监控与指标 API

系统健康检查、指标与业务统计。

重要事实：代码层面不存在 /api/monitor/health、/api/monitor/stats 这类路由，「监控」只是前端页面路径。可观测端点如下，按版本区分。

---

健康检查

方法	路径	版本	说明
GET	/healthz	企业	存活探针
GET	/readyz	企业	就绪探针（逐组件检查）
GET	/api/v1/health	两者	健康 + 工具计数（无鉴权）
POST	/api/v1/diagnostics	个人	自诊断（无鉴权）
GET	/ws	个人	WebSocket Hub 状态

---

指标（Prometheus）

GET /metrics

企业版独有。返回 Prometheus 格式指标，可接入 Grafana。

curl http://localhost:8080/metrics \
  -H "Authorization: Bearer <token>"

# HELP lyncore_http_requests_total Total HTTP requests
# TYPE lyncore_http_requests_total counter
lyncore_http_requests_total{method="GET",endpoint="/api/v1/chat",status="200"} 15234
lyncore_http_requests_total{method="POST",endpoint="/api/v1/chat",status="429"} 12

# HELP lyncore_active_sessions Current active sessions
# TYPE lyncore_active_sessions gauge
lyncore_active_sessions 42

企业版另提供 GET /api/v1/openapi.yaml 与 Swagger 文档路由。

---

业务统计

GET /api/v1/usage/stats

个人版独有，无鉴权。返回本地用量统计（Token、请求量、活跃度等）。

curl http://localhost:19824/api/v1/usage/stats

返回统一结构 { "code": 0, "data": { ... }, "request_id": "..." }，data 内含用量与时长等统计信息。

GET /api/v1/briefing

个人版独有，无鉴权。返回每日简报（聚合近期活动摘要）。

curl http://localhost:19824/api/v1/briefing

GET /api/v1/admin/dashboard/*

企业版独有（需管理员）。管理台仪表盘统计：

路径	说明
/api/v1/admin/dashboard/stats	总览统计
/api/v1/admin/dashboard/usage	用量统计
/api/v1/admin/dashboard/agents/status	Agent 状态
/api/v1/admin/dashboard/audit/summary	审计摘要
/api/v1/admin/dashboard/billing/summary	计费摘要

---

错误码

场景	code	message
未认证	40100	缺失/非法 Authorization
无权限	40300	需要管理员权限