Repository navigation
Conversation
1. 插件安装与更新时，可等待在途请求完成，失败后自动恢复原状。 2. 网络请求增加备用地址与 DNS 解析，提升连接稳定性。 3. 签到状态记录与展示更准确。 4. 模型绑定冲突提示更明确。 修复BUG 1. 修复自定义提供商状态同步失败的问题。 2. 修复部分情况下模型绑定冲突未正确提示的问题。 更新 1. 新增账号设置页面，集中管理提供商连接、凭证、转发行为和出网代理。 2. 新增 DeepSeek 网页账号支持，可通过网页登录或粘贴令牌添加。 3. 模型管理支持思考等级绑定、能力配置、可见性标记和批量操作。 4. 新增全局路由参与范围设置，可选择自动参与或仅限指定提供商。
2. 新增：路由作用范围，支持全局、模型级与提供商级范围分别配置参与账号。 3. 新增：路由策略（顺序 / 轮换 / 提供商优先）与会话粘滞模式（自动 / 会话 / 每轮 / 关闭），可在范围内分别设定。 4. 优化：会话粘滞按模型分别计有效期，列表展示会话标识、活动与剩余时间。 5. 更新：路由接口返回作用范围、配置快照与会话标识，决策回放更完整。 6. 更新：补齐路由相关中英日韩葡繁五语文案；手机端路由页同步适配。 7. 修复：README 支持矩阵中 Raccoon 参考图编辑的描述缺失（已与中文一致）。
1. 路由工作台：路由页重构为「工作台 / 执行 / 配置」三栏，按路径聚合会话，可按会话或账号搜索。 2. 路由作用范围：支持全局、模型级与提供商级范围分别配置参与账号。 3. 路由策略与会话粘滞：新增顺序 / 轮换 / 提供商优先策略，及自动 / 会话 / 每轮 / 关闭粘滞模式，可在范围内分别设定。 4. 会话粘滞按模型分别计有效期，列表展示会话标识、活动与剩余时间。 5. 路由接口返回作用范围、配置快照与会话标识，决策回放更完整。 2. 其他更新 1. 补齐路由相关中英日韩葡繁五语文案。 2. 手机端路由页同步适配（首页 / 更多 / 代理 / 请求页）。 3. 修正 README 支持矩阵中 Raccoon 参考图编辑描述缺失。 4. 网关依赖 reqwest 增加 system-proxy 特性。
2. 新增：路由页模型配置可一键「删除独立配置」，确认后直接回到继承全局，不必先切「继承」再保存。 3. 修复：豆包工作的生图请求被会话式分支截走，导致上游报「messages 必须包含消息」，与账号无关。 4. 更新：设置页左栏分类移除自带的旧选中样式，与主侧栏共用同一套导航外观。 5. 更新：补齐路由相关中英日韩葡繁五语文案，重建桌面前端产物。
…、触发阈值可在「设置 → 网关 → 图片压缩」调整，关掉即恢复原样。 2. 新增：DeepSeek（dsh）客户端接管 —— 按它自己的 settings.yaml 写自定义提供商，密钥单独存到 .credentials.yaml，改完刷新页面即生效。 3. 新增：Trae 模型 ID 收敛 —— 去掉网关照加上去的 -solo 后缀，存量配置（模型规则、路由、Key 白名单、助手、会话、限额、目录缓存）一次性迁移；旧请求名仍然可用。 4. 新增：路由工作台新增「模型」筛选 —— 模型下拉只列当前时间窗内真的发过请求的模型，选中后不再只剩它自己。 5. 新增：路由页模型配置可一键「删除独立配置」，确认后直接回到继承全局，不必先切「继承」再保存。 6. 优化：插件安装 / 卸载 / 启停可等待在途请求完成，失败自动恢复原状。 7. 优化：上游请求增加备用入口与 DNS 解析容错，只作用于可信 HTTPS 来源，不改变账号选择与代理出口。 8. 优化：更新检查补上「有新版本但没有本机安装包」的诊断 —— 说明这一版实际传了哪些文件、本机要什么后缀。 9. 优化：更新页支持说明文案更贴近实际情况，赞助弹窗措辞重写。 10. 优化：账号存储增加快照缓存与变更版本号，减少重复读库。 11. 优化：选路与请求准备搬到阻塞线程池，减少长请求期间的调度抖动。 12. 优化：签到状态记录与展示更准确；模型绑定冲突提示更明确。 13. 修复：豆包工作的生图请求被会话式分支截走，导致上游报「messages 必须包含消息」，与账号无关。 14. 修复：自定义提供商状态同步失败的问题。 15. 修复：部分情况下模型绑定冲突未正确提示的问题。 16. 更新：设置页左栏分类移除自带的旧选中样式，与主侧栏共用同一套导航外观。 17. 更新：补齐路由、图片、更新相关中英日韩葡繁五语文案。 18. 更新：手机端模型页支持未挂载映射提示与清理，签到 / 计划 / 账号页同步桌面端改动。 19. 更新：发版规范对齐新的发布链路说明。 20. 版本：3.3.0-beta.6 → 3.4.0
…管理、提供商选择与连通性测试；视觉分析可绑定提供商、模型与思考等级；面板可把 Skill / MCP 配置安装或卸载到本机客户端，手机端同步工具页。 2. 新增：AI 助手支持文本附件与账号导入 —— 可在对话里上传 JSON / .info 文件，模型能读取附件并把凭证文件导入成账号，整库导出文件走批量导入。 3. 新增：Tabbit 国内版 / 国际版账号入口 —— 支持粘贴网页 Cookie / JWT，国内站支持手机号登录。 4. 新增：Kiro 提供商接入（由插件实现）—— 对话、工具、思考、图片输入、自动续期、在线模型目录与余额；支持网页登录、导入 kiro-cli / Kiro IDE 登录态和 API key。Kiro 已从停用名单移出，界面可见。 5. 新增：AStudio（讯飞星辰）提供商接入（由插件实现）—— 手机号验证码 / 账号密码登录（含极验滑块）与粘贴 modelBearerToken；余额、每日签到、OpenAI Responses 对话。 6. 优化：登录页拆成独立脚本，登录时不再下载整份主面板脚本；构建校验同步覆盖登录脚本。 7. 优化：管理面板启用 gzip 响应压缩，远程打开面板更快。 8. 优化：Kiro / AStudio 余额按额度窗口展示；无分组的长读数窗口改为紧凑行，和 Antigravity / OpenCode Go 的余额样式一致。 9. 优化：AStudio 登录方式收敛为两种，手机号 / 密码登录固定用应用内嵌窗口，不再让用户选择打开方式。 10. 优化：云同步 WebDAV / S3 支持自定义 User-Agent，兼容按 UA 校验客户端类型的服务。 11. 优化：模型映射允许中文等非 ASCII 名称（例如千问办公的「高级 / 标准」）。 12. 优化：日志与请求统计的保留期 / 容量裁剪改为批量执行，列表的三个计数合并为一次扫描，降低长期运行和频繁轮询的开销。 13. 优化：凭证刷新增加结果核验 —— 适配器报成功但凭据没有推进时明确报错；自动维护与手动刷新共用同一判据。 14. 优化：自定义提供商账号可清除单独保存的上游地址，改回跟随提供商；设置页按账号实际地址显示请求端点。 15. 优化：请求统计补充 Loomy 生图积分、Cline 费用等读数；生图响应顶层的积分消耗也计入报表。 16. 修复：提供商适配问题 —— CatPaw 工具参数 / Schema 深度放宽到 32；MonkeyCode 上下行按官方客户端封装并补齐审批；Raccoon 补齐桌面端身份头与请求 id；Accio 必带设备指纹；AutoClaw、WorkBuddy、ZCode、Kuku 的刷新与签到问题（详见插件日志）。 17. 更新：补齐工具页、账号、助手相关五语文案；重建桌面前端、登录脚本与手机端产物。 18. 版本：3.4.0 → 3.4.1
1. 新增：路由组，跨提供商、跨模型组合成一个对外模型 ID，可配置参与成员、顺序与失败后备选。 2. 新增：路由草稿预演，不发请求、不耗额度，展示候选、跳过原因与执行路径。 3. 新增：压缩路由，识别 ZCode 上下文压缩请求时切换到指定模型，普通对话仍走原模型。 4. 新增：客户端识别，按软件标识归类请求，支持内置规则、自定义规则与来源声明。 5. 新增：服务端一键更新，Windows 服务与 systemd 由受限升级进程校验、替换并确认新版运行。 6. 新增：MonkeyCode 提供商，桌面端官方页登录自动读取登录态，含滑块与短信验证。 7. 新增：签到领取验证，ZCode 与豆包工作需人工验证时给出提示，回查确认避免重复领取。 8. 优化：网页搜索聚合标准服务与已有账号能力，可绑定账号；工具执行增加超时上限。 9. 优化：账号余额展示即将到期份额与倒计时，单位未知、仅比例的读数单独标注。 2. 其他更新 1. 更新：六语文案补齐路由组、压缩路由、客户端识别、服务端更新与签到验证等条目。 2. 更新：六份安装文档与打包脚本同步一键更新、旧安装接入及环境变量开关。 3. 更新：重建桌面前端、手机端与 Service Worker 产物，刷新前端 i18n 资源。 4. 新增：手机端 Android 支持选择 APK 更新来源。 5. 更新：AGENTS.md 补充反代提供商问题的排查规范。 6. 更新：网关依赖补齐系统代理、更新源与 GitHub 访问配置所需能力。
2. 优化：路由配置恢复“配置列表、当前配置、账号组”的三栏画布布局，默认打开路由配置；配置卡片垂直居中，外层内边距统一为 10px，精简创建弹窗和冗余说明。 3. 优化：模型筛选支持搜索，默认“全部”展示现有账号，选择具体模型后只展示对应账号组；移除配置卡片中的选路预演区域。 4. 优化：请求回放改为简洁列表与执行时间线，按请求当时的快照展示尝试、切换和跳过原因，区分响应到达与首帧时间。 5. 优化：全局默认直接管理账号启用与禁用，与账号页同步并即时生效；其他路由仍独立控制参与名单。旧版全局参与设置转换前列出受影响账号并要求确认。 6. 优化：恢复账号积分到期倒计时、到期近远排序快捷入口，以及整组和单账号设置按钮；消耗规则修改后同步刷新顺序，保留独立路由顺序和未保存的其他修改。 7. 新增：压缩路由，可为 ZCode 上下文压缩请求指定模型，普通对话仍使用原模型。 8. 新增：客户端识别，支持内置规则、自定义规则和来源声明，并在请求记录与报表中展示识别信息。 9. 新增：标准 Windows 服务与 systemd 部署支持面板一键更新，下载后独立校验、备份替换并确认新版启动；安装脚本兼容旧安装接入并保留已有配置。 10. 新增：MonkeyCode 国内版、国际版桌面内嵌网页登录，登录后自动读取凭证，保留用户手动完成页面验证的流程。 11. 优化：签到与领取补充人工验证提示和结果回查，减少重复领取，完善 ZCode 与豆包工作相关记录。 12. 优化：网页搜索可组合标准搜索服务与已有账号能力，支持账号绑定；工具执行增加超时限制。 13. 优化：账号余额展示即将到期份额和倒计时，单位未知、仅提供比例的读数单独标注；Android 手机端支持选择 APK 更新来源。 14. 移除：桌面端与手机端的 LobsterAI 新增账号入口，已有账号的显示与调用保持不变。 15. 更新：同步六语界面文案、六份安装文档及相关打包脚本，重建桌面前端、手机端与多语言资源。 16. 版本：3.4.1 → 3.4.2
- 设置页网关新增「第三方模型回答完自动折叠过程」开关，默认关闭 - 为 Codex 来源的 /v1/responses 响应补 phase 阶段标记，回答完折叠推理与命令过程 - 新增 GET/PUT /api/reasoning-collapse 管理接口，桌面桥与网页桥同步接线 - 流式、非流式聚合与上游完整响应三条回程共用同一阶段判据 - 输出预算用尽与内容过滤的截断响应不补阶段标记，避免半截答案被当作收尾 - 客户端归类值提取为常量，阶段标记判据与请求日志客户端列同源
- 调试报文限量保留、正文合计与单条体积设上限，超限淘汰最旧记录 - 大请求及时释放原始字节，避免解析与转发期间长期保留多份正文 - 请求终态与限额事件在同一事务内提交，在途状态最多每秒写入一次 - 日志每 64 条、请求统计每 128 次记账或每 60 秒批量维护 - 日志查询与统计加缓存，请求总数用内存缓存，无筛选不再全表计数 - SQLite 检查点阈值提高到 10000 页，新库启用增量回收 - 图片逐张压缩，避免一次性复制全部图片地址 - 调试关闭时清理历史快照并停止详细日志，同类余额查询失败 15 分钟内去重 - 更新检查复用成功结果，减少重复网络请求
1. 新增：QuWork 接入网关，支持导入本机登录态或粘贴凭证 JSON，区分模型凭证与账号凭证。 2. 新增：编程会话，连接自有 HAPI 后台，在面板与手机端使用电脑上的 Codex、Claude Code。 3. 新增：图片兼容，模型不识图时可辅助识图或切换视觉模型，支持按模型配置与备选顺序。 4. 新增：工具服务生图，复用已有账号经 MCP / Skills 生成或编辑图片，任务编号可回查。 5. 新增：自动维护，定期刷新临期凭证与更新模型目录，自动和手动共用逐项结果记录。 6. 新增：活动福利与权益，支持限时活动、权益兑换、月度赠送查询及果办免费套餐开通。 7. 新增：客户端接入配置可搜索多选模型，自动填入能力，写入前预览改动并备份。 8. 优化：统计报表重做，新增用量趋势、分布排名、缓存命中率与活跃热力图。 9. 优化：代理不可用时明确失败且不改走直连，删除代理前列出受影响账号。 10. 优化：云同步按实质变化自动上传，可设最小间隔，失败退避重试并保留本机改动。 2. 其他更新 1. 新增：页面自动刷新间隔、阅读模式与未挂载映射批量删除。 2. 优化：签到与领取结果待确认时只回查不重复提交，人工验证提示更明确。 3. 优化：搜索、视觉与生图共用网关配置，MCP 安装仍在桌面端完成。 4. 更新：六语文案补齐上述功能，重建桌面前端、手机端与多语言资源。 5. 更新：手机端同步生图、编程会话、自动维护与自动刷新页面。
1. 优化插件页操作入口与诊断信息，集中提供检查更新、刷新、设置、从文件安装、从 npm/GitHub 安装与诊断。 2. 优化更新页对各 GitHub 下载线路的展示，显示限流等待、上次结果与可重试状态。 3. 优化签到中心活动与体验套餐布局，减少重复说明，一屏可查看更多账号。 4. 优化图片兼容设置说明，将通用说明与各模型配置分开呈现。 5. 优化本机 Codex 会话发送体验，结果不确定时不会自动重复执行。 6. 优化脚本插件更新体验，更新前等待在途任务结束，失败时恢复原插件。 7. 优化工具调用兼容性，减少自定义工具或历史记录导致的请求失败。 ### 修复BUG 1. 修复更新检查遇到 GitHub 限流时提示不完整的问题，现在会显示等待时间并提示可切换其他线路。 2. 修复部分客户端在对话中调用工具时可能失败的问题。 3. 修复关闭应用后本机 Codex 后台进程可能残留的问题。 4. 修复脚本插件升级失败后可能丢失原插件的问题。 ### 更新 1. 对话页新增本机 Codex 支持，可在电脑与手机间继续会话、审批操作并共享官方终端。 2. 插件页支持从 npm、GitHub、Magpie 社区安装与管理脚本插件，提供启停、提供商管理、签到授权、更新与卸载。 3. 新增 MiniMax Code、DeepAI Code、Cloudflare Workers AI、Codar、JoyCode、Agnes Code、River、WPS 灵犀等社区插件入口。 4. 添加账号支持社区插件声明的动态登录方式，包括内嵌窗口登录、设备码/回调提交与本机客户端导入。 5. 图片兼容设置改为按模型名单配置辅助识图或切换视觉模型，支持备选模型、当前路由内优先与统一思考等级。 6. 签到中心活动福利支持按账号查看领取状态，并提供全部、未领取、已领取筛选与批量查询。 7. 路由工作台增强请求回放，展示耗时分段、候选账号、尝试结果、最终承载及当时与当前配置对比。 8. Agent 接管页完善 Claude Code、Codex、Kimi Code 等客户端的模型菜单、上下文、图片与思考等级配置。 9. 账号页额度展示补充剩余天数/小时/分钟、窗口额度与时间、额度详情和数据来源说明。 ### 移除 移除侧边栏中的「AI 助手」旧名称，统一使用「对话」。
仅采纳原始请求提前释放、图片逐张处理、调试开关轻量读取、终态与限额同事务提交，以及在途状态限频写入。 补齐异常收尾：直接保存最后实时快照与中断终态，保留首次错误和手动终止原因，迟到状态不覆盖终态。限额维持请求 ID 幂等，统计失败时保留独立台账降级路径。 保持调试正文采集、历史保留上限、批量维护节拍、更新缓存和 SQLite 参数不变。 Co-authored-by: Lucas <57995614+aimod-cc@users.noreply.github.com>
保留原贡献者提交，适配当前 beta。统一正常结束与截断判据，空工具列表按未调用工具处理；阶段兼容仅使用严格客户端识别，不跟随报表规则。补充错误、缺少结束信号和未知结束原因的阶段保护，重新构建设置页和多语言资源。
统一桌面与手机端的模型查询，支持提供商名称、能力来源与自定义模型；恢复 LobsterAI 新增入口，同步前端产物与 Trae 完整性检查说明。
- scripts/omarchy-agent2api.sh：服务名 / 发布端口 / 数据目录全部从 docker compose config 读取，不再硬编码；新增 doctor 自检、一致性 backup / restore、build 子命令（走宿主网络，绕开 bridge 访问 GitHub 超时的 Cargo 依赖拉取） - scripts/omarchy-compose.yml：独立于根 docker-compose.yml 的加固版 —— 默认只发布 127.0.0.1、宿主端口 / 容器名 / 镜像 / uid-gid 可用 .env 参数化、支持预置管理员与第一把网关 Key - 对照 3.4.x 核实：/health、AGENT2API_PROXY_API_KEY、EXPOSE 3065、 HEALTHCHECK、data 卷、Dockerfile 构建参数均按新版结构适配 - .gitignore 增加 backups/（backup 归档目录不入库）
- install 六份语言一一对应新增「Arch / Omarchy：本机源码部署（Docker）」 小节：pacman 依赖、.env 参数表、脚本命令、已知坑（构建期 GitHub 超时、 容器内 GitHub 不通）、数据备份口径、systemd ProtectHome 限制 - 局域网访问一节补一句：omarchy compose 部署默认只发布回环， 局域网访问改 .env 的 AGENT2API_BIND_ADDRESS - 六份 README 的 Docker 速查表下各加一行指向安装文档该节的链接 （遵守 AGENTS.md：安装细节只进 install 文档，README 只留速查表）
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: b71413d897
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| if [ -n "${AGENT2API_DATA_DIR:-}" ]; then | ||
| printf '%s' "$AGENT2API_DATA_DIR" | ||
| return |
There was a problem hiding this comment.
When AGENT2API_DATA_DIR is set while using the default Compose file, this changes only the path used by the script; the container still mounts ./data:/data. As a result, backup can archive an unused directory and restore can write to a directory the gateway does not use. Keep the override aligned with the Compose mount, or reject it for this configuration.
Useful? React with 👍 / 👎.
| *) die "up 只接受 --build" ;; | ||
| esac | ||
| compose ps | ||
| wait_health || true |
There was a problem hiding this comment.
If the container never becomes healthy within the configured timeout, wait_health returns failure but || true makes up exit successfully. Callers and automation therefore cannot distinguish a healthy startup from an unavailable service, despite this command promising to wait for /health.
Useful? React with 👍 / 👎.
| local image="${AGENT2API_IMAGE:-agent2api:local}" | ||
| case "$mode" in | ||
| --bridge) docker build -t "$image" "$ROOT" ;; | ||
| "") docker build --network host -t "$image" "$ROOT" ;; |
There was a problem hiding this comment.
When .env sets the supported AGENT2API_IMAGE override but it is not exported in the caller's shell, this builds the default agent2api:local tag while Compose up references the custom tag. The subsequent startup may reuse a stale custom image or trigger a regular Compose build, defeating the documented host-network workaround.
Useful? React with 👍 / 👎.
| # https://curl.se/docs/http-cookies.html | ||
| # This file was generated by libcurl! Edit at your own risk. | ||
|
|
||
| #HttpOnly_127.0.0.1 FALSE / FALSE 1796580228 agent2api-panel 1a1c0df67133145d48e6fcf0f851690f0af35270be8b0dc084502f181ab5b5ac.0e65f515f2f7441ecbfeee07efb80a620f6eede890eddce198f1d6b307f50531ed6aef7623121e274556561c36a98e14 |
There was a problem hiding this comment.
This tracked cookie jar contains an agent2api-panel access/refresh token pair for 127.0.0.1 and expires on 2026-12-06. If the gateway that issued it is still running or reachable, anyone who can read the repository can replay it as an administrator and access that instance's management APIs; revoke the session and remove the jar.
Useful? React with 👍 / 👎.
| if [ -e "$dir" ]; then | ||
| mv "$dir" "$keep" | ||
| fi | ||
| mkdir -p "$(dirname "$dir")" | ||
| tar -C "$(dirname "$dir")" -xzf "$archive" |
There was a problem hiding this comment.
If the archive is corrupt, incompatible, or fails to extract, this has already moved the current data directory aside. With set -e, the script exits through the trap and restarts the service without restoring that directory, so the gateway can come back against a missing or partially extracted data directory even though restore failed. Stage and validate the archive before swapping directories, or restore the saved directory on failure.
Useful? React with 👍 / 👎.
概要
把
feat/omarchy-local-deploy上的 Omarchy / Arch 本机部署功能移植到新版（3.4.x）架构：不是硬拷旧代码，而是对照新版真实运行结构重写。基线为本仓库新 beta 线2c55b92a（v3.4.2）。scripts/omarchy-agent2api.sh（重写）：服务名、宿主发布端口、数据目录、容器用户全部从docker compose config实时读取，不硬编码；命令：up/build/down/restart/status/logs/health/backup/restore/doctor/config。安全边界：不删除容器以外的东西、不读取 / 回显.env值、不打开数据库文件；backup / restore 在 trap 里保证服务被拉回。scripts/omarchy-compose.yml（新增）：独立于根docker-compose.yml的加固版 —— 端口默认只发布到127.0.0.1、宿主端口 / 容器名 / 镜像 / 容器 uid/gid 用.env参数化、支持预置管理员与第一把网关 Key。刻意不改根docker-compose.yml：上游对它有持续改动，用独立文件避免每次同步冲突。docs/install.*.md一一对应新增「Arch / Omarchy：本机源码部署（Docker）」小节（pacman 依赖、.env参数表、脚本命令、已知坑、备份口径、systemdProtectHome限制），六份 README 速查表各加一行指向安装文档的链接；旧docs/OMARCHY_LINUX.md不再以独立文件出现（内容已迁移，原文保留在feat/omarchy-local-deploy分支历史中）。与新版源码 / 构建配置的对照（可复核）
/health探活GET /healthdesktop-tauri/src-tauri/server/src/server/api/health.rs、server/mod.rsAGENT2API_PROXY_PORT默认 3065、EXPOSE 3065server/src/bin/agent2api-server.rs、DockerfileHEALTHCHECK ... /healthDockerfileVOLUME ["/data"]、AGENT2API_PROXY_HOME=/dataDockerfile；compose 挂./data:/dataAGENT2API_PROXY_API_KEY（启动时注入，fail-closed 语义）server/src/server/config/parse.rs、server/http.rsagent2api-provider-protocol = { git = "https://github.com/ProvidersPlugin/Agent2Providers", tag = "v3.4.0" }desktop-tauri/src-tauri/server/Cargo.tomlAGENT2API_SELF_UPDATE默认 1，非 root 运行需置 0Dockerfile注释、docs/install.md「容器内更新」验证（本机 Omarchy/Arch，Docker 29.9.2 / compose 5.6.1）
bash -n、shellcheck 0.10.0（-S style）零告警；docker compose config解析通过。docker build --network host在本仓库完整 worktree 上成功（190MB 镜像）。a2a-omarchy-port-test、端口 3068，不触碰真实部署agent2api-fork:0.0.0.0:3065）：config/up/status/health/doctor/backup（停服→打包→起服，含agent2api.db）/restart/restore（旧数据改名保留后健康）/down（数据保留）全部通过；ss确认端口只绑127.0.0.1；预置 Key 后/v1/models带 Key 200、无 Key/v1/chat/completions401（fail-closed）；uid/gid=1000 +SELF_UPDATE=0变体启动健康。build.network: host在 buildx 路径要求--allow权限，不可移植，因此工作落地为脚本build子命令（docker build --network host）；首次数据目录没有account.key是预期（密钥在首个凭证作用域使用时才生成），backup 归档校验以agent2api.db为准。备注
2c55b92a）；若合并时origin/beta尚未前移，PR 的 diff 会暂时包含上游同步提交，beta 前移后自动收敛为本分支改动。nobody:nobody（userns 映射），doctor会对该情况给出 WARN 与处理建议；这是宿主 Docker 配置差异，不是脚本缺陷。🤖 本条回复由 AI Agent 生成