前言¶
DeepSeek Harness (DSH) 的理念是“一切皆插件”。对于使用 ZCode 的开发者来说，积累的会话往往分散在本地数据库中，难以在 DSH 中统一管理。该插件通过设置页入口，提供了一套可视化的导入流程，将 ZCode 的会话转化为原生 DSH 会话。
核心功能¶
- 设置页入口：在设置面板中新增“会话导入”页面，与“通用 / 模型 / 插件”同级。
- 工作区列表：按
session.directory自动聚合 ZCode 工作区，显示会话数、最近更新时间；目录已被删除的会标黄提示。 - 对话列表：选中工作区后列出其对话，包含标题、更新时间、消息条数及已导入标记；子代理会话默认折叠。
- 导入选项：支持勾选任意几条对话进行“导入选中会话”，或一键“导入整个工作区”。
- 进度与明细：导入过程显示进度条与当前标题，结束后逐条列出“已导入 / 已存在 / 跳过 / 失败”及原因。
- 内容完整：将文本、思考、工具调用与结果全部还原为 DSH 的
tool/call和tool/result事件。 - 自动建工作区：目标目录在 DSH 中不存在时自动创建并挂载。
- 热重载：修改
impl.js后，通过POST /__reload即可生效，无需重启 DSH。
安装¶
插件以 MIT 许可证开源。
dsh plugin --profile web add github:BaiZhi967/dsh-plugin-zcode-import
安装后刷新页面，打开 设置 → 会话导入。
用法¶
- 打开 设置 → 会话导入，顶部会显示识别到的 ZCode 数据目录。
- 在左栏点击一个 工作区。
- 在右栏勾选要导入的对话，点击 导入选中会话；或直接点击 导入整个工作区。
- 等待进度条跑完，查看 导入明细。
- 关掉设置后，会话已出现在左侧列表中，可以像往常一样打开、继续提问、归档或删除。
限制与说明¶
- 只读模式：ZCode 数据库以
readOnly打开，插件不会写入、删除或迁移 ZCode 原数据。 - 图片与附件：ZCode 中的
file类部分仅保留文件名占位文本，二进制附件不会搬运。 - 模型来源：导入的 assistant 消息会保留 ZCode 记录的
provider/model名作为来源标注。 - 子代理会话：默认不列出（ZCode 中子代理会话较多），需要时在 API 调用中添加
?includeSubagents=1参数。 - 重复导入：会话 ID 由 ZCode UUID 派生，重复导入会被识别为“已存在”并跳过。
- 新会话：导入的是 ZCode 数据库里的既存记录，ZCode 之后新产生的对话需要再次导入。
生态背景¶
本插件由社区开发者维护，收录于 SkillHub 插件目录。DSH 本身不提供官方插件商店，所有插件均由社区维护。
