dsh-plugin-developer-skill

dsh-plugin-developer — DeepSeek Harness 插件开发 Skill 指导 AI Agent 从 0 到 1 开发、构建、安装、测试、发布 DeepSeek Harness（dsh）插件。基于 dsh 0.2.x（官方文档 + 四个已上架开源插件实战），内置完整可运行的 0.2.x 骨架与两个历史实战案例。 这是什么

dsh 采用"无特权内核、万物皆插件"的设计：模型适配器、工具注册表、Agent 循环、网页界面都是插件。给 dsh 增加新能力 = 写一个插件包挂到 Cordis 容器上，不需要 fork 源码。

一个插件 = Host 半边（Node：工具/技能/系统提示/HTTP/数据）+ Client 半边（浏览器：页面/标签页/命令/Toolview）。这个 Skill 把"写一个 dsh 插件"做成可复用工作流：

目录结构

快速上手（给 AI Agent 的调用指引）

1. 先读 SKILL.md：按第 0~6 步执行（选型→环境→骨架→实现→构建→测试→发布）。 2. 按需读 references（渐进式加载，别一次全读）。 3. 生成骨架：python scripts/scaffold_plugin.py --name dsh-my-plugin，先跑 npm test && npm run build 确认基线，再填充逻辑。 4. 对照蓝本：能力疑问先看 assets/plugin-skeleton/ 对应文件；外部生成 API/CLI 集成看 assets/examples/dsh-seedance-studio/。 给用户的快速说明 让模型多一个动作 → Tool：ctx.tools.register（defineTool 或原生对象+自写校验），结构化数据经 presentationMeta 给浏览器渲染。 教模型按规范产出 → Skill：SkillProvider { list, get }，候选常驻、正文按需。 要用户能打开的页面 → Client 侧栏入口 + Host webServer 前缀路由伺服页面与数据。 要 /命令、会话标签页、右侧面板、设置卡片 → 对应 Client 面（browser-side.md 槽位地图）。 要本机存数据 → $DSH_HOME/ / + Host 工具读写（沙箱写不了工作区外）。 调宿主已配好的模型 → ctx.get('llm')（host-integration.md），不要自带密钥。 硬约束速记（0.2.x） 参考与致谢

本 Skill 的 0.2.x 升级基于以下一手材料，感谢这些开源项目： 官方文档：https://deepseek-harness.github.io/deepseek-harness/ （develop/basic、framework、reference/cookbook） dsh-context（bowenliang123）— 仪表板/斜杠命令/设置卡片/兼容层的权威样本 dsh-guizang-design（歸藏/op7418）— 附《dsh插件开发教程》，技能包+页面+工具模式的范本 dsh-media-desk（蜗牛的科技笔记）— HTTP 型插件、安全加固、mock 测试工作流 GeoChat（tiwe0）— 原生工具+55 技能+离线资源的 DSH 插件 历史案例 weather-plugin（以及已被 dsh-seedance-studio 替代的 ecom-details-image-plugin）与 特别致谢社区支持： https://linux.do License

MIT