功能页面
本页逐一介绍桌面端左侧栏的各个页面及其用途。
左侧栏分三组:「概览」;「执行」组下有「Agent」「Bot」「工作区」「在线预览」「实时画面」「市场」;「本机」组下有「日志与诊断」「设置」。侧栏底部显示机器归属人、机器名和操作系统。
桌面端偏重「看本机在干什么」。新建 Bot、改 Bot 设置、管理供应商、引入 Skill 等操作在网页上做,页面里的「在 Web 中管理」「在网页中打开」会直接用浏览器打开对应位置。网页上的机器管理见 我的机器与 Bot。
窗口右上角的连接状态在所有页面都可见,旁边的按钮可「在浏览器中打开共工」:
| 状态 | 含义 |
|---|---|
| 已连接 服务器地址 | 在线,可以接任务 |
| 连接中 / 重连中 | 正在连接;服务器不可用时按指数退避自动重连 |
| 协议不兼容 | 本机版本太旧,服务器拒绝连接,需要升级 |
| token 已吊销 / token 无效 | 账号被停用或机器被吊销,需重新绑定 |
| 未运行 | 本机已有别的 daemon 在运行(通常是命令行 gg) |
| 未绑定 | 还没有绑定服务器 |
窗口底部的状态栏显示心跳、到服务器的延迟、运行中与排队的任务数、ACP 适配器版本,以及本机 daemon 版本和协议版本。
概览
本机执行端状态与正在运行的轮次。

- 四个统计卡片:连接(在线与否、是否加密连接)、Bot(已绑定数量、可用 Agent 数)、并发(运行中 / 本机 Bot 并发上限之和,以及本机队列长度)、工作区(数量、托管与本机目录各几个、占用空间)。
- 正在运行:每一行是一个运行中的轮次,显示 Bot、群、触发人、当前步骤和状态(运行中 / 等待审批 / 等待回答)。点击进入该轮的「运行过程」,内容与网页上的运行详情一致;点「返回」回到概览。
- 本机队列:超过并发上限、在本机排队等待的任务及排位。
- 提示条:连接出问题、daemon 未运行、系统权限未授权、实时画面推流失败时,页面顶部会出现提示和对应按钮(如「重试」「去授权」「查看」「重新绑定」)。
Agent
本机的 Node.js 与 CLI 运行时:安装升级、检测与供应商。

Agent 是本机安装的 CLI 运行时,决定能用哪些模型;Bot 是团队里的身份,调用这里的某个 Agent 执行。页面由上到下:
Node.js:运行 ACP 适配器与不需适配器的 Agent(Gemini CLI、CodeBuddy 等),托管安装 Agent 也用它,需要 22 或更高版本。本机没有合适的 Node.js 时,点「安装」会安装共工空间托管版到 ~/.gonggong/runtime,不影响系统环境。
各个 Agent:Claude Code、Codex、Gemini CLI、CodeBuddy(WorkBuddy)、pi、DeepSeek Harness、Antigravity CLI 各一张卡片。已安装时显示:
- 路径、版本(是否满足最低版本要求)、来源(共工空间托管 / 自行安装)、最新版本(有新版时标「有更新」)
- 登录状态、ACP 适配器(Claude Code、Codex、pi 的适配器随 daemon 提供,其余为「CLI 自带」)、可用模型(模型与推理强度在网页上为 Bot 设置)
- 被哪些 Bot 使用
可用的操作:
| 按钮 | 作用 |
|---|---|
| 安装 | 本机未检测到时,从镜像源安装共工空间托管版,不需要管理员权限 |
| 升级到 x.y.z | 有新版本时出现。托管版直接升级;自行安装的按原安装方式升级,卡片里会显示「升级命令」,也可以自己在终端运行 |
| 改用共工空间托管安装 | 自行安装的版本升级失败时出现 |
| 重新检测 / 已安装,重新检测 | 刚在终端里装好或升级后,重新检测 |
| 更换路径… / 手动指定路径… | 选择要使用的 CLI 可执行文件 |
| 恢复自动检测 | 取消手动指定的路径 |
安装和升级过程会在卡片里实时显示日志。下载地址由「设置」里的「镜像源」决定。
本机供应商:每个 Agent 卡片下方列出它的供应商(pi 除外,pi 使用它自己的登录:在本机运行 pi,输入 /login 登录或填写 API Key)。选中的一项是本机默认,新会话使用它:
- 「官方登录」:使用本机 CLI 自己的登录与配置。
- 其余为在网页上添加的供应商,显示地址、模型、打码后的 Key,或「本机 Claude 配置目录」。
在这里只能切换本机默认;新增、编辑、删除供应商点「在 Web 中管理」,到网页的机器页操作,见 Agent 工具与供应商。切换不会打断进行中的会话:如果有群的会话仍在使用旧供应商,会先弹窗列出受影响的群,确认后新会话才改用新的供应商。
Agent 设置(Claude Code 等支持的 Agent):只读展示这台机器的默认 Agent 设置,以及是否「继承本机 CLI 配置」(加载 ~/.claude 下的个人配置、CLAUDE.md、记忆、hooks 与 Skill)。新会话生效,Bot 可在网页上覆盖部分项。本机 CLI 配置里的设置会盖过共工的对应设置时,这里会提示。修改同样点「在 Web 中管理」。
Bot
本机运行的 Bot 与其供应商,其余设置请在 Web 端修改。

