前言¶
用 DSH 跑日常任務，有兩類小麻煩反覆出現：一是工具執行前的確認環節，危險命令必須人工把關，但每條都盯着看很耗精力，漏看又有風險；二是等待環節，審批請求、後臺任務什麼時候完成，如果不盯着界面就容易錯過。
dsh-pi-kit 針對的就是這兩個點。它是 DSH 的輕量優化插件合集，把「自動審覈」和「提示音」打成一個小包，裝上之後日常使用基本零感知，危險操作和等待事件不再錯過。下面介紹它的功能、安裝和使用方式。
這是什麼¶
dsh-pi-kit 由 Pidreamleaves 維護，許可證爲 MIT，當前版本 0.1.0。它以一個 workspace 管理三個成員包，通過 bundle 機制一次性掛載：
- auto-review：自動審覈門衛
- approval-chime：提示音 / 通知
- pi-kit-settings：聚合設置卡殼
三個包各管一件事，也可以單獨安裝其中某一個。
核心功能¶
自動審覈（auto-review）¶
在工具執行前自動處理確認環節：危險命令攔截、安全操作放行、拿不準的交用戶確認。審覈用輕量模型完成，複用 DSH 憑據，不需要額外配置密鑰。
提示音（approval-chime）¶
在審批請求、詢問、後臺任務完成時用不同聲音提醒。後臺作業完成時還會調用系統通知。這樣即使切走了窗口，也不會漏掉需要你介入的時刻。
聚合設置卡（pi-kit-settings）¶
三個插件的設置收進一張卡片，入口在「設置 → 插件 → 插件配置 → dsh-pi-kit」，配置持久化存儲。如果不裝這個設置殼，設置會以獨立卡片形態出現。
安裝與啓用¶
一鍵安裝（推薦）¶
先確保環境裏有 pnpm（dsh plugin 內部調用 pnpm 完成安裝；若提示 pnpm not found，先 npm install -g pnpm），然後執行：
dsh plugin --profile web add dsh-pi-kit
這條命令會讀取包內的 dsh.bundle.patch，由 dsh 自動完成依賴安裝與掛載，不需要手寫任何 patch。重啓 DSH 生效。
web 是內置 Web GUI profile 名；使用其他 profile 時換成對應名字（~/.dsh/profiles/ 下的目錄名）。
手動安裝¶
等價的寫法是直接改 profile 的 package.json，聲明依賴並掛載 bundle：
{
"dependencies": { "dsh-pi-kit": "^0.1.0" },
"dsh": { "profile": { "bundles": ["dsh-pi-kit"] } }
}
驗證與卸載¶
安裝後先用下面的命令確認插件行已掛載：
dsh --profile web --dump-config
不需要時卸載，重啓 dsh web 生效：
dsh plugin --profile web remove dsh-pi-kit
兩個佈局相關的注意點¶
1、profile 使用 pnpm 隔離（isolated）佈局時，成員包會被收進嵌套目錄，dsh web 啓動可能報 Cannot find package 'dsh-auto-reviewer'。在 profile 的 pnpm-workspace.yaml 加 nodeLinker: hoisted 後重新安裝即可。
2、想單獨停用某個成員，在 patch 層追加一行 - id: <插件 id> disabled: true 就可以，不必整體卸載。
日常使用¶
裝好重啓後，兩個功能默認都是啓用狀態，可以先用起來再按需調整。
自動審覈：審覈模型爲 deepseek-v4-flash。策略文件 ~/.dsh/auto-review.yml 會在首次啓動時自動生成一份帶註釋的模板，按示例改成自己的規則即可。每次對話 turn 結束時，審覈結果以彩色徽章彙總——放行綠、攔截紅、提權藍，點「明細」可以看到每一條的判定理由。
提示音：完成音默認只提醒後臺會話，避免正常會話被頻繁打擾；如果你希望所有會話都有提示，可以在設置裏改。審批音、詢問音、完成音三種音色都可以在設置裏試聽。
從源碼安裝：想改代碼調試的話，可以把三個成員包分別鏈接進 web profile：
git clone https://github.com/Pidreamleaves/dsh-pi-kit.git
cd dsh-pi-kit
pnpm install
pnpm -r build
dsh plugin --profile web add link:<絕對路徑>/dsh-pi-kit/packages/auto-review
dsh plugin --profile web add link:<絕對路徑>/dsh-pi-kit/packages/approval-chime
dsh plugin --profile web add link:<絕對路徑>/dsh-pi-kit/packages/pi-kit-settings
重啓 dsh web 生效；之後改完代碼執行 pnpm -r build 再重啓即可。
適用場景與注意¶
適合兩類人：一是經常讓 DSH 執行命令、希望減少手動確認負擔又不想放棄安全底線的用戶；二是習慣把任務丟到後臺、需要及時知道「該回來了」的用戶。兩個功能可以聚合安裝，也可以按需單裝，不需要的不用引入。
安裝前有一點需要明確：這類客戶端插件以當前 dsh 進程的權限運行，它拿到的權限就是你的權限。dsh-pi-kit 是 MIT 許可、源碼公開的，安裝前建議過一遍倉庫源碼，確認審覈規則和依賴符合自己的預期，再決定是否啓用。
結尾¶
dsh-pi-kit 做的事情不復雜：把「危險操作別漏攔」和「等待事件別錯過」這兩個高頻小需求做成插件，一次安裝、默認啓用、在一張設置卡里調整。如果你的日常 DSH 使用也被這兩件事困擾，可以試試。
- GitHub：https://github.com/Pidreamleaves/dsh-pi-kit
- 也可以在 DSH 社區插件目錄中檢索
dsh-pi-kit查看收錄頁。
