ISSUE-0226 AI 配置同步挱云端 tab + 开关形态重做¶
来源¶
2026-10-02 Tony 截图报障(docs/raw/inbox/2026-10-02-ai-sync-placement.md):
「这个同步云端 不应该放到云端设置里吗?帮我对抗审查分析下 另外,好丑的
开启那个一点都不明显。」主控对抗分析(正方=编辑现场原则/反方=用户按目的地
分类 + 四处同步命名撞车)后 Tony 拍板:挱云端 + 重微形态。
病灶¶
- 归属:「自动同步到云端」(AI 配置 autoSync)在 AI tab 底部裸奔(无卡片框), 与云端 tab 两块云功能(云备份/数据池)语义割裂;全仓「同步」≥4 处三套开关形态, 「云端数据同步」vs「自动同步到云端」命名无法区分。
- 开关隐身:SWITCH_CLASS 20×36px 拨杆关态 bg-muted 灰底灰边,在整行 muted 文字里接近隐身(Tony:「开启那个一点都不明显」)。
- 丑:一行塞开关+标题+问号+状态+两图标按钮 7 元素;无卡片框与 AI tab 其他分区形态不齐。
修法(Tony 拍板方案)¶
- 同步区块整体提取为独立卡组件(如
AiSyncCard,自持 aiSettings 的 autoSync 读写与 push/pull/状态逻辑),挪到云端 tab 作第三块云功能, 改名「AI 配置同步」(去撞车);云端 tab 三块命名顺一遍: 云备份(采集结果)/ 来发信数据池 / AI 配置同步。 - AI tab 原位置留一行轻量状态(开:「AI 配置已自动同步 · 最近 xx」; 关:「AI 配置仅存本机」),可点击跳云端 tab(settings-view 的 onTabChange 传下去)。
- 开关形态重做:保持
input[type=checkbox](🔴 ai-off-account-probe.test.tsx 锚点,不能换 Radix),放大尺寸对齐 RHFSwitch 观感;开/关态各配语义 chip (开=「已同步」蓝、关=「仅本机」灰),状态一眼可读。 - 套 SectionCard 与云端 tab 两卡形态对齐;明文 Key 警示、上传/拉取按钮跟着挪。
- 🔴 禁阉割:autoSync 开关、手动推/拉、明文警示、多机覆盖说明(HelpTip) 全部保留;同步行为逻辑零变化(只挪家)。
状态¶
- 2026-10-02 开账(Tony 拍板)→首轮 T2 双审 NO-GO(执行体挂载时机)→回环一→验收 NO-GO(timer 生命周期)→回环二→双席验收 GO-WITH-WARNINGS(处方 10/10 落地,主控复跑 188/2896 绿)→ v0.16.78 收口。尾巴见 devlog 回环二验收收口条目(R2-1/2/3 注释与卸载清理、R2-4 双 realm、循环依赖)。
- 2026-10-02 fixed @ v0.16.78(第一刀,后被双席 NO-GO 打回):卡组件
src/sections/settings/view/ai-sync-card.tsx(云端 tab 第三块「AI 配置同步」); 共享源src/utils/ai/ai-sync-shared.ts+watchAiSettings; AI tab 底部状态行(点「去云端设置」跳 tab);开关 24×44+描边 + 开「已同步」/关「仅本机」chip;云端 tab 三块命名顺一遍。 截图:docs/raw/screenshots/2026-10-02-ai-sync-card-harness.png(三态+状态行+新旧对照)。 - 2026-10-02 T2 双席 NO-GO(P1×2 同根因)→ 回 in-progress:自动上传/启动拉取的
执行体住在 AiSyncCard(只在 cloud tab 挂载)—— AI tab 编辑时无人上传、
切 tab 后那笔编辑被记基线永不再推、启动拉取退化为开 cloud tab 才拉。
返工:执行体下沉
src/utils/ai/ai-sync-controller.ts(settings-view 恒挂载, 行为基线逐条等价旧版);F-3 拉取回推根治(共享源写分类 lastWriteKind + noteAiSyncWrite 登记口,pullAiSettings 内部登记);F-4 测试复位钩子进 setup-dom;F-5 stub watch 升级(__setStorageValueForTests 泵)+ tests/ai-sync-controller.test.tsx 三条行为钉(mutation 自证红)+ controller 依赖注入探针(jsdom 模块双图教训);F-6 云备份一套名 / F-7 说明行改准 / F-8 死锚删 / F-9 在途守卫。 验证:compile 0 错;2891 tests 全绿;build manifest=0.16.78。 详见 docs/changelog/development-log.md v0.16.78 回环条目。 - 2026-10-02 二轮验收 luna NO-GO / glm GO-WITH-WARNINGS → 保持 in-progress: P1×2 timer 生命周期(关 autoSync 不清排队上传、手动拉取不取消排队 timer); P2×3(登记下沉 saveAiSettings/writeAiSettingsPulled 消灭未登记写路径与双重打戳、 pulledOnce 回归每次挂载、F-3 钉改走真实登记链);P3(死注释改准、基线退出闸)。 验证:compile 0 错;188 files / 2896 tests 全绿(行为钉 6 条 + 登记链钉 2 条, P1-2 mutation 自证红);build manifest=0.16.78。 尾巴记账:N-4 pull 回显竞态残余窗口、双 realm 并发互推(已声明「宁可多推」)。