复现已有算法

2026-07-14 15:43:18 +08:00
parent abebd2a683
commit 50b8111fd9
860 changed files with 182250 additions and 18 deletions
@@ -0,0 +1,94 @@
+---
+name: edge-local-dev-services
+description: edge_collector 本地开发与联调服务管理规范。用于在本机或远程开发主机启动、检查、停止 edge/cloud 前后端开发服务和依赖服务，包含 collector、configurator、cloud_server、React/Vite 前端、PostgreSQL、TDengine、Mosquitto、端口占用和日志验证。
+---
+
+# edge_collector 本地开发服务
+
+## 适用场景
+
+- 本机启动边缘侧或云平台开发环境。
+- 前端页面需要 dev server 联调。
+- 后端接口需要本地验证。
+- E2E 前需要确认依赖服务。
+- 端口冲突、服务没起来、接口连接失败。
+
+## 先读配置
+
+不要假设服务和端口，优先读取：
+
+- `docs/project-overview.md`
+- `cloud_server/config/server_config.json`
+- `configurator/config/`
+- `frontend/*/package.json`
+- `package.sh`
+- `deploy_cloud.sh`
+- `scripts/install_all.sh`
+- systemd service 安装脚本
+
+## 常见服务
+
+- 边缘：`collector`、`configurator`、`edge` systemd 服务。
+- 云端：`cloud_server`、`cloud-server` systemd 服务。
+- 前端：`frontend/config_app`、`frontend/cloud_app`。
+- 依赖：PostgreSQL、TDengine、Mosquitto。
+- 独立 agent：frpc agent、port forward agent、4G/WiFi 相关脚本。
+
+## 检查流程
+
+1. 查看端口占用：
+
+```bash
+ss -lntp
+```
+
+2. 查看服务状态：
+
+```bash
+systemctl status edge --no-pager
+systemctl status cloud-server --no-pager
+```
+
+3. 查看最近日志：
+
+```bash
+journalctl -u edge --since "10 min ago" --no-pager
+journalctl -u cloud-server --since "10 min ago" --no-pager
+```
+
+4. 验证接口：
+
+```bash
+curl -s http://127.0.0.1/api/status
+curl -s http://127.0.0.1:8081/api/health
+```
+
+## 前端开发
+
+进入对应目录后：
+
+```bash
+npm install
+npm run dev
+npm run build
+```
+
+如果 Node 环境在 97/ARM64 主机异常，优先参考 `scripts/set_env/install_nvm_npm.sh` 和本地 nvm 离线安装规则。
+
+## 禁止事项
+
+- 不要直接连接生产库做写操作。
+- 不要随意 kill 非本次启动的进程。
+- 不要删除用户已有容器、数据库或运行配置。
+- 不要把本地端口和临时密码写死进代码。
+- 不要每次同步后都执行 `install_all.sh`，除非用户明确要求。
+
+## 输出
+
+最终说明：
+
+- 启动或检查了哪些服务。
+- 使用了哪些端口。
+- 哪些接口验证通过。
+- 日志里是否有错误。
+- 如何停止本次启动的临时服务。