# 08 开发者手册 文档状态:0.6.3 版整理稿 ## 1. 基本原则 - 默认使用现有模块和风格,不为小改动引入新架构。 - 新功能必须有小型可重复测试。 - 不支持的物理或输入必须明确报错,不得静默回退。 - 不提交 build、results、CSV/VTK 全量结果、restart 和临时文件。 - 文档使用 UTF-8 without BOM。 ## 2. 新增单元流程 1. 在 `fem_element_topology` 中增加 canonical 名称、类型、节点数、边/面和积分点计数。 2. 在输入读取和数据库校验中覆盖新名称。 3. 在形函数、积分、刚度、内力和质量路径中接入实现。 4. 增加 topology/database/module 测试。 5. 如果暴露给 C API,同步更新 bridge、header、C wrapper 和 `test_c_api`。 6. 更新算法、接口、用户手册和 benchmark matrix。 不得把未验证的 Abaqus 名称静默映射到已支持单元。 ## 3. 新增积分规则流程 1. 在 `fem_quadrature` 中增加或复用 family/domain/order 描述符。 2. 保持现有 element-driven 默认规则不变,除非有明确测试覆盖。 3. 增加点数、坐标对称性和权重和测试。 4. 用户侧任意积分选择必须等后续版本单独规划。 ## 4. 新增 API 流程 - 优先使用 dimension query + value-fill query。 - 写输出前验证 id、索引和缓冲区容量。 - C ABI 空指针或非正容量返回 `-1`。 - Fortran 错误通过 `ierr` 和 `fem_get_last_error` 传递。 - C 多维数组按 Fortran 顺序展开。 ## 5. 测试建议 常用聚焦测试: ```powershell ctest --test-dir build-codex-gcc -R "^(smoke|element_infrastructure|database_topology|element_stiffness|shell_internal|c_api)$" --output-on-failure ctest --test-dir build-codex-gcc -R "^source_size$" --output-on-failure ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure ``` 发布前运行: ```powershell cmake --build build-codex-gcc --parallel ctest --test-dir build-codex-gcc -R "^(smoke|element_infrastructure|database_topology|element_stiffness|shell_internal|c_api)$" --output-on-failure ctest --test-dir build-codex-gcc -R "^source_size$" --output-on-failure ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure git diff --check ``` ## 6. 文档维护 核心文档固定为: - `01_requirements_specification.md` - `02_software_architecture_design.md` - `03_detailed_design.md` - `04_mathematical_model_and_algorithms.md` - `05_interface_control_document.md` - `06_test_and_verification_plan.md` - `07_user_manual.md` - `08_developer_manual.md` - `09_release_history.md` - `10_development_roadmap.md` - `11_benchmark_matrix.md` 历史版本计划、验收报告和 benchmark 矩阵不再拆成多个文件;统一维护在 09-11。 ## 7. 0.6.3 开发注意事项 - `S4R` hourglass 修改必须保持 `S4` 回归绿色。 - `C3D8R` hourglass 修改必须保持 `C3D8` 回归绿色,并覆盖刚度、内力、质量和输出路径。 - B 矩阵约定变更必须同步接口文档和 C API 测试。 - 元素查询 API 不应暴露内部数组指针。 - 新增积分规则不等于开放用户侧积分选择。