AI Agent 与 CLI 接入

应用、脚本和 AI Agent 使用同一套接口与业务权限。选择工具不会自动扩大账号、发布或会员权限。

当前可用的接入方式

• 匿名读取已上架工作流目录、历史版本元数据和指南预览；读取公开技能元数据、平台入口包和允许匿名下载的本站技能包。工作流 ZIP 需网页登录，买断模板另需购买权益。
• 使用中央 ltak_… API Key 读取历史作品和发布权限；账号获发布权限后发布技能或工作流模板，并管理本人工作流定价。
• 平台入口 Skill 为 lingtu-workflow，安装说明在 /install/lingtu-workflow.md；包元数据仍通过 /api/public/school-skill 获取。不再安装学堂专用 CLI，程序接入可使用标准 HTTP；统一 CLI 的适配状态见下文。中央 API Key 不替代后台管理或课程业务的网页登录权限。

灵途 CLI

当前灵途 CLI 尚未注册学堂来源。仅配置 Origin 不会自动获得学堂业务命令。后续适配时，应区分匿名发现、历史作品读取和目录发布，复用客户端的凭证保护、超时和结构化输出机制。

这些接口主要提供查询、管理和包分发，不应包装成生成任务。CLI 的随程序分发 Skill 与学堂技能市场目录也属于不同资源。

接入验证

1. 先验证接口在目标环境的公网入口、方法、参数与响应。
2. 覆盖失效或撤销凭证、未授权账号发布、资格失效、版本冲突和资源下架。
3. 验证上传超限、下载摘要不符和响应丢失，保证写操作不会被自动重复提交。
4. 学习、订单及管理能力需先完成后端 Agent 鉴权和最小公开契约，再增加命令。

不要在终端配置产品 client_secret、直连数据库或将 /internal/* 暴露为公共接口。