🎨 style(markdown): format markdown files

2026-01-11 12:58:27 +08:00
parent e3ecd26a88
commit 2b37860331
54 changed files with 10042 additions and 16272 deletions
@@ -65,19 +65,23 @@ std::cout << "Elapsed: " << elapsed.count() << "ms\n";
 ### 3. 优化策略（从高收益到低收益）

 **3.1 算法级（优先级最高）**
+
 - 降低复杂度：`O(n^2)` → `O(n log n)` → `O(n)`
 - 避免重复计算：缓存、记忆化

 **3.2 数据结构级**
+
 - 选择合适容器：数组 vs 哈希表 vs 树
 - 预分配容量，减少扩容

 **3.3 循环级**
+
 - 循环内不做 I/O
 - 循环内避免重复解析/格式化
 - 提前计算循环不变量

 **3.4 I/O 级**
+
 - 批量读写（减少系统调用）
 - 缓存（明确 TTL 与容量上限）

@@ -25,6 +25,7 @@ description: "测试策略与最佳实践（TSL/Python/C++）：单元测试→
 - 一个测试只验证一个行为点

 **命名示例**：
+
 - `test_add_positive_numbers_returns_sum`
 - `test_add_with_zero_returns_other_number`

@@ -45,13 +46,13 @@ description: "测试策略与最佳实践（TSL/Python/C++）：单元测试→

 ## 何时补测试

-| 场景 | 是否需要测试 | 测试类型 |
-|------|-------------|---------|
-| 新功能 | ✅ 必须 | 单元 + 集成 |
-| Bug 修复 | ✅ 必须 | 回归 |
-| 重构 | ✅ 必须 | 运行现有测试 |
-| 文档/注释 | ❌ 不需要 | - |
-| 格式调整 | ❌ 不需要 | - |
+| 场景      | 是否需要测试 | 测试类型     |
+| --------- | ------------ | ------------ |
+| 新功能    | ✅ 必须      | 单元 + 集成  |
+| Bug 修复  | ✅ 必须      | 回归         |
+| 重构      | ✅ 必须      | 运行现有测试 |
+| 文档/注释 | ❌ 不需要    | -            |
+| 格式调整  | ❌ 不需要    | -            |

 ## 测试可维护性原则

@@ -92,6 +92,7 @@ col_0 := matrix[:, 0];

 **文件**：`references/primer.md`
 **内容**：
+
 - 变量/常量、类型与字面量
 - 数组与表数组表达
 - 运算符与表达式
@@ -108,6 +109,7 @@ col_0 := matrix[:, 0];

 **文件**：`references/advanced.md`
 **内容**：
+
 - Unit/Namespace/函数文件与调用优先级
 - Class/Object 模型（继承/override/Create/Destroy）
 - 扩展语法：矩阵、集合运算、结果集过滤
@@ -123,10 +125,12 @@ col_0 := matrix[:, 0];

 **文件**：`references/functions_index.md`
 **内容**：
+
 - 函数库分类索引与检索策略
 - 对应权威目录：`docs/tsl/syntax_book/function/tsl/index.md`

 **重要说明**：
+
 - 函数库已拆分为 `docs/tsl/syntax_book/function/` 多文件，**禁止整目录加载**
 - 优先在 `docs/tsl/syntax_book/function/tsl/` 下分文件检索

@@ -169,6 +173,7 @@ col_0 := matrix[:, 0];
  3. 只读取相关函数片段（≤100 行）

 **检索示例**：
+
 ```bash
 rg -n "\\bTrim\\b" docs/tsl/syntax_book/function/tsl/base.md
 rg -n "^######\s+FileExists" docs/tsl/syntax_book/function/tsl/resource.md
@@ -74,17 +74,17 @@ var d: integer;    // 类型可写可省（类型信息不做强校验）

 常见类型（参考 `01_language_basics.md`）：

-| 类型 | 说明 |
-|------|------|
-| Integer / Int64 | 整数 |
-| Real | 浮点数 |
-| Boolean | 布尔值（true/false） |
-| TDateTime | 日期时间 |
-| String | 字符串 |
-| Binary | 二进制 |
-| Array | 数组 |
-| Matrix / TMatrix | 矩阵 |
-| NIL | 空值 |
+| 类型             | 说明                 |
+| ---------------- | -------------------- |
+| Integer / Int64  | 整数                 |
+| Real             | 浮点数               |
+| Boolean          | 布尔值（true/false） |
+| TDateTime        | 日期时间             |
+| String           | 字符串               |
+| Binary           | 二进制               |
+| Array            | 数组                 |
+| Matrix / TMatrix | 矩阵                 |
+| NIL              | 空值                 |

 示例：