前言¶
用 DeepSeek Harness（DSH）做《钢铁雄心 IV》（Hearts of Iron IV，HOI4）Mod 时，常见做法是自己在对话里堆 wiki 链接、复制粘贴 PDX 片段，再手动对照 error.log 改语法。国策树、事件、决议、本地化、DDS 图标、.mod 结构各自有一套约定，单靠通用模型很难稳定走完「脚手架 → 静态检查 → 装进玩家目录 → 排错」整条链路。
下面介绍社区插件 dsh-hoi4-modding（维护者 a1249070611）。它向 DSH 注册一个名为 hoi4-modding 的技能包，把规则、工作流、可复制示例和一组 Python 工具脚本绑在一起，面向 HOI4 1.19.3 的 Mod 制作与调试。插件分类为客户端；npm 包当前版本为 1.1.2（MIT 许可）。社区目录页：skillhub.cn/plugins/a1249070611/dsh-hoi4-modding；源码与说明：GitHub。
这是什么¶
dsh-hoi4-modding 是 DeepSeek Harness 的 skill bundle，不是游戏本体或 Paradox 官方工具。安装后只注册技能元数据；真正读写本地 HOI4 安装与玩家 mod/ 目录的是技能内脚本，且仅在你在对话中明确要求时由 agent 执行，命令会在运行前出现在对话里。
技能 hoi4-modding 的定位是：让 agent 能按 Mod 制作流程工作——从零建 Mod、编写国策树 / 事件 / 决议 / 理念 / 角色 / 科技 / MIO / 特殊项目 / scripted GUI、补本地化与 DDS 图标、跑静态校验、安装进游戏、按 error.log 分诊排错。
核心功能¶
技能文档与参考¶
| 路径 | 作用 |
|---|---|
skills/hoi4-modding/SKILL.md |
技能正文：规则、工作流、error.log 分诊、验收清单 |
skills/hoi4-modding/references/cheatsheet.md |
15 类常见任务的可复制代码 |
skills/hoi4-modding/references/deep-dive.md |
主题 → 深度文档索引 |
skills/hoi4-modding/references/tech-tree-ui.md |
科技树 UI：页面可用性、连线、大小框混排、拆页合并、调试手法（1.1.0 起） |
bundled 脚本¶
| 脚本 | 作用 |
|---|---|
new_mod.py |
脚手架生成可运行 Mod（可选国策树；会跑 linter） |
hoi4_lint.py |
静态校验：语法、编码/BOM、本地化、GFX、ID 冲突、.mod 结构 |
install_mod.py |
复制安装 Mod 到玩家 mod/ 并启用（不写游戏安装目录） |
build_reference.py |
从游戏 documentation/*.md 生成 effects/triggers/modifiers/控制台参考 |
dds_helper.py |
生成 / 检查 HOI4 DDS 图标（需 Pillow） |
pdx_parser.py |
供 linter 使用的容错 PDX 解析器 |
tech_tree_audit.py |
审计 Mod 科技页：注册表 vs 页/Tab/项模板/gridbox/科技/本地化 |
tech_folder_available.py |
将 technology_folders.available 从 has_country_flag 迁移为 original_tag（check/apply/revert） |
item_sprite_check.py |
对比项模板尺寸与背景精灵像素（「小框显示成大框」类问题） |
errorlog_triage.py |
对 error.log 分诊：科技树 / 纹理 / scope / 未知字段 / 本地化等 |
README 说明：无游戏本体时技能仍可用于脚手架与代码示例；校验器依赖 HOI4 1.19.3 的 vanilla 索引、GFX 与 ID 检查。游戏目录可自动探测，也可用环境变量 HOI4_GAME、HOI4_USER_DIR 覆盖。
依赖与环境¶
- DeepSeek Harness 含技能注册表，0.2.x（
package.json中engines.dsh:>=0.2.0 <0.3.0；Node^22.19.0 || >=24.0.0）。 - Python 3.10+（脚本以标准库为主；
dds_helper.py需pip install pillow）。 - 插件不附带游戏文件，不需要网络与 API Key。
安装与启用¶
在 DSH 主机要求的环境下执行下列命令之一（与 README 一致）：
# 从 npm 安装（市场安装等价）
dsh plugin --profile web add dsh-hoi4-modding
# 或从源码仓库
dsh plugin --profile web add github:a1249070611/dsh-hoi4-modding
npm 包地址：https://www.npmjs.com/package/dsh-hoi4-modding。
按主机提示重启或刷新后，技能会出现在会话技能目录。可直接用自然语言描述 HOI4 Mod 需求（例如「做个 HOI4 mod」「加个国策树」「mod 报错了」），或显式说「加载 hoi4-modding」。
典型用法¶
工作方式由 SKILL.md 中的规则与工作流驱动，常见路径包括：
- 新建 Mod：通过对话触发
new_mod.py生成目录与基础文件，并由hoi4_lint.py做静态检查。 - 写内容：agent 按 cheatsheet / deep-dive 编写国策、事件、决议等 PDX；需要图标时用
dds_helper.py（先确保已安装 Pillow）。 - 科技树 UI 问题（1.1.0 起）：README 指出
technology_folders.available若仍用旗帜类条件，在新游戏中可能导致整页连线静默消失，应使用original_tag；可用tech_folder_available.py检查或批量修复。大小框混排时，小框背景精灵须指向真实小纹理，可用item_sprite_check.py与tech_tree_audit.py对照文档tech-tree-ui.md中的调试手法。 - 安装与排错：
install_mod.py将 Mod 复制到Documents/Paradox Interactive/Hearts of Iron IV/mod/；游戏报错时用errorlog_triage.py对error.log分诊，再改脚本与本地化。
校验与安装脚本会读取本机 HOI4 路径；安装前请自行确认仓库源码与 MIT 许可证，并理解插件以当前 DSH 进程权限运行。
适用场景与注意¶
适合：已在 DSH 0.2.x 上使用智能体、目标版本为 HOI4 1.19.3、希望把 Mod 制作步骤、静态校验和 error.log 排错收敛到一条对话工作流里的开发者。
注意：
- 社区目录（skillhub.cn）为独立站点，与 DeepSeek / 幻方无官方从属关系；安装插件前请阅读 GitHub 源码与许可。
- 插件只注册技能；Python 脚本在用户请求时执行，可能读取游戏安装目录，并在使用
install_mod.py时写入玩家文档目录下的mod/，不会修改游戏安装目录本身。 - 无 HOI4 安装时，脚手架与示例仍可用，但 linter 的 vanilla/GFX/ID 类检查需要本机 1.19.3 游戏数据。
链接¶
- 社区目录：https://www.skillhub.cn/plugins/a1249070611/dsh-hoi4-modding
- GitHub：https://github.com/a1249070611/dsh-hoi4-modding
- npm：
dsh-hoi4-modding（当前 package 版本 1.1.2）
