JerryChaox/dsh-plugin-development

DSH 插件开发

一份架构优先的实战指南与 Agent Skill，用于为
DeepSeek Harness 及其
Cordis 运行时构建插件。

本项目为独立的社区作品，与 DeepSeek 无关联，亦未获得其认可。

核心理念

DSH 插件不仅仅是一个注册 Tool 的 JavaScript 模块。它同时是五个系统：

flowchart LR
A["Cordis capability graph"] --> B["Tool contract"]
B --> C["Model / Code / UI projections"]
C --> D["Durable session replay"]
D --> E["Product interaction"]
A --> F["Profile and package closure"]
F --> E

大多数棘手的故障都发生在把其中某个边界误认为另一个边界之时：

- 将规范化的 Tool 值与面向模型渲染的内容混为一谈；
- 假定实时卡片是可回放的；
- 在没有真实 owner/selection/slot 链路的情况下测试 React 组件；
- 原子列表 Tool 把模型变成了分页引擎；
- monorepo 让未声明的运行时依赖看起来像是已安装；
- 把配置顺序误认为 Cordis 激活。

SKILL.md 教授一种可复用的方法来推理这些边界。
故障图谱 将常见症状映射到其背后错误的心智模型。

本仓库包含的内容

- SKILL.md —— 可安装的 Agent Skill；
- references/failure-atlas.md —— 症状 → 失效边界 → 正确诊断；
- scripts/check-plugin-closure.mjs —— 一个只读的包/构建/peer 依赖
检查器，用于树外 DSH 插件；
- evals/evals.json —— 用于评估 Agent 是否真正学会了架构、而非死记清单的
真实提示词。

作为 Agent Skill 安装

将仓库克隆到你的 Agent 运行时识别的 skill 目录中：

git clone https://github.com/JerryChaox/dsh-plugin-development.git \
~/.agents/skills/dsh-plugin-development

如需项目本地安装，请将其放在：

/.agents/skills/dsh-plugin-development/

该 Skill 应在以下场景触发：DSH/Cordis 插件工作、Tools、Code Mode、客户端
slots、回放 bug、profile 打包、空白详情面板，以及在源码检出中可用但安装后
失败的插件。

检查插件的安装闭包

先构建目标插件，然后运行：

node scripts/check-plugin-closure.mjs /path/to/plugin

该检查器会验证已声明和已构建的 host/client 入口点、bundle 补丁、
客户端注入，以及每个 peer 依赖是否都能从插件自身的安装位置解析。

它刻意不证明插件处于激活状态。请单独检查实际的 DSH
profile：

dsh --profile  --dump-config

设计论点

Agent 应选择业务意图与约束。高层 Tool
应执行数据计划。UI 应帮助人们审视由此产生的决策。
这种分离方式比要求模型手动翻阅大型数据集、将中间 JSON 复制到上下文中，并向用户解释内部 Tool 字段要稳健得多。

许可证

MIT