🛠️ 工具 / 工作流¶
Edit / Python 切片 / Git / 版本流程
⚙️ 本文件由
pnpm docs:rebuild自动生成 — 修改无效。
涉及文档(29 个)¶
🎯 功能规格(4)¶
- 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 期推进
- 文档与功能同步治理升级 · in-progress
- 用产品文档试点、显式 Docs-Impact 声明和只读门禁降低功能与文档漂移
🔧 已知问题 + 修复(14)¶
- 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 工具盲区漏检
- 批量删 untracked 文件误删刚 Write 的新 ISSUE 文档 · fixed
- v0.10.112 写 ISSUE-0074 后跑 rm-untracked 脚本一并删掉了刚建未 git add 的 ISSUE 文件
- jsstore insertOne 空函数体 footgun(静默丢数据) · fixed
- 迁移自母产品的 insertOne 函数体为空,调用即静默返回 undefined
- auth/context/utils.ts JWT session 死代码(母模板残留) · fixed
- isValidToken/setSession/tokenExpired 全仓零引用,本扩展不走 JWT,已删整文件
- manifest host_permissions 域名拼写错误(lafaxin.com 少一个 i) · fixed
- wxt.config.ts 写成 lafaxin.com,被
掩盖;一旦收紧权限 API 全挂 - 词边界 \b 挡死屈折词尾与复合词 —— 上下文词表连翻三次 · fixed
- PHONE_KW/NEG_KW 用 \b 收尾,波兰语 Telefony、德语 Ust-IdNr 全部漏判
- package.json 加了依赖、lockfile 没跟上 —— HEAD 装不起来 · fixed
- 第一版只 path-scoped 提了 package.json,turndown 三条依赖在 lock 里 0 条
- 源码文本断言的假绿盲区 —— 两轮审查在同一个测试上各挖出一个 · fixed
- 固定字符窗口假红、锚点后 decoy 假绿、锚点前真调用假绿;改成整函数体 AST 断言
- 变异还原的 cp 备份把真改动一起抹了 —— 而三道门禁全绿 · fixed
- v0.10.181 声称改了两处 helper 实际没进提交,全量测试/tsc/verify/build 都没发现
📋 工作流规则(10)¶
- 元规则:按需建档机制
- 用户首次描述某工具用法/工作流时,AI 必须立即落档,杜绝重复描述
- 备份与开发日志
- 改代码前必做的备份 + 全程开发日志记录规范
- Cloudflare Pages 部署指引 · stable
- MkDocs site 发布到 Cloudflare Pages 的一次性配置 + 后续 push 自动部署
- 批量 rm untracked 文件 — 安全清单(防误删新建文档) · stable
- ISSUE-0079 复盘 — rm untracked 前必先 git add 新建文档 + dry-run 看清单
- Docs-Impact — 功能改动与文档同批同步 · stable
- src 或 WXT 配置进入提交时,声明同批更新的文档或具体无影响理由
- GitHub 推送规则 · stable
- 首次推送到 github + 日常同步策略 + 推哪些不推哪些
- 每版本沉淀检查表 — 何时必建 ISSUE / wiki / SPEC · stable
- 版本完成 commit 前的强制自查清单,防"小修不归档"积累成历史空白
- 版本发布流程
- 每次版本更新的标准动作 — 从「准备」到「发布」的完整流程
- 版本发布铁律 — 项目版本更新总规范 · stable
- 改设置页/调度逻辑/文案前必读;第七章 MV3 持久化陷阱 16 条铁律
- 中文标点 → Edit 工具兜底方案
- 含中文标点的旧 JSX/TS 改不动时,用 Python 切片替换
🗒️ 原始素材(1)¶
- v0.16.82→86 真机验收清单——六刀落地后需要 Tony 实测确认的项 · spec-ed
- L1 翻页游标/L2 派生分页/10k 窗口/尾页 clamp/L3 导出流式的真机验收清单(含口径与操作步骤);静态全绿但动态项未经 42w 真库验证
给 AI / 新协作者的建议阅读顺序¶
- 先读 specs(了解需求 / 设计决策)
- 遇到 bug 查 issues(避免重蹈覆辙)
- 追溯起源看 raw(用户原话)