@zhushanwen/pi-cache-probe 0.3.1 → 0.3.2

package/README.md

@@ -1,6 +1,6 @@
 # @zhushanwen/pi-cache-probe
 
-前缀稳定性长期数据采集 extension（设计文档：`docs/todo/cache-probe-design.md`）。零行为影响：只在 system prompt / tools 指纹变化时向 session JSONL 写 `cache-probe` custom entry（不进 LLM 上下文），配合 `analyze.py` 把 turn 首笔 cache miss 归因为「前缀变化（可修）」vs「服务端淘汰（不可修）」。
+前缀稳定性长期数据采集 extension。零行为影响：只在 system prompt / tools 指纹变化时向 session JSONL 写 `cache-probe` custom entry（不进 LLM 上下文），配合 `analyze.py` 把 turn 首笔 cache miss 归因为「前缀变化（可修）」vs「服务端淘汰（不可修）」。
 
 ## 组成
 
@@ -28,7 +28,7 @@ pi --continue --extension <repo>/extensions/universal/cache-probe/index.ts "<pro
 ## 归因分析
 
 ```bash
-python3 extensions/universal/cache-probe/analyze.py ~/.pi/agent/sessions ~/.xyz-agent/pi/sessions
+python3 extensions/universal/cache-probe/analyze.py ~/.pi/agent/sessions ~/.taiji/pi/sessions
 ```
 
 输出五部分：扫描概览 / 命中率基线 / 归因矩阵 / 进程边界漂移 / GO-NO-GO 决策建议。
@@ -37,10 +37,10 @@ python3 extensions/universal/cache-probe/analyze.py ~/.pi/agent/sessions ~/.xyz-
 
 - pi CLI 启动路径（`--session` / `--continue`）的 session_start reason 恒为 `startup`（`resume` 仅运行时 switch session 出现）——跨进程识别靠 baseline 标记 + 时间戳 gap，漂移检测靠 hash 对比，均不受影响。
 - 同进程内修改 AGENTS.md 不进 system prompt（pi 启动快照），contextFiles 漂移只出现在跨进程边界——pi 的行为，不是探针缺陷。
-- 真实环境实测发现：extension 链（model-switch / subagent-workflow 等）存在每 turn 级的 system prompt 动态注入，由 spFull 单独捕获——这正是它存在的价值。
+- 真实环境实测发现：extension 链（如 subagent-workflow）存在每 turn 级的 system prompt 动态注入，由 spFull 单独捕获——这正是它存在的价值。
 
 ## 日常维护
 
 - 校验：`cd extensions/universal/cache-probe && pnpm typecheck && pnpm test`（或仓库级 `pnpm extensions:typecheck && pnpm extensions:test`）
 - 每日检查：跑一次 analyze.py，确认 `sessions_with_probe` 增长、`error entries` 为 0 或已知原因
-- 归因矩阵内有效 turn（analyze.py 第 3 部分 core 过滤：排除间隔>30min、模型切换、探针未覆盖的 turn）满 200 后，analyze.py 第 5 部分给出快照方案 GO/NO-GO 倾向；结论与后续动作记录回设计文档
+- 归因矩阵内有效 turn（analyze.py 第 3 部分 core 过滤：排除间隔>30min、模型切换、探针未覆盖的 turn）满 200 后，analyze.py 第 5 部分给出快照方案 GO/NO-GO 倾向

package/analyze.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""cache-probe 归因分析脚本（设计文档 docs/todo/cache-probe-design.md §7.2）。
+"""cache-probe 归因分析脚本（设计文档 cache-probe-design §7.2）。
 
 输入一个或多个 sessions 目录，输出：
   1. 扫描概览（含 error entry / 畸形行计数，失败要出声）

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@zhushanwen/pi-cache-probe",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Zero-impact Pi probe extension — records system prompt / tools fingerprint hashes into session custom entries (only on change) to attribute LLM prompt-cache miss to prefix drift vs server-side eviction.",
   "type": "module",
   "main": "src/index.ts",
-  "xyz-agent": {
+  "taiji": {
     "role": "universal"
   },
   "pi": {
@@ -26,7 +26,7 @@
     "analyze.py"
   ],
   "dependencies": {
-    "@zhushanwen/pi-ext-guards": "0.4.0"
+    "@zhushanwen/pi-ext-guards": "0.4.1"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.1.9",

package/src/fingerprint.ts

@@ -1,5 +1,5 @@
 /**
- * cache-probe 指纹纯函数层 —— 设计文档 docs/todo/cache-probe-design.md §7.1。
+ * cache-probe 指纹纯函数层 —— 设计文档 cache-probe-design §7.1。
  *
  * entry schema v2（长期生效版，数据量精简为长期采集优化）：
  *  - hash 用 sha256 前 16 hex（64bit，同 session 内对比，碰撞概率可忽略）

package/src/index.ts

@@ -1,7 +1,7 @@
 /**
  * cache-probe — pi file-type extension（前缀稳定性长期数据采集探针）。
  *
- * 设计文档：docs/todo/cache-probe-design.md（§7.1 实现机制）。
+ * 设计文档：cache-probe-design（§7.1 实现机制）。
  *
  * 记录 9 个指纹 hash（schema v2：短 hash + 增量 entry），变化时才向 session JSONL
  * 写 custom entry（customType = "cache-probe"）。custom entry 不进 LLM 上下文，