feat(health): add Agent Health Center with read-only checks (#52) - #187
Merged
Merged
Conversation
added 5 commits
September 10, 2026 01:46
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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 目录保持不变。退出测试包后恢复原安装应用。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 交付,不扩展修改无关账号动画。Risk and rollback / 风险与回退
默认健康检查不联网、不执行目标 CLI、不刷新授权、不写配置/业务表、不导入 usage。TRAE 存在 WAL/SHM/journal 时如实未知,避免只读检查创建 sidecar。超时后台仍持有唯一许可,实际读取结束前拒绝叠加重试。模型请求、登录和配置修改进入既有明确操作流程。
新增闭合 DTO/只读 IPC 与 ACL;不返回原始路径、地址、凭据或错误内容。无数据库迁移、新依赖或 Release 改动。可通过回退功能提交撤销新增入口、端口和来源读取;无需数据回滚。原用户 dirty worktree 的分支、HEAD、状态与 tracked diff 摘要均保留。
Contract and provenance impact / 契约与来源影响
Screenshots / 截图
最终 macOS 原生包,使用隔离测试数据;恢复后 Codex 高亮与选中项一致:
Checklist / 检查清单
check:prearchive通过;补充性能套件两项失败已明确记录。