lazygophers aidog 流程与信息架构优化
针对「用户完成一件事的路径」而非单个像素。aidog 是代理网关管理器，核心流程围绕：平台(Platforms) → 分组(Groups) → 日志(Logs) → 设置/统计。本 skill 优化这些流程的步骤数、一致性、状态反馈、信息层级。
何时用
- 某流程「步骤太多 / 太绕 / 中途会卡」。
- 成对操作不一致：新增 vs 编辑、导入 vs 导出、启用 vs 停用 行为/UI 不对称。
- 保存/同步「点了没反应」「状态不更新」。
- 侧栏/tab 信息层级乱，用户「找不到」。
aidog 流程现状锚点
| 流程 | 入口 | 关键约定 |
|---|---|---|
| 导航结构 | App.tsx 侧栏（页级）+ AppSettings.tsx tab（设置内） |
无 react-router，纯本地 state |
| 离页保护 | utils/navGuard.ts 注册表 |
有未保存改动时拦截切页 |
| 设置保存 | 字段保存时确定性物化，禁靠 debounce effect | 改 group 配置后须 syncGroupSettings |
| Group 统计 | 前端逐 group 调 groupUsageApi.stats |
后端按 proxy_log.group_name 聚合 |
| 平台重试 | 多平台失败 failover + 三态 status | 后端 router.rs + scheduling.rs |
| 导入导出 | 7 scope 逐项冲突处理 | gateway/import_export/ |
执行流程
Step 1：画现状流程图（禁凭感觉改）
- 把目标流程拆成步骤序列：用户从哪进入 → 每步点什么 → 每步看到什么反馈 → 在哪结束。
- 标注痛点类型：①步骤冗余 ②无反馈 ③易误触 ④成对操作不一致 ⑤状态不同步。
- grep 涉及的 page/command，确认真实交互（如保存走哪个 invoke、同步触发点）。
Step 2：对照「成对操作一致性」
aidog 大量成对操作。优化一个流程时检查它的「对偶」是否需同步改：
| 操作 | 对偶 | 一致性检查点 |
|---|---|---|
| 新增平台 | 编辑平台 | 字段、校验、保存反馈是否对称 |
| 导入 | 导出 | scope 范围、冲突提示是否对齐 |
| 启用 skill | 停用 skill | 乐观更新 + 失败回滚是否都做了 |
| 创建 group | 修改 group | 改完是否都触发 syncGroupSettings |
🔴 CHECKPOINT：改成对操作之一前，确认是否要同步改对偶。只改一半 = 引入新的不一致。
Step 3：状态反馈与时序
每个会产生副作用的操作必须有：发起态（loading/busy）→ 成功态 → 失败态（可回滚）。
- 保存/同步：禁靠 debounce effect 隐式触发，须显式确定性物化（项目踩坑：statusLine 字段曾因 debounce 丢保存）。
- 改 group 配置后必须
syncGroupSettings，否则磁盘配置与 UI 不一致。 - 长操作（安装 skill、同步价格）做乐观更新，禁全页 spinner 阻塞（Skills 页已是范本）。
Step 4：信息架构（侧栏/tab 层级）
- 一个页放太多 → 拆 tab（参考
AppSettings.tsx模式）。 - 高频操作前置，低频/危险操作收起。
- 改导航结构同步检查 navGuard 注册是否仍覆盖新增页。
Step 5：验证
yarn build # 类型 + 构建
yarn check:i18n # 新增流程文案的 key
实际走一遍改后流程，数点击次数 / 确认每步有反馈。
失败模式编码（if-then）
| 触发 | 一线修复 | 仍失败兜底 |
|---|---|---|
| 改完保存「点了没反应」 | 确认是显式物化而非 debounce effect | 检查 invoke 是否真触发 + 加成功 toast |
| group 改完 UI 对但实际没生效 | 确认调了 syncGroupSettings |
查 do_sync_group_settings（会 strip _aidog_statusline 等） |
| 精简步骤后丢了离页保护 | navGuard 注册随新流程更新 | 检查注册/注销时机 |
| 成对操作改一半导致不一致 | 回 Step 2 同步改对偶 | 列对偶清单逐项核对 |
反例黑名单（不要做）
- ❌ 只改成对操作的一半（如只改"新增"不改"编辑"）。
- ❌ 用 debounce effect 做关键保存 —— 必显式确定性物化。
- ❌ 改 group 配置不调 syncGroupSettings。
- ❌ 长操作用全页阻塞 spinner —— 用乐观更新。
- ❌ 重组导航后忘了更新 navGuard 覆盖。
- ❌ 凭感觉精简步骤而不先画现状流程图。
相关
- 视觉/布局：
aidog-frontend-experienceskill - 请求链路：
aidog-request-inspectskill - 性能：
aidog-perf-auditagent