📝 docs(tsl): align agent-facing guidance

2026-05-28 19:12:34 +08:00
parent c48354e0cb
commit d8eb418277
63 changed files with 1921 additions and 371 deletions
@@ -2,14 +2,18 @@

 文档类型：检索页
 是否可直接用于生成代码：否
-是否含已验证可执行示例：否
-是否含已验证反例：否
 遇到不确定时跳转到：[tsbacktesting.md](tsbacktesting.md)、[tsl_python_interop.md](tsl_python_interop.md)、[../finance/index.md](../finance/index.md)、项目自身文档、`scripts/*` 入口脚本、CI 配置

 这里处理“现成模块、外部集成和互操作”，不处理基础语法教学，也不替代金融业务主线。

 模块摘要页只负责确认能力边界和选路，不负责给出项目账户体系、真实接口名、部署方式、权限模型或脚本入口的真值。

+## Agent Modules 路由规则
+
+- 先判断任务是在问模块能力、业务流程、语法规则还是项目真实接入参数。
+- modules 只给集成边界和选路；真实账号、部署入口、权限模型和接口细节必须回项目文档。
+- 不要发明模块专属 API 参数、项目账号来源、部署路径或脚本入口。
+
 ## If / Then 路由

 - If 问题在问“策略回测框架怎么组织、怎么取结果”，then 先读 [tsbacktesting.md](tsbacktesting.md)。
@@ -2,14 +2,18 @@

 文档类型：模块摘要
 是否可直接用于生成代码：仅部分
-是否含已验证可执行示例：否
-是否含已验证反例：否
 遇到不确定时跳转到：项目级部署文档、官方 pyTSL 详细接口文档、[tsl_python_interop.md](tsl_python_interop.md)、[index.md](index.md)

 本页用于确认 pyTSL 的接入方向和最小链路，不替代项目级部署文档或完整接口手册。

 - 如果登录方式、凭证来源、环境变量、部署入口、连接上下文或返回结构没有确认，不继续生成接入代码，直接回项目级部署文档或官方 pyTSL 详细接口文档。

+## Agent pyTSL 边界规则
+
+- 先确认项目是否已经给出 pyTSL 安装方式、登录方式、凭证来源和返回结构。
+- 本页只给 SDK 能力分类和最小链路，不替代官方接口手册。
+- 不要发明登录参数、连接上下文、查询语句来源或返回数据结构。
+
 ## 定位

 - 官方 Python SDK，面向取数/执行/批量/异步与数据转换。
@@ -73,8 +77,7 @@

 示例里的 `"user"` / `"password"` 只表示调用外形，不代表项目里的真实登录方式或凭证来源。

-代码块身份：配置片段 / 概念骨架
-代码块说明：可参考最小链路，不是已验证可执行示例。
+下面代码只表示调用外形；真实登录方式、凭证和查询来源以项目文档为准。

 ```python
 import pyTSL
@@ -2,14 +2,18 @@

 文档类型：模块摘要
 是否可直接用于生成代码：否
-是否含已验证可执行示例：否
-是否含已验证反例：否
 遇到不确定时跳转到：项目实际接口定义、[../finance/backtest_and_trade_flow.md](../finance/backtest_and_trade_flow.md)、[index.md](index.md)

 本页不足以直接生成回测代码，只用于确认回测任务的组织顺序，以及哪些地方必须回到项目实际接口定义继续核对。

 - 只要任务已经进入对象创建、交易输入入口、结果读取方法或项目封装差异，就先停止生成，直接回项目实际接口定义，不要先拼调用链。

+## Agent TSBackTesting 边界规则
+
+- 只把本页用于识别回测框架任务顺序和常见字段类别。
+- 对象创建方式、最小必填字段、交易入口和结果接口都以项目实际接口定义为准。
+- 不要发明 `TSBackTesting` 构造方式、交易输入函数或结果读取调用链。
+
 ## 适用场景

 - 任务已经进入“回测框架怎么配置、怎么执行、怎么读结果”。
@@ -2,14 +2,18 @@

 文档类型：模块摘要
 是否可直接用于生成代码：否
-是否含已验证可执行示例：否
-是否含已验证反例：否
 遇到不确定时跳转到：项目级部署文档、对应官方文档、[pytsl_api.md](pytsl_api.md)、[index.md](index.md)

 本页用于接入决策和最小链路确认，不替代项目级部署文档。

 - 如果登录方式、凭证来源、位数、环境变量、连接通道或部署入口没有确认，不继续生成接入代码，直接回项目级部署文档或对应官方文档。

+## Agent Python 互操作边界规则
+
+- 先判断是 Python 调 TSL、TSL 调 Python，还是服务器侧 Python 服务。
+- 本页只给接入路径和接口类别；真实登录方式、位数、环境变量和部署入口必须回项目级部署文档。
+- 不要发明凭证来源、连接通道、Python 路径或服务部署方式。
+
 ## 摘要

 - 覆盖三类交互：Python 调用 TSL、TSL 调用 Python、落地服务器开启 Python 服务。
@@ -2,12 +2,16 @@

 文档类型：模块摘要
 是否可直接用于生成代码：仅部分
-是否含已验证可执行示例：否
-是否含已验证反例：否
 遇到不确定时跳转到：调用侧账户体系文档、项目实际接口说明、[index.md](index.md)

 本页用于确认接口名称、参数含义和风险边界，不替代项目级接入文档。

+## Agent 微信消息边界规则
+
+- 先确认调用侧已经提供 `userid`、模板类型、关键字含义和必要的账户字段。
+- 本页只给接口外形和参数含义；账户体系、授权关系和模板映射以项目实际接口说明为准。
+- 不要发明 `username` 来源、模板关键字含义、项目封装函数或账户映射。
+
 ## 适用场景

 - 通过“天软科技服务号”向微信客户端发送模板消息。
@@ -59,8 +63,7 @@

 ## 发送示例（配置片段，可参考参数组织）

-代码块身份：配置片段 / 概念骨架
-代码块说明：可参考参数组织，不是已验证可执行示例。
+下面代码只表示参数组织方式；真实账户、模板关键字和调用侧封装以项目实际接口说明为准。

 ```tsl
 // 定义参数