Browse documentation

REPODESK DOCUMENTATION

User guides from stonega/repodesk. Available features depend on your deployment version, connected services and workspace settings.

View source at b292e6c

工作区与成员

工作区隔离成员、聊天、仓库、技能和任务。Telegram 用户名、GitHub 管理员身份或一条仓库链接,不会自动授予工作区权限。

账号与角色

身份作用
部署管理员管理服务器级配置、模型供应商、连接服务和部署操作
工作区 owner/admin管理获授权工作区的成员、群组、技能、定时任务等
普通成员在权限范围内对话、查询和提出操作
已验证 GitHub 身份在成员权限之上应用 GitHub 仓库的实际读写权限

首个 /setup 账号是部署管理员。面板账号和 Telegram 身份分开管理;创建面板账号不会自动加入 Telegram,邀请成员也不会创建面板账号。

邀请成员

  1. 打开 Members & access,复制当前邀请链接。
  2. 私下交给预定成员,对方用自己的 Telegram 账号打开并发送 Start。
  3. 确认成员列表出现其身份,再使用新链接邀请下一人。

邀请由首个使用账号领取,同一链接不能给多个账号加入。卡片约每十秒刷新链接,复制出的链接有效期为 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 群管理员。

更多说明见 群组与话题 和 记忆与隐私。