---
name: edge-project-overview
description: edge_collector 项目概览维护规范。用于读取、生成或更新本仓库项目总览，沉淀边缘侧、云平台、前端、协议采集、脚本部署、远程主机、运行目录、动态配置保护和常用验证命令，帮助新任务快速建立上下文。
---

# edge_collector 项目概览

## 何时使用

- 用户要求“整理项目概览”“说明当前工程结构”。
- 新增较大功能前需要建立上下文。
- 部署、协议、前端、云端多模块同时涉及。
- 文档或 skill 需要引用项目约定。

## 建议落点

默认维护：

```text
docs/project-overview.md
```

如果已有同类文档，优先更新已有文档，不新增重复总览。

## 必须覆盖

```text
项目定位
模块结构
边缘侧服务
云平台服务
前端应用
协议采集架构
运行目录 runtime/edge
配置文件与动态配置保护
构建与打包脚本
部署与同步脚本
常用远程主机
常用验证命令
风险与注意事项
推荐阅读路径
```

## 事实来源

生成或更新概览时优先读取：

- `CMakeLists.txt`、`collector/CMakeLists.txt`
- `package.sh`
- `deploy_cloud.sh`
- `scripts/migrate_edge.sh`
- `scripts/install_all.sh`
- `frontend/*/package.json`
- `configurator/config/`
- `collector/docs/`
- `.agents/skills/`

## 环境与主机

概览可记录常用主机，但不要写敏感密钥：

- 82：常用 arm64 发布构建主机。
- 97：arm64 编译/同步验证主机。
- 94、87：边缘运行验证主机。
- 云平台：`119.45.4.75`。

## 输出要求

- 明确“已确认事实”和“从文件推断”。
- 不把历史临时问题写成永久事实。
- 动态配置保护规则要写清楚，避免打包/同步覆盖运行配置。
- 同主机编译部署也要使用 `scripts/migrate_edge.sh` 的规范需要写入。