前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」。开发者在面对模糊的编程需求时，往往在执行前浪费 token，或在执行后丢失经验。dsh-spec-forge 插件通过「需求分级」与「模板沉淀」两件事，将模糊的编程需求锻造成可执行规格，并在每次任务完成后沉淀为会自动复用的个人提示词模板库。
核心功能¶
需求分级：三级响应与三态路由¶
插件在模型请求发出前，根据启发式规则判定下一步动作：
- implement：需求明确（如加字段、改文案、调间距），不追问，直接执行。
- confirm：需求只有容器（如「加个按钮」），使用 ask_user_question 问清再动手。
- triage：模块级/架构级需求，先进行四维体检定级。
需求体检：四维完整度分析与保守默认¶
对需求进行四维分析，并给出保守默认值。分级是启发式，漏检一律回退 L2（按默认执行），不会默认 L1 瞎干。
模板沉淀：三层漏斗与同名幂等¶
仅在代码改动且复用价值三问通过时沉淀。采用三层漏斗机制，同名幂等更新，避免模板无限堆积。
项目禁区自动累积¶
识别到的禁区（如禁止动 common/Result.java）会自动累积进项目档案，后续需求自动注入约束。
召回机制：零依赖关键词指纹¶
基于关键词指纹匹配，而非向量检索。对语义相同但说法不同的需求召回有限，但可解释且零成本。
成本控制：减少往返与大文件纪律¶
减少工具往返次数（简单需求从 3 次降到 1 次）。限制大文件读取，避免整读大文件消耗大量 token。
安装与前置要求¶
前置要求：
- dsh 可用
- Node 22+
- pnpm 在 PATH 上
安装命令：
dsh plugin --profile web add github:<你的账号>/dsh-spec-forge
dsh web # 必须重启，插件才会组合进插件树
注意事项¶
- dsh 仍是 developer preview，插件锁定 API 面。
- 匹配不是向量检索，对语义相同但说法不同的需求召回有限。
- 分级是启发式，漏检一律回退 L2。
- 插件与宿主同进程同权限，只读写数据目录，不联网/执行 shell/读凭据。
- 卸载不删除已沉淀的模板数据。
