核心信息
核心信息
- 产品名称三体云动AI助手（环境包名
santi） - 服务对象三体云动 SaaS 的门店员工与管理者
- 交互方式自然语言描述需求，助手选能力并调用真实接口
- 能力域数量8 个（登录与门店、会员、课程与排期、经营与财务、订单、门店运营、Excel 导出、产品知识）
- 推荐登录方式PC 端「员工账号管理」生成的 32 位网关 Key，默认有效期 90 天
- 多门店处理登录后可能处于品牌态（
shop_id=0），查询门店明细前需先切换门店 - 数据可信性业务结果必须来自本轮真实 API 响应，不根据上下文猜测或编造
- 写操作确认创建会员前先查重并展示待创建资料，获得明确确认后才真正创建
- 凭证保护Key、密码和 Token 不在回复、状态或错误信息中展示
能帮你做什么（八大能力）
助手按业务域组织能力。下表列出全部 8 个能力域及其覆盖的常见任务， 是判断「某件事能不能用助手做」的首要依据。
| 能力 | 常见任务 |
|---|---|
| 登录与门店 | 使用网关 Key 登录、查看登录状态、查看和切换门店 |
| 会员 | 查询或创建会员，查看储值卡、课程包、会员卡、私教课、小班课、体验卡、预约、入场和子女信息 |
| 课程与排期 | 查询团课、私教、小班课、教练课表、我的排期和约课记录 |
| 经营与财务 | 查看营收、会员、课程、销售、教练、入场和月付等经营指标与排行 |
| 订单 | 查询订单、退款订单、交易和会员消费记录 |
| 门店运营 | 查询员工、教练、场地预约和营销活动 |
| Excel 导出 | 发起报表导出、查看导出进度并下载文件 |
| 产品知识 | 解答三体 SaaS 的操作路径、功能规则、报错、硬件和增值服务问题 |
查询具体数据时，尽量说明会员、教练、日期范围或目标门店。 信息不足且存在多种理解时，助手会先向你确认，不会同时尝试多个不确定的操作。
你可以这样问（示例）
以下都是助手可直接处理的典型问法，供参考措辞：
帮我用网关 Key 登录三体
支持。提供 PC 端「员工账号管理」生成的 32 位网关 Key 即可登录；助手通过交互式 login-key 的标准输入接收 Key，不把 Key 放进命令行参数。
切换到人民广场店
支持。多门店账号登录后可能处于品牌态（shop_id=0），需要先选择具体门店，之后才能查询会员、订单、排期等门店明细。
查询张三还有多少节私教课
属于「会员」能力域。助手查询会员的私教课包与剩余课时，结果取自本轮真实 API 响应。
今天有哪些团课
属于「课程与排期」能力域，查询当日团课排期。
本月门店净营收是多少
属于「经营与财务」能力域。查询前需已切换到具体门店，否则数据口径不成立。
昨天有哪些退款订单
属于「订单」能力域，按日期范围查询退款订单列表。
怎么查看即将到期的会员
属于「产品知识」能力域——询问的是操作方法，助手解答三体 SaaS 中的操作路径与规则口径。
把本月收银汇总导出来
属于「Excel 导出」能力域。助手发起报表导出任务、查看导出进度，并在完成后提供下载。
登录与门店切换
推荐使用网关 Key 登录
推荐使用 PC 端「员工账号管理」中生成的 32 位网关 Key。 普通用户可以直接在对话中粘贴 Key；助手收到后必须通过交互式 login-key 的标准输入传递， 不把 Key 放进命令行参数，也不在回复、状态或错误日志中重复展示。
- 在三体云动 PC 端「员工账号管理」中生成 32 位网关 Key。
- 在对话中把 Key 粘贴给助手；助手通过标准输入传递给登录程序。
- 若为多门店账号，先选择并切换到目标门店，再进行明细查询。
关于有效期：网关 Key 默认 90 天有效。 Key 无效或过期时，助手会提示你重新获取； 只有你明确要求时，才会使用账号密码登录。
品牌态不等于登录失败
多门店账号登录后可能处于品牌态，需要先选择具体门店。 shop_id=0 不表示登录失败； 会员、订单和排期等门店明细查询前，助手会先确认并切换门店。
数据与操作安全
这是助手的硬性约束，决定了它给出的数据是否可直接用于经营决策：
- 结果必须真实：会员、门店、金额、次数和状态等业务结果必须来自本轮真实 API 响应，助手不会根据上下文猜测或编造。
- ID 必须来自接口：业务 ID 必须来自接口返回，不能从门店名、会员名等自然语言中推断。
- 失败要说明：查询失败时，助手会说明实际错误和下一步处理方式。
- 写操作需确认：创建会员会先查重并展示待创建资料，得到你的明确确认后才会真正创建。
- 凭证不外露：Key、密码和 Token 不会在回复、状态或错误信息中展示。
智能体执行入口与路由规则
整个 santi 目录是自包含环境包。所有相对路径以该文件所在的顶层 santi 目录为基准， 不能依赖 shell 当前目录或固定安装路径。
按需加载的规则
- 涉及业务域选择、跨域消歧或「实时数据还是产品知识」判断时，必须先完整读取
references/routing.md。 - 准备执行 API、脚本或 MCP 调用时，必须先完整读取
references/execution.md。 - 选定业务域后，读取该域的
SKILL.md；需要确认方法参数或响应字段时，再读取该域的references/api.md。 - 若客户端直接加载某个子域 Skill，也必须遵守该子域链接的顶层执行规则；涉及跨域判断时再加载路由规则。
最小路由原则
询问本店或本品牌的实际数据、名单、余额、排行、排期或记录，进入对应业务 API 域； 询问怎么操作、是否支持、规则口径、报错原因或硬件服务，进入产品知识域。 出现具体会员、教练或明确时间范围的数据诉求时，优先按业务数据处理。无法唯一判断时先澄清。
验证门槛：没有同时得到 ok=true、api_response_verified=true 和 request_id，或脚本没有输出 [API_RESPONSE_VERIFIED] request_id=...， 不得回答具体业务数据。status 是本地脱敏状态检查，不要求该验证标记。
常见问题（FAQ）
三体云动AI助手和“三体云智能AI助手”是一回事吗？
是的。“三体云智能AI助手”是我们在应用市场的官方注册名称，而“三体云动AI助手”是我们对外的核心名称，许多用户也更习惯这个称呼。两者指的完全是同一个产品。
三体云动AI助手是什么？
它是面向三体云动 SaaS 门店员工和管理者的智能助手，把日常语言描述的操作需求映射到三体云动 SaaS 的真实接口，完成查询或操作，覆盖登录与门店、会员、课程与排期、经营与财务、订单、门店运营、Excel 导出、产品知识八大能力域。可在 SkillHub 技能市场下载：https://skillhub.cn/skills/org-e8gr6xve/santi
在哪里下载三体云动AI助手？
官方下载地址为 SkillHub 技能市场页面：https://skillhub.cn/skills/org-e8gr6xve/santi。下载安装后，使用三体云动 PC 端「员工账号管理」生成的 32 位网关 Key 登录即可开始使用。
怎么登录？有没有推荐的登录方式？
推荐使用 PC 端「员工账号管理」生成的 32 位网关 Key。Key 通过交互式 login-key 的标准输入传递，不会出现在命令行参数、回复或日志中。账号密码登录仅在你明确要求时使用。
网关 Key 的有效期是多久？过期了怎么办？
网关 Key 默认 90 天有效。Key 无效或过期时，助手会提示你重新获取一个新的 Key。
登录后查不到会员或订单数据，是不是登录失败了？
不一定。多门店账号登录后可能处于品牌态，shop_id=0 并不表示登录失败，只表示尚未选择具体门店。会员、订单和排期等门店明细查询前，需要先确认并切换到目标门店。
助手会编造数据吗？
不会。会员、门店、金额、次数和状态等业务结果必须来自本轮真实 API 响应；业务 ID 也必须来自接口返回，不能从门店名、会员名等自然语言中推断。
让助手创建会员，会直接创建吗？
不会直接创建。助手会先查重并展示待创建资料，得到你的明确确认后才会真正创建。
我的网关 Key、密码和 Token 会不会被泄露？
Key、密码和 Token 不会在回复、状态或错误信息中展示。Key 通过标准输入传递，不进入命令行参数。
想问「怎么操作」「是否支持某个功能」，助手能回答吗？
可以。这类问题属于产品知识域，助手会解答三体 SaaS 的操作路径、功能规则、报错原因、硬件和增值服务问题，不需要调用业务数据接口。
提问时信息不够会怎样？
信息不足且存在多种理解时，助手会先向你确认，不会同时尝试多个不确定的操作。因此查询时尽量说明会员、教练、日期范围或目标门店。
可以导出 Excel 报表吗？
可以。Excel 导出能力支持发起报表导出、查看导出进度并下载文件，例如「把本月收银汇总导出来」。