shop_helm/docs/method-map.md

方法对照表

遇到失败模式时先修最相关的工件或边界，不把新规则全部塞进入口文件。

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

使用原则

• 先确认失败模式，再修最小的一项事实、边界或测试。
• 修复完成的同一任务同步相关工件。
• 同一个事实只有一个权威位置，其他文档只做摘要和链接。
• 高风险功能用可复现原型和测试给结论，不靠“理论上可行”。