LF Mir200 Codex Skill

这是一个面向 LF/LFM2/翎风引擎 Mir200 服务端脚本 的 Codex 知识库技能项目。

项目把已经转换好的说明书 Markdown、实际 Mir200 脚本样本、索引工具和训练总结组织成一个标准 Codex Skill，方便未来的 Codex 在回答、分析或修改 Mir200 脚本时先查资料、再看真实脚本、最后给出可复用判断。

项目内容

核心 skill 位于：

codex-skills/lf-mir200-knowledge

主要文件：

codex-skills/lf-mir200-knowledge/
  SKILL.md                         # Codex skill 主说明
  knowledge_base/                  # 必须随 skill 发布的完整说明书知识库
  scripts/lf_kb.py                 # 本地索引、搜索、检查工具
  references/local-layout.md       # 本地知识库目录约定
  references/mir200-thinking.md    # 从真实脚本提炼出的思维模型
  references/mir200-training.md    # 用样本脚本继续训练的课程地图
  agents/openai.yaml               # 可复用 agent 配置参考

仓库还包含：

tests/test_lf_kb.py                # 静态工具测试
tests/test_install_codex_skill.py  # 安装包与知识库伴随关系测试

能力范围

这个 skill 用于：

• 查询 LF/LFM2/Mir200 说明书中的命令、参数和规则。
• 检索真实 样本Mir200 脚本中的可用写法。
• 分析 NPC、QuestDiary、MapInfo、MonGen、MerChant、Robot_def、Market_def 等脚本结构。
• 解析 MapInfo.txt 地图链接规则，例如 0 308,264 -> 0102 3,7 表示踩到地图 0 的 X308 Y264 后进入地图 0102 的 X3 Y7。
• 从样本脚本中总结入口、条件、动作、状态写回、失败路径等通用经验。
• 生成并维护 mir200-thinking.md 和 mir200-training.md，让 skill 可以随着样本持续升级。
• 学习并沉淀 Envir 配置文本的读取规则，例如套装备注、套装属性、特效表、物品规则、物品备注等。

这个 skill 不用于：

• 编译、启动或运行 Mir200 服务端。
• 修改或上传服务端二进制、数据库、授权文件、运行日志。
• 凭空编造命令语法。回答前应先检索说明书或样本。

本地知识根要求

使用时 skill 目录内已经包含必需的说明书；如需样本分析，再额外准备本地样本：

codex-skills/lf-mir200-knowledge/knowledge_base/
                                  # 必须随 skill 安装的完整说明书知识库
样本Mir200/                        # 可选的本地 Mir200 服务端脚本样本

本仓库默认不提交这些大体积或敏感内容：

• 原始 CHM 文件
• CHM 解包目录
• 样本Mir200/ 服务端样本（公开仓库不包含）
• .exe、.db、.dat、.lic、日志、缓存等运行文件

这样做是为了让 GitHub 仓库保持轻量，也避免误传服务器私有文件。

安装到 Codex

knowledge_base 是 lf-mir200-knowledge 的必需内容，不能只复制 skill 外壳。推荐使用仓库内安装器：

python scripts\install_codex_skill.py `
  --source . `
  --dest "$env:USERPROFILE\.codex\skills\lf-mir200-knowledge"

兼容旧版 GitHub skill-installer 时，路径必须指向包含嵌套 knowledge_base 的目录：

python install-skill-from-github.py `
  --repo 3dchaos/LfMirSkill `
  --path codex-skills/lf-mir200-knowledge `
  --ref master

安装后，在新任务中当你询问 LF/LFM2/Mir200 脚本、命令、NPC、地图、怪物刷新、机器人脚本、商人脚本等问题时，Codex 会根据 skill 描述加载这套知识库工作流。

常用命令

在 skill 知识根目录运行，或用 --root 指定 codex-skills/lf-mir200-knowledge：

python codex-skills\lf-mir200-knowledge\scripts\lf_kb.py --root codex-skills\lf-mir200-knowledge validate
python codex-skills\lf-mir200-knowledge\scripts\lf_kb.py --root codex-skills\lf-mir200-knowledge update
python codex-skills\lf-mir200-knowledge\scripts\lf_kb.py --root codex-skills\lf-mir200-knowledge search "CHECKITEM GIVE 装备回收" --source all --limit 8
python codex-skills\lf-mir200-knowledge\scripts\lf_kb.py --root codex-skills\lf-mir200-knowledge search "0 308 264 0102" --source mapinfo --limit 5
python codex-skills\lf-mir200-knowledge\scripts\lf_kb.py --root codex-skills\lf-mir200-knowledge inspect "references/mir200-thinking.md"

命令用途：

自我升级方式

当说明书或 样本Mir200 内容变化后，执行：

python codex-skills\lf-mir200-knowledge\scripts\lf_kb.py --root codex-skills\lf-mir200-knowledge update
python codex-skills\lf-mir200-knowledge\scripts\lf_kb.py --root codex-skills\lf-mir200-knowledge validate

更新后重点查看：

• references/mir200-thinking.md：当前从真实脚本中提炼出的“脚本思维”。
• references/mir200-training.md：适合未来 Codex 逐课学习的样本阅读路线。

推荐训练方法：

1. 先看 mir200-training.md 的课程顺序。
2. 每次只学习一个主题，例如 NPC 对话、装备回收、自动机器人、地图事件。
3. 对照说明书确认命令语法。
4. 再从样本中总结入口、条件、动作、状态写回和失败分支。
5. 可复用经验沉淀到 mir200-thinking.md，稳定规则再沉淀到 SKILL.md。

近期训练沉淀

本轮训练重点补强了 样本Mir200\Envir 下的配置文本读取规则：

• TzItemDescList.txt：套装备注是玩家可见说明，不是实际套装效果来源。
• GroupItemList.txt / GroupItemSkillPowerList.txt：运行时套装属性与套装技能威力配置，需按套装 ID 和固定数组位置交叉读取。
• EffectImageList.txt / EffectItemList.txt / EffectList.txt：特效资源、物品默认特效、脚本可调用特效之间需要分层验证。
• ItemRuleList.txt：M2 列表信息2 -> 物品规则 导出的运行时规则表，样本中表现为 物品名 + 40 个规则位 + | + 10 个扩展位。
• ItemDescList.txt：物品悬浮备注显示表，支持颜色、多行和图片/动画标记，但备注文字不等于真实限制。

沉淀后的通用原则：凡是涉及“是否可交易、可丢弃、可修理、可升级、是否触发 QFunction、套装是否真正生效”的判断，必须交叉验证运行时配置、脚本触发和官方说明；不能只看备注文本。

静态分析约束

本项目遵循一个硬约束：

不要编译、启动或运行 Mir200 服务端；只做静态分析与静态验证。

也就是说，Codex 可以读取说明书、检索脚本、分析文本、更新索引、运行本项目的静态检查工具，但不应该尝试启动服务端、连接运行环境或执行 Mir200 相关二进制。

开发验证

本项目当前使用 Python 标准库实现索引工具和测试。提交前建议运行：

python -m unittest tests.test_lf_kb -v
python codex-skills\lf-mir200-knowledge\scripts\lf_kb.py --root . validate

这些验证只检查本仓库的工具逻辑和知识库结构，不会编译或运行 Mir200 服务端。

GitHub 发布说明

这个仓库适合公开保存 skill 本体、工具脚本、训练方法和项目说明。

真实服务器样本、CHM 解包产物和运行文件应继续保留在本地，并通过 .gitignore 排除。完整转换后的 knowledge_base 是公开 skill 的必需发布内容，不再排除。