@comate/zulu 1.4.0-beta.2 → 1.4.0-beta.4

package/comate-engine/assets/skills/code-review/references/rules/Js/JS_STYLE_RULES.md

@@ -0,0 +1,350 @@
+# JavaScript/TypeScript 规范类规则
+
+格式与代码风格规则，来源于 JAVASCRIPT_SMELL_LIST_details.md（共35条）。
+
+---
+
+### JS 通用规则
+
+#### 1. no-trailing-spaces - 禁止行尾空白 [Critical]
+**描述**：不允许在行尾出现空白字符（空格或制表符）。
+
+#### 2. quotes - 引号风格 [Critical]
+**描述**：强制使用单引号（`'`），只有在字符串本身包含单引号时才允许使用双引号转义。
+
+```javascript
+// 错误写法
+const str = "hello";
+const msg = "it's a test";
+
+// 正确写法
+const str = 'hello';
+const msg = 'it\'s a test';
+```
+
+#### 3. semi - 分号要求 [Critical]
+**描述**：要求每条语句后面必须使用分号（`;`）结尾。
+
+#### 4. max-len - 行长度限制 [Critical]
+**描述**：每行代码不得超过120个字符（URL除外）。
+
+#### 5. curly - 花括号要求 [Critical]
+**描述**：所有控制语句（`if`、`else`、`for`、`while`、`do`）都必须使用花括号包裹语句体，即使只有一行代码。
+
+```javascript
+// 错误写法
+if (condition) doSomething();
+for (let i = 0; i < 10; i++) console.log(i);
+
+// 正确写法
+if (condition) {
+    doSomething();
+}
+for (let i = 0; i < 10; i++) {
+    console.log(i);
+}
+```
+
+#### 6. comma-dangle - 尾逗号规则 [Critical]
+**描述**：多行数组、对象、导入、导出必须使用尾逗号；函数参数不允许使用尾逗号。
+
+```javascript
+// 错误写法 — 多行对象缺少尾逗号
+const obj = {
+    a: 1,
+    b: 2
+};
+
+// 正确写法 — 多行必须有尾逗号
+const obj = {
+    a: 1,
+    b: 2,
+};
+
+// 正确写法 — 单行无需尾逗号
+const arr = [1, 2, 3];
+```
+
+#### 7. no-multi-spaces - 禁止多个连续空格 [Critical]
+**描述**：不允许在代码中出现多个连续的空格（行尾注释前的空格和对象属性对齐除外）。
+
+#### 8. comma-spacing - 逗号空格 [Critical]
+**描述**：逗号前不允许有空格，逗号后必须有一个空格。
+
+```javascript
+// 错误写法
+const arr = [1,2,3];
+foo(1,2 ,3);
+
+// 正确写法
+const arr = [1, 2, 3];
+foo(1, 2, 3);
+```
+
+#### 9. space-infix-ops - 运算符空格 [Critical]
+**描述**：二元运算符（`+`, `-`, `*`, `/`, `=`, `==`, `===`, `!=`, `!==`, `<`, `>`, `<=`, `>=` 等）两侧必须有空格。
+
+```javascript
+// 错误写法
+const x = 1+2*3;
+if (a===b) {}
+
+// 正确写法
+const x = 1 + 2 * 3;
+if (a === b) {}
+```
+
+#### 10. space-before-function-paren - 函数括号前空格 [Critical]
+**描述**：匿名函数（箭头函数、function表达式）的括号前必须有空格；命名函数声明的括号前不允许有空格。
+
+```javascript
+// 错误写法
+const foo = function() {};   // 匿名函数缺少空格
+function test () {}          // 命名函数多余空格
+
+// 正确写法
+const foo = function () {};
+function test() {}
+```
+
+#### 11. spaced-comment - 注释空格 [Critical]
+**描述**：注释标记（`//` 或 `/*`）后必须有一个空格。
+
+#### 12. key-spacing - 对象键空格 [Critical]
+**描述**：对象字面量的冒号前不允许有空格，冒号后必须有一个空格。
+
+```javascript
+// 错误写法
+const obj = {a :1, b : 2};
+
+// 正确写法
+const obj = {a: 1, b: 2};
+```
+
+#### 13. keyword-spacing - 关键字空格 [Critical]
+**描述**：关键字（`if`, `else`, `for`, `while`, `do`, `switch`, `case`, `break`, `continue`, `return`, `try`, `catch`, `finally`, `throw`, `typeof`, `instanceof`, `new`, `delete`, `void`, `in`, `await`, `async` 等）前后必须有空格。
+
+```javascript
+// 错误写法
+if(condition) {}
+for(let i = 0; i < 10; i++) {}
+
+// 正确写法
+if (condition) {}
+for (let i = 0; i < 10; i++) {}
+```
+
+#### 14. object-curly-spacing - 对象花括号空格 [Critical]
+**描述**：对象字面量的花括号内部不允许有空格（使用 `never` 配置，`{a: 1}` 而非 `{ a: 1 }`）。
+
+```javascript
+// 错误写法
+const obj = { a: 1, b: 2 };
+
+// 正确写法
+const obj = {a: 1, b: 2};
+```
+
+#### 15. dot-notation - 点号访问 [Critical]
+**描述**：强制使用点号访问对象属性，仅当属性名包含特殊字符或使用变量时才允许使用方括号语法。
+
+```javascript
+// 错误写法
+const name = user['name'];
+
+// 正确写法
+const name = user.name;
+const value = obj['special-key'];  // 含特殊字符，允许方括号
+const key = 'age';
+const val = person[key];           // 动态变量，允许方括号
+```
+
+#### 16. space-before-blocks - 代码块前空格 [Critical]
+**描述**：代码块（`{}`）前必须有一个空格。
+
+```javascript
+// 错误写法
+if (condition){}
+function test(){}
+
+// 正确写法
+if (condition) {}
+function test() {}
+```
+
+#### 17. arrow-parens - 箭头函数参数括号 [Critical]
+**描述**：仅在需要时使用箭头函数参数的括号（单个参数时省略括号，零个或多个参数时保留括号）。
+
+```javascript
+// 错误写法
+const add = (a) => a + 1;   // 单参数不应有括号
+
+// 正确写法
+const add = a => a + 1;
+const sum = (a, b) => a + b;
+const greet = () => 'Hello';
+```
+
+#### 18. max-statements-per-line - 每行最多语句数 [Critical]
+**描述**：每行只允许一条语句。
+
+#### 19. eqeqeq - 严格相等比较 [Critical]
+**描述**：必须使用严格相等（`===`）和严格不等（`!==`），禁止使用宽松相等（`==`）和不等（`!=`）。`null` 比较时忽略此规则。
+
+```javascript
+// 错误写法
+if (name == 'John') {}
+if (count != 0) {}
+
+// 正确写法
+if (name === 'John') {}
+if (count !== 0) {}
+if (value == null) {}  // null 比较时例外，允许同时匹配 null/undefined
+```
+
+#### 20. operator-linebreak - 运算符换行 [Critical]
+**描述**：运算符换行时，运算符必须放在行的开头（不是结尾）。
+
+```javascript
+// 错误写法
+const result = veryLongVariable +
+               anotherLongVariable;
+
+// 正确写法
+const result = veryLongVariable
+               + anotherLongVariable;
+```
+
+#### 21. no-mixed-spaces-and-tabs - 禁止混用空格和Tab [Critical]
+**描述**：不允许在缩进中混用空格和制表符（Tab）。
+
+#### 22. arrow-spacing - 箭头函数箭头空格 [Critical]
+**描述**：箭头函数的箭头（`=>`）前后必须各有一个空格。
+
+```javascript
+// 错误写法
+const add = (a, b)=>a + b;
+const multiply = (x, y) =>x * y;
+
+// 正确写法
+const add = (a, b) => a + b;
+```
+
+#### 23. no-confusing-arrow - 禁止混淆箭头函数 [Critical]
+**描述**：禁止使用可能与比较运算符混淆的箭头函数（如 `x => x === y`），建议使用括号区分（如 `x => (x === 0)`）。
+
+```javascript
+// 错误写法 — => 与比较运算符视觉上易混淆
+const isZero = x => x === 0;
+const isPositive = x => x > 0;
+
+// 正确写法 — 加括号明确是箭头函数返回值
+const isZero = x => (x === 0);
+const isPositive = x => (x > 0);
+```
+
+#### 24. radix - parseInt 必须指定基数 [Critical]
+**描述**：使用 `parseInt()` 时必须指定第二个参数（基数），如 `parseInt('10', 10)`。
+
+```javascript
+// 错误写法
+const num = parseInt('10');
+
+// 正确写法
+const num = parseInt('10', 10);
+const hex = parseInt('ff', 16);
+```
+
+---
+
+### Vue 规则
+
+#### 25. vue/max-attributes-per-line - 每行最多属性数 [Critical]
+**描述**：单行标签最多2个属性，多行标签每行最多2个属性。
+
+```html
+<!-- 错误写法 — 超过2个属性未换行 -->
+<MyComponent id="app" class="container" title="Hello" @click="handleClick" />
+
+<!-- 正确写法 — 多属性时每行最多2个 -->
+<MyComponent
+    id="app" class="container"
+    title="Hello" @click="handleClick"
+/>
+```
+
+#### 26. vue/html-closing-bracket-newline - HTML闭合括号换行 [Critical]
+**描述**：单行标签的闭合括号在同一行；多行标签的闭合括号单独占一行。
+
+```html
+<!-- 错误写法 — 多行标签的 > 不应缩进在属性后 -->
+<MyComponent
+    id="app"
+    class="container"
+    >
+
+<!-- 正确写法 — 多行标签的 > 单独占一行顶格 -->
+<MyComponent
+    id="app"
+    class="container"
+>
+```
+
+#### 27. vue/attribute-hyphenation - Vue属性命名 [Critical]
+**描述**：自定义组件的属性名必须使用短横线命名法（kebab-case）。
+
+```html
+<!-- 错误写法 -->
+<MyComponent userName="John" maxCount="10" />
+
+<!-- 正确写法 -->
+<MyComponent user-name="John" max-count="10" />
+```
+
+#### 28. vue/no-unused-refs - 禁止未使用的ref [Critical]
+**描述**：禁止声明但未使用的 ref 引用。
+
+#### 29. vue/mustache-interpolation-spacing - 插值空格 [Critical]
+**描述**：Mustache 插值表达式中的花括号内部必须有单个空格（`{{ message }}`）。
+
+#### 30. vue/no-unused-vars - 禁止未使用的v-for变量 [Critical]
+**描述**：禁止在 `v-for` 中声明但未使用的变量。
+
+#### 31. vue/no-multiple-template-root - 禁止多个模板根元素 [Critical]
+**描述**：Vue 2 的模板只能有一个根元素；Vue 3 允许多个根元素但此规则强制要求单一根元素。
+
+#### 32. vue/html-button-has-type - 按钮必须有type属性 [Critical]
+**描述**：`<button>` 元素必须显式指定 `type` 属性（button/submit/reset）。
+
+---
+
+### React 规则
+
+#### 33. react/jsx-indent - JSX缩进 [Critical]
+**描述**：JSX 元素必须使用4个空格缩进。
+
+```jsx
+// 错误写法（2空格）
+<div>
+  <span>Text</span>
+</div>
+
+// 正确写法（4空格）
+<div>
+    <span>Text</span>
+</div>
+```
+
+---
+
+### San 规则
+
+#### 34. san/html-indent - HTML缩进 [Critical]
+**描述**：San 模板中的 HTML 元素使用4个空格缩进（配置：4空格，attribute: 1, baseIndent: 1, closeBracket: 0）。
+
+---
+
+### CSS 规则
+
+#### 35. rule-empty-line-before - 规则前空行 [Critical]
+**描述**：CSS 规则（选择器块）之间需要空行分隔。

