CHAT-001 P0 | 定义 ChatScope 设计文档 docs/chat-scope-design.md #82

New Issue

wangdl · 2026-06-06T16:23:22+08:00

wangdl commented

2026-06-06 16:23:22 +08:00

完成 ✅

设计文档已写入 docs/chat-scope-design.md

文档内容

概述与目标
8 条核心规则
ChatScope 类型定义（5 种 scope）
17 条完整决策表
数据模型（ChatSession/ChatMessage/ChatCitation 完整 Schema + 字段变更汇总表）
API 契约（4 个端点的完整定义：create/list/messages/stream + PATCH）
open-or-create 算法（含 TypeScript 伪代码）
上下文检索策略（5 种 scope 的检索实现）
iOS 集成（ChatEntryContext + 6 个入口映射表 + Route 参数 + Swift 示例）
迁移计划（含 SQL 回填脚本）
边界情况处理（8 种）
依赖关系图
附录 A (TS 完整类型) + 附录 B (Swift 完整类型)

下一步

#83 CHAT-002 — 定义 ChatScope API Contract 前后端接口协议

## 完成 ✅ 设计文档已写入 `docs/chat-scope-design.md` ## 文档内容 1. 概述与目标 2. 8 条核心规则 3. ChatScope 类型定义（5 种 scope） 4. 17 条完整决策表 5. 数据模型（ChatSession/ChatMessage/ChatCitation 完整 Schema + 字段变更汇总表） 6. API 契约（4 个端点的完整定义：create/list/messages/stream + PATCH） 7. open-or-create 算法（含 TypeScript 伪代码） 8. 上下文检索策略（5 种 scope 的检索实现） 9. iOS 集成（ChatEntryContext + 6 个入口映射表 + Route 参数 + Swift 示例） 10. 迁移计划（含 SQL 回填脚本） 11. 边界情况处理（8 种） 12. 依赖关系图 13. 附录 A (TS 完整类型) + 附录 B (Swift 完整类型) ## 下一步 #83 CHAT-002 — 定义 ChatScope API Contract 前后端接口协议

wangdl added this to the M7：ChatScope 会话系统 — 学习对象绑定的上下文会话 milestone 2026-06-06 16:23:22 +08:00

wangdl closed this issue

2026-06-06 17:03:19 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/api-server#82