尝试用rules--code.md


description: RV1126 嵌入式代码生成规范 --- 根据方案或文件生成 C/C++ 代码时必须遵守的架构、接口与模块化规则

globs: "**/*.cpp,**/*.c,**/*.h,**/CMakeLists.txt"

alwaysApply: false


RV1126 代码生成规范

架构原则

  • **POSIX 接口优先**:系统调用一律使用 POSIX API(open/read/write/close/ioctl/select/poll),禁用平台私有或非标准扩展

  • **完全重构**:生成代码必须是全新实现,不得在原单体代码上打补丁;参考 `research.md` 理解逻辑后重写

  • **C++11 标准**:不使用 C++14/17/20 特性(目标编译器 arm-linux-gnueabihf-g++ 6.3)

模块化与进程独立

  • 每个不可拆分的功能内聚为一个**独立进程**(独立二进制),可单独编译、运行、测试

  • 进程间通信仅限 **MQTT**(mosquitto localhost:1883)和 **terminal 参数传递**,禁止共享内存/全局变量/Unix Socket

  • 每个进程必须具备完善的 **CLI 标准输入输出**,可在 terminal 通过参数运行:

```bash

必须支持的基础参数

qe_<module> --help # 显示帮助

qe_<module> --config <path> # 配置文件

qe_<module> --log-level <level> # debug|info|warn|error

qe_<module> --<single-op> args # 单次操作模式(执行后退出,便于测试)

```

子模块插件化

  • 子模块设计为**可热加载插件**,通过运行时参数或 MQTT 消息动态加载/卸载

  • 实现方式:`dlopen`/`dlsym` 加载 `.so`,或通过 CLI 参数指定子模块列表

```cpp

// 插件接口(所有子模块实现)

struct PluginInterface {

const char* name;

int (*init)(const char* config_json);

int (*process)(const char* input_json, char* output_json, int max_len);

void (*cleanup)();

};

```

文件行数约束

  • 每个源文件 **200~800 行**(含头文件),超 800 行**必须拆分**

  • 每个 `.cpp` 对应一个 `.h`,公共接口在头文件声明

模块自测功能

每个模块必须内建自测能力:

```bash

qe_<module> --self-test # 执行自测

qe_<module> --self-test --test-data <path> # 使用指定测试数据包

```

自测需包含:自测方案(测试什么)、测试数据包(输入数据)、测试结果(JSON 输出 PASS/FAIL + 详情)

README.md 要求

每个模块目录必须包含 `README.md`:

  • 代码功能说明

  • 流程图(ASCII 或 Mermaid)

  • 接口说明(CLI 参数 + MQTT 主题 + 插件接口)

  • 测试方案、测试数据位置、测试结果判断规则

代码结构一致性

所有模块遵循统一目录结构:

```

modules/<module-name>/

├── CMakeLists.txt

├── README.md

├── src/

│ ├── <module>_main.cpp

│ ├── <component>.cpp/.h

│ └── plugin_<sub>.cpp/.h

└── test/

├── test_data/

└── self_test.cpp

```

相关推荐
瑞克-桑切斯15 小时前
Kubernetes 1.28 保姆级新手学习教程
运维·学习·docker·云原生·容器·kubernetes
kaixin_啊啊17 小时前
【三种鲑科鱼类比较基因组学分析鉴定出参与细胞内寄生菌鲑立克次体抗性的功能候选基因】论文学习
学习
CappuccinoRose19 小时前
Redis 学习文档
redis·后端·学习·缓存·session·非关系型数据库·gossip
qingwufeiyang_53020 小时前
Docker学习笔记2
笔记·学习
Z21-X21 小时前
云原生运维学习笔记:从操作系统底层到 Kubernetes 集群的深度实践
运维·笔记·学习·云原生·kubernetes
Century_Dragon21 小时前
把高压回路“看透” 新能源汽车动力系统拆装与检测实训MR软件
学习
电科_银尘2 天前
【深度学习项目实战·22】灰度图像着色:用小型U-Net学习从灰度到RGB
人工智能·深度学习·学习
QuZhengRong2 天前
【AI】Agent 全栈进阶|AgentScope 沙箱源码解析
python·学习·ai·agent·沙箱
承渊政道2 天前
【Python编程—从入门到实践】(用户账户:给Django网站装上登录系统,让每个人拥有自己的学习笔记)
python·学习·pycharm·django
诗句藏于尽头2 天前
游戏《完美神话》-使用Ai-agent进行修复已停服游戏到本地成功部署以及GM端网页完整教程
人工智能·学习·游戏