前言¶
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 本身不提供官方插件商店，所有插件均由社區維護。
