DeepSeek Harness Plugin Hub

Publish and manage complete Harness Profiles. Discover Plugins for your next setup.

Explore

PluginsPresetsDocsNews

Community

Publish a pluginContactReport an issue

Resources

Plugin Hub on GitHubDeepSeek HarnessSystem statusPrivacy notice
© 2026 DeepSeek Harness Plugin HubPowered byPaxTech

Independent and unofficial. Not affiliated with, authorized by, or endorsed by DeepSeek.

DeepSeek Harness Plugin Hub
ProfilesPluginsCategoriesNewsDocsSign inManage Profiles
ProfilesPluginsCategoriesNewsDocsSign in
← Plugins

dsh-hoi4-modding

Hoi4 Modding

HOI4 1.19.3 modding skill bundle for DeepSeek Harness: create, edit, validate, install and debug Hearts of Iron IV mods (focus trees, events, decisions, ideas, characters, technologies, MIO, special projects, GUI, localisation, DDS) with bundled verifier/installer scripts; plus tech tree UI diagnost

The plugin will be installed here. Keep web if you are unsure.

npx -y @deepseek-ai/dsh plugin --profile web add dsh-hoi4-modding@1.4.0
READMECompatibilityVersions

Description

HOI4 1.19.3 modding skill bundle for DeepSeek Harness: create, edit, validate, install and debug Hearts of Iron IV mods (focus trees, events, decisions, ideas, characters, technologies, MIO, special projects, GUI, localisation, DDS) with bundled verifier/installer scripts; plus tech tree UI diagnostics, 18-slot tank designer layouts, 3D models, tech icon pipeline, scripted GUI / topbar patterns, CJK font auditing (core_chinese.gfx overrides), a 23-workshop-mod technique survey, and a multi-agent division-of-labour playbook.

Compatibility and provenance

Hoi4 Modding is published as dsh-hoi4-modding and currently resolves to version 1.4.0. The Hub verifies its manifest and preserves the exact installation source for reproducible installs.

DSH compatibility
*
Runtime surfaces
any
Release source
npm
Registry updated
11/5/2026

Versions

1.4.0stable
11/5/2026
1.3.0stable
11/5/2026
1.2.0stable
10/30/2026
Show 3 more versionsCollapse versions
1.1.2stable
10/27/2026
1.1.0stable
10/27/2026
1.0.0stable
10/26/2026

Related plugins

Loading related plugins…

Latest
1.4.0
DSH
*
HMR
Process restart
Tree shaking
Safe tree shaking not declared
Unpacked size
309.7 kB
Files
34
Surface
any
License
MIT
Source
npm
GitHub
★ 1
Weekly downloads
0
Last push
11/5/2026
View source ↗
README badge

Click the badge to copy Markdown for your README.

Do you maintain this Plugin?Claim benefit · Priority security scan

Verify the GitHub repository declared in package.json to manage this listing. After you claim it, Hub will prioritize a security scan of the current version and publish the result when it passes.

Claim this Plugin →
Report an issue

Related plugins

More verified plugins in developer-tools.

Web App@deepseek-ai/dsh-web-appThe dsh browser-surface bundle: the web patch layer over dsh-base plus the runtime glue plugin (frontend dist serving, web-surface prompt, bash runtime variables, URL line)Sdk Minimal@deepseek-ai/dsh-sdk-minimalThe standalone minimal SDK profile bundle: JSON-RPC, one DeepSeek adapter, persistent shell, and JSONL sessionsSdk App@deepseek-ai/dsh-sdk-appThe dsh SDK profile bundle: stdio JSON-RPC serving and process lifecycle over dsh-baseExperimental Inspector@deepseek-ai/dsh-experimental-inspectorExperimental cross-realm CDP hub for Host debugging and Client Runtime inspection

README

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

