# 01 需求规格说明 文档状态:0.6.5 版整理稿 ## 1. 软件定位 FemLite 是一个轻量级有限元求解器,核心使用 Fortran 实现,面向结构动力学、静力学、非线性分析、壳/实体单元、接触、材料非线性和紧凑工程基准算例开发。 当前项目版本为 0.6.5。0.6.5 是 CCLite 真实 IPC worker 接入闭环版本,重点交付标准 worker 参数、真实 Windows IPC worker 后端、AOR_V1 data block、能力查询和进程级 IPC 自测。 ## 2. 当前交付范围 当前软件应支持以下能力: - 显式动力学、线性静力、非线性静力和隐式 Newmark 路径。 - 实体单元:`C3D4`、`C3D8`、`C3D8R`、`C3D10`、`C3D20`。 - 壳单元:`S3`、`S4`、`S4R`、`S6`、`S8`。 - Abaqus 风格单元名称识别;不支持的名称必须明确报错。 - 线弹性、J2/J2_JC 和 Mohr-Coulomb 材料路径。 - 内部 CG、BiCGSTAB、GMRES 和 dense pivoting 线性求解器。 - 基础接触、mortar/AL、摩擦、cohesive 和颗粒耦合诊断基础设施。 - CSV、VTU/PVD、restart、Fortran API 和 C ABI 输出/查询接口。 - 元素 introspection API:元素类型、节点、坐标、积分点、形函数、Jacobian 和 B 矩阵。 - CCLite coupling surface/facet 查询、节点力导入、worker mock、真实 IPC worker、IPC adapter 和载荷诊断 CSV。 - `continuation_path.csv`、`nonlinear_lifecycle.csv` 和 restart version 5 生命周期诊断。 ## 3. 0.6.4 新增需求 0.6.4 的新增需求已经交付: - 增加中立 coupling surface/facet 查询和扩展导出接口。 - 增加 coupling 节点力导入接口,包含 `source_id`、`load_mode` 和 `valid_flags`。 - 增加本步总力、总力矩、拒绝计数和按 `source_id` 汇总的诊断。 - 增加 `femlite_cclite_load_report.csv` 与 `femlite_cclite_surface_report.csv` 输出。 - 增加 worker mock 命令状态机和 VTU/PVD + coupling 诊断输出闭环。 - 增加 Windows shared memory / named event IPC adapter 的 C 层边界。 - 保留 0.6.3 的 `S4R`、受控 `C3D8R`、积分规则基础设施和元素 introspection API。 ## 4. 0.6.5 新增需求 0.6.5 的新增需求已经交付: - 增加 `--worker-backend ipc` 真实 Windows IPC worker 路径,支持 READY、INIT、STEP、STOP、ERROR 命令闭环。 - 增加 `--solver-id`、`--timeout-ms`、`--worker-id`、`--command-block`、`--data-prefix` 等标准 worker 参数。 - 增加 AOR_V1 data block 布局、初始化和校验接口,支持 surface/facet 导出和 nodal load 导入的共享内存数据段边界。 - 增加 `--cclite-capabilities` 能力查询输出,便于 CCLite 侧进行启动前能力探测。 - 增加真实进程级 IPC worker 小闭环、100 step、timeout 和异常输入自测。 ## 5. 明确不交付范围 以下内容不属于 0.6.5 交付: - 完整 reduced-integration solid 家族。 - 完整 Abaqus 单元库。 - 用户侧任意积分规则选择关键字。 - 生产级有限变形 `S4R`。 - 高级 hourglass 控制参数体系。 - 完整工业级 AL/mortar 一致切线。 - 广义 mixed-control continuation 和分支切换。 - cohesive 主线接触 step。 - DEM/FEM 子循环和大规模颗粒长算例。 - 真实 SPH-FEM penalty contact、FSI 和强耦合 rollback。 - 生产级滚压成形工艺链。 ## 6. 质量要求 - 所有新增功能必须有小型、可重复的测试或 checker。 - 公开接口必须通过 `ierr` 或 C 返回码报告错误,不得直接终止程序。 - 不支持的输入必须明确报错或明确 warning,不得静默回退到不同物理模型。 - 生成的 CSV、VTU/PVD、restart 和临时结果不得提交。 - 发布前必须通过当前版本 release gate。