dsh-creativity-nudge
DSH 插件：在模型锁定路线的那一刻，注入一次"先发散"的提醒。
建议型（advisory only）——不否决调用、不改写结果、不评价输出好坏。
配套技能：creative-divergence（在 ~/.dsh/skills/creative-divergence/SKILL.md；"怎么做"的工序在技能里，插件只负责"什么时候想起来"）。
默认 enabled: false：装上不生效，改配置才注册监听。
为什么是钩子而不是提示词
创新提示最怕高频。每轮都出现的"要有创意"，等于每轮都不出现——它会退化成格式噪音，模型和人都一样免疫。
所以这里的设计是 低频 + 硬预算 + 只落在决策点，而不是"每次都提醒"。
触发时机（只判断时机，不判断内容）
判"这个任务要不要创意"只有两条路：多烧一次模型调用，或者写关键词正则误伤。所以插件不做判断，只观测确定性的结构事实：
| 时机 | 观测条件 | 文案要它做什么 | 每会话 |
|---|
| T1 承诺点 | 本会话第一次 write/edit，且用户最近一条消息命中了 keywords | 给出两个"机制不同"的候选，各写一句牺牲 | 1 次 |
| T2 卡住点 | 同一个文件被改到第 stuckEdits 次（默认 5） | 换机制，别再微调同一处 | 1 次 |
| T3 连续失败 | 连续 stuckFailures 次 isError（默认 0 = 关闭） | 回退到能工作的状态再换方向 | 0 次 |
T2 默认 5 而不是 3：正常开发里改同一个文件 3 次是常态，5 次才开始像打转。
T3 默认关闭：一次失败的测试再改一次是很正常的迭代，误报率高于信息量；要开就设 stuckFailures: 2。
不做 T4「交付前提醒」：答案已经写完，这时候提醒只能逼模型推倒重写，成本翻倍、收益不可证。
频率（硬预算，不是节流）
maxPerSession: 2 —— 每会话最多两次，用完就没有cooldownCalls: 8 —— 两次提醒之间至少隔 8 次工具调用- 用户发新消息清空 T2 的文件计数与失败计数（T1 的"第一次落盘"不重置；同一条用户消息在每一 step 重复出现，按 message id 去重）
- 措辞轮换：同一句话出现第三次会被当样板忽略，所以两条文案按 seed 轮换
- 单调递减：预算本身就是递减的——第 3 次机会不存在
配置
在 cordis.patch.yml 的 config 段改：
enabled: false # 总开关（装上不生效就靠它）
maxPerSession: 2 # 每会话最多注入几次
cooldownCalls: 8 # 两次提醒之间的最小工具调用间隔
stuckEdits: 5 # 同一文件改到第几次算打转
stuckFailures: 0 # 连续失败阈值，0 = 关闭
mutatingTools: ['write', 'edit']
keywords: ['设计', '方案', '架构', '命名', ...]
dryRun: false # 只记日志不注入
auditFile: '' # jsonl 审计路径，空 = 不写
非法配置（如 stuckEdits: 1、keywords: []）在装载时直接抛错，不静默改行为。
开关（装完默认是关的）
在 <profile>/cordis.patch.yml 末尾追加这三行，重启 DSH 即生效：
- id: creativity-nudge
name: 'dsh-creativity-nudge'
config:
enabled: true
部分字段就够——插件内部的 normalizeConfig 会拿 DEFAULTS 合并，没写的键走默认值。
想先观测不打扰，就换成：
- id: creativity-nudge
name: 'dsh-creativity-nudge'
config:
enabled: false
dryRun: true
auditFile: '%USERPROFILE%/.dsh/logs/creativity-nudge.jsonl'
注意 dryRun 单独也能激活监听（不需要 enabled），但只写日志、不注入。
安装 / 卸载
node scripts/install.mjs --dry-run # 预演
node scripts/install.mjs # 装进档案（会备份 package.json）
node scripts/install.mjs --uninstall # 彻底摘干净
安装 = 复制到 <profile>/node_modules/dsh-creativity-nudge + 追加进 dsh.profile.bundles。
装完必须完全退出并重开 DSH。
不要在这个档案里跑 pnpm install：它会按 package.json 的 dependencies 重装 node_modules，把手放的这份冲掉。
验证
- 单元测试：
npm test（15 条，覆盖预算、冷却、重置、dryRun、block 透传）
- 只看不注入：
enabled: true + dryRun: true + auditFile: '.../nudge.jsonl'，跑一天，看 jsonl 里 event: would-fire 的条数与理由是否符合预期
- 确认生效：
enabled: true 后开一个开放式任务，第一次落盘之后日志里会有 creativity-nudge: 已接管 tools/post-execute
已知限制
- 只看得见
write/edit。用 run_code 写文件、用 pwsh 重定向写文件都不计数。
- 关键词是唯一的启发式，也是唯一会误判的地方：中文任务描述里"设计/方案/架构"出现频率高，可能会在非创意任务上响一次（但有预算兜着）。
- 状态只在内存里：恢复会话从零开始计数，重启后预算刷新。这是有意为之——它是启发式提醒，不是记录在案的不变量。
- 不跨 agent 互相影响（每个 agent 一份状态）。
结构
lib/index.js 插件本体（零 @deepseek-ai 依赖，只 import node 内建模块）
cordis.patch.yml loader entry + 默认配置
scripts/install.mjs 装/卸进档案
scripts/profile-io.mjs 档案读写（复制自 dsh-command-guard）
tests/nudge.test.mjs 假 ctx 驱动的单元测试
依赖为零是有意的：档案里装的插件只保证能解析 node 内建模块，靠住的越少，宿主升级时越不会炸。
