前言¶
DeepSeek Harness (DSH) 的設計理念是“一切皆插件”。在 Linux 環境下，智能體若要獲取包信息、命令診斷數據或 CVE 漏洞情報，通常需要通過外部接口。dsh-plugin-pkgseek 插件通過適配 PkgSeek API，將這些能力封裝爲原生 DSH 工具，使智能體可以直接在 DSH 流程中調用。
是什麼¶
該插件由 web-casa 維護，開源協議爲 MIT。它是一個薄型適配器，在插件加載時通過 tools/list 動態註冊工具，並將請求轉發到 PkgSeek API。
安裝與啓用¶
插件通過 npm 包發佈，支持 Web 和 Desktop 客戶端。若同時使用兩種客戶端，需在兩個 profile 下安裝。
- Web 客戶端安裝
dsh plugin --profile web add dsh-plugin-pkgseek
- Headless 客戶端安裝
dsh plugin --profile headless add dsh-plugin-pkgseek
- 從 GitHub 源安裝
dsh plugin --profile web add github:web-casa/dsh-plugin-pkgseek
核心能力¶
-
工具註冊與轉發
插件在加載時通過tools/list動態註冊原生 DSH 工具（名稱前綴爲pkgseek_），並通過tools/call轉發請求到 PkgSeek API。 -
離線快照支持
插件內置了離線快照。當tools/list請求失敗時，插件會自動回退到快照中的工具列表，保證基本可用性。 -
系統提示指南
插件提供promptGuidance，用於輔助智能體判斷何時使用這些工具。 -
只讀操作
所有提供的工具均爲只讀，無寫入權限。
可用工具列表¶
插件提供約 22 個只讀工具，分爲以下類別：
- 命令與工具智能：
pkgseek_search_tools,pkgseek_get_tool,pkgseek_resolve_install,pkgseek_identify_binary,pkgseek_query_file_provides,pkgseek_compare_distros,pkgseek_get_context - 錯誤與命令診斷：
pkgseek_diagnose_linux_error,pkgseek_lint_command,pkgseek_explain_command,pkgseek_suggest_fix - 包管理：
pkgseek_search_packages,pkgseek_get_package,pkgseek_compare_package_versions,pkgseek_get_package_history - 漏洞情報：
pkgseek_search_vulnerabilities,pkgseek_get_vulnerability - 生命週期與遷移：
pkgseek_check_release_lifecycle,pkgseek_get_distro_lifecycle,pkgseek_compare_distro_releases,pkgseek_plan_distro_migration - 元數據：
pkgseek_get_repository_health
配置項¶
插件支持通過配置行控制行爲。所有配置項均爲可選：
- id: pkgseek
name: dsh-plugin-pkgseek
config:
apiBase: https://api.pkgseek.com # PkgSeek API 部署地址
timeoutMs: 20000 # 單次請求超時時間（毫秒）
promptGuidance: true # 是否註冊使用指南提示段
refreshTools: true # 是否在加載時刷新工具列表（默認回退快照）
enabledTools: [] # 允許的工具白名單（爲空則允許所有）
注意事項¶
- 版本要求：需要 DSH
>=0.1.0-rc.7 <0.2.0。 - 權限與安全性：所有工具均爲只讀，無需 API 密鑰。
- 發佈流程：插件採用手動發佈流程，使用 OIDC 進行驗證。
- 適用場景：適用於需要 Linux 系統級情報查詢的場景。
總結¶
該插件爲 DSH 提供了結構化的 Linux 包、命令與 CVE 智能能力，通過原生工具接口集成，保持了 DSH 的安全性與一致性。源碼與目錄頁鏈接如下：
- GitHub 倉庫
- 社區目錄
