feat: 增加重试页面恢复逻辑,优化点击后等待时间
This commit is contained in:
+34
-15
@@ -1,4 +1,4 @@
|
||||
# 项目开发规范(AI协作)
|
||||
# 项目开发规范(AI协作)
|
||||
|
||||
本文档是面向 AI 与开发者的项目开发规范。
|
||||
|
||||
@@ -12,7 +12,8 @@
|
||||
|
||||
- 目标是“让项目更清晰、更可维护、更可测试”,不是单纯把代码拆碎。
|
||||
- 重构优先考虑稳定性、职责边界与可理解性。
|
||||
- 任何新增功能都必须沿现有分层接入,禁止重新堆回巨石文件。
|
||||
- 任何新增功能都必须沿现有分层接入,禁止重新堆回大文件。
|
||||
- 乱码问题视为阻塞问题,不是“后面再顺手修”的小问题。
|
||||
|
||||
## 1. 架构原则
|
||||
|
||||
@@ -31,13 +32,13 @@
|
||||
- 步骤顺序统一由:
|
||||
- [data/step-definitions.js](c:/Users/projectf/Downloads/codex注册扩展/data/step-definitions.js)
|
||||
- [background/steps/registry.js](c:/Users/projectf/Downloads/codex注册扩展/background/steps/registry.js)
|
||||
共同管理。
|
||||
共同管理。
|
||||
|
||||
### 1.3 前后端步骤定义共享原则
|
||||
|
||||
- 任何步骤标题、顺序、key 变更,必须优先改 [data/step-definitions.js](c:/Users/projectf/Downloads/codex注册扩展/data/step-definitions.js)
|
||||
- 不允许只改 sidepanel 文案而不改共享定义
|
||||
- 不允许只改 registry 而不改共享定义
|
||||
- 任何步骤标题、顺序、key 变更,必须优先改 [data/step-definitions.js](c:/Users/projectf/Downloads/codex注册扩展/data/step-definitions.js)。
|
||||
- 不允许只改 sidepanel 文案而不改共享定义。
|
||||
- 不允许只改 registry 而不改共享定义。
|
||||
|
||||
## 2. 模块边界规则
|
||||
|
||||
@@ -49,7 +50,7 @@
|
||||
- 某个单独步骤文件
|
||||
- 某个单独 manager 文件
|
||||
|
||||
### 2.2 不应该继续膨胀的文件
|
||||
### 2.2 不应继续膨胀的文件
|
||||
|
||||
- [background.js](c:/Users/projectf/Downloads/codex注册扩展/background.js)
|
||||
- [sidepanel/sidepanel.js](c:/Users/projectf/Downloads/codex注册扩展/sidepanel/sidepanel.js)
|
||||
@@ -77,7 +78,7 @@
|
||||
1. 是否有纯工具模块
|
||||
2. 是否需要 background provider 调度逻辑
|
||||
3. 是否需要 sidepanel 配置项
|
||||
4. 是否需要 Step 4 / 7 验证码链路接入
|
||||
4. 是否需要 Step 4 / 8 验证码链路接入
|
||||
5. 是否需要成功收尾逻辑
|
||||
6. 是否需要 README 与完整链路文档更新
|
||||
|
||||
@@ -105,7 +106,7 @@
|
||||
3. 导入导出
|
||||
4. state restore
|
||||
5. sidepanel UI
|
||||
6. 是否挂在正确的职责域下
|
||||
6. 是否挂在正确的职责域中
|
||||
7. 文档
|
||||
|
||||
## 4. 测试规范
|
||||
@@ -116,7 +117,7 @@
|
||||
- 优先测试:
|
||||
- 模块是否接入
|
||||
- 核心纯函数是否仍可验证
|
||||
- 回退/停止/异常传播是否仍正确
|
||||
- 回退、停止、异常传播是否仍正确
|
||||
|
||||
### 4.2 不允许的做法
|
||||
|
||||
@@ -145,11 +146,11 @@ npm test
|
||||
|
||||
### 5.1 必须更新文档的场景
|
||||
|
||||
- 文件新增/删除/重命名
|
||||
- 文件新增、删除、重命名后
|
||||
更新 [项目文件结构说明.md](c:/Users/projectf/Downloads/codex注册扩展/项目文件结构说明.md)
|
||||
- 功能链路变化
|
||||
- 功能链路变化
|
||||
更新 [项目完整链路说明.md](c:/Users/projectf/Downloads/codex注册扩展/项目完整链路说明.md)
|
||||
- 开发流程、边界、约束变化
|
||||
- 开发流程、边界、约束变化
|
||||
更新当前文件
|
||||
|
||||
### 5.2 文档更新要求
|
||||
@@ -159,6 +160,14 @@ npm test
|
||||
- 不能让结构文档漏文件
|
||||
- 不能让链路文档落后于真实实现
|
||||
|
||||
### 5.3 乱码要求
|
||||
|
||||
- 所有中文文档、中文注释、中文日志、sidepanel 文案、错误提示文案都必须避免乱码。
|
||||
- 修改任何包含中文的文件时,必须把“乱码检查”视为与“功能是否正确”同级的必做项。
|
||||
- 如果某次修改引入了可见乱码,则该次开发视为未完成,不能提交为最终结果。
|
||||
- 不允许把“当前终端显示有点乱,但文件也许没问题”当作默认成立;必须做显式检查。
|
||||
- 如果文件历史上曾出现过编码问题,修改后必须再次审查该文件整体,而不是只看改动片段。
|
||||
|
||||
## 6. 命名规范
|
||||
|
||||
### 6.1 文件命名
|
||||
@@ -177,11 +186,12 @@ npm test
|
||||
- 优先复用现有模块,不重复发明一套新流程
|
||||
- 共享逻辑先提公共层,再让步骤层调用
|
||||
- 代码新增后应尽量减少主文件体积,而不是只做“形式拆分”
|
||||
- 观测、留档、日志、导出这类横切能力必须优先挂在独立配置域下,不能借某个 provider 的业务模式开关隐式控制
|
||||
- 观察、留档、日志、导出这类横切能力必须优先挂在独立配置域下,不能借某个 provider 的业务开关隐式控制
|
||||
- 保留少量兼容型薄包装是允许的,但必须有明确目的:
|
||||
- 运行时装配
|
||||
- 测试迁移过渡
|
||||
- 如果某个薄包装已经没有存在意义,应在后续重构中清掉
|
||||
- 涉及中文内容的文件必须保持稳定编码,修改后要主动检查是否出现乱码、错码、异常替换字符。
|
||||
|
||||
## 8. AI 开发时的自检清单
|
||||
|
||||
@@ -193,7 +203,8 @@ npm test
|
||||
4. 我有没有补或迁移测试?
|
||||
5. 我有没有更新三份根目录文档?
|
||||
6. 我新增或修改的文件是否有可见乱码?
|
||||
7. 如果改动影响 Gmail / 2925 别名邮箱逻辑,我有没有同步检查 `managed-alias-utils.js`、sidepanel 接线、background 调度、auto-run reset 和回归测试?
|
||||
7. 我有没有逐个检查本次改动涉及的中文文案、日志、注释、文档没有乱码?
|
||||
8. 如果改动影响 Gmail / 2925 别名邮箱逻辑,我有没有同步检查 `managed-alias-utils.js`、sidepanel 接线、background 调度、auto-run reset 和回归测试?
|
||||
|
||||
## 9. 完成标准
|
||||
|
||||
@@ -204,6 +215,7 @@ npm test
|
||||
- 全量测试通过
|
||||
- 三份根目录文档已同步
|
||||
- 没有可见乱码
|
||||
- 已对本次修改涉及的文件做过乱码审查
|
||||
|
||||
## 10. 特别要求
|
||||
|
||||
@@ -214,4 +226,11 @@ npm test
|
||||
- [项目完整链路说明.md](c:/Users/projectf/Downloads/codex注册扩展/项目完整链路说明.md)
|
||||
- [项目开发规范(AI协作).md](c:/Users/projectf/Downloads/codex注册扩展/项目开发规范(AI协作).md)
|
||||
|
||||
- 每次开发结束前,必须审查本次修改文件与关键运行文案没有乱码:
|
||||
- 文档正文
|
||||
- sidepanel 中文文案
|
||||
- 日志文案
|
||||
- 报错文案
|
||||
- 中文注释
|
||||
|
||||
这是硬要求,不是建议。
|
||||
|
||||
Reference in New Issue
Block a user