pi-think-anchor 1.0.24 → 1.0.26

package/README.md

@@ -56,6 +56,91 @@ pi install npm:pi-think-anchor
 | `bands.spec/react` | `1.2 / 0.5` | 旧版兼容（无 `score` 时生效） |
 
 其他：日志 `~/.pi/think-anchor.jsonl`（1 MiB 截断，保留尾部整行）。
+**词表覆盖规则（源码事实）**
+
+- 三个键独立覆盖：只写想改的那个，其余保留默认（`lexicon` 按子键浅合并）。
+- 数组是 **整体替换**，不是追加：写 `positive` 就会替换掉默认 28 词。
+- 想在默认基础上加词 → 复制下面的完整数组再往里加。
+- `neutral` 默认空数组，写进去才按 `weights.beta` 计入比率。
+- 非法 JSON 整份配置回退默认。
+
+完整配置（可直接复制到 `~/.pi/think-anchor.json`，含默认词表）：
+
+```json
+{
+  "enabled": true,
+  "score": {
+    "minHits": 3,
+    "spec": 1.2,
+    "react": 0.5,
+    "alpha": 1
+  },
+  "windowSize": 5,
+  "weights": {
+    "beta": 0.4,
+    "eps": 0.5
+  },
+  "intervention": {
+    "l1CooldownMin": 10,
+    "l2CooldownMin": 15,
+    "maxL2": 2
+  },
+  "lexicon": {
+    "positive": [
+      "我们需要",
+      "我们将",
+      "我要",
+      "直接",
+      "下一步",
+      "关键是",
+      "结论",
+      "根本原因",
+      "失败原因",
+      "执行",
+      "验证",
+      "检查",
+      "核对",
+      "确认",
+      "修复",
+      "同步",
+      "提交",
+      "收尾",
+      "落盘",
+      "更新",
+      "测试",
+      "完成",
+      "清理",
+      "we need",
+      "we'll",
+      "we will",
+      "i will",
+      "next step"
+    ],
+    "negative": [
+      "让我",
+      "来看看",
+      "也许",
+      "或许",
+      "可能",
+      "或者",
+      "要不",
+      "先试试",
+      "随便",
+      "不太确定",
+      "好像",
+      "不知道",
+      "let me",
+      "let's",
+      "maybe",
+      "perhaps",
+      "i guess",
+      "not sure"
+    ],
+    "neutral": []
+  }
+}
+```
+
 
 ## 命令
 
@@ -77,12 +162,12 @@ pi install npm:pi-think-anchor
 flowchart TD
     A[turn_end<br/>读 assistant thinking] --> B[词频指纹 pos/neg/neu]
     B --> C{本轮命中 >= minHits?}
-    C -->|否| Z[只推进窗口<br/>不评分不干预]
+    C -->|否：只推进窗口| A
     C -->|是| D[滑窗聚合 + alpha 平滑比率]
     D --> E{波段}
-    E -->|spec| F[healthy 静默]
-    E -->|mixed| G[watch]
-    E -->|react| H[状态机<br/>L1 / L2 干预]
+    E -->|spec：静默| A
+    E -->|mixed：观察| A
+    E -->|react| H[状态机 L1 / L2]
     H -->|nextTurn 尾部消息| A
 ```
 
@@ -94,7 +179,7 @@ flowchart TD
 flowchart TD
     A[你说的话] --> B[教练看用词]
     B --> C{清晰吗}
-    C -->|清晰| D[不打扰]
+    C -->|清晰| A
     C -->|有点散| E[轻提醒]
     C -->|一直散| F[认真提醒]
     E --> A
@@ -164,6 +249,91 @@ Config file `~/.pi/think-anchor.json` (optional; defaults apply, invalid JSON fa
 | `bands.spec/react` | `1.2 / 0.5` | Legacy keys (used when `score` is absent) |
 
 Also: log `~/.pi/think-anchor.jsonl` (1 MiB truncation, tail-preserving).
+**Lexicon override rules (from source)**
+
+- Keys merge independently: write only what you change; the rest keep defaults (`lexicon` merges per sub-key).
+- An array is **replaced wholesale**, never appended: writing `positive` replaces all 28 defaults.
+- To add words on top of the defaults, copy the full array below and insert yours.
+- `neutral` defaults to empty; words you add count with `weights.beta`.
+- Invalid JSON falls back to the whole default config.
+
+Full config (copy-paste ready, includes the default lexicon):
+
+```json
+{
+  "enabled": true,
+  "score": {
+    "minHits": 3,
+    "spec": 1.2,
+    "react": 0.5,
+    "alpha": 1
+  },
+  "windowSize": 5,
+  "weights": {
+    "beta": 0.4,
+    "eps": 0.5
+  },
+  "intervention": {
+    "l1CooldownMin": 10,
+    "l2CooldownMin": 15,
+    "maxL2": 2
+  },
+  "lexicon": {
+    "positive": [
+      "我们需要",
+      "我们将",
+      "我要",
+      "直接",
+      "下一步",
+      "关键是",
+      "结论",
+      "根本原因",
+      "失败原因",
+      "执行",
+      "验证",
+      "检查",
+      "核对",
+      "确认",
+      "修复",
+      "同步",
+      "提交",
+      "收尾",
+      "落盘",
+      "更新",
+      "测试",
+      "完成",
+      "清理",
+      "we need",
+      "we'll",
+      "we will",
+      "i will",
+      "next step"
+    ],
+    "negative": [
+      "让我",
+      "来看看",
+      "也许",
+      "或许",
+      "可能",
+      "或者",
+      "要不",
+      "先试试",
+      "随便",
+      "不太确定",
+      "好像",
+      "不知道",
+      "let me",
+      "let's",
+      "maybe",
+      "perhaps",
+      "i guess",
+      "not sure"
+    ],
+    "neutral": []
+  }
+}
+```
+
 
 ## Commands
 
@@ -185,14 +355,13 @@ Also: log `~/.pi/think-anchor.jsonl` (1 MiB truncation, tail-preserving).
 flowchart TD
     A[turn_end<br/>read assistant thinking] --> B[word fingerprint pos/neg/neu]
     B --> C{hits >= minHits?}
-    C -->|no| Z[advance window only<br/>no score, no nudge]
+    C -->|no: window only| A
     C -->|yes| D[sliding window + alpha-smoothed ratio]
     D --> E{band}
-    E -->|spec| F[healthy: silent]
-    E -->|mixed| G[watch]
-    E -->|react| H[state machine<br/>L1 / L2 nudge]
+    E -->|spec: silent| A
+    E -->|mixed: watch| A
+    E -->|react| H[state machine L1 / L2]
     H -->|nextTurn message| A
-
 ```
 
 ## How it works (plain words)
@@ -203,7 +372,7 @@ flowchart TD
 flowchart TD
     A[what you say] --> B[coach reads wording]
     B --> C{focused?}
-    C -->|yes| D[no interruption]
+    C -->|yes| A
     C -->|slightly off| E[gentle nudge]
     C -->|drifting| F[stronger nudge]
     E --> A

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-think-anchor",
-  "version": "1.0.24",
+  "version": "1.0.26",
   "description": "Monitors thinking focus drift and nudges the model back on track.",
   "type": "module",
   "license": "MIT",