🔧 设置 / 配置¶
settings 字段语义 / UI 配置 / 数据过滤 / 自定义规则
⚙️ 本文件由
pnpm docs:rebuild自动生成 — 修改无效。
涉及文档(44 个)¶
🧭 产品使用文档(2)¶
- AI 辅助(设置 → AI) · stable
- 配置 AI 账号、勾选模型、给每个提示词选模型,以及分类推演怎么用
- 数据外发清单 · stable
- 扩展会把哪些数据发往哪些服务器,以及每一项的用途与开关
📐 架构 / 知识沉淀(3)¶
- 正则演示组件(RegexTester)
- 让用户即改即看的正则测试折叠组件,避免抽象正则改完不知道效果
- 设置字段语义对照
- settings 全部字段的实际语义、对应源码、易混淆点 — 改 UI 前必查
- 共享队列架构
- v0.10.0 后的核心调度模型 — 多任务共用一个调度器、Tab/worker 是全局资源
🎯 功能规格(7)¶
- Watchdog 核弹重启后自动恢复(带上限保护) · done
- 核弹重启后默认自动 pumpTasks,避免无人值守场景必须手动点开始;加 cycle 上限防止无限循环
- SPEC-005 — React 前端 lifecycle 系统性扫描 + 修复 · parked
- 334 处 useEffect/setState 全量审 — 找裸异步、unmount race、setState-on-unmounted;分 3 期推进
- 文档与功能同步治理升级 · in-progress
- 用产品文档试点、显式 Docs-Impact 声明和只读门禁降低功能与文档漂移
- 云端同步身份模型与契约实现差距 · draft
- 两套并存云端通道、契约与实现的差距清单、身份绑定移交开发说明
- 设置页重排 —— 按「用户来这里要干什么」排,不按字段属于哪个模块排 · done
- 七个结构性问题的诊断 + 三方案对比 + 分阶段落地;阶段一(安全网+四处搬迁)已完成
- 设置导入导出 —— 换机器还原配置 · done
- 导出不脱敏(与日志导出相反)、导入只认已知键+类型、覆盖前必须确认
- SPEC-024 照这个再建一个 —— 任务跑完之后的补充采集 · done
- 三审后改为在详情页按「组合」勾选再建任务;原「创建界面预填+按词标记」方案被推翻
🔧 已知问题 + 修复(21)¶
- 长时间运行后浏览器卡死 / 累积孤儿 Tab · fixed
- 插件运行时间长,会导致电脑卡死,页面没正常关闭,是不是要加上定期的检查?确保浏览器正常关闭,而不是打开一堆?
- 设置字段命名望文生义,与实际语义矛盾 · fixed
- 设置字段名暗示与实际语义矛盾,反复出现(已写成铁律)
- 设置页右侧出现两个滚动条 · fixed
- 设置的右侧两个滑动的??
- FormProvider 强制 flex column 对 Dialog 表单的潜在副作用 · fixed
- FormProvider 强制 flex column 对 Dialog 表单的潜在副作用(观察)
- 设置页双滚动条 — v0.10.18 修不彻底(二次修复) · fixed
- 修复截图右侧两个滚动条的问题
- 第三轮 agent 找到 3 真 bug — watchdog 镜像 / 死 listener / 正则漂移 · fixed
- 第三轮独立 agent 验证收敛失败,3 个真问题
- 质量分可配置 — 3 预设 + 5 维度权重 + 阈值 + 等级门槛 · fixed
- 用户问"质量分如何计算?能设置吗" — 加 Settings UI(默认/邮件营销/电销/高端市场 4 预设 + 完全自定义)
- 勾选「跳过无邮箱商家」导致地图抓取 100% 不入库 · fixed
- 过滤器判断了尚未产生的 emails 字段,条件恒真,整批数据静默丢弃
- 设置页四处误导性文案 —— 用户照着做会删掉自己要的数据 · fixed
- 校验话术望文生义、过滤门槛没说无值也删、加分与过滤同名、预设静默改深度
- maxConcurrentTasks 四处兜底两个值 —— 调度器与批控制器对并发上限理解差一倍 · fixed
- 设置读不到时 task-manager 兜底 1、batch-controller 兜底 2,同一时刻两套认知
- 全新用户首屏被告知「自定义配置」—— 默认值与推荐档差一个字段 · fixed
- DefaultSettings 与 balanced 预设 12 个字段差 1 个,matchPreset 要求全等故判 custom
- 一道安全校验锁死了整张设置表单 —— 判据放错了层 · fixed
- https 校验写进 yup,存量 http 地址让用户任何设置都保存不了;连带 catch 兜底与留痕两处
- 变异还原的 cp 备份把真改动一起抹了 —— 而三道门禁全绿 · fixed
- v0.10.181 声称改了两处 helper 实际没进提交,全量测试/tsc/verify/build 都没发现
- 断言体检 —— 三种绕过让一批断言在功能已坏时全绿 · fixed
- 块注释藏关键词 / 只留 import 不调用 / 括号绕过字面量正则;codeOnly 四份拷贝收归一处
- 重排把响应快照变成死控件 + codeOnly 的同族绕过(两路对抗审) · fixed
- 快照只由多阶段 pipeline 写,默认多阶段关;搬家拆掉同屏因果后开关永远不记录任何东西
- 云端 API 地址框把 Bearer 凭据发往用户填的任意 https 域名 · fixed
- https 判据挡得住 http、挡不住 https://任意域名;Tony 实测填 test.com token 照发
- 模型行只判 testOk 两态——「已失效」被显示成绿勾 · fixed
- modelHealth 写了四态且「stale 压过 testOk」,而模型行没用它;账号行四态、模型行两态,同一语义两套实现
- 去 AI 味第二刀:字号档位失控与色彩语义降级 · fixed
- 统计条六档字号同屏、任务格孤紫、结束按钮黄字语义降级 —— 视觉预算失守的集中清理
- 剪贴板写入吞错家族第三例 — task-filter-picker 复制任务 ID 静默失败 · fixed
- navigator.clipboard.writeText(id) 不 await、catch 空吞——ISSUE-0042 Y3 家族复发,闸字面锚定查不出等价形态
- 设置页 tab CJK 逐字断行错位 — 收缩无防护 + 无 nowrap · fixed
- AI 配置同步挱云端 tab + 开关形态重做 — 命名撞车与隐身开关 · fixed
📋 工作流规则(8)¶
- 元规则:按需建档机制
- 用户首次描述某工具用法/工作流时,AI 必须立即落档,杜绝重复描述
- 备份与开发日志
- 改代码前必做的备份 + 全程开发日志记录规范
- 文档目录规范 — 什么在根 / 什么在 docs/ · stable
- repo 根目录与 docs/ 分层规则;区分产品使用文档和五层研发知识漏斗
- Docs-Impact — 功能改动与文档同批同步 · stable
- src 或 WXT 配置进入提交时,声明同批更新的文档或具体无影响理由
- 每版本沉淀检查表 — 何时必建 ISSUE / wiki / SPEC · stable
- 版本完成 commit 前的强制自查清单,防"小修不归档"积累成历史空白
- 改设置项 / UI 文案 — 前置自查
- 改 settings 字段或调度相关 label/helper 前的必做检查
- 版本发布流程
- 每次版本更新的标准动作 — 从「准备」到「发布」的完整流程
- 中文标点 → Edit 工具兜底方案
- 含中文标点的旧 JSX/TS 改不动时,用 Python 切片替换
🗒️ 原始素材(3)¶
- 系统性盲区 — 前端 React lifecycle 一直没人查 · spec-ed
- 本会话 14 个 issue 0 个针对 useEffect cleanup / unmount race / setState-on-unmounted
- AI 配置「自动同步到云端」归属与形态质疑 · unprocessed
- Tony 三点反馈——同步云端应放云端设置 tab?(对抗分析)好丑;开启开关不明显
- 设置页 tab 错位到第二行(文字断行) · spec-ed
- Tony 截图报障——设置页三个 tab 在宽度不足/放大比例下文字逐字断行错位成两行高
给 AI / 新协作者的建议阅读顺序¶
- 先看 product(核对当前用户路径和限制)
- 再读 wiki(了解架构)
- 再读 specs(了解需求 / 设计决策)
- 遇到 bug 查 issues(避免重蹈覆辙)
- 追溯起源看 raw(用户原话)