dsh-hoi4-modding

English | 中文

A DeepSeek Harness skill bundle for Hearts of Iron IV (HOI4) 1.19.3 modding. It registers one skill, hoi4-modding, which turns the agent into a working HOI4 modder: create a mod from scratch, write focus trees / events / decisions / ideas / characters / technologies / MIO / special projects / scripted GUI, add localisation and DDS icons, run a static verifier, install into the game, and debug error.log.

Install

# 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

Restart / refresh as the host asks. The skill appears in the session skill catalog; invoke it by asking for HOI4 modding, or explicitly “load hoi4-modding”.

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

What is inside

Requirements

• DeepSeek Harness with the skill registry (0.2.x).
• Python 3.10+ for the bundled scripts (stdlib only; dds_helper.py needs pip install pillow).
• HOI4 1.19.3 for the verifier's vanilla index, GFX and ID checks. Without the game the skill still works for scaffolding and code recipes; the game directory is auto-detected (HOI4_GAME / HOI4_USER_DIR override).
• No network access, no API keys, no game files are shipped.

Permissions

The plugin registers skill metadata only. The bundled Python scripts are run by the agent when the user asks; they read the HOI4 install and, for install_mod.py, write into the player Documents/Paradox Interactive/Hearts of Iron IV/mod/ directory (never the game install itself). All commands are visible in the conversation before they run.

License

Publishing

Releases are published by GitHub Actions using npm Trusted Publishing (OIDC) — no NPM_TOKEN secret and no bypass-2FA token are required:

1. npmjs.com → package dsh-hoi4-modding → Settings → Trusted Publisher → GitHub Actions (repository a1249070611/dsh-hoi4-modding, workflow file release.yml, "Allow npm publish").
2. Release: npm version patch -m "release %s" && git push origin master --tags. The release.yml workflow runs the tests and publishes with provenance.

The old granular-token flow (bypass-2FA token + npm publish) is deprecated by npm and stops working in January 2027.

Changelog

• 1.1.0 — Tech tree UI knowledge from a real large-mod debugging session: technology_folders.available must use original_tag (flag-based conditions silently drop every connection line on a page in new games), big/small item mixing requires the small item background sprites to point at real small textures, plus three debugging recipes (marker rename, half-split experiment, control probe) and four new scripts.
• 1.0.0 — Initial release.

License

MIT. The skill text and scripts are original; no Paradox game assets are included.

中文

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.2.0）

• references/tank-designer.md：坦克设计器（窗口 / pos_custom_module_slot_window_N 槽位位置表 / 底盘 module_slots / 模块类别 / 16 槽布局 / 加高窗口背景贴图坑 / 隐藏升级区与自动按钮）
• references/tank-models-3d.md：坦克 3D 模型链路（entity→pdxmesh→.mesh/.anim/.dds、特效节点 barrel/tracks/exhaust、复用原版 / 换贴图 / 自制 mesh 三条路线）
• references/icon-dds-pipeline.md：科技卡 173×77 图标流水线（去白底/棋盘格、白色涂装保护、安全区 20/4、183×84 卡片自检）
• 新增 3 个脚本：tank_designer_probe.py（设计器体检）、tank_designer_layout.py（生成 16 槽布局）、tech_icon_import.py（照片→图标 DDS）
• 科技树文档补充：多根分支 gridbox（一个页面多个 _tree）、生成文件被外部改写导致 Found no grid box 的排查

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 脚本由 agent 在你要求时执行：读取游戏安装目录， install_mod.py 会把 Mod 复制到玩家 Documents/Paradox Interactive/Hearts of Iron IV/mod/ （不改游戏安装目录）。所有命令在对话中可见。

许可

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