Skip to content

feat(health): add Agent Health Center with read-only checks (#52) - #187

Merged
python-rust merged 6 commits into
mainfrom
codex/issue-52-health-center
Sep 11, 2026
Merged

python-rust merged 6 commits into
mainfrom
codex/issue-52-health-center

Conversation

@NongHua123

@NongHua123 NongHua123 commented Sep 9, 2026 •

Copy link
Copy Markdown
Collaborator

Scope and rationale / 范围与原因

当多款 Agent 的安装、登录或配置出错时,用户需要先知道哪个需要处理、为什么以及下一步去哪。比较卡片内展开、独立仪表盘与共享快照方案后,选择新增“运行状态”主页面、各 Agent 卡片直达,并复用现有安装、账号和模型处理页。

覆盖七款 Agent、五种总状态及十二项本机检查,呈现原因、严重度、时间和适用入口。支持单项/串行批量检查、停止、过期提示、部分失败保留旧结果和处理后返回重读;隐藏页面停止后续派发。未知关键事实不会被显示为正常。

Related work / 关联工作

Fixes #52

产品方案 · 详细验证 · 使用说明

Evidence / 验证证据

macOS / Apple Silicon,基于主线 11c13339:

  • 完整门禁通过:TRELLIS_CONTEXT_ID=01a086ce-0347-7ce3-827a-018f8952006a mise run python:run -- mise run check:prearchive --exclude-active-task .trellis/tasks/09-09-issue-52-health-center。前端 1641 passed / 1 原有 skipped;Rust 主库 3237 passed / 5 原有 ignored,其他 workspace 与集成检查通过。归档后 mise run python:run -- mise run check:contracts 也通过。
  • mise run test:browser:576 项交互、2 项生产构建启动通过。包括四种 Chromium 尺寸与 WebKit、排序高亮回归和处理返回重读。交互使用明确 fixtures。
  • mise run build:debug:最终原生调试包通过;隔离测试实际执行 7/7 检查、配置损坏、处理入口和恢复重读。独立核对六份配置、25 张业务表及 TRAE 目录保持不变。退出测试包后恢复原安装应用。
  • 初始 JavaScript 664590 / 665600 bytes,严格端口延迟加载;没有增加依赖或放宽体积预算。
  • mise run test:performance 为 33 passed / 2 failed,不能视为全绿。 同宿主干净主线也失败相同两项。账号呈现动画 p95:主线 36.2ms / 本分支 36.8ms;尺寸动画:45.5ms / 44.1ms;预算均 33.4ms。预算与断言未改。导航 p95 为 38.8ms(1x)/ 51.1ms(4x),均在 100ms 内,无 long task。保留为已知基线限制,PR 以 draft 交付,不扩展修改无关账号动画。
  • Windows 原生、真实账号 UAT、远端模型可用性、签名和 Release 未验证;本地结果不代替这些层级。远程 CI 状态以 PR Checks 为准。

Risk and rollback / 风险与回退

默认健康检查不联网、不执行目标 CLI、不刷新授权、不写配置/业务表、不导入 usage。TRAE 存在 WAL/SHM/journal 时如实未知,避免只读检查创建 sidecar。超时后台仍持有唯一许可,实际读取结束前拒绝叠加重试。模型请求、登录和配置修改进入既有明确操作流程。

新增闭合 DTO/只读 IPC 与 ACL;不返回原始路径、地址、凭据或错误内容。无数据库迁移、新依赖或 Release 改动。可通过回退功能提交撤销新增入口、端口和来源读取;无需数据回滚。原用户 dirty worktree 的分支、HEAD、状态与 tracked diff 摘要均保留。

Contract and provenance impact / 契约与来源影响

  • 更新前后端 Health 规范、导航/懒加载规范、可执行成功与失败测试及使用说明。
  • 无上游导入;平台来源资产只更新本次实际触及项及新只读模块,没有扩大豁免。
  • 无 CI/Release 工作流修改,不合并、不发布、不自行关闭 Issue。

Screenshots / 截图

最终 macOS 原生包,使用隔离测试数据;恢复后 Codex 高亮与选中项一致:

原生运行状态

Checklist / 检查清单

  • 当前宿主完整 check:prearchive 通过;补充性能套件两项失败已明确记录。
  • 测试覆盖可观察成功、失败、超时、停止、隐藏和只读边界。
  • 当前渲染器中文与无障碍状态已同步;模板“四份 locale”不适用,遵循现行简体中文前端规范。
  • 未包含真实凭据、证书、个人配置、虚拟环境或用户业务数据;截图与测试使用隔离合成数据。
  • 结论区分本地检查、浏览器 fixtures、原生回读、远程 CI 与正式 Release。

@github-actions github-actions Bot added documentation Improvements or additions to documentation frontend backend labels Sep 9, 2026
@python-rust
python-rust marked this pull request as ready for review September 11, 2026 05:32
@python-rust
python-rust added this pull request to the merge queue Sep 11, 2026
Merged via the queue into main with commit 38b4a98 Sep 11, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backend documentation Improvements or additions to documentation frontend

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[G3-07] 建立 Health Center,集中显示状态、原因和修复入口

2 participants