优化步骤在日志中的显示

This commit is contained in:
QLHazyCoder
2026-05-03 19:25:55 +08:00
parent 4410fea3d1
commit 691ac39514
25 changed files with 691 additions and 297 deletions
+9
View File
@@ -40,6 +40,14 @@
- 不允许只改 sidepanel 文案而不改共享定义。
- 不允许只改 registry 而不改共享定义。
### 1.4 日志步骤号原则
- 步骤相关日志必须通过结构化元数据传递步骤号:`addLog(message, level, { step, stepKey })` 或内容脚本 `log(message, level, { step, stepKey })`
- sidepanel 只能读取日志条目的 `entry.step` 渲染步骤标签,禁止再用正则从日志正文解析 `步骤 X` / `Step X`
- Plus 模式复用普通执行器时,必须先按当前运行态解析可见步骤号,再传给日志、完成信号、错误信号和内容脚本 payload;禁止在复用执行器里写死普通模式步骤号。
- 日志正文可以在业务说明里提到“回到步骤 X”这类操作目标,但不能把正文前缀当作当前日志所属步骤。
- 不做旧日志文本兼容;如果旧日志没有结构化 `step`,sidepanel 不需要补推断步骤标签。
## 2. 模块边界规则
### 2.1 可以继续增长的文件
@@ -245,6 +253,7 @@ npm test
6. 我新增或修改的文件是否有可见乱码?
7. 我有没有逐个检查本次改动涉及的中文文案、日志、注释、文档没有乱码?
8. 如果改动影响 Gmail / 2925 别名邮箱逻辑,我有没有同步检查 `managed-alias-utils.js`、sidepanel 接线、background 调度、auto-run reset 和回归测试?
9. 如果改动影响步骤日志,我有没有确认日志步骤号来自结构化 `step`,而不是来自日志正文?
## 9. 完成标准