用途
dsh-plugin-developer 用于在 DeepSeek Harness（dsh）0.2.x 中开发插件、为 dsh 增加新能力。dsh 没有特权内核：模型适配器、工具注册表、Agent 循环、网页界面都是插件，因此增加能力的方式是编写插件并挂载到 Cordis 容器，不需要 fork 源码。
主要能力
- 需求诊断与选型：按能力面地图判断需求应使用哪种注册方式，包括工具注册（ctx.tools.register）、技能提供者（ctx.skills.registerProvider）、系统提示（ctx.systemPrompt.section）、侧栏页面、命令、会话标签、设置卡片、本机持久数据、外部 API 调用等，并区分 Host 半边与 Client 半边。
- 提供插件骨架与脚手架：骨架是一个完整可运行的最小插件闭环，包含工具（原生注册、自写校验、presentationMeta）、技能（含 addendum）、系统提示、插件页面（webServer 前缀路由、鉴权、safeFile）、$DSH_HOME 数据持久化、Client 半边（侧栏与 main 槽、主题跟随）、esbuild 打包自检、node --test 单测和 dev-sandbox 隔离开发脚本。脚手架脚本为 python scripts/scaffold_plugin.py <项目目录> --name dsh-my-plugin。
- 分主题实现指南：工具、技能、系统提示、外部 API 调用、插件页面与数据、浏览器端、深度集成、安全、插件类型、构建测试、发布、排错，均有对应参考文档，按需读取。
- 构建与测试流程：npm install && npm test && npm run build；测试包括纯函数/契约测试、隔离 DSH_HOME 跑网页版、mock 模型全链路测试和 web 界面人工验收。
- 发布指导：发布前过安全清单，npm pack、npm publish 或 Release tgz+SHA256，含安装途径、桌面版差异、engines.dsh 兼容声明与市场元信息。
使用方式
工作流分七步：第 0 步诊断需求并选型；第 1 步环境准备（Node 22.19+ 或 24+，确认 dsh -v 可用）；第 2 步用脚手架或复制 assets/plugin-skeleton/ 搭骨架；第 3 步按需读对应指南实现能力；第 4 步构建；第 5 步测试；第 6 步发布。在 dsh 自身对话内开发时，以宿主内 inspection 结果为准，装插件用 install_bundle，不要手改 profile。
适用场景
用户要求开发、编写、创建、搭建 dsh 插件，或为 dsh 增加新能力时使用，包括编写工具、技能、系统提示、插件页面、数据持久化、外部 API/CLI 集成与深度集成等。
限制
目标版本为 dsh 0.2.x，骨架默认 engines.dsh 区间为 >=0.2.1-rc.2 <0.3.0。示例中 weather-plugin 为 0.1.x 历史案例，构建链已过时。其余收费、平台等事实资料未提供。