lsdyna-kfile

LS-DYNA K 文件编写与自动验证

完整模型交付物只能是经本机求解器实际计算验证的完整 k 文件和验证报告，不可“写完就交”。 仅要求独立关键字卡片时走下述极简模式，只承诺 L0 静态检查。 以下把本文件所在目录称为 SKILL_DIR；脚本、知识、协议和模板分别位于 SKILL_DIR/scripts/、 SKILL_DIR/knowledge/、SKILL_DIR/references/、SKILL_DIR/templates/。

1. 路由与环境

• 极简模式（优先路由）：用户明确只要一个或少量独立关键字卡片/片段（如 *MAT_*、 *EOS_*），且不要求完整模型、修改现有 deck 或试算时启用。直接生成目标卡片，按要求交付文本 或 .k 文件；不走任务书确认、模板/基准检索、M0~M3、L1/L2、求解器或 §5 完整报告。 参数优先取用户给定值和本地资料，用 units.py 核对换算、用 kfile-format.md 或手册核对字段； 缺少参数时可按 references/literature-parameter-routing.md 的参数检索链路按需联网，但不触发 完整模型的强制基准/文献双链路。除非用户明确要求记录来源，不创建 spec.md、 research/literature-evidence.json 或文献来源清单；关键值无可靠依据就询问，不编造。 将卡片置于临时 *KEYWORD/*END 包裹的独立文件，以 python "SKILL_DIR/scripts/check_kfile.py" fragment.k --fragment 做 L0，要求 0 errors； 仅用户要求文件时保留 .k，否则交付卡片文本。若卡片依赖未提供的外部模型实体， 不虚构配套模型；说明引用检查结果及静态检查覆盖边界。简要报告单位制、假设、 L0 errors/warnings 和未验证项，不把 L0 PASS 称为求解器验证或参数标定。
• 模板制作模式：用户上传主 .k/.key/.dyn，明确说明其要作为某类模板，并要求抽象、整理、 参数化或沉淀。优先执行 references/template-authoring-protocol.md；先运行 python "SKILL_DIR/scripts/prepare_existing_deck.py" user_model.k --outdir template_build/<模板名称> --objective "制作 <模板用途> 模板"， 将源文件和 include 闭包置于只读 source/，只在独立 working/（候选模板）与 validation/ 目录工作。 该模式必须先完成结构化分析和模板适用性判断；会影响模板物理、参数接口或验收结论的问题，整个请求 最多集中询问 5 个关键问题。问题未回答前不得抽象最终模板或进行最终 L2 验证；用户确认后才写入 template_spec.md、NOTES.md 和模板文件。来源 deck 的验证结果不可直接替代模板候选的重新验证。
• 已有 deck 模式：用户提供主 .k/.key/.dyn 并要求修改、调试、运行或修复。跳过 §1 需求头脑风暴、 spec.md 确认、模板/基准/学术门和新建流程，执行 references/existing-deck-repair.md；仍须做 环境检查、knowledge/errors.md 预检、L0/L1/L2、§5 交付报告和经验追加。无 spec.md 时保持 原 deck 的物理意图，仅解决用户目标范围的问题。先运行 python "SKILL_DIR/scripts/prepare_existing_deck.py" user_model.k --objective "用户目标"，不得直接修改原文件。
• 新建 deck 模式：无可用主 deck 或要求重新建模，执行 §2-§5。

完整模型模式会话首次运行：

python "SKILL_DIR/scripts/kagent_config.py"

默认求解器为 C:\Program Files\ANSYS Inc\v242\ansys\bin\winx64（LS-DYNA R14.1.1）；用 LSDYNA_BIN、LSDYNA_MPIEXEC 或 ~/.lsdyna-kagent.json 覆盖。不得使用 R14 之后才支持的关键字或字段。 凡标注 R15 及以上的功能一律回避。手册缺失时运行 python "SKILL_DIR/scripts/fetch_manuals.py"。