Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

fix(health): `/health` 是常量字符串、doctor 不探活、容量与数据丢失信号缺位——三种"半死"状态全返回 200 ok

已关闭
#123 4 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
35/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
rust

调研方向

Start at the router that registers /health (handlers.rs:30-34) and the doctor command (main.rs:1435-1541) to see what each currently reports. Then read the failure sites that only log today: reaper eviction http/mod.rs:1368-1373, DELETE and tombstone handlers.rs:663-683, and graceful shutdown http/mod.rs:1430-1435. Done means a /readyz that write-probes storage, proves a recent LLM success and reports admission saturation, a doctor --probe mode, and four registered counters/gauges (sse_clients, agui_runs, persist_failures, sessions_evicted).

由索引模型根据 Issue 内容生成。

描述

场景 gap 单(okguitar 提报)· 优先级 P2 · 依赖:无 · 验收:代码 diff 逐点核对;运行时可见性另需 Langfuse(#124)

基线 origin/main = fc29f3d4。

Summary

  • handlers.rs:30-34 health() 返回常量 "ok";无 /readyz(grep 空)。值班最需要的三种半死——key 失效/网关不通、存储只读或满、sandbox 起不来——全部 200。
  • cmd_doctor(main.rs:1435-1541)只查文件存在/可解析:不发一次网络请求、不试写存储、不测磁盘。
  • 容量与丢失信号缺位:无 recursive_sse_clients(event_channels 的 receiver_count 无人调用)、无 AG-UI 在飞 run(agui_active_runs 从未计数)、无在途工具数;持久化失败(真丢数据)只 tracing::warn:reaper 驱逐 http/mod.rs:1368-1373、DELETE handlers.rs:663-669、tombstone :673-683、优雅停机时 busy 会话直接不落盘(http/mod.rs:1430-1435)。

建议

拆 /healthz 与 /readyz(存储写探针+最近 LLM 成功时戳+admission 饱和度);doctor 加 --probe;补 4 个计数器/gauge(sse_clients/agui_runs/persist_failures/sessions_evicted);停机 busy 会话数升 error 级进指标。

主要语言
Rust
星标
4
派生
0
平均合并
5 小时 32 分钟
30 天内合并 PR
7

环境准备

  • 提供 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 没有贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

jeffkit/recursive 的其他 Issue

查看 jeffkit/recursive 的全部 Issue

相似的 Issue

更多 Rust Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。