📝 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.
2026-06-09 17:24:30 +08:00
parent 9c194170a1
commit 540b3c0a1b
192 changed files with 32929 additions and 13533 deletions
@@ -1,189 +1,33 @@
 # 资源访问函数

-这一页只负责函数定位：先按主题找到模块，再在页内搜索函数名。
+文档类型：函数事实路由页
+是否可直接用于生成代码：是；进入分类详情页后按函数事实条目生成调用
+遇到不确定时：回到 [../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)
+这一页是资源访问函数的轻量入口，不直接承载全部函数事实。生成函数调用时，先按分类目录进入详情页，再只读取命中的函数条目和参数表。

 ## 模块范围

 - 说明：文件、数据库、网络与外部资源访问
- 主题数：10
- 函数数：136
+- 函数事实数：132

-## 主题目录
+## 智能体检索规则

-### 数据库访问函数
+1. 用户只描述能力时，先按“分类目录”选择候选详情页。
+2. 用户给出函数名时，优先在 `resource/` 子目录中搜索三级函数标题。
+3. 只读取命中的函数条目、相邻分类标题和必要参数表；不要把同页其它函数混进当前调用。
+4. 没有命中函数事实条目时，不要发明函数名；回到 [../index.md](../index.md) 或项目实际代码确认。

- `ExecSQL`
+## 分类目录

-### 文件访问函数
-
- `FileList`
- `FileAge`
- `RemoveDir`
- `FileSize`
- `SetFileAttr`
- `FileDelete`
- `Sysdbfwrite`
- `FileTime`
- `SetFileAge`
- `WriteFile`
- `WriteToLog`
- `FileExists`
- `FileCopy`
- `SetFileTime`
- `ReadExcelSheets`
- `CreateDir`
- `FileAttr`
- `ReadFile`
- `Sysdbfread`
- `FileRename`
- `ImportFile`
- `ExportFile`
- `ExportFile2`
- `ImportFile2`
- `FileMode`
- `SetFileMode`
- `FileAttrToStr`
- `FileModeToStr`
- `StrToFileAttr`
- `StrToFileMode`
- `Filemove`
-
-### 文件访问函数 / 导入导出类型函数
-
- `ftCSV`
- `ftXLS`
- `ftXls2`
- `ftXls3`
- `ftStream`
- `ftString`
- `ftXML`
- `ftdbf`
-
-### 文件访问函数 / 文件读写类型函数
-
- `rwByte`
- `rwInt`
- `rwReal`
- `rwStr`
- `rwObj`
- `rwRaw`
- `rwBinary`
-
-### 网络访问以及相关函数
-
- `GetHttp`
- `PostHttp`
- `GetURL`
- `CreateHttpSession`
- `SetHttpMode`
- `SetHttpCallBack`
- `GetHttpContent`
- `GetHttpResponseHeader`
- `SysSendMail`
-
-### INI文件处理函数
-
- `IniReadBool`
- `IniReadDate`
- `IniReadDateTime`
- `IniReadFloat`
- `IniReadInteger`
- `IniReadTime`
- `IniReadString`
- `IniReadBinaryStream`
- `IniReadSection`
- `IniReadSections`
- `IniReadSectionValues`
- `IniSectionExists`
- `IniValueExists`
- `IniWriteBool`
- `IniWriteDate`
- `IniWriteDateTime`
- `IniWriteFloat`
- `IniWriteInteger`
- `IniWriteTime`
- `IniWriteString`
- `IniWriteBinaryStream`
- `IniDeleteKey`
- `IniEraseSection`
-
-### INI文件处理函数 / 宽字节处理函数
-
- `IniReadSectionsw`
-
-### 进程相关函数
-
- `SysPutenv`
- `SysExec`
- `SysParamStr`
- `SysErrorMessage`
- `Sysgetenv`
- `SysWaitForMultipleObjects`
- `SysTerminate`
- `SysCreateMutex`
- `SysCloseHandle`
- `SysReleaseMutex`
- `SysProcessID`
- `SysParamcount`
- `SysThreadID`
- `Sleep`
- `SysWaitForSingleObject`
- `SysGetenvs`
- `SysexecReadpipe`
- `SysexecGetenvs`
- `SysexecDeletepipe`
- `SysexecSetenvs`
- `SysexecNewpipe`
- `SysExecWritepipe`
- `dbglocalrunning`
- `dbglocalcancel`
- `SysThreadSelf`
- `syslinuxkrnlclosemutex`
- `SysSetThreadPriority`
- `SysGetThreadPriority`
- `SysSetProcessPriority`
- `SysGetProcessPriority`
- `SysGetProcessList`
- `SysGetProcessListw`
- `SysGetProcessNamePath`
- `SysGetProcessNamePathw`
- `SysGetProcessCmdLine`
- `SysGetProcessCmdLinew`
- `SysSetThreadName`
- `SysGetThreadName`
- `SysGetThreads`
- `SysPPid`
- `SysGetSubProcesses`
- `SysKill`
- `SysPidOfTid`
- `SysPidOfHandle`
- `SysHandleOfPid`
-
-### 进程相关函数 / 获取COM进程
-
- `SysGetPidOfCom`
- `SysGetWndOfCaption`
- `SysGetPidtidOfWnd`
-
-### 本地资源相关函数
-
- `SysExecName`
- `PluginPath`
- `FileInfo`
- `Getlogicdrive`
- `GetDeviceFree`
- `Getdeviceinfo`
- `Createlink`
- `Realpath`
+| 分类                 | 详情页                                                                   | 函数事实数 |
+| -------------------- | ------------------------------------------------------------------------ | ---------: |
+| 数据库访问函数       | [resource/01_database_access.md](resource/01_database_access.md)         |          3 |
+| 文件访问函数         | [resource/02_file_access.md](resource/02_file_access.md)                 |         29 |
+| 导入导出类型函数     | [resource/03_import_export_types.md](resource/03_import_export_types.md) |          8 |
+| 文件读写类型函数     | [resource/04_file_rw_types.md](resource/04_file_rw_types.md)             |          7 |
+| 网络访问以及相关函数 | [resource/05_network.md](resource/05_network.md)                         |          9 |
+| INI文件处理函数      | [resource/06_ini.md](resource/06_ini.md)                                 |         23 |
+| 宽字节处理函数       | [resource/07_wide_byte.md](resource/07_wide_byte.md)                     |          1 |
+| 进程相关函数         | [resource/08_process.md](resource/08_process.md)                         |         44 |
+| 本地资源相关函数     | [resource/09_local_resource.md](resource/09_local_resource.md)           |          8 |