核心概念
花 3 分钟弄懂 S.A.N.T 的几个基本设定，后面所有功能都建立在它们之上。
一个项目 = 一个文件夹
S.A.N.T 不用私有数据库，也不把数据锁在云端——你的项目数据就是项目文件夹里的普通文件（设计文档是 Markdown，清单类数据是 JSON，都在项目根目录的 .santt/ 子文件夹里）。应用只是这些文件的"漂亮操作界面"。
这带来几个实实在在的好处：
- 数据永远是你的：哪天不用 S.A.N.T 了，文件还在文件夹里，记事本都能打开；
- 天然支持版本管理：整个项目文件夹可以直接进 git，谁改了什么有历史可查；
- AI 工具直接可读：Claude Code / Cursor 打开项目文件夹，就能看到设计文档和团队决策（详见 AI 指南）；
- 卸载应用数据不丢，换电脑拷走文件夹即可。
💡 任何文件夹都能"一键变成 S.A.N.T 项目"——新建项目时选中它，应用会自动补齐所需文件；你自己的工程文件（脚本、美术源文件）S.A.N.T 一概不动。
界面总览
左侧导航（全局功能）：
| 入口 | 作用 |
|---|---|
| 项目 | 项目列表、新建项目、打开项目 |
| ✦ Agent | 打开 AI 同事对话面板（项目内=三位专家，项目外=应用向导） |
| 素材库 | 玩法模板与功能组件库，新建项目时选用 |
| 团队 | 登录/注册、创建或加入团队、部署团队云项目 |
| 设置 | 主题、AI 接入、关于与版本更新 |
| 底部积分胶囊 | 内置 AI 的积分余额，点击查看收支明细 |
项目内页签（打开某个项目后，顶部一排）：
| 页签 | 一句话 |
|---|---|
| 工作台 | 每日的"作战室"：今日同步、任务看板、成员分工 |
| 动态 | 团队操作时间线 + 队友的 Agent 会话（互相可见、可回放） |
| GDD | 游戏设计文档：AI 生成、随时编辑、AI 扩展 |
| 画板 | 节点连线搭玩法框架，可挂接任务/资产/决策，多人实时协作 |
| 配置 | 可调参数表：从 GDD 提取、从代码扫描、生成调参指南 |
| 资产 | 美术资产台账：规格、状态流转、目录扫描、3D/图片预览 |
| 决策池 | 所有"需要人拍板"的事项：AI 提出 → 你确认 → AI 落实 |
| 版本 | 版本对齐：当前版本、改动日志、状态 |
| 上线 | 上线检查清单 + 上线后数据回流 |
| AI 配置 | 打通外部 AI 工具（Claude Code / Cursor / Codex）的开关面板 |
| 协作 | 云项目管理 + 同步与版本设置 |
每个页签的详细用法见 功能指南。
三位 AI 同事 + 一位向导
S.A.N.T 的 AI 不是聊天窗口，而是能动手干活的数字同事：
- 策划：读 GDD 和画板、拆任务、记录决策、维护配置参数；
- 程序：读代码、提交代码修改提案、扫描参数；
- 美术：维护资产台账、按需求生成图片（产物自动登记入资产台账）；
- 向导（未打开项目时）：带你熟悉应用、引导建项目。
它们干活前会先看项目的"墙"（GDD、决策、画板、任务），干完再把结果贴回墙上——所以你和 AI 看到的始终是同一份事实。用法详见 AI 指南。
决策池：AI 记录，人拍板
这是 S.A.N.T 的一条铁律——AI 永远是记录者和草稿工，拍板权永远在人：
- AI（无论是应用内的 Agent，还是外部的 Claude Code / Cursor）遇到"影响游戏体验的选择"时，不会擅自决定，而是把问题连同推荐方案写进决策池；
- 每条决策带 P0–P3 优先级（P0 最急）和几个候选选项；
- 主创在决策池里点选拍板 → 决策变为"已确认" → AI 工具下次干活时会看到并落实它。
好处：项目里每一个重要选择都有记录、有去向，不再散落在群聊里。
云协作：镜像，不是搬家
登录账号、把项目发布为云项目后，团队获得实时协作能力（谁在线、改动秒级互通、画板光标互见）。但要理解它的定位：
- 本地文件始终是"真相"——云端只是它的镜像，用来在成员之间搬运变化；
- 断网照常干活，联网后后台自动补齐两边差异;
- 项目文件本体（代码、美术源文件）走 git 或共享文件夹，协作数据（任务/决策/配置/画板等）走云实时同步——两条通道各司其职。
详见 协作指南。