Agentbox v0.1.7

本版新增统一 Claude MCP 管理与客户端镜像更新，并支持从开发构建直接切换到最新正式版。

主要更新

• Claude MCP 管理：用户默认配置与空间覆盖，支持新增、编辑、启停、复制和 mcpServers JSON 导入预览；可检测容器内 stdio / Streamable HTTP 连接并查看工具列表。敏感字段脱敏，已有原生条目需显式接管，保存失败保留草稿，管理配置进入系统备份。
• 客户端更新与回退：「系统设置 → 容器与资源 → 客户端更新」可手动检查、更新和回退，也可按系统时区每日执行。Claude 支持 stable / latest 渠道，Codex 可选同步更新至 latest；自动更新默认关闭。更新保留当前镜像中的浏览器与自定义功能，验证 CLI 版本后才切换，回退会暂停自动更新。
• 开发版切换正式版：标准 Linux/systemd 版本目录中的 dev、预发布和 dirty 构建可直接选择最新正式版，即使开发版版本号更高。页面明确显示「切换到正式版并重启」，保留下载校验、兼容检查、系统备份和健康检查；正式版之间仍不允许降级。
• MCP 界面优化：状态和操作分开，开关控制启停，编辑、复制、删除使用带提示的图标；优化手机布局和更新确认提示。

升级说明

• v0.1.6 升级到本版沿用 schema 9，不新增数据库迁移。管理员在「关于与更新」检查更新，选择 v0.1.7 后升级并重启；也可下载校验后使用包内 deploy/release.py install/activate。
• 从开发构建使用页面切换，需要当前服务端和 deploy/update.py 已包含开发版切换修复。旧开发构建不会因刷新网页自动解除限制；源码或自定义服务布局继续使用手工部署。
• 服务端升级会短暂中断 HTTP/WebSocket 连接，升级前结束正在进行的网页对话。系统备份不包含工作区的一致性快照；重要工作区可另做完整备份。
• 服务端升级不自动更换工作空间镜像。客户端镜像更新后，运行中的空间不打断，停止再启动时生效；选择 stable 渠道不会自动降级 CLI。
• MCP 修改在下一回合聊天、终端连接或空间启动时同步；已运行的终端 Claude 需重启。MCP OAuth 仍通过终端处理。

下载

提供 7 个平台包：服务端 Linux amd64/arm64，以及 abox-link Linux/macOS amd64/arm64、Windows amd64。服务端包附带五个平台客户端，下载后使用同一 Release 的 SHA256SUMS 校验。会话镜像仍由管理员在自己的 Docker 环境构建。

• 完整变更记录
• 安装与升级
• MCP 使用说明
• 客户端镜像更新

验证

• 发布流水线与 CI 全部通过：Go build/test/vet、前端类型与浏览器回归、安装器、漏洞检查、源码及安装包扫描。
• Linux amd64/arm64 发布包均完成容器内运行与备份恢复；amd64 验证真实服务、空间启停、文件/Git、终端用量及重启保留会话。
• 合成 MCP 服务验证工具发现、配置同步、冲突与接管；客户端镜像更新实测保留浏览器及基础运行配置。测试未调用付费模型。
• 部署迁移/回退演练中的 systemd 为模拟；开发版到本正式版的生产页面切换尚待操作验证。

Agentbox v0.1.6

本版新增通用远程浏览器，并修复 Claude 续聊计费与价格维护问题。

• 远程浏览器：完整桌面、多标签、Claude / ChatGPT 快捷入口、按空间保存登录状态、中文剪贴板、文件下载、全屏和三档画质；工具栏适配桌面、手机及浅色/深色主题。
• 代理与体验：修复 Chrome 本地代理地址被 DNS 规则拦截的问题；采用变化区域采集，允许使用共享内存，并降低默认图像质量以减少传输压力。
• 计费修复：Claude 网页续聊按 message ID 持久去重、逐请求计价，避免累计结果重复扣费；使用记录和 CSV 新增缓存命中率。
• 价格目录：支持 models.dev 候选价格、差异预览及可选自动跟随；自定义价格保留，超过 25% 的变动、零价跨越和阶梯变化需人工处理。

升级与启用

