3 Commits

Include renames

Author	SHA1	Message	Date
AskaEth	fe4c702f87	feat(gateway): 未读面 unreadCount 进 message_persisted 帧（契约 v0.76 ②） ... - broadcastPersisted 是 Web 与 IM 两条路的**共用**函数 ⇒ 两处口径天然一致，不存在分叉 - 口径 = 绝对未读 + 主人单一已读游标（chat_sessions.read_at）⇒ 多端共享 - 可选键 omitempty：只在 >0 且确实算得出来时出现；0 与「算不出来」都不顶位 （0 只能从「会话有游标」推出，否则那个 0 就是编的）⇒ 缺席 = 老行为 - Docs/api-client.md：v0.76 ① 按实测改标「未实现且无实现路径」（见下），② 已实现， 并更正「GET /sessions 的 unreadCount 自 D4 起已在」、新增 §4.13 与 §7.4 第 23 条 ⚠️ ① toolCalls[] 本版未落地（取证结论，非推断）：chat_messages.turn_id（编排器随机路标识 turn-<16hex>）与 flow_graphs.turn_id（trace.FlowGraph.ID = <session>-<轮次序号>，进程内递增） 不同源，真实库中 66 条消息行 vs 21 条图行字面交集为空 ⇒ 无法 join；按时间窗硬凑属于猜，不做。 补齐路径：链路图带回合标识（新键 + 迁移 0023 起）+ 落盘列，之后 toolCalls[] 是一条批量 SQL。 我亲自复跑的变异：去掉帧里的 n > 0 守卫 ⇒ TestBroadcastPersistedUnreadCountAbsentWhenUnknown 与 TestBroadcastPersistedCarriesUnreadCount 双双 FAIL（断言「0 不该顶位」）⇒ 测试是真护栏。	2026-10-06 07:58:42 +08:00
AskaEth	09fba77f87	docs(comments): 注释中文化 · internal/runtime/history（15 文件，纯替换） ... - 只翻注释/文档字符串：剥离注释后代码行逐字节不变（机械校验只剩 4 条行尾注释的翻译，代码前缀全等） - 交叉引用（design/16 §4.6、D4/B3、0010 迁移文件名）逐字保留 - 保留未译技术词：DDL/rowid/LIKE/LEFT JOIN/DTO/rune/WS/actor 及全部标识符与表名 - 顺带副作用：store.go、session_persona_test.go 由注释文字改变而变得 gofmt 干净（未运行 gofmt -w）	2026-10-04 12:28:48 +08:00
AskaEth	e8eccd2bb2	feat(history,gateway): D4 会话未读/已读游标 — unreadCount + POST /sessions/{id}/read + session_read 广播 ... - chat_sessions 增 read_at（毫秒，与 chat_messages.created_at 同单位）；迁移 0010 并把既有会话回填为各自最新消息时间（升级当天不误报） - ListSessions 单查询派生 unreadCount（无 N+1，复用 idx_chat_msgs_session_created 覆盖索引） - MarkSessionRead 只前进 MAX(read_at, ?)；未知会话 ErrSessionNotFound；游标方法挂在网关消费侧窄接口（沿用 GetMessage/messageLookup 先例，避免污染 runtime 接口与其 fake） - POST /api/v1/sessions/{id}/read：writeAuth + 400/404/501，成功广播 session_read、失败路径不广播 - Docs/api-client v0.37（§1 unreadCount / 新行 8a / §3.9 session_read / §4.2 用法） - 含迁移回填测试、store/handler 测试与变异验证；顺带把 migrate_pinned_test 的「回退一步=0009」硬编码改为对迁移数量免疫	2026-10-03 16:47:55 +08:00