返回目录

Agent 与会话插件

dsh-conversation-manager

lanlandeli/dsh-conversation-manager

DeepSeek Harness 会话管理插件｜归档与恢复、批量操作、工作区分组、子代理关系、活动详情、记录目录与安全文件清理

查看仓库项目主页

Stars: 1
Forks: 0
Issues: 0
更新: 1 天前

PROJECT TOPICS

项目标签

archive conversation-management deepseek deepseek-harness dsh dsh-plugin plugin session-manager typescript

INSTALL REFERENCE

安装参考

未验证

dsh plugin --profile web add github:lanlandeli/dsh-conversation-manager

在 DSH 中安装

该命令指向仓库当前默认分支；尚无绑定当前 commit 的完整验证结果。

PROJECT README

README

🗂️ dsh-conversation-manager

English

为 DeepSeek Harness 提供安全、清晰的会话归档与记录管理。

dsh-conversation-manager 是面向 DeepSeek Harness Web UI 的会话管理插件。它把活跃会话、归档会话、子代理关系、活动摘要和本地产出文件集中到一个界面中，并为永久删除操作设置明确的确认与文件系统边界。

插件通过 Harness 提供的服务和 UI 插槽集成，不修改官方 npm 包或 Web UI DOM。会话数据只在本机读取和处理。

dsh plugin --profile web add dsh-conversation-manager

重启 Web Profile 后，在「设置」中打开 会话管理。

更新或卸载：

dsh plugin --profile web update dsh-conversation-manager
dsh plugin --profile web remove dsh-conversation-manager

🎬 效果演示

以下素材使用纯演示数据生成，不包含真实会话、路径或文件信息。

会话管理效果演示

🖼️ 界面截图

查看浅色主题

浅色主题

查看深色主题

深色主题

✨ 功能概览

模块	说明
📥 归档与恢复	将对话移入归档或恢复到活跃列表，保留原始会话记录
📚 批量管理	支持拖动连续选择、全选、批量归档、恢复与永久删除；失败项会保留选择以便重试
🔎 搜索与分组	按标题或会话 ID 搜索，并可在单列表与工作区分组之间切换
🌳 子代理关系	子代理默认隐藏，在父会话下按需展开；多级关系与搜索结果保持正确归属
📊 会话详情	查看磁盘占用、更新时间、消息与工具调用统计、网络获取记录及父子会话关系
📁 记录目录	选择单个会话后，在系统文件管理器中打开实际用于计算占用空间的记录目录
🧹 产出文件清理	仅允许删除该会话记录过、且位于已注册工作区内的普通文件
🌐 中英文界面	自动跟随 Harness 的语言设置切换中文或英文

⚠️ 删除行为

归档对话只改变归档状态，不删除会话记录。
删除选中会永久删除所选会话的持久化记录，无法撤销。
删除父会话不会级联删除子代理；只有明确选中的会话会被删除。
正在运行的会话会被拒绝删除。当前页面打开的会话在界面中不可选择。
删除选中文件会永久删除磁盘文件，仅用于无需保留的会话产出。

重要数据仍建议自行备份。插件不是备份或回收站工具。

🔒 安全边界

产出文件删除必须同时满足以下条件：

请求包含有效的会话 ID；
文件路径存在于该会话的产出文件列表；
目标是普通文件，不是目录或符号链接；
解析后的真实路径严格位于 Harness 已注册的工作区内部，且不能是工作区根目录。

会话记录目录由 Harness 官方 persistence 的 locate(meta) 接口提供；插件不再推导或假设 JSONL 目录结构。浏览器接口只接受本机回环地址上的同源 POST 请求，并限制请求体大小。详细信息见安全策略和隐私说明。

🧩 兼容性

目前已在 DeepSeek Harness 0.1.0-rc.7、Node.js 22.19+ 和 24+、官方 Web Profile 上验证。界面支持浅色、深色主题以及加载同源 Web UI 的桌面封装。

Harness 仍处于快速迭代阶段。其他版本可能能够运行，但不属于当前验证范围；详见兼容性说明。

🛠️ 开发

npm ci
npm run release:check

源码结构：

路径	用途
`src/index.ts`	Host API、详情聚合、归档、恢复与删除操作
`src/server/path-security.ts`	会话记录和工作区文件的真实路径安全围栏
`src/client/index.tsx`	设置页界面、详情卡片和交互状态
`src/client/model.ts`	搜索、工作区分组与子代理树模型
`src/client/batch.ts`	保留逐项成功/失败结果的批处理器
`src/client/i18n.ts`	中英文界面文案
`src/client/styles.ts`	响应式样式、主题和动效
`tests/`	路径安全、批处理和状态模型测试

构建产物位于 lib/，不要直接编辑。贡献前请阅读开发说明。

🐛 遇到问题

如果出现插件入口缺失、会话列表不完整、目录定位错误或界面异常，请提交 Issue，并尽量附上：

DeepSeek Harness、插件和 Node.js 版本；
安装或更新插件时执行的命令；
可复现问题的操作步骤；
已脱敏的错误日志或界面截图。

请勿在公开 Issue 中提交 API 密钥、访问令牌、提示词、会话日志或本机完整路径。安全问题请按安全策略私密报告。

📜 许可证

CLASSIFICATION EVIDENCE

分类依据

项目类型插件

功能分类Agent 与会话

规则置信度高

系统优先读取 GitHub Topics，再与站内分类词典和词根规则比对。当前命中： conversation-management、session-manager。