前言¶

在 DeepSeek Harness（DSH）里做 HOI4 模组，常见摩擦不是「不会写 Clausewitz 脚本」，而是引擎静默失败：本地化缺 BOM 整条被忽略、事件忘 add_namespace 根本不注册、国策 id 冲突被悄悄丢掉。模型还倾向于写出语法正确、字段却不在 1.19 里的内容。dsh-hoi4-modding（维护者 Kiant98，GitHub Kiant98/dsh-hoi4-modding）把原版与文档索引成可检索知识库，用 MCP 工具做生成前查阅、写后机器校验和离线预览，把闭环压进 DSH 工作流。下文按「装什么 → 怎么装 → 典型命令」说明。

这是什么¶

dsh-hoi4-modding 是钢铁雄心 4 的模组开发工具包，当前版本 3.2.0（2026-11-09，MIT 许可）。装进 DSH 后提供 1 个模组工程师 agent、15 个技能、20 个 MCP 工具，外加 163 篇参考库与以原版 1.19.x（Operation Postern） 为参照的可建索引知识库。实现侧为 纯 Python 标准库、零第三方依赖（Python 3.9+）。插件在 SkillHub 分类为工作流；仓库简介还提到国策树、科技树 UI、坦克设计器、scripted GUI、CJK 字体等主题，但不包含游戏资产。目录页：skillhub.cn/plugins/Kiant98/dsh-hoi4-modding。

作者归纳的闭环是：索引原版 → 查真实实现 → 生成骨架 → 机器校验 → 离线预览 → 进游戏验证，再把结论记回知识库。

参考库与知识库¶

参考库（随包文档）¶

references/ 下 163 篇文档（146 篇正文 + 17 篇域索引），按脚本、内容系统、军事、世界地图、表现层、工程流程等域组织；另有错题本、方案库与案例区。入口路由见 references/_index.md（「我要做 X → 读哪一篇」）。知识来源优先级写在 references/AUTHORITY.md：游戏自带 documentation/*.md 与域级 _documentation.md 为字段级权威；无官方文档的域以原版实例为准。

本地 SQLite 知识库¶

把原版、已装模组、指定本地目录与笔记索引成库后，可用工具按符号、全文、类型检索，结果带文件路径与行号，并对 game-doc / domain-doc / vanilla-instance 等来源分级。示例（经 MCP 调用，参数以 README 为准）：

python mcp-server/server.py --call kiant_hoi4_kb_lookup '{"kind":"tech"}'
python mcp-server/server.py --call kiant_hoi4_kb_search '{"query":"scripted_gui"}'
python mcp-server/server.py --call kiant_hoi4_kb_symbol '{"name":"GER_pz1_a"}'

符号查询可区分 effect 是否存在与拼写错误，例如 kiant_hoi4_kb_symbol name=add_to_variable 命中文档行号，add_stabiltiy 返回 found: false。

两级资料：平台资料库（kiant_hoi4_kb_sync action=pull）与本地资料库（kiant_hoi4_kb_build action=build）。检索时 kiant_hoi4_kb_search 的 scope 可选 auto、platform、local、all。

校验、预览与规划¶

十二类可插拔校验¶

python mcp-server/server.py --call kiant_hoi4_validate_mod '{"deep":true}'

覆盖描述文件、本地化、语法、重复 id、科技、资产与图标、GUI、on_actions、音乐、国策树语义、本地化命令等。结果含 file、line、hint；等级分 error / warn / info，在能否对照原版索引时会对报错过级，以减少假阳性。

离线 HTML 预览¶

python mcp-server/server.py --call kiant_hoi4_preview '{}'

生成自包含 HTML：国策树按坐标与前置连线渲染，并汇总本地化覆盖率等问题，无需启动游戏。

长任务规划¶

python mcp-server/server.py --call kiant_hoi4_plan '{"action":"init"}'
python mcp-server/server.py --call kiant_hoi4_plan '{"action":"status"}'

同步维护 ROADMAP.md，用 Markdown 复选框跟踪阶段与验收标准。

在 DeepSeek Harness 中安装与启用¶

自 3.2.0 起，npm 包同时是 DSH 组合包（dsh.bundle.patch + cordis.patch.yml + lib/index.js），推荐在 Harness 内安装。

1、打开 设置 → 插件，搜索 dsh-hoi4-modding，安装（已安装则更新到 3.2.0），重开会话。

2、装好后 15 个技能自动出现在技能列表；20 个工具以 mcp__kiant_hoi4_modkit__kiant_hoi4_* 挂载，由 lib/index.js 用本机 python 启动 mcp-server/server.py（stdio）。

3、可选插件配置（JSON）：

{"python": "C:/path/to/python.exe"}

指定解释器；不需要 MCP 时可设：

{"mcp": false}

package.json 要求 DSH >=0.2.0 <0.3.0，Node ^22.19.0 || >=24.0.0。

首次使用前可在包目录确认 Python 与工具列表：

python mcp-server/server.py --list
python mcp-server/server.py --call kiant_hoi4_kb_stats '{}'

建索引（README 称首次约 30 秒，之后增量）：

python mcp-server/server.py --call kiant_hoi4_kb_build '{"action":"discover"}'
python mcp-server/server.py --call kiant_hoi4_kb_build '{"action":"build"}'

README 还列出 Release _zip、npm 安装等方式；接入其他客户端见仓库 platform/README.md。DSH 社区目录（SkillHub）是独立站点，与 DeepSeek / 幻方无官方从属关系，并非官方应用商店。

典型用法（可复现顺序）¶

1、kiant_hoi4_kb_sync action=pull 拉平台资料（若使用平台库）。

2、kiant_hoi4_kb_build action=build 建本地库；需要索引自有目录时显式传入 local_dirs（工具不会自动扫全盘）。

3、写模组前用 kiant_hoi4_kb_search / kiant_hoi4_kb_symbol 对照原版或文档。

4、改完后 kiant_hoi4_validate_mod deep=true，再 kiant_hoi4_preview 看结构与文案。

5、进游戏验证；问题与结论可回流笔记并再次 kb_build。

第一次上手可走仓库 GETTING-STARTED.md，目标是在无 Clausewitz 先验的情况下做出可运行的国策骨架。

适用场景与注意¶

适合谁：面向 HOI4 1.19.x 的模组作者，或希望在 DSH 里用 agent + 技能 + MCP 把「查原版 → 写脚本 → 校验 → 预览」串成固定工作流的人。参考库与校验语义、路径习惯均按 1.19 实测校对（如 .mod 的 picture=、启动参数 -debug_mode 等，见 README 验证表）。

权限与安全：插件 MCP 以当前 DSH 进程权限在本机执行 Python，会读取你配置的游戏路径、模组目录与 local_dirs。安装前应浏览 GitHub 源码 与 MIT 许可证，确认可接受其索引与校验范围。不要上传未授权的游戏文件到第三方；知识库默认本地化索引 english + simp_chinese，全语言需按 README 配置 loc_langs。

能力边界：README 写明军事装备等部分域的校验覆盖有限；references/92_solutions/ 中方案有「未验证」状态标记，需与错题本、案例区区分开。

结尾¶

dsh-hoi4-modding 的价值在于把 Paradox 引擎「不崩溃只失效」类问题和模型字段幻觉，转成可检索出处与可机器执行的检查，并原生挂进 DSH 的技能与 MCP 体系。需要安装说明与更新记录见 SkillHub 目录页 与 GitHub 仓库。