前言¶
DeepSeek Harness (DSH) 采用「一切皆插件」的理念，Agent 在扩展能力时，面临社区插件来源复杂、版本浮动、潜在风险难以把控的问题。dsh-agent-plugin-research 是一个面向 Agent 的专用工具，用于在安装 DSH 社区插件前完成搜索、版本固定、风险检查和用户确认，并提供安装后的验证与激活方案。
基本定位¶
这是一个 Agent 专用的 DSH 插件检索、审计、安装与验证工具桥。由 Asteroid0449 维护，采用 MIT 许可证。它不提供设置页、可视化市场、客户端 bundle 或 Web 路由，而是作为 Agent 的后端能力，协助其进行插件的检索、审计、安装与验证。
核心功能¶
该插件提供七项固定工具，始终以固定顺序注册：
- 检索与检查：搜索 GitHub、npm、私有索引或离线精选表；检查 manifest、安装脚本和
cordis.patch.yml风险。 - 安装与卸载：使用 pnpm 永久安装或移除依赖，并协调 bundle 清单。
- 验证与规划：验证包身份、锁文件、patch 和 profile 层；检测当前 Agent 可见能力并生成激活步骤。
- 清单管理：列出 profile 依赖、运行入口和有序 bundle 层。
安装与启用¶
安装前需确保环境满足要求：Node.js >= 22.19.0，DSH >= 0.1.0-rc.8。
在下载目录执行以下命令进行安装：
dsh plugin --profile web add .\dsh-agent-plugin-research-0.5.1.tgz
如果仓库源码已在本机，可先运行验证脚本：
.\verify-and-install.cmd
安装完成后，插件不会自行调用激活或重启工具，需由 Agent 根据生成的方案进行后续操作。
典型用法¶
插件的使用分为“审查”和“安装”两个阶段。
-
审查阶段：在正式写入前，先让 Agent 搜索并审查一个适合 DSH 的插件。示例提示词如下：
> 搜索并审查一个适合 DSH 的插件，先不要安装。列出版本身份、安装脚本、bundle patch 风险和建议的激活方式。 -
安装与确认阶段：确认报告内容无误后，执行安装并请求验证。示例提示词如下：
> 安装刚才固定的版本；在任何永久写入前向我确认，安装后验证 profile 登记并给出激活方案。
安全边界与注意事项¶
- 权限与确认：安装和卸载必须显式确认；审批通道存在时，审批失败或不可用会拒绝写入。
- 安装限制：安装仅接受精确 npm 版本、固定 GitHub commit，或位于
allowedFileRoots内的本地file:路径。 - 验证范围：
verify只证明安装元数据一致，不证明运行时服务、Web 客户端或原生产物已经工作。 - 运行环境：插件以当前 DSH 进程权限运行，需审查源码与许可证后再决定是否安装。
激活路径¶
根据环境不同，激活方案包含三种路径：
* dsh-super-injector 的 dev_* 工具（开发态）。
* 用户 cordis.patch.yml（配置态）。
* dsh-restart-resume（正式态）。
插件只给出方案，不包装或偷偷调用其他工具。
总结¶
dsh-agent-plugin-research 是一个专注于安全与可控的 Agent 工具桥。它帮助 Agent 在扩展 DeepSeek Harness 能力时，通过强制审查、版本固定和显式确认机制，降低引入第三方插件的风险。
