fix: 降低 worker 健康检查与前端轮询的空闲开销

[xerrors]

变更说明

修复 #1078 中周期性 worker 健康检查反复导入完整业务运行时、开发环境 Vite 高频文件轮询导致的空闲开销。

• 任务类型：bug-fix
• 目标：开发与生产 Compose 直接运行轻量心跳探针；保留失活检测；Vite polling 间隔设为 1000 ms。
• 非目标：业务运行性能、其他进程 CPU 峰值、逐 worker 实例健康机制。
• substantial：涉及探针长期维护边界，已建立并收敛 decision。没有数据迁移、新依赖或新增配置。

工程主张与 Owner

• worker_health.py 拥有 ARQ 心跳键、间隔、TTL 上界与轻量检查入口；worker 和 API readiness 读取同一契约。
• 两份 Compose 直接执行 python -m yuxi.services.worker_health。探针通过 Redis transaction 读取 GET/PTTL；空值、缺失、过期、永久、超长租约或连接异常均失败。日志不输出 DSN/异常内容中的凭据。
• ARQ 写入 Redis 心跳是健康事实的发布点。健康探针表达共享队列消费健康，多副本不能据此识别单进程失活；API readiness 的 reconciliation 检查保留。
• web/vite.config.js 拥有轮询频率；保留 polling 以兼容 Docker/Windows 文件挂载。
• 决策记录：降低空闲 worker 探针与开发文件监听开销。

验证情况

探针不加载业务执行依赖且保留租约失败语义

• 失败面：重复重导入，或 Redis 非法健康键被误判有效。
• 语义 Owner：worker_health、ARQ Worker、Compose。
• 直接证据 / 命令：临时 API 镜像挂载当前工作树到 /repo，在 /repo/backend 设置 PYTHONPATH=/repo/backend/package 后执行：
  • python -m pytest -p no:cacheprovider test/unit/services/test_worker_health.py test/unit/services/test_readiness_service.py test/unit/config/test_docker_compose_checkpointer.py -q：33 passed。
  • python -m pytest -p no:cacheprovider --confcutdir=test/integration/services test/integration/services/test_worker_health_redis.py -q：6 passed，连接独占临时 Redis。该 selector 排除无关全局 API/沙盒清理 fixture，保留随机测试键的创建与清理。
  • python -m pytest -p no:cacheprovider test/unit -m 'not slow'：2428 passed、7 subtests passed；设置 YUXI_SKILL_PROJECTION_DIR=/tmp/1078-skill-projections 供容器写入。
• 负向案例：子进程阻止 run_worker/run_queue_service/LangGraph/SQLAlchemy/tiktoken 导入；真实 ARQ 心跳不续租后由 Redis 过期；缺失、空值、永久、超长 TTL 和不可达 Redis 返回失败；错误消息不泄露凭据。修改前 Compose 装配断言失败。
• 结果：Passed。

健康检查进程开销下降

• 失败面：探针仍加载重依赖。
• 语义 Owner：Compose 健康检查入口。
• 直接证据 / 命令：同一临时 API 容器、独占 Redis 下，分别启动 arq --check server.worker_main.WorkerSettings 与 python -m yuxi.services.worker_health 各 3 次；每次预置有效 6 秒心跳，使用 perf_counter 与 getrusage(RUSAGE_CHILDREN) 读取 wall/CPU 时间。
• 结果：Passed。旧命令 wall 2.254–2.293 s、CPU 4.326–4.407 s；新命令 wall 0.124–0.131 s、CPU 0.123–0.130 s，全部退出 0。
• 负向案例：删除心跳后新命令退出 1。此结果仅说明该环境的探针进程开销，不代表用户机器整体 CPU 降幅。

Vite 轮询仍发送更新

• 失败面：降低频率后无法发现源文件变化。
• 语义 Owner：vite.config.js。
• 直接证据 / 命令：npm run lint:check、npm run test:unit（380 passed）、npm run build；Vite createServer 加载当前配置，对临时模块 transformRequest 后修改文件，等待 ws.send 的 update 消息。
• 负向案例：8 秒内无对应模块 update 则探针失败。
• 结果：Passed。实际 interval=1000，813 ms 后发出对应 js-update；临时模块已清理。

工程与文档门禁

• 失败面：配置接线、文档链接、格式回归。
• 语义 Owner：工程 verifier、Ruff、VitePress。
• 直接证据 / 命令：python3 scripts/verify_engineering_contracts.py、python3 -m unittest scripts.test_verify_engineering_contracts（62 passed）、uvx ruff check（本次修改的 Python 文件）、uvx ruff format --check（新增 Python 文件）、cd docs && npm run build、git diff --check。
• 负向案例：新探针装配恢复成旧 arq 命令会触发 Compose 断言失败；其他沿用既有 gate。
• 结果：Passed。

简化 / 删除验收

不涉及。

独立语义 Review

已调用全新、无历史会话的 pi，只启用 read/grep/find/ls 工具。覆盖完整需求、根与子树规范、完整 diff（含新增文件）、相关源码、实际测试日志和未验证范围。结论：没有探针逻辑、Compose 接线、Vite polling 或共享心跳语义问题；唯一 P3 是清理 Vite 验证生成的临时文件。该文件已删除，最终提交范围已复核，没有未解决 findings。

未验证范围与风险

• 新工作树没有 .env 和运行中的 Compose 服务，要求的 docker compose exec api uv run --group test pytest test/unit -m 'not slow' 在配置插值阶段失败；上述后端检查改用已有 API 镜像的临时容器挂载本工作树执行。首次全量测试因容器 skill-projections 目录不可写失败，设置独立可写目录后全部通过。
• 前端 pnpm 拒绝重装跨工作树软链接的 node_modules，改用 npm 执行相同 package.json 脚本；没有修改依赖或锁文件。
• Not run：用户机器整体空闲 CPU、Windows Docker 文件监听、浏览器消费 HMR、完整业务 E2E/真实模型。Linux Vite 服务实际发出了 HMR 消息；没有将其等同于浏览器端验收。
• 轮询增加最多约一秒检测等待；原有共享心跳的多副本局限保留。Question: CPU占用100% #1078 的其他高 CPU 峰值仍需用户环境采样。

事故反馈

未达到高影响事故复盘门槛；已补充针对性回归与决策记录。

界面变更

不涉及产品界面或交互；开发服务器文件轮询频率调整。

关联事项

Closes #1078

补充说明

以 xerrors 身份提交 Draft PR；不合并。运行环境需重建生产镜像或重建相关开发容器，以应用新的 Compose 健康检查和 Vite 配置。

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-09-28T07:42:01.191421Z	af6f0b3	Draft marked ready

ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.