Repository navigation
Expand file tree
/
Copy pathrule.json
More file actions
44 lines (44 loc) · 74 KB
/
Copy pathrule.json
File metadata and controls
44 lines (44 loc) · 74 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
{
"rules": [
{
"path": "**/*.proto",
"rule": "#### Protobuf 审查规则(wire 兼容优先)\n\n> 精准优先于召回:只报告你确信是真缺陷的问题,上下文不清晰时保持沉默,误报比漏报更损害信任。安全与正确性问题为阻塞级,风格建议为非阻塞。\n> **比对基准必须是旧版 .proto**(可用 `git show <base>:<proto路径>` 获取基准),只看新版无法判定破坏性变更;无基准时先索取,不下兼容性结论。\n\n#### 字段编号与 wire 兼容(GO-RPC-001~003)\n- 已发布字段的编号(tag)一经上线即永久契约:禁止改号、禁止将已删除字段的编号分配给新字段、禁止使用 19000~19999 保留段编号。注意:只调整字段声明顺序但连带改了编号同样违规\n- 删除或重命名字段必须同时 `reserved <编号>;` 与 `reserved \"字段名\";` 双占位,只占其一不完整。优先建议 `[deprecated = true]` 过渡而非物理删除\n- 已发布字段禁止 wire 不兼容类型变更:数值型 ↔ string/bytes 互改、singular ↔ repeated 互改、int32 → uint32/sint32(负数语义不兼容)\n- int32 ↔ int64 等取值范围安全的 varint 家族内部互转属兼容变更,勿误报\n- 类型变更的正确演进姿势:新增新字段 + 旧字段标 deprecated + reserved,而非原地改类型\n\n#### enum 契约(GO-RPC-004)\n- 已有 enum 值禁止删除或修改整数值;新增值禁止复用已有整数、禁止插入到已有数值区间的中间\n- proto3 首值必须为 0 值 `XXX_UNSPECIFIED`;调用方需对未知 enum 值有兜底(落 UNSPECIFIED 分支),否则新增 enum 值也会让旧调用方出错\n- 在末尾追加新编号的 enum 值属兼容变更,勿报\n\n#### service 与包契约(GO-RPC-005/006)\n- RPC method 名 + request/response 类型构成调用契约:禁止删除、重命名、整体替换消息类型、unary ↔ stream 互改(旧调用方直接 method not found)。协议升级正确姿势:新增 `XxxV2` method,旧 method 标 deprecated 保留兼容窗口\n- `package`、service 名、`option go_package` 变更会连锁打断路由与所有下游编译,禁止随意变更;确需重构走灰度双跑 + 调用方迁移完成后再下线\n\n#### 生成代码一致性\n- 同 PR 中 `.proto` 与 `*.pb.go` 必须同步变更;`*.pb.go` 出现手改痕迹(绕过生成器的逻辑修改)= 违规\n\n#### 明确不报\n- 纯新增字段(使用全新编号)、末尾追加 enum 值、注释与文档变更、声明处的拼写修正\n\n#### Fowler 代码坏味道基线(跨语言通用,编译时追加到每个语言规则)\n\n> 与上文各语言专项规则并列生效。两条总则约束本节:\n> 1. **仓库已文档化的规范覆盖基线**——仓库标准明确认可某写法时(如团队规范要求的转发层),即使基线会标记该 smell,也抑制不报。\n> 2. **一律是判断题(judgement call),不是硬违规**——每条 smell 标注为「可能存在 XX 味道」,不下硬结论;与上文 Correctity/安全类规则的 🔴 硬分级不同,本节发现默认 🟢~🟡 级。\n> 工具链(gofmt/golint/php-cs/vue-tsc 等)已能可靠判定的问题不在此重复报告。每条按「是什么 → 怎么修」对照 diff。\n\n- **Mysterious Name(神秘命名)**:函数、变量或类型的名字没揭示它做什么/装什么 → 重命名;起不出诚实名字,说明设计本身混浊,转设计问题。\n- **Duplicated Code(重复代码)**:同一逻辑形状出现在本次变更的多个 hunk 或文件 → 提取共享形状,两处调用。\n- **Feature Envy(依恋别人家)**:方法访问别的对象的数据比自己的还多 → 把方法移到它依恋的数据上。\n- **Data Clumps(数据泥团)**:同样几个字段/参数总是结伴出现(一个类型想出生了)→ 捆成一个类型传递。\n- **Primitive Obsession(基本类型偏执)**:用原始类型/字符串顶替应有自己类型的领域概念(金额用 float、状态用裸 int)→ 给概念建小类型(如 `type OrderStatus int` + 常量集 / Money 结构)。\n- **Repeated Switches(重复分支)**:对同一类型的相同 switch/if 级联在本次变更中反复出现 → 用多态或两处共享的一张映射表替代。\n- **Shotgun Surgery(霰弹式修改)**:一个逻辑变更迫使 diff 在许多文件里零散落点 → 把一起变的东西聚到一个模块。\n- **Divergent Change(发散式变化)**:一个文件/模块因多个互不相关的原因被改 → 拆分使每个模块只因一个原因变。\n- **Speculative Generality(投机泛化)**:为 spec 没有的需求加的抽象、参数、钩子 → 删掉,内联回去直到真实需求出现。\n- **Message Chains(消息链)**:调用方依赖 `a.b().c().d()` 长链导航 → 在第一个对象上用一个方法把这段路藏起来。\n- **Middle Man(中间人)**:一个类/函数基本只做转发 → 砍掉,让调用方直接找真目标。\n- **Refused Bequest(拒绝继承)**:子类/实现者忽略或覆写了继承来的大部分内容 → 放弃继承改用组合。"
},
{
"path": "**/*.go",
"rule": "#### Go 审查规则(go-zero 项目)\n\n> 精准优先于召回:只报告你确信是真缺陷的问题(含可达上下文),上下文不清晰时保持沉默。正确性与安全为阻塞级,风格建议为非阻塞。做非局部判断前先用 file_read / code_search 确认调用点、所有权、同步与输入边界;不要仅凭函数名或 import 推断并发调用、攻击者控制或错误契约。\n> 不重复报告 go vet、Staticcheck、gofmt、编译器已能可靠判定的问题,除非 diff 展现了这些工具无法表达的实际后果。\n\n#### RPC 接口防御(线上 panic 最高频根因,GO-RPC-007/008)\n- go-zero logic 层禁止假设对端一定传字段:`in.Operator.Id` 直接解引用嵌套指针、`in.OrderIds[0]` 不判 len、oneof 不判激活分支就强转 → nil panic。正确写法:getter 链 `in.GetOperator().GetId()`(nil 安全返回零值)、`len(in.GetOrderIds())` 先判空\n- 新增 request 字段必须保持可选语义(零值默认/降级),logic 层对**本次新增**字段做 `if req.NewField == \"\" { return err }` 强校验 = 破坏向下兼容;存量字段的必填校验不受此限。response 新增字段靠 protobuf 前向兼容自动忽略,无需处理\n- `*.pb.go` 生成代码出现手改痕迹、或与 `.proto` 未同 PR 同步 = 违规;proto 定义变更的兼容性判定(字段编号/reserved/enum)见 proto 专项规则\n- 变更发布顺序:先扩展后收缩、服务端先于调用方;一次 PR 混合新增+删除应建议拆分(Suggestion)\n\n#### 并发安全(团队历史事故规则,最高优先级)\n- **共享对象方法内禁止写入接收者字段**(GO-CONC-008):快速判定链——指针接收者 → 方法内 `c.xxx = ...` → 对象被 ServiceContext/全局变量/sync.Once 持有 → 无 Mutex 保护 → 🔴 Critical(并发请求互相覆写)。per-request `NewXxx()` 创建的对象各 goroutine 独立,不报\n- **禁止修改带 `validate:\"required\"` 的结构体指针入参字段**(GO-CORE-015):框架可能将同一请求对象分发给多 goroutine → data race → panic。正确姿势:`channelTag := in.ChannelTag` 局部变量承接后只操作局部变量;确需修改必须加锁或构造新结构体\n- 全局 map 无锁并发写 = `fatal error: concurrent map writes`(不可 recover 的 crash):包级 map 在 handler 路径写 → 用 sync.RWMutex 包裹或 sync.Map;多 goroutine 并发 append 同一 slice 同理\n- Mutex 必须 `mu.Lock(); defer mu.Unlock()`;含 Mutex 的结构体必须指针接收器(值接收器拷贝 Mutex = 锁失效);读多写少用 RWMutex\n- `wg.Add` 必须在 goroutine 启动前调用;goroutine 必须有退出机制(`select { case <-ctx.Done(): return }`);发送方负责关闭 channel\n- 锁定并发/死锁结论前必须有状态可被并发触达的证据;不报不可变数据、per-goroutine 局部变量、所有权保证同步的场景\n\n#### Context 与错误(团队规范)\n- ctx 必须第一参数、命名 `ctx`、禁止嵌入结构体;中间层禁止用 `context.Background()` 顶替上游 ctx 切断取消链(仅入口函数可用)\n- 外部调用(HTTP/RPC/DB)必须 ctx 超时防雪崩:`context.WithTimeout` + `defer cancel()` 成对出现\n- 错误码必须用团队错误码包(`xerr.NewErrCodeMsg(consts.Xxx, msg)` 形态)+ 常量,禁止硬编码错误码\n- 错误被忽略/覆盖/转为成功默认值隐藏失败操作;`fmt.Errorf` 丢失原始因(需 `errors.Is/As` 的场景应 `%w`);defer 清理覆盖主错误\n- 长生命周期 goroutine 必须 defer-recover;HTTP handler 挂框架 Recovery 中间件\n- `panic`/`log.Fatal`/`os.Exit` 出现在请求、worker、库或清理路径(可返回错误时)\n\n#### 安全边界(报告前确认攻击者控制或信任边界,给出具体利用路径与修复)\n- SQL 禁止字符串拼接:`fmt.Sprintf(\"... WHERE x='%s'\", userInput)` → 用 `?` 占位符或团队 ORM `model.Where{}` map 传参;动态表名/列名需白名单\n- 生产代码禁止 `tls.Config{InsecureSkipVerify: true}` 与直接返回 nil 的自定义证书校验\n- `os/exec` 禁止 `sh -c` + 用户输入拼接:`exec.Command(\"sh\", \"-c\", fmt.Sprintf(\"convert %s\", userFile))` → 改为参数列表 `exec.Command(\"convert\", filepath.Base(userFile))` 并校验\n- 外部提供的 URL 必须白名单校验 + 禁私网段(SSRF:`169.254.169.254` 云元数据窃取;判定 `ip.IsPrivate() || ip.IsLoopback()`);强制 HTTPS,禁硬编码 IP\n- 禁止硬编码密钥/token/密码;手机号等敏感信息日志与展示必须脱敏(`phone[:3]+\"******\"+phone[9:]`);密钥走环境变量/配置中心\n- 路径穿越、不可信输入拼 SQL/shell/URL/路径/模板、math/rand 用于安全用途(token/nonce/盐)→ 均需确认可达性后报告\n\n#### 逻辑漏洞模式(跨语言团队专项,模拟攻击者视角)\n- 水平越权:接口只验登录不验资源归属(`order.UserID == userID` 缺失);垂直越权:普通用户可达管理操作\n- 金额篡改:金额以客户端提交为准,未按商品价×数量服务端重算;负数金额未校验(`amount <= 0`)导致资金逆流;金额计算禁用 float,用整数「分」\n- 幂等缺失:支付/写操作可重复提交(网络重试属正常路径,必须幂等键或状态前置校验,非仅报错)\n- 状态机绕过:状态可任意跳转(如 completed → pending 逆向回退),需对照业务状态机定义判合法性\n- 时序竞争:先查再改非原子(`FindOne` 判库存再 `Update` → 超卖),应用 `UPDATE ... WHERE stock >= ?` 原子操作或锁\n\n#### 性能(报告前确认数据规模或热路径证据)\n- N+1 查询:循环内逐条查库/逐个 RPC/HTTP 调用 → 收集 ID 批量 `FindMany`/批量接口 + map 组装。团队基线:100 次循环调用 = Critical\n- 无上限并发:循环内 `go fn()` 无 worker pool 限制 → OOM 风险,限并发数(如 100)\n- goroutine/timer/资源泄漏:缺 `ctx.Done()` 退出分支;`http.Response.Body`/`sql.Rows`/文件未在所有可达路径关闭;循环内 defer 延迟释放\n- 串行可并行:无依赖的多个外部调用顺序 await → 并发执行(响应时间从累加变为取最大值)\n- 大事务:事务内含网络请求(发邮件/RPC)→ 移到事务外;`rows.Err()` 循环后遗漏\n\n#### 数值与集合边界\n- 整数转换/收窄/符号比较/大小计算可溢出、截断、回绕,或负数输入变超大 size(注意架构相关的 int 宽度)\n- 空输入/边界输入下越界的索引、切片、长度运算;`sql.Rows` 迭代提前停止未 Close\n- 返回/缓存共享底层存储的 slice/map/buffer,后续被复用方改写导致另一持有方数据被污染(确认所有权后再报)\n\n#### 团队命名与结构约定(Warning 级)\n- 请求/响应结构体用 `{Action}Req`/`{Action}Resp` 后缀(非 Request/Response 全称);ID 全大写;常量驼峰;bool 带 is/has/can 前缀\n- 包名/文件名全小写下划线(团队内部库 import 前缀依赖此约定,按你的团队替换)\n- 控制流嵌套 ≤ 3 层(卫语句/函数拆分);废弃代码必须 `@deprecated` + 替代方案 + 下线时间,无保留价值直接删\n\n#### 明确不报\n- go vet / staticcheck / gofmt / 编译器覆盖的问题(nil slice vs `[]string{}`、crypto/rand 选型、comma-ok 断言等)\n- 框架/调用方持有关闭责任的资源、有文档的 best-effort 忽略错误、不可变值对象拷贝、Go 1.23+ 未 Stop 的 timer(GC 可回收)\n- 测试文件(OCR 默认过滤)除非用户显式包含;仅为格式、import 顺序、命名偏好的非阻塞建议\n\n#### Fowler 代码坏味道基线(跨语言通用,编译时追加到每个语言规则)\n\n> 与上文各语言专项规则并列生效。两条总则约束本节:\n> 1. **仓库已文档化的规范覆盖基线**——仓库标准明确认可某写法时(如团队规范要求的转发层),即使基线会标记该 smell,也抑制不报。\n> 2. **一律是判断题(judgement call),不是硬违规**——每条 smell 标注为「可能存在 XX 味道」,不下硬结论;与上文 Correctity/安全类规则的 🔴 硬分级不同,本节发现默认 🟢~🟡 级。\n> 工具链(gofmt/golint/php-cs/vue-tsc 等)已能可靠判定的问题不在此重复报告。每条按「是什么 → 怎么修」对照 diff。\n\n- **Mysterious Name(神秘命名)**:函数、变量或类型的名字没揭示它做什么/装什么 → 重命名;起不出诚实名字,说明设计本身混浊,转设计问题。\n- **Duplicated Code(重复代码)**:同一逻辑形状出现在本次变更的多个 hunk 或文件 → 提取共享形状,两处调用。\n- **Feature Envy(依恋别人家)**:方法访问别的对象的数据比自己的还多 → 把方法移到它依恋的数据上。\n- **Data Clumps(数据泥团)**:同样几个字段/参数总是结伴出现(一个类型想出生了)→ 捆成一个类型传递。\n- **Primitive Obsession(基本类型偏执)**:用原始类型/字符串顶替应有自己类型的领域概念(金额用 float、状态用裸 int)→ 给概念建小类型(如 `type OrderStatus int` + 常量集 / Money 结构)。\n- **Repeated Switches(重复分支)**:对同一类型的相同 switch/if 级联在本次变更中反复出现 → 用多态或两处共享的一张映射表替代。\n- **Shotgun Surgery(霰弹式修改)**:一个逻辑变更迫使 diff 在许多文件里零散落点 → 把一起变的东西聚到一个模块。\n- **Divergent Change(发散式变化)**:一个文件/模块因多个互不相关的原因被改 → 拆分使每个模块只因一个原因变。\n- **Speculative Generality(投机泛化)**:为 spec 没有的需求加的抽象、参数、钩子 → 删掉,内联回去直到真实需求出现。\n- **Message Chains(消息链)**:调用方依赖 `a.b().c().d()` 长链导航 → 在第一个对象上用一个方法把这段路藏起来。\n- **Middle Man(中间人)**:一个类/函数基本只做转发 → 砍掉,让调用方直接找真目标。\n- **Refused Bequest(拒绝继承)**:子类/实现者忽略或覆写了继承来的大部分内容 → 放弃继承改用组合。"
},
{
"path": "**/*.php",
"rule": "#### PHP 审查规则(Yaf 类 MVC / 团队框架项目)\n\n> 精准优先于召回:只报告你确信是真缺陷的问题,上下文不清晰时保持沉默。正确性与安全为阻塞级,风格建议为非阻塞。做非局部判断前先用 file_read / code_search 验证调用方、输入来源、框架配置与资源所有权。\n> **审查前置**:① PHP 版本以项目根 `php_version` 文件为准(无则查 composer.json 的 require.php),代码出现高于该版本的语法特性 = Critical;② 项目入口文件包含框架 SDK 初始化(如 `require_once` 框架 init 文件)即为框架项目,启用「框架 API 形态」检查(路径按你的项目调整);③ Model 层事务落点不作违规项(团队口径:只关注并发一致性结果,不约束事务层级)。\n\n#### Queue 一致性专项(团队队列库约定,历史事故规则;触发路径:`application/library/QueueTopic.php`、`conf/*Queue.php`、`service/Queue/Worker/**`、`service/Queue/Worker.php`、`service/Queue/Client.php`——按你的项目调整)\n- **QUEUE-CASE-001 Topic→Worker 类名推导闭环**:固定推导算法 `$_worker = strtr(str_replace('_', '', ucwords($topic, ':_')), ':', '\\\\');` 再拼前缀 `\\Service\\Queue\\Worker\\{$_worker}`,推导结果必须与实际类名、命名空间逐字一致。例:topic `order:payment_timeout` → 期望类 `Order\\PaymentTimeout`;实际类为 `PaymentTimeOut` 则 Critical\n- **QUEUE-CASE-002 Worker 文件名大小写敏感比对**:由推导类名计算期望路径与实际文件名做大小写敏感比对。macOS 开发环境大小写不敏感\"看起来正常\",Linux 上 `class_exists` 失败、Worker 无法消费——不能因本地能跑而放行\n- **QUEUE-CASE-003 三段链路闭环**:QueueTopic 常量定义 → `conf/*Queue.php` TOPICS 注册 → Worker 文件。topic 只需在**任一** `*Queue.php` 注册即可(存在 Queue.php/OrderQueue.php/DeliveryQueue.php 多文件),勿误报\"未在所有配置文件注册\"。topic 定义但未注册 TOPICS → 消息进 Redis 永不消费(等同丢失);action 未声明在 topic 配置的 `actions` 数组 → Worker 无法匹配\n- **QUEUE-CASE-005 TYPE_DELAY 与 $ttl 一致性**:扫描 `\\Service\\Queue\\Client::instance()->add($topic, $action, $data, $ttl)`——`$ttl > 0` 时该 topic 在 conf 中 `type` **必须**为 `Queue::TYPE_DELAY`。混合调用(同一 topic 任一调用传 `$ttl > 0`)按最严格判定;`$ttl` 为变量时默认按 `> 0` 处理。判定矩阵:有值 + TYPE_REAL = 🔴 Critical(延迟消息不被消费、队列积压),其余组合不报\n- **PHP-CORE-016 常量约定**:QueueTopic 常量名 UPPER_SNAKE ↔ 值 `module:topic_name` 一一对应;调用必须用常量而非字符串字面量(`'order:paymnet'` 拼写错误无法静态发现);新增 topic/action 常量后必须同步 conf 注册\n- **Client::instance() module 传参一致性**(真实事故复盘沉淀):Worker 重试/投递路径的 `Client::instance()` 必须显式传 module(`Client::instance(self::$_module)`);无参调用会落到硬编码默认 module,多模块部署时消息投错队列。发现无参 `Client::instance()` 且上下文存在多 module 判定(`self::$_module`/`$_module` 字段)→ Critical\n- **跨仓同步(多仓部署同一队列库时)**:Queue 关键文件(`service/Queue/Client.php`、`Worker.php`、`Worker/**`、`conf/*Queue.php`、`QueueTopic.php`)必须与对照仓同路径比对;两侧 Topic/Action 常量、TOPICS 注册、Worker 类名/文件名大小写三者一致,单边遗漏即 Critical(历史事故:两侧未同步致数万条队列消息未执行数小时)\n\n#### 单例与静态绑定(常驻内存污染专项)\n- **PHP-CORE-017 静态绑定**:可继承类静态上下文默认 `static::`(LSB)——单例 `getInstance()` 用 `new self()` → 子类拿到父类实例,正解 `self::$instances[static::class] = new static()`;工厂方法同理用 `new static()`。注意:`static::$prop` 不会自动隔离存储,子类必须**重声明**静态属性才真正隔离;固定父类常量刻意用 `self::` 属设计意图(要求注释说明),勿误报\n- **PHP-CORE-018 单例属性覆写**:判定链——单例类(`instance()`/`getInstance()`)→ 方法内 `$this->_xxx = ...` 写入请求级临时数据(非全局配置)→ 🔴。PHP-FPM 下同请求多次调用后写覆盖前写 = Warning;Swoole/常驻内存下跨协程并发覆写 = Critical。正解:方法返回值/局部变量传递,或改 per-request 对象。典型事故:单例 PriceModel 中 `_genPriceId()` 写 `$this->_priceId`,同请求两次询价后者覆盖前者\n\n#### 框架 API 形态(框架项目,API 名按你的框架调整)\n- 参数获取用框架请求对象(如 `$this->request->getInt('user_id', 0)`)而非裸 `$_GET`/`$_POST`(Critical)\n- 响应用框架响应对象(如 `$this->response->json()`)而非裸 `echo` + `die`;依赖框架自动加载而非手动 `require_once`\n- 异常须注册框架异常处理器(Critical);鉴权/限流走中间件而非入口重复判断\n\n#### 循环变量与引用(团队约定)\n- PHP 无块级作用域:循环体值变量与临时变量用 `_` 前缀(`$_item`),嵌套循环层级命名(`$_order`/`$_orderItem`);`for` 计数器 `$i/$j/$k` 不需要前缀但禁止用业务名。典型事故:`foreach ($coupons as $discount)` 覆盖全局 `$discount`,循环后金额计算类型错乱\n- `foreach ($items as &$_item)` 引用遍历结束后必须 `unset($_item)`;`array_walk` 引用回调改用 `array_map` 返回新数组;大数组禁止 `$_record['snapshot'] = $records` 式整体自引用(OOM),用 `array_chunk($records, 1000)` 分批\n- PHP 对象默认按 handle 传递、改属性天然影响调用方,这与 `&` 引用是两回事——不要把\"对象属性修改\"误报为引用违规;不想影响调用方应 `clone`\n\n#### SaaS 接入专项(SaaS 链路代码)\n- **PHP-SEC-010 TLS 双开关**:请求 SaaS HTTPS 链路需忽略非可信证书时,`CURLOPT_SSL_VERIFYPEER` 与 `CURLOPT_SSL_VERIFYHOST` 必须**同时**在 curl 初始化阶段设置且受环境开关约束(`getenv('SAAS_IGNORE_SSL_VERIFY')` 类配置)。只设其一仍会握手失败(历史事故:服务无法请求 SaaS 接口、链路不可用);反向要求——无开关无条件忽略 SSL 同样违规\n- **PHP-SAAS-002 灰度门禁**:新增入口(方法/路由/回调/分支)必须验证灰度匹配 key 能覆盖、新逻辑未绕过灰度 gate、灰度/非灰度两条路径均符合预期。新增方法没接灰度匹配规则 → 非灰度环境意外执行新逻辑\n\n#### 类型与语义(通用要点,确认可达后报告)\n- 松散比较 `==` 使安全/业务敏感的不同值相等(`0 == \"abc\"`);`isset()` 无法区分键存在但值为 null(需 `array_key_exists`);`empty()` 把 `0`/`\"0\"` 与空混同\n- 数组键读取未处理可达的缺键路径(请求数据/JSON 解码/数据库行/可选配置);数组 union `+` 与 `array_merge` 的覆盖与重排序语义误用\n- `Throwable` 被捕获后静默丢弃/转为成功/替换为误导性默认值;宽泛 catch 包住无关操作无法区分预期失败与程序缺陷;`@` 抑制符把有意义的失败变成非法状态\n- 事务:多步写缺原子边界、早退/异常路径遗留未提交事务;cURL/流操作缺超时(可停顿远程端点);长生命周期进程(队列消费者/定时任务)资源未释放、内存增量 > 50MB 记 warning\n\n#### 逻辑漏洞模式(跨语言团队专项,模拟攻击者视角)\n- 水平越权(只验登录不验资源归属)/垂直越权(普通用户可达管理操作);金额篡改(以客户端提交为准,未服务端重算);负数金额(`amount <= 0` 缺校验,注意退款场景取负是合法的);幂等缺失(支付可重复提交);状态机绕过(逆向跳转);时序竞争(先查库存再改,两请求同时通过判断 → 超卖,应用原子 UPDATE 或锁)\n- 金额计算禁用 float(`0.1+0.2` 精度问题),整数「分」为单位;除零未判 `total == 0`;优惠券叠加后 `finalAmount < 0` 未截断;批量操作无数量上限(应 ≤100)\n\n#### 安全边界(报告前确认攻击者控制与输出/执行上下文)\n- SQL 拼接未参数绑定(列名/排序方向需白名单);模板输出未按上下文转义(HTML/属性/URL/JS/CSS);CSRF:cookie 认证下状态变更请求缺 token(token 认证 API 不报);文件上传信客户端文件名/扩展名/MIME\n- `eval`/动态 include/变量函数/反射/shell 拼接可达不可信输入无严格白名单;`unserialize()` 不可信数据(`allowed_classes` 不等于可信);外发 URL 未限 scheme/host/私网(SSRF)\n- 弱随机与密码:token 用 `random_bytes`、密码用 `password_hash`/`password_verify`/`hash_equals`;敏感信息(token/密码/手机号/身份证)入日志、入错误响应、明文展示 = 违规(手机号 `138****1234` 掩码)\n\n#### 性能(报告前确认数据规模或热路径证据)\n- N+1:循环内逐条查库/逐个远程调用 → 批量接口 + 组装(团队基线:100 次循环调用 = Critical);循环内重复计算不变量移出循环;循环内字符串 `html .=` 拼接 O(n²);O(n²) 双层循环查重可用 map/set 降 O(n)\n- 响应时间分级:>1s 立即修(N+1/循环远程调用/泄漏),200ms~1s 近期修(索引/串行改并发),<200ms 排期\n\n#### 明确不报(团队反向口径,防止通用规则引入误报)\n- `throw new Exception` 未传 code 参数——不强制(例外:对外 API 业务错误码/catch 按 code 分流/映射 HTTP 状态码三种场景 code 有意义)\n- Model 层是否开事务、事务落点层级(团队豁免口径)\n- 对象 handle 传递导致的属性修改(非 `&` 引用违规);框架/DI 容器持有关闭责任的资源;普通请求级文件流(PHP 请求结束自动释放)\n- PHPStan/Psalm/PHPCS/格式化工具已覆盖的风格问题\n\n#### Fowler 代码坏味道基线(跨语言通用,编译时追加到每个语言规则)\n\n> 与上文各语言专项规则并列生效。两条总则约束本节:\n> 1. **仓库已文档化的规范覆盖基线**——仓库标准明确认可某写法时(如团队规范要求的转发层),即使基线会标记该 smell,也抑制不报。\n> 2. **一律是判断题(judgement call),不是硬违规**——每条 smell 标注为「可能存在 XX 味道」,不下硬结论;与上文 Correctity/安全类规则的 🔴 硬分级不同,本节发现默认 🟢~🟡 级。\n> 工具链(gofmt/golint/php-cs/vue-tsc 等)已能可靠判定的问题不在此重复报告。每条按「是什么 → 怎么修」对照 diff。\n\n- **Mysterious Name(神秘命名)**:函数、变量或类型的名字没揭示它做什么/装什么 → 重命名;起不出诚实名字,说明设计本身混浊,转设计问题。\n- **Duplicated Code(重复代码)**:同一逻辑形状出现在本次变更的多个 hunk 或文件 → 提取共享形状,两处调用。\n- **Feature Envy(依恋别人家)**:方法访问别的对象的数据比自己的还多 → 把方法移到它依恋的数据上。\n- **Data Clumps(数据泥团)**:同样几个字段/参数总是结伴出现(一个类型想出生了)→ 捆成一个类型传递。\n- **Primitive Obsession(基本类型偏执)**:用原始类型/字符串顶替应有自己类型的领域概念(金额用 float、状态用裸 int)→ 给概念建小类型(如 `type OrderStatus int` + 常量集 / Money 结构)。\n- **Repeated Switches(重复分支)**:对同一类型的相同 switch/if 级联在本次变更中反复出现 → 用多态或两处共享的一张映射表替代。\n- **Shotgun Surgery(霰弹式修改)**:一个逻辑变更迫使 diff 在许多文件里零散落点 → 把一起变的东西聚到一个模块。\n- **Divergent Change(发散式变化)**:一个文件/模块因多个互不相关的原因被改 → 拆分使每个模块只因一个原因变。\n- **Speculative Generality(投机泛化)**:为 spec 没有的需求加的抽象、参数、钩子 → 删掉,内联回去直到真实需求出现。\n- **Message Chains(消息链)**:调用方依赖 `a.b().c().d()` 长链导航 → 在第一个对象上用一个方法把这段路藏起来。\n- **Middle Man(中间人)**:一个类/函数基本只做转发 → 砍掉,让调用方直接找真目标。\n- **Refused Bequest(拒绝继承)**:子类/实现者忽略或覆写了继承来的大部分内容 → 放弃继承改用组合。"
},
{
"path": "**/*.phtml",
"rule": "#### PHP 审查规则(Yaf 类 MVC / 团队框架项目)\n\n> 精准优先于召回:只报告你确信是真缺陷的问题,上下文不清晰时保持沉默。正确性与安全为阻塞级,风格建议为非阻塞。做非局部判断前先用 file_read / code_search 验证调用方、输入来源、框架配置与资源所有权。\n> **审查前置**:① PHP 版本以项目根 `php_version` 文件为准(无则查 composer.json 的 require.php),代码出现高于该版本的语法特性 = Critical;② 项目入口文件包含框架 SDK 初始化(如 `require_once` 框架 init 文件)即为框架项目,启用「框架 API 形态」检查(路径按你的项目调整);③ Model 层事务落点不作违规项(团队口径:只关注并发一致性结果,不约束事务层级)。\n\n#### Queue 一致性专项(团队队列库约定,历史事故规则;触发路径:`application/library/QueueTopic.php`、`conf/*Queue.php`、`service/Queue/Worker/**`、`service/Queue/Worker.php`、`service/Queue/Client.php`——按你的项目调整)\n- **QUEUE-CASE-001 Topic→Worker 类名推导闭环**:固定推导算法 `$_worker = strtr(str_replace('_', '', ucwords($topic, ':_')), ':', '\\\\');` 再拼前缀 `\\Service\\Queue\\Worker\\{$_worker}`,推导结果必须与实际类名、命名空间逐字一致。例:topic `order:payment_timeout` → 期望类 `Order\\PaymentTimeout`;实际类为 `PaymentTimeOut` 则 Critical\n- **QUEUE-CASE-002 Worker 文件名大小写敏感比对**:由推导类名计算期望路径与实际文件名做大小写敏感比对。macOS 开发环境大小写不敏感\"看起来正常\",Linux 上 `class_exists` 失败、Worker 无法消费——不能因本地能跑而放行\n- **QUEUE-CASE-003 三段链路闭环**:QueueTopic 常量定义 → `conf/*Queue.php` TOPICS 注册 → Worker 文件。topic 只需在**任一** `*Queue.php` 注册即可(存在 Queue.php/OrderQueue.php/DeliveryQueue.php 多文件),勿误报\"未在所有配置文件注册\"。topic 定义但未注册 TOPICS → 消息进 Redis 永不消费(等同丢失);action 未声明在 topic 配置的 `actions` 数组 → Worker 无法匹配\n- **QUEUE-CASE-005 TYPE_DELAY 与 $ttl 一致性**:扫描 `\\Service\\Queue\\Client::instance()->add($topic, $action, $data, $ttl)`——`$ttl > 0` 时该 topic 在 conf 中 `type` **必须**为 `Queue::TYPE_DELAY`。混合调用(同一 topic 任一调用传 `$ttl > 0`)按最严格判定;`$ttl` 为变量时默认按 `> 0` 处理。判定矩阵:有值 + TYPE_REAL = 🔴 Critical(延迟消息不被消费、队列积压),其余组合不报\n- **PHP-CORE-016 常量约定**:QueueTopic 常量名 UPPER_SNAKE ↔ 值 `module:topic_name` 一一对应;调用必须用常量而非字符串字面量(`'order:paymnet'` 拼写错误无法静态发现);新增 topic/action 常量后必须同步 conf 注册\n- **Client::instance() module 传参一致性**(真实事故复盘沉淀):Worker 重试/投递路径的 `Client::instance()` 必须显式传 module(`Client::instance(self::$_module)`);无参调用会落到硬编码默认 module,多模块部署时消息投错队列。发现无参 `Client::instance()` 且上下文存在多 module 判定(`self::$_module`/`$_module` 字段)→ Critical\n- **跨仓同步(多仓部署同一队列库时)**:Queue 关键文件(`service/Queue/Client.php`、`Worker.php`、`Worker/**`、`conf/*Queue.php`、`QueueTopic.php`)必须与对照仓同路径比对;两侧 Topic/Action 常量、TOPICS 注册、Worker 类名/文件名大小写三者一致,单边遗漏即 Critical(历史事故:两侧未同步致数万条队列消息未执行数小时)\n\n#### 单例与静态绑定(常驻内存污染专项)\n- **PHP-CORE-017 静态绑定**:可继承类静态上下文默认 `static::`(LSB)——单例 `getInstance()` 用 `new self()` → 子类拿到父类实例,正解 `self::$instances[static::class] = new static()`;工厂方法同理用 `new static()`。注意:`static::$prop` 不会自动隔离存储,子类必须**重声明**静态属性才真正隔离;固定父类常量刻意用 `self::` 属设计意图(要求注释说明),勿误报\n- **PHP-CORE-018 单例属性覆写**:判定链——单例类(`instance()`/`getInstance()`)→ 方法内 `$this->_xxx = ...` 写入请求级临时数据(非全局配置)→ 🔴。PHP-FPM 下同请求多次调用后写覆盖前写 = Warning;Swoole/常驻内存下跨协程并发覆写 = Critical。正解:方法返回值/局部变量传递,或改 per-request 对象。典型事故:单例 PriceModel 中 `_genPriceId()` 写 `$this->_priceId`,同请求两次询价后者覆盖前者\n\n#### 框架 API 形态(框架项目,API 名按你的框架调整)\n- 参数获取用框架请求对象(如 `$this->request->getInt('user_id', 0)`)而非裸 `$_GET`/`$_POST`(Critical)\n- 响应用框架响应对象(如 `$this->response->json()`)而非裸 `echo` + `die`;依赖框架自动加载而非手动 `require_once`\n- 异常须注册框架异常处理器(Critical);鉴权/限流走中间件而非入口重复判断\n\n#### 循环变量与引用(团队约定)\n- PHP 无块级作用域:循环体值变量与临时变量用 `_` 前缀(`$_item`),嵌套循环层级命名(`$_order`/`$_orderItem`);`for` 计数器 `$i/$j/$k` 不需要前缀但禁止用业务名。典型事故:`foreach ($coupons as $discount)` 覆盖全局 `$discount`,循环后金额计算类型错乱\n- `foreach ($items as &$_item)` 引用遍历结束后必须 `unset($_item)`;`array_walk` 引用回调改用 `array_map` 返回新数组;大数组禁止 `$_record['snapshot'] = $records` 式整体自引用(OOM),用 `array_chunk($records, 1000)` 分批\n- PHP 对象默认按 handle 传递、改属性天然影响调用方,这与 `&` 引用是两回事——不要把\"对象属性修改\"误报为引用违规;不想影响调用方应 `clone`\n\n#### SaaS 接入专项(SaaS 链路代码)\n- **PHP-SEC-010 TLS 双开关**:请求 SaaS HTTPS 链路需忽略非可信证书时,`CURLOPT_SSL_VERIFYPEER` 与 `CURLOPT_SSL_VERIFYHOST` 必须**同时**在 curl 初始化阶段设置且受环境开关约束(`getenv('SAAS_IGNORE_SSL_VERIFY')` 类配置)。只设其一仍会握手失败(历史事故:服务无法请求 SaaS 接口、链路不可用);反向要求——无开关无条件忽略 SSL 同样违规\n- **PHP-SAAS-002 灰度门禁**:新增入口(方法/路由/回调/分支)必须验证灰度匹配 key 能覆盖、新逻辑未绕过灰度 gate、灰度/非灰度两条路径均符合预期。新增方法没接灰度匹配规则 → 非灰度环境意外执行新逻辑\n\n#### 类型与语义(通用要点,确认可达后报告)\n- 松散比较 `==` 使安全/业务敏感的不同值相等(`0 == \"abc\"`);`isset()` 无法区分键存在但值为 null(需 `array_key_exists`);`empty()` 把 `0`/`\"0\"` 与空混同\n- 数组键读取未处理可达的缺键路径(请求数据/JSON 解码/数据库行/可选配置);数组 union `+` 与 `array_merge` 的覆盖与重排序语义误用\n- `Throwable` 被捕获后静默丢弃/转为成功/替换为误导性默认值;宽泛 catch 包住无关操作无法区分预期失败与程序缺陷;`@` 抑制符把有意义的失败变成非法状态\n- 事务:多步写缺原子边界、早退/异常路径遗留未提交事务;cURL/流操作缺超时(可停顿远程端点);长生命周期进程(队列消费者/定时任务)资源未释放、内存增量 > 50MB 记 warning\n\n#### 逻辑漏洞模式(跨语言团队专项,模拟攻击者视角)\n- 水平越权(只验登录不验资源归属)/垂直越权(普通用户可达管理操作);金额篡改(以客户端提交为准,未服务端重算);负数金额(`amount <= 0` 缺校验,注意退款场景取负是合法的);幂等缺失(支付可重复提交);状态机绕过(逆向跳转);时序竞争(先查库存再改,两请求同时通过判断 → 超卖,应用原子 UPDATE 或锁)\n- 金额计算禁用 float(`0.1+0.2` 精度问题),整数「分」为单位;除零未判 `total == 0`;优惠券叠加后 `finalAmount < 0` 未截断;批量操作无数量上限(应 ≤100)\n\n#### 安全边界(报告前确认攻击者控制与输出/执行上下文)\n- SQL 拼接未参数绑定(列名/排序方向需白名单);模板输出未按上下文转义(HTML/属性/URL/JS/CSS);CSRF:cookie 认证下状态变更请求缺 token(token 认证 API 不报);文件上传信客户端文件名/扩展名/MIME\n- `eval`/动态 include/变量函数/反射/shell 拼接可达不可信输入无严格白名单;`unserialize()` 不可信数据(`allowed_classes` 不等于可信);外发 URL 未限 scheme/host/私网(SSRF)\n- 弱随机与密码:token 用 `random_bytes`、密码用 `password_hash`/`password_verify`/`hash_equals`;敏感信息(token/密码/手机号/身份证)入日志、入错误响应、明文展示 = 违规(手机号 `138****1234` 掩码)\n\n#### 性能(报告前确认数据规模或热路径证据)\n- N+1:循环内逐条查库/逐个远程调用 → 批量接口 + 组装(团队基线:100 次循环调用 = Critical);循环内重复计算不变量移出循环;循环内字符串 `html .=` 拼接 O(n²);O(n²) 双层循环查重可用 map/set 降 O(n)\n- 响应时间分级:>1s 立即修(N+1/循环远程调用/泄漏),200ms~1s 近期修(索引/串行改并发),<200ms 排期\n\n#### 明确不报(团队反向口径,防止通用规则引入误报)\n- `throw new Exception` 未传 code 参数——不强制(例外:对外 API 业务错误码/catch 按 code 分流/映射 HTTP 状态码三种场景 code 有意义)\n- Model 层是否开事务、事务落点层级(团队豁免口径)\n- 对象 handle 传递导致的属性修改(非 `&` 引用违规);框架/DI 容器持有关闭责任的资源;普通请求级文件流(PHP 请求结束自动释放)\n- PHPStan/Psalm/PHPCS/格式化工具已覆盖的风格问题\n\n#### Fowler 代码坏味道基线(跨语言通用,编译时追加到每个语言规则)\n\n> 与上文各语言专项规则并列生效。两条总则约束本节:\n> 1. **仓库已文档化的规范覆盖基线**——仓库标准明确认可某写法时(如团队规范要求的转发层),即使基线会标记该 smell,也抑制不报。\n> 2. **一律是判断题(judgement call),不是硬违规**——每条 smell 标注为「可能存在 XX 味道」,不下硬结论;与上文 Correctity/安全类规则的 🔴 硬分级不同,本节发现默认 🟢~🟡 级。\n> 工具链(gofmt/golint/php-cs/vue-tsc 等)已能可靠判定的问题不在此重复报告。每条按「是什么 → 怎么修」对照 diff。\n\n- **Mysterious Name(神秘命名)**:函数、变量或类型的名字没揭示它做什么/装什么 → 重命名;起不出诚实名字,说明设计本身混浊,转设计问题。\n- **Duplicated Code(重复代码)**:同一逻辑形状出现在本次变更的多个 hunk 或文件 → 提取共享形状,两处调用。\n- **Feature Envy(依恋别人家)**:方法访问别的对象的数据比自己的还多 → 把方法移到它依恋的数据上。\n- **Data Clumps(数据泥团)**:同样几个字段/参数总是结伴出现(一个类型想出生了)→ 捆成一个类型传递。\n- **Primitive Obsession(基本类型偏执)**:用原始类型/字符串顶替应有自己类型的领域概念(金额用 float、状态用裸 int)→ 给概念建小类型(如 `type OrderStatus int` + 常量集 / Money 结构)。\n- **Repeated Switches(重复分支)**:对同一类型的相同 switch/if 级联在本次变更中反复出现 → 用多态或两处共享的一张映射表替代。\n- **Shotgun Surgery(霰弹式修改)**:一个逻辑变更迫使 diff 在许多文件里零散落点 → 把一起变的东西聚到一个模块。\n- **Divergent Change(发散式变化)**:一个文件/模块因多个互不相关的原因被改 → 拆分使每个模块只因一个原因变。\n- **Speculative Generality(投机泛化)**:为 spec 没有的需求加的抽象、参数、钩子 → 删掉,内联回去直到真实需求出现。\n- **Message Chains(消息链)**:调用方依赖 `a.b().c().d()` 长链导航 → 在第一个对象上用一个方法把这段路藏起来。\n- **Middle Man(中间人)**:一个类/函数基本只做转发 → 砍掉,让调用方直接找真目标。\n- **Refused Bequest(拒绝继承)**:子类/实现者忽略或覆写了继承来的大部分内容 → 放弃继承改用组合。"
},
{
"path": "**/*.vue",
"rule": "#### Vue 审查规则\n\n> 精准优先于召回:只报告你确信是真缺陷的问题,上下文不清晰时保持沉默。正确性与安全为阻塞级,风格建议为非阻塞。eslint-plugin-vue / stylelint / prettier 已覆盖的风格问题一律不报,聚焦 lint 无法覆盖的语义级缺陷。\n\n#### XSS 与安全边界\n- `v-html` 渲染用户输入(`userComment`/`$route.query.content`/接口返回内容)= XSS,必须 DOMPurify 白名单净化(ALLOWED_TAGS,FORBID script/iframe)。服务端可信富文本不豁免;**禁止**自写 `replace(/<script>/g,'')` 式净化(可被大小写/编码绕过)\n- 写操作(POST/PUT/DELETE)必须带 CSRF Token:走统一 axios 拦截器注入 `X-CSRF-Token`。全局拦截器已配置的项目,散用 `fetch` 绕过拦截器才是漏洞点\n- 敏感数据禁入 localStorage(`token`/`password`/`idCard`/`bankAccount`)、禁入 URL query(`?token=xxx`)、禁 `console.log(password)`、禁留在注释。Token 应 httpOnly Cookie;主题/语言等非敏感偏好可存\n- 双重验证:前端表单校验只是体验,重点查「服务端是否也验」;文件上传只查扩展名不查 MIME/大小 = 违规\n- 敏感信息展示脱敏:手机号 `138****1234`、身份证/银行卡掩码\n\n#### 路由与权限\n- 路由权限三要素:`meta.requiresAuth/roles` 定义 + 统一守卫 + 后端复验。前端守卫只是 UX,**后端必须独立验权**,只有前端校验无后端 403 处理 = 违规\n- 守卫 `next()` 逻辑错误(静态工具查不出的运行时 bug):某分支忘调 `next()` → 导航永久挂起;同一守卫多次调用 `next()`\n- 404 通配路由 `/:pathMatch(.*)*` 必须放路由表最后,放在前面导致后续路由永不匹配\n- `router.push({ query: { token, password } })` URL 携带敏感信息 = 违规(redirect 参数可接受)\n\n#### 副作用与生命周期(内存泄漏)\n- `mounted` 注册的副作用必须清理:`setInterval`/`addEventListener`/`$bus.$on` 在 `beforeDestroy` 无对应清除 → 泄漏。清理函数与注册一一对应;keep-alive 场景用 `deactivated`\n- watch 三个坑:① 监听对象未加 `deep`(内层变化不触发)② 回写被监听数据 → 死循环(有条件回写带 if 终止不算)③ 误用 `immediate` 导致 created 重复调用\n- computed 必须纯函数:内部 await 请求/修改数据/`new Date()`/`Math.random()` = 违规\n- 绕过单向数据流:子组件直接改 prop、`this.$parent.xxx()`、`this.$store.state.user = x` 绕过 mutation、`$children[0]` 脆弱索引\n\n#### 逻辑漏洞模式(BFF/Node 层重点,模拟攻击者视角)\n- BFF/Node 中间层接口只透传不鉴权:水平越权(只验登录不验资源归属 `order.UserID == userID`);垂直越权(普通用户可达管理接口)\n- 金额以客户端提交为准未服务端重算;金额计算禁用 float,用整数「分」;前端展示层四舍五入可容忍,落库/支付不可\n- 幂等缺失:提交按钮防抖只是 UX,后端必须幂等\n\n#### 性能(报告前确认规模或热路径证据)\n- 循环内串行请求 `for { await api.getUser(id) }` = 前端 N+1,收集 ID 批量接口或 `Promise.all`;无依赖的多个请求顺序 await → 并发(响应时间从累加变取最大值)\n- 循环内并发 fetch 无上限(应分批);未清理的定时器/事件监听泄漏\n- 响应时间分级:>1s 立即修,200ms~1s 近期修,<200ms 排期\n\n#### 明确不报\n- eslint-plugin-vue / stylelint 已覆盖:组件命名、标签顺序、v-for key、v-if+v-for、指令缩写、scoped/BEM/嵌套深度、prop 命名 casing、no-console/no-debugger 等\n- 模板 <200 行不要求分块注释标记;路由命名/懒加载等通用最佳实践(除非引发实际 bug)\n\n#### Fowler 代码坏味道基线(跨语言通用,编译时追加到每个语言规则)\n\n> 与上文各语言专项规则并列生效。两条总则约束本节:\n> 1. **仓库已文档化的规范覆盖基线**——仓库标准明确认可某写法时(如团队规范要求的转发层),即使基线会标记该 smell,也抑制不报。\n> 2. **一律是判断题(judgement call),不是硬违规**——每条 smell 标注为「可能存在 XX 味道」,不下硬结论;与上文 Correctity/安全类规则的 🔴 硬分级不同,本节发现默认 🟢~🟡 级。\n> 工具链(gofmt/golint/php-cs/vue-tsc 等)已能可靠判定的问题不在此重复报告。每条按「是什么 → 怎么修」对照 diff。\n\n- **Mysterious Name(神秘命名)**:函数、变量或类型的名字没揭示它做什么/装什么 → 重命名;起不出诚实名字,说明设计本身混浊,转设计问题。\n- **Duplicated Code(重复代码)**:同一逻辑形状出现在本次变更的多个 hunk 或文件 → 提取共享形状,两处调用。\n- **Feature Envy(依恋别人家)**:方法访问别的对象的数据比自己的还多 → 把方法移到它依恋的数据上。\n- **Data Clumps(数据泥团)**:同样几个字段/参数总是结伴出现(一个类型想出生了)→ 捆成一个类型传递。\n- **Primitive Obsession(基本类型偏执)**:用原始类型/字符串顶替应有自己类型的领域概念(金额用 float、状态用裸 int)→ 给概念建小类型(如 `type OrderStatus int` + 常量集 / Money 结构)。\n- **Repeated Switches(重复分支)**:对同一类型的相同 switch/if 级联在本次变更中反复出现 → 用多态或两处共享的一张映射表替代。\n- **Shotgun Surgery(霰弹式修改)**:一个逻辑变更迫使 diff 在许多文件里零散落点 → 把一起变的东西聚到一个模块。\n- **Divergent Change(发散式变化)**:一个文件/模块因多个互不相关的原因被改 → 拆分使每个模块只因一个原因变。\n- **Speculative Generality(投机泛化)**:为 spec 没有的需求加的抽象、参数、钩子 → 删掉,内联回去直到真实需求出现。\n- **Message Chains(消息链)**:调用方依赖 `a.b().c().d()` 长链导航 → 在第一个对象上用一个方法把这段路藏起来。\n- **Middle Man(中间人)**:一个类/函数基本只做转发 → 砍掉,让调用方直接找真目标。\n- **Refused Bequest(拒绝继承)**:子类/实现者忽略或覆写了继承来的大部分内容 → 放弃继承改用组合。"
},
{
"path": "**/*.{js,jsx,mjs,cjs}",
"rule": "#### Web 前端审查规则(JS/TS/HTML/CSS)\n\n> 精准优先于召回:只报告你确信是真缺陷的问题,上下文不清晰时保持沉默。正确性与安全为阻塞级,风格建议为非阻塞。ESLint/Prettier/Stylelint 已覆盖的风格问题一律不报,聚焦 lint 无法覆盖的语义级缺陷。\n\n#### XSS 与 DOM 注入\n- `innerHTML`/`document.write` 插入用户输入 = XSS,优先 `textContent`/`insertAdjacentText`;富文本必须 DOMPurify 白名单净化,**禁止**自写 `replace(/<script>/g,'')` 式净化(可被大小写/编码绕过)\n- 从 URL query/`location.hash`/`postMessage`/`referrer` 读取的数据直接写入 DOM 或 eval 类执行 = 违规\n\n#### 安全响应头与配置(部署配置文件场景)\n- CORS 白名单:`Access-Control-Allow-Origin: *`、直接回显 `req.headers.origin`、`*` 与 credentials 同用 = 违规\n- 点击劫持:未配置 `X-Frame-Options: DENY/SAMEORIGIN` 或 CSP `frame-ancestors`(`ALLOWALL` 是非法值;客户端 frame-busting 可被禁 JS 绕过)\n- 安全随机数:Token/验证码用 `Math.random()`/`Date.now()` 生成 = 违规,应 `crypto.getRandomValues()` 且长度 ≥32 字节(非安全用途的随机样式不报)\n\n#### 敏感数据\n- 敏感数据禁入 localStorage/URL query/`console.log`/注释;`?token=xxx` 传参 = 违规\n- 敏感信息展示脱敏(手机号 `138****1234`、身份证/银行卡掩码)\n\n#### 逻辑漏洞模式(跨语言团队专项,模拟攻击者视角)\n- 水平越权:接口只验登录不验资源归属(前端改 ID 即可访问他人数据,判定要看后端是否补验)\n- 金额篡改:金额以客户端提交为准未服务端重算;金额计算禁用 float(`0.1+0.2`),用整数「分」;前端展示层四舍五入可容忍,落库/支付不可\n- 幂等缺失:提交可重复触发(防抖只是 UX,后端必须幂等)\n- 除零:`success/total` 未判 `total == 0` 返回 NaN/Infinity 直接渲染\n\n#### 性能(报告前确认规模或热路径证据)\n- 循环内串行请求 `for { await api.getUser(id) }` = N+1,批量接口或 `Promise.all`\n- 无依赖的多个请求顺序 await → 并发执行(响应时间从累加变取最大值);循环内并发 fetch 无上限应分批\n- 循环内字符串 `html +=` 拼接 O(n²) → 数组 + `join`\n- 响应时间分级:>1s 立即修,200ms~1s 近期修,<200ms 排期\n\n#### 明确不报\n- ESLint/Prettier/Stylelint 已覆盖:camelcase、no-var、prefer-const、curly、语义化标签、alt/label、内联样式、类名规范、属性顺序等\n- 通用 Web 性能最佳实践(首屏/压缩/CDN/懒加载),除非 diff 引入了可量化的具体退化\n\n#### Fowler 代码坏味道基线(跨语言通用,编译时追加到每个语言规则)\n\n> 与上文各语言专项规则并列生效。两条总则约束本节:\n> 1. **仓库已文档化的规范覆盖基线**——仓库标准明确认可某写法时(如团队规范要求的转发层),即使基线会标记该 smell,也抑制不报。\n> 2. **一律是判断题(judgement call),不是硬违规**——每条 smell 标注为「可能存在 XX 味道」,不下硬结论;与上文 Correctity/安全类规则的 🔴 硬分级不同,本节发现默认 🟢~🟡 级。\n> 工具链(gofmt/golint/php-cs/vue-tsc 等)已能可靠判定的问题不在此重复报告。每条按「是什么 → 怎么修」对照 diff。\n\n- **Mysterious Name(神秘命名)**:函数、变量或类型的名字没揭示它做什么/装什么 → 重命名;起不出诚实名字,说明设计本身混浊,转设计问题。\n- **Duplicated Code(重复代码)**:同一逻辑形状出现在本次变更的多个 hunk 或文件 → 提取共享形状,两处调用。\n- **Feature Envy(依恋别人家)**:方法访问别的对象的数据比自己的还多 → 把方法移到它依恋的数据上。\n- **Data Clumps(数据泥团)**:同样几个字段/参数总是结伴出现(一个类型想出生了)→ 捆成一个类型传递。\n- **Primitive Obsession(基本类型偏执)**:用原始类型/字符串顶替应有自己类型的领域概念(金额用 float、状态用裸 int)→ 给概念建小类型(如 `type OrderStatus int` + 常量集 / Money 结构)。\n- **Repeated Switches(重复分支)**:对同一类型的相同 switch/if 级联在本次变更中反复出现 → 用多态或两处共享的一张映射表替代。\n- **Shotgun Surgery(霰弹式修改)**:一个逻辑变更迫使 diff 在许多文件里零散落点 → 把一起变的东西聚到一个模块。\n- **Divergent Change(发散式变化)**:一个文件/模块因多个互不相关的原因被改 → 拆分使每个模块只因一个原因变。\n- **Speculative Generality(投机泛化)**:为 spec 没有的需求加的抽象、参数、钩子 → 删掉,内联回去直到真实需求出现。\n- **Message Chains(消息链)**:调用方依赖 `a.b().c().d()` 长链导航 → 在第一个对象上用一个方法把这段路藏起来。\n- **Middle Man(中间人)**:一个类/函数基本只做转发 → 砍掉,让调用方直接找真目标。\n- **Refused Bequest(拒绝继承)**:子类/实现者忽略或覆写了继承来的大部分内容 → 放弃继承改用组合。"
},
{
"path": "**/*.{ts,tsx}",
"rule": "#### Web 前端审查规则(JS/TS/HTML/CSS)\n\n> 精准优先于召回:只报告你确信是真缺陷的问题,上下文不清晰时保持沉默。正确性与安全为阻塞级,风格建议为非阻塞。ESLint/Prettier/Stylelint 已覆盖的风格问题一律不报,聚焦 lint 无法覆盖的语义级缺陷。\n\n#### XSS 与 DOM 注入\n- `innerHTML`/`document.write` 插入用户输入 = XSS,优先 `textContent`/`insertAdjacentText`;富文本必须 DOMPurify 白名单净化,**禁止**自写 `replace(/<script>/g,'')` 式净化(可被大小写/编码绕过)\n- 从 URL query/`location.hash`/`postMessage`/`referrer` 读取的数据直接写入 DOM 或 eval 类执行 = 违规\n\n#### 安全响应头与配置(部署配置文件场景)\n- CORS 白名单:`Access-Control-Allow-Origin: *`、直接回显 `req.headers.origin`、`*` 与 credentials 同用 = 违规\n- 点击劫持:未配置 `X-Frame-Options: DENY/SAMEORIGIN` 或 CSP `frame-ancestors`(`ALLOWALL` 是非法值;客户端 frame-busting 可被禁 JS 绕过)\n- 安全随机数:Token/验证码用 `Math.random()`/`Date.now()` 生成 = 违规,应 `crypto.getRandomValues()` 且长度 ≥32 字节(非安全用途的随机样式不报)\n\n#### 敏感数据\n- 敏感数据禁入 localStorage/URL query/`console.log`/注释;`?token=xxx` 传参 = 违规\n- 敏感信息展示脱敏(手机号 `138****1234`、身份证/银行卡掩码)\n\n#### 逻辑漏洞模式(跨语言团队专项,模拟攻击者视角)\n- 水平越权:接口只验登录不验资源归属(前端改 ID 即可访问他人数据,判定要看后端是否补验)\n- 金额篡改:金额以客户端提交为准未服务端重算;金额计算禁用 float(`0.1+0.2`),用整数「分」;前端展示层四舍五入可容忍,落库/支付不可\n- 幂等缺失:提交可重复触发(防抖只是 UX,后端必须幂等)\n- 除零:`success/total` 未判 `total == 0` 返回 NaN/Infinity 直接渲染\n\n#### 性能(报告前确认规模或热路径证据)\n- 循环内串行请求 `for { await api.getUser(id) }` = N+1,批量接口或 `Promise.all`\n- 无依赖的多个请求顺序 await → 并发执行(响应时间从累加变取最大值);循环内并发 fetch 无上限应分批\n- 循环内字符串 `html +=` 拼接 O(n²) → 数组 + `join`\n- 响应时间分级:>1s 立即修,200ms~1s 近期修,<200ms 排期\n\n#### 明确不报\n- ESLint/Prettier/Stylelint 已覆盖:camelcase、no-var、prefer-const、curly、语义化标签、alt/label、内联样式、类名规范、属性顺序等\n- 通用 Web 性能最佳实践(首屏/压缩/CDN/懒加载),除非 diff 引入了可量化的具体退化\n\n#### Fowler 代码坏味道基线(跨语言通用,编译时追加到每个语言规则)\n\n> 与上文各语言专项规则并列生效。两条总则约束本节:\n> 1. **仓库已文档化的规范覆盖基线**——仓库标准明确认可某写法时(如团队规范要求的转发层),即使基线会标记该 smell,也抑制不报。\n> 2. **一律是判断题(judgement call),不是硬违规**——每条 smell 标注为「可能存在 XX 味道」,不下硬结论;与上文 Correctity/安全类规则的 🔴 硬分级不同,本节发现默认 🟢~🟡 级。\n> 工具链(gofmt/golint/php-cs/vue-tsc 等)已能可靠判定的问题不在此重复报告。每条按「是什么 → 怎么修」对照 diff。\n\n- **Mysterious Name(神秘命名)**:函数、变量或类型的名字没揭示它做什么/装什么 → 重命名;起不出诚实名字,说明设计本身混浊,转设计问题。\n- **Duplicated Code(重复代码)**:同一逻辑形状出现在本次变更的多个 hunk 或文件 → 提取共享形状,两处调用。\n- **Feature Envy(依恋别人家)**:方法访问别的对象的数据比自己的还多 → 把方法移到它依恋的数据上。\n- **Data Clumps(数据泥团)**:同样几个字段/参数总是结伴出现(一个类型想出生了)→ 捆成一个类型传递。\n- **Primitive Obsession(基本类型偏执)**:用原始类型/字符串顶替应有自己类型的领域概念(金额用 float、状态用裸 int)→ 给概念建小类型(如 `type OrderStatus int` + 常量集 / Money 结构)。\n- **Repeated Switches(重复分支)**:对同一类型的相同 switch/if 级联在本次变更中反复出现 → 用多态或两处共享的一张映射表替代。\n- **Shotgun Surgery(霰弹式修改)**:一个逻辑变更迫使 diff 在许多文件里零散落点 → 把一起变的东西聚到一个模块。\n- **Divergent Change(发散式变化)**:一个文件/模块因多个互不相关的原因被改 → 拆分使每个模块只因一个原因变。\n- **Speculative Generality(投机泛化)**:为 spec 没有的需求加的抽象、参数、钩子 → 删掉,内联回去直到真实需求出现。\n- **Message Chains(消息链)**:调用方依赖 `a.b().c().d()` 长链导航 → 在第一个对象上用一个方法把这段路藏起来。\n- **Middle Man(中间人)**:一个类/函数基本只做转发 → 砍掉,让调用方直接找真目标。\n- **Refused Bequest(拒绝继承)**:子类/实现者忽略或覆写了继承来的大部分内容 → 放弃继承改用组合。"
},
{
"path": "**/*.html",
"rule": "#### Web 前端审查规则(JS/TS/HTML/CSS)\n\n> 精准优先于召回:只报告你确信是真缺陷的问题,上下文不清晰时保持沉默。正确性与安全为阻塞级,风格建议为非阻塞。ESLint/Prettier/Stylelint 已覆盖的风格问题一律不报,聚焦 lint 无法覆盖的语义级缺陷。\n\n#### XSS 与 DOM 注入\n- `innerHTML`/`document.write` 插入用户输入 = XSS,优先 `textContent`/`insertAdjacentText`;富文本必须 DOMPurify 白名单净化,**禁止**自写 `replace(/<script>/g,'')` 式净化(可被大小写/编码绕过)\n- 从 URL query/`location.hash`/`postMessage`/`referrer` 读取的数据直接写入 DOM 或 eval 类执行 = 违规\n\n#### 安全响应头与配置(部署配置文件场景)\n- CORS 白名单:`Access-Control-Allow-Origin: *`、直接回显 `req.headers.origin`、`*` 与 credentials 同用 = 违规\n- 点击劫持:未配置 `X-Frame-Options: DENY/SAMEORIGIN` 或 CSP `frame-ancestors`(`ALLOWALL` 是非法值;客户端 frame-busting 可被禁 JS 绕过)\n- 安全随机数:Token/验证码用 `Math.random()`/`Date.now()` 生成 = 违规,应 `crypto.getRandomValues()` 且长度 ≥32 字节(非安全用途的随机样式不报)\n\n#### 敏感数据\n- 敏感数据禁入 localStorage/URL query/`console.log`/注释;`?token=xxx` 传参 = 违规\n- 敏感信息展示脱敏(手机号 `138****1234`、身份证/银行卡掩码)\n\n#### 逻辑漏洞模式(跨语言团队专项,模拟攻击者视角)\n- 水平越权:接口只验登录不验资源归属(前端改 ID 即可访问他人数据,判定要看后端是否补验)\n- 金额篡改:金额以客户端提交为准未服务端重算;金额计算禁用 float(`0.1+0.2`),用整数「分」;前端展示层四舍五入可容忍,落库/支付不可\n- 幂等缺失:提交可重复触发(防抖只是 UX,后端必须幂等)\n- 除零:`success/total` 未判 `total == 0` 返回 NaN/Infinity 直接渲染\n\n#### 性能(报告前确认规模或热路径证据)\n- 循环内串行请求 `for { await api.getUser(id) }` = N+1,批量接口或 `Promise.all`\n- 无依赖的多个请求顺序 await → 并发执行(响应时间从累加变取最大值);循环内并发 fetch 无上限应分批\n- 循环内字符串 `html +=` 拼接 O(n²) → 数组 + `join`\n- 响应时间分级:>1s 立即修,200ms~1s 近期修,<200ms 排期\n\n#### 明确不报\n- ESLint/Prettier/Stylelint 已覆盖:camelcase、no-var、prefer-const、curly、语义化标签、alt/label、内联样式、类名规范、属性顺序等\n- 通用 Web 性能最佳实践(首屏/压缩/CDN/懒加载),除非 diff 引入了可量化的具体退化\n\n#### Fowler 代码坏味道基线(跨语言通用,编译时追加到每个语言规则)\n\n> 与上文各语言专项规则并列生效。两条总则约束本节:\n> 1. **仓库已文档化的规范覆盖基线**——仓库标准明确认可某写法时(如团队规范要求的转发层),即使基线会标记该 smell,也抑制不报。\n> 2. **一律是判断题(judgement call),不是硬违规**——每条 smell 标注为「可能存在 XX 味道」,不下硬结论;与上文 Correctity/安全类规则的 🔴 硬分级不同,本节发现默认 🟢~🟡 级。\n> 工具链(gofmt/golint/php-cs/vue-tsc 等)已能可靠判定的问题不在此重复报告。每条按「是什么 → 怎么修」对照 diff。\n\n- **Mysterious Name(神秘命名)**:函数、变量或类型的名字没揭示它做什么/装什么 → 重命名;起不出诚实名字,说明设计本身混浊,转设计问题。\n- **Duplicated Code(重复代码)**:同一逻辑形状出现在本次变更的多个 hunk 或文件 → 提取共享形状,两处调用。\n- **Feature Envy(依恋别人家)**:方法访问别的对象的数据比自己的还多 → 把方法移到它依恋的数据上。\n- **Data Clumps(数据泥团)**:同样几个字段/参数总是结伴出现(一个类型想出生了)→ 捆成一个类型传递。\n- **Primitive Obsession(基本类型偏执)**:用原始类型/字符串顶替应有自己类型的领域概念(金额用 float、状态用裸 int)→ 给概念建小类型(如 `type OrderStatus int` + 常量集 / Money 结构)。\n- **Repeated Switches(重复分支)**:对同一类型的相同 switch/if 级联在本次变更中反复出现 → 用多态或两处共享的一张映射表替代。\n- **Shotgun Surgery(霰弹式修改)**:一个逻辑变更迫使 diff 在许多文件里零散落点 → 把一起变的东西聚到一个模块。\n- **Divergent Change(发散式变化)**:一个文件/模块因多个互不相关的原因被改 → 拆分使每个模块只因一个原因变。\n- **Speculative Generality(投机泛化)**:为 spec 没有的需求加的抽象、参数、钩子 → 删掉,内联回去直到真实需求出现。\n- **Message Chains(消息链)**:调用方依赖 `a.b().c().d()` 长链导航 → 在第一个对象上用一个方法把这段路藏起来。\n- **Middle Man(中间人)**:一个类/函数基本只做转发 → 砍掉,让调用方直接找真目标。\n- **Refused Bequest(拒绝继承)**:子类/实现者忽略或覆写了继承来的大部分内容 → 放弃继承改用组合。"
},
{
"path": "**/*.css",
"rule": "#### Web 前端审查规则(JS/TS/HTML/CSS)\n\n> 精准优先于召回:只报告你确信是真缺陷的问题,上下文不清晰时保持沉默。正确性与安全为阻塞级,风格建议为非阻塞。ESLint/Prettier/Stylelint 已覆盖的风格问题一律不报,聚焦 lint 无法覆盖的语义级缺陷。\n\n#### XSS 与 DOM 注入\n- `innerHTML`/`document.write` 插入用户输入 = XSS,优先 `textContent`/`insertAdjacentText`;富文本必须 DOMPurify 白名单净化,**禁止**自写 `replace(/<script>/g,'')` 式净化(可被大小写/编码绕过)\n- 从 URL query/`location.hash`/`postMessage`/`referrer` 读取的数据直接写入 DOM 或 eval 类执行 = 违规\n\n#### 安全响应头与配置(部署配置文件场景)\n- CORS 白名单:`Access-Control-Allow-Origin: *`、直接回显 `req.headers.origin`、`*` 与 credentials 同用 = 违规\n- 点击劫持:未配置 `X-Frame-Options: DENY/SAMEORIGIN` 或 CSP `frame-ancestors`(`ALLOWALL` 是非法值;客户端 frame-busting 可被禁 JS 绕过)\n- 安全随机数:Token/验证码用 `Math.random()`/`Date.now()` 生成 = 违规,应 `crypto.getRandomValues()` 且长度 ≥32 字节(非安全用途的随机样式不报)\n\n#### 敏感数据\n- 敏感数据禁入 localStorage/URL query/`console.log`/注释;`?token=xxx` 传参 = 违规\n- 敏感信息展示脱敏(手机号 `138****1234`、身份证/银行卡掩码)\n\n#### 逻辑漏洞模式(跨语言团队专项,模拟攻击者视角)\n- 水平越权:接口只验登录不验资源归属(前端改 ID 即可访问他人数据,判定要看后端是否补验)\n- 金额篡改:金额以客户端提交为准未服务端重算;金额计算禁用 float(`0.1+0.2`),用整数「分」;前端展示层四舍五入可容忍,落库/支付不可\n- 幂等缺失:提交可重复触发(防抖只是 UX,后端必须幂等)\n- 除零:`success/total` 未判 `total == 0` 返回 NaN/Infinity 直接渲染\n\n#### 性能(报告前确认规模或热路径证据)\n- 循环内串行请求 `for { await api.getUser(id) }` = N+1,批量接口或 `Promise.all`\n- 无依赖的多个请求顺序 await → 并发执行(响应时间从累加变取最大值);循环内并发 fetch 无上限应分批\n- 循环内字符串 `html +=` 拼接 O(n²) → 数组 + `join`\n- 响应时间分级:>1s 立即修,200ms~1s 近期修,<200ms 排期\n\n#### 明确不报\n- ESLint/Prettier/Stylelint 已覆盖:camelcase、no-var、prefer-const、curly、语义化标签、alt/label、内联样式、类名规范、属性顺序等\n- 通用 Web 性能最佳实践(首屏/压缩/CDN/懒加载),除非 diff 引入了可量化的具体退化\n\n#### Fowler 代码坏味道基线(跨语言通用,编译时追加到每个语言规则)\n\n> 与上文各语言专项规则并列生效。两条总则约束本节:\n> 1. **仓库已文档化的规范覆盖基线**——仓库标准明确认可某写法时(如团队规范要求的转发层),即使基线会标记该 smell,也抑制不报。\n> 2. **一律是判断题(judgement call),不是硬违规**——每条 smell 标注为「可能存在 XX 味道」,不下硬结论;与上文 Correctity/安全类规则的 🔴 硬分级不同,本节发现默认 🟢~🟡 级。\n> 工具链(gofmt/golint/php-cs/vue-tsc 等)已能可靠判定的问题不在此重复报告。每条按「是什么 → 怎么修」对照 diff。\n\n- **Mysterious Name(神秘命名)**:函数、变量或类型的名字没揭示它做什么/装什么 → 重命名;起不出诚实名字,说明设计本身混浊,转设计问题。\n- **Duplicated Code(重复代码)**:同一逻辑形状出现在本次变更的多个 hunk 或文件 → 提取共享形状,两处调用。\n- **Feature Envy(依恋别人家)**:方法访问别的对象的数据比自己的还多 → 把方法移到它依恋的数据上。\n- **Data Clumps(数据泥团)**:同样几个字段/参数总是结伴出现(一个类型想出生了)→ 捆成一个类型传递。\n- **Primitive Obsession(基本类型偏执)**:用原始类型/字符串顶替应有自己类型的领域概念(金额用 float、状态用裸 int)→ 给概念建小类型(如 `type OrderStatus int` + 常量集 / Money 结构)。\n- **Repeated Switches(重复分支)**:对同一类型的相同 switch/if 级联在本次变更中反复出现 → 用多态或两处共享的一张映射表替代。\n- **Shotgun Surgery(霰弹式修改)**:一个逻辑变更迫使 diff 在许多文件里零散落点 → 把一起变的东西聚到一个模块。\n- **Divergent Change(发散式变化)**:一个文件/模块因多个互不相关的原因被改 → 拆分使每个模块只因一个原因变。\n- **Speculative Generality(投机泛化)**:为 spec 没有的需求加的抽象、参数、钩子 → 删掉,内联回去直到真实需求出现。\n- **Message Chains(消息链)**:调用方依赖 `a.b().c().d()` 长链导航 → 在第一个对象上用一个方法把这段路藏起来。\n- **Middle Man(中间人)**:一个类/函数基本只做转发 → 砍掉,让调用方直接找真目标。\n- **Refused Bequest(拒绝继承)**:子类/实现者忽略或覆写了继承来的大部分内容 → 放弃继承改用组合。"
},
{
"path": "**/*.scss",
"rule": "#### Web 前端审查规则(JS/TS/HTML/CSS)\n\n> 精准优先于召回:只报告你确信是真缺陷的问题,上下文不清晰时保持沉默。正确性与安全为阻塞级,风格建议为非阻塞。ESLint/Prettier/Stylelint 已覆盖的风格问题一律不报,聚焦 lint 无法覆盖的语义级缺陷。\n\n#### XSS 与 DOM 注入\n- `innerHTML`/`document.write` 插入用户输入 = XSS,优先 `textContent`/`insertAdjacentText`;富文本必须 DOMPurify 白名单净化,**禁止**自写 `replace(/<script>/g,'')` 式净化(可被大小写/编码绕过)\n- 从 URL query/`location.hash`/`postMessage`/`referrer` 读取的数据直接写入 DOM 或 eval 类执行 = 违规\n\n#### 安全响应头与配置(部署配置文件场景)\n- CORS 白名单:`Access-Control-Allow-Origin: *`、直接回显 `req.headers.origin`、`*` 与 credentials 同用 = 违规\n- 点击劫持:未配置 `X-Frame-Options: DENY/SAMEORIGIN` 或 CSP `frame-ancestors`(`ALLOWALL` 是非法值;客户端 frame-busting 可被禁 JS 绕过)\n- 安全随机数:Token/验证码用 `Math.random()`/`Date.now()` 生成 = 违规,应 `crypto.getRandomValues()` 且长度 ≥32 字节(非安全用途的随机样式不报)\n\n#### 敏感数据\n- 敏感数据禁入 localStorage/URL query/`console.log`/注释;`?token=xxx` 传参 = 违规\n- 敏感信息展示脱敏(手机号 `138****1234`、身份证/银行卡掩码)\n\n#### 逻辑漏洞模式(跨语言团队专项,模拟攻击者视角)\n- 水平越权:接口只验登录不验资源归属(前端改 ID 即可访问他人数据,判定要看后端是否补验)\n- 金额篡改:金额以客户端提交为准未服务端重算;金额计算禁用 float(`0.1+0.2`),用整数「分」;前端展示层四舍五入可容忍,落库/支付不可\n- 幂等缺失:提交可重复触发(防抖只是 UX,后端必须幂等)\n- 除零:`success/total` 未判 `total == 0` 返回 NaN/Infinity 直接渲染\n\n#### 性能(报告前确认规模或热路径证据)\n- 循环内串行请求 `for { await api.getUser(id) }` = N+1,批量接口或 `Promise.all`\n- 无依赖的多个请求顺序 await → 并发执行(响应时间从累加变取最大值);循环内并发 fetch 无上限应分批\n- 循环内字符串 `html +=` 拼接 O(n²) → 数组 + `join`\n- 响应时间分级:>1s 立即修,200ms~1s 近期修,<200ms 排期\n\n#### 明确不报\n- ESLint/Prettier/Stylelint 已覆盖:camelcase、no-var、prefer-const、curly、语义化标签、alt/label、内联样式、类名规范、属性顺序等\n- 通用 Web 性能最佳实践(首屏/压缩/CDN/懒加载),除非 diff 引入了可量化的具体退化\n\n#### Fowler 代码坏味道基线(跨语言通用,编译时追加到每个语言规则)\n\n> 与上文各语言专项规则并列生效。两条总则约束本节:\n> 1. **仓库已文档化的规范覆盖基线**——仓库标准明确认可某写法时(如团队规范要求的转发层),即使基线会标记该 smell,也抑制不报。\n> 2. **一律是判断题(judgement call),不是硬违规**——每条 smell 标注为「可能存在 XX 味道」,不下硬结论;与上文 Correctity/安全类规则的 🔴 硬分级不同,本节发现默认 🟢~🟡 级。\n> 工具链(gofmt/golint/php-cs/vue-tsc 等)已能可靠判定的问题不在此重复报告。每条按「是什么 → 怎么修」对照 diff。\n\n- **Mysterious Name(神秘命名)**:函数、变量或类型的名字没揭示它做什么/装什么 → 重命名;起不出诚实名字,说明设计本身混浊,转设计问题。\n- **Duplicated Code(重复代码)**:同一逻辑形状出现在本次变更的多个 hunk 或文件 → 提取共享形状,两处调用。\n- **Feature Envy(依恋别人家)**:方法访问别的对象的数据比自己的还多 → 把方法移到它依恋的数据上。\n- **Data Clumps(数据泥团)**:同样几个字段/参数总是结伴出现(一个类型想出生了)→ 捆成一个类型传递。\n- **Primitive Obsession(基本类型偏执)**:用原始类型/字符串顶替应有自己类型的领域概念(金额用 float、状态用裸 int)→ 给概念建小类型(如 `type OrderStatus int` + 常量集 / Money 结构)。\n- **Repeated Switches(重复分支)**:对同一类型的相同 switch/if 级联在本次变更中反复出现 → 用多态或两处共享的一张映射表替代。\n- **Shotgun Surgery(霰弹式修改)**:一个逻辑变更迫使 diff 在许多文件里零散落点 → 把一起变的东西聚到一个模块。\n- **Divergent Change(发散式变化)**:一个文件/模块因多个互不相关的原因被改 → 拆分使每个模块只因一个原因变。\n- **Speculative Generality(投机泛化)**:为 spec 没有的需求加的抽象、参数、钩子 → 删掉,内联回去直到真实需求出现。\n- **Message Chains(消息链)**:调用方依赖 `a.b().c().d()` 长链导航 → 在第一个对象上用一个方法把这段路藏起来。\n- **Middle Man(中间人)**:一个类/函数基本只做转发 → 砍掉,让调用方直接找真目标。\n- **Refused Bequest(拒绝继承)**:子类/实现者忽略或覆写了继承来的大部分内容 → 放弃继承改用组合。"
}
]
}