chore(evidence): t_5ad3f843 交付说明(AC 逐条 before/after + 咽喉点收口 27/27 + 终审亲跑证据 + 未部署核定)

This commit is contained in:
小怡
2026-10-16 22:26:31 +08:00
parent 05100339f8
commit fa3490e794
@@ -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 原计划的逐写者分布表未落盘(随交付说明一起丢)。