AI 指南

S.A.N.T 的 AI 分三层：内置模型（登录即用）、Agent 同事（能动手干活）、外部 AI 打通（Claude Code / Cursor 无缝接入）。本篇按这个顺序讲。

内置模型与积分

「设置 → AI 接入」→ 服务商选「内置」→ 已登录状态下点「启用模型」。不需要申请任何 API Key——请求由我们的服务器代为调用模型，密钥保管在服务端。

内置模型按用量消耗积分（各模型费率见应用内费率表）：

💡 生成图片同样扣积分，按张计费，费率见应用内费率表。

如果你有自己的模型服务商账号，可以不走内置：

「设置 → AI 接入」→ 选择服务商：Anthropic / OpenAI / DeepSeek / GLM / Kimi（或任意 OpenAI 兼容端点）；
填入 API Key、端点和模型名。

左侧栏 ✦ Agent 打开对话面板。项目内是三位专家（可随时切换），项目外是应用向导。

它们不是聊天机器人——回答问题前会实际去读你的项目（GDD、决策、任务、画板、代码），需要动手时会调用工具：建任务、改资产状态、记录决策、生成图片（自动存入资产目录并登记台账）等。

几个值得知道的机制：

权限档：每个会话可设只读 / 标准 / 自动。标准档下，改文档这类"内容写入"一律先出提案卡，你点「应用」才生效；只读档 AI 只能看不能动。
决策必经人：无论什么档位，AI 记录的决策都要你在卡片或决策池里确认才算数。
会话持久：每个项目 × 每个角色的对话历史自动保存，重启应用接着聊。
计划条：复杂任务 Agent 会先列计划、边干边勾。
外接 MCP：你自己配置的第三方 MCP 工具服务器，可以并入三位同事的工具箱（设置里配置）。

这是 S.A.N.T 的招牌能力：你在外部 AI 编程工具里干活时，它们自动知道你的项目背景——不需要复制粘贴设计文档，也不经过任何第三方服务器（全部通过项目文件夹内的本地文件完成）。

打开项目 → 「AI 配置」页签：

上下文文件：一键生成 CLAUDE.md / AGENTS.md / Cursor 规则——外部 AI 打开项目就能读到：项目信息、GDD、画板结构、开发规范、已拍板的决策；
- 这些文件只占一块标记区域，你自己写的内容不会被覆盖；
- GDD、决策等数据变化时自动刷新。
MCP 接入：按钮一键写入 Claude Code / Cursor / Codex / Claude 桌面版的配置——AI 工具获得实时查询能力（要 GDD、查决策、看画板都是现问现答）。
对话 Hook（Claude Code / Codex）：每轮对话前自动注入最新的待落实决策，比"重开会话才生效"更即时。

接入后，外部 AI 在写代码过程中遇到"影响体验的选择"（比如"金币掉落是即时结算还是结算画面统一给？"），会自动把问题写回决策池（带优先级和推荐方案），并按推荐默认继续干活不停工。你在 S.A.N.T 里拍板后，AI 下次干活会看到你的决定并照办。

应用升级可能带来接入文件的新版本。「AI 配置」页的就绪自检会逐项检查项目里的接入产物是否过期，亮"待更新"时一键刷新即可。

不用开 Agent 对话，各页签内直接点：

针对目标平台（蛋仔派对 / Roblox）的 Agent Skills 会在创建项目时自动部署到项目里，让 Claude Code 等工具获得平台专属知识。你自己添加的技能不会被应用清理。