团队版本管理 FAQ
本页汇总团队版本管理中的常见问题。完整的操作指南请参阅团队版本管理。
连接与推送
推送失败提示 "rejected - non-fast-forward"
说明远端有你本地没有的新提交。先拉取（Pull）合并远端变化，再推送：
- 点击"拉取"
- 等待合并完成（大多数情况会自动合并）
- 再次点击"推送"
连接远程仓库时提示 "authentication failed"
- 检查 OAuth 账号是否过期：进入 设置 → 连接账号，重新授权 GitHub/Gitee
- 如果使用 PAT（个人访问令牌），确认令牌未过期且有
repo权限 - 私有仓库需要确保令牌具备对应仓库的读写权限
推送后远端看不到变化
- 确认推送的目标分支是否正确（默认
main，部分仓库可能是master） - 在远端网页刷新查看，有时存在缓存延迟
成员与版本
安装团队时提示"无法安装：缺少远程地址"
该成员智能体是纯本机的（没有推送到任何 Git 仓库）。你需要：
- 联系团队发布者，请对方把该成员发布到市场或推送到 Git
- 或者自己创建一个同配置的本地智能体替代
团队成员版本显示"已偏离"
你本地修改过该成员智能体的配置（人格、技能等），与团队锁定的版本产生了差异。
- 不影响使用：本地版本照常工作
- 不会被覆盖：升级团队时不会强制覆盖你的修改
- 如需同步：在成员智能体的版本管理中手动推送你的修改，再升级团队
换了队长后，旧队长的配置还在吗？
在。换帅只改变"谁是组长"的组织关系，不影响任何成员的配置、记忆或技能。你可以在版本历史中看到换帅记录。
冲突处理
拉取时出现冲突文件列表
通常发生在两人同时修改了团队共享资源（如共享技能或规则文件）。
| 策略 | 适用场景 |
|---|---|
| 保留本地 | 你的修改更新、更完整 |
| 使用远端 | 对方的修改是你想要的 |
| 手动编辑 | 需要合并双方的改动 |
| 保留两者 | 不确定时先都留着，稍后整理 |
两个人各加了新成员，会冲突吗？
通常不会。成员列表的合并策略是取并集——A 加了 carol，B 加了 dave，合并后团队同时拥有 carol 和 dave。只有修改同一条记录（比如同时移除同一人）才会真正冲突。
发布与安装
发布时提示"成员缺少远程来源"
团队中包含了纯本机智能体。发布前需要：
- 检查每个成员的来源（本地 / Git / 市场 / 内置）
- 把本机成员推送到 Git 或发布到市场
- 重新发布
从链接安装后，和原作者还有关系吗？
没有。安装时系统会自动断开与原始远程的连接。你得到的是一个完全独立的副本（类似 Git fork），后续修改不影响原作者。
安装来的团队可以发布到市场吗？
可以。只要所有成员都有远程来源，你就可以像原创团队一样发布。建议使用不同的团队名称以避免混淆。
解散与恢复
解散后数据会丢失吗？
不会。解散是"归档"而非"删除"：
- 团队目录被移到归档区，磁盘上完整保留
- 版本历史、共享资源、成员清单全部保留
- 成员智能体本身不受影响，它们只是不再属于该团队
如何恢复已解散的团队？
从归档区手动将团队目录移回活跃目录即可。系统会重新识别版本历史和成员关系。