chenmoranzhiandCursor
9306c8e659
便于后续落地偏好召回时对照已拍板边界。 Co-authored-by: Cursor <cursoragent@cursor.com>
64 lines
2.6 KiB
Markdown
64 lines
2.6 KiB
Markdown
# 用户偏好 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` 一致）
|