工作区与成员
工作区隔离成员、聊天、仓库、技能和任务。Telegram 用户名、GitHub 管理员身份或一条仓库链接,不会自动授予工作区权限。
账号与角色
| 身份 | 作用 |
|---|---|
| 部署管理员 | 管理服务器级配置、模型供应商、连接服务和部署操作 |
| 工作区 owner/admin | 管理获授权工作区的成员、群组、技能、定时任务等 |
| 普通成员 | 在权限范围内对话、查询和提出操作 |
| 已验证 GitHub 身份 | 在成员权限之上应用 GitHub 仓库的实际读写权限 |
首个 /setup 账号是部署管理员。面板账号和 Telegram 身份分开管理;创建面板账号不会自动加入 Telegram,邀请成员也不会创建面板账号。
邀请成员
- 打开 Members & access,复制当前邀请链接。
- 私下交给预定成员,对方用自己的 Telegram 账号打开并发送 Start。
- 确认成员列表出现其身份,再使用新链接邀请下一人。
邀请由首个使用账号领取,同一链接不能给多个账号加入。卡片约每十秒刷新链接,复制出的链接有效期为 24 小时;页面倒计时表示刷新节奏。邀请授予普通成员身份,不授予管理员或仓库写权限。接收器就绪后,即使机器人尚未激活,也可处理加入流程。
处理访问申请
未获准用户可以发消息并点击 Request access。在 Members & access → Access requests 审核:
- Approve access:加入或恢复普通成员身份。
- Reject request:不授予访问;对方可在 24 小时后重新申请。
如果机器人无法判断用户属于哪个工作区,使用该工作区邀请链接。
手动管理成员
Add/Edit 对话框管理角色和活跃状态。身份以 Telegram 数字用户 ID 为准,显示名和用户名仅供识别。停用会阻止其继续执行机器人工作,已有远端结果不会撤回。
管理员可以关联成员的 GitHub 资料,但此时显示 Verification pending。只有本人在私聊完成 /github 授权并返回确认后,才是已验证连接。当前 GitHub 写权限是执行 Codex 的必要条件,管理员角色不能替代。
工作区选择与设置
面板左侧切换工作区;Telegram 私聊用 /workspace <工作区 UUID> 选择自己已加入的工作区。执行仓库操作前核对目标。
| 页面 | 主要用途 |
|---|---|
| Overview | 工作区摘要、时区、预算和保留期限 |
| Settings | 活动状态和暂停/恢复 |
| Members & access | 成员、GitHub 关联和访问申请 |
| Group access | 群组绑定、可见性和消息收集 |
| Plugins / Skills / Workflows / Instructions | 集成、技能、定时工作和持久指令 |
| Runs & delivery / Usage / Audit / Privacy | 运行、交付、费用、审计和删除 |
可见入口取决于权限。多人同时修改时,旧页面保存可能失败;重新加载并核对新值后再保存。
暂停与恢复
工作区 Pause 会取消排队或运行中的助手工作及待发送结果。恢复后允许新请求,不会重启已取消请求。部署范围的暂停在 Operations 管理。
取消或撤权无法撤回已送达消息、已创建 PR 或已开始的外部请求。结果不确定时先核对目标服务。
可见性与身份绑定
部署管理员及符合条件的工作区 owner/admin 可在面板查看留存的运行请求、回复和交付内容。向成员说明这一点,并合理设置保留期限。
需要在 Telegram 执行 owner 操作时,可通过面板身份验证入口绑定自己的 Telegram。额外面板账号、身份链接和权限恢复位于 Operations;绑定后可能需要重新登录。群组关联还要求该账号是 Telegram 群管理员。