前言¶
DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。p-jiangh/dsh-enhance 是一個爲 DSH 提供增強體驗的工具包，它的定位類似於 oh-my-zsh 的主題擴展。它通過封裝技能、注入工作規則、提供預設代理以及一系列輔助工具，幫助用戶在 DSH 中快速建立一套標準的深度工作流。
核心能力¶
安裝後，插件主要提供以下功能：
- 打包技能：內置
code-review、git-workflow和tdd等技能，通過/菜單直接調用。 - Work-rules 段：常駐系統提示詞段，定義通用工作紀律。
- Doctor 工具：
dsh_enhance_doctor，用於診斷插件裝配狀態並給出建議。 - 人類指令：提供
/doctor（診斷）和/boulder（工作追蹤狀態）兩個 UI 入口，結果僅渲染不消耗 token。 - 守衛 + Delivery-gate：包含
write-existing、path-traversal、bash-read等守衛，以及基於文件 manifest 的交付門衛。 - 工作追蹤：結合 boulder 和寫令牌，提供
start-work和 delivery-gate 鉤子。 - Worktree 工具：提供
worktree_create/list/cleanup工具。 - Enhance 預設：一個名爲
enhance的工作模式預設，包含深度工作協議（enhance-mode）段。 - Advisor：伴隨審查運行的子代理，提供 nit/concern/blocker 等建議。
安裝與啓用¶
本插件以 Profile 爲單位進行掛載。安裝前請確保已安裝 dsh CLI（npm 包 @deepseek-ai/dsh）。
- 確認你的 profile 名稱。桌面端 GUI 使用
desktop，Loopback Web 使用web，無頭模式使用headless。 - 執行安裝命令：
dsh plugin --profile <your-profile> add https://github.com/P-JIANGH/dsh-enhance/releases/download/v0.1.2/p-jiangh-dsh-enhance-0.1.2.tgz
注意點：
* 包名是 @p-jiangh/dsh-enhance，不要寫成裸名 dsh-enhance。
* 如果 profile 名稱寫錯，命令會靜默新建一個同名 profile，桌面端 GUI 可能看不到該插件。建議先確認已存在的 profile：ls $DSH_HOME/profiles。
* 桌面端的 profile 由應用獨佔管理，CLI 只能管理 web、headless 或自定義 profile。在桌面端 GUI 的插件面板安裝即可。
典型用法¶
安裝完成後，插件會自動加載。你可以通過以下方式使用：
- 使用技能：在輸入框打
/，選擇code-review、git-workflow或tdd。 - 執行診斷：在輸入框打
/，選擇/doctor。 - 啓用增強模式：新建會話時，在預設菜單中選擇 Enhance。該預設包含常駐的
enhance-mode段。
配置¶
插件支持在界面或 YAML 文件中進行配置。
- 界面配置：在側邊欄「插件」面板中找到
@p-jiangh/dsh-enhance，點擊「配置」。可以調整workRules、doctorTool、guards、workTracking等開關，或修改advisorModel。 - YAML 配置：在 profile 的
cordis.patch.yml或$DSH_HOME/cordis.patch.yml中覆蓋：
- id: dsh-enhance
name: '@p-jiangh/dsh-enhance'
config:
workRules: |
# 你的自定義規則
doctorTool: true
注意事項¶
- 預設固定：Enhance 預設是會話創建時固定的，無法在已有會話中切換。要使用該預設，必須新建會話。
- 兼容性：Enhance 預設需要
dsh >= 0.2.0，且僅在 Web 或桌面端界面可用。純 headless / acp / sdk 環境下無法在預設菜單選擇，但插件本體功能正常。 - 功能狀態：Advisor 的目標迴歸功能尚未實現，當前僅作爲伴隨審查運行時存在。
總結¶
dsh-enhance 通過提供預設好的技能、工作流守衛和深度工作模式，降低了在 DSH 中搭建複雜工作流的門檻。它適合希望在對話中快速複用代碼審查、Git 工作流或進行結構化深度工作的用戶。
