复现已有算法

2026-07-14 15:43:18 +08:00
parent abebd2a683
commit 50b8111fd9
860 changed files with 182250 additions and 18 deletions
@@ -0,0 +1,72 @@
+---
+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` 的规范需要写入。