协作指南

从"一个人用"到"全队实时协作"，只需四步：建团队 → 启用云项目 → 队友部署 → 开工。

1. 建团队 / 进团队

• 负责人：「团队」页 → 登录后点「创建团队」→ 得到一个团队码，发给队友；
• 队友：「团队」页 → 「加入团队」→ 输入团队码。

入队后，团队名下的所有云项目对你自动可见——不需要逐项目再邀请。

💡 团队码泄露了？管理员可以在团队页重置团队码，旧码立即作废。 💡 成员分两种角色：管理员（可管项目与成员）和成员。

2. 把项目启用为云项目（负责人做一次）

1. 打开项目 → 「协作」页签 → 「团队 · 云端」区域；
2. 点「启用云项目」，选择所属团队；
3. （推荐）在下方「同步 · 版本」配置 git 远程仓库——这是队友一键部署的取货地址。

完成后，这个项目就出现在全团队的「团队」页里了。

3. 队友一键部署

1. 「团队」页 → 找到项目 → 「部署到本机」；
2. 选择存放位置 → 应用自动克隆项目并接入云协作 → 直接打开。

⚠️ 私有 GitHub 仓库首次克隆可能失败——先在终端完成一次 GitHub 登录（或配置 PAT/SSH）再重试，见 常见问题。

4. 选协作模式

「协作」页签 → 「同步 · 版本」→ 协作模式，二选一（团队共用一个设置）：

💡 不确定选哪个：异地就选分布式；只有当团队把工程放在同一个 NAS/共享盘上时才选 NAS 模式。模式随时可切换。

实时同步：哪些内容会自动互通

登录 + 云项目状态下，以下内容改动后几秒内出现在所有队友屏幕上，无需任何手动操作：

决策、任务、版本、配置、上线清单、GDD、画板（逐节点/逐连线）；资产台账另有独立开关（在协作页签，默认可开）。

几条让你放心的底层规则：

• 断网不慌：离线照常干活，联网后自动补齐两边差异；
• 不会误删：网络异常、数据可疑时同步宁可"这一轮什么都不做"，也不会拿坏数据覆盖你本地的文件;
• 同一条数据两人都改：以修改时间新者为准；配合"谁在编辑"提示，小团队足够用。

在线状态与编辑提示

• 团队页：成员头像带在线绿点；
• 工作台：能看到每个在线成员当前在哪个项目、编辑哪个模块；
• 页签横幅：你打开决策池时，若队友也在编辑决策池，顶部会出现"xx 正在编辑本模块"的提示；
• 条目徽章：具体到某条任务/决策/资产，正在被谁编辑会有小徽章。

这些都是软提示，不上锁——不会出现"文件被别人锁定无法编辑"的尴尬；两人同改一条时新者胜，提示的作用是让你们错开。

画板更进一步：队友的鼠标光标（带名字）和每步操作实时可见，可以当白板开会用。

git 同步与版本快照

「协作」页签 → 「同步 · 版本」：

• 一键同步：拉取 + 推送一步完成（分布式模式的日常动作）；
• 版本快照：不管哪种模式，都可以随时给项目文件夹拍快照、必要时回滚。

权限速查