delete and replace

Author: liuyangyang

CLAUDE.md

@@ -1,9 +1,58 @@
 # CLAUDE.md
 
-这个文件为 Claude Code (claude.ai/code) 在此代码仓库中工作时提供指导。
+# 任何项目都务必遵守的规则（极其重要！！！）
+## Communication
+- 永远使用简体中文进行思考和对话
+
+## Documentation
+- 编写 .md 文档时，也要用中文
+- 正式文档写到项目的 docs/ 目录下
+- 用于讨论和评审的计划、方案等文档，写到项目的 discuss/ 目录下
+
+## Code Architecture
+- 代码必须简单清晰，易于理解
+- 编写代码的硬性指标，包括以下原则：
+  （1）对于 Python 等动态语言，尽可能确保每个代码文件不要超过 300 行
+  （2）对于 C++ 、C 等静态语言，尽可能确保每个代码文件不要超过 400 行
+  （3）每层文件夹中的文件，尽可能不超过 8 个。如有超过，需要规划为多层子文件夹
+- 除了硬性指标以外，还需要时刻关注优雅的架构设计，避免出现以下可能侵蚀我们代码质量的「坏味道」：
+  （1）僵化 (Rigidity): 系统难以变更，任何微小的改动都会引发一连串的连锁修改。
+  （2）冗余 (Redundancy): 同样的代码逻辑在多处重复出现，导致维护困难且容易产生不一致。
+  （3）循环依赖 (Circular Dependency): 两个或多个模块互相纠缠，形成无法解耦的“死结”，导致难以测试与复用。
+  （4）脆弱性 (Fragility): 对代码一处的修改，导致了系统中其他看似无关部分功能的意外损坏。
+  （5）晦涩性 (Obscurity): 代码意图不明，结构混乱，导致阅读者难以理解其功能和设计。
+  （6）数据泥团 (Data Clump): 多个数据项总是一起出现在不同方法的参数中，暗示着它们应该被组合成一个独立的对象。
+  （7）不必要的复杂性 (Needless Complexity): 用“杀牛刀”去解决“杀鸡”的问题，过度设计使系统变得臃肿且难以理解。
+- 【非常重要！！】无论是你自己编写代码，还是阅读或审核他人代码时，都要严格遵守上述硬性指标，以及时刻关注优雅的架构设计。
+- 【非常重要！！】无论何时，一旦你识别出那些可能侵蚀我们代码质量的「坏味道」，都应当立即询问用户是否需要优化，并给出合理的优化建议。
+
+
+## Run & Debug
+- 必须首先在项目的 scripts/ 目录下，维护好 Run & Debug 需要用到的全部 .sh 脚本
+- 对于所有 Run & Debug 操作，一律使用 scripts/ 目录下的 .sh 脚本进行启停。永远不要直接使用 npm、pnpm、uv、python 等等命令
+- 如果 .sh 脚本执行失败，无论是 .sh 本身的问题还是其他代码问题，需要先紧急修复。然后仍然坚持用 .sh 脚本进行启停
+- Run & Debug 之前，为所有项目配置 Logger with File Output，并统一输出到 logs/ 目录下
+
+## Python
+- 数据结构尽可能全部定义成强类型。如果个别场景不得不使用未经结构化定义的 dict，需要先停下来征求用户的同意
+- Python 虚拟环境永远使用 .venv 作为目录名
+- 必须使用 uv，而不是 pip、poetry、conda、python3、python。包括依赖管理、构建、调试启动等所有环节
+- 项目的根目录必须保持简洁，只保留必须存在的文件
+- main.py 内容也要简洁。只保留必须存在的代码
+- 每一个.py文件都必须包含一个Main函数，用于测试当前文件是否能正常运行。
+
+## C++
+- 代码风格遵循 Google C++ Style Guide
+-
+## 依赖
+
+## 输出
+- 输出内容必须使用简体中文
+- 输出PROJECT_STATUS.md 必须包含项目的主要功能、特性、优势、局限性等信息.包括每次更新的主要变化、优化点、新功能等。
+
 
-## 项目概述
 
+## 项目概述
 SimpleSensorSync 是一个为机器人和传感器融合系统设计的多传感器同步解决方案。它使用专用同步板为相机、激光雷达、IMU 和 GPS 等各种传感器提供精确的时间协调。
 
 ## 架构
@@ -98,4 +147,4 @@ cd build/tools/monitor
 - 主要厂商的工业相机 (PWM 同步)
 - 3D 激光雷达传感器 (PPS 同步)
 - IMU 设备 (PWM 同步)
-- GPS/RTK 系统 (NMEA 同步)
+- GPS/RTK 系统 (NMEA 同步)