dsh-plugin-development
Installation
SKILL.md
DSH 插件开发
版本适用范围:本文主体保留 2026-08-13 的历史模板,不代表当前 Harness 的 API。在 AgentTeams 仓库内处理升级时,先读项目根目录
skills/README.md,再使用项目内dsh-upgrade-audit、plugin-upgrade和plugin-test。独立安装此 skill 时不要求这些同伴文件,仍按 §2 取证。下文的dsh-client-runtime、conversationEvents等旧接口须按目标精确 tag 与 npm 产物重新核实,不能直接用于 Alpha.2 或后续版本。
这是正式版导向的执行清单。先判断运行面,再选择官方模板,实现后必须从真实组合和用户安装路径验证。不要把某个项目的偶然实现当成框架契约。
1. 开始前
- 用
pwd、git rev-parse --show-toplevel、git status --short --branch确认项目与用户改动。 - 读取
package.json、cordis.patch.yml、tsconfig*.json、构建配置、相关src/和测试。 - 不覆盖用户改动,不操作用户明确排除的 profile、端口或实例。
- 判断最小运行面:
- 工具、system prompt、HTTP、持久化、provider:host。
- slot、Conversation Node、浏览器状态和浮层:client。
- host 能力且需要 Web 可视化:host + client。
- 没有 Web 需求:不要声明
dsh.client,也不要构建 client bundle。
- 写下插件唯一职责、依赖的 service、贡献的配置行、持久化 owner 和用户可见验证面,再开始编码。