8履约任务14 分钟

统一响应、request_id 与轻量可观测

统一 Result 格式、错误码、request_id 中间件、结构化日志,L1 轻量可观测不上 Langfuse。

可观测request_id错误码日志
进度保存在本机浏览器;验收通过后再点更稳妥
本课任务 · AI 履约学法

所有 JSON API 统一 Result;日志带 request_id;可选 metrics 摘要。

推荐:复制 Prompt → 在 AI大模型/AI编程工具 改项目 → 跑验收 → 再展开下方概念卡。不必先对着仓库读代码。

Prompt
你在 codehub-llm-core 中补齐工程底座可观测性。

本课目标:
1. 统一 Result + 错误码枚举(含 40001/42901/50001 等)
2. request_id 中间件:响应头 X-Request-Id 与日志一致
3. 结构化日志字段:request_id, model, latency_ms, tokens, tool_calls, error
4. 可选 GET /api/metrics/summary 或 /dashboard 最近请求表

约束:
- 不上 Langfuse / OpenTelemetry
- INFO 日志不打印完整用户原文

验收:故意触发超时,响应 code=50001 且能用 request_id 在日志里找到同一条。
验收标准npm run verify:llm-08
  • 所有 JSON 接口统一 Result 形态
  • X-Request-Id 与 body.request_id 一致
  • LLM 调用有结构化日志行

卡关对照:Gitee tag phase-0-init(验收通过后再看,或路径 C 直接 checkout)