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），主会话补；
⚠️ 真机端到端未跑（不能重启后端）。
103 lines
5.2 KiB
Go
103 lines
5.2 KiB
Go
// memorytidy.go 是记忆整理（design/23）**运行期调优**的可变源：
|
||
// `$DATA_DIR/config/memory-tidy.json`（design/13 §2.1「运行期生成的配置进
|
||
// `$DATA_DIR/config/`，新增配置家族从一开始就只写这里，不落老位置」）。
|
||
//
|
||
// 为什么需要它（2026-10-07 主人「那么多 link 是干什么的？该删就删，怎么这个记忆
|
||
// 整理机制这么保守呢」）：轮末自动落地是一件**改记忆**的动作，它必须有一个
|
||
// 「一键回到只产建议」的开关与一个每轮上限，而 `.env` 已被主人冻结
|
||
// （`design/13 §2.1`：调优/门槛/上限/开关类参数走 `$DATA_DIR/config/**` + 代码
|
||
// 默认值，不进 `.env`）。于是这两项落在这里，**零新 env 键**。
|
||
//
|
||
// 边界与 backthink.go 同源（那是同一族的手续）：
|
||
//
|
||
// 1. 本文件只管**文件形状 + 读取**：它不认识 `TidyConfig`，也不认识「零值回落
|
||
// 代码默认值」那条裁决 —— 那是 `memory.normalizeTidyConfig` 的事。
|
||
// 2. **只读**：面板写路径不在本切片内，因此刻意没有 `Save*`。改动仍要
|
||
// **人手改这个文件 + 重启**（与 `backthink.json` 同口径：启动期读一次）。
|
||
// 3. **零新 env 键**，也不进面板的配置事实卡（那张表的键名被 `.env.example` 钉住）。
|
||
//
|
||
// 读取口径：文件缺失或全空白 = 还没配过（零值 + nil，**不是错误**）；存在但解不开
|
||
// = 返回错误，调用方记 WARN 并回落**代码默认值**（即：坏配置绝不能把自动档的开关
|
||
// 或上限读成「无限制」）。
|
||
package runtimeconfig
|
||
|
||
import (
|
||
"encoding/json"
|
||
"errors"
|
||
"fmt"
|
||
"os"
|
||
"path/filepath"
|
||
"strings"
|
||
)
|
||
|
||
const (
|
||
// memoryTidyFileName 是文件名（家族命名 = 服务/模块名 + .json）。
|
||
memoryTidyFileName = "memory-tidy.json"
|
||
// memoryTidyConfigSubdir 是落点的第一段目录（`$DATA_DIR/config/`）。与
|
||
// backthink 各自声明一份而不是共用一个常量：某一族换位置时，共用常量会让
|
||
// 另一处**静默**跟着搬家。
|
||
memoryTidyConfigSubdir = "config"
|
||
)
|
||
|
||
// MemoryTidyConfigRelPath 是落点相对 `$DATA_DIR` 的路径（`config/memory-tidy.json`）。
|
||
// 导出它是为了让面板/文档能**如实**告诉主人改哪个文件，而不必把部署相关的绝对路径
|
||
// 塞进接口形状。
|
||
const MemoryTidyConfigRelPath = memoryTidyConfigSubdir + "/" + memoryTidyFileName
|
||
|
||
// ErrInvalidMemoryTidy 是 memory-tidy.json 结构不合法时的分类错误（errors.Is 可判类）。
|
||
var ErrInvalidMemoryTidy = errors.New("runtimeconfig: invalid memory tidy config")
|
||
|
||
// MemoryTidyTuning 是 `memory-tidy.json` 的形状：记忆整理运行期的两个旋钮。
|
||
//
|
||
// AutoApply 用**指针**是刻意的：代码默认值是「开」，而 JSON 的 `bool` 零值也是
|
||
// false —— 用 bool 会让「这个键没写」与「显式写 false」不可区分，于是任何只写
|
||
// 上限的文件都会**静默把自动档关掉**。指针让「没写」= nil = 不覆盖默认。
|
||
//
|
||
// 字段名是 camelCase 的 JSON 键（文件是给人看、给人改的）。
|
||
type MemoryTidyTuning struct {
|
||
// AutoApply 控制轮末自动落地。nil = 没配（用代码默认值：开）；false = 一键
|
||
// 回到「只产建议」；true = 显式开（与默认同义，写它只是为了自解释）。
|
||
AutoApply *bool `json:"autoApply"`
|
||
// AutoApplyPerRound 是每轮自动落地的条数上限。零/负 = 没配 ⇒ 用代码默认值
|
||
// （**没有「无上限」语义**，最终还会被硬顶钳位）。
|
||
AutoApplyPerRound int `json:"autoApplyPerRound"`
|
||
}
|
||
|
||
// AutoApplyOff 报告自动档是否被这份配置**显式关掉**。nil（没配）返回 false ——
|
||
// 「没配」不等于「关掉」，那正是指针存在的理由。
|
||
func (t MemoryTidyTuning) AutoApplyOff() bool {
|
||
return t.AutoApply != nil && !*t.AutoApply
|
||
}
|
||
|
||
// DefaultMemoryTidyPath 返回记忆整理调优的落点：`$DATA_DIR/config/memory-tidy.json`。
|
||
func DefaultMemoryTidyPath(dataDir string) string {
|
||
return filepath.Join(dataDir, memoryTidyConfigSubdir, memoryTidyFileName)
|
||
}
|
||
|
||
// LoadMemoryTidyTuning 读取 memory-tidy.json（**只读**）。
|
||
//
|
||
// 文件缺失或全空白 ⇒ 零值 + nil：调用方用代码默认值（normalizeTidyConfig 会把
|
||
// 非正的上限回落默认），因此「没配过」与「配成 0」得到同一个结果。
|
||
//
|
||
// 存在但解不开 ⇒ 返回错误。调用方应记一条带 source 的 WARN 并回落默认；
|
||
// **不得覆盖**那个文件（损坏的文件可以人工救回，程序盖掉它就丢了人工写的意图）。
|
||
//
|
||
// 它不建目录、不读老位置：新家族没有老位置（design/13 §2.1 第 5 条）。
|
||
func LoadMemoryTidyTuning(path string) (MemoryTidyTuning, error) {
|
||
raw, err := os.ReadFile(path)
|
||
if err != nil {
|
||
if os.IsNotExist(err) {
|
||
return MemoryTidyTuning{}, nil
|
||
}
|
||
return MemoryTidyTuning{}, fmt.Errorf("runtimeconfig: read %s: %w", path, err)
|
||
}
|
||
if strings.TrimSpace(string(raw)) == "" {
|
||
return MemoryTidyTuning{}, nil
|
||
}
|
||
var t MemoryTidyTuning
|
||
if err := json.Unmarshal(raw, &t); err != nil {
|
||
return MemoryTidyTuning{}, fmt.Errorf("%w: decode %s: %w", ErrInvalidMemoryTidy, path, err)
|
||
}
|
||
return t, nil
|
||
}
|