package/comate-engine/assets/skills/code-review/references/rules/Python/PYTHON_AUTH_RULES.md

@@ -0,0 +1,38 @@
+# Python 接口鉴权规则
+
+检测对外接口的鉴权缺失与越权访问风险。
+
+---
+
+### AUTH_PY_01. 对外接口缺少鉴权 [high]
+- **检测**：Flask/Django/FastAPI 路由定义无 `@login_required`/`@require_auth`/JWT 验证，且非公开接口
+- **排除**：健康检查/登录/静态资源；全局中间件/装饰器统一鉴权
+
+### AUTH_PY_02. 越权访问 - 未校验资源归属 [high]
+- **检测**：接口通过 request 参数获取资源 ID，未校验该资源是否属于当前登录用户
+- **排除**：管理员接口有角色校验；公共资源
+
+### AUTH_PY_03. 身份校验逻辑错误 [high]
+- **检测**：用 `==` 而非 `hmac.compare_digest` 等时序安全比较做 token 校验；校验变量来自请求参数而非已验证的会话
+
+```python
+# 错误写法 — 普通 == 比较存在时序攻击风险，且变量来自请求
+token = request.args.get('token')
+if token == SECRET_TOKEN: ...
+
+# 正确写法
+import hmac
+if hmac.compare_digest(token, SECRET_TOKEN): ...
+```
+
+### AUTH_PY_04. 鉴权中间件配置遗漏 [middle]
+- **检测**：部分路由/蓝图未被鉴权中间件覆盖
+- **排除**：有全局 before_request 统一鉴权
+
+### AUTH_PY_05. 垂直越权 - 敏感操作缺少角色校验 [high]
+- **检测**：管理员级别操作缺少 `current_user.is_admin` 或权限校验
+- **排除**：RBAC 中间件统一处理
+
+---
+
+**通用排除**：健康检查/登录/Webhook；全局中间件；框架内置权限管理（Django permissions、FastAPI Dependencies）

