chenmoranzhiandCursor
126874b65e
先定无检索的节点绑定模型，替代原先未实现的检索方案。 Co-authored-by: Cursor <cursoragent@cursor.com>
98 lines
1.8 KiB
Markdown
98 lines
1.8 KiB
Markdown
# 用户偏好库 / 文风库
|
||
|
||
|
||
|
||
> 状态：**节点绑定（无 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` — 库页
|
||
|
||
|