From a2f355a994bf14683fe4fd264bbf8bddb9494fcf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=B0=8F=E6=80=A1?= Date: Fri, 16 Oct 2026 22:44:45 +0800 Subject: [PATCH] =?UTF-8?q?feat(metanote):=20=E5=BD=B1=E5=AD=90=E6=A1=A3?= =?UTF-8?q?=20ZHIYI=5FMETA=5FFILTER=3Dshadow=EF=BC=88=E5=91=BD=E4=B8=AD?= =?UTF-8?q?=E5=8F=AA=E8=AE=B0=20would-reject=EF=BC=8C=E4=B8=8D=E6=8B=A6?= =?UTF-8?q?=E5=86=99=EF=BC=89=E2=80=94=E2=80=94=20=E6=BF=80=E6=B4=BB?= =?UTF-8?q?=E5=89=8D=E8=A7=82=E5=AF=9F=E6=9C=9F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- go/internal/api/routes/core.go | 5 ++ go/internal/metanote/classify.go | 41 +++++++++-- go/internal/metanote/metanote_shadow_test.go | 76 ++++++++++++++++++++ 3 files changed, 118 insertions(+), 4 deletions(-) create mode 100644 go/internal/metanote/metanote_shadow_test.go diff --git a/go/internal/api/routes/core.go b/go/internal/api/routes/core.go index 9c9b04f..9e96762 100644 --- a/go/internal/api/routes/core.go +++ b/go/internal/api/routes/core.go @@ -111,6 +111,9 @@ func (a *API) Commit(w http.ResponseWriter, r *http.Request) { respondError(w, 422, "meta-note rejected: "+reason) return } + // 影子档(ZHIYI_META_FILTER=shadow):命中只记「would-reject」,照常放行。 + // 默认 off ⇒ 立即返回,零开销、零行为变化。 + metanote.ObserveShadow(req.Content) if req.Namespace == "" { req.Namespace = classifyNamespace(req.Category, req.AgentID, req.Content) } @@ -324,6 +327,8 @@ func (a *API) WriteMemory(w http.ResponseWriter, r *http.Request) { respondError(w, 422, "meta-note rejected: "+reason) return } + // 影子档(同 Commit):命中只记「would-reject」,照常放行;默认 off 零开销。 + metanote.ObserveShadow(req.Content) if req.AgentID == "" { req.AgentID = "hermes-a06" } diff --git a/go/internal/metanote/classify.go b/go/internal/metanote/classify.go index 48b4d73..c566c79 100644 --- a/go/internal/metanote/classify.go +++ b/go/internal/metanote/classify.go @@ -1,6 +1,7 @@ package metanote import ( + "log" "os" "strings" "unicode/utf8" @@ -83,12 +84,30 @@ func Classify(text string) (bool, string) { return false, "" } -// GateEnabled:env 门控(ZHIYI_META_FILTER=1 启用;默认关闭 = 零行为变化)。 -// 逐请求读取:测试/灰度可无需重启翻转(生产由 unit env 决定,默认无 = 关)。 -func GateEnabled() bool { - return strings.TrimSpace(os.Getenv("ZHIYI_META_FILTER")) == "1" +// GateMode:三档门控(由 ZHIYI_META_FILTER 取值决定) +// +// ""/"0"/其他 ⇒ "off" 照常写(零行为变化,默认) +// "shadow" ⇒ "shadow" 命中只记日志「would-reject」,**照常放行**(观察期用) +// "1" ⇒ "on" 命中即拒写(422) +// +// 逐请求读取:测试/灰度可无需重启翻转(生产由 unit env 决定)。 +func GateMode() string { + switch strings.TrimSpace(os.Getenv("ZHIYI_META_FILTER")) { + case "1": + return "on" + case "shadow": + return "shadow" + default: + return "off" + } } +// GateEnabled:兼容旧调用点 —— **仅 "on" 为真**(shadow 不改变写入行为)。 +func GateEnabled() bool { return GateMode() == "on" } + +// ShadowEnabled:影子档(只记录不拦)。 +func ShadowEnabled() bool { return GateMode() == "shadow" } + // ShouldSkip:门禁 ON 且判 meta ⇒ (true, reason)。调用点据此拒绝落库。 func ShouldSkip(text string) (bool, string) { if !GateEnabled() { @@ -96,3 +115,17 @@ func ShouldSkip(text string) (bool, string) { } return Classify(text) } + +// ObserveShadow:影子档下判定并记日志 —— 命中只记「would-reject」,**不改变写入**。 +// 日志前缀固定为 `[metanote] shadow would-reject`,便于 grep 统计真实流量误拦率。 +// 返回 (是否命中, reason),供测试断言;非影子档 ⇒ 立即 (false, ""),零开销。 +func ObserveShadow(text string) (bool, string) { + if !ShadowEnabled() { + return false, "" + } + skip, reason := Classify(text) + if skip { + log.Printf("[metanote] shadow would-reject: reason=%s content=%.60s", reason, text) + } + return skip, reason +} diff --git a/go/internal/metanote/metanote_shadow_test.go b/go/internal/metanote/metanote_shadow_test.go new file mode 100644 index 0000000..d42576a --- /dev/null +++ b/go/internal/metanote/metanote_shadow_test.go @@ -0,0 +1,76 @@ +package metanote + +import "testing" + +// TestGateMode_ThreeWay:三档取值映射(off / shadow / on)。 +func TestGateMode_ThreeWay(t *testing.T) { + cases := []struct{ env, want string }{ + {"", "off"}, {"0", "off"}, {"false", "off"}, {"weird", "off"}, + {"shadow", "shadow"}, {" shadow ", "shadow"}, + {"1", "on"}, {" 1 ", "on"}, + } + for _, c := range cases { + t.Setenv("ZHIYI_META_FILTER", c.env) + if got := GateMode(); got != c.want { + t.Errorf("env=%q GateMode()=%q want %q", c.env, got, c.want) + } + } +} + +// TestShadowDoesNotBlockWrites:影子档**不改变写入行为**(核心安全项)。 +func TestShadowDoesNotBlockWrites(t *testing.T) { + meta := "实测 淇县 ANN 731→15、鹤壁 6536→18(都进池50)" + t.Setenv("ZHIYI_META_FILTER", "shadow") + if skip, _ := ShouldSkip(meta); skip { + t.Fatal("shadow 档必须不拦写(ShouldSkip 应 false)") + } + if GateEnabled() { + t.Fatal("shadow 档 GateEnabled 必须 false(兼容旧调用点)") + } + if !ShadowEnabled() { + t.Fatal("shadow 档 ShadowEnabled 应 true") + } +} + +// TestObserveShadowDetectsButOffIsSilent:命中可检出;off 档静默且零开销语义。 +func TestObserveShadowDetectsButOffIsSilent(t *testing.T) { + meta := "DEBUG: recall returned empty, investigating" + fact := "牧尘在河南省鹤壁市淇县工作。" + + t.Setenv("ZHIYI_META_FILTER", "shadow") + hit, reason := ObserveShadow(meta) + if !hit || reason == "" { + t.Fatalf("shadow 档应命中 meta 并给 reason,得 hit=%v reason=%q", hit, reason) + } + if hit2, _ := ObserveShadow(fact); hit2 { + t.Fatal("事实句不应命中(事实 vs 调查记录 判据)") + } + + t.Setenv("ZHIYI_META_FILTER", "") + if hit3, r3 := ObserveShadow(meta); hit3 || r3 != "" { + t.Fatalf("off 档应静默返回 false/空 reason,得 hit=%v reason=%q", hit3, r3) + } +} + +// TestOnModeStillRejects:正式档仍拒写;且 on 档下影子函数不重复计数。 +func TestOnModeStillRejects(t *testing.T) { + meta := "实测 淇县 ANN 731→15(都进池50)" + t.Setenv("ZHIYI_META_FILTER", "1") + if skip, _ := ShouldSkip(meta); !skip { + t.Fatal("on 档应拦") + } + if hit, _ := ObserveShadow(meta); hit { + t.Fatal("on 档下 ObserveShadow 不应重复计数(拒写由 on 路径负责)") + } +} + +// TestClassifyEnvIndependent:Classify 是纯函数,不受门档影响(parity 前提)。 +func TestClassifyEnvIndependent(t *testing.T) { + meta := "复现步骤:query「我工作所在的县是哪个」返回 0 条相关" + for _, env := range []string{"", "shadow", "1"} { + t.Setenv("ZHIYI_META_FILTER", env) + if skip, reason := Classify(meta); !skip || reason == "" { + t.Fatalf("env=%q 下 Classify 应仍命中,得 %v/%q", env, skip, reason) + } + } +}