writing-agent/docs/briefs/user-preference-rag-todo.md

用户偏好 RAG 库（待定）

状态：未实现。先记设计共识与未决项，尤其 RAG 插入点。

已对齐

写库（学习，不改游玩上下文）

• 累计对话轮次 ≥ 10（可在设置中改）后，尝试从最近对话总结用户偏好。
• 弹出审核卡：通过 / 编辑后通过 / 合并到已有 / 跳过。
• 通过后才写入全局偏好库；支持去重与更新已有条目。
• 「随机插一条」= 往库里记候选，不修改当前轮 prompt。

读库（仅创建期）

• 根据用户输入 Boss 直聘式召回匹配条目（卡片点选）。
• 选中结果收成本局固定上下文（resident_context / 叙事指南合并），不在游玩期动态插入。

条目形状（草案）

• id, title, kind（style|taboo|tone|format|other）
• keys[]（检索用）, content, mount[], always_on?
• source（manual|learned）, status（active|archived）

未决：RAG 怎么插

当前仓库无 embedding / 向量检索。需先定插入架构，再写代码。

选项	做法	优点	风险
A. 关键词召回	keys + 标题匹配用户输入	零依赖、快落地	召回弱
B. 创建期 LLM 选条	把库摘要交给 design-flow 一步选	与现有编排一致	token、不稳定
C. 本地 embedding	条目向量化 + 相似度 Top-K	真 RAG	新依赖、索引维护
D. 混合	always_on + 关键词粗筛 +（可选）embedding 精排	可渐进	实现稍复杂

读库插入落点（创建期）候选：

1. 设计.用户偏好.选用集 fragment → refine 合并进 resident_context / 叙事 情境备用 / 绝对禁忌
2. 仅 resident_context[]，不经过叙事指南
3. 新设计步「用户偏好」专产选用集

写库触发落点候选：

1. session-manager 回合末计数 + 调 summarize API
2. 独立 PreferenceService + /api/preferences/*
3. 审核 UI 挂在 SessionView.preferenceReview

建议实现顺序（定好 RAG 后再做）

1. 库 store + 手写样例条目
2. 设置项 preferenceReviewEveryTurns（默认 10）
3. 读库：关键词召回 + Boss 卡片 + 选用集 tag
4. refine 合并选用集 → 固定上下文
5. 写库：轮次触发 + 总结 + 审核 + 去重写回
6. （可选）embedding RAG

相关现有基建

• 常驻：src/skills/resident-context.ts，设计.worker集.resident_context
• 投影排序：context-order inserts
• 叙事写法档：设计.叙事指南 → 情境备用
• 设置：src/config/settings.ts
• 无游玩期上下文注入需求（与 context-assembly.md 一致）