PathPurpose
skills/hoi4-modding/SKILL.mdThe skill body: rules, workflow, error-log triage, acceptance checklist
skills/hoi4-modding/references/cheatsheet.mdCopy-ready code for 15 common tasks
skills/hoi4-modding/references/deep-dive.mdTopic → deep-documentation index
skills/hoi4-modding/scripts/new_mod.pyScaffold a runnable mod (optional focus tree; runs the linter)
skills/hoi4-modding/scripts/hoi4_lint.pyStatic verifier: syntax, encoding/BOM, localisation, GFX, ID conflicts, .mod structure
skills/hoi4-modding/scripts/install_mod.pyCopy-install a mod into the player mod/ directory and enable it
skills/hoi4-modding/scripts/build_reference.pyGenerate effects/triggers/modifiers/console references from the game's documentation/*.md
skills/hoi4-modding/scripts/dds_helper.pyGenerate / inspect HOI4 DDS icons (needs Pillow)
skills/hoi4-modding/scripts/pdx_parser.pyTolerant PDX script parser used by the linter
skills/hoi4-modding/references/tech-tree-ui.mdTech tree UI: folder availability, connection lines, big/small item layouts, split/merge recipes, debugging recipes
skills/hoi4-modding/scripts/tech_tree_audit.pyAudit a mod's tech pages: registry vs page/tab/item templates/gridboxes/techs/localisation
skills/hoi4-modding/scripts/tech_folder_available.pyMigrate technology_folders.available from has_country_flag to original_tag (check/apply/revert)
skills/hoi4-modding/scripts/item_sprite_check.pyCompare item template sizes with the actual item background sprite pixels ("small item looks big")
skills/hoi4-modding/scripts/errorlog_triage.pyTriage error.log: tech tree / textures / scopes / unknown fields / localisation
skills/hoi4-modding/references/tank-designer.mdTank designer: window/slot position table, 16/18-slot layouts, module-slot data, taller-window background trap
skills/hoi4-modding/references/scripted-gui-and-topbar.mdScripted GUI and topbar buttons: containerWindowType, <button>_click binding, topbar plate extension, font pitfalls, native auto-close limits
skills/hoi4-modding/references/tank-models-3d.mdTank 3D models: entity/pdxmesh/.mesh/.anim/.dds chain, effect nodes, reuse/repaint/custom-mesh routes
skills/hoi4-modding/references/fonts-and-cjk.mdCJK fonts: why ???? happens (core_chinese.gfx overrides), 37 safe font names, custom font slices
skills/hoi4-modding/scripts/font_audit.pyScan interface/ + gfx/ for font = names that have no Chinese glyph slices
skills/hoi4-modding/references/vanilla-mod-survey.md23 workshop mods surveyed: gridbox-as-filter, @ macros, duplicate_archetypes, gui_category, native-shell tabs, topbar mountings
skills/hoi4-modding/references/agent-teams-playbook.mdSplitting HOI4 mod work across agents: write-domain table, handoff contract, audit separation
skills/hoi4-modding/references/icon-dds-pipeline.mdTech icon pipeline: photo → 173×77 DDS, de-background, white-paint protection, safe margins, card preview
skills/hoi4-modding/scripts/tank_designer_probe.pyProbe designer window, slot table, slot-entry size, module categories, chassis slot counts, background DDS size
skills/hoi4-modding/scripts/tank_designer_layout.pyGenerate a custom tank-designer slot layout (16-compact / 16-tall / 18-compact presets) into a mod
skills/hoi4-modding/scripts/tech_icon_import.pyPhoto/vector → 173×77 DDS: de-background, safe-area placement, 183×84 card preview

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.3.0 — Scripted GUI / topbar button guide (containerWindowType, <button>_click, topbar plate extension, native auto-close limits, CJK font pitfalls) and the 18-slot tank designer layout (18-compact preset).
  • 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.3.0)

  • references/scripted-gui-and-topbar.md:scripted GUI 只能 containerWindowType、按钮 <名>_click 绑定、顶栏按钮底图补块(原版斜角)、警报/信息栏避让、原生窗口自动关闭限制、hoi_14mbs/hoi_24mbs 中文字体坑。
  • references/tank-designer.md:新增本项目最终 18 槽(7+4+7) 布局与数据顺序说明。
  • scripts/tank_designer_layout.py:新增 18-compact 预设;生成 18 个槽位位置。
  • README/CHANGELOG 同步 1.3.0。

本次新增(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 游戏素材。