修复 §19 端点编号检查的误报：按表格块识别，而不是"整章所有表格行"

## 问题

`test_real_document_has_no_duplicate_endpoint_ids` 失败，报 7 处"首列无法识别"：
`**场外基金**`、`**场外运营**`、`**客户入驻**`、`**推广材料**`、`**访客令牌**`、
`**账户与交易**`、`段`。

查下去发现**文档没错、工具错了**：§19 里除端点总目录外，还有一张
「段 / 前缀 / 挂载来源 / 权限口径」的**说明表**（`docs/05` 行 1207 起）。它的首列是
分组名、表头是 `段` 而不是 `编号`。工具早期实现把**整章所有表格行**都当端点表扫，
于是那张说明表的 6 个分组名 + 1 个表头被报成结构异常。

**误报比漏报更伤**：这个脚本存在的意义是抓"编号被复用"（2026-09-12 真的发生过
`A034`/`A035` 各出现两次），可一旦它平时就在报噪声，真出问题时会被当成噪声忽略。

## 改法

`collect_rows` 改为**按表格块**识别：

- 表格块的第一行是表头；**只有表头首列是 `编号`** 的表格才是端点总目录；
- 其它表格整体跳过并**计数** —— 跳过几张表会打印出来，所以"忽略了什么"是可见的，
  不是静默的；
- 端点表**内部**形状不对的首列**仍然报出来** —— 那才是真正的结构异常。

于是"§19 覆盖"这行现在长这样：

    §19 覆盖：93 个端点编号 / 9 个号段（A×49、AD×11、C×7、K×4、M×4、O×3、P×2、R×4、T×9）；跳过 1 张非端点表

跳过的表被显式写出来，覆盖范围仍然可核对 —— 这是原实现"不枚举前缀白名单、
把扫到的号段一并打印"那套自检思路的延续。

## 测试

`test_real_document_actually_scans_enough_endpoints` 因 `collect_rows` 返回值从
2 元组变 3 元组而需要同步；顺便**加了一条断言守住新行为**：
`skipped >= 1`，即"§19 的说明表确实被识别为独立表格块并跳过" —— 否则那几个分组名
会重新变成误报，而这条测试会先失败。

## 实测

- `python tools/check_docs_endpoint_ids.py` -> **exit 0**
  「93 个端点编号 / 9 个号段；跳过 1 张非端点表 / 端点编号无重复」
- `pytest tests/unit tests/contract` -> **1428 passed, 2 skipped, 1 failed**
  （剩下的 1 个是投顾工作台 `index.html` 被整体替换成自包含静态页所致，
  属产品决策，见前述说明）
- `ruff check` -> All checks passed

tests/unit/tools/test_docs_endpoint_ids.py

@@ -54,9 +54,15 @@ def test_real_document_has_no_duplicate_endpoint_ids() -> None:
 def test_real_document_actually_scans_enough_endpoints() -> None:
     """防止脚本坏掉后"什么都没扫到"却报通过。"""
     module = _load_tool_module()
-    ids, _ = module.collect_rows(module.read_section())
+    # 返回值是三元组：编号、无法识别的首列、跳过的非端点表数量
+    ids, _, skipped = module.collect_rows(module.read_section())
     assert len(ids) >= MIN_REAL_ENDPOINTS
     assert len(set(ids)) == len(ids)
+    # §19 除端点总目录外，还有一张「段 / 前缀 / 挂载来源 / 权限口径」的说明表。
+    # 它必须被识别为**非**端点表并跳过 —— 否则那 6 个分组名
+    # （`**场外基金**` 等）会被误报成"首列无法识别"，而误报会让这个检查
+    # 失去可信度（真出问题时会被当成噪声忽略）。
+    assert skipped >= 1, "§19 的说明表没有被识别为独立表格块"
 
 
 def test_duplicate_endpoint_id_is_detected(tmp_path: Path) -> None: