docs: 添加 README.md,记录正确的启动方式和端口规范

- 重要发现:服务被 OpenClaw 杀掉(SIGTERM)
- 解决方案:使用 nohup + disown 脱离进程树
- 更新所有项目的 start_cmd 为正确的启动方式
- 记录端口规范(19000-19100)
- 记录故障排查步骤
This commit is contained in:
2026-04-15 09:59:39 +08:00
parent cc18d254a8
commit 70eab1f1b8
2 changed files with 155 additions and 11 deletions

View File

@@ -6,7 +6,7 @@
"type": "web",
"ports": [19000],
"directory": "works/pdf-translate-web-v2",
"start_cmd": "python3 app.py",
"start_cmd": "mkdir -p logs && nohup python3 app.py > logs/app.log 2>&1 & disown",
"health_url": "http://localhost:19000/api/health",
"description": "英文PDF翻译中文网站支持用户系统、会员体系",
"admin_url": "http://localhost:19000/admin",
@@ -19,7 +19,7 @@
"type": "web",
"ports": [19001],
"directory": "works/llm-index-rag",
"start_cmd": "python3 app.py",
"start_cmd": "mkdir -p logs && nohup python3 app.py > logs/app.log 2>&1 & disown",
"health_url": "http://localhost:19001/api/stats",
"description": "基于索引和搜索的知识检索系统",
"admin_url": "http://localhost:19001/settings",
@@ -32,7 +32,7 @@
"type": "web",
"ports": [19009],
"directory": "works/snippet-notes",
"start_cmd": "python3 app.py",
"start_cmd": "mkdir -p logs && nohup python3 app.py > logs/app.log 2>&1 & disown",
"health_url": "http://localhost:19009/api/notes",
"description": "碎片信息记录工具AI自动生成标题",
"git_repo": null,
@@ -44,7 +44,7 @@
"type": "web",
"ports": [19010],
"directory": "works/param-hub-python",
"start_cmd": "python3 app.py",
"start_cmd": "mkdir -p logs && nohup python3 app.py > logs/app.log 2>&1 & disown",
"health_url": "http://localhost:19010/api/stats",
"description": "AI大模型与硬件参数速查平台",
"admin_url": "http://localhost:19010/admin",
@@ -57,12 +57,12 @@
"type": "web",
"ports": [19020],
"directory": "works/ai-chat",
"start_cmd": "python3 main.py",
"start_cmd": "mkdir -p logs && nohup python3 main_v2.py > logs/app.log 2>&1 & disown",
"health_url": "http://localhost:19020/api/admin/stats",
"description": "网页端和Matrix端实时同步的AI聊天系统",
"admin_url": "http://localhost:19020/admin",
"git_repo": "http://192.168.2.8:12007/coder/ai-chat-system",
"version": "v1.0.0"
"version": "v2.5.4"
},
{
"id": "product-crawler",
@@ -70,7 +70,7 @@
"type": "web",
"ports": [19011],
"directory": "/home/xian/.openclaw/common/projects/product-crawler",
"start_cmd": "python3 app.py",
"start_cmd": "mkdir -p logs && nohup python3 app.py > logs/app.log 2>&1 & disown",
"health_url": "http://localhost:19011/api/products",
"description": "自动从官网爬取产品参数信息",
"admin_url": "http://localhost:19011/admin",
@@ -83,13 +83,26 @@
"type": "web",
"ports": [19007],
"directory": "/home/xian/.openclaw/common/projects/llm-proxy",
"start_cmd": "python3 app.py",
"start_cmd": "mkdir -p logs && nohup python3 app.py > logs/app.log 2>&1 & disown",
"health_url": "http://localhost:19007/health",
"description": "大模型API中转系统多提供商调度",
"admin_url": "http://localhost:19007/admin",
"git_repo": "http://192.168.2.8:12007/coder/llm-proxy",
"version": "v2.0.0"
},
{
"id": "project-panel",
"name": "项目服务管理面板",
"type": "web",
"ports": [19013],
"directory": "works/project-panel",
"start_cmd": "mkdir -p logs && nohup python3 app.py > logs/app.log 2>&1 & disown",
"health_url": "http://localhost:19013/",
"description": "统一管理所有Web服务项目",
"admin_url": "http://localhost:19013",
"git_repo": "http://192.168.2.8:12007/coder/project-panel",
"version": "v1.0.1"
},
{
"id": "web-context-extension",
"name": "网页助手插件",
@@ -147,7 +160,7 @@
"type": "web",
"ports": [19014],
"directory": "works/xian-favor",
"start_cmd": "xian_favor serve --port 19014",
"start_cmd": "mkdir -p logs && nohup xian_favor serve --port 19014 > logs/app.log 2>&1 & disown",
"health_url": "http://localhost:19014/api/health",
"description": "文本笔记、链接收藏、待办事项管理系统",
"admin_url": "http://localhost:19014",
@@ -160,7 +173,7 @@
"type": "web",
"ports": [19015],
"directory": "works/multi-agent-bidding",
"start_cmd": "python3 -m app.app --port 19015",
"start_cmd": "mkdir -p logs && nohup python3 -m app.app --port 19015 > logs/app.log 2>&1 & disown",
"health_url": "http://localhost:19015/api/agents",
"description": "基于竞标机制的多智能体任务调度系统",
"admin_url": "http://localhost:19015",
@@ -173,7 +186,7 @@
"type": "web",
"ports": [19004],
"directory": "/home/xian/.openclaw/common/projects/tech-forum",
"start_cmd": "python3 backend/app.py",
"start_cmd": "mkdir -p logs && nohup python3 backend/app.py > logs/app.log 2>&1 & disown",
"health_url": "http://localhost:19004/api/health",
"description": "技术交流、工具分享、问答讨论社区",
"admin_url": "http://localhost:19004/admin",