在開發 DeepSeek Harness (DSH) 插件時，智能體往往需要調用外部命令行工具（如 gh, jq, ffmpeg）。直接在代碼中拼接 Shell 腳本進行安裝存在注入風險且難以驗證。dsh-cli-store 提供了一個經過審查的註冊表和安裝器，專門用於管理這些外部 CLI 工具。
這是什麼¶
dsh-cli-store 是由 Harzva 維護的 DSH 插件，旨在解決外部 CLI 工具的安裝與驗證問題。它不替代 DSH 插件市場，而是作爲註冊表，描述運行在 DSH 之外的二進制工具，並通過 DSH Bundle 將其集成到代理中。
核心功能¶
安裝後，插件註冊了以下工具：
dsh_cli_search：在本地註冊表中搜索。dsh_cli_list：列出當前平臺的所有註冊表項。dsh_cli_discover：通過適配器搜索公共源並保存結果。dsh_cli_saved：讀取本地保存的發現結果。dsh_cli_install_discovered：安裝已保存且經源驗證的條目。dsh_cli_doctor：檢查已註冊 CLI 的版本響應。dsh_cli_install：顯示安裝計劃並執行。
安裝與啓用¶
安裝插件需要使用 DSH 的 profile web 模式：
dsh plugin --profile web add https://github.com/Harzva/dsh-cli-store/releases/latest/download/dsh-cli-store-0.3.0.tgz
典型用法¶
- 搜索工具：
dsh-cli-store search workbench
- 列出註冊表：
dsh-cli-store list --
- 網絡發現並保存：
dsh-cli-store discover "image cli" --source github --limit 10 --save
- 查看已保存項：
dsh-cli-store saved image --
- 安裝已發現的項：
dsh-cli-store install-discovered homebrew:ffmpeg --confirm --no-dry-run
- 診斷 CLI：
dsh-cli-store doctor gh
- 查看安裝計劃：
dsh-cli-store plan install gh
- 執行安裝：
dsh-cli-store install gh --confirm --no-dry-run
安全與限制¶
插件採用安全優先的設計：
- 註冊表條目和安裝參數是經過審查的數據，而非原始 Shell 片段。
- 子進程使用
shell: false，禁止任意 Shell 字符串評估。 - 可執行安裝程序僅限於代碼允許的包管理器命令（如 brew install, winget install 等），手動安裝器僅提供文檔。
- DSH 默認爲幹運行模式，必須同時設置
confirm=true和dryRun=false才能執行寫入操作。 - 醫生模式僅調用聲明的 CLI 及其版本參數。
- 發現功能在未顯式請求時是隻讀的，且發現結果被視爲不受信任的元數據，僅作爲數據展示。
適用場景與注意¶
適合需要管理大量外部 CLI 工具的 DSH 插件開發者。使用時需注意，該插件以當前 DSH 進程的權限運行，安裝前應審查源碼與許可證。
總結¶
dsh-cli-store 通過嚴格的權限控制和驗證機制，爲 DSH 生態提供了可控的外部工具管理方案。
- 項目主頁：https://github.com/Harzva/dsh-cli-store
- 插件目錄：https://www.skillhub.cn/plugins/Harzva/dsh-cli-store
