dsh-plugin-scaffold

在 DSH（DeepSeek Harness）生态里搭一个「树外」插件，难点往往不在业务代码，而在 bundle 三行该怎么分工、宿主与浏览器端如何分半构建、版本混装时谁来门禁。改上游包既不可行也不该做；从零抄模板又容易漏掉兼容性裁决或验证链里的某一环。dsh-plugin-scaffold 把这类容易搭错的基础设施先摆好，让你把精力留给真正的插件行为。

脚手架提供完整的 bundle 骨架：兼容性门禁行、宿主服务行、以及浏览器 client 图的唯一锚点行，三者职责清晰。构建侧用 tsdown 产出宿主 ESM 与浏览器闭包工厂，tsc 产出两套类型声明；兼容性层则维护精确版本 allowlist，并对 unsupported、mixed、incomplete 等状态给出明确判定与升级车道。工程上还自带类型检查、lint、单测、组合冒烟、打包门禁与文档检查等一整条 verify 链路，并约定 AGENTS.md、docs 分区与双语 README 等协作习惯。

当前仓库刻意只交付可运行的占位：`src/service.ts` 暴露占位服务，客户端 `apply` 仍为空。把标识符按文档表替换、在 compat 里对齐核心包依赖，再跑通验证，即可在此基础上实现你的服务与 UI 补丁。若宿主版本不在支持矩阵内，或核心包版本混装，门禁服务行不会启动，组合会退化为「未安装该插件」——这是设计选择，而非疏漏。

适合准备发布 DSH 插件、希望与上游 deepseek-harness 解耦、又需要可重复工程标准的团队或个人开发者；不适合只想找一个已完成功能的成品插件直接安装使用。