fix: remove stale Loading span in Infrastructure tab; add per-service ?/§ for Platform (WeChat Bridge, API Proxy, article_processor) and Ejabberd with dedicated spec files

This commit is contained in:
hmo
2026-07-16 22:25:17 +08:00
parent c8b641bb65
commit 79e8480f3c
6 changed files with 243 additions and 44 deletions
+50
View File
@@ -0,0 +1,50 @@
{
"module": "api_proxy",
"version": "1.0",
"purpose": "API Proxy 运行在 Windows (192.168.1.16:8787),为 VolcEngine(火山引擎)等外部 API 提供代理转发、重试和降级能力。",
"ui_location": "Infrastructure tab → Platform → API Proxy",
"human_help": {
"title": "API ProxyAPI 代理 :8787",
"description": [
"API Proxy 是一个轻量级反向代理,专门用于转发 VolcEngine(火山引擎)DeepSeek API 的请求。",
"主要功能:",
"• 请求代理——将内部请求转发到 VolcEngine 端点",
"• 自动重试——遇到网络抖动时自动重试",
"• 失败降级——主 API 不可用时自动切换到备用端点",
"简单说:它就是 AI API 的'中间人',保证请求能发出去、失败能重来。"
],
"usage": [
"监控状态:在 Infrastructure → Platform 下查看状态指示灯",
"如果状态为 stoppedAI 请求会直接失败",
"需要先确认 WeChat Bridge 正常运行"
],
"troubleshooting": [
"如果 API Proxy 停止:检查 Windows 上 api_proxy.py 进程是否在运行",
"排障命令:检查端口 8787 是否监听",
"重试策略:超时 5s,最多重试 2 次,失败后尝试备用端点"
],
"related": "WeChat Bridge(依赖 API Proxy 访问 AI)、Ejabberd(底层通信)"
},
"ai_spec": {
"apis": [
{"method": "POST", "path": "/v1/chat/completions", "returns": "OpenAI 兼容的 chat completion 响应"},
{"method": "GET", "path": "/health", "returns": "{ok, status}"}
],
"dependencies": [
"依赖 VolcEngine(火山引擎)API 可用",
"依赖 Windows 网络连通性"
],
"constraints": [
"仅用于 AI 模型 API 调用,不代理其他流量",
"重试策略:5s 超时 + 2 次重试 + 备用端点自动切换",
"端口 8787 在 Windows 上监听"
],
"related_files": [
"gateway/scripts/api_proxy.py — 实际运行脚本",
"gateway/scripts/templates/dashboard.html — fI() 状态展示",
"gateway/scripts/specs/api_proxy.json — 本 spec 文件"
]
}
}