第 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)