天天基金官方ttskill

概述

天天基金 ttskill Runtime

当用户需要使用天天基金 Skills 能力时，优先使用本机 ttskill 运行时。不要把本入口理解为每次都要重新安装；安装只在本机缺少 ttskill 或运行时不可用时执行。

使用前检查

先检查本机是否已经安装并可用：

ttskill --version
ttskill status --env prod --json
ttskill skill list --json

如果 ttskill 命令存在且状态正常，不要重复安装基础包，继续按业务问题选择具体 skill_id 调用。

如果 ttskill 不存在、命令不可用，或基础运行时损坏，才进入首次启用流程。进入安装指南前先遵守以下规则：

• 优先使用基础包内置安装脚本完成标准安装，并以 ttskill --version 和 ttskill status --env prod --json 验证命令可用。
• 安装指南是首次启用文档，不是日常调用步骤；若已经安装，不要重复执行安装流程。
• 如果进入首次启用流程，完整执行安装指南中全量业务包的同步与安装，并确认本地业务包列表已全量安装完成后，才进入业务调用。

安装指南：

https://skills.tiantianfunds.com/ttfund-skills/ttfund-skill-cli-install.md

登录状态

如果 ttskill status --env prod --json 显示未登录、登录过期，或调用返回 cli_login_required、登录态失效、token 失效等鉴权错误，主动执行：

ttskill login --env prod

用户只需要在打开的浏览器页面里扫码或确认授权。不要只提示用户自行登录。

业务包更新

本机已经完成首次启用后，日常调用只按当前业务问题选择具体 skill_id；不要为了单次查询重复全量安装。

如果业务包缺失、版本过旧，或调用返回需要升级的版本信息，执行对应安装或更新：

ttskill install <skill_id> --env prod
ttskill update <skill_id> --env prod

install 和 update 会自动尝试刷新路由。只有返回结果提示 agent-entry refresh 失败，或 ttskill agent-entry show 仍看不到新业务包时，才手动执行：

ttskill agent-entry refresh --env prod

业务包由 ttskill 运行时下载、安装、更新和管理，不要把业务包本体复制进 Agent 目录。

调用方式

先通过路由内容或本地业务包列表确定具体原子 skill_id：

ttskill agent-entry show
ttskill skill list --json

选定具体业务 skill_id 和 action 后调用：

ttskill invoke <skill_id> --action <action> --env prod

需要传复杂参数时，优先把 JSON 请求体写入临时文件，再通过 --body <file> 传入，避免命令行引号被当前 shell 误解析。

如果只是做快速连通性验收，可以追加 --summary 输出精简摘要；需要分析完整业务结果时，默认不要加 --summary。

边界规则

• 不要提示用户配置 TTFUND_APIKEY。
• 不要使用旧的 API Key 型天天基金 Skill 流程调用 ttskill 能力。
• 不要依赖固定基础包安装路径；标准长期调用入口是 ttskill 命令，基础包内部路径只用于排障。
• 不要把分类名称当作可调用 Skill；分类只用于理解和路由，最终必须选择具体原子 skill_id。
• 不要根据聊天历史推断登录态；登录状态必须通过 ttskill status --env prod --json 或实际调用结果判断。
• 返回用户结果时优先提炼核心业务信息，不要原样堆砌完整 JSON、token、cookie 或其他敏感字段。