dsh-conversation-manager

🗂️ 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 的语言设置切换中文或英文

⚠️ 删除行为

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

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

🔒 安全边界

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

1. 请求包含有效的会话 ID；
2. 文件路径存在于该会话的产出文件列表；
3. 目标是普通文件，不是目录或符号链接；
4. 解析后的真实路径严格位于 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 密钥、访问令牌、提示词、会话日志或本机完整路径。安全问题请按 安全策略 私密报告。

📜 许可证

MIT。项目包含基于上游 MIT 许可代码修改的部分，版权声明见 LICENSE。