前言¶
DSH 生態強調「一切皆插件」。做插件時，常見麻煩有兩類：一類是開發本地 DSH 配置，容易把真實 ~/.dsh 弄髒；另一類是對第三方插件是否可靠沒有把握。如果只是直接在當前 DSH 配置裏試裝、試拔，容易碰到狀態污染和殘留問題。
下面介紹 @swell05/dsh-whale-tank。它是一個 DSH 插件開發沙盒輔助工具：隔離 DSH_HOME，建立開發態的 DSH 配置沙箱與插件開發骨架，附帶開發知識包、插拔副作用檢測與沙箱復原，以及第三方插件 vet 體檢功能。
這是什麼¶
@swell05/dsh-whale-tank 由 swell05 維護，採用 MIT 許可證。它不改動真實 ~/.dsh，而是在獨立 DSH_HOME 中建立開發沙盒，用於插件初始化、構建、插拔測試、復原和第三方插件預檢。
它適合在 dsh web 模式下做 DSH 插件開發，或對 npm 包形式的第三方插件做檢查。
核心功能¶
插件開發沙盒¶
init 會創建獨立的 DSH_HOME、官方基線 profile 和 state.json，不改動真實 ~/.dsh。
骨架按 host、client、both 類型生成，可構建，並附帶開發工具包。
開發知識包¶
可選載入 AGENTS.md、NOTES.md、docs/dev-guidance 等開發知識包。它按 merge-spec 增量合併，不覆蓋用戶已有內容。
.wttools 工作區工具¶
.wttools 是零依賴單文件工具，插件卸載後仍可用。常用命令如下：
| 命令 | 用途 |
|---|---|
.wttools\status |
沙盒狀態體檢 |
.wttools\deps |
添加依賴 |
.wttools\plug |
把項目插件接入沙盒 |
.wttools\unplug |
取出插件並檢查 |
.wttools\plug-test |
插拔測試 |
.wttools\run-test |
實跑指定 profile |
.wttools\restore |
復原沙盒 |
.wttools\reset |
重建沙盒 |
.wttools\upgrade-knowledge |
升級知識包 |
第三方插件 vet 體檢¶
vet 用於檢查第三方插件，分三個階段：
- 靜態危害檢查
- 受限動態驗證
- LLM 源碼審查
體檢結果會生成 vet-report.md 和 vet-result.json，落在 .vetting/。結論三選一：未發現漏洞、謹慎、不建議。
安裝與啓用¶
先確認環境滿足：
node >=20peerDependencies: @deepseek-ai/cordis ^4.0.1
安裝到 web profile：
dsh plugin --profile web add @swell05/dsh-whale-tank
裝完重啓 web（bundle 層棧在 boot 合成）。
如需卸載：
dsh plugin --profile web remove @swell05/dsh-whale-tank
典型用法¶
初始化插件項目¶
在 dsh web 的空工作區對話裏輸入：
/whale-tank-init
說明插件主要功能後，它會創建沙盒和骨架，並可載入開發知識包。
體檢第三方插件¶
輸入：
/whale-tank-vet
把想檢查的 npm 包名提供給它，三階段體檢自動走完。檢查完成後查看 .vetting/ 下的 vet-report.md 與 vet-result.json。
使用 .wttools¶
常用命令示例：
.wttools\status
.wttools\deps --add @deepseek-ai/dsh-tools
.wttools\run-test --profile headless
如果骨架生成後 npm run build 報 tsc 不存在，先執行：
npm install
或：
.wttools\deps
然後再執行：
npm run build
適用場景與注意¶
適合在 dsh web 模式開發 DSH 插件，或需要對第三方 npm 插件做預檢。
注意事項：
vet是啓發式預檢，不是安全保證。- 隔離靠獨立
DSH_HOME和受限執行，防狀態污染，不防本機執行。 - 網絡行爲只記錄，不阻斷。
vet只在web裏經/whale-tank-vet使用，CLI 暫不提供。plugin通道強制版本一致性，版本與沙盒運行時不一致時直接拒絕。- Skills 與 Tools 僅測試過
dsh web模式。 - DSH 插件以當前
dsh進程權限運行。安裝前應檢查源碼與許可證。
參考¶
GitHub：https://github.com/swell05/dsh-whale-tank
