插件调研安装桥 Asteroid0449/dsh-agent-plugin-research

dsh-agent-plugin-research

让智能体在安装 DSH 社区插件前先完成搜索、固定版本、风险检查和用户确认，并在安装后给出可验证的激活方案。

本项目是智能体工具桥，不是面向人的可视化插件市场。它没有设置页、客户端 bundle 或 Web 路由。

30 秒快速开始

要求：Node.js 22.19+、DeepSeek Harness 0.1.0-rc.8+。

从 Releases 下载当前固定版本的压缩包，在下载目录运行：

dsh plugin --profile web add .\dsh-agent-plugin-research-0.5.1.tgz

如果仓库源码已经在本机，也可以先测试再安装：

.\verify-and-install.cmd

安装完成后，用已有的 DSH 生命周期方式加载插件：开发态可使用可见的 dsh-super-injector 工具；正式 bundle 变更使用受监督重启。插件不会自行调用任何激活或重启工具。

首次验证可直接告诉智能体：

搜索并审查一个适合 DSH 的插件，先不要安装。列出版本身份、安装脚本、bundle patch 风险和建议的激活方式。

确认报告后再说：

安装刚才固定的版本；在任何永久写入前向我确认，安装后验证 profile 登记并给出激活方案。

工作流程

flowchart LR
A[搜索候选] --> B[固定版本或 commit]
B --> C[检查 manifest 与 patch]
C --> D{用户确认与审批}
D -- 拒绝 --> X[停止，不写入]
D -- 允许 --> E[持久化安装]
E --> F[验证依赖、锁文件与 bundle]
F --> G[选择激活路径]
G --> H[激活后验证运行时]

七项固定工具

| 工具 | 作用 | 写入 | 是否需要确认 |
| plugin_research_search | 搜索 GitHub、npm、私有索引或离线精选表 | 否 | 否 |
| plugin_research_inspect | 检查 manifest、安装脚本和 cordis.patch.yml 风险 | 否 | 否 |
| plugin_research_list_installed | 列出 profile 依赖、运行入口和有序 bundle 层 | 否 | 否 |
| plugin_research_install | 用 pnpm 永久安装并协调 bundle 清单 | 是 | confirm: true，且使用可用的审批服务 |
| plugin_research_uninstall | 永久移除依赖并协调 bundle 清单 | 是 | confirm: true，且使用可用的审批服务 |
| plugin_research_verify | 验证包身份、锁文件、patch 和 profile 层 | 否 | 否 |
| plugin_research_activation_plan | 检测当前智能体可见能力并生成激活步骤 | 否 | 否 |

工具始终以固定顺序和固定 schema 注册。可选插件是否存在只改变显式调用 activation_plan 后的结果，不改变模型请求前缀。

安装位置：谁负责什么

| 层 | 普通用户应如何理解 |
| DSH profile | 权威的依赖登记和 bundle 顺序，例如 ~/.dsh/profiles/web |
| profile node_modules | DSH 实际解析到的运行时包入口 |
| 源码工作区 | 只在 link: / file: 安装时单独存在 |
| pnpm store | 共享内容缓存，不是插件源码目录，也不是激活位置 |

输出不会假设固定盘符、用户名或全局 pnpm store 位置。

三种激活路径

| 路径 | 适合场景 | 持久化 | 是否重启 |
| dsh-super-injector 的 dev_ 工具 | 本地开发、热注入、卸载与重载 | 取决于其开发工作流 | 通常不需要 |
| 用户 cordis.patch.yml | 已能从 profile 解析的包，进行事务化配置 HMR | 是 | 成功时不需要 |
| dsh-restart-resume | 永久 bundle 安装/移除后正式加载后端与前端 | 是 | 是，受监督 |

写 patch 不会下载依赖，也不能猜测插件的 id、name 或配置结构。本插件只给方案，不包装或偷偷调用其他工具。

安全边界

- 安装仅接受精确 npm 版本、固定 GitHub commit，或位于 allowedFileRoots 内的本地 file: 路径。
- 第三方包可能执行安装脚本；应先 inspect，再单独审查需要放行的 allowBuildPackages。
- pnpm 使用无 shell 的异步子进程；Windows 直接运行 pnpm 的 JavaScript 入口。
- 安装和卸载必须显式确认；审批通道存在时，审批失败或不可用会拒绝写入。
- verify 只证明安装元数据一致，不证明运行时服务、Web 客户端或原生产物已经工作。
- GitHub 认证默认读取 GITHUB_TOKEN 或 GH_TOKEN；不要把 token 写进配置、提示词或问题报告。

配置

cordis.patch.yml 可配置额外 JSON 索引、GitHub token 环境变量名、本地文件白名单根目录和 pnpm 行为。私有索引应返回固定且可审查的包身份，不应把浮动分支伪装成已固定版本。

常见问题

| 现象 | 处理 |
| GitHub 搜索被限流 | 设置 GITHUB_TOKEN / GH_TOKEN，或等待结果报告的重置时间；可使用 npm 身份继续只读检查 |
| pnpm 阻止构建脚本 | 审查失败结果中的包名，只把确认过的精确名称放入 allowBuildPackages 后重试 |
| 安装成功但没有激活方案 | 先运行 plugin_research_verify；依赖、锁文件、manifest、patch 与 bundle 必须一致 |
| 看不到 dev_ 或重启工具 | 这些是可选生命周期能力；安装相应插件或选择当前环境可用的路径 |
| 插件「装在 pnpm store」 | store 只是缓存；以 profile 登记和 profile node_modules 解析结果为准 |
| GitHub 分支或 npm latest 被拒绝 | 改用固定 commit 或精确版本，重新 inspect 后再安装 |

开发验证

npm ci
npm test
npm pack --dry-run

CI 在 Windows + Node.js 22.19 上执行同样的测试与打包检查。提交问题时请附 DSH/Node 版本、目标 profile、已脱敏的工具结果和最小复现步骤。

反馈与社区

插件问题请提交到本仓库 Issues。确认属于 Harness 上游的问题，再前往 DeepSeek Harness Discussions。贡献前请阅读贡献指南，安全问题请阅读安全策略。

致谢与项目状态

本项目是独立维护的 DeepSeek Harness 社区插件，并非 DeepSeek 官方产品，也未获得 DeepSeek 的背书、合作或认证。感谢 DeepSeek Harness 团队提供插件平台、bundle 机制与开发文档。

感谢 dsh-super-injector 项目公开其 dev_* 开发生命周期工具与运行时注入实践。本插件仅在这些工具对当前智能体可见时，将其识别为可选的开发态激活路径并给出建议；不会代替用户调用、打包或依赖 dsh-super-injector。插件的搜索、审查和持久化安装能力不以它为前提。

DeepSeek Harness、DeepSeek 及其他第三方项目的名称与商标归各自权利人所有；本文提及这些名称仅用于说明兼容性和项目关系。

许可证

MIT