钢铁雄心4模组开发 a1249070611/dsh-hoi4-modding

dsh-hoi4-modding

DeepSeek Harness 的技能包，用于 Hearts of Iron IV（HOI4）1.19.3 mod 开发。它注册一个技能 hoi4-modding，把智能体变成能上手干活的 HOI4 modder：从零创建 mod，编写 focus tree / 事件 / 决议 / 理念 / 角色 / 科技 / MIO / 特殊项目 / 脚本 GUI，添加本地化和 DDS 图标，运行静态校验器，安装进游戏，调试 error.log。

安装

from npm (market install does the same thing)
dsh plugin --profile web add dsh-hoi4-modding

or straight from the source repo
dsh plugin --profile web add github:a1249070611/dsh-hoi4-modding

按宿主提示重启或刷新。技能会出现在会话技能目录里；想调用它，直接说要做 HOI4 mod，或者明确说「load hoi4-modding」。

npm：https://www.npmjs.com/package/dsh-hoi4-modding

内容一览

| 路径 | 用途 |
| skills/hoi4-modding/SKILL.md | 技能正文：规则、工作流、error.log 排查、验收清单 |
| skills/hoi4-modding/references/cheatsheet.md | 15 个常见任务的代码，可直接复制 |
| skills/hoi4-modding/references/deep-dive.md | 主题 → 深度文档索引 |
| skills/hoi4-modding/scripts/new_mod.py | 搭出可运行的 mod 骨架（可选 focus tree；会跑 linter） |
| skills/hoi4-modding/scripts/hoi4_lint.py | 静态校验器：语法、编码/BOM、本地化、GFX、ID 冲突、.mod 结构 |
| skills/hoi4-modding/scripts/install_mod.py | 以复制方式安装 mod 到玩家 mod/ 目录并启用 |
| skills/hoi4-modding/scripts/build_reference.py | 从游戏的 documentation/*.md 生成 effects/triggers/modifiers/console 参考 |
| skills/hoi4-modding/scripts/dds_helper.py | 生成 / 检查 HOI4 DDS 图标（需要 Pillow） |
| skills/hoi4-modding/scripts/pdx_parser.py | 宽容的 PDX 脚本解析器，供 linter 使用 |
| skills/hoi4-modding/references/tech-tree-ui.md | 科技树 UI：文件夹可用性、连接线、大/小项目布局、拆分/合并配方、调试配方 |
| skills/hoi4-modding/scripts/tech_tree_audit.py | 审计 mod 的科技页面：注册表 vs 页面/标签/项目模板/gridbox/科技/本地化 |
| skills/hoi4-modding/scripts/tech_folder_available.py | 把 technology_folders.available 从 has_country_flag 迁移到 original_tag（检查/应用/回滚） |
| skills/hoi4-modding/scripts/item_sprite_check.py | 对比项目模板尺寸和实际项目背景 sprite 像素（「小项目看着大」） |
| skills/hoi4-modding/scripts/errorlog_triage.py | 排查 error.log：科技树 / 纹理 / 作用域 / 未知字段 / 本地化 |

环境要求

- DeepSeek Harness，带技能注册表（0.2.x）。
- 内置脚本需要 Python 3.10+（只用标准库；dds_helper.py 需要 pip install pillow）。
- 校验器的原版索引、GFX 和 ID 检查需要 HOI4 1.19.3。没有游戏时，技能仍然用于脚手架和代码配方；游戏目录自动探测（可用 HOI4_GAME / HOI4_USER_DIR 覆盖）。
- 不联网，不需要 API key，不附带游戏文件。

权限

插件只注册技能元数据。打包的 Python 脚本由智能体在用户要求时运行；脚本读取 HOI4 安装目录，install_mod.py 还会写入玩家的 Documents/Paradox Interactive/Hearts of Iron IV/mod/ 目录（绝不写入游戏安装目录本身）。
所有命令运行前都会在对话中显示。

许可证

发布

发布由 GitHub Actions 使用 npm Trusted Publishing (OIDC) 完成 —— 不需要 NPM_TOKEN 密钥，也不需要 bypass-2FA token：

1. npmjs.com → 包 dsh-hoi4-modding → Settings → Trusted Publisher → GitHub Actions （仓库 a1249070611/dsh-hoi4-modding，workflow 文件 release.yml，勾选 "Allow npm publish"）。
2. 发版：npm version patch -m "release %s" && git push origin master --tags。
release.yml workflow 会运行测试并带 provenance 发布。

旧的 granular token 流程（bypass-2FA token + npm publish）已被 npm 弃用，2027 年 1 月起失效。

更新日志

- 1.1.0 —— 来自一次真实大型 Mod 调试会话的科技树 UI 知识：technology_folders.available 必须使用 original_tag（基于旗帜的条件会在新游戏里静默丢掉页面上所有连线），大小框混排要求小框背景精灵指向真实的小尺寸贴图，另加三个调试配方（留痕法、对半分实验、对照探针）和四个新脚本。
- 1.0.0 —— 首次发布。

许可证

MIT。技能文本和脚本均为原创；不包含任何 Paradox 游戏资源。

DeepSeek Harness 的 HOI4 1.19.3 Mod 制作技能包。 安装后注册一个名为 hoi4-modding 的技能：从零建 Mod、写国策/事件/决议/理念/角色/科技/MIO/特殊项目/scripted GUI、本地化与 DDS 图标、静态校验、安装进游戏、按 error.log 排错。

安装

dsh plugin --profile web add dsh-hoi4-modding
或从源码仓库：
dsh plugin --profile web add github:a1249070611/dsh-hoi4-modding

刷新/重启后，技能出现在技能目录；直接说「做个 HOI4 mod」「加个国策树」「mod 报错了」即可触发，也可以显式说「加载 hoi4-modding 技能」。

本次新增（1.1.0）

- references/tech-tree-ui.md：科技树页面可用性 / 连线 / 大小框混排 / 拆页合并 / 三种调试手法（留痕法、对半分、对照探针）
- 4 个新脚本：tech_tree_audit.py（科技页完整性审计）、tech_folder_available.py（旗帜判定→国家标签，批量修复整页无连线）、 item_sprite_check.py（模板尺寸 vs 背景精灵像素，专治"小框显示成大框"）、errorlog_triage.py（error.log 分诊）

发布方式（npm）

- 默认走 GitHub Actions + Trusted Publishing (OIDC)，不需要 NPM_TOKEN、也不需要 bypass-2FA token。
在 npmjs.com 的包设置里把仓库 a1249070611/dsh-hoi4-modding 与 workflow release.yml 注册为 Trusted Publisher；发版只需 npm version patch -m "release %s"，然后 git push origin master --tags，CI 会自动测试并带 provenance 发布。
- 旧的 granular token 直发方式（勾选 Bypass 2FA 后 npm publish）已被 npm 弃用，2027 年 1 月起失效。

依赖

- DeepSeek Harness（含技能注册表，0.2.x）
- Python 3.10+（脚本仅标准库；DDS 工具需 Pillow）
- HOI4 1.19.3（校验器需要；游戏目录自动探测，可用 HOI4_GAME / HOI4_USER_DIR 覆盖）
- 不含任何游戏本体资源，不需要网络与 API Key

权限说明

插件只注册技能元数据；技能里的 Python 脚本由智能体在你要求时执行：读取游戏安装目录， install_mod.py 会把 Mod 复制到玩家 Documents/Paradox Interactive/Hearts of Iron IV/mod/ （不改游戏安装目录）。所有命令在对话中可见。

许可

MIT。技能文本与脚本为原创，不包含 Paradox 游戏素材。