DeepSeek Harness 插件：dsh-default-overrides

前言¶

DeepSeek Harness（DSH）的設計理念是“一切皆插件”。核心預設（如 standard）提供了通用的基礎能力，但在實際開發中，往往需要針對特定環境（如 Shell 通道、工具權限、人設）進行調整。dsh-default-overrides 插件允許你通過配置覆蓋這些默認行爲，而無需修改 DSH 的安裝文件或預設源碼。

插件概覽¶

• 名稱：dsh-default-overrides
• 一句話介紹：DeepSeek Harness（DSH）標準預設的可配置覆蓋：Shell（Bash/PowerShell）通道、禁用行、人設和 Harness 身份。
• 類別：工作流
• 維護者：site-chenwei
• 許可證：MIT

安裝與啓用¶

安裝後默認不改變現有行爲，按需添加配置即可。

1. 安裝插件。以下以 web profile 爲例：

    dsh plugin --profile web add dsh-default-overrides

也可以在 DSH 插件管理器中安裝。

2. 編輯目標 profile 的配置文件。以 web profile 爲例：

    # 文件路徑：~/.dsh/profiles/web/cordis.patch.yml
    - id: dsh-default-overrides
      config:
        # 在此添加具體配置項

核心功能¶

插件提供以下配置能力：

1. 配置 Shell 模式¶

支持 Bash 和 PowerShell，並支持持久化模式。
* 模式選擇：
* bash / pwsh：每次新建 Shell，不保留目錄、變量和函數。
* persistent-bash / persistent-pwsh：保留狀態，適合連續執行。
* 路徑配置：
* Windows：需顯式填寫 bashPath（如 Git Bash）或 pwshPath。
* macOS / Linux：通常使用系統默認路徑。
* 限制：Windows 上本插件的 Bash 後端不接受 Cygwin 或 WSL / Linux 入口。

2. 設置助手人設¶

通過 persona 字段修改系統提示詞，通過 personaPresets 指定生效的預設（默認爲 standard）。

3. 禁用工具¶

通過 disabledTools 禁用 standard 預設中的特定工具（如 tool-web、tool-workflow）。

4. 調整上下文與壓縮¶

• autoCompaction：關閉原生自動壓縮，由用戶手動控制上下文管理。
• includeHarnessIdentity / surfaceContext：隱藏框架身份提示或 Web 表層提示。

適用場景與注意事項¶

• 適用場景：需要持久化 Shell 環境進行開發、需要固定助手人設的工作流、需要精確控制上下文內容的場景。
• 注意事項：
  • 驗收狀態：Windows 實機與 ConPTY 驗收尚未完成；PowerShell 真進程也尚未在此環境驗收。
  • 默認行爲：安裝後默認不改變現有行爲，需手動添加配置。
  • 插件限制：插件不限制安裝版本，其他 DSH / Node 版本的兼容性需要實際確認。

結語¶

該插件通過配置覆蓋解決了 DSH 標準預設的通用性與特定工作流需求之間的矛盾。更多細節與完整配置示例可參考：
* 插件目錄頁
* GitHub 倉庫