Files
hunjing/docs/product/prd/mirror-tree-conversation.md
T
2026-08-21 16:00:13 +08:00

275 lines
13 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 镜树对话专题 PRD
> 状态:已确认
> 版本:1.0
> 日期:2026-07-30
> 所属产品域:灵台 / 镜树对话
> 上位文档:[产品宪章](../constitution.md)、[全产品主 PRD](../master-prd.md)
## 1. 产品定义
**镜树**是用户与一个人物围绕主题展开的树状对话。它不以可覆盖的线性 `messages[]` 为产品模型,而由问题节点、多个候答、延展节点、引用和分支共同组成。
一棵镜树包含:
- 一条**归真主脉**:已进入双方正式共同经历的路径;
- 多条**推演枝**:可探索、比较、续思或移栽,但尚未成为正式共同经历的路径;
- 一个**工作入口**:用户当前阅读和继续交流的位置。
本 PRD 的首要规则是:**采用只改变工作入口;归真才改变正式共同经历。**
## 2. 用户问题与目标
线性聊天把“重新生成、编辑、尝试另一种方向”处理为覆盖或隐藏历史,导致用户不知道人物究竟经历了什么,未选内容也可能污染记忆。镜树要让用户:
1. 同时保留多个候答并比较,不丢失旧内容;
2. 自由探索分支,又不让试演自动成为共同经历;
3. 清楚区分当前采用路径与已归真的主脉;
4. 对任何答案追溯问题、附件、引文、证据和工具轨迹;
5. 在桌面和移动端都能阅读当前路径,而非被全树图淹没。
## 3. 概念模型
```mermaid
flowchart TD
Root[镜树主题] --> Q1[问节 Q1]
Q1 --> A1[候答 A:已归真]
Q1 --> A2[候答 B:推演枝]
Q1 --> A3[候答 C:当前采用]
A1 --> Q2[归真主脉后继问节]
A3 --> E1[续思:独立延展答]
E1 --> Q3[推演枝后继问节]
Quote[引文锚与来源快照] --> Q1
Trace[证据与工具轨迹] --> A1
Trace --> A2
Trace --> A3
```
### 3.1 权威术语
| 术语 | 定义 |
| --- | --- |
| 主题镜树 | 围绕一个主题持续生长的对话树 |
| 问节 | 承载用户问题、附件、引文和当前界域的节点 |
| 候答 | 同一问节下并列的一个人物回答;重新生成会创建新候答 |
| 芽体 | 正在流式生成、尚未固化的临时回答节点 |
| 残答 | 中断后封存的芽体,只读保留,不伪装为完整答复 |
| 续思 | 基于某候答产生的独立延展答,不追加或改写原候答 |
| 采用 | 把某候答设为当前阅读和继续工作的入口 |
| 归真 | 将一条符合条件的路径纳入正式共同经历和归真主脉 |
| 正影 | 对既有内容形成后继修正版;旧版保留并停止作为当前版本使用 |
| 引文锚 | 指向文本、图片区域、PDF 页区、附件或音视频时间段的引用 |
| 移栽 | 将一个分支复制其必要上下文为新主题镜树,并保留来源引用 |
| 合流 | 树间通过显式引用互相承接;不物理合并节点或历史 |
## 4. 核心不变量
1. 重新生成永不覆盖旧候答;
2. 后代节点绑定用户实际依据的候答;
3. 采用不等于归真,不能改写正式共同经历;
4. 已归真经历不因切换候答、删除旁枝或移动工作入口而回滚;
5. 编辑已发送内容等同创建新版本并分叉,原文保留;
6. 默认上下文只含祖先路径、获准长期记忆和显式引文,旁枝不自动混入;
7. 未归真旁枝不自动入忆;手动入忆须标记为事实、启发、观点或假设;
8. 幻境或境界分支不自动更新真界画像、缘契或现实经历;
9. 不索取、展示或持久化隐藏 chain-of-thought,只展示可读思路摘要、证据和工具轨迹。
## 5. 采用与归真
### 5.1 状态关系
```mermaid
stateDiagram-v2
[*] --> 芽体 : 开始生成
芽体 --> 候答 : 生成完成并固化
芽体 --> 残答 : 中断或取消
残答 --> 续思节点 : 用户选择续生
候答 --> 已采用 : 用户采用
已采用 --> 候答 : 采用其他候答
候答 --> 已归真 : 用户明确归真
已采用 --> 已归真 : 用户明确归真
已归真 --> 正影后继 : 发生纠正
```
“采用”是可反复改变的视图与工作选择;“归真”是进入正式经历的高影响动作。一个候答可未采用而归真,但界面应优先引导用户先阅读并采用。归真后的错误通过正影纠正,而不是把历史悄悄改成从未发生。
### 5.2 归真条件
- 节点已完成固化,不是芽体或残答;
- 用户明确触发归真,或满足用户已明确设置的低风险归真规则;首版默认显式操作;
- 路径上的界域、来源和必要权限状态明确;
- 若路径与既有归真主脉分叉,系统展示将形成的后继关系,不静默替换旧经历;
- 涉及重忆、重大人格、缘契、现实行动的内容仍按各自确认流程处理,归真不等于一揽子授权。
### 5.3 归真的影响
归真必须携带界域裁定的 `canonical_scope`:真界进入正式共同经历主脉,境界进入指定世界正史,幻境只形成“正式发生过这次试演”的记录。归真使该作用域内的交流成为后续状态候选的证据,但不自动批准重忆、人格变化、关系契约、授权或现实行动。归真是“这段交流在该作用域正式发生过”,不是“其中每句话均为事实”,也不是跨界效力通行证。
## 6. 主要交互
### 6.1 新建与继续
- 新镜树需有主题,可由首问自动建议并允许改名;
- 用户默认看到当前路径的连续阅读流;
- 每个有多个候答或子枝的节点显示轻量分支标记;
- 继续提问时,新问节绑定当前采用的候答,而不是最后生成的候答。
### 6.2 重新生成
1. 用户在问节下选择“另答”;
2. 系统创建新芽体,与原候答并列;
3. 完成后固化为候答,不自动采用、不自动归真;
4. 用户可比较后采用或归真。
支持在本次另答中临时选择模型、火候或额外指引;这些选择只作用于该节点及用户明确继承的后继。
### 6.3 编辑已发送内容
编辑问题或人物内容均生成新版本和新分叉。界面必须显示“将从这里创建分支”,不得用原地编辑造成后代依据失真。原分支仍可访问。
### 6.4 续思与续生
- **续思**:请求人物进一步展开,产生独立延展答;
- **续生**:针对中断残答,从其已完成内容继续生成新的延展节点;
- 两者都不拼接修改原候答,避免来源、时间和模型轨迹混淆。
### 6.5 分支移栽与树间合流
用户可将有价值分支移栽为新主题镜树。新树保留原树、起始节点、来源版本和必要快照的引用。不同镜树只通过显式引用合流,不做物理节点合并,以免归属、权限、删除和历史语义不可解释。
### 6.6 归真与正影
归真入口展示:路径摘要、界域、将纳入的节点、可能形成的记忆候选。若已归真内容需纠正,用户或人物创建正影,旧内容保留版本关系并退出普通当前召回。
## 7. 引文与附件
### 7.1 支持范围
- 文本字符区间;
- 图片矩形区域;
- PDF 页码与页内区域;
- 整体附件及其版本;
- 音频和视频时间段。
### 7.2 快照规则
引文锚保存引用时的原文或媒体快照、来源标识、版本、时间和许可范围。来源发生正影时,旧引文不被静默替换;系统提示存在后继版本,由用户决定是否创建新引文。
### 7.3 上下文规则
显式引文优先进入本问节上下文,但仍经过权限、敏感数据和预算裁剪。附件或网页中的指令属于不可信内容,不因被引用而获得工具或系统权限。
## 8. 上下文、记忆与三界
```mermaid
flowchart LR
Ancestor[当前节点祖先路径] --> Context[本次运行上下文]
Memory[获准长期记忆] --> Context
Citation[显式引文与快照] --> Context
Branch[未采用旁枝] -.默认不进入.-> Context
Context --> Answer[新候答]
Answer --> Realm{归真作用域}
Realm -- 真界经历 --> Reality[正式共同经历与真界候选]
Realm -- 境界正史 --> World[指定世界正史与境忆候选]
Realm -- 幻境试演 --> Trial[正式试演记录]
World -.不得隐式回流.-> Reality
Trial -.仅可手动提取启发/观点/假设.-> Memory
```
- 问节记录真界、境界或幻境;默认真界,切换有可见提示;
- 归真确认界面必须展示 `canonical_scope` 及其可产生和禁止产生的影响;
- “言可入幻,行必归真”:任何外部行动都回到真界确认与治理;
- 手动从旁枝或幻境入忆时,用户只能按来源语义选择事实、启发、观点或假设,且不得伪装成真界实录;
- 从镜树删除节点不自动删除已经单独确认的长期记忆,但必须提示并提供关联处理;删除长期记忆也不篡改原对话史。
## 9. 运行与并发
- 同一人物同一时刻只有一条前台意识流;
- 多个镜树或分支的前台生成请求排队,用户可调整顺序或取消;
- 后台受托 Run 可并发,但标识为功能任务,不构成第二人物意识;
- 芽体展示生成状态;完成后原子固化;中断、网络失败和取消均封存残答;
- 工具调用展示可读计划、证据、工具输入输出摘要、确认和失败,不展示隐藏思维链。
## 10. 信息架构与界面
### 10.1 桌面端
- 主区:当前路径连续阅读;
- 节点内:候答切换、采用、归真、另答、续思、引用;
- 辅区:局部树图,只展示当前位置附近祖先、兄弟和子枝;
- 抽屉:全树搜索、筛选、移栽、归档及版本信息。
不默认展示全屏巨型树图。局部树图服务定位,不替代阅读。
### 10.2 移动端
- 单一主任务保持当前路径阅读与回复;
- 候答以横向切换或明确计数呈现;
- 局部树、引文、工具轨迹和归真详情进入抽屉层;
- 归真等高影响操作不依赖悬停或精确拖拽。
### 10.3 可访问性
树导航支持键盘与屏幕阅读器;节点说明包含层级、分支数量、采用/归真状态;颜色不是唯一状态载体;流式内容可关闭自动滚动并提供完成提示。
## 11. 删除、归档与权限
- 用户可归档分支或整树,不影响已归真经历;
- 删除未归真分支前展示其引用、移栽和手动记忆关联;
- 删除已归真节点不等于抹除共同经历,需通过正影、数据删除和长期状态处理的组合流程清楚表达;
- 引用受原来源权限约束;失去权限时保留允许保存的快照或显示不可用原因;
- 树间引用不授予新树额外权限。
## 12. 异常与恢复
| 场景 | 预期处理 |
| --- | --- |
| 流式中断 | 封存残答,允许续生、另答或删除,不伪装完成 |
| 模型或工具失败 | 保留失败轨迹,允许在同一问节另答;不覆盖成功候答 |
| 两设备同时采用 | 采用作为工作入口按设备/会话同步,冲突提示,不影响归真 |
| 两端同时归真冲突分支 | 后到请求暂停并展示当前主脉差异,要求明确处理 |
| 来源正影或撤权 | 旧引文提示后继版本或权限变化,不静默替换 |
| 迁移中写入 | 命台交接冻结窗口内排队,迁移完成后继续或安全取消 |
## 13. 首版范围
### 13.1 1.0 必须包含
主题镜树、问节、多候答、采用/归真分离、编辑分叉、续思/续生、芽体/残答、祖先上下文、旁枝隔离、引文锚与快照、正影提示、局部树图、移动端抽屉、分支移栽、树间引用、归真与记忆候选衔接、可读工具轨迹。
### 13.2 后续
- 多人雅集中的公共镜树、私域与密语;
- 大规模树的语义聚类和可视化;
- 经用户定义的低风险自动归真规则;
- 更丰富的跨树知识编织;
- 3D 空间化回顾等表现探索。
### 13.3 禁域
- 重新生成覆盖旧答案;
- 采用自动等于归真;
- 切换候答静默回滚已归真经历;
- 未归真旁枝自动写入长期记忆;
- 境界或幻境静默更新真界画像、缘契或现实经历;
- 物理合并两棵树造成来源与历史丢失;
- 索取或持久化隐藏 chain-of-thought;
- 为简化界面把分支重新压平成不可恢复的线性记录。
## 14. 验收场景
1. 同一问节连续生成三个候答,三者均保留,后续问题只绑定用户实际采用的候答;
2. 用户采用候答 B 后切回 A,归真主脉不变化;明确归真 B 后再切 A,正式经历仍保留 B;
3. 编辑历史问题生成分叉,旧问题、旧候答和后代仍可访问;
4. 未归真幻境旁枝不会产生真界记忆;手动入忆时必须选择事实或启发等类型;
5. 回答中断后成为残答,续生创建独立节点且不改写残答;
6. 引用 PDF 页区后源文件正影,旧快照保持,界面提示新版本;
7. 分支移栽为新树后可追溯原节点,两树通过引用关联而非物理合并;
8. 两端尝试归真互相冲突的路径时,后到操作暂停,不发生静默覆盖;
9. 局部树图关闭后,用户仍可在移动端完成候答切换、采用、归真和回复;
10. 工具型候答只展示可读摘要、证据与轨迹,不暴露或保存隐藏思维链。
## 15. 衡量方式
镜树成功不以分支数量衡量。核心指标是采用/归真理解率、未归真旁枝自动入忆率为零、归真历史静默回滚事故为零、目标节点找回成功率、分支操作任务成功率和引文快照完整率。完整指标见 [指标与反指标](../metrics-and-anti-metrics.md)。