# CCLite Worker Diagnostics 文档状态:0.8.x mock 设计稿 本文记录 worker 诊断输出的文件名、字段和验收边界。当前实现提供格式工具和 smoke 测试,不在真实 worker 主循环中写文件。 ## 1. 输出文件 | 文件 | 内容 | |---|---| | `sphlite_cclite_worker.log` | worker 启动参数、命令、ack、状态和错误 | | `sphlite_cclite_particle_report.csv` | 每步导出的粒子摘要 | | `sphlite_cclite_force_report.csv` | 每步接收的外部力/力矩和拒绝原因 | ## 2. Worker Log 字段 ```text solver_id,command_block,data_prefix,command_id,step_id,ack_sequence, worker_state,exported_particles,exported_facets,received_forces, error_code,error_message ``` 这些字段覆盖启动参数日志、command/data block 名称、command id、step id、ack seq、worker state、导出数量、接收 force 数量以及错误码/错误消息。 ## 3. CSV 字段 particle report: ```text step_id,region_index,export_index,external_id,phase,status, material,section,x,y,z,vx,vy,vz ``` force report: ```text step_id,region_index,source_id,pair_id,target_id, fx,fy,fz,mx,my,mz,reject_reason ``` ## 4. VTK 复核 worker 结果复核可继续使用现有 VTU/PVD 输出。VTU/PVD 是 SPHLite 求解输出,不替代 worker log 和 CSV 诊断。