前言¶

在 DeepSeek Harness（DSH）的插件生態中，直接管理 NPM 註冊表是一個常見需求。dsh-npm 作爲一個聯網工具，旨在讓智能體直接通過註冊表 API 或本地 npm CLI 完成包信息的查詢、搜索、版本覈對以及發佈和棄用操作，無需開發者手動干預。

插件介紹¶

名稱：dsh-npm
維護者：zhengjy01
類別：聯網工具
許可證：MIT

該插件通過調用 npm 官方 JSON API 處理查詢類操作，對於發佈和棄用操作則調用本地 npm CLI，並支持通過配置文件注入 Token 以訪問私有包。

核心功能¶

插件提供了以下工具能力：

1. npm_status：檢查插件運行狀態，包括當前生效的註冊表、Token 是否配置、本地 npm CLI 是否可用以及配置文件路徑。
2. npm_config：配置註冊表基礎 URL 和認證 Token。配置項存儲在 ~/.dsh/dsh-npm.（權限 0600），支持 reset: true 清除配置。
3. npm_info：獲取包的詳細元數據，包括最新版本、描述、作者、許可證、倉庫地址、發佈時間戳以及依賴摘要。
4. npm_versions：列出註冊表中該包所有已發佈的版本及其對應的發佈日期。
5. npm_search：根據關鍵詞（包名、描述、作者、評分）在註冊表中進行搜索。
6. npm_publish：執行真實的 npm publish。支持參數包括 dir（發佈目錄）、tag（標籤）、access（訪問權限）、otp（雙因素驗證）、registry（指定註冊表）、dryRun（預演模式）和 force（強制覆蓋）。
7. npm_deprecate：在註冊表中將包或特定版本標記爲 deprecated。
8. Web 面板：在 DSH 設置頁面中提供可視化的 NPM 面板，用於配置註冊表和 Token（Token 值會掩碼顯示）、快速查詢包信息和搜索註冊表。

安裝與啓用¶

在安裝前請確認 DeepSeek Harness 版本 >= 0.1.5-rc.1。

使用官方安裝命令：

dsh plugin --profile web add dsh-npm

安裝完成後，需要重啓 DSH Web 服務才能生效。

典型用法¶

1. 查詢公開包信息：無需任何配置，直接使用 npm_info 查詢 express 等公開包的元數據。
2. 配置私有包認證：使用 npm_config 設置私有註冊表地址或 Token。
3. 發佈前檢查：在執行 npm_publish 前，先使用 npm_info 或 npm_versions 確認目標版本不存在，避免衝突。
4. 安全發佈：先使用 npm_publish 配合 dryRun: true 參數進行預演，確認無誤後再執行正式發佈。
5. Web 界面操作：進入設置頁面的 NPM 面板，直接進行配置和搜索。

適用場景與注意¶

• 環境要求：插件依賴 DeepSeek Harness >= 0.1.5-rc.1。
• 權限與安全：插件以當前 DSH 進程的權限運行，安裝前請務必檢查源碼。Token 以 0600 權限存儲在本地文件中，並通過臨時配置文件注入命令，絕不會被打印在日誌或命令行中。
• 操作風險：
• npm_publish 和 npm_deprecate 操作會直接寫入註冊表，且不可逆。
• force: true 參數會強制覆蓋已存在的版本（npm 默認會阻止覆蓋），使用時需格外小心。
• 生態說明：插件目錄爲社區站點，與 DeepSeek 或幻方無官方從屬關係。

結尾¶

dsh-npm 爲 DeepSeek Harness 提供了完整的 NPM 註冊表管理能力，適合需要在智能體中自動處理包版本、發佈或查詢的開發者。相關目錄頁及源碼位於：GitHub。