dsh-session-manager-next

DeepSeek Harness（DSH）会话管理插件：在 Web UI 里浏览历史对话、导出对话、整理会话、安全删除。

• 仓库名：dsh-session-manager-next；npm 包名 / 插件包名仍为 dsh-session-manager（安装命令与插件条目 id 不受仓库改名影响）
• 适配版本：DSH 0.2.1-rc.2（Desktop / Web 同一套 Host API）
• 形态：Cordis bundle（Host 半 + Web Client 半），无第三方依赖、无需构建
• 参考实现：huajuan2024/dsh-session-manager（面向 0.2.0-rc.2；本插件按其思路针对 0.2.1-rc.2 重写并扩展）

功能

1. 对话导出

格式	内容	适用
Markdown	用户 / 助手消息、思考过程（折叠）、工具调用与结果（代码块）、轮次统计	归档、分享、二次编辑
JSON	完整原始事件日志 + 会话 header + 统计（dsh-session-export v1）	备份、程序处理、迁移
HTML	单文件、自带样式与深色模式、可直接双击打开	阅读、发给别人

• 单会话导出：侧边栏会话「…」菜单 → 导出对话…，或管理面板右侧详情里的三个导出按钮。
• 批量导出：勾选多个会话 → 导出所选 Markdown / JSON（合并为一份文件）。
• 文件名自动带标题、会话 ID 尾段与日期。
• Markdown / HTML 默认省略 Harness 注入的运行时上下文（Current runtime context.、<system-reminder> 等），并在文件头注明省略条数；JSON 保留全部事件。

2. 整理会话

• 重命名标题：走 Host 的 sessionController.rename，durable 写入 session event，不只是本地显示。
• 置顶 / 取消置顶、归档 / 取消归档：走 workspaceRegistry，与侧边栏状态一致。
• 强制归档：会话仍在活动时，可停止其运行并归档。
• 搜索 / 筛选 / 排序：按标题、工作区、会话 ID 搜索；筛选活跃 / 全部 / 空会话 / 已归档 / 已置顶；按最近更新 / 创建时间 / 标题排序。
• 清理空会话：一键筛出 blank 会话并批量删除。

3. 删除会话

• 单个删除（详情页二次确认）与批量删除（勾选后确认）。
• 安全护栏：
  • 运行中的会话直接拒绝（先停止再删）；
  • 仍被内存中 Agent 占用的会话需二次确认「强制删除」；
  • 删除后同步清理工作区登记（detachSession）与归档 / 置顶集合，避免残留幽灵条目；
  • 只删除 <DSH_HOME>/sessions/<项目>/<会话 ID> 目录；目标目录名来自 readdir 结果，永不拼接请求里的字符串；会话 ID 另做白名单校验；
  • 删除不可恢复：UI 有明确二次确认。

界面位置

• 侧边栏底部图标（面板列表第 4 个）→ 打开整页「会话管理」：左侧会话列表，右侧详情（导出 / 重命名 / 置顶 / 归档 / 删除 + 消息预览）。
• 会话行「…」菜单新增一行「导出对话…」：直接从侧边栏跳到该会话的详情与管理操作。
• 设置 → 插件 中可见「会话管理」条目（标题、描述、图标来自 locale/*.json 与 icon.svg）。

架构

index.js    Host 半：注册 /api-session-manager/{ping,list,detail,export,organize,delete}
            - 读：ctx.sessionQuery（readSession / readTitleSnapshots）
                  ctx.sessionController.list（running / blank / 活动时间）
            - 写：ctx.sessionController.rename、ctx.workspaceRegistry（pin / archive / unarchive）
            - 删：node:fs 移除会话目录（DSH 0.2.1 未提供删除 API）
            - 归档/置顶状态：只读 workspace ledger（<DSH_HOME>/storages/workspace.json）
client.js   Client 半：纯 JavaScript 动态模块，注册
            sidebar.panellist（图标）+ main（整页面板）+ 会话菜单行
            React 由宿主模块表提供；样式只用 --dsw-alias-* 主题 token；
            locale 走 ctx.get('locale')，读写只经 Host 路由
test/       render-smoke.mjs：用极简 React/hook/fetch 替身在 Node 中执行整个
            Client 半（空态、列表、归档筛选、详情、导出、删除确认、菜单行），
            捕获渲染期崩溃与错误路由

为什么删除要落到文件系统

0.2.1-rc.2 的会话生命周期里没有删除接口：

• sessionPersistence 只有 create / open / append / flush / list / stat，没有 delete；
• sessionController / workspaceController 只有 archiveSession / unarchiveSession，没有删除；
• 侧边栏内置会话菜单只有置顶、重命名、分叉、归档、复制 ID。

因此删除由插件在 Host 进程内完成：扫描 ~/.dsh/sessions/*/<sessionId>（目录名精确匹配，不接受客户端给的路径片段）后 rm -rf，再清理工作区登记与归档 / 置顶集合。

