BiBrain 使用手册
BiBrain 把团队协作收敛成一条主线：团队 → 目标 → 任务。AI 在三个地方出手——帮你拆目标、帮你干一条任务、帮你做团队看板；其余界面只负责「看见」和「确认」。所有团队资产都存在团队自己的 git 仓库里，随时能 clone 下来看。
阅读顺序
手册由浅入深分四层：第一层 5 分钟读完，第二三层按需查，第四层用于排障与定制。
- 第一层 · 先跑起来（本页）：它是什么、五分钟上手、界面地图
- 第二层 · 日常怎么用：团队首页、目标与任务、会话、共享空间、源代码管理、团队回顾、团队设置
- 第三层 · 用熟之后：布局与命令面板、快捷键、同步与冲突、拆解、状态机、会话进阶、提示词与画像、子仓库、跨团队
- 第四层 · 底层模型：真相在哪、仓库目录约定、task-graph.json、数据落点
- 附录：排错速查、这一版做不到什么、术语表
它是什么
三分钟建立心智模型。这一节里的四条判据，能省掉后面 80% 的困惑。
一条主线
团队 → 立一个 目标 → AI 把目标拆成 任务 → 人或 AI 执行任务 → 产出进 共享空间 → 回过头看 团队回顾
每一环都对应界面左侧活动栏的一个图标。找不到某个功能时，先问自己「它属于这条主线的哪一环」。
四条判据
1 · 团队的一切都在一个 git 仓库里
任务结构、任务状态、文档、成果物、对话归档、看板，全都是这个仓库里的文件。不是黑盒数据库——你可以 git clone 下来，用任何编辑器打开。客户端在你本机维护一份工作副本（默认 ~/.sdw/shared-team/<团队 id>）。
2 · AI 只写文件，落不落库由你点
Agent 拆解目标、执行任务、生成看板，产出都是工作副本里未提交的改动。你 review 之后自己提交推送。AI 从不替你 commit——这是硬约束，不是配置项。
3 · BiBrain 是一个独立窗口
它和 AIKO 主窗口是两个窗口、两套界面。登录态、模型配置从主窗口来，但团队协作的所有事都在 BiBrain 窗口里做。主窗口里旧的「团队」界面与它无关。
4 · 界面是 VS Code 的形状
最左是活动栏（切换你在哪个视图），中间是侧栏（这个视图的导航树），右边是编辑区（可拖拽、可分屏、可关闭的标签页）。会用 VS Code 就会用它；不会也没关系，下文「界面地图」有完整地图。
入口
在 AIKO 主窗口顶栏点 B 图标开 BiBrain 窗口。看不到这个图标，去 设置 → 实验室 打开 「新版本 BiBrain」。B 图标上的绿点表示 BiBrain 窗口正在运行。
五分钟上手
从零到「AI 帮我干完了第一条任务」。每一步都标了它在界面的哪个位置。
进入 BiBrain
AIKO 主窗口顶栏 → B 图标。第一次会新开一个窗口，之后点它是切过去。
有团队 or 建团队
侧栏最顶上是团队切换器。已经被拉进团队的话直接选一个；没有的话两条路：
- 和 AI 一起组建（推荐）——说一句要做什么，它翻组织名册按角色和当前负载推荐人选，实时填进右侧表单，你随时改。
- 自己填表——团队名、可见范围、协作模式、成员与角色。
拿到别人的邀请链接时，在团队管理页粘贴链接加入（链接分「直接加入」和「需审批」两种）。
建完团队，服务端自动开一个 git 仓库，把 AI 要用的工作规程（skill）放进去。
等工作副本连上
进团队后客户端会自动把团队仓库 clone 到本机。顶栏右侧的同步按钮会显示进度。首次 clone 可能要等一会儿；连上之前，共享空间的文件树是空的，这是正常的。
要换目录：团队设置 → 基线能力 → Git 仓库。
立一个目标
活动栏 目标与任务 → 顶部 tab「目标浏览」→ 新建目标。写清楚你想达成什么、什么时候要。
让 AI 把目标拆成任务
在目标上点「拆解」，进目标拆解会话：左边和 AI 聊，右边实时看它拆出来的任务图（DAG / Raw JSON 两个视图 + 演进历史）。
- 拆得太碎或太粗 → 调拆解粒度滑块，再来一轮
- 任务之间连线太多或太少 → 调依赖密度
- 某条任务的标题、交付物、工时想改 → 直接在右边表单上改，AI 下一轮就读到了
拆解结果是你工作副本里一份未提交的文件。确认没问题，点「确认落库」才 commit + push 给全团队。
分派与流转
切到「任务浏览」tab：看板拖卡片改状态，列表批量看，关系图看依赖链走到哪了。
只有负责人能流转自己的任务；没指派负责人的任务要先指派。断网也能拖——改动先记在本地，网络恢复后自动同步。
让 AI 干一条任务
任务卡上点「执行」，进任务执行会话：左边对话，右边实时列出它产出了哪些文件、上游依赖交了什么。
Agent 能自己翻团队共享空间里已有的资料，不用你把上下文重贴一遍。它自报干完时，任务会推到**「评审中」**并移交给目标负责人——不是直接「已完成」，签收始终是人的动作。
提交到团队
活动栏 源代码管理：左边列出所有改动，逐个看 diff，勾选要提交的，写提交说明，⌘/Ctrl+Enter 提交并推送。
或者用顶栏的同步按钮一键跑「同步更改」（预览 → 拉取合并 → 推送）。
看团队怎么跑的
团队首页：周期概览、目标进度、状态分布、成员负载、团队动态、历史归档。
团队回顾：和 AI 说你想看什么，它生成一张自包含的 HTML 看板存进团队仓库，发布后全团队都能打开。
界面地图
一张表认全所有入口。活动栏是唯一的一级导航——点一个图标，侧栏的内容类型整个换掉。
窗口的四块
| 区域 | 装什么 | 关键行为 |
|---|---|---|
| 顶栏 | 搜索框 · 同步按钮 · ＋新建 · 通知 · 头像 | 搜索回车跳目标中心；同步按钮是分裂按钮（左半执行、右半 ▾ 切模式）；头像菜单里有「我的工作台 / 我的画像 / 团队管理 / 回到 AIKO」 |
| 活动栏 最左窄条 | 7 个视图图标 | 点已激活的图标 = 折叠侧栏；可拖拽排序、右键隐藏（团队设置沉底，不可拖不可隐） |
| 侧栏 | 团队切换器 → ＋新建对话 → 当前视图的导航树 → 用户卡 | 可拖宽；每段可折叠，折叠态跨重启记住 |
| 编辑区 | 可拖拽的标签页（文件、diff、会话、终端…） | 拖拽停靠、分屏、关闭；布局跨重启保留 |
七个视图
| 图标 | 视图 | 侧栏给你什么 / 主区给你什么 |
|---|---|---|
| ⌂ | 团队首页 dashboard | 侧栏：我的工作（我负责的 / 我创建的 / 我交付的 / 全部团队）、快捷访问 主区：周期概览、目标列表、状态分布、成员负载、交付节奏、团队动态、历史归档 |
| ◎ | 目标与任务 work | 侧栏：目标树（展开看任务） 主区 4 个 tab：目标浏览 / 任务浏览 / 我的任务 / 成员分布 |
| 💬 | 会话 chat | 侧栏：会话历史树（类型 → 对象 → 成员 → 会话） 主区：会话标签，可同时开多条 |
| 🗂 | 共享空间 space | 侧栏：文件树（含 ⌘/Ctrl+P 快速搜索） 主区 9 个 tab：概览 / 需求 / 文档 / 目标与任务 / 会话记录 / 成果物 / AI 资产 / 同步记录 / 变更 |
| ⑂ | 源代码管理 git | 侧栏三段：源代码管理（提交框 + 分组的更改列表）、子仓库、提交图 主区：仓库概览（分支、领先落后、冲突、最近提交、同步模式） |
| ▤ | 团队回顾 review | 侧栏：看板库（我的 / 按成员分） 主区：看板卡片墙 + 内置「团队运行概览」；右侧是看板预览面板 |
| ⚙ | 团队设置 settings | 侧栏：设置分节树 主区 5 个 tab：基线能力 / 场景插件 / 画像 / 成员画像 / 提示词 |
记住这条
共享空间是「看文件」，源代码管理是「改动与提交」。两个视图读的是同一个工作副本，但改动列表只在源代码管理里操作——刻意不在两处各放一份。