• 标准部署可从「关于与更新」升级，或使用包内 deploy/release.py install/activate。数据库自动迁移至 schema 9；升级前保留备份，不可将旧版程序直接连接到不兼容的新库。
• 浏览器镜像需要单独构建并启用。包内提供 scripts/build-browser-image.sh；Linux amd64 使用 Google Chrome for Testing 154.0.8037.57，Linux arm64 使用 Chromium。服务端升级不会自动切换工作空间镜像。
• 网页登录与 CLI OAuth 独立。网页服务消费不进入 CLI 用量流水；升级不会自动重算历史费用、退款或启用价格自动同步。

下载

提供 7 个平台包：服务端 Linux amd64/arm64，abox-link Linux/macOS amd64/arm64、Windows amd64。服务端包包含全部五个平台客户端及浏览器镜像构建配方。

请使用同一 Release 的 SHA256SUMS 校验下载文件。完整变更与启用步骤：

• CHANGELOG
• 远程浏览器
• 安装与升级

安装包不包含用户配置、账号凭证或生产数据；浏览器镜像由管理员本地构建，不发布公共镜像。

Agentbox v0.1.5

本版将源码、安装包和更新入口统一到主仓库，并首次提供管理员网页升级。

• 新安装、版本检查、升级包下载和客户端下载均使用 devilcoolyue/agentbox。
• 管理员在「关于与更新」可执行「升级并重启」：强制校验下载、检查配置/数据库兼容性、停服备份并验证、切换版本、检查服务健康。
• 升级由独立 systemd 任务执行，网页展示进度与日志入口，刷新或断线后可继续查询；自定义服务布局保留手工升级说明。
• Apache-2.0 完整源码开放，历史 v0.1.0～v0.1.4 原始附件已迁入主仓库；旧下载仓库作为兼容镜像保留。

已有安装升级

v0.1.4 及更早版本需先手工升级到 v0.1.5 一次，旧二进制不会自动获得网页升级按钮。无需卸载，首次安装命令不用于升级现有服务。

下载匹配架构的服务端包和 SHA256SUMS，确认所选包校验为 OK，解压到新目录，再执行：

sudo python3 /绝对路径/新版本包/deploy/release.py install --package /绝对路径/新版本包
sudo python3 /绝对路径/新版本包/deploy/release.py activate --version v0.1.5

沿用数据库 schema 8，不新增迁移，保留配置、用户、工作空间、历史和现有工作空间镜像。更早版本仍需遵守 schema 升级和备份回退限制。上述命令适用于标准 /opt/agentbox 独立安装；源码或自定义服务沿用相应部署流程。升级会短暂中断 HTTP/WebSocket，请先结束正在进行的网页任务。

安装 v0.1.5 后，符合标准 Linux/systemd 布局、root、Python 3 和 systemd-run 条件的实例可以从网页升级后续版本。版本切换后不自动回退，避免不兼容的数据库回退。

新安装

curl -fsSL https://raw.githubusercontent.com/devilcoolyue/agentbox/main/install.sh | sudo bash -s -- --version v0.1.5

附件包括 Linux amd64/arm64 服务端、Linux/macOS amd64/arm64 与 Windows amd64 的 abox-link，共七个平台包，另有 release.json 和 SHA256SUMS。服务端包携带五个平台客户端。

构建源码：69a39b50fb003b301a0fc3c4df09f42b799d7ef2。旧下载仓库同步同一份附件，文件与 SHA-256 完全一致；旧版本能从原地址发现过渡版本，v0.1.5 从主仓库获取后续更新。

验证：Go build/test/vet、前端类型与产物一致性、浏览器回归、安装/卸载/升级策略测试、发布包与校验和、Linux Docker 会话/文件/Git/用量/重启、安装迁移与回退演练、依赖漏洞检查及源码/产物敏感信息扫描。部署演练中的 systemd 为模拟调用，未执行用户生产服务升级。

完整说明：安装与升级 · 历史版本与源码映射

Agentbox v0.1.2

