dsh-hoi4-modding 1.1.1 → 1.2.0

package/CHANGELOG.md

@@ -1,32 +1,69 @@
-# Changelog
-
-## 1.1.1
-
-- 文档同步补丁：README 增加「Publishing」小节（2026 年可用 granular token 直发；**2027-01 起该方式移除**，
-  改用 stage only + `npm stage publish` 或 GitHub Actions Trusted Publishing），CHANGELOG 记录同项。
-  1.1.0 已包含全部功能与脚本，本版仅同步文档，避免 npm 包与仓库不一致。
-
-## 1.1.0
-
-科技树 UI 专题（来自一次 2900 科技/多国科技页大型 Mod 的真实排障，全部结论经游戏内对照实验验证）：
-
-- **新增** `references/tech-tree-ui.md`
-  - `technology_folders.available` 必须用 `original_tag`：用 `has_country_flag` 时引擎建页画线阶段的
-    运行时二次求值失败，**整页连线被静默丢弃**（方框在、日志干净、旧存档正常而新开档必现）。
-  - 大框/小框混排三件套：`force_use_small_tech_layout` + `techtree_<folder>_small_item` 模板 +
-    `GFX_technology_<folder>_small_*_item_bg` **指向真正的小图**（模板 size 只管排版，贴图按像素绘制）。
-  - 拆页/合并页 6 步配方、网格原点统一规则、跨页 path 不画线的必然性。
-  - 三种调试手法：留痕法（改名 gridbox 判断页面是否被建）、对半分实验、对照探针。
-- **新增脚本**
-  - `tech_tree_audit.py`：科技页完整性审计（注册表 ↔ 页面/页签/item 模板/网格/科技/本地化）
-  - `tech_folder_available.py`：`has_country_flag` → `original_tag` 批量迁移（check/apply/revert）
-  - `item_sprite_check.py`：item 模板尺寸 vs 背景精灵实际像素（专治"小框显示成大框 + 偏位"）
-  - `errorlog_triage.py`：error.log 分诊（科技树/贴图/scope/未知字段/本地化），并给出"日志干净即静默跳过"的判语
-- **SKILL.md**：铁律新增 2 条（科技页可用性、大小框三件套）；排错表新增 3 行症状；验收清单新增 2 条；
-  工具与配方索引补充新内容。
-- README：脚本清单、更新记录（中英）。
-- README：补充 npm 发布方式说明（2027-01 起 granular token 直发被移除，改用 stage only / Trusted Publishing）。
-
-## 1.0.0
-
-- 首个版本：HOI4 1.19.3 Mod 全流程技能（骨架/国策/事件/决议/理念/角色/科技/州/MIO/特殊项目/GUI/本地化/DDS/校验/安装/排错/发布）。
+# Changelog
+
+## 1.2.0
+
+坦克设计器 + 3D 模型 + 图标流水线专题（来自一次 30 科技德国坦克树 / 16 槽设计器改造的真实工程，
+全部结论经游戏内对照验证）：
+
+- **新增** `references/tank-designer.md`
+  - 设计器文件地图：`interface/tank_designer_view.gui`（窗口 1091×542、`equipment_modules` 13/146 512×350、
+    9 个 `pos_custom_module_slot_window_*`）、`equipmentdesignerview.gui`（槽位按钮模板 **76×47**）、
+    每底盘蓝图 GUI（`equipment_designer_<底盘>` → archetype 回退）。
+  - 数据侧：槽位 = `module_slots` 书写顺序；模块类别由 `category =` 隐式创建；装备可自定义 `module_slots`。
+  - 16 槽布局（上 7 + 第二排 2 + 下 7，窗口不加高 542）完整坐标与取舍。
+  - **窗口背景固定尺寸坑**：`GFX_tank_designer_popup_bg` 是 1092×553 贴图，只改窗口 size 会让内容溢出；
+    给出“顶部原样 + 中间平铺 + 底部原样”生成加高 DDS 的配方。
+  - 隐藏升级区/自动按钮的安全做法（position 移出屏幕；`auto_upgrade_button` 可能被代码自动摆放）。
+- **新增** `references/tank-models-3d.md`
+  - 四层链路 `graphic_db` → `entity`（`.asset`）→ `pdxmesh`（`.gfx`）→ `.mesh/.anim/.dds`；
+  - 原版德国实体清单（`GER_iw/light/medium/heavy/super_heavy_armor_entity`）、特效节点
+    `barrel`/`left_tracks`/`right_tracks`/`left_exhaust`/`right_exhaust`；
+  - 复用原版 / 换贴图 / 自制 mesh 三条路线，导出器（Maya 官方、Blender 社区）与排错表。
+- **新增** `references/icon-dds-pipeline.md`
+  - 科技卡几何：183×84 卡、`Icon` 中心 x=74 → 内容右移 8px（左 20 / 右 4 / 上下 2，最大 149×73）；
+  - 去背（透明/白底/8px 棋盘格）、白色涂装保护规则（亮度≥235 且 relY<0.8）、批量别名表、卡片预览自检、踩坑表。
+- **新增脚本**
+  - `tank_designer_probe.py`：设计器体检（窗口/槽位位置/槽位模板/背景 DDS 尺寸/模块类别/底盘 archetype 槽数/隐藏元素）
+  - `tank_designer_layout.py`：从原版 GUI 生成自定义槽位布局（默认 16 槽紧凑版，支持 16-tall、背景 sprite 替换、dry-run）
+  - `tech_icon_import.py`：照片/矢量图 → 173×77 DDS（去背 + 安全区 + 183×84 卡片预览，可调尺寸/边距）
+- **文档补充**
+  - `references/tech-tree-ui.md` 新增：多根分支 gridbox（一个页面多个 `_tree`）、生成文件被外部改写导致
+    `Found no grid box` 的排查顺序；
+  - `references/cheatsheet.md` 新增 §16：坦克设计器 / 3D 模型 / 173×77 图标速查；
+  - SKILL.md 铁律 +2 条、配方索引 +3 行、排错表 +3 行、验收清单 +2 条。
+
+## 1.1.2
+
+- 发布通道切换为 **npm Trusted Publishing (OIDC)**：`release.yml` 去掉 `NPM_TOKEN` 依赖，改用 OIDC 发布并生成 provenance；
+  README 的中英「Publishing」小节同步更新。技能内容与 1.1.1 相同（纯发布/文档变更）。
+
+## 1.1.1
+
+- 文档同步补丁：README 增加「Publishing」小节（2026 年可用 granular token 直发；**2027-01 起该方式移除**，
+  改用 stage only + `npm stage publish` 或 GitHub Actions Trusted Publishing），CHANGELOG 记录同项。
+  1.1.0 已包含全部功能与脚本，本版仅同步文档，避免 npm 包与仓库不一致。
+
+## 1.1.0
+
+科技树 UI 专题（来自一次 2900 科技/多国科技页大型 Mod 的真实排障，全部结论经游戏内对照实验验证）：
+
+- **新增** `references/tech-tree-ui.md`
+  - `technology_folders.available` 必须用 `original_tag`：用 `has_country_flag` 时引擎建页画线阶段的
+    运行时二次求值失败，**整页连线被静默丢弃**（方框在、日志干净、旧存档正常而新开档必现）。
+  - 大框/小框混排三件套：`force_use_small_tech_layout` + `techtree_<folder>_small_item` 模板 +
+    `GFX_technology_<folder>_small_*_item_bg` **指向真正的小图**（模板 size 只管排版，贴图按像素绘制）。
+  - 拆页/合并页 6 步配方、网格原点统一规则、跨页 path 不画线的必然性。
+  - 三种调试手法：留痕法（改名 gridbox 判断页面是否被建）、对半分实验、对照探针。
+- **新增脚本**
+  - `tech_tree_audit.py`：科技页完整性审计（注册表 ↔ 页面/页签/item 模板/网格/科技/本地化）
+  - `tech_folder_available.py`：`has_country_flag` → `original_tag` 批量迁移（check/apply/revert）
+  - `item_sprite_check.py`：item 模板尺寸 vs 背景精灵实际像素（专治"小框显示成大框 + 偏位"）
+  - `errorlog_triage.py`：error.log 分诊（科技树/贴图/scope/未知字段/本地化），并给出"日志干净即静默跳过"的判语
+- **SKILL.md**：铁律新增 2 条（科技页可用性、大小框三件套）；排错表新增 3 行症状；验收清单新增 2 条；
+  工具与配方索引补充新内容。
+- README：脚本清单、更新记录（中英）。
+- README：补充 npm 发布方式说明（2027-01 起 granular token 直发被移除，改用 stage only / Trusted Publishing）。
+
+## 1.0.0
+
+- 首个版本：HOI4 1.19.3 Mod 全流程技能（骨架/国策/事件/决议/理念/角色/科技/州/MIO/特殊项目/GUI/本地化/DDS/校验/安装/排错/发布）。

