前言¶

在 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 倉庫。