AskaEth
6d92536276
主人原话：「那么多 link 是干什么的？该删就删，怎么这个记忆整理机制这么保守呢」。
① **link 停产**（依据 design/23 §14 把它列为「未细化」⇒ 既无落点也无数据模型；
`applyable()` 也只认 merge/archive/reclassify ⇒ 应用 link 恒 `skipped`，是纯噪音）：
- 规则层 `containNone` 判定改为 `keep`（不再产出 501 条不可应用的待办）；
- `TidyLink` 常量保留，只为**读历史行**与「不可应用」判定；
- 存量出路：新端点 `POST /api/v1/admin/memories/candidates/reject?action=&limit=`
（**幂等、只改候选 status、不碰记忆**），主会话用它清掉存量 501 条。
② **轮末自动落地**（默认开，仅两类，判据是纯函数）：
- `merge`：**字面重复** ∨「事实集合等价 ∧ 相似度 ≥ 0.95」；
- `archive`：理由 = `one_off_event` **且不像习惯**（`design/23 §5.2-1` 红线：
习惯类会因正文带钟点被误判成一次性事件，归档它是错的）。
- **不自动**：`reclassify`、低置信 merge、跨分区/跨角色、任何改正文、受限来源
（群聊/陌生人）—— 新增执行面守卫 `tidySkipSourceRestricted`。
③ **六条护栏**（缺一不可）：软动作（复用既有 apply 路径）/ 每轮上限 50（硬顶 500，
超限如实 `Truncated` + 真总数）/ 审计 `memory.tidy.apply`（`auto=true`，不带正文）/
**可 revert**（复用既有回滚）/ 幂等（复用候选状态条件更新）/ **一键关回只产建议**
（`$DATA_DIR/config/memory-tidy.json` 的 `autoApply:false`，**零新 env 键**）。
验收（主会话复跑 + 亲自变异）：memory 与 gateway 两包 build/vet/test 全绿；我用
-overlay 短路「习惯不归档」守卫 ⇒ TestTidyAutoNeverArchivesHabitMisjudgedAsOneOff
变红（逐字报「作息习惯被自动归档了 …design §5.2-1 红线」）。
⚠️ 未部署（要 build+restart 才生效）；⚠️ 契约欠登记（新端点 B25 + §7.2），主会话补；
⚠️ 真机端到端未跑（不能重启后端）。
81 lines
3.6 KiB
Go
81 lines
3.6 KiB
Go
package main
|
||
|
||
import (
|
||
"fmt"
|
||
|
||
"git.yeij.top/AskaEth/Cyrene_v2/internal/config/runtimeconfig"
|
||
"git.yeij.top/AskaEth/Cyrene_v2/internal/logger"
|
||
"git.yeij.top/AskaEth/Cyrene_v2/internal/runtime/memory"
|
||
)
|
||
|
||
// 本文件把记忆整理（DevDocs/design/23-记忆整理与去重 §4）接进组合根。
|
||
//
|
||
// 四件事只在这里定：
|
||
// - **形态**：低峰定期后台任务（memory.TidyService 的心跳），不是会话内派
|
||
// subagent。它在 main.go 与 backthink 并列启动、在 close 里先于关库停止；
|
||
// - **依赖面**：只给它记忆存储与 embedder —— 服务侧拿不到任何会话/历史读数，
|
||
// 因此 design §4.1「绝不碰主会话上下文」是结构性成立的，而不是靠自觉；
|
||
// - **审计**：接到网关的 AuditEvent（design §8 的 memory.tidy.*），出口在调用
|
||
// 时才解析 a.gw —— 网关比本服务晚组装（wireFrontend），与 onToolAudit
|
||
// 同一手法。未就绪时只记日志，绝不假装写过审计；
|
||
// - **运行期调优**（2026-10-07 新增）：从 `$DATA_DIR/config/memory-tidy.json`
|
||
// 读「自动落地开关 + 每轮上限」。它是 `.env` 冻结（design/13 §2.1）之后新旋钮
|
||
// 的唯一去处，**零新 env 键**；读不到/解不开一律回落代码默认值并记 WARN
|
||
// （坏配置绝不能让自动档变成「无限制」）。
|
||
//
|
||
// 刻意**不做**的一件事（design §4.1 F）：
|
||
// - 不把 sess-memorytidy 加进 flowPub 的图源白名单（默认关：整理是系统任务，
|
||
// 不是主人的会话）。
|
||
func (a *app) wireMemoryTidy() error {
|
||
cfg := memory.TidyConfigFromConfig(a.cfg.MemoryTidy)
|
||
a.applyMemoryTidyTuning(&cfg)
|
||
svc, err := memory.NewTidyService(cfg, memory.TidyDeps{
|
||
Store: a.memStore,
|
||
Embedder: a.embedder,
|
||
Audit: a.auditMemoryTidy,
|
||
Log: logger.WithSource(a.log, "memory/tidy"),
|
||
})
|
||
if err != nil {
|
||
return fmt.Errorf("memory tidy: %w", err)
|
||
}
|
||
a.memoryTidy = svc
|
||
return nil
|
||
}
|
||
|
||
// applyMemoryTidyTuning 把 `$DATA_DIR/config/memory-tidy.json` 叠到 env 侧的
|
||
// TidyConfig 上（见 runtimeconfig.MemoryTidyTuning 的零值口径）：
|
||
// - 文件里**没写** autoApply ⇒ 保持代码默认（开）；
|
||
// - 写 `false` ⇒ DisableAutoApply = true（一键回到「只产建议」，不必改代码）；
|
||
// - autoApplyPerRound ≤ 0 ⇒ 不覆盖，交给 normalizeTidyConfig 填默认上限。
|
||
//
|
||
// 读不到/解不开时只记 WARN 并保持 env 侧的值：那正是「回落代码默认值」。
|
||
func (a *app) applyMemoryTidyTuning(cfg *memory.TidyConfig) {
|
||
path := runtimeconfig.DefaultMemoryTidyPath(resolveDataDir(a.cfg))
|
||
tuning, err := runtimeconfig.LoadMemoryTidyTuning(path)
|
||
if err != nil {
|
||
logger.WithSource(a.log, "memory/tidy").Warn(
|
||
"memory tidy tuning unreadable, falling back to code defaults",
|
||
"path", path, "error", err)
|
||
return
|
||
}
|
||
cfg.DisableAutoApply = tuning.AutoApplyOff()
|
||
if tuning.AutoApplyPerRound > 0 {
|
||
cfg.AutoApplyPerRound = tuning.AutoApplyPerRound
|
||
}
|
||
logger.WithSource(a.log, "memory/tidy").Info(
|
||
"memory tidy tuning loaded",
|
||
"path", path, "auto_apply", !cfg.DisableAutoApply,
|
||
"auto_apply_per_round", cfg.AutoApplyPerRound)
|
||
}
|
||
|
||
// auditMemoryTidy 把一轮整理的计数写进网关审计链。它**只带计数**，绝不带
|
||
// 任何记忆正文（design §8 的 who/what/when/result 口径）。
|
||
func (a *app) auditMemoryTidy(who, what, result string) {
|
||
if a.gw != nil {
|
||
a.gw.AuditEvent(who, what, result)
|
||
return
|
||
}
|
||
logger.WithSource(a.log, "memory/tidy").Info(
|
||
"memory tidy audit dropped: gateway not ready", "who", who, "what", what, "result", result)
|
||
}
|