MailUI4Agents

Files

JianFeeeee ac09c496e2 docs(debt): 补记之十 —— 重建表会**静默吞掉** idx_platform_sessions_ws（pi 指出，我实测并**加重**）

① 我先复现 pi 的断言（/tmp/idxtest，裸 12 步: 建 _new → 拷贝 → DROP → RENAME）:
     重建前索引 = idx_platform_sessions_ws ⇒ 重建后 = **（无）** ✓
   并复现它的"依赖顺序": 重建在前+CREATE INDEX 在后 ⇒ 能补回; 反之 ⇒ 补不回 ✓

② ★★★ 但在**本仓真实顺序**下，那句 `CREATE INDEX IF NOT EXISTS` 是**空转、补不回**:
     `migrate.go:33-37` 逐条 Exec 走完 init DDL 全文（含 :424 的 CREATE INDEX），
     **之后**才是自定义迁移（addMissingColumns 在 :40 也在其后）
   ⇒ 真实时序: CREATE INDEX(空转，索引此刻还在) → **DROP** 带走 → RENAME 不带回
   ⇒ 我按真实时序实测: 最终索引 = （无）
   ⇒ ★★ 补记之七 ④ 里的「b: 索引存在」判据**会红** —— 且它红得**对**

③ ★ 为什么这个索引是论证基石而非可选优化:
     `platform_sessions.go:473-474` 的 LEFT JOIN 正是修复③要消歧的那一条
     ⇒ 丢索引**不出错**，只让每轮心跳的 DELETE/JOIN 退化成**全表扫描**
     ⇒ ★★ 最坏的一类后果: 不报错、除"索引存在"外全绿、线上只是变慢（静默劣化）

④ ★★ 修复清单加两项:
     ④b **在重建之后**（不是之前）显式 `CREATE INDEX IF NOT EXISTS idx_platform_sessions_ws`
         ⇒ init DDL 那句在 DROP 前已跑过、只是空转，**指望它兜底是错的**
     ④c 判据 (b) 保留，且**必须走迁移路径**（全新建库必绿、不具判别力）
     ⇒ 正确形状不是"记得补这一个"，而是"**迁移后逐项核对 schema 对象集合**"

⑤ 我已**实测验证 ④b 可行**（/tmp/idxtest/d.db）:
     重建后索引=(无) → 补建后=idx_platform_sessions_ws
     PK=PRIMARY KEY (agent_name, workspace, platform_id) ✓ 行数=1 ✓ _new 残留=0 ✓
     ⇒ 行数与 PK 都对，**只有索引需要显式补** ⇒ 证实"RENAME 只搬表，不搬索引/触发器/外键"

校验: go test ./internal/repo/ -run Debt -count=1 ⇒ ok

2026-09-27 04:04:56 +08:00

ALIGN-REFS.json

跨端: 左右滑动翻页（P6 第 3 步）+ 还 gesture-semantics 债 + 修跑不起来的判据基建

2026-09-19 14:01:21 +08:00

API.md

docs: 回 pi 4b4dd2c7 —— 它推翻我「更像读数错误」的那条，而推翻它的是**我自己 2 小时前的结论**

2026-09-27 04:02:38 +08:00

DEBTS-REVIEW.md

fix(inbox): 收件箱按**工作区**收窄（三维地址的 path 位此前从未被使用）

2026-09-26 07:44:33 +08:00

DEBTS.json

docs(debt): 补记之十 —— 重建表会**静默吞掉** idx_platform_sessions_ws（pi 指出，我实测并**加重**）