每个指定到本机的 Bot 一张卡片:
- 状态:在线 / 运行中 / 离线 / agent 缺失 / 待确认。
- 团队:Bot 所属团队。
- Agent:使用的 Agent 及版本;本机未安装时显示红字,并提供「前往 Agent」按钮。
- 供应商:下拉选择「继承机器(当前:…)」、「官方登录」或本机的某个供应商。只保存在本机,进行中的会话开启新会话后才切换。
- 并发上限、审批方式:只读展示。
- 「在 Web 中管理」:打开网页上该 Bot 的设置。别人为你创建的 Bot 显示「待确认」,按钮变为「在 Web 中确认」。
名称、角色说明、模型、并发上限、审批方式等都在网页上修改,见 Bot 设置与权限。
工作区
每个「群 × Bot」一个托管目录,或绑定的本机目录。

表格列出本机所有工作区:群、Bot、类型(托管 / 托管 · 无仓库 / 本机目录)、路径、状态(运行中 / 空闲 / 已移出 / 未使用,后两种附占用大小)和上下文占用圆环。双击一行在 Finder(Windows 为资源管理器)中打开。
托管工作区放在 ~/gonggong/workspaces/<群名>/<Bot名>/<仓库名> 下,在 Finder 里能直接找到。
- 托管工作区:可「打开」;已移出或未使用的托管工作区可「删除…」,确认后从本机删除该目录。只影响本机目录,群里的消息与记录不受影响。
- 本机目录(
/cd绑定):可「打开」,或「改回托管」让 Bot 回到托管工作区,结果会发到群消息里。本机目录不会被删除。
下方「本机备份 · 不上传」列出被覆盖的本地修改、中断的半成品,它们只保存在本机,可点「在 Finder 中显示」(Windows 为「在资源管理器中显示」)查看。
无法连接服务器时,页面顶部提示「无法连接服务器」,群与 Bot 名称暂时显示不出来,只按本机目录列出。
在线预览
Bot 对外开放的网页与后台运行的服务,可在本机查看或停止。

- 在线预览:把 Bot 开放给群成员访问的网页与对应的本机后台服务合并展示,显示所属群、Bot、类型和状态(在线 / 已暂停 / 离线)。可「本机打开」在本机浏览器访问,或点「停止」同时关闭群预览并停掉进程;点「···」菜单可「仅暂停后台进程(保留卡片)」(之后可点「重新启动」)或「查看技术详情」(端口、服务名、启动命令)。
- 仅后台运行(未开放预览):仅当存在尚未绑定任何预览的后台服务时出现,显示状态(启动中 / 运行中 / 已退出 / 启动失败)、端口和启动命令,可「停止」。
在这里操作与在网页群里效果相同,群成员会立即看到变化。预览功能见 结果预览。
实时画面
Bot 推送的桌面应用与小程序画面:推流组件、系统权限与推流状态。

