AskaEth
6e28b38b08
【MT-A：护栏 + 诚实截断 + 试算异步】
- maxTidyCompareItems 400(写死)→2000 并开放为 MEMORY_TIDY_COMPARE_LIMIT；
MEMORY_TIDY_CANDIDATE_LIMIT 默认 20→200（语义不变，仍每分区）
- 依据是首跑实测：459 条的分区被 400 截断 ⇒ compared(705) < scanned(784)，
候选数(77)由上限而不是规则决定；三处上限的 WARN 都补齐了总数/上限/分区名
- 新增「上限 + 时间预算」双闸（实测 2000 条/分区 ≈234s > 3 分钟墙钟）：
整分区跳过 / 两两比对中途收手，一律如实记 (budget) + WARN
- ?async=1 ⇒ 202 {runId,status}；GET …/{runId} 轮询（writeAuth 同档）；
done 的 result 与同步 data 逐字节同形；并发=复用既有 runId、TTL 30min 自完成起算、
重启即如实 404 tidy_run_not_found；不带 async 时同步路径逐字不变
【MT-B：D3 入库前审查（design/23 §15.1）】
- 新记忆经 Store.Add（仓库里唯一 INSERT INTO memory_items）落库后，由独立记忆管理
会话（sess-memorytidy）在有界后台队列异步判定 skip/merge/modify/create
- 软合并回写（status + merged_into/merged_from/merge_count，可 revert、绝不改 content）
- 隔离来源（群聊/陌生人）**概不审查**、召回/超时失败**零改写**（fail-safe 结构性成立）
- 写入侧仅 +62.7µs/条（非阻塞入队）；默认 ENABLED=true（主人裁定：入库前先审查）
【耦合说明（重要）】两片同包且互相依赖：MT-B 的 preinsert_recall.go 用 MT-A 的
collectTidyPairs 新签名 + tidyBudget ⇒ **各自单独都 build 不过**，故一并落地。
MT-A 为让整包编译，最小幅度适配了 MT-B 的 preinsert_recall.go / preinsert_test.go
（零值预算=行为不变；符号重名改名）。
【我的验收】隔离 worktree（37 文件）build/vet/linux/darwin 全过，切片包全绿；
我亲手打红两个变异：① 去掉 (compare) 截断标记 ⇒ TestTidyCompareLimit_HitIsLoud 红；
② 中和隔离来源守卫 ⇒ TestReviewRestrictedSourceIsNeverTouched 红。
唯一红是 internal/runtime/tool 的两条超时用例（该包无人改）⇒ 主仓库 -count=8 全绿，
判定为负载敏感 flake（当时两个整树验收 + 子代理并发），已记入开发习惯与约定 §7。
.env.example 补 MEMORY_REVIEW_* 四键（MT-B 无该文件权限，由我按其代码语义补写）。
70 lines
2.8 KiB
Go
70 lines
2.8 KiB
Go
package main
|
||
|
||
import (
|
||
"fmt"
|
||
"time"
|
||
|
||
"git.yeij.top/AskaEth/Cyrene_v2/internal/config"
|
||
"git.yeij.top/AskaEth/Cyrene_v2/internal/logger"
|
||
"git.yeij.top/AskaEth/Cyrene_v2/internal/runtime/memory"
|
||
)
|
||
|
||
// 本文件把 D3「入库前审查」（DevDocs/design/23-记忆整理与去重 §15.1 D3）接进
|
||
// 组合根。三件事只在这里定：
|
||
//
|
||
// - **形态**：记忆管理会话（复用既有的 sess-memorytidy 装配，见
|
||
// memory.TidySessionID）的有界后台队列，不是会话内派 subagent。它与整理
|
||
// 心跳并列启动、在 close 里先于关库停止；
|
||
// - **依赖面**：只给它记忆存储与 embedder —— 服务侧拿不到任何会话/历史读数，
|
||
// 因此「独立会话、零上下文、不碰主会话上下文」（§15 D3）是结构性成立的，
|
||
// 而不是靠自觉；
|
||
// - **审计**：接到网关的 AuditEvent（口径 memory.review.ingest）。出口在调用
|
||
// 时才解析 a.gw —— 网关比本服务晚组装（wireFrontend），与 memoryTidy 同
|
||
// 一手法。未就绪时只记日志，绝不假装写过审计。
|
||
//
|
||
// 关闭（MEMORY_REVIEW_ENABLED=false）时**不建、不接**：store 的写入路径因此
|
||
// 逐字回到本次改动之前（纯增量，无破坏性变更）。
|
||
func (a *app) wireMemoryReview() error {
|
||
cfg, err := config.LoadMemoryReviewConfig(envPath)
|
||
if err != nil {
|
||
return fmt.Errorf("memory review config: %w", err)
|
||
}
|
||
if !cfg.Enabled {
|
||
logger.WithSource(a.log, "memory/review").Info(
|
||
"memory ingest review disabled by configuration", "env", "MEMORY_REVIEW_ENABLED")
|
||
return nil
|
||
}
|
||
reviewer, err := memory.NewPreInsertReviewer(memory.ReviewConfig{
|
||
Enabled: cfg.Enabled,
|
||
QueueSize: cfg.QueueSize,
|
||
ScanLimit: cfg.ScanLimit,
|
||
Timeout: time.Duration(cfg.TimeoutSec) * time.Second,
|
||
// 召回门复用记忆整理的既有阈值（design/23 §13 开放点 2 = 0.80）：
|
||
// 入库前审查与夜间整理必须用同一把尺子，否则同一对条目会有两个结论。
|
||
Threshold: a.cfg.MemoryTidy.RecallThreshold,
|
||
}, memory.ReviewDeps{
|
||
Store: a.memStore,
|
||
Embedder: a.embedder,
|
||
Audit: a.auditMemoryReview,
|
||
Log: a.log,
|
||
})
|
||
if err != nil {
|
||
return fmt.Errorf("memory ingest review: %w", err)
|
||
}
|
||
a.memStore.AttachIngestReviewer(reviewer)
|
||
a.memoryReview = reviewer
|
||
return nil
|
||
}
|
||
|
||
// auditMemoryReview 把一条审查结论写进网关审计链。它**只带决定、依据与 id**，
|
||
// 绝不带任何记忆正文（design §15 D3-8「记忆正文不进日志」）。
|
||
func (a *app) auditMemoryReview(who, what, result string) {
|
||
if a.gw != nil {
|
||
a.gw.AuditEvent(who, what, result)
|
||
return
|
||
}
|
||
logger.WithSource(a.log, "memory/review").Info(
|
||
"memory ingest review audit dropped: gateway not ready",
|
||
"who", who, "what", what, "result", result)
|
||
}
|