9.1 组织

组织是一个团队：组织里的人可以互相聊天，共享组织的项目和记忆。比如“青禾科技”就是一个组织，林晓是所有者，周明是管理员，陈思远和王悦是成员。

通讯录

点导航栏的“通讯录”：

• 有人邀请你时，顶部是“你的邀请”，每条写着“王悦 @wangyue 邀请你以成员身份加入 青禾设计组”（不认识对方时只显示用户名，例如“wangyue 邀请你…”）和“有效期至”，可以“接受”或“拒绝”。
• 下面是你所在的每个组织，可以折叠。组织名右边的齿轮（“组织设置”）打开组织页。
• 每个成员显示名字，名字和用户名不同时后面跟着“@用户名”，比如“周明 @zhouming”。成员旁有在线状态：绿色在线，灰色离线，琥珀色是“在线，秘书忙碌”。点成员就开始和他聊天；成员的菜单里有“聊天”，以及按你的角色能做的操作。
• 最后一节“联系人”是和你有过私聊、但现在不在同一个组织里的人，比如以前同在一个组织、后来离开的同事。这些私聊只能看，不能再发消息。

创建组织

在通讯录顶部点“创建组织”，填：

• 短名：组织的唯一标识，比如 qinghe，用在命令行和链接里，创建后不能改。
• 显示名（可选）：大家看到的名字，比如“青禾科技”。

创建者就是组织的所有者。

角色

角色	能做什么
所有者	管理员能做的所有事；把成员设为管理员或改回成员；邀请成员或管理员；移除除自己以外的任何人；转让所有权；创建组织机器人；解散组织。每个组织只有一个所有者
管理员	邀请成员；移除成员（不能移除其他管理员）；改组织名和组织设置；维护组织记忆；清除成员自己声明的外部账号（比如 GitHub 账号）
成员	看到组织的项目；在组织项目里新建主题和工作流；参与被加入的主题；退出组织

组织项目由谁建、主题谁能看，见 4.1 项目和 4.2 主题。

邀请成员

被邀请的人必须已经有账号。没有账号的人先用注册码自己注册（没有注册码找管理员要）（见 1.2 注册与登录）。

1. 打开组织页（在通讯录里点组织名右边的齿轮），点右上角“邀请”。
2. 在查找框里输入对方用户名或名称的一部分（至少 2 个字符），或完整邮箱。
   • 已经在组织里的人标着“已是成员”，邀请过的标着“已邀请”。
   • 显示“没有匹配的账号。”说明他还没有账号。
3. 选“身份”：只有所有者能看到这个下拉框，可以邀请成员或管理员；管理员只能邀请成员。
4. 发出邀请。

对方会在收件箱里收到“加入 青禾科技 的邀请”，在通讯录顶部也能看到，可以接受或拒绝。

• 邀请 7 天内有效。
• 再次邀请同一个人，会更新角色并重新计算有效期。
• 还没回应的邀请在组织页的“邀请”一节，可以“撤回”。

组织页

页头写着组织名和“你的角色：所有者”。右上角的按钮（所有者和管理员才有）：“改名”“邀请”，所有者在还没有机器人时还有“创建组织机器人”。

部分	内容
邀请	待处理的邀请，写着“由 linxiao 邀请，有效期至 …”（这里写的是邀请人的用户名），可以“撤回”。没有时显示“没有待处理的邀请”
成员	所有成员和角色，“2 / 4 已连接”表示几位成员连接了已验证的 GitHub 账号。点成员右边的 ⋯（“成员操作”）：设为管理员、设为成员、转让所有权、移除
关联、连接申请	用来连接组织的 GitHub，桌面应用和服务器网页上都有（见 4.4 Webhooks 与 GitHub）
设置	组织级的选项。现在只有一项“群聊人数上限”：默认 32，可设 3 到 256，包括管理者。点“修改”或“恢复默认”，只有所有者或管理员能改
组织记忆	组织所有成员都能看到、组织里所有项目的会话都会召回的记忆（见 7.2 四个层级）
退出组织	退出后你看不到它的项目、群聊和记忆；再次加入需要新的邀请

改名

在组织页点“改名”，填成员看到的名字，最多 128 个字符；留空则显示短名。短名不会变。

转让所有权

所有者在成员的 ⋯ 里选“转让所有权”。确认后对方成为所有者，你变成管理员；只有新的所有者能再转回来。

所有者不能直接退出组织：先把所有权转让给另一位成员，再退出。

组织机器人

组织机器人是组织的一个特殊账号，组织连接的外部服务（比如 GitHub 的 Webhook）以它的名义发消息。它不能登录，也没有凭证。成员列表里它的名字是英文的“Organization bot”，标着“机器人 · 无凭证”。

• 只有所有者能点“创建组织机器人”，每个组织一个。它加入群聊后才能在群里发消息。
• 不再需要时，所有者在它的 ⋯ 里选“退役机器人”：它被永久停用并移出组织，消息保留，组织不能再创建替代的机器人。

解散组织

只有所有者能解散组织。在组织页最下面点“解散组织”，输入组织的短名确认。

• 解散后所有成员立刻看不到它，连同它的项目、群聊和记忆。
• 每位成员都会收到通知。他们的账号、个人项目、个人记忆，以及各自设备上的会话都会保留。

在命令行里管理组织

banz org list                                    # 你所在的组织
banz org create --slug qinghe --display-name 青禾科技
banz org members qinghe                          # 成员和角色
banz org find qinghe chen                        # 查找要邀请的人（至少 2 个字符）
banz org invite qinghe chensiyuan --role member  # 邀请（写用户名）
banz org invitations qinghe                      # 待处理的邀请
banz org role qinghe zhouming --role admin       # 设为管理员
banz org transfer qinghe --username zhouming     # 转让所有权
banz org leave qinghe                            # 退出组织（会先要你确认）
banz org leave qinghe --username wangyue         # 所有者或管理员移除成员（会先要你确认）
banz org edit qinghe --display-name 青禾科技     # 改名
banz org settings qinghe                         # 组织设置
banz org set qinghe chat.max_members 48          # 改群聊人数上限
banz org dissolve qinghe --confirm qinghe        # 解散组织
banz invitation list                             # 你收到的邀请
banz invitation accept qinghe-design             # 接受某个组织的邀请（写组织短名）

命令里的人都写用户名。banz org leave 是高风险操作：在终端里会先问一次，输入 y 才执行；在脚本里要加 --yes。