历史发布迁移：原始发布日期 2026-09-26。全部安装包、release.json 与 SHA256SUMS 从旧下载仓库原样迁入，未重新构建。
包内构建提交 4855187dfe3b0d583cbbdb8f95a25115204391d8 对应清理后的源码 8ef557ed4595。历史提交哈希清理及标签校正见 发布说明。

Agentbox v0.1.2

• 工作空间默认镜像加入彩色 Bash 提示符、彩色 ls、ll 和完整 Vim，修复旧版 vi 方向键、退格与输入内容不一致的问题。一键安装自动构建此版本镜像。
• 新增价格目录管理：查看候选价格差异、保护自定义价格、手动应用与历史恢复；网页回合开始时锁定价格，历史账单保留入账快照。目录默认不联网、不自动应用价格。
• 文件源码预览支持语法高亮、行号、光标位置、Tab 缩进和全屏编辑，完善浅色、深色及手机布局。
• 优化聊天结果、提示消息和内网状态展示；手机终端增加常用快捷键和软键盘适配。
• 加强发布包与初始化检查，确保 Shell、Vim、tmux 配置完整随包提供。

新安装：

curl -fsSL https://raw.githubusercontent.com/devilcoolyue/agentbox-releases/main/install.sh | sudo bash -s -- --version v0.1.2

支持 Linux amd64 / arm64 服务端；随包提供 Linux、macOS（Intel / Apple 芯片）、Windows 五个平台的 abox-link 客户端。请下载后核对 SHA256SUMS。

已有部署请按 README 的升级流程安装并激活新版本，一键初始化不会覆盖现有数据。工作空间镜像单独升级：在解压后的新包目录执行 sudo env AGENTBOX_IMAGE=agentbox-agent:v0.1.2 AGENTBOX_VERSIONED_IMAGE=agentbox-agent:v0.1.2 bash scripts/build-image.sh，再在系统设置中选择此镜像。已有空间需停止后重新启动才能换用新镜像，终端进程会中断，挂载的工作区文件保留。

构建源码：4855187。精确提交和工具链信息见包内 build.json 与 --version。

验证：Go 构建、测试、vet，浏览器与编辑预览回归，发布包与校验和、敏感信息扫描，真实 Docker 会话/文件/Git/用量/重启、终端 Vim 操作及安装/迁移回归。安装与迁移测试中的下载、systemd 和镜像构建使用模拟调用；工作空间镜像构建与终端测试单独实际执行，不调用模型。

Agentbox v0.1.1

历史发布迁移：原始发布日期 2026-09-24。全部安装包、release.json 与 SHA256SUMS 从旧下载仓库原样迁入，未重新构建。
包内构建提交 e4555ab841de89f7c4e8ed333a0f9955bf3e20d7 对应清理后的源码 5d1266f986f7。历史提交哈希清理及标签校正见 发布说明。

v0.1.1 更新

• 控制台使用最新铺满布局，增加版本提醒、密码显隐及配对码复制。
• 登录及身份请求增加超时和错误提示，失败后可以直接重试；登录完成即解除按钮加载态。
• 安装和升级自动提供 Windows、macOS（Intel / Apple 芯片）、Linux（amd64 / arm64）五个平台的 abox-link 下载，无需手工编译。
• 修复 Oracle Linux / RHEL SELinux 标签导致的 systemd 203/EXEC 启动失败。
• 提供兼容 v0.1.0 默认安装的一键卸载脚本，默认备份配置与数据，也支持显式彻底删除；修复立即重装时的端口占用误判。

安装：

curl -fsSL https://raw.githubusercontent.com/devilcoolyue/agentbox-releases/main/install.sh | sudo bash -s -- --version v0.1.1

从 v0.1.0 全新重装（先卸载，文件默认移入仅 root 可读的备份目录）：

curl -fsSL https://raw.githubusercontent.com/devilcoolyue/agentbox-releases/main/uninstall.sh | sudo bash -s -- --yes

默认卸载保留 Docker、镜像、其他容器和防火墙规则。新安装会生成新的管理员密码。要保留当前数据继续使用，请按 README 的升级流程激活新版本，不必卸载。

构建提交：e4555ab。包内 build.json 和 --version 可核对版本；下载后请验证 SHA256SUMS。

