DSH插件开发助手

解决的问题

开发 DeepSeek Harness 插件通常涉及底层配置和框架术语（如 bundle-client、cordis.patch.yml），导致从自然语言需求到可运行插件之间存在代码断层。对于仅描述功能（例如“添加一个命令”或“做个设置面板”）的用户，手动处理形态决策、代码生成和验证流程既复杂又易错，尤其当需要同时支持前后端时。

核心能力与工作流程

DSH插件开发助手通过配方装配模式解决这一问题。它提供 8 个预构建的 配方 模块，每个对应特定能力面，例如：

• command-tool：用于处理命令和工具。
• http-api：提供 HTTP 路由接口。
• settings-panel：生成浏览器设置面板。
• service-provider：对外提供服务和事件总线。

这些配方可按需组合，AI 会基于自然语言需求，使用推荐默认值（如默认 bundle-client 形态）完成决策。

工作流程遵循六个严格步骤，每步设有决策门：

1. 需求捕获：将用户目标复述为“一句话目标”，并逐一勾选能力面清单（如命令、UI、服务等）。
2. 形态与分发决策：根据是否需要网页界面，选择 pure（纯后端）、bundle（组合层）或 bundle-client（默认，含界面）。
3. 配方装配：AI 直接生成完整项目文件，合并配方代码，确保所有注册在 ctx.effect() 内，并包含冒烟功能（如 hello 命令、health 路由和 UI 标记）。
4. 本地验证：检查冒烟功能是否真实可用，并运行 pnpm run bundle 等构建命令。
5. 安装与浏览器冒烟：按分发方式安装后，在浏览器中验证无加载错误（如 plugin tree failed to load），且功能可见可交互。
6. 发布准备：生成 docs/plan.md 记录决策全过程，支持 git 或 npm 分发，并进行最终验收。

关键点：技能优先代码交付，在缺少 pnpm/node 环境时仍能生成等价文件；采用症状优先排查，通过 references/troubleshooting.md 按症状定位问题。

适用边界与注意事项

本技能专注于 DeepSeek Harness 插件开发，适用于：

• 需要快速原型或完整插件的场景，例如添加命令、HTTP 接口、服务或 UI 组件（如状态栏、工作区）。
• 局部问题修复：当遇到 slot 崩溃、注入失败等问题时，可使用“局部问题快速路径”直接处理，无需重跑全流程。

注意事项：

• 形态选择：默认推荐 bundle-client 适合有界面插件；纯后端插件用 pure；需随包分发多个挂载时用 bundle。
• 验证必须通过：确保 package.json 中 main 指向 lib/index.js，且 React 相关包在客户端 bundle 中保持 external，避免打包错误。
• 决策可追踪：每个项目生成 docs/plan.md，记录从需求到发布的决策，便于交接和回放，但发布前需验证所有决策门。