🛠️ 工具 / 工作流

Edit / Python 切片 / Git / 版本流程

⚙️ 本文件由 pnpm docs:rebuild 自动生成 — 修改无效。

涉及文档（18 个）

🎯 功能规格（3）

• SPEC-000 — v2 UI 改版说明（v0.8.58 → v0.9.x → v0.10.x） · done
• 早期整体界面改版历史档案；dist/ 与 dist-v2/ 双轨阶段进度记录
• 文档治理自动化（docs:check + docs:rebuild + _overview） · done
• 用脚本 enforcement 解决"INDEX 脱节 / 断链 / 重复信息"持续累积的问题
• SPEC-005 — React 前端 lifecycle 系统性扫描 + 修复 · parked
• 334 处 useEffect/setState 全量审 — 找裸异步、unmount race、setState-on-unmounted；分 3 期推进

🔧 已知问题 + 修复（6）

• Edit 工具改含中文标点的旧代码反复失败 · fixed
• cat > /tmp/new.txt << 'EOF
• watchdog 自动恢复 cooldown 用 setTimeout（SW kill 时丢失） · fixed
• v0.10.23/24 的自动恢复 cooldown setTimeout 在 SW kill 时丢，与 ISSUE-0026 同款
• doResumeFromInterception 只调 manageQueue 漏地图调度 · fixed
• 拦截恢复后地图任务不重新派 tab，纯地图任务自动恢复无效
• use-countdown 双 useEffect + module-let interval 反模式 · fixed
• setInterval 与 cleanup 分两个 useEffect 通过 let 变量传递，StrictMode 不安全
• scan:protocol 基础设施 + open-results lost message + 死 messager 删 · fixed
• 实施 agent 提议的 Tool 2（dead listener 检测器），扫到真 lost + 整个 messager-extension 死代码
• 第四轮 agent 找到 ISSUE-0031 第 4 兄弟 + 2 个孤儿 listener · fixed
• 同函数内 3/4 分支补了 pumpAllSchedulers 漏第 4 个 catch 兜底；2 个 dead listener 工具盲区漏检

📋 工作流规则（8）

• 元规则：按需建档机制
• 用户首次描述某工具用法/工作流时，AI 必须立即落档，杜绝重复描述
• 备份与开发日志
• 改代码前必做的备份 + 全程开发日志记录规范
• Cloudflare Pages 部署指引 · stable
• MkDocs site 发布到 Cloudflare Pages 的一次性配置 + 后续 push 自动部署
• GitHub 推送规则 · stable
• 首次推送到 github + 日常同步策略 + 推哪些不推哪些
• 每版本沉淀检查表 — 何时必建 ISSUE / wiki / SPEC · stable
• 版本完成 commit 前的强制自查清单，防"小修不归档"积累成历史空白
• 版本发布流程
• 每次版本更新的标准动作 — 从「准备」到「发布」的完整流程
• 版本发布铁律 — 项目版本更新总规范 · stable
• 改设置页/调度逻辑/文案前必读；第七章 MV3 持久化陷阱 16 条铁律
• 中文标点 → Edit 工具兜底方案
• 含中文标点的旧 JSX/TS 改不动时，用 Python 切片替换

给 AI / 新协作者的建议阅读顺序

1. 再读 specs（了解需求 / 设计决策）
2. 遇到 bug 查 issues（避免重蹈覆辙）