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

用户偏好库 / 文风库

状态：节点绑定（无 RAG）。偏好与文风分库；创作节点声明 libraries 后注入，库空跳过。

两库

| 库 | 存盘 | 绑定节点 | 注入 |

|----|------|----------|------|

| 文风库 style-packs | ~/.writing-agent/style-packs.json | 叙事指南、叙事指南与故事推进 | 【文风库 · 可选用】 |

| 偏好库 preferences | ~/.writing-agent/preferences.json | 用户需求 | 【偏好库 · 可选用】 |

读写

| 阶段 | 行为 |

|------|------|

| 库页 | 顶栏「库」：手写 CRUD + LLM 提取入库 |

| 创作节点 | design-step / 对话落盘按 libraries 注入目录；节点选用写入本局产物 |

| 开玩 | 不再全量自动摊偏好；靠产物 设计.用户需求 / 设计.叙事指南* 挂载 |

| 游玩 | 每隔 N 回合采集偏好候选（设置项）；收下写入全局偏好库 |

偏好条目形状

• id, content, status（active|archived）, createdAt, updatedAt

文风包形状

• id, name, content, samples?, status, createdAt, updatedAt

设置

• preferenceCollectEveryTurns：采集间隔（默认 10；0=关）

• 设置页「用户偏好」：只留间隔；CRUD 在库页

API

• GET/POST /api/preferences；PUT/DELETE /api/preferences/:id

• POST /api/preferences/extract

• GET/POST /api/style-packs；PUT/DELETE /api/style-packs/:id

• POST /api/style-packs/extract

• POST /api/sessions/:id/preferences/review

实现

• src/libraries/registry.ts — 库注册 + formatBoundLibrariesForPrompt

• src/style-pack/ — 文风库

• src/preference/ — 偏好库 + extract

• skills/.../modules/user-requirements/ — 用户需求节点

• web/libraries.html — 库页