csh/playbook
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

🐛 fix(tsl_syntax): repair lookup engine and reconcile reference facts

Browse Source 
lookup.py: exempt code-anchored ASCII identifiers from the mixed
zh/en gate so exact hits are no longer dropped; dedup parent/child
sections in results; validate write-prelude anchors in --check.

references: correct interpreter-verified facts (case-as-expression,
control-flow semicolons, __line__/__stack_frame, tslObjects order,
destroy timing, ErrDefine, truncated outputs), fix headings, scope
qualifiers and reversed quotes; strip dead preamble metadata from all
24 pages.

packaging: exclude __pycache__/*.pyc from playbook and bundle copies;
update build test file-count assertion to match.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
csh
2026-07-13 09:16:57 +08:00
co-authored by Claude Fable 5
parent 923bce91b0
commit b597edfc70
29 changed files with 356 additions and 256 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/tsl-syntax-reference/references/12_matrix_and_collections.md
+13 -15
View File
@@ -1,10 +1,5 @@
# TSL 数组、键表、矩阵样数据与集合运算
文档类型：语法主线
是否可直接用于生成代码：是
是否含可直接照写示例：是
是否含不可照写反例：否
这一篇收拢 `array(...)` 的扩展用法：顺序数组、字符串键表、嵌套数组、本页明确的矩阵样比较，以及 `in` / `sqlin` / `union2` / `intersect` / `minus` / `outersect` 这类去重型集合关系。
## 本篇职责
@@ -29,7 +24,7 @@
- `in` / `not in` 处理的是元素存在关系，以及左侧为数组时的子集关系。
- `sqlin` / `not sqlin` 处理的是行存在关系；左侧要当成一整行去匹配右侧结果集。
- `union2`、`intersect`、`minus`、`outersect` 都按“行”运算，而不是按单元格逐个运算。
- 集合运算结果会折叠重复行；如果需求是保留重复记录，改看 [13_resultset_and_filters.md](13_resultset_and_filters.md)。
- 集合运算结果会折叠重复行；保留重复记录的过滤规则见 [13_resultset_and_filters.md](13_resultset_and_filters.md)。
- 当数据本身就是一维数组时，按行集合运算和按元素集合运算是一致的。
- 左侧是数组时，先判定需求语义：子集关系用 `in`，整行存在关系用 `sqlin`。
@@ -137,6 +132,9 @@ writeLn(1 not in array(0, 2));
0
1
1
1
0
1
```
`sqlin` 按整行判断左侧是否存在于右侧结果集中：
@@ -198,7 +196,7 @@ outersect_rows := left_rows outersect right_rows;
- 集合运算先把数据当成“行集合”来看，再做包含、并交差。
- 过滤运算先保留“原结果集里的每一条命中记录”；因此重复行会保留下来。
- 需要“集合关系”时留在本页。
- 需要“从原表里筛出哪些行”时看 [13_resultset_and_filters.md](13_resultset_and_filters.md)。
- “从原表里筛出哪些行”的过滤规则见 [13_resultset_and_filters.md](13_resultset_and_filters.md)。
## 默认生成模板
@@ -211,7 +209,7 @@ matched := 1 in array(1, 2, 3);
row_matched := array(1, 2) sqlin array((1, 2), (3, 4));
```
### 点前缀比较算符产生逻辑数组
## 点前缀比较算符产生逻辑数组
点前缀比较（`.=`、`.<>`、`.>`、`.>=`、`.<`、`.<=`）对数组/矩阵逐元素比较，返回真假值数组：
@@ -274,7 +272,7 @@ writeLn("子集 (1,0):", subset[1][0]);
- `a[indexes]` 按下标提取对应行，等价于 `select * from a where [0] > 0.5 end`
- `mfind` 的完整用法见 [22_matrix_deep_dive.md](22_matrix_deep_dive.md)
### 非完全矩阵与缺位当 0 处理
## 非完全矩阵缺位当 0 处理与标量广播
基础算符作用于非完全矩阵（行长度不一致或字符串键不对齐的数组）时，对应位置不存在或为 `nil` 时**默认当 0 处理**：
@@ -341,15 +339,15 @@ writeLn("(1,1):", result[1][1]);
## 禁止项
- 不要把字符串下标按数组的 `0` 起始规则来写；字符串索引事实见 [03_values_and_literals.md](03_values_and_literals.md)。
- 不要把字符串下标按数组的 `0` 起始规则来写；字符串下标从 `1` 开始，详见 [03_values_and_literals.md](03_values_and_literals.md)。
- 不要把矩阵链式比较 `::...` 和标量链式比较混写成同一种语法。
- 不要把 `in` 和 `sqlin` 当成同一个概念。
- 不要期待 `union2` 保留重复行。
- 不要用集合运算去做”保留原始重复记录”的过滤任务。
- 不要把二维结果集默认当成”按元素逐个比较”的集合运算。
- 左侧数组要表达”这些值是否都属于右侧集合”时，用 `in`。
- 左侧数组要表达”这一整行是否存在于右侧结果集”时，用 `sqlin`。
- `minus` 表达集合差集；如果任务要求保留左侧原始重复次数，改走 [13_resultset_and_filters.md](13_resultset_and_filters.md) 的过滤规则。
- 不要用集合运算去做“保留原始重复记录”的过滤任务。
- 不要把二维结果集默认当成“按元素逐个比较”的集合运算。
- 左侧数组要表达“这些值是否都属于右侧集合”时，用 `in`。
- 左侧数组要表达“这一整行是否存在于右侧结果集”时，用 `sqlin`。
- `minus` 表达集合差集；保留左侧原始重复次数的过滤规则见 [13_resultset_and_filters.md](13_resultset_and_filters.md)。
- 不要在本页发明结果集过滤、TS-SQL 查询、写回语法或更大矩阵函数族。
- 不要把普通 `array(...)` 自动升级成 `FMArray`；`FMArray` 专属事实见 [23_fmarray.md](23_fmarray.md)。
- 不要把点前缀比较 `.>` 和矩阵链式比较 `::>` 混用；`.>` 返回逻辑数组，`::>` 是链式比较。