本地数据与日志
本页介绍 daemon 在本机保存了哪些数据、日志在哪里、可用的环境变量，以及如何导出诊断包。
命令行 gg 和桌面端共用同一个数据目录，默认是 ~/.gonggong/（Windows 为 %USERPROFILE%\.gonggong\），可用环境变量 GONGGONG_HOME 改到别处。
目录结构
text
~/.gonggong/
├── config.json 绑定信息：服务器地址、机器凭据（token）、归属人
├── settings.json 本机偏好：自动升级开关、镜像源（解除绑定后保留）
├── local.json 手动指定的 Agent CLI 路径
├── providers.json 本机模型供应商与 API Key、本机默认、Bot 单独设置
├── models.json 从各 Agent 探测到的可选模型，上报服务器供网页选择
├── tools-latest.json Node.js / Claude Code / Codex 最新版本的查询缓存
├── adapters/ ACP 适配器（首次运行时用 npm 安装）
├── runtime/ 共工空间托管版 Node.js
├── tools/ 共工空间托管版 Claude Code / Codex
├── workspaces/ 托管工作区：workspaces/<群>/<Bot>/<仓库>
├── backups/ 本机备份：被覆盖的本地修改、中断的半成品
├── logs/ daemon 日志：daemon.<日期>.log
├── updates/ 自动升级下载的新版本（校验通过后才替换）
├── bin/ 命令行使用实时画面时从服务器下载的 gg-cast
├── run/ 运行时生成的临时配置（含供应商设置）
├── probe/ 探测可选模型时使用的临时目录
├── services.pids Bot 启动的托管服务进程记录
└── *.lock daemon.lock 等锁文件说明：
config.json和providers.json含凭据，文件权限仅本人可读写（0600），不要发给别人。- 除
config.json外，其他文件都不含服务器凭据；但providers.json含第三方 API Key。 - 目录会按需创建，没用到的功能不会生成对应目录。
daemon.lock保证同一个数据目录只运行一个 daemon（gg run或桌面端）。- 工作区里的
.gonggong/子目录存放消息附件和托管服务日志，属于工作区的一部分。
本机备份
Bot 运行时如果要覆盖工作区里未提交的本地修改，或者一轮运行被中断留下半成品，daemon 会先把它们存到 ~/.gonggong/backups/：
- 只保存在本机，不上传服务器。
- 查看：
gg workspaces输出末尾的「本机备份 · 不上传」，或桌面端「工作区」页下方同名区域。 gg logout、桌面端「解除绑定…」、机器被吊销时都不会删除备份目录；不需要时手动删除即可。
解除绑定时会删除什么
| 操作 | config.json | 托管工作区 | /cd 绑定的目录 | 本机备份 | 其他设置与供应商 |
|---|---|---|---|---|---|
gg logout | 删除 | 保留 | 保留 | 保留 | 保留 |
| 桌面端「解除绑定…」 | 删除 | 删除 | 保留 | 保留 | 保留 |
| 机器被吊销 / 账号停用 | 删除 | 删除 | 保留 | 保留 | 保留 |
吊销时的删除是尽力而为，不保证彻底。
日志
- daemon（
gg run或桌面端）的日志按天写入~/.gonggong/logs/daemon.<日期>.log，保留最近 7 天。 - 查看：
gg logs（默认最近 200 行 info 及以上），或桌面端「日志与诊断」页的「最近日志」。 - 日志写入前会按规则脱敏：token、密码、API Key、Authorization 等形似凭据的内容会被替换为
[REDACTED]。 gg run同时把日志输出到终端（标准错误），输出级别由GONGGONG_LOG控制；gg doctor等一次性命令只输出到终端，不写日志文件。
诊断包
遇到问题需要找管理员排查时，导出诊断包：
- 命令行：
gg logs --export（默认保存到桌面，文件名gonggong-diag-<日期-时间>.zip），或gg logs --export 路径.zip。 - 桌面端：「日志与诊断」→「导出诊断包…」，选择保存位置。
诊断包是一个 zip，内容如下：
| 文件 | 内容 |
|---|---|
logs/daemon.<日期>.log | 各日志文件的末尾部分，已脱敏 |
diag.json | 导出时 gg doctor 各项检测的结果 |
versions.json | daemon 版本、协议版本、系统与架构、检测到的 Agent |
config.json | 绑定信息，已去掉 token 等凭据 |
local.json | 本机设置，已去掉形似凭据的字段 |
诊断包不包含 providers.json 和工作区内容。
环境变量
| 变量 | 作用 |
|---|---|
GONGGONG_HOME | 数据目录，默认 ~/.gonggong。可用于在一台机器上隔离多份数据 |
GONGGONG_LOG | 终端日志的输出级别，写法同 Rust tracing 的过滤规则，如 info、debug、gonggong=debug。不设置时终端只输出 error 级别 |
GONGGONG_NO_AUTO_UPGRADE | 设为 1 时 gg run 不自动升级，效果同在设置里关闭「自动升级」 |
GONGGONG_BROWSER | 生成预览卡片截图用的浏览器可执行文件路径。不设置时自动查找本机的 Chrome / Edge / Chromium |
GONGGONG_MACHINE_ID | 覆盖用于识别机器的硬件 ID。只在一台主机上运行多份相互隔离的实例（各自一个 GONGGONG_HOME）时使用 |
示例：
bash
GONGGONG_LOG=debug gg run # 终端输出 debug 日志
GONGGONG_HOME=/data/gonggong gg status # 使用另一个数据目录备份与迁移
- 需要备份的：
settings.json、local.json、providers.json（含 API Key，妥善保管）。它们都是本机配置，服务器上没有副本。 - 不需要备份的：
adapters/、runtime/、tools/、models.json等可以重新下载或探测；托管工作区可从仓库重新克隆。 - 换机器：在新机器上重新
gg login（或在桌面端绑定），再重新配置供应商。同一台机器gg logout后重新gg login会恢复原有机器记录和 Bot 绑定。 - 不要把
config.json复制到别的机器使用。