📝 docs(tsl): restructure agent-facing reference

Rework TSL syntax, catalog, modules, and routing docs around deterministic agent lookup and generation.

Split large catalog pages into focused function fact pages, remove obsolete pending/verified/unavailable paths, and update consistency tests for the new structure.
This commit is contained in:
csh
2026-06-09 17:24:30 +08:00
parent 9c194170a1
commit 540b3c0a1b
192 changed files with 32929 additions and 13533 deletions
+20 -48
View File
@@ -1,59 +1,31 @@
# 图形函数
这一页只负责函数定位:先按主题找到模块,再在页内搜索函数名。
文档类型:函数事实路由页
是否可直接用于生成代码:是;进入分类详情页后按函数事实条目生成调用
遇到不确定时:回到 [../index.md](../index.md)、[../../syntax/index.md](../../syntax/index.md)
## 候选函数索引说明
- 本页是候选函数索引,只说明函数名被归入当前模块。
- 候选名没有进入 verified 函数页前不能当成可调用事实。
- 生成代码前必须先查 [../verified/index.md](../verified/index.md);只从 verified 函数页读取参数类型。
## 使用方式
- 返回总目录:[catalog/index.md](index.md)
- 需要基础语法时回到 [../../syntax/index.md](../../syntax/index.md)
- 需要金融任务组织方式时回到 [../../finance/index.md](../../finance/index.md)
这一页是图形函数的轻量入口,不直接承载全部函数事实。生成函数调用时,先按分类目录进入详情页,再只读取命中的函数条目和参数表。
## 模块范围
- 说明:图表、绘图与可视化相关函数
- 主题数:3
- 函数数:27
- 函数事实数:87
## 主题目录
## 智能体检索规则
### 作图函数
1. 用户只描述能力时,先按“分类目录”选择候选详情页。
2. 用户给出函数名时,优先在 `graphics/` 子目录中搜索三级函数标题。
3. 只读取命中的函数条目、相邻分类标题和必要参数表;不要把同页其它函数混进当前调用。
4. 没有命中函数事实条目时,不要发明函数名;回到 [../index.md](../index.md) 或项目实际代码确认。
- `Graph`
- `GraphGroup`
- `MergeGraph`
- `EncodeGraphGroup`
- `DecodeGraphGroup`
- `DecodeGraph`
- `EncodeGraph`
- `FastLine_Web`
- `GetColorByIndex`
## 分类目录
### 图形字段函数
- `gfColor`
- `gfFill`
- `gfFlag`
- `gfZero`
- `gfMaxValue`
- `gfMinValue`
- `gfLTP`
- `gfTitleCaption`
- `gfLeftTitleCaption`
- `gfCoordinate`
### 图形填充设置函数
- `flSolid`
- `flClear`
- `flHorizontal`
- `flVertical`
- `flFDiagonal`
- `flBDiagonal`
- `flCross`
- `flDiagCross`
| 分类 | 详情页 | 函数事实数 |
| ---------------- | ---------------------------------------------------------------- | ---------: |
| 作图函数 | [graphics/01_drawing.md](graphics/01_drawing.md) | 7 |
| 图形字段函数 | [graphics/02_graph_fields.md](graphics/02_graph_fields.md) | 22 |
| 图形填充设置函数 | [graphics/03_graph_fill.md](graphics/03_graph_fill.md) | 8 |
| 图形类型函数 | [graphics/04_graph_types.md](graphics/04_graph_types.md) | 7 |
| 图形标示函数 | [graphics/05_graph_markers.md](graphics/05_graph_markers.md) | 9 |
| 颜色函数 | [graphics/06_color.md](graphics/06_color.md) | 22 |
| 颜色变换函数 | [graphics/07_color_transform.md](graphics/07_color_transform.md) | 12 |