创意提醒钩子 Elysia-laoda/dsh-creativity-nudge

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，把手放的这份冲掉。

验证

1. 单元测试：npm test（15 条，覆盖预算、冷却、重置、dryRun、block 透传）
2. 只看不注入：enabled: true + dryRun: true + auditFile: '.../nudge.jsonl'，跑一天，看 jsonl 里 event: would-fire 的条数与理由是否符合预期
3. 确认生效：enabled: true 后开一个开放式任务，第一次落盘之后日志里会有 creativity-nudge: 已接管 tools/post-execute

已知限制

- 只看得见 write/edit。用 run_code 写文件、用 pwsh 重定向写文件都不计数。
- 关键词是唯一的启发式，也是唯一会误判的地方：中文任务描述里「设计/方案/架构」出现频率高，可能会在非创意任务上响一次（但有预算兜着）。
- 状态只在内存里：恢复会话从零开始计数，重启后预算刷新。这是有意为之——它是启发式提醒，不是记录在案的不变量。
- 不跨智能体互相影响（每个智能体一份状态）。

结构

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 内建模块，靠住的越少，宿主升级时越不会炸。