28 lines
2.6 KiB
Markdown
28 lines
2.6 KiB
Markdown
|
# 方法对照表
|
||
|
|
|
||
|
|
> 遇到失败模式时先修最相关的工件或边界，不把新规则全部塞进入口文件。
|
||
|
|
|
||
|
|
| 失败模式 | 表现 | 首要修复 | 权威工件 |
|
||
|
|
| --- | --- | --- | --- |
|
||
|
|
| 新会话重新摸索 | 不知道现在能否运行、下一个任务是什么 | 恢复现实快照 | [`current-state.md`](current-state.md) + [`../progress.md`](../progress.md) |
|
||
|
|
| 范围扩散 | 店铺没闭环就开始订单、AI、RPA | 回到需求和任务依赖 | [`02-requirements.md`](02-requirements.md) + [`06-tasks.md`](06-tasks.md) |
|
||
|
|
| Gio 页面卡顿 | 滚动或拖动时 UI 冻结 | 把 I/O 移出 frame，检查事件模型 | [`04-architecture.md`](04-architecture.md) + [`05-coding-rules.md`](05-coding-rules.md) |
|
||
|
|
| UI 状态丢失 | 输入框、按钮或滚动每帧重置 | 持久化页面/widget 状态 | [`routes.md`](routes.md) + [`05-coding-rules.md`](05-coding-rules.md) |
|
||
|
|
| Chrome 混店或重复启动 | profile 参数错误、占用仍启动 | 收紧 launch/profile port 和测试 | [`api.md`](api.md) + T-102 |
|
||
|
|
| 把 profile 当防关联 | 文案承诺规避平台关联 | 回到产品和合规边界 | [`01-vision.md`](01-vision.md) + [`AGENTS.md`](../AGENTS.md) |
|
||
|
|
| 图片预览与导出不一致 | 位置、缩放或透明度改变 | 只保留共享 planner | [`04-architecture.md`](04-architecture.md) + T-103 |
|
||
|
|
| 原图被改写 | 输出路径等于输入或直接原地保存 | 原子新文件和覆盖保护 | [`05-coding-rules.md`](05-coding-rules.md) + [`api.md`](api.md) |
|
||
|
|
| 导入静默丢数据 | 无效行跳过但用户不知道 | preview、fingerprint、事务提交 | [`api.md`](api.md) + T-304 |
|
||
|
|
| 数据恢复后损坏 | 未校验就替换 SQLite | 完整性检查和回滚副本 | [`04-architecture.md`](04-architecture.md) + T-208 |
|
||
|
|
| 代码改了就宣布完成 | 没有测试、build 或 smoke | 绑定完成到证据 | [`06-tasks.md`](06-tasks.md) + [`clean-state-checklist.md`](clean-state-checklist.md) |
|
||
|
|
| 多 agent 抢改看板 | 状态覆盖、ID 冲突 | 切换一任务一文件 | [`tasks/README.md`](tasks/README.md) |
|
||
|
|
| 文档与实现漂移 | schema/API/页面各自演化 | 按变更类型同步权威文档 | [`AGENTS.md`](../AGENTS.md) 的文档同步规则 |
|
||
|
|
| 日志泄露敏感数据 | 错误日志包含账号或路径秘密 | 结构化错误码和脱敏测试 | [`05-coding-rules.md`](05-coding-rules.md) + T-501 |
|
||
|
|
|
||
|
|
## 使用原则
|
||
|
|
|
||
|
|
- 先确认失败模式，再修最小的一项事实、边界或测试。
|
||
|
|
- 修复完成的同一任务同步相关工件。
|
||
|
|
- 同一个事实只有一个权威位置，其他文档只做摘要和链接。
|
||
|
|
- 高风险功能用可复现原型和测试给结论，不靠“理论上可行”。
|