pi-think-anchor 1.0.28 → 1.0.29

package/README.en.md

@@ -1,53 +1,9 @@
 # pi-think-anchor
 
-Chain-of-thought drift monitor: reads a word-frequency fingerprint from thinking, classifies focused / mixed / reactive, and nudges when drifting.
+Thinking-focus monitor with graded nudges, driven by a reproducible ratio test.
 
-## Install
+**English documentation:** [open the English section](README.md#english) · **中文文档：** [中文](README.md#zh)
 
-```bash
-pi install npm:pi-think-anchor
-```
+    pi install npm:pi-think-anchor
 
-## Configuration
-
-Config file `~/.pi/think-anchor.json` (optional; defaults apply, invalid JSON falls back):
-
-| Key | Default | Description |
-| --- | --- | --- |
-| `enabled` | `true` | Master switch |
-| `score.minHits` | `3` | Fewer hits in a turn: no scoring, no intervention |
-| `score.spec` | `1.2` | Focused threshold |
-| `score.react` | `0.5` | Reactive threshold |
-| `score.alpha` | `1` | Alpha smoothing |
-| `windowSize` | `5` | Window size in messages |
-| `weights.beta` | `0.4` | Neutral-word weight in the numerator |
-| `weights.eps` | `0.5` | Denominator floor |
-| `intervention.l1CooldownMin` | `10` | L1 cooldown (minutes) |
-| `intervention.l2CooldownMin` | `15` | L2 cooldown (minutes) |
-| `intervention.maxL2` | `2` | Max L2 per session |
-| `lexicon.positive/negative/neutral` | built-in Chinese lexicon (28 focus / 18 drift) | Lexicon override |
-| `bands.spec/react` | `1.2 / 0.5` | Legacy keys (used when `score` is absent) |
-
-Also: `THINK_ANCHOR=0` hard off; log `~/.pi/think-anchor.jsonl` (1 MiB truncation, tail-preserving).
-
-## Commands
-
-| Command | Purpose |
-| --- | --- |
-| `/think-anchor` | Current band, hits, drift share, last intervention result |
-| `/think-anchor stats` | Version, band distribution, actions, effectiveness, log size |
-
-## What it does (source facts)
-
-- `turn_end`: reads assistant thinking -> fingerprint (pos/neg/neu) -> sliding window -> band; when hits < `minHits` it only advances the window.
-- State machine `healthy -> warning -> critical`; L1/L2 nudges are injected as `nextTurn` trailing messages.
-- No escalation: when the previous `eff >= 0`, L2 degrades to L1.
-- `session_start`: resets state, keeping only the last 3 samples and pending (cross-session settlement).
-
-## Credits
-
-Distilled from the DSH plugin [`dsh-anchored-monitor`](https://dsh-plugin.org/zh/plugins/aik358/dsh-anchored-monitor) 0.3.1: the mechanism is upstream, the code is not (turn-level, no separate process).
-
-## License
-
-MIT
+Source: https://github.com/op15066212/pi-plugins-publish

package/README.md

@@ -42,7 +42,7 @@ pi install npm:pi-think-anchor
 | `intervention.maxL2` | `2` | 每会话 L2 上限 |
 | `lexicon.positive/negative/neutral` | 专注 28 词 / 发散 18 词 / 中性 **默认空** | 词表覆盖 |
 
-其他：日志 `~/.pi/think-anchor.jsonl`（1 MiB 截断，保留尾部整行）。
+其他：日志 `~/.pi/think-anchor.jsonl`（1 MiB 截断，保留尾部整行）；日志里的 `ratio` 是**未平滑**的原始比率，而判定用的是 α 平滑后的比率（`(pos + beta·neu + alpha) / (neg + eps + alpha)`）——两者数值不同，别拿日志 ratio 当判定依据。
 **词表覆盖规则（源码事实）**
 
 - 三个键独立覆盖：只写想改的那个，其余保留默认（`lexicon` 按子键浅合并）。
@@ -224,7 +224,7 @@ Config file `~/.pi/think-anchor.json` (optional; defaults apply, invalid JSON fa
 | `intervention.maxL2` | `2` | Max L2 per session |
 | `lexicon.positive/negative/neutral` | 28 focus / 18 drift / neutral **empty by default** | Lexicon override |
 
-Also: log `~/.pi/think-anchor.jsonl` (1 MiB truncation, tail-preserving).
+Also: log `~/.pi/think-anchor.jsonl` (1 MiB truncation, tail-preserving). The `ratio` in the log is the **unsmoothed** raw ratio; classification uses the `alpha`-smoothed ratio (`(pos + beta·neu + alpha) / (neg + eps + alpha)`). They differ — do not use the logged ratio as the decision value.
 **Lexicon override rules (from source)**
 
 - Keys merge independently: write only what you change; the rest keep defaults (`lexicon` merges per sub-key).

package/index.ts

@@ -89,17 +89,12 @@ export function fingerprint(text: string, lex: { positive: string[]; negative: s
   };
 }
 
+
 /** 加权比率：专注度代理指标 */
 export function ratioOf(pos: number, neg: number, neu: number, w: { beta: number; eps: number } = DEF_CFG.weights): number {
   return (pos + w.beta * neu) / (neg + w.eps);
 }
 
-export function bandOf(ratio: number, t: { spec: number; react: number } = DEF_CFG.score): "spec" | "mixed" | "react" {
-  if (ratio >= t.spec) return "spec";
-  if (ratio >= t.react) return "mixed";
-  return "react";
-}
-
 /**
  * v2.1 判据：证据门槛 + α 平滑的专注/发散比。
  * 回放 2069 条可评分日志：旧判据 react 占 18.3%（其中 57% 是命中 <3 的长而散）；
@@ -328,7 +323,7 @@ export default function thinkAnchor(pi: ExtensionAPI): void {
       } else {
         // 被冷却/上限挡下：记 blocked，避免与「无需动作」混淆（实测 583 次 want=L2 只有 55 次真发）
         st.phase = prevPhase;
-        if (d.level !== "none") acted = st.autoMuted ? "muted-" + d.level : "blocked-" + d.level;
+        acted = st.autoMuted ? "muted-" + d.level : "blocked-" + d.level;
       }
       if (band === "spec" && st.phase === "healthy") st.l2Tried = 0; // 恢复后重置 L2 计数
       // v3 效果闭环：干预后第 3 轮结算（pre = 干预前最近 3 轮 ratio 均值）

package/package.json

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