前言¶
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 仓库
- 社区目录
