dsh-plugin-guide

一个 Skill,把 DeepSeek Harness (dsh) 官方插件开发文档提炼成「决策流程 + 聚焦 references」,让 agent 写一个正确的 dsh 插件(host/client、工具、服务、事件、配置、LLM 适配器、bundle/profile 发布)时不必重读整个文档站。

内容提炼自官方文档:

• develop/basic(basic / tool / config / publish)
• develop/framework(framework / service / events)
• develop/practice(practice / llm-adapter)
• develop/cordis-tutorial(01-first-plugin / 06-composition-and-hmr / 07-into-the-harness)

结构

skills/dsh-plugin-guide/           # 权威源(供 npx skills add 找)
├── SKILL.md                         # 总纲 + 决策流程 + 三形式速查 + 硬规则 + 取证顺序
└── references/
    ├── cordis-core.md               # Cordis 核心:Fiber / inject / effect / 组合 / HMR / 事件四模式
    ├── entry.md                     # 插件入口三形式 + 生命周期
    ├── config.md                    # schemastery Config + fail-loud
    ├── tool.md                      # defineTool + schema/render/execute
    ├── service.md                   # Service 类 + 三角色 + 声明合并
    ├── events.md                    # ctx.on/emit + 类型化事件 + namespace 约定
    ├── llm-adapter.md               # LlmAdapter + StreamChunk 协议
    └── publish.md                   # bundle/profile + package.json + 分发安装
.dsh/skills/dsh-plugin-guide/      # 镜像(供 dsh 自动发现)
scripts/sync-skill.mjs               # 同步 skills/ → .dsh/skills/,支持 --check 校验

使用

• 通过 npx skills add <本仓库> 安装(读 skills/)。
• dsh 启动时自动发现 .dsh/skills/ 里的镜像。

保持两份一致:

node scripts/sync-skill.mjs          # 同步
node scripts/sync-skill.mjs --check  # 校验镜像是否过期(CI 用)

原则

• 行为不确定时回读官方 checkout 取证,不凭旧文档猜。
• 官方仓库是公开 MIT 许可证据源,默认分支 master,开发者预览阶段无 release tag;一切以当前 checkout 实际代码为准。

License: MIT