Skip to content

功能页面 ​

本页逐一介绍桌面端左侧栏的各个页面及其用途。

左侧栏分三组:「概览」;「执行」组下有「Agent」「Bot」「工作区」「在线预览」「实时画面」「市场」;「本机」组下有「日志与诊断」「设置」。侧栏底部显示机器归属人、机器名和操作系统。

桌面端偏重「看本机在干什么」。新建 Bot、改 Bot 设置、管理供应商、引入 Skill 等操作在网页上做,页面里的「在 Web 中管理」「在网页中打开」会直接用浏览器打开对应位置。网页上的机器管理见 我的机器与 Bot。

窗口右上角的连接状态在所有页面都可见,旁边的按钮可「在浏览器中打开共工」:

状态含义
已连接 服务器地址在线,可以接任务
连接中 / 重连中正在连接;服务器不可用时按指数退避自动重连
协议不兼容本机版本太旧,服务器拒绝连接,需要升级
token 已吊销 / token 无效账号被停用或机器被吊销,需重新绑定
未运行本机已有别的 daemon 在运行(通常是命令行 gg)
未绑定还没有绑定服务器

窗口底部的状态栏显示心跳、到服务器的延迟、运行中与排队的任务数、ACP 适配器版本,以及本机 daemon 版本和协议版本。

概览 ​

本机执行端状态与正在运行的轮次。

概览

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

Agent ​

本机的 Node.js 与 CLI 运行时:安装升级、检测与供应商。

Agent

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

每个指定到本机的 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、类型和状态(在线 / 已暂停 / 离线)。可「本机打开」在本机浏览器访问,或点「停止」同时关闭群预览并停掉进程;点「···」菜单可「仅暂停后台进程(保留卡片)」(之后可点「重新启动」)或「查看技术详情」(端口、服务名、启动命令)。
  • 仅后台运行(未开放预览):仅当存在尚未绑定任何预览的后台服务时出现,显示状态(启动中 / 运行中 / 已退出 / 启动失败)、端口和启动命令,可「停止」。

在这里操作与在网页群里效果相同,群成员会立即看到变化。预览功能见 结果预览。

实时画面 ​

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 绑定的目录与本机备份保留),并回到 首次引导。此操作不可撤销。

相关页面 ​

基于 Apache License 2.0 开源