验证：Go 构建/测试/vet、浏览器登录失败与超时重试、归档及客户端一致性检查、敏感信息扫描通过。正式 Linux 包通过真实 Docker 会话、文件/Git、用量及重启测试；安装/卸载/重装测试中的 systemd 和镜像构建使用模拟调用。

v0.1.0 — Linux 一键安装

历史发布迁移：原始发布日期 2026-09-24。全部安装包、release.json 与 SHA256SUMS 从旧下载仓库原样迁入，未重新构建。
包内构建提交 2a916ccbdc173ad120ead5912c3bf93c3a81662c 对应清理后的源码 19c7678494a0。历史提交哈希清理及标签校正见 发布说明。

Agentbox v0.1.0 正式版，支持 Linux 一键安装与浏览器 AI 编码工作空间。

在 Linux 服务器执行：

curl -fsSL https://raw.githubusercontent.com/devilcoolyue/agentbox-releases/main/install.sh | sudo bash

安装器自动选择 amd64/arm64 发布包、校验 SHA-256、构建固定版本的 Claude/Codex 工作空间镜像，生成管理员密码并配置 systemd 服务。Ubuntu 22.04+、Debian 12+ 自动准备缺失依赖和 Docker；其他 systemd 发行版需预装依赖。宿主机无需 Go 或 Node。

安装后打开 http://服务器IP:8180，使用终端显示的 boxadmin 和随机密码登录，再添加模型账号。首次镜像构建需要访问基础镜像仓库、Debian 软件源和 npm。公网访问需放行防火墙/安全组，长期使用建议配置 HTTPS。

• Linux 服务端：amd64、arm64。
• abox-link 客户端：Linux/macOS amd64、arm64，Windows amd64。
• 附件包括 SHA256SUMS 和 release.json。安装包携带二进制、运行所需脚本/镜像配方、用户说明与许可证。
• 已有安装不会被覆盖，升级使用包内 deploy/release.py。完整说明见安装与维护。

已验证包完整性、Linux 实际服务登录、工作空间、文件/Git、终端用量、SIGTERM 重启、备份恢复和安装演练。安装演练中的镜像构建和 systemctl 使用模拟命令，干净主机上的 apt 安装与开机自启尚未验收。SHA-256 提供完整性校验，不是独立数字签名。

Agentbox v0.1.4

历史发布迁移：原始发布日期 2026-09-27。全部安装包、release.json 与 SHA256SUMS 从旧下载仓库原样迁入，未重新构建。
包内构建提交 6576d45a2e3b137a61bb3f5a781fda717b715639 对应清理后的源码 adaad57a4551。历史提交哈希清理及标签校正见 发布说明。

本版改进 Git 管理与手机端操作体验。

• Git 管理成为独立页面，包含使用指南、提交身份、仓库连接；支持深链接、刷新恢复、浏览器前进/后退，连接编辑和授权管理在页内完成。
• 手机端通过顶栏切换系统设置与 Git 分区，说明按需展开，低频操作收进「更多」，长按图标可查看操作说明。
• 手机端文件预览保留固定关闭入口，Git 变更支持列表与差异详情切换；桌面端保留分栏导航与文字操作。
• 统一主控制台与 abox-link 面板图标、按钮状态及无障碍名称。

已有安装升级

v0.1.3 可保留配置、用户、工作空间和历史升级。本版沿用数据库 schema 8，无新增迁移，工作空间镜像可继续使用。

下载匹配架构的服务端包与 SHA256SUMS，校验并解压到新目录，再运行新包内的工具：

sudo python3 /绝对路径/新版本包/deploy/release.py install --package /绝对路径/新版本包
sudo python3 /绝对路径/新版本包/deploy/release.py activate --version v0.1.4

以上适用于 /opt/agentbox 独立安装布局；源码部署沿用原部署流程。升级前确认备份，激活会短暂断开 HTTP/WebSocket。首次安装脚本不会升级已有安装，无需卸载重装。更早版本升级仍需遵守 v0.1.3 的 schema 3 → 8 迁移与备份回退要求。

新安装

curl -fsSL https://raw.githubusercontent.com/devilcoolyue/agentbox-releases/main/install.sh | sudo bash -s -- --version v0.1.4

