前言¶

DeepSeek Harness（dsh）把模型、工具、存儲、策略和界面都做成可插拔組件，Agent 會話、工具調用和權限策略由同一套服務驅動。官方提供 Web UI，但在本地倉庫裏寫代碼、看 diff、跑審查時，很多人更習慣終端裏的交互方式——類似 Codex CLI、Claude Code 那種 TUI 工作流。

下面介紹社區插件 DSH-Code（維護者 UNLINEARITY）。它以樹外 bundle 的形式疊在官方 @deepseek-ai/dsh-base 之上，與 Harness Web UI 共用 Agent、Session、工具、命令、技能、權限、sandbox、上下文壓縮與插件服務；界面換成終端 TUI，運行行爲仍由 DSH 進程和配置決定。插件在 SkillHub 目錄歸類爲「客戶端」，GitHub 約 27 stars（截至資料抓取時）。

這是什麼¶

DSH-Code 是 dsh 的終端編碼界面（Claude-Code-style TUI bundle）。 它不另起一套 Agent 運行時，而是讀取 Harness 的即時註冊表，把持久會話、模型管理、Agent Preset、subagent、plan mode 和編碼相關命令搬到終端裏。

與「單獨裝一個 CLI 工具、自己維護會話和工具鏈」的做法相比，DSH-Code 直接接入 DSH 的 Cordis 組合與 Session 事件投影：恢復會話時會同步還原 Agent Preset 和模型選擇；/plugin 展示的是當前 loader 狀態，而不是本地副本。

核心功能¶

會話與工作流¶

• /new 新建會話，/resume、--continue 按目錄、時間或 id 恢復；/fork 從歷史節點分支，原會話保留
• 支持持久標題、Markdown 導出（/export）、上下文佔用與 token 統計
• Up/Down 召回輸入，/history 搜索歷史提示詞
• @ 引用工作區文件或已有會話；PNG、JPEG、WebP、GIF 自動作爲圖片附件
• /diff 按文件查看改動，/review 以只讀權限審查 Git diff；支持工具審批、plan review、任務運行中補充指令

Agent、模型與擴展¶

• 每會話可選 Agent Preset：standard、code、minimal、cordis 或用戶自定義；/mode 切換，--mode 啓動時指定
• /model 管理 provider、API key、OAuth/設備碼登錄、endpoint 與可用模型；未配置模型時仍可進入 TUI 使用非模型功能
• /effort 調整 reasoning effort；/permission 切換權限 Preset；/subagent 指定子代理模型
• 自動加載 DSH 中的命令與技能；/help 查看入口，/plugin 檢查擴展狀態
• 切換模型或 reasoning effort 時，輸入框可播放 Wave、Aurora 或 Pulse 動畫（官方 DeepSeek 模型與其他高強度模型觸發條件不同，詳見 README）

與 DSH 的接入方式¶

Host 平面持有註冊表、持久化、查詢、權限與 sandbox；每個會話獲得隔離的 Agent scope，由 Agent Preset 組合工具、提示詞、技能、上下文壓縮與 subagent 能力。提示詞、流式輸出、工具調用、模型選擇與 preset 均寫入 Session 事件，恢復與導出共用同一份記錄。

安裝與啓用¶

需要 Node ^22.19 || >=24，以及預覽版 dsh CLI（當前版本線：@deepseek-ai/dsh@0.1.1-rc.2）。dsh-code@1.0.1 面向該版本構建，Harness 依賴均鎖定爲 0.1.1-rc.2，請保持全局 dsh 與 dsh-code 同步，避免宿主與插件混用候選版本。

初次安裝與更新使用同一組命令：

npm install -g @deepseek-ai/dsh@0.1.1-rc.2 dsh-code@1.0.1
npm install -g pnpm
dsh plugin --profile cli add dsh-code@1.0.1

pnpm 會忽略發佈不足 24 小時的包，發佈首日請寫精確版本 dsh-code@1.0.1；24 小時後可省略版本號。npm 不受此限制。

典型用法¶

安裝完成後，以下三條命令等價，後續參數會原樣轉發：

dsh --profile cli
deepseek
dsh-code

帶參數啓動示例：

dsh --profile cli --mode code        # 使用 code Agent Preset
dsh --profile cli --continue         # 恢復當前目錄最新會話
dsh --profile cli --resume abc123    # 按 id 或唯一前綴恢復
deepseek --resume abc123             # 別名同樣支持參數轉發

進入 TUI 後，常用內置命令包括：

快捷鍵方面：Tab 補全命令與 @ 引用，Ctrl+O 查看完整歷史與工具詳情，Esc 可中斷正在運行的 turn，Ctrl+D 退出。完整列表以 /help 爲準。

適用場景與注意¶

適合誰： 已在用或打算用 DeepSeek Harness，希望在終端完成編碼、diff、審查和會話管理的開發者；需要與 Web UI 共用同一套 Agent、工具和持久會話的人。

使用前注意：

• DeepSeek Harness 仍處於 developer preview，插件接口可能隨上游變化；DSH-Code 聲明會持續跟隨演進。
• 插件以當前 dsh 進程的權限運行，安裝前建議查看 GitHub 源碼 與 MIT 許可證。
• SkillHub（目錄頁）是社區插件目錄，與 DeepSeek / 幻方無官方從屬關係。
• 安裝、原生模塊或插件加載異常，可參考倉庫內 常見問題與排障。

結尾¶

DSH-Code 把 DSH 的 Agent 運行時、持久會話和插件生態接到終端 TUI，覆蓋從會話管理、模型切換到 /diff、/review 的編碼工作流，而不另建一套工具鏈。若你已在用 dsh --profile cli，裝上 bundle 後即可用 deepseek 或 dsh-code 直接進入同一套服務。

• 目錄頁：https://www.skillhub.cn/plugins/UNLINEARITY/dsh-code
• GitHub：https://github.com/UNLINEARITY/dsh-code