dsh-pi-compatible: Pi 工具組契約復刻插件

DeepSeek Harness (DSH) 的核心優勢在於其插件化架構和強大的擴展能力。有時，開發者需要復刻特定 Agent（如 Pi）的核心工具交互契約，同時保留 DSH 自身的後端能力（如文件系統、會話管理等）。dsh-pi-compatible 插件正是爲了解決這一需求而生。它復刻了 Pi 工具組的 Agent Preset，提供了一套小寫核心工具契約，並支持擴展版本，同時底層仍由 DSH 驅動。

核心功能¶

該插件提供兩個預設：Pi-compatible Core 和 Pi-compatible Plus。

Pi-compatible Core¶

該預設復刻了 Pi 0.84.2 的核心工具契約，默認暴露七個核心工具。這些工具的命名風格與 Pi 保持一致，但行爲由 DSH 實現。

read: 讀取文件，支持偏移量和行數限制，最大 64 MiB 安全上限。
bash: 執行 Bash 命令，每次調用創建新進程，無持久狀態。
edit: 編輯文件，支持模糊標點回退，保留 BOM 和換行符格式。
write: 寫入文件，自動創建父目錄。
grep: 基於 ripgrep 的搜索，支持 JSON 輸出和上下文控制。
find: 基於 fd 的搜索，支持 glob 模式和 .gitignore 忽略。
ls: 列出目錄內容，包含 dotfiles，支持不區分大小寫的排序。

Pi-compatible Plus¶

在 Core 的基礎上，Plus 預設增加了 DSH 後端支持的擴展工具，包括：
* WebFetch
* WebSearch
* Task
* TodoWrite
* ExitPlanMode
* Think
* SlashCommand
* /plan
* /compact
* 以及 DSH 的基礎壓縮和工具結果剪裁功能

底層能力¶

上述工具均使用 DSH 的底層能力構建，包括：
* filesystem: 文件讀寫與目錄操作
* subprocess: 子進程管理
* attachment: 附件處理（支持 PNG, JPEG, GIF, WebP, BMP 等）
* session: 會話管理
* cancellation: 取消操作
* model-routing: 模型路由
* presentation: 展示能力

安裝與啓用¶

安裝該插件需要使用 DSH 的 Web profile。

執行安裝命令：

    dsh plugin --profile web add kingguuu8-svg/dsh-pi-compatible

或者安裝本地檢出的代碼：

    dsh plugin --profile web add .

安裝完成後，插件會解壓到 ${DSH_HOME:-~/.dsh}/.agent-presets/pi-compatible/ 目錄。該安裝過程是冪等的，不會覆蓋已存在的完整預設。
創建新會話，並在預設列表中選擇 Pi-compatible Core 或 Pi-compatible Plus。

運行時配置¶

插件依賴部分外部工具和配置項。以下環境變量可用於控制行爲：

PI_COMPAT_BASH_PATH: 指定真實的 Bash 可執行文件絕對路徑。
PI_COMPAT_FD_PATH: 指定 fd 工具的絕對路徑。
PI_COMPAT_RG_PATH: 指定 rg (ripgrep) 工具的絕對路徑。
PI_COMPAT_OFFLINE=1: 禁用 fd 和 rg 的網絡下載。
PI_OFFLINE=1: PI_COMPAT_OFFLINE 的別名，同樣禁用網絡下載。
DSH_HOME: DSH 的主目錄，同時也是私有 pi-compatible/bin 緩存根目錄。

工具解析策略：
* Bash: 優先使用 Git Bash (Windows 下)，其次是 PATH 中的 Bash，最後是緩存目錄中的版本。
* fd/rg: 優先級爲環境變量 > 系統路徑 > 緩存目錄 > GitHub 最新發布版本（除非處於離線模式）。

權限與信任¶

該插件僅支持 danger-full-access 權限預設。它不會實現針對更窄權限策略的升級工作流。

信任聲明: 該插件包含可執行任意 Bash 命令和修改任意文件的權限。作爲用戶 Preset，它擁有所加載插件的權限。建議在安裝前審查源碼。
Windows 平臺: Windows 是發佈阻塞平臺。
Pi 基線: Pi baseline 永久凍結爲 0.84.2。
兼容性邊界: 兼容性指模式和關鍵行爲，不要求字節級錯誤消息或 TUI 渲染完全一致。DSH 保留了路徑授權、文件系統發佈、進程樹取消等核心控制權。

生態與鏈接¶

許可證: MIT
目錄頁: SkillHub - dsh-pi-compatible
源碼: GitHub - kingguuu8-svg/dsh-pi-compatible