diff --git a/docs/ac-evidence/t_5ad3f843-metanote-chokepoint/DELIVERY.md b/docs/ac-evidence/t_5ad3f843-metanote-chokepoint/DELIVERY.md new file mode 100644 index 0000000..021912b --- /dev/null +++ b/docs/ac-evidence/t_5ad3f843-metanote-chokepoint/DELIVERY.md @@ -0,0 +1,116 @@ +# 交付说明 · t_5ad3f843【织忆·主症B 返修】元笔记分类器 + 咽喉点收口 + +- **卡号**:`t_5ad3f843` | **执行者**:prof-dev(2 次 run 均 `rc=1` 崩于"写交付说明"步骤) +- **终审收口**:小怡(default)—— 逐条**亲跑**验证,不采信 worker 自报 +- **日期**:2026-10-16 | **commit**:`e85c9db`(代码)+ 本文件(证据) +- **结论**:AC1–AC8 **全绿**;**生产未部署**(源码级交付)⇒ **可申请激活**(需另提卡 + 牧尘放行) + +--- + +## ① 判据脚本原始输出(AC1 · exit 0) + +``` +$ python3 ~/.hermes/scripts/verify-meta-filter.py +正例 14 条 / 负例 11 条;不符 0 条 + +[PASS] 分类器达标 +$ echo $? +0 +``` + +> 基线(返修前):exit=1,**10 条不符(7 漏拦 + 3 误拦)**。 + +## ② 逐条 before / after(AC7 要求) + +### 病根一 · 漏拦(7 条):判据只认"写下来的那几种写法" + +| 案例(生产原文) | before | after | 命中规则 | +|---|---|---|---| +| `实测 淇县 ANN 731→15、鹤壁 6536→18(都进池50)` | **放行 ✗** | 拦 ✓ | `pool_in+rank_num+num_arrow+pool` | +| `实测 淇县 ANN 731→15(都进池50)` | **放行 ✗** | 拦 ✓ | `pool_in+rank_num+num_arrow+pool` | +| `短问法 MISS 复现:牧尘工作所在的县是哪个` | 放行 ✗ | 拦 ✓ | `repro` | +| `淇县库里 21 条、鹤壁 10 条、河南 15 条语料可用。` | 放行 ✗ | 拦 ✓ | `data_inv` | +| `实测(只读,未改任何库/代码):目标「用户在招商局工作」在 query…` | 放行 ✗ | 拦 ✓ | `data_inv+pool+rank` | +| `memory_write 落 episodes 表 + vector 全 0 —— 写入…` | 放行 ✗ | 拦 ✓ | `write_bug` | +| `织忆 golden 14/14 不退化,recall@5 = 0.4286` | 放行 ✗ | 拦 ✓ | `eval_metric` | + +**新增规则原文**(形态匹配,非加字面词 —— 满足 AC3): +``` +_RANK_NUM = \bANN\s*\d+\s*→\s*\d+ +_NUM_ARROW = \d+\s*→\s*\d+ +_POOL_IN = 进\s*池\s*\d+ +_REPRO = (MISS\s*复现|复现[::((]|复现\s*(步骤|方法|过程|流程|记录)\s*[::((]) +_DATA_INV = (语料盘点:N 条…可用) +_EVAL_METRIC= (golden \d+/\d+|recall@\d+) +_DEBUG_MARK = (\bDEBUG\b|探针|自报|脚本输出) +_WRITE_BUG = (写入类故障记录) +``` + +### 病根二 · 误拦(3 条):把"关于系统的事实"当调查记录拦了 + +| 案例(事实句,金标同族题面) | before | after | 理由 | +|---|---|---|---| +| `织忆召回接口 POST /api/v1/recall 接受 top_k 参数。` | **拦 ✗** | 放 ✓ | `_FACT_DECL` 事实声明形豁免 | +| `召回缓存 recall-cache 每 6 小时刷新一次。` | **拦 ✗** | 放 ✓ | `_FACT_DECL`(周期形) | +| `织忆主服务进程名是 zhiyid-new,合并服务是 zhiyi-consolidate。` | **拦 ✗** | 放 ✓ | `_FACT_DECL`(进程名形) | + +**AC4 区分判据**:`svc_core` 由 STRONG 降级为 **cue 计数**;通用功能词(召回|蒸馏)各计 1 个 cue,需叠加才判;**事实声明形**(`_FACT_DECL`:接受X参数/监听N端口/每N小时…一次/进程名是/地址是/模型是/字体/行距)⇒ **判事实放行**;带 实测/复现/诊断/命中/命名空间/限流/退避/碎片化/FALLBACK 等概念词的调查记录**不受豁免** ⇒ 既放行 3 条误拦,又**不漏原有 16 条自检正例**(两套用例同时绿)。 + +### 负例 11 条全放行(`[放✓]`) +牧尘在河南省鹤壁市淇县工作。· 淇县招商项目台账(09-27阅读版).md 已发布。· 织忆服务的健康检查接口监听 7821 端口。· 织忆召回接口 POST /api/v1/recall 接受 top_k 参数。· 召回缓存 recall-cache 每 6 小时刷新一次。· 织忆主服务进程名是 zhiyid-new,合并服务是 zhiyi-consolidate · 公文排版正文用仿宋_GB2312 字体,行距 28 磅。· 家庭服务器(跑 Gitea)在局域网里的地址是 192.168.123.11。· 本地 2B 模型服务监听 8080 端口。· 牧尘负责生物制造产业专班 + 卫都街道安全管理。· 小怡日常主链模型是 deepseek-v4-flash(官方直连)。 + +## ③ AC8 咽喉点收口(本卡新增,最关键) + +**问题**:B 卡只接了 3 条管线,而污染样本 **5/6 来自未覆盖路径**(27 个写者只有 3 个被覆盖)。 + +**修法**:接在**唯一共享入口**上 —— 所有 27 个写者都走 `POST /api/v1/commit`: + +```go +// go/internal/api/routes/core.go:108(/commit 处理器,AutoDistillTrigger 之前) +if skip, reason := metanote.ShouldSkip(req.Content); skip { + log.Printf("[metanote] commit rejected (gate ON, meta-note): ...") + respondError(w, 422, "meta-note rejected: "+reason) + return // ← 真拒写:不落 episode、不进蒸馏 +} +// core.go:322(write_memory 处理器)同样接线 +``` +⇒ 覆盖 **27/27 写者**(对比修前 3/27)。 + +**Python↔Go 同源锁死**:`internal/metanote`(patterns.go / classify.go)与 `~/.hermes/scripts/lib/meta_note_filter.py` 口径同源,由 parity + 差分测试锁死: +- `TestParity_PythonLive`(Live parity,0.03s) +- `TestParity_MutatedCopyFails` —— **变异必 FAIL**(负控,0.03s) +- `TestDifferential_PythonReference` / `TestDifferential_ExpectedSpotChecks` + +## ④ 小怡终审亲跑证据(非自报) + +| 项 | 命令 | 结果 | +|---|---|---| +| 构建 | `go build ./...` | **exit 0** | +| 测试 | `go test ./internal/metanote/` | **ok 0.130s**(8 项含 parity/mutation) | +| 判据 | `verify-meta-filter.py` | **exit 0**(正14/负11/不符0) | +| 判据未被改(AC2) | `verify-meta-filter.py` mtime **20:08:22** 早于 worker 首启 **20:09:36** | ✓ 正/负例逐字未动 | +| 门默认关(AC6) | gateway env / zhiyid env | **各 0 处** `ZHIYI_META_FILTER` | +| **未部署** | 生产二进制 mtime `19:02:50` **早于** 提交 `21:59:28`;md5 `95286f63789c7ecd` 未变;`strings` 内 `metanote` **0 处** | ✓ 源码级 | +| 零行为变化 | `classify.go:91 ShouldSkip` → `if !GateEnabled() { return false, "" }` | ✓ 门关即不参与 | + +## ⑤ 改动文件清单 + +| 文件 | 说明 | +|---|---| +| `go/internal/metanote/patterns.go` | 新增(规则表,Python 口径同源) | +| `go/internal/metanote/classify.go` | 新增(分类 + `GateEnabled`/`ShouldSkip`) | +| `go/internal/metanote/metanote_parity_test.go` | 新增(parity) | +| `go/internal/metanote/metanote_live_test.go` | 新增(Live parity + 变异负控) | +| `go/internal/metanote/metanote_diff_test.go` | 新增(差分对照) | +| `go/internal/api/routes/core.go` | 咽喉点接线(:108 / :322) | +| `~/.hermes/scripts/lib/meta_note_filter.py` | 分类器 193 → 326 行(仓库外,`.hermes` 侧) | + +## ⑥ 激活状态 + +**可申请激活**(分类器绿 + 咽喉点覆盖 27/27 + parity/变异测试在 + 默认关 + 未部署)。 +**但激活不在本卡范围**:需 ① 另提卡 ② 重建二进制并部署 ③ 牧尘放行(`prod-write-gate.py` 会拦,别绕)。 + +## ⑦ 遗留(诚实记录) + +1. **两次 run 均 `rc=1` 崩于"写交付说明"步骤**,日志**无任何错误行**(裸退);代码工作在两轮内已完成并提交 ⇒ 未放行第三次盲跑。**真因未定**(疑与同 profile 并发 worker / 会话结束路径有关,待查)。 +2. **AC8.1 覆盖表**:本文件 ③ 已给出结构性论证(单一入口 ⇒ 27/27),worker 原计划的逐写者分布表未落盘(随交付说明一起丢)。