csh
3d83740f88
25d895d 🐛 fix(gitea_workflow): clean up temp repos after job steps 2bc3b11 🐛 fix(gitea_workflow): clean up temporary repo dirs in workflows 98c3f30 📝 docs(agent_rules): allow plan execution on current branch 16c7230 📝 docs(prompts): define custom verify layering 8efc4dd 🐛 fix(skills): quote commit-message description bc8498f 🐛 fix(ci): install tomli for gitea tests 55cda3b 🐛 fix(tests): report missing toml parser clearly c0729c7 🐛 fix(playbook): import Optional for cli compatibility 63e24bf 📦 deps(skills): sync thirdparty skills d2f9356 🐛 fix(ci): isolate gitea workflow repos 588b81d 🐛 fix(ci): inline gitea workflow bootstrap e0b1c3a ♻️ refactor(skills): standardize first-party skill contracts 2c5050d ♻️ refactor(skills): rename repo skills source dir f049dfb 📦 deps(skills): drop duplicate first-party superpowers skills 234b335 ✨ feat(workflow): add superpowers planning and execution state tracking c1702a6 📝 docs(markdown): format tracked markdown and drop stale templates 2325409 📝 docs(markdown): clarify optional markdownlint usage 214c44e 🔧 chore(markdown): add markdownlint baseline and lint fixes a22b324 📝 docs(templates): add execution and memory-bank prompt templates 223a797 📝 docs(templates): update README for Claude Code and current features 4ac8672 📝 docs: simplify README + platform-agnostic tools + auto-create local rules 2431c9d 📝 docs: add claude_md config and use cross-platform paths d64b248 📝 docs: fix README.md inaccuracies and add Claude Code info c8d6bf2 🐛 fix(playbook): use relative paths in CLAUDE.md when not at project root 6518f0f ✨ feat(playbook): auto-create CLAUDE.md with path discovery 6ec9a45 ✨ feat(skills): add skill_link symlink support + platform-agnostic prompt 9f8b6b5 📝 docs: update README and config example for Claude Code support 79cff6c 📝 docs(skills): add Claude Code platform support 452c6f5 ✨ feat(playbook): auto-inject AGENTS.md into CLAUDE.md e1dbf3c 🐛 fix(skills): remove dual-path from commit-message skill f3a7259 🔧 chore(ci): use prepare_repo.sh in both workflows da08212 🔧 chore(ci): extract prepare_repo.sh and clean up workflows 7ade85e 🗑️ remove(tsl): drop syntax_book/, data/ source and build script f94dba0 ♻️ refactor(skills): update playbook.py and tests for thirdparty/ layout b3df412 ♻️ refactor(skills): separate thirdparty skills into thirdparty/ subdirectory 64950e7 📦 deps(skills): sync thirdparty skills a2e3cb0 ✨ feat(playbook): add no_backup deploy controls 8609d59 🐛 fix(docs): repair reference catalog source links 956da11 🐛 fix(playbook): publish hidden ci test fixes 3f67754 📦 deps(skills): sync thirdparty skills 08ca87b 📦 deps(skills): add karpathy thirdparty sync 96b705b 📝 docs(tsl): rebuild canonical syntax and routing manual 3ed5052 📦 deps(skills): sync thirdparty skills 60108dd 📦 deps(skills): sync thirdparty skills da85d4e 🐛 fix(thirdparty): prune nested project snapshots a2a697e 📦 deps(skills): sync thirdparty skills 9df610a 🐛 fix(thirdparty): exclude duplicated superpowers skills 33dd5bb 🐛 fix(thirdparty): preserve optional manifest fields 91b0ea7 🐛 fix(thirdparty): preserve manifest during snapshot update 2e26f98 🔧 chore(thirdparty): generalize skills sync pipeline 5b9c1e3 📦 deps(skills): sync superpowers 2f2d34a 📝 docs(readme): normalize subtree command spacing 62db7db 🐛 fix(ci): serialize superpowers update and sync 3463223 🐛 fix(ci): use literal superpowers sync paths 48f6de8 📦 deps(skills): sync superpowers 4b23529 🔧 chore(ci): merge superpowers update and sync workflow a56d75b 📦 deps(skills): sync superpowers 84bcefa 🔧 chore(ci): use ci[bot] commit author name 00a07e5 📦 deps(skills): sync superpowers 7b84daf 🐛 fix(templates): enforce main loop progress tracking 51373d7 🔧 chore(ci): automate superpowers sync workflow eaaa39c 🐛 fix(ci): prevent stale superpowers sync from restoring skills block 79755c6 📦 deps(skills): sync superpowers 836d878 📦 deps(skills): sync superpowers 8216c9f 📦 deps(skills): sync superpowers 9439505 🐛 fix(playbook): address reported repo issues git-subtree-dir: docs/standards/playbook git-subtree-split: 25d895d8b3f56624ccfe99ad7289e9eb49e0f316
4.7 KiB
4.7 KiB
天软平台和 Python 的交互
文档类型：模块摘要 是否可直接用于生成代码：否 是否含已验证可执行示例：否 是否含已验证反例：否 遇到不确定时跳转到：项目级部署文档、对应官方文档、pytsl_api.md、index.md
本页用于接入决策和最小链路确认，不替代项目级部署文档。
- 如果登录方式、凭证来源、位数、环境变量、连接通道或部署入口没有确认，不继续生成接入代码，直接回项目级部署文档或对应官方文档。
摘要
- 覆盖三类交互：Python 调用 TSL、TSL 调用 Python、落地服务器开启 Python 服务。
- 提供 COM/远程登录两种路径，以及
PyRun/PyCall体系。
怎么选路
| 场景 | 先选哪条路 | 最小前置条件 | 常见失败点 |
|---|---|---|---|
| Python 作为主控，远程执行或调用 TSL | Python 调 TSL | Python 环境、TSLPy 模块、可用连接方式（COM / 远程登录） | 位数不一致、环境变量没配好、服务器未登录 |
| TSL 脚本里需要调用现有 Python 代码 | TSL 调 Python | TSL 与 Python 位数一致、PYTHONHOME 等环境正确 |
Python 环境未就绪、模块找不到、网格场景不支持 |
| 落地服务器侧长期提供 Python 能力 | 落地服务器开启 Python 服务 | 服务端环境、部署权限、可维护的脚本入口 | 服务端环境和本地环境不一致、依赖未部署、运行权限不足 |
结构索引
- 支持版本
- Python 调用 TSL：配置步骤 / 接口说明 / 范例
- TSL 调用 Python：配置步骤 / 接口说明 / 范例
- do Python 方式
- 落地服务器开启 Python 服务
- sklearn 机器学习接口
- 附录与 FAQ
Python 调用 TSL（核心步骤）
- 先确认项目级部署文档里的天软目录、Python 目录、位数、连接通道和登录方式。
- 配置环境变量（天软目录、Python 目录）。
- 加载 TSLPy 模块（直接加载或修改包名）。
- 选择连接方式（COM / 远程登录）。
- 登录服务器后，再执行
RemoteExecute/RemoteCallFunc。 - 完成后显式断开连接。
主要接口（Python 侧）
- 服务器：
ConnectServer/LoginServer/Disconnect - 执行：
RemoteExecute/RemoteCallFunc - 系统参数：
SetSysParam/GetSysParam - 日期转换：
EncodeDate/DecodeDate/EncodeDateTime/DecodeDateTime
TSL 调用 Python（核心接口）
PyPutVar/PyGetVarPyRun（执行脚本）PyCall（调用 Python 函数，支持命名参数）PyError/PyRelease/PyEnsure
TSL 调用 Python（核心步骤）
- 先回项目级部署文档确认位数、
PYTHONHOME、解释器路径和可用模块。 - 用
PyEnsure确认 Python 运行时已经就绪。 - 需要把输入传给 Python 时，先用
PyPutVar放入变量。 - 选择执行方式：执行整段脚本用
PyRun，直接调函数用PyCall。 - 需要取回结果时，再用
PyGetVar读取输出变量。 - 失败时先看
PyError，结束后显式PyRelease。
最小前置条件
- Python 与 TSL 位数必须一致。
- 多版本 Python 需同步设置
PYTHONHOME。 - 落地前先决定是谁主控：Python 主控还是 TSL 主控。
do Python 方式
- 适合快速执行 Python 脚本，省去显式接口调用。
落地服务器开启 Python 服务（核心步骤）
- 先回项目级部署文档确认服务入口、部署权限、依赖目录和守护方式。
- 在服务器上准备与项目要求一致的 Python 运行时和依赖包。
- 放置一个稳定的 Python 脚本或服务入口，先只承载一条最小调用链。
- 按项目约定把这个入口接到天软侧的调用路径或调度入口。
- 用最小请求先验证“能启动、能调用、能返回”，再扩展业务逻辑。
- 再补日志、重启方式和运维监控；如果这些入口还没确认，不继续生成部署代码。
注意事项（精简）
- Python 与 TSL 位数必须一致。
- 多版本 Python 需同步设置
PYTHONHOME。 - TSL 调 Python 不支持网格调用。
- 出现调用失败时，优先先检查环境、位数和登录状态，再排查业务逻辑。
- 如果登录方式、凭证来源、位数、环境变量、连接通道或部署入口任一没有确认，不继续生成接入代码。