dsh-session-plus：DeepSeek Harness 的会话归档与分支插件

前言¶

DeepSeek Harness (DSH) 的理念是「一切皆插件」。官方 Harness 虽然支持会话归档，但在用户界面层面缺少查看、恢复或删除归档会话的功能。dsh-session-plus 由维护者 SZMY-haruhi 开发，通过补充侧栏归档目录和分支对话功能，将通常分散在不同插件中的操作整合到一个入口。该插件走公开 slot 和 workspace 域，不修改 @deepseek-ai 核心文件，也不向官方「视图选项」菜单插入 DOM。

插件信息¶

• 插件名：dsh-session-plus
• 维护者：SZMY-haruhi
• 许可证：MIT
• 安装命令：

    dsh plugin --profile web add dsh-session-plus

*注意：npm 上的 0.1.0 是更早的占名包，请安装 0.1.1 版本。*

核心功能¶

该插件提供以下功能：

1. 归档目录：列出官方 archivedSessionIds，不是插件自己维护的影子列表。
2. 恢复：从归档集合中移除，回到原工作区位置。
3. 删除：居中二次确认，卸工作区记账并删除会话日志（包括 .zstd 兄弟文件和会话目录）。删除后不会再次触发取消归档逻辑。
4. 空白新会话：空白草稿状态的会话不能归档、也不能删除。
5. 分支对话：在用户消息旁显示 Y 形带箭头的分叉图标，点击后弹出就近浮窗，可修改提问并分支。如果不填写新标题，默认沿用官方 increaseTitle 叠加 (1) (2) 的方式。
6. 空闲等待：插件会在归档前尽量等待空闲（包含 runningCalls 和 partial 状态），最多等待约 30 秒，超时会提示「请先等当前回复结束，或点停止后再归档」。

典型用法¶

1. 归档会话：在侧栏底部、设置旁边点击「归档」按钮。
2. 管理归档：在弹出的归档目录列表中，点击「恢复」或「删除」。
3. 分支对话：在用户消息旁点击 Y 形图标，在浮窗中修改提问后发送，原对话保留。

注意事项¶

• 禁止在工具调用时归档：这是插件最关键的限制。如果正在调工具时归档，会导致会话日志损坏，恢复后会出现 tool-call received more than one start Match 或 SessionPersistenceCorruptionError。一旦出现这种情况，需重启服务或删除会话。
• 不修复损坏日志：如果会话日志已经损坏，插件无法修复，只能删除该会话。
• 空白会话限制：空白新会话（未发送过消息的会话）不能被归档或删除。

生态背景¶

DSH 插件生态由社区维护。相关插件目录托管在独立站点，与 DeepSeek 或幻方无官方从属关系。本插件依赖公开 Harness API 开发，不覆盖官方 plugin 行（仅使用 insert），不伪装成官方菜单项。