Cursor rule

1# 编码风格
2 
3## 不可变性（关键）
4 
5始终创建新对象，永远不要修改现有对象：
6 
7```
8// 伪代码
9错误:  modify(original, field, value) → 就地修改 original
10正确: update(original, field, value) → 返回带有更改的新副本
11```
12 
13原理：不可变数据防止隐藏的副作用，使调试更容易，并启用安全的并发。
14 
15## 文件组织
16 
17多个小文件 > 少量大文件：
18- 高内聚，低耦合
19- 典型 200-400 行，最多 800 行
20- 从大模块中提取工具函数
21- 按功能/领域组织，而非按类型
22 
23## 错误处理
24 
25始终全面处理错误：
26- 在每一层显式处理错误
27- 在面向 UI 的代码中提供用户友好的错误消息
28- 在服务器端记录详细的错误上下文
29- 永远不要静默吞掉错误
30 
31## 输入验证
32 
33始终在系统边界验证：
34- 处理前验证所有用户输入
35- 在可用的情况下使用基于模式的验证
36- 快速失败并给出清晰的错误消息
37- 永远不要信任外部数据（API 响应、用户输入、文件内容）
38 
39## 代码质量检查清单
40 
41在标记工作完成前：
42- [ ] 代码可读且命名良好
43- [ ] 函数很小（<50 行）
44- [ ] 文件聚焦（<800 行）
45- [ ] 没有深层嵌套（>4 层）
46- [ ] 正确的错误处理
47- [ ] 没有硬编码值（使用常量或配置）
48- [ ] 没有变更（使用不可变模式）
49