安全模型

• 面板不向模型上下文注入任何内容，不新增 session event。
• Client 只拿到 JSON：没有绝对路径批量下发、没有 token、没有文件系统能力。
• 所有写操作在 Host 进程执行；sessionId 需匹配 ^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$，且不会进入 path.join 的可控段。
• Host 路由挂在同源 /api-session-manager/*（与社区插件一致的 Host 路由方式），仅本机页面可访问；接口自身再做参数与状态校验。

安装

从 Releases 下载 dsh-session-manager-0.3.0.tgz 后：

dsh plugin --profile desktop add ./dsh-session-manager-0.3.0.tgz

也可以直接安装仓库目录（开发时更方便）：

# 方式一：插件管理器（Web UI 设置 → 插件 → 添加，选择本目录）
# 方式二：CLI
dsh plugin --profile desktop add <本目录绝对路径>

安装后 Host 会热加载 Client bundle，侧边栏出现「会话管理」图标；若未出现，刷新页面。

包名 dsh-session-manager 与上游同名项目一致，本仓库以本地 bundle 方式安装，不发布到 npm（package.json 保持 private: true，避免名字冲突）。

配置

无必填配置，默认值：

项目	默认值
会话根目录	$DSH_HOME/sessions（DSH_HOME 缺省 ~/.dsh）
工作区账本	$DSH_HOME/storages/workspace.json（只读）
单次请求体上限	128 KiB
单次批量删除上限	500

测试

node test/render-smoke.mjs

无需安装依赖：测试自带 React / DOM / fetch 替身，覆盖 Client 半的注册、渲染与请求路径。

已知边界

• 删除正在内存中的会话后，侧边栏条目要等页面刷新或 Harness 重启才消失（Host 的 workspace/session 索引在启动时构建）。
• 归档 / 置顶的读取依赖 workspace ledger 的结构；结构变化时仅失去状态显示，写入仍走官方 API。
• 批量导出 HTML 会退化为 Markdown（单会话 HTML 完整支持）。
• 「…」菜单行通过注入的 useMenuOpenState 关闭菜单；宿主改变该 hook 名称时，行仍可点击，只是菜单需手动关闭。
• 国际化：简体中文 / English。

卸载

设置 → 插件 → 会话管理 → 卸载，或：

dsh plugin --profile desktop remove dsh-session-manager

验证状态（本机 0.2.1-rc.2）

Host 路由已用真实 HTTP 调用验证：ping、list（真实会话列表，归档 / 置顶 / running 状态正确）、detail（含运行中会话与导入会话）、export（Markdown / HTML / JSON / 批量均正确返回文件）、delete 与 organize 的守卫（不存在、运行中、内存中、非法 ID、非法 action、错误方法均返回对应错误码）。Client 半的三处注册在运行中的页面里均为 active，渲染与交互由 test/render-smoke.mjs 覆盖；面板的实际视觉效果需在浏览器里目视确认。