package/README.md

@@ -1,128 +1,146 @@
-# 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
-
-```sh
-# 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
-
-| Path | Purpose |
-|---|---|
-| `skills/hoi4-modding/SKILL.md` | The skill body: rules, workflow, error-log triage, acceptance checklist |
-| `skills/hoi4-modding/references/cheatsheet.md` | Copy-ready code for 15 common tasks |
-| `skills/hoi4-modding/references/deep-dive.md` | Topic → deep-documentation index |
-| `skills/hoi4-modding/scripts/new_mod.py` | Scaffold a runnable mod (optional focus tree; runs the linter) |
-| `skills/hoi4-modding/scripts/hoi4_lint.py` | Static verifier: syntax, encoding/BOM, localisation, GFX, ID conflicts, `.mod` structure |
-| `skills/hoi4-modding/scripts/install_mod.py` | Copy-install a mod into the player `mod/` directory and enable it |
-| `skills/hoi4-modding/scripts/build_reference.py` | Generate effects/triggers/modifiers/console references from the game's `documentation/*.md` |
-| `skills/hoi4-modding/scripts/dds_helper.py` | Generate / inspect HOI4 DDS icons (needs Pillow) |
-| `skills/hoi4-modding/scripts/pdx_parser.py` | Tolerant PDX script parser used by the linter |
-| `skills/hoi4-modding/references/tech-tree-ui.md` | Tech tree UI: folder availability, connection lines, big/small item layouts, split/merge recipes, debugging recipes |
-| `skills/hoi4-modding/scripts/tech_tree_audit.py` | Audit a mod's tech pages: registry vs page/tab/item templates/gridboxes/techs/localisation |
-| `skills/hoi4-modding/scripts/tech_folder_available.py` | Migrate `technology_folders.available` from `has_country_flag` to `original_tag` (check/apply/revert) |
-| `skills/hoi4-modding/scripts/item_sprite_check.py` | Compare item template sizes with the actual item background sprite pixels ("small item looks big") |
-| `skills/hoi4-modding/scripts/errorlog_triage.py` | Triage `error.log`: tech tree / textures / scopes / unknown fields / localisation |
-
-## 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
-
-- **Now – December 2026**: a granular access token with **Read and write (publish and stage)** and
-  **Bypass 2FA** enabled can publish directly with `npm publish --access public`.
-  npm deprecates this path in **January 2027**.
-- **From January 2027**: use a **stage only** token plus `npm stage publish`, or GitHub Actions
-  **Trusted Publishing** (the bundled `release.yml` already runs on `v*` tags).
-
-## 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` 排错。
-
-### 安装
-
-```sh
-dsh plugin --profile web add dsh-hoi4-modding
-# 或从源码仓库：
-dsh plugin --profile web add github:a1249070611/dsh-hoi4-modding
-```
-
-刷新/重启后，技能出现在技能目录；直接说「做个 HOI4 mod」「加个国策树」「mod 报错了」即可触发，
-也可以显式说「加载 hoi4-modding 技能」。
-
-### 本次新增（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）
-- 2026 年内：Granular token 选 **Read and write (publish and stage)** 并勾选 **Bypass 2FA**，可 `npm publish --access public` 直发；
-  npm 已在页面上提示该方式将于 **2027 年 1 月**移除。
-- 2027 年起：改用 **stage only** token + `npm stage publish`，或 GitHub Actions **Trusted Publishing**
-  （仓库里的 `release.yml` 已在 `v*` 标签触发）。
-
-### 依赖
-
-- 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 游戏素材。
+# 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
+
+```sh
+# 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
+
+| Path | Purpose |
+|---|---|
+| `skills/hoi4-modding/SKILL.md` | The skill body: rules, workflow, error-log triage, acceptance checklist |
+| `skills/hoi4-modding/references/cheatsheet.md` | Copy-ready code for 15 common tasks |
+| `skills/hoi4-modding/references/deep-dive.md` | Topic → deep-documentation index |
+| `skills/hoi4-modding/scripts/new_mod.py` | Scaffold a runnable mod (optional focus tree; runs the linter) |
+| `skills/hoi4-modding/scripts/hoi4_lint.py` | Static verifier: syntax, encoding/BOM, localisation, GFX, ID conflicts, `.mod` structure |
+| `skills/hoi4-modding/scripts/install_mod.py` | Copy-install a mod into the player `mod/` directory and enable it |
+| `skills/hoi4-modding/scripts/build_reference.py` | Generate effects/triggers/modifiers/console references from the game's `documentation/*.md` |
+| `skills/hoi4-modding/scripts/dds_helper.py` | Generate / inspect HOI4 DDS icons (needs Pillow) |
+| `skills/hoi4-modding/scripts/pdx_parser.py` | Tolerant PDX script parser used by the linter |
+| `skills/hoi4-modding/references/tech-tree-ui.md` | Tech tree UI: folder availability, connection lines, big/small item layouts, split/merge recipes, debugging recipes |
+| `skills/hoi4-modding/scripts/tech_tree_audit.py` | Audit a mod's tech pages: registry vs page/tab/item templates/gridboxes/techs/localisation |
+| `skills/hoi4-modding/scripts/tech_folder_available.py` | Migrate `technology_folders.available` from `has_country_flag` to `original_tag` (check/apply/revert) |
+| `skills/hoi4-modding/scripts/item_sprite_check.py` | Compare item template sizes with the actual item background sprite pixels ("small item looks big") |
+| `skills/hoi4-modding/scripts/errorlog_triage.py` | Triage `error.log`: tech tree / textures / scopes / unknown fields / localisation |
+| `skills/hoi4-modding/references/tank-designer.md` | Tank designer: window/slot position table, 16-slot layouts, module-slot data, taller-window background trap |
+| `skills/hoi4-modding/references/tank-models-3d.md` | Tank 3D models: `entity`/`pdxmesh`/`.mesh`/`.anim`/`.dds` chain, effect nodes, reuse/repaint/custom-mesh routes |
+| `skills/hoi4-modding/references/icon-dds-pipeline.md` | Tech icon pipeline: photo → 173×77 DDS, de-background, white-paint protection, safe margins, card preview |
+| `skills/hoi4-modding/scripts/tank_designer_probe.py` | Probe designer window, slot table, slot-entry size, module categories, chassis slot counts, background DDS size |
+| `skills/hoi4-modding/scripts/tank_designer_layout.py` | Generate a custom tank-designer slot layout (16-compact preset) into a mod |
+| `skills/hoi4-modding/scripts/tech_icon_import.py` | Photo/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.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` 排错。
+
+### 安装
+
+```sh
+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 游戏素材。

package/package.json

@@ -1,67 +1,70 @@
-{
-  "name": "dsh-hoi4-modding",
-  "version": "1.1.1",
-  "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 (page availability, connection lines, big/small item layouts).",
-  "type": "module",
-  "main": "lib/index.js",
-  "exports": {
-    ".": "./lib/index.js",
-    "./package.json": "./package.json",
-    "./cordis.patch.yml": "./cordis.patch.yml"
-  },
-  "files": [
-    "lib/index.js",
-    "cordis.patch.yml",
-    "skills/**/*",
-    "README.md",
-    "LICENSE",
-    "icon.svg",
-    "CHANGELOG.md"
-  ],
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    }
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-skill": ">=0.1.0-rc.1 <0.3.0-0"
-  },
-  "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-skill": {
-      "optional": true
-    }
-  },
-  "engines": {
-    "node": "^22.19.0 || >=24.0.0",
-    "dsh": ">=0.2.0 <0.3.0"
-  },
-  "scripts": {
-    "test": "node --test tests/smoke.test.mjs"
-  },
-  "keywords": [
-    "deepseek",
-    "deepseek-harness",
-    "dsh",
-    "dsh-plugin",
-    "skill",
-    "hearts-of-iron",
-    "hoi4",
-    "hoi4-modding",
-    "paradox",
-    "modding"
-  ],
-  "icon": "./icon.svg",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/a1249070611/dsh-hoi4-modding.git"
-  },
-  "homepage": "https://github.com/a1249070611/dsh-hoi4-modding#readme",
-  "bugs": {
-    "url": "https://github.com/a1249070611/dsh-hoi4-modding/issues"
-  }
-}
+{
+  "name": "dsh-hoi4-modding",
+  "version": "1.2.0",
+  "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 and tank designer (module slots, 16-slot layouts, 3D models, tech icon pipeline).",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./package.json": "./package.json",
+    "./cordis.patch.yml": "./cordis.patch.yml"
+  },
+  "files": [
+    "lib/index.js",
+    "cordis.patch.yml",
+    "skills/**/*",
+    "README.md",
+    "LICENSE",
+    "icon.svg",
+    "CHANGELOG.md"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-skill": ">=0.1.0-rc.1 <0.3.0-0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-skill": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0",
+    "dsh": ">=0.2.0 <0.3.0"
+  },
+  "scripts": {
+    "test": "node --test tests/smoke.test.mjs"
+  },
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "skill",
+    "hearts-of-iron",
+    "hoi4",
+    "hoi4-modding",
+    "paradox",
+    "modding",
+    "tank-designer",
+    "3d-models",
+    "icon-pipeline"
+  ],
+  "icon": "./icon.svg",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/a1249070611/dsh-hoi4-modding.git"
+  },
+  "homepage": "https://github.com/a1249070611/dsh-hoi4-modding#readme",
+  "bugs": {
+    "url": "https://github.com/a1249070611/dsh-hoi4-modding/issues"
+  }
+}

package/skills/hoi4-modding/INSTALL.md

@@ -8,7 +8,8 @@
 ```
 hoi4-modding/
 ├─ SKILL.md          # 必需：frontmatter 含 name、description
-├─ references/       # 可选：参考资料（本技能为 cheatsheet.md、deep-dive.md）
+├─ references/       # 可选：参考资料（本技能为 cheatsheet.md、deep-dive.md、tech-tree-ui.md、
+│                    #       tank-designer.md、tank-models-3d.md、icon-dds-pipeline.md）
 ├─ scripts/          # 可选：可执行工具（Python 3.10+，标准库；DDS 需 Pillow）
 └─ INSTALL.md        # 本文件
 ```