abydym AstraLogic AFSIM Skill
开发者： 安徽大学 2023级网络工程 李乐怡 & 周钰炜 GitHub： https://github.com/abydym/AstraLogic 引擎版本： AFSIM 2.9.0
文件注入策略
- 仅本文件（SKILL.md）自动注入 — 控制 token 开销
- 其他文件（blocks/、references/、templates/、scripts/）均在磁盘上，通过
read()按需加载 - 工作流程： 先读
INDEX.md查找所需文件，再用read()加载具体文件
环境配置
# Windows
$env:AFSIM_HOME = "C:\AFSIM2.9\afsim-2.9.0"
# Linux/Mac
export AFSIM_HOME=/opt/afsim-2.9.0
# 验证
& "$env:AFSIM_HOME\bin\mission.exe" --version
# Python 依赖
pip install matplotlib numpy
工作流（4步）
Step 1: cd 项目目录 && mission.exe -es main.txt # 编译
Step 2: 根据错误信息修复 → 重复 Step 1 # 迭代
Step 3: mystic.exe output/*.aer # 3D 可视化
Step 4: python analyze.py --evt output/*.evt # 分析画图
⚠️
define_path_variable CASE name必须在event_output/csv_event_output/event_pipe之前。
关键规则
platform_type <NAME> WSF_PLATFORM— WSF_PLATFORM 关键字必须- 必须包含 mover：
WSF_GROUND_MOVER、WSF_AIR_MOVER、WSF_GUIDED_MOVER或WSF_STRAIGHT_LINE_MOVER - 签名（radar/IR/optical）全局定义，然后在 platform_type 内按名引用
- 结束时间用
end_time <val> secs，不是simulation_end_time - 路由：
edit mover { route ... end_route } end_mover CueToTarget()必须在Fire()之前- 场景文件中目标必须在射手之前包含（预置跟踪）
- 传感器默认关闭；需设置
on或调用sensor.TurnOn() - 文件保存为 无 BOM 的 UTF-8（AFSIM 无法解析 UTF-8 BOM）
- 卫星轨道必须闭合：路线航点需形成至少一个完整轨道（~15个航点）
- 仿真时间需覆盖 ≥1 个完整轨道：LEO 520km 约 5693 秒，公式
T = 2π × √((R+h)³/μ)，μ = 3.986×10¹⁴ - AFSIM 2.9 WSF_SCRIPT_PROCESSOR 限制：无
on_init、无substr()、无atan2()、无三元运算符、无数组{}初始化、无Latitude()/Longitude()方法
常见错误速查
| 错误 | 修复 |
|---|---|
Unknown command: <cmd> |
查手册确认命令名 |
Bad value for: <cmd> |
检查单位格式（m, km, sec, deg, kts, watt, dB） |
Unexpected End Of Data |
end_ 标签不匹配，数一下块 |
Cannot open file: <path> |
setup.txt 中加 file_path . |
Unable to open event_output file |
先创建 output/ 目录 |
Target platform was not defined prior to track |
蓝方文件放在红方之前 |
Bad value for position |
用 34.0n 118.0w altitude 0 m 格式 |
aero type must be specified |
加 aero none 或在制导 mover 中定义 aero |
| UTF-8 BOM 错误 | 用无 BOM 的 UTF-8 保存 |
查找命令（节省 token）
# 在 reference_manual.txt 中查找（限 [-200:+1500] 字符）
# 或使用脚本：
# python scripts/lookup.py <keyword>
规则： 永远不要注入完整手册。按需查询，限制上下文。
文件目录
完整索引见 INDEX.md。 用 read() 加载后按需读取具体文件。
afsim-projectskill/
├── SKILL.md ← 本文件（自动注入）
├── INDEX.md ← 文件索引（先读这个）
├── SYNTAX.md ← AFSIM 语法速查
├── blocks/ ← 可复用代码块（45+ 文件）
├── references/ ← 命令参考手册（17 文件）
├── scripts/ ← 工具脚本
├── templates/ ← 可编译项目模板
└── COMPREHENSIVE_SUMMARY.md ← 详细功能总结