附件包含 Linux amd64/arm64 服务端、Linux/macOS amd64/arm64 与 Windows amd64 的 abox-link，共 7 个平台包，以及 release.json、SHA256SUMS。服务端包内同时包含五个平台客户端。

构建源码：6576d45a2e3b137a61bb3f5a781fda717b715639。版本、提交与构建时间可通过 build.json 和 --version 核对。

验证：Go 构建/测试/vet、前端类型检查/构建、浏览器回归（6 种屏宽、深浅主题、Git 管理导航与生命周期、文件预览）、发布包与校验和、Linux Docker 会话/文件/Git/用量/重启、安装迁移与回退演练、源码与产物敏感信息扫描。部署演练中的 systemd 为模拟调用。

Agentbox v0.1.3

历史发布迁移：原始发布日期 2026-09-26。全部安装包、release.json 与 SHA256SUMS 从旧下载仓库原样迁入，未重新构建。
包内构建提交 4f21454474b8d361de5169e0522b0401d4bec90b 对应清理后的源码 639d038aebca。历史提交哈希清理及标签校正见 发布说明。

Git 工作流正式接入远程账号与仓库授权，本地提交仍不自动推送。

• 用户级 Git 连接：GitHub/GitLab OAuth、HTTPS Token、SSH；跨空间复用，空间默认与仓库 remote 显式绑定。
• 克隆、获取、快进拉取、推送预览与确认；分支/remote 管理、PR/MR 草稿创建、操作进度、取消与审计。
• 企业 Git 支持公司 CA、内网隧道和 SSH 主机公钥校验；管理员可共享专用账号并限制用户读写。
• 30 分钟终端授权，默认只读、显式允许推送、随时撤销；长期 Token/私钥保留在服务端。
• Git 凭证加密及配套备份恢复，支持停服后的主密钥轮换和中断恢复。
• SSH 依赖升级至 golang.org/x/crypto v0.56.0，修复 GO-2026-6354 / GO-2026-6355。

已有生产环境升级

v0.1.2 可保留配置、用户、工作空间和历史升级至 v0.1.3，无需卸载重装。下载并校验对应架构的包与 SHA256SUMS，解压到新目录，然后使用新包内工具：

sudo python3 /绝对路径/新版本包/deploy/release.py install --package /绝对路径/新版本包
sudo python3 /绝对路径/新版本包/deploy/release.py activate --version v0.1.3

以上适用于 /opt/agentbox 独立安装布局；源码/systemd 部署沿用原部署流程并事先验证备份。升级会短暂断开 HTTP/WebSocket。数据库自动迁移到 schema 8；独立安装 activate 会停服备份并验证后切换，迁移后不能直接回退旧二进制，需恢复升级前配套备份。控制台提供更新提示，尚不执行网页一键升级。首次安装脚本不会升级已有安装。

v0.1.2 默认镜像已包含 Git/Python，可继续使用；自定义镜像需提供 Git、timeout、Python 3，并保证容器可达服务端网桥。服务端升级不自动切换工作空间镜像。OAuth 需管理员注册平台应用；真实平台/企业 SSO 权限按现场配置。

新安装

curl -fsSL https://raw.githubusercontent.com/devilcoolyue/agentbox-releases/main/install.sh | sudo bash -s -- --version v0.1.3

附件包括 Linux amd64/arm64 服务端与 Linux/macOS/Windows 五个平台的 abox-link、release.json、SHA256SUMS。服务端包内同时包含五个平台客户端。

构建源码：4f21454474b8d361de5169e0522b0401d4bec90b。精确信息见 build.json 与 --version。

验证：Go 构建/测试/vet、前端构建与浏览器回归、发布包/校验和与敏感信息扫描、真实 Docker 会话/文件/Git/用量/重启；合成 HTTPS/SSH 上游经真实 Linux 容器验证 Git 网桥与终端授权。安装/迁移测试中的 systemd、下载和镜像构建为模拟调用；未宣称真实平台注册应用或企业 SSO 已验收。

已用 v0.1.2 与 v0.1.3 实际发布包在临时 Docker 环境演练 schema 3 → 8 升级，验证原登录、空间、运行容器、文件保留及旧备份验证/恢复。