常见问题（FAQ）

安装与更新

Q：安装时 Windows 弹出蓝色的"Windows 已保护你的电脑"？ 点「更多信息」→「仍要运行」。这是因为安装包暂未购买代码签名证书（个人开发者阶段的常见情况），并非安全问题。请只从官网 unrmc.com 下载安装包，下载页提供 SHA256 校验值可自行核对。

Q：应用怎么更新？ 自动的：每次启动检查新版本，静默下载，下次启动生效；也可以在「设置 → 关于」手动检查并一键更新。

Q：更新提示一直不出现 / 应用打不开了怎么办？ 直接去官网下载最新安装包覆盖安装即可，项目数据不受影响（数据都在你的项目文件夹里，与应用安装无关）。

账号与积分

Q：注册提示需要邀请码？ S.A.N.T 目前是邀请制，请向你的团队负责人索取邀请码。

Q：积分是什么？不够用了怎么办？ 积分是内置 AI 模型的计量单位（见 AI 指南）。获取途径：① 输入兑换码充值；② 兑换过码的账号每日首次登录自动 +100。另外，配置自己的 API Key 直连服务商不消耗积分。

Q：每日 +100 积分没有到账？ 每日赠送只发给兑换过至少一张兑换码的账号。兑一张任意面额的码即可解锁。

Q：内置模型显示"未启用"？ 先确认已在「团队」页登录云账号——内置模型的身份就是你的登录态。已登录仍显示未启用的话，去「设置 → AI 接入」→ 内置 → 点「启用模型」重新检测；仍异常请升级到最新版本（旧版本存在重启后误显示未启用的问题，已修复）。

协作

Q：队友点「部署到本机」提示克隆失败？ 多数是项目仓库为私有仓库、这台电脑还没有 GitHub 凭据。在终端里完成一次 GitHub 登录（如运行 gh auth login，或配置 SSH Key / PAT），然后回到应用重试部署。

Q：我的改动队友看不到 / 队友的改动我看不到？ 按顺序检查：① 双方都已登录且打开的是同一个云项目（「协作」页签可见绑定状态）；② 网络正常——同步在断网时会安全暂停，恢复联网后自动补齐；③ 双方版本一致且为最新（旧版本画板协作存在已修复的问题）。正常情况下改动几秒内互通，最迟不超过一次后台轮询（15 秒）。

Q：NAS 共享目录里的项目，别人改了我这边不刷新？ 请升级到最新版本——NAS/共享盘的文件变化监听已改为轮询方案，共享目录下会自动生效；同时确认「协作」页签里的模式选的是「NAS 共享目录」。

Q："xx 正在编辑本模块"会锁住我吗？ 不会。这是软提示，只是让你们错开编辑；真的同时改了同一条，以后保存的为准。

Q：不组队能用吗？ 完全可以。不登录时，除云协作与内置模型外的全部功能（项目/GDD/画板/配置/资产/决策/版本/上线/外部 AI 打通）都可离线使用；AI 可用自己的 API Key。

数据安全

Q：我的项目数据存在哪？会上传吗？ 数据就是你项目文件夹里的普通文件（.santt/ 子目录 + GDD.md）。只有在你启用云项目后，协作数据（任务/决策/画板等）才会同步到云端做团队镜像；你的代码和美术源文件永远不会上传到 S.A.N.T 的服务器。

Q：卸载应用 / 换电脑，数据会丢吗？ 不会。卸载不影响项目文件夹；换电脑把项目文件夹拷过去（或用「部署到本机」重新拉取云项目）即可。

Q：填入的 API Key 安全吗？ Key 用系统级加密存储在你本机，不会上传服务器、不会进项目文件夹（也就不会被 git 提交）。

AI

Q：AI 生成的内容会直接改我的文档吗？ 不会。内容级修改（GDD、配置、代码文件）都走提案流程——AI 给出修改卡，你点「应用」才落地；决策更是必须由人确认。详见 AI 指南。

Q：Claude Code / Cursor 里的 AI 怎么"认识"我的项目？ 打开项目 → 「AI 配置」页签 → 一键生成上下文文件并接入 MCP。之后外部 AI 打开项目文件夹即可读到 GDD、画板、决策等背景。见 AI 指南。

Q：「AI 配置」页出现"待更新"标记？ 说明应用升级后带来了新版接入文件，项目里的还是旧版。点一键更新刷新即可，不影响你的自有内容。

Q：图片生成很慢？ 图片模型单张生成通常需要 1–2 分钟，请耐心等待；生成完成后会自动存入你的资产目录并登记台账。