- 推流组件:gg-cast 的状态。正式的 macOS 安装包显示「已内置」,随共工空间一起安装与升级;没有内置时显示「未内置」,首次推流时从服务器下载(服务器需在「客户端发布」上传 gg-cast)。
- 系统权限(仅 macOS):屏幕录制、辅助功能是否已授权,未授权时点「去授权」,见 权限与系统设置。
- Bot 开放的实时画面:每个画面显示类型(桌面应用 / 小程序)、推流状态(无人观看 / 启动中 / 推流中 / 推流失败 / 等待操作),以及谁正在远程操作。推流失败会显示原因并自动重试。可「关闭」(带托管应用的显示「关闭并停止应用」)。
群成员在网页打开实时画面时,本机才推送对应窗口;没人看时自动停止。
市场
我的 Skill 与市场条目,只读;引入、发布与审核请在网页端操作。
- 顶部可搜索 Skill 和插件,点「刷新」重新加载,点「在网页中打开」跳到网页上的市场。
- 我的 Skill:你引入到个人的条目,显示类型、版本(跟随最新或锁定的版本)、有新版本或被封禁等提示,以及「已启用 / 已停用」。
- 市场:市场里的全部条目,显示作者、团队和引入次数,已引入的标「已引入」。
- 点任一条目打开只读详情:最新版本、作者、引入次数、适用的 Agent、已引入到哪些位置。点「在网页中查看详情」到网页上引入、升级、移除或申请。
连不上服务器时提示「连不上服务器,请检查网络后刷新」。市场的完整用法见 市场与插件。
日志与诊断
连接、ACP、git 与同步日志;运行过程入库前已脱敏。

诊断:打开页面时自动检测以下各项,可能需要半分钟,每项标为正常 / 注意 / 异常 / 跳过:
| 检测项 | 内容 |
|---|---|
| 服务器连接 | 能否连上服务器,以及连接是否加密(HTTPS / HTTP) |
| Agent | 各 Agent 是否已安装、版本是否满足要求 |
| git 凭据 | 本机托管仓库能否访问远端 |
| 磁盘 | 工作区占用与剩余空间 |
| 换行符 | 托管仓库的 core.autocrlf 是否已关闭 |
| 屏幕录制、辅助功能 | 仅 macOS,是否已授权 |
下方两个按钮:
- 「测量延迟与带宽」:测量到服务器的延迟和带宽,结果会上报服务器。
- 「导出诊断包…」:选择保存位置,导出一个 zip,包含脱敏后的日志、诊断结果、版本信息和去掉凭据的配置,可发给管理员排查问题。
最近日志:实时刷新的 daemon 日志,右上角可切换 info / warn / debug 级别。
设置
外观、升级、镜像源、启动项与存储位置。

| 设置 | 说明 |
|---|---|
| 语言 | 中文 / English |
| 主题 | 浅色 / 深色 / 跟随系统 |
| 玻璃效果 | 清透 / 标准 / 着色,调节侧栏、菜单和浮层的透明程度 |
| 版本 | 当前版本;点「检查更新」立即检查,已下载新版本时点「立即重启」完成升级 |
| 自动升级 | 自动下载新版本,重启后生效 |
| 开机启动 | 登录系统后在后台运行 |
| 关闭窗口后隐藏程序坞图标 | 仅 macOS。保留菜单栏图标,可从菜单栏重新打开;后台服务继续运行 |
| 镜像源 | 安装、升级 Node.js 与 Agent 工具时的下载源:淘宝镜像(npmmirror,默认)/ 官方源 / 自定义。自定义需填写 npm registry 和 Node.js 下载地址(index.json 所在的目录) |
| 环境变量 | 启动 Agent 时附加,每行一个 KEY=VALUE,点「保存」后新启动的 Agent 进程生效 |
| 工作区根目录 | 托管工作区与附件目录,只读展示 |
| 备份目录 | 被覆盖的本地修改、中断的半成品,只读展示 |
| 服务器 | 当前绑定的服务器,只出站连接(HTTPS / WSS) |
解除绑定…:确认后本机断开连接,清除团队密钥与托管工作区(/cd 绑定的目录与本机备份保留),并回到 首次引导。此操作不可撤销。