前言¶
DeepSeek Harness 的理念是「一切皆插件」，能力可以被组合、替换、扩展。但这把原本由平台承担的工作转移给了使用者：判断需求是否值得、确认 Harness 是否原生支持、确认接口契约、应对版本更新带来的兼容性问题。对 Agent 来说，每次都要重新支付一遍认知成本。
dsh-plugin-maker 是一个工具集合，旨在将官方教程里的方法论机器化。它提供向导、骨架生成、校验与诊断工具，把固定的目录结构、入口形式、导出要求变成确定性机制，管理「插件化自由」带来的工程成本，帮助判断「这个东西到底应不应该成为插件」。
是什么¶
DeepSeek Harness 插件开发工坊，提供向导、骨架生成、校验与诊断工具。
核心功能¶
该插件包含以下核心能力：
* 插件骨架生成
* 契约与发布合规校验
* 第三方插件体检
* 安全修改自动应用
* 变更影响分析
* 任务清单生成
* 工具面诊断
* 需求满足向导
* 分类调研
* 上游挂点盯梢
安装与启用¶
安装命令如下：
pnpm pack && dsh plugin --profile web add file:<本目录>/dsh-plugin-maker-<版本>.tgz
典型用法¶
- 生成骨架：使用
plugin_maker_scaffold生成合规插件骨架。 - 校验：使用
plugin_maker_check进行契约与发布合规检查。 - 接盘第三方插件：使用
plugin_maker_vet进行体检，使用plugin_maker_adopt对安全、确定的部分进行自动应用。 - 诊断工具面：使用
plugin_maker_surface诊断工具面，判断是否需要收窄原语。 - 需求向导：使用
/plugin-studio-wizard进行需求满足向导。 - 分类调研：使用
/five-step-research进行分类调研。
适用场景与注意¶
- 纯开发期工具，无硬依赖。
- 不做运行时收窄（facade 无法隐藏工具）。
- 不沉淀运行期教训/踩坑记录。
- 不碰 preset / cordis 组合与动态 Cordis 插件。
- 非自动生成器，需求与架构由用户决定。
总结¶
dsh-plugin-maker 通过提供骨架生成、合规校验、体检改造与向导等工具，降低了插件化开发中的工程成本，帮助开发者明确需求与架构，而非盲目生成代码。
