记忆治理与写入

本页描述灵犀“记忆写入模块”的稳定方案，而不是脚本级实现细节。

模块定位

lingxi-memory-write 位于记忆系统中游，承接上游识别结果并落盘：

• 上游：taste-recognition 决定“是否写入、以何种结构写入”
• 中游：lingxi-memory-write 决定“如何治理、是否门控、写入哪里”
• 下游：memory-retrieve 在 pre/post 时机消费记忆并触发履约

稳定职责边界

写入模块长期保持以下边界：

• 仅接收结构化 payload，不直接消费原始对话
• 不做价值判定（不重复做识别层工作）
• 统一执行治理动作：dedupe / merge / replace / veto / new
• 对高风险动作执行用户门控
• 维护 note 与 INDEX 的一致性

治理策略

治理遵循“语义相近优先收敛”的策略：

1. 先判断与已有记忆的关系（相同、补充、冲突、无关）
2. 再选择治理动作（去重、合并、替换、否决、新建）
3. 在必要场景要求用户确认
4. 记录审计，确保可追溯

该策略关注的是决策原则，而非具体阈值与打分参数。

门控策略

• 低风险：允许自动执行（如明显去重）
• 中高风险：必须用户确认（如替换、删除、冲突覆盖）
• 新建路径：按置信度分流是否静默写入

门控的核心目标是：在保证效率的同时，用户始终掌握关键决策权。

与检索时序的关系

写入时可标注记忆触发时机（TriggerTiming）：

• pre：执行前生效
• post：执行后生效
• both：前后都可生效

检索层据此在步骤 C 与步骤 D 做不同阶段的履约，形成“写入即服务于执行”的闭环。

与 memory-govern 的分工

• 写入模块：处理“本次写入”过程中的即时治理
• memory-govern：处理“全库层面”的索引同步与主动治理

两者互补：一个是事务内治理，一个是库级治理。

文档边界说明

官网不承诺以下易变实现细节：

• TopK、阈值、内部评分实现
• 审计事件字段的完整枚举
• 脚本参数与内部流程编排

这些信息以主仓实现为准，官网仅保持架构与方案准确。