feat(metanote): 影子档 ZHIYI_META_FILTER=shadow(命中只记 would-reject,不拦写)—— 激活前观察期
This commit is contained in:
@@ -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"
|
||||
}
|
||||
|
||||
@@ -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
|
||||
}
|
||||
|
||||
@@ -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)
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user