# AGENTS.md — Envi3D 2026(环境设计) 本文件由 pi 自动加载。**完整的项目说明在 `CODEBUDDY.md`**(构建、preset、加密双版本、模块分组、架构分层)。 动手改代码前先 `read CODEBUDDY.md`。这里只放 pi 环境差异和硬性红线。 ## pi 环境说明 - 内置工具只有 `read` / `write` / `edit` / `bash`,**没有独立的 grep / glob / web 工具**: 搜索一律在 `bash` 里用 `rg`,联网靠 `curl` 或额外插件。 - 超长文件用 `read` 的 `offset` / `limit` 分段读: `AecDbEwFitting.cpp` 17453 行、`AecDbEwEquipment.cpp` 14290 行、`AecDbEwPipe.cpp` 5002 行。 - 类名与文件名不一定一致,搜之前先 `rg -n "ACRX_DXF_DEFINE_MEMBERS" <文件>` 确认 (例:`AecDbSlab.cpp` 里的类叫 `AecDbXSlab`)。 ## 红线(违反了会污染仓库或造成不可逆损坏) 1. **源码编码**:`SourceCode/Code2026/**/*.cpp|*.h` 必须是 **UTF-8 with BOM**; `cmakelists.txt` / `CMakeLists.txt` 保持 ASCII 无 BOM。 中文写坏**不可逆**,只能 `git checkout HEAD -- ` 还原后重做。 2. **禁止新增或依赖 `.vcxproj` / `.sln`**(`StartApp/StartApp.sln` 是唯一例外)。 `cmake_output/` 下的 `*.vcxproj` 是构建产物,不要提交。 3. **不要直推 `main`**,推送走 `git push origin HEAD:refs/for/main/<分支名>` 触发评审。 4. commit message 用中文。 5. 文件内私有函数放**该文件已有的匿名 `namespace`**;不要写文件级 `static`,不要放头文件。 6. 平台判断用 `#ifdef ZWCAD`,**不要**只比较 `ARX` 版本号(ZRX 的 `ARX` 宏与 AutoCAD R 版本数值重叠)。 7. `Arx/`、`ZRX/`、`bin/`、`lib/`、`cmake_output/` 已被 gitignore,不要手动加进来。 ## 动手前 - 本仓库**没有单元测试框架、没有 lint 配置**:验证方式 = 编对应 preset + 在 CAD 里加载实测。 - 大改动先读仓库根目录已有的分析文档(`*-review.md` / `*-plan.md` / `*-analysis.md`), 里面记录了很多"已经决定不做"的理由,别重复踩。 - 构建命令与 target 对照见 `CODEBUDDY.md`,或直接用 skill `build-arx`。 ## 仓库内 skill | skill | 用途 | | --- | --- | | `build-arx` | 按 preset 编译、单 target、产物与部署路径 | | `verify-utf8` | UTF-8 BOM 自检、写坏后的回滚 | | `pr-flow` | 分支命名 / 中文 commit / `refs/for/main` 推送 | | `analyze-big-entity` | 万行实体类的分析与改动套路 | 使用说明(常用命令、会话管理、Windows 终端问题、多机同步、插件取舍)见 `pi-agent-setup.md`。