系统
设置 → 系统 —— 在应用中标记为 系统管理 —— 是运维界面:“管理网络代理、应用更新和语言偏好”,外加第四个面板,用于备份和恢复一切。四个相互独立的部分,各自保存;这里没有任何东西需要页面级的保存。
软件更新
检查所配置的发布来源是否有更新版本的 Codeg,并在可以的地方就地安装它。面板显示你的当前版本和一个检查更新按钮;检查之后,它会记下时间(“上次检查…”),并显示 “你已是最新版本” 或那个正等待你的发布版本的详情 —— 它的版本、日期和完整的发布说明。
升级按钮的行为取决于你在哪里运行 —— 这是桌面与服务器真正有所不同的唯一界面:
- 桌面应用 —— 升级到 vX 会下载该发布版本、显示进度条,并在准备就绪时切换为 重启以更新;点击它会重新启动进入新版本。这是 Codeg 内置的自动更新器。
- 可自更新的服务器 —— 支持就地更新的独立
codeg-server(或 Docker)行为相同:下载、进度、重启。关于服务器更新如何工作,见部署。 - 任何无法自更新的情况 —— 较旧的远程服务器会回退到一个 查看 vX 发布 按钮,它会打开 GitHub 发布页面,让你手动更新它。
回滚(仅限服务器)
可自更新的服务器会保留上一个二进制文件,因此升级之后会出现一个 回滚 按钮 —— “恢复到上次升级前所安装的版本。” 它是为那种只在后来才浮现的回归而准备的 —— 也就是在自动的试用窗口检查早已通过之后。桌面应用通过操作系统的安装程序更新,不提供这一项。在 Docker 上,就地升级只在容器被重建之前有效 —— “若要保留它,请拉取或构建新版本的镜像并重建容器。”
如果检查或安装失败,原因会就地显示 —— 无法访问的更新来源、网络错误,或下载或安装失败 —— 通常是连接性问题,下面的代理面板可以处理它。
网络代理
将 Codeg 自身的网络流量通过代理路由。勾选 启用系统代理 并输入一个 代理地址;此后,“后续的网络请求会优先使用此代理(包括 ACP 聊天、智能体安装和 Git 远程操作)。”
该地址接受一个 http、https 或 socks5 URL —— 占位符是 http://127.0.0.1:7890,一个典型的本地代理。代理启用后它是必填的(打开代理而不填地址会被拒绝),且该设置随手保存 —— 切换复选框或离开该字段都会提交它。它仅在 启用系统代理 打开时生效;取消勾选即可重新直连。
这就是承载 Codeg 一切对外请求的代理 —— 你的账户所认证的 Git 操作、智能体安装、模型流量。若要在应用启动之前从环境中设置代理,见配置。
语言
设置 Codeg 自身界面的语言 —— 菜单、按钮、设置。应用语言 可以是 跟随系统 或十种之一:英语、简体中文和繁体中文、日语、韩语、西班牙语、德语、法语、葡萄牙语,以及阿拉伯语。跟随系统区域设置时,“不支持的语言会回退到英语。” 该选择立即生效并被记住。
(这是桌面或浏览器应用的界面语言 —— 与任何单个对话的语言,或本文档站点的语言无关。)
备份与恢复
一个便携的 Codeg 安装快照 —— “导出你的 codeg 数据的便携备份,或从中恢复。” 两个标签页:备份 和 恢复。
备份
导出会写出一个包含你的数据库和上传内容的 .codegbak 归档文件。有两个选项来塑造它:
- 包含对话内容 (默认关闭) —— “同时归档智能体 CLI 的会话记录(Claude、Codex、Gemini……)。会增大体积。” 关闭时,备份只是你的 Codeg 数据;打开时,它还会拉入底层智能体 CLI 各自的会话记录文件。
- 口令 (可选) —— 加密归档。留空则 Codeg 会以琥珀色警告 “此备份将以明文包含机密(API 密钥、令牌)” —— 因为它确实如此;请把它存放在安全的地方。设置一个,则相反的告诫适用:“如果你丢失了它,备份将无法恢复。”
导出备份 会构建它 —— 桌面应用保存一个文件,浏览器会话则下载一个。
恢复
选择备份文件(.codegbak 或 .zip),Codeg 会在做任何事之前先检查它。如果它是加密的,你会被要求输入口令;然后一个 备份详情 卡片会显示它是何时制作的、由哪个应用版本制作,以及它是否兼容 —— 来自比你正在运行的更新的 Codeg 的备份无法恢复。
恢复是一次完全替换,面板对此直言不讳,用红色标出:“恢复会替换所有当前的 codeg 数据(数据库和上传内容)。你的当前数据会先被快照,以便可以恢复。” 你要通过一个 替换所有数据? 对话框确认,之后 Codeg 会暂存恢复并重启以应用它。
动手之前有两件事值得了解:
- 桌面备份不携带你的钥匙串机密。 “桌面端的 GitHub/聊天令牌存放在你操作系统的钥匙串中,不包含在内;恢复后请重新输入它们。” 在服务器上,这些相同的令牌存放在一个确实在备份中的文件里 —— 区别正是版本控制下所述的那种系统密钥环划分。
- 恢复对话内容是单独的选择。 如果备份包含了智能体 CLI 的会话记录,你要选择它们落在哪里 —— 跳过它们、把它们放进一个安全的旁侧文件夹,或把它们写回原始的 CLI 位置(附带冲突扫描和可选的覆盖),好让智能体重新看到它们的历史。
备份作用于这台机器
备份和恢复作用于实际运行 Codeg 的那台机器的数据。如果你身处一个连接到远程工作区的桌面应用中,该面板会被禁用,并附注 “请直接从那台服务器管理它的备份” —— 这里的原生文件对话框与远程服务器的存储对不上。
值得了解
- 四个面板,四次独立的保存。 代理、语言和更新检查各自行事;没有页面级的保存,改动其中一个绝不会触及另一个。
- 桌面和服务器的更新方式不同。 桌面应用自动安装并重新启动;服务器就地更新并重启(且可以回滚);旧的远程服务器只是给你链接到发布页面。同一个面板,三种行为。
- 未加密的备份就是明文机密。 除非你设置口令,否则 API 密钥和令牌会以明文随行 —— 请加密它,或把文件保存在可信之处。Codeg 一般如何处理机密,见隐私与安全。
- 恢复是替换,但可逆。 它会整体换入备份的数据库和上传内容 —— 但会先快照你的当前数据,因此一次误操作的恢复可以被撤回。
- 代理是应用级的。 一旦打开,它就同时承载 git、智能体安装和模型调用 —— Codeg 对外的一切都经由这一条路径。