package/comate-engine/assets/skills/code-review/references/rules/Python/PYTHON_CORRECTNESS_RULES.md

@@ -0,0 +1,255 @@
+# Python 正确性规则
+
+静态模式可识别的确定性错误，单次执行可触发。
+
+---
+
+## 一、空值与类型安全（7项）
+
+### CORRECTNESS_PY_01. 对 None 对象进行属性或方法调用 [Critical]
+- **检测**：函数返回值可能为 None 时直接调用属性/方法，触发 `AttributeError`；`re.search()` 结果未判断
+- **排除**：有 `if result:` 或 `if x is not None:` 检查
+
+### CORRECTNESS_PY_02. 空集合首元素访问 [Critical]
+- **检测**：`users[0]` 在可能为空列表时；`min([])`/`max([])` 空集合；`first, *rest = []` 空列表解包
+- **排除**：有 `if users:` 检查；有长度验证
+
+### CORRECTNESS_PY_03. 列表索引越界访问 [Critical]
+- **检测**：`parts[2]` 等硬编码索引未校验长度；循环边界 `range(len(arr)+1)` 越界
+- **排除**：有 `len()` 检查
+
+### CORRECTNESS_PY_04. 字典键不存在错误 [Critical]
+- **检测**：`data["key"]` 直接访问可能不存在的键，触发 `KeyError`；`os.environ["KEY"]` 未配置时崩溃
+- **排除**：已用 `.get(key, default)`；已有 `key in dict` 检查
+
+### CORRECTNESS_PY_05. 类型不匹配运算错误 [Critical]
+- **检测**：字符串与数字拼接 `"text: " + count`；None 参与算术运算；列表与非列表 `+` 操作
+- **排除**：有类型转换
+
+### CORRECTNESS_PY_06. 解包数量不匹配 [Critical]
+- **检测**：`x, y, z = line.split(",")` 但分割结果可能不足3个；数据库行列数与解包变量数不一致
+- **排除**：有长度检查；使用 `*rest` 弹性解包
+
+### CORRECTNESS_PY_07. 对 None 或非可迭代对象迭代 [Critical]
+- **检测**：`for item in get_items()` 但函数可能返回 None；`for x in data.get("records")` 字段可能为 null
+- **排除**：已用 `for item in (get_items() or [])` 等保护
+
+---
+
+## 二、数据结构操作错误（5项）
+
+### CORRECTNESS_PY_08. 可变对象作为函数默认参数 [Critical]
+- **检测**：`def f(items=[])` 或 `def f(config={})` —— 默认参数共享同一对象，多次调用互相污染
+
+```python
+def add_item(item, items=[]):  # 错误：每次调用共享同一 items
+    items.append(item)
+    return items
+# 正确：items=None，函数内 if items is None: items = []
+```
+
+### CORRECTNESS_PY_09. 迭代列表时修改列表 [Critical]
+- **检测**：for-each 遍历时 `list.remove(item)` 或 `del list[i]`，导致跳过元素；迭代字典时 `del dict[key]` 抛 RuntimeError
+- **排除**：用列表推导式/`removeIf` 等安全方式
+
+### CORRECTNESS_PY_10. 在哈希集合中使用可变对象 [Critical]
+- **检测**：`set.add([1,2])` 或 `{[1]:v}` —— list/dict 不可哈希，触发 TypeError
+- **排除**：已改用 tuple
+
+### CORRECTNESS_PY_11. 使用 is 比较数值/字符串 [Critical]
+- **检测**：`if a is 1000:` —— is 比较内存地址，小整数池外返回 False，应用 `==`
+- **排除**：`is None`/`is not None` 是正确用法
+
+### CORRECTNESS_PY_12. 闭包循环变量捕获陷阱 [Critical]
+- **检测**：`[lambda: i for i in range(5)]` —— 所有 lambda 捕获同一变量引用，执行时都是最终值
+- **排除**：已用默认参数固定值 `lambda i=i: i`
+
+```python
+# 错误写法 — 全部输出 4
+funcs = [lambda: i for i in range(5)]
+print(funcs[0]())  # 4，不是 0
+
+# 正确写法 — 用默认参数固定值
+funcs = [lambda i=i: i for i in range(5)]
+print(funcs[0]())  # 0
+```
+
+---
+
+## 三、异常处理错误（6项）
+
+### CORRECTNESS_PY_13. 捕获所有异常隐藏真实错误 [Critical]
+- **检测**：`except:` 裸异常或 `except Exception: pass` 吞掉所有错误，包括 KeyboardInterrupt；捕获后返回默认值隐藏错误
+- **排除**：有充分日志；顶层框架兜底处理且已记录
+
+### CORRECTNESS_PY_14. 异常后资源未清理 [Critical]
+- **检测**：`lock.acquire()` 后无 try-finally，异常时锁未释放
+- **排除**：已用 `with` 上下文管理器
+
+### CORRECTNESS_PY_15. 静默忽略异常（except pass）[Critical]
+- **检测**：`except SomeError: pass` 捕获后完全不处理，后续代码可能使用未定义变量
+
+### CORRECTNESS_PY_16. finally 中 return 覆盖异常 [Critical]
+- **检测**：`finally: return None` 覆盖 try 块中抛出的异常，异常消失
+
+### CORRECTNESS_PY_17. JSON 序列化不支持的对象 [Critical]
+- **检测**：`json.dumps` 包含 datetime/Decimal/自定义对象，触发 TypeError
+- **排除**：有自定义 JSONEncoder；已序列化为基础类型
+
+### CORRECTNESS_PY_18. assert 用于业务逻辑校验 [Critical]
+- **检测**：`assert amount > 0` 用于业务规则校验，Python -O 优化模式下 assert 被移除失效
+- **排除**：assert 仅用于开发期内部不变式断言
+
+---
+
+## 四、静态检查：参数与变量错误（9项）
+
+### CORRECTNESS_PY_19. 访问未定义变量 [Critical]
+- **检测**：使用了从未声明的变量名，触发 NameError；条件分支中部分路径未赋值就使用
+
+### CORRECTNESS_PY_20. 访问未赋值的局部变量 [Critical]
+- **检测**：局部变量在 try/except 的 except 分支中未赋值就在函数末尾使用，触发 UnboundLocalError
+
+```python
+# 错误写法 — except 分支没有给 result 赋值
+def get_data():
+    try:
+        result = fetch()
+    except NetworkError:
+        log_error()   # result 未赋值
+    return result     # UnboundLocalError！
+
+# 正确写法
+def get_data():
+    result = None     # 先赋初始值
+    try:
+        result = fetch()
+    except NetworkError:
+        log_error()
+    return result
+```
+
+### CORRECTNESS_PY_21. 调用函数时缺少必要参数 [Critical]
+- **检测**：传入位置参数少于函数定义的必要参数数量，触发 TypeError
+
+### CORRECTNESS_PY_22. 调用函数时传递参数过多 [Critical]
+- **检测**：传入位置参数多于函数定义的参数数量，触发 TypeError
+
+### CORRECTNESS_PY_23. 重复传递关键字参数 [Critical]
+- **检测**：同一参数通过位置和关键字两种方式传递，触发 TypeError
+
+### CORRECTNESS_PY_24. 函数参数名重复定义 [Critical]
+- **检测**：`def f(x, y, x)` 参数名重复，触发 SyntaxError
+
+### CORRECTNESS_PY_25. 实例方法缺少 self 参数 [Critical]
+- **检测**：类中实例方法第一个参数（self）缺失，调用时触发 TypeError
+
+### CORRECTNESS_PY_26. __all__ 中引用未定义变量 [Critical]
+- **检测**：`__all__` 列表包含模块中不存在的名称
+
+### CORRECTNESS_PY_27. 实例成员在赋值前被访问 [Critical]
+- **检测**：`__init__` 中先调用方法再赋值属性，方法中访问了尚未赋值的 self 属性
+
+```python
+# 错误写法 — setup() 访问 self.config，但此时尚未赋值
+class Service:
+    def __init__(self):
+        self.setup()          # setup 中访问 self.config
+        self.config = {}      # 赋值在 setup 之后
+
+    def setup(self):
+        print(self.config)    # AttributeError: 'Service' has no attribute 'config'
+
+# 正确写法 — 先赋值再调用
+class Service:
+    def __init__(self):
+        self.config = {}
+        self.setup()
+```
+
+---
+
+## 五、静态检查：格式化字符串（4项）
+
+### CORRECTNESS_PY_28. 格式化字符串参数过多/过少 [Critical]
+- **检测**：`%` 格式化提供的参数个数与占位符数量不符，触发 TypeError
+
+### CORRECTNESS_PY_29. 不支持的格式化字符 [Critical]
+- **检测**：`%q`/`%h` 等不受支持的格式符，触发 ValueError
+
+### CORRECTNESS_PY_30. 格式化字符串不完整 [Critical]
+- **检测**：`"Value: %"` 格式符不完整，触发 ValueError
+
+### CORRECTNESS_PY_31. 对不支持下标访问的对象使用下标 [Critical]
+- **检测**：对整数/None/set 使用 `[]`，触发 TypeError；`slice` 索引非整数触发 TypeError
+
+---
+
+## 六、静态检查：OOP 错误（5项）
+
+### CORRECTNESS_PY_32. 实例化抽象类 [Critical]
+- **检测**：直接实例化含未实现抽象方法的 ABCMeta 类，触发 TypeError
+
+### CORRECTNESS_PY_33. 继承非类对象 [Critical]
+- **检测**：继承函数/None/实例而非类，触发 TypeError
+
+### CORRECTNESS_PY_34. 类 MRO 解析顺序不一致 [Critical]
+- **检测**：多重继承中基类顺序冲突，无法确定 MRO，触发 TypeError
+
+### CORRECTNESS_PY_35. 错误使用 NotImplemented 代替 NotImplementedError [Critical]
+- **检测**：`raise NotImplemented` —— NotImplemented 是常量非异常，应用 `raise NotImplementedError`
+
+### CORRECTNESS_PY_36. break/continue 在循环外使用 [Critical]
+- **检测**：`break`/`continue` 出现在函数体或模块顶层而非循环内，触发 SyntaxError
+
+---
+
+## 七、静态检查：控制流（3项）
+
+### CORRECTNESS_PY_37. return 在函数外使用 [Critical]
+- **检测**：`return` 出现在模块级或类定义外，触发 SyntaxError；缩进错误导致 return 跑出方法
+
+### CORRECTNESS_PY_38. continue 在 finally 中使用 [Critical]
+- **检测**：`finally: continue` 抑制异常（3.8+语法合法但语义危险）；3.7及以下为 SyntaxError
+
+### CORRECTNESS_PY_39. except 捕获顺序不当 [Critical]
+- **检测**：通用异常（Exception）在具体异常（ValueError）之前，导致具体处理永不执行
+
+---
+
+## 八、数据处理错误（2项）
+
+### CORRECTNESS_PY_40. 除零错误未处理 [Critical]
+- **检测**：除法操作未检查除数为 0，触发 ZeroDivisionError
+- **排除**：有 `if count != 0:` 检查；有 try-except ZeroDivisionError
+
+### CORRECTNESS_PY_41. 字符串编码解码错误 [Critical]
+- **检测**：字节流按错误编码（如 utf-8 解码 GBK 数据），触发 UnicodeDecodeError
+- **排除**：有 `errors='ignore'/'replace'` 参数；有编码检测
+
+---
+
+## 九、其他（1项）
+
+### CORRECTNESS_PY_42. __len__ 返回非负整数 [Critical]
+- **检测**：`__len__` 方法返回负数、浮点数或 None，触发 ValueError/TypeError
+
+```python
+# 错误写法 — 返回负数
+class MyList:
+    def __len__(self):
+        return -1        # ValueError: __len__() should return >= 0
+
+# 错误写法 — 返回浮点数
+class MyList:
+    def __len__(self):
+        return 1.5       # TypeError: 'float' object cannot be interpreted as an integer
+
+# 正确写法
+class MyList:
+    def __init__(self):
+        self._items = []
+
+    def __len__(self):
+        return len(self._items)  # 返回非负整数
+```