Просмотр исходного кода

📝 v3 规则:日志级别按生产是否留存选,临时日志不进提交

生产要留的用 error / warning / info,本地看的用 debug,临时排查的调试完删;
info 不准放热路径、不准写整段正文。提交前 grep 暂存区里新增的 Log:: / dd() 等。
CLAUDE.md 与 v3-resource skill(硬规范第 12 条 + 验收)同步。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
visuddhinanda 15 часов назад
Родитель
Сommit
0d3bd63af2
2 измененных файлов с 36 добавлено и 0 удалено
  1. 21 0
      .claude/skills/v3-resource/SKILL.md
  2. 15 0
      CLAUDE.md

+ 21 - 0
.claude/skills/v3-resource/SKILL.md

@@ -680,6 +680,19 @@ v3 端点可以自由改:v4 那两处 v3 引用(`ChatInput.tsx:127`、`agent
    `$this->postJson($url, $data, ['Accept-Language' => 'zh-Hans'])`,范例见
    `$this->postJson($url, $data, ['Accept-Language' => 'zh-Hans'])`,范例见
    `tests/Feature/LocaleV3Test.php`。
    `tests/Feature/LocaleV3Test.php`。
 
 
+12. **日志级别按「生产上要不要留」选,临时日志不进提交。**
+
+   | 用途 | 级别 |
+   | --- | --- |
+   | 生产上需要留存、出事要靠它排查的 | `error` / `warning` / `info` |
+   | 只在本地开发时看的 | `debug`(生产 `.env` 须 `LOG_LEVEL=info`;`config/logging.php` 缺省是 debug) |
+   | 临时排查用的 | 调试完就删 |
+
+   `info` 只给低频、有业务意义的事件,**不准放在逐句、逐段、逐请求的热路径上**,
+   也不准把整段正文写进日志。反例:阅读页的 `reading-annotations: inject`
+   (`Log::info` 逐句写整句译文,2026-11-19 线上 46 秒 91 条,已删)。
+   提交前的检查见「验收」。
+
 ## 路由怎么设计
 ## 路由怎么设计
 
 
 ### 先过四道判据
 ### 先过四道判据
@@ -1173,6 +1186,14 @@ cd dashboard-v6 && npm run build                                  # 前端类型
 三条都要过。**没有这三道闸,上面所有规范半年内都会腐化**——这比任何文档都重要。
 三条都要过。**没有这三道闸,上面所有规范半年内都会腐化**——这比任何文档都重要。
 (`tests/Feature/ExampleTest.php` 是历史遗留失败,可忽略。)
 (`tests/Feature/ExampleTest.php` 是历史遗留失败,可忽略。)
 
 
+提交前再查一遍新增的日志(硬规范第 12 条):
+
+```bash
+git diff --cached -U0 | grep -nE 'Log::|logger\(|\b(dd|dump|ray)\('
+```
+
+新增的每一条都要对得上级别表;临时日志、`dd()`、`dump()` 删掉再提交。
+
 ## 禁止事项
 ## 禁止事项
 
 
 - 不要一次迁多个资源
 - 不要一次迁多个资源

+ 15 - 0
CLAUDE.md

@@ -379,6 +379,21 @@ v3 这条只服务单 channel 的只读渲染。前端 `dashboard-v6/src/api/pal
 补偿手段要写进代码:v3 控制器的类注释写明「取代 `GET /v2/xxx`」,模型注释写明底层表名
 补偿手段要写进代码:v3 控制器的类注释写明「取代 `GET /v2/xxx`」,模型注释写明底层表名
 (如 `Reaction` 写明仍是 `likes` 表),这样从任一端都能找到另一端。
 (如 `Reaction` 写明仍是 `likes` 表),这样从任一端都能找到另一端。
 
 
+**日志级别(2026-11-20 定)**:按「这条日志要不要在生产上留下」选级别,不按心情。
+
+| 用途 | 级别 |
+| --- | --- |
+| 生产上需要留存、出了事要靠它排查的 | `error` / `warning` / `info` |
+| 只在本地开发时看的 | `debug`(生产 `.env` 必须 `LOG_LEVEL=info`,debug 才不落盘;`config/logging.php` 缺省是 debug) |
+| 临时排查用的 | 调试完就删,不进提交 |
+
+`info` 只给低频、有业务意义的事件(任务完成、外部服务降级等),**不准放在逐句、逐段、
+逐请求的热路径上**,更不准把整段正文写进日志——2026-11-19 线上阅读页的
+`reading-annotations: inject`(`Log::info`,逐句写整句译文)46 秒写了 91 条,已删。
+
+**提交前检查**:`git diff --cached -U0 | grep -nE 'Log::|logger\(|\b(dd|dump|ray)\('`,
+新增的每一条都要对得上上表;临时日志、`dd()`、`dump()` 一律删掉再提交。
+
 **做迁移时使用 `v3-resource` skill**,里面有完整链路(0–9 步必做,10–12 步按需)与模板。
 **做迁移时使用 `v3-resource` skill**,里面有完整链路(0–9 步必做,10–12 步按需)与模板。
 
 
 **每迁一个资源,两套外部测试都要跟着更新**(skill 第 8、9 步),没更新就不算迁完:
 **每迁一个资源,两套外部测试都要跟着更新**(skill 第 8、9 步),没更新就不算迁完: