dsh-h3-image 0.2.0 → 0.2.1

package/LICENSE

@@ -22,6 +22,9 @@ SOFTWARE.
 
 NOTE: This license covers the plugin source code only. The MiniMax H3-Image
 model weights are distributed separately by MiniMax under the MiniMax H3
-Image Community License Agreement (shown inside the setup wizard before any
-download), and the upstream MLX engine is Apache-2.0. See
+Image Community License Agreement, and the quantized text encoder under the
+MiniMax H3 Community License Agreement; the setup wizard shows the key
+points of both (including territorial exclusions) with direct links to the
+full texts before any download, and the original agreement files land on
+your disk with the downloads. The upstream MLX engine is Apache-2.0. See
 THIRD_PARTY_NOTICES.md.

package/README.md

@@ -1,21 +1,83 @@
 # dsh-h3-image
 
-**English** | [简体中文](README.zh.md)
+[简体中文](#简体中文) | [English](#english)
 
-> **Name reserved.** This package version (0.2.0) ships the full local
-> pipeline: the read-only environment check, the one-time setup wizard
-> (venv → pinned engine clone → license gate → sha256-verified weight
-> download with resume → smoke test, each long step a background job that
-> survives restarts), and text-to-image. Nothing here calls any cloud
-> service.
+## 简体中文
 
-A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH)
-plugin bundle that runs the open-source **MiniMax H3-Image** text-to-image
-model **entirely on your own Apple Silicon Mac**, through the
-[MLX](https://github.com/ml-explore/mlx) engine. No API keys, no accounts, no
-per-image fees, no egress during generation.
+> **非官方声明**：本插件是社区独立开发的第三方工具，与 MiniMax 无任何关联、未获其背书；"MiniMax-H3-Image" 仅用于指示所支持的模型。权重依 MiniMax 社区许可协议提供，**授权地域不含欧盟、英国、韩国、美国**——请自行确认你所在司法辖区可合法使用。完整免责与商用提示见 [docs/DISCLAIMER.md](docs/DISCLAIMER.md)。
 
-## What you get
+一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）插件包：在**你自己的 Apple Silicon Mac** 上，通过 [MLX](https://github.com/ml-explore/mlx) 引擎运行开源的 **MiniMax H3-Image** 文生图模型，全程完全本地。零 API 密钥、零账号、零按张费用，生图过程零出网。
+
+当前版本交付完整本地链路：只读环境体检、一键安装向导（venv → 钉定引擎 clone → 许可确认 → sha256 校验的权重下载（支持断点续传）→ 冒烟出图，每个长步骤都是宿主重启不丢的后台任务），以及本地文生图。
+
+### 你能得到什么
+
+| 工具 | 用途 |
+| --- | --- |
+| `h3_status` | 只读环境体检：平台、统一内存、venv、引擎 commit、权重、文本编码器、可用磁盘——每个红项附修复提示。 |
+| `h3_setup` | 一键安装向导，可续传状态机：`check → venv → engine → license → weights → smoke`。长步骤（引擎安装、约 59 GB 下载+转换）以分离后台任务运行——提交秒级返回 `job_id`，`action=poll` 从引擎自身的磁盘状态读进度，中断的下载重跑时从 `.part` 续传。死掉的任务如实报 `interrupted`，绝不谎报"完成"。`action=license` 展示社区许可，接受记录只能由你本人产生；`action=reset` 清除本地状态记录。 |
+| `h3_image` | 文生图：每次调用一个引擎子进程、内部 deadline、同一时刻只跑一路（第二路立即收到 `busy`）、PNG 结构校验通过才上报，产物落在你的会话工作区。 |
+
+### 运行要求
+
+- Apple Silicon Mac（引擎仅支持 arm64；Intel/Windows/Linux 由 `h3_status` 明确拒绝，而不是崩溃）。
+- **建议 48GB 及以上统一内存**；32GB 机型先警告再确认，低于 32GB 拒绝。
+- 安装期约 60GB 可用磁盘（从零安装实测峰值；引擎删除源分片后稳态约 53GB——见下方资源账）。
+- DSH ≥ 0.2.2-rc.1，Node ≥ 22.19。
+
+### 资源账（实测，裸机验收 2026-11-12/13）
+
+以下每个数字都来自 275GB Apple Silicon 机器上的一次从零验收运行（无复用候选、全新 venv/引擎/权重）——不是估算。
+
+| 项目 | 实测 |
+| --- | --- |
+| 磁盘峰值（增量，全程） | 58.6 GB (54.6 GiB)：DiT pack 21.5 + 文本编码器 28.2 + 在途源分片 5.4 + venv 1.1 |
+| 磁盘稳态（安装完成后） | 53.2 GB（引擎转换后自删源分片） |
+| venv 创建 | ~18 s（找到合适的独立 CPython 即复用，否则如实报 miss） |
+| 引擎 clone + pip install | ~72 s |
+| 权重：单个 transformer 分片（下载 5.5 GB + Q8 转换 + 删除） | ~4–5 分钟 |
+| 权重：续传段（7 分片 + 28.2 GB 文本编码器） | 41 分钟 |
+| 冒烟出图 | 30 s 墙钟 / 10.8 s 引擎时间（1 MP，6 步） |
+| 生图内存峰值（引擎 metrics） | 27.5 GB / 张 @ 1 MP |
+| 运行期间宿主已用内存 | 274 GB——含常驻推理服务；插件自身占用即上行的 27.5 GB |
+
+中断的步骤可续传：被杀的下载从 `.part` 继续（Range 请求），已完成分片绝不重下——验收运行的续传审计实证（已完成分片零重下）。
+
+### 许可——下载权重前必读
+
+本插件的**代码**是 MIT，不打包、不托管、不再分发模型——模型与其许可条款与本插件无关，插件只是带许可门的下载器与运行器。安装向导从 Hugging Face 官方仓库按钉定 revision 下载权重，并在拉取任何字节之前**展示两份协议的要点与全文直链**（权重：MiniMax H3 Image 社区许可；量化文本编码器：MiniMax H3 社区许可，均来自各自上游仓库），**点名地域排除（EU/UK/KR/US）**；协议原件随下载落盘在你的模型目录里。由你本人确认接受；插件永不代你接受。上游引擎为 Apache-2.0。详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
+
+### 安装（DSH）
+
+在 DSH 里用 `plugin_manager` 安装，两种来源任选：
+
+```
+install_bundle → dsh-h3-image            # 从 npm 装最新发布版
+install_bundle → /path/to/dsh-h3-image   # 或本地仓库/解包目录
+```
+
+然后在 profile 中启用该 bundle，跑一次 `h3_status`——机器还缺什么它会逐项告诉你。
+
+### 开发
+
+```sh
+npm test                                   # 单测（纯检查逻辑）
+npm run release                            # 门禁 + pack + tarball 扫描
+```
+
+两道发布门禁在 CI 与 `prepack` 运行：`scripts/check-release-safety.mjs`（源码**与**产物 tarball 双扫：零机器指纹、零 AppleDouble、零密钥）与 `scripts/check-version-consistency.mjs`（package.json ↔ CHANGELOG ↔ locale ↔ 钉定 revision 四处一致）。
+
+---
+
+## English
+
+> **Unofficial**: a third-party community tool, not affiliated with or endorsed by MiniMax; "MiniMax-H3-Image" is referenced descriptively only. Weights are provided under the MiniMax Community License, whose authorized territory **excludes the EU, UK, South Korea and the US** — verify you may lawfully use the model in your jurisdiction. Full disclaimer: [docs/DISCLAIMER.md](docs/DISCLAIMER.md).
+
+A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) plugin bundle that runs the open-source **MiniMax H3-Image** text-to-image model **entirely on your own Apple Silicon Mac**, through the [MLX](https://github.com/ml-explore/mlx) engine. No API keys, no accounts, no per-image fees, no egress during generation.
+
+The current version ships the full local pipeline: the read-only environment check, the one-time setup wizard (venv → pinned engine clone → license gate → sha256-verified weight download with resume → smoke test, each long step a background job that survives restarts), and text-to-image.
+
+### What you get
 
 | Tool | Purpose |
 | --- | --- |
@@ -23,22 +85,16 @@ per-image fees, no egress during generation.
 | `h3_setup` | The one-time setup wizard as a resumable state machine: `check → venv → engine → license → weights → smoke`. Long steps (engine install, ~59 GB of downloads + conversion) run as detached background jobs — submit returns a `job_id` in seconds, `action=poll` reads progress from the engine's own on-disk state, and an interrupted download resumes from `.part` on re-run. A dead job is reported `interrupted`, never "done". `action=license` shows the community license; acceptance is recorded only by you. `action=reset` clears the local state record. |
 | `h3_image` | Text-to-image: one engine subprocess per call, internal deadline, one generation at a time (a second call gets an immediate `busy`), PNG verified before it is reported, output lands in your session workspace. |
 
-## Requirements
+### Requirements
 
-- Apple Silicon Mac (the engine is arm64-only; Intel/Windows/Linux are
-  declined by `h3_status`, not by a crash).
-- **48 GB+ unified memory recommended**; 32 GB machines are warned-then-
-  confirmed, below 32 GB is refused.
-- ~60 GB free disk during setup (measured peak on a from-zero install; the
-  steady state after the engine deletes source shards is ~53 GB — see the
-  resource ledger below).
+- Apple Silicon Mac (the engine is arm64-only; Intel/Windows/Linux are declined by `h3_status`, not by a crash).
+- **48 GB+ unified memory recommended**; 32 GB machines are warned-then-confirmed, below 32 GB is refused.
+- ~60 GB free disk during setup (measured peak on a from-zero install; the steady state after the engine deletes source shards is ~53 GB — see the resource ledger below).
 - DSH ≥ 0.2.2-rc.1, Node ≥ 22.19.
 
-## Resource ledger (measured, bare-metal acceptance 2026-11-12/13)
+### Resource ledger (measured, bare-metal acceptance 2026-11-12/13)
 
-Every number below comes from one from-zero acceptance run on a 275 GB
-Apple Silicon machine (no reuse candidates, fresh venv/engine/weights) —
-not from estimates.
+Every number below comes from one from-zero acceptance run on a 275 GB Apple Silicon machine (no reuse candidates, fresh venv/engine/weights) — not from estimates.
 
 | Item | Measured |
 | --- | --- |
@@ -52,30 +108,24 @@ not from estimates.
 | Generation peak memory (engine metrics) | 27.5 GB per image at 1 MP |
 | Host memory in use during the run | 274 GB — includes a resident inference server; the plugin's own footprint is the 27.5 GB above |
 
-Interrupted steps resume: a killed download continues from its `.part`
-(Range requests), and finished shards are never re-fetched — verified by
-the acceptance run's resume audit (zero re-downloads of completed shards).
+Interrupted steps resume: a killed download continues from its `.part` (Range requests), and finished shards are never re-fetched — verified by the acceptance run's resume audit (zero re-downloads of completed shards).
+
+### Licenses — read before downloading weights
 
-## Licenses — read before downloading weights
+This plugin's **code** is MIT. It does not ship, re-host or re-distribute the model — the model and its license terms have nothing to do with this plugin, which is only a downloader and runner with a license gate. Before any byte is fetched, the setup wizard **shows the key points of both agreements with direct links to their full texts** (weights: MiniMax H3 Image Community License; quantized text encoder: MiniMax H3 Community License, each from its own upstream repo) and **names the territorial exclusions (EU/UK/KR/US)**; the original agreement files land on your disk inside the model directory. You accept them yourself; the plugin never accepts on your behalf. The upstream engine is Apache-2.0. See [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
 
-This plugin's **code** is MIT. It does not ship, re-host or re-distribute the
-model. The setup wizard downloads the weights from the official Hugging Face
-repository at a pinned revision, and **shows you the MiniMax H3 Image
-Community License Agreement — including its territorial exclusions — before
-any byte is fetched. You accept it yourself; the plugin never accepts on your
-behalf.** The upstream engine is Apache-2.0. See
-[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
+### Install (DSH)
 
-## Install (DSH)
+Install with `plugin_manager`, from either source:
 
 ```
-plugin_manager → install_bundle → <this repo or the npm package>
+install_bundle → dsh-h3-image            # latest release from npm
+install_bundle → /path/to/dsh-h3-image   # or a local checkout / unpacked dir
 ```
 
-Then enable the bundle in your profile and run `h3_status` — it tells you
-exactly what the machine still needs.
+Then enable the bundle in your profile and run `h3_status` — it tells you exactly what the machine still needs.
 
-## Development
+### Development
 
 ```sh
 npm test                                   # unit tests (pure check logic)

package/THIRD_PARTY_NOTICES.md

@@ -12,21 +12,35 @@ machine, after the user accepts the respective license where required.
 - Pinned commit: recorded in `lib/pinned.js` (`ENGINE.commit`). The wizard
   clones and checks out exactly this commit; `main` is never followed.
 
-## Model weights — `MiniMaxAI/MiniMax-H3-Image` (+ text encoder from `MiniMaxAI/MiniMax-H3`)
+## Model weights — `MiniMaxAI/MiniMax-H3-Image` (+ upstream meta from `MiniMaxAI/MiniMax-H3`)
 
 - Upstream: <https://huggingface.co/MiniMaxAI/MiniMax-H3-Image>
 - License: MiniMax H3 Image Community License Agreement (upstream `LICENSE`
-  file). **The license includes territorial exclusions** — read the upstream
-  LICENSE text yourself before downloading; the wizard shows it and requires
-  your explicit acceptance. The plugin never accepts on your behalf.
+  file). **The license includes territorial exclusions (EU, UK, South Korea,
+  US)** — read the upstream LICENSE text yourself before downloading; the
+  wizard shows its key points with a direct link and requires your explicit
+  acceptance. The plugin never accepts on your behalf.
 - Pinned revisions: recorded in `lib/pinned.js` (`WEIGHTS.revision`,
   `TEXT_ENCODER.revision`); every downloaded file is verified against a
   recorded sha256.
 
+## Quantized text encoder — `ddalcu/MiniMax-H3-FL2VA-MLX-Serve-8bit`
+
+- Upstream: <https://huggingface.co/ddalcu/MiniMax-H3-FL2VA-MLX-Serve-8bit>
+- A community-quantized Model Derivative, hosted by an independent third
+  party; this plugin neither operates that repository nor is affiliated with
+  it. It is the package the pinned engine actually loads for the text path.
+- License: **MiniMax H3 Community License Agreement** (a second agreement,
+  distinct from the H3-Image one, with the same territorial exclusions). Its
+  `LICENSE`, `NOTICE` and `MODIFICATIONS.md` are downloaded beside the
+  weights; the wizard lists both agreements before acceptance.
+- Pinned revision + sha256: recorded in `lib/pinned.js`
+  (`TEXT_ENCODER_PACKAGE`).
+
 ## Runtime — Python ≥ 3.13 + MLX
 
 - The wizard creates an isolated virtual environment on your machine and
-  installs the engine's declared dependencies (MLX is Apple-licensed, other
-  packages under their own licenses). The plugin ships none of them.
+  installs the engine's declared dependencies (MLX is MIT-licensed by Apple,
+  other packages under their own licenses). The plugin ships none of them.
 
 No trademark or brand assets of MiniMax are included in this package.

package/lib/pinned.js

@@ -52,6 +52,14 @@ export const TEXT_ENCODER = Object.freeze({
 export const TEXT_ENCODER_PACKAGE = Object.freeze({
   repo: "ddalcu/MiniMax-H3-FL2VA-MLX-Serve-8bit",
   revision: "64314cde0ac6d90f132bc94ae58e0c82f77396c6",
+  /**
+   * This quantized package is a Model Derivative of MiniMax-H3 (video) and
+   * carries its own agreement — the MiniMax H3 Community License, with the
+   * same territorial exclusions. It is a separate third-party repository;
+   * this plugin neither operates it nor accepts on anyone's behalf.
+   */
+  license: "MiniMax H3 Community License Agreement",
+  licenseSha256: "59b99642b95ea21630e311198ddbfffbfe05aadba0c2f5d884cbdf4efcc90f44",
   /** Only what the image path loads + the license trail. The engine's video
    *  path needs more from this repo; H3 Image does not. */
   files: [

package/lib/state.js

@@ -14,7 +14,7 @@
 import { rename, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 
-import { WEIGHTS } from "./pinned.js";
+import { TEXT_ENCODER_PACKAGE, WEIGHTS } from "./pinned.js";
 import { envelope } from "./checks.js";
 
 export const STATE_FILE_NAME = "h3-plugin-state.json";
@@ -43,14 +43,18 @@ export async function writeState(path, state, { writeFileP = writeFile, renameP
 /** Pure gate: returns null when generation may proceed, else the envelope. */
 export function licenseGate(state) {
   const rec = state?.license;
-  if (rec?.accepted === true && rec?.agreement === WEIGHTS.license) {
+  const both = Array.isArray(rec?.agreements)
+    && rec.agreements.includes(WEIGHTS.license)
+    && rec.agreements.includes(TEXT_ENCODER_PACKAGE.license);
+  if (rec?.accepted === true && rec?.agreement === WEIGHTS.license && both) {
     return null;
   }
   return envelope(
     "license",
-    `The model weights are distributed under the "${WEIGHTS.license}", which includes territorial ` +
-      `exclusions and usage terms. No acceptance record exists for this model directory.`,
-    `Read the agreement at the pinned Hugging Face model card, then record YOUR acceptance: ` +
+    `The model weights are distributed under the "${WEIGHTS.license}" and the quantized text ` +
+      `encoder under the "${TEXT_ENCODER_PACKAGE.license}", both with territorial exclusions and ` +
+      `usage terms. No acceptance record exists for both agreements on this model directory.`,
+    `Read both agreements at the pinned Hugging Face model cards, then record YOUR acceptance: ` +
       `h3_setup action=license accept=true. The plugin never accepts on your behalf.`,
   );
 }
@@ -58,17 +62,33 @@ export function licenseGate(state) {
 /** Summary shown by `h3_setup action=license` before acceptance (no I/O). */
 export function licenseSummary() {
   return [
-    `Agreement: ${WEIGHTS.license}`,
-    `Weights source: ${WEIGHTS.repo} @ ${WEIGHTS.revision.slice(0, 12)}`,
-    "Key points (read the full text at the model card before accepting):",
-    " - community license with TERRITORIAL EXCLUSIONS — check your region is permitted;",
-    " - usage, redistribution and commercial terms are defined by the agreement, not by this plugin;",
-    " - acceptance is recorded locally (timestamp + agreement name) and gates every download and generation;",
+    `Agreement 1: ${WEIGHTS.license}`,
+    `  Weights: ${WEIGHTS.repo} @ ${WEIGHTS.revision.slice(0, 12)}`,
+    `  Full text: https://huggingface.co/${WEIGHTS.repo}/raw/${WEIGHTS.revision}/LICENSE`,
+    `Agreement 2: ${TEXT_ENCODER_PACKAGE.license} (quantized text encoder, a separate third-party repo)`,
+    `  Package: ${TEXT_ENCODER_PACKAGE.repo} @ ${TEXT_ENCODER_PACKAGE.revision.slice(0, 12)}`,
+    `  Full text: https://huggingface.co/${TEXT_ENCODER_PACKAGE.repo}/raw/${TEXT_ENCODER_PACKAGE.revision}/LICENSE`,
+    "Key points shared by both agreements:",
+    " - TERRITORIAL EXCLUSIONS: authorized worldwide EXCEPT the EU, UK, South Korea and the US —",
+    "   use outside the authorized territory is not licensed; confirm your jurisdiction first;",
+    " - commercial use above US$1M annualized revenue, or offering a hosted service, needs separate",
+    "   written authorization from MiniMax; outputs may not train other models (see the AUP in the text);",
+    " - the original agreement files land on your disk with the downloads (LICENSE/NOTICE);",
+    " - usage, redistribution and commercial terms are defined by those agreements, not by this plugin;",
+    " - acceptance is recorded locally (timestamp + agreement names) and gates every download and generation;",
     " - this plugin never clicks accept for you: acceptance requires accept=true from you.",
   ].join("\n");
 }
 
 /** Pure transition: returns the new state with the acceptance record stamped. */
 export function acceptLicense(state, at = new Date().toISOString()) {
-  return { ...state, license: { accepted: true, agreement: WEIGHTS.license, at } };
+  return {
+    ...state,
+    license: {
+      accepted: true,
+      agreement: WEIGHTS.license,
+      agreements: [WEIGHTS.license, TEXT_ENCODER_PACKAGE.license],
+      at,
+    },
+  };
 }

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "H3 Image (local MLX)",
-    "description": "In Apple Silicon, fully local text-to-image with the open-source MiniMax H3-Image (MLX engine). A one-time setup wizard downloads the pinned engine and weights to your machine (the MiniMax community license and its region terms are shown before any download; you accept it yourself), then generation runs offline — no keys, no accounts, no egress. Long setup steps are background jobs that survive restarts and resume where they stopped. Requires Apple Silicon with 48 GB+ unified memory (32 GB is not guaranteed) and ~60 GB free disk during setup; Intel Macs and other platforms are declined up front. Current version (0.2.0): read-only environment check, one-click setup wizard, and local generation (the community license must be explicitly accepted by you before the first image)."
+    "description": "Unofficial third-party plugin, not affiliated with MiniMax. In Apple Silicon, fully local text-to-image with the open-source MiniMax H3-Image (MLX engine). A one-time setup wizard downloads the pinned engine and weights to your machine (the MiniMax community license and its region terms are shown before any download; you accept it yourself), then generation runs offline — no keys, no accounts, no egress. Long setup steps are background jobs that survive restarts and resume where they stopped. Requires Apple Silicon with 48 GB+ unified memory (32 GB is not guaranteed) and ~60 GB free disk during setup; Intel Macs and other platforms are declined up front. Current version (0.2.1): read-only environment check, one-click setup wizard, and local generation (the community license must be explicitly accepted by you before the first image)."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "H3 本地生图（MLX）",
-    "description": "在 Apple Silicon 上用开源 MiniMax H3-Image（MLX 引擎）做完全本地文生图。一键安装向导一次性把钉定版本的引擎与权重下载到本机（下载前展示 MiniMax 社区许可及地域条款，由你本人确认接受）；之后生图全程离线——零密钥、零账号、零出网。安装中的长步骤是后台任务，宿主重启不丢、断点续传。需 Apple Silicon、48GB 及以上统一内存（32GB 不保证）、安装期约 60GB 可用磁盘；Intel Mac 与其他平台在检查阶段即明确拒绝。当前版本（0.2.0）：只读环境体检 + 一键安装向导 + 本地产图（社区许可需你本人显式确认接受后才会出图）。"
+    "description": "非官方第三方插件，与 MiniMax 无关联。在 Apple Silicon 上用开源 MiniMax H3-Image（MLX 引擎）做完全本地文生图。一键安装向导一次性把钉定版本的引擎与权重下载到本机（下载前展示 MiniMax 社区许可及地域条款，由你本人确认接受）；之后生图全程离线——零密钥、零账号、零出网。安装中的长步骤是后台任务，宿主重启不丢、断点续传。需 Apple Silicon、48GB 及以上统一内存（32GB 不保证）、安装期约 60GB 可用磁盘；Intel Mac 与其他平台在检查阶段即明确拒绝。当前版本（0.2.1）：只读环境体检 + 一键安装向导 + 本地产图（社区许可需你本人显式确认接受后才会出图）。"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-h3-image",
-  "version": "0.2.0",
-  "description": "Fully local text-to-image on Apple Silicon using the open-source MiniMax H3-Image model on MLX. A setup wizard builds the pinned engine and weights on your machine once; generation then runs offline with no keys and no cloud calls.",
+  "version": "0.2.1",
+  "description": "在 Apple Silicon 上用开源 MiniMax H3-Image（MLX 引擎）做完全本地文生图的 DeepSeek Harness 插件：一键安装向导 + 零出网本地生图。Fully local MiniMax H3-Image text-to-image on Apple Silicon MLX — a DeepSeek Harness plugin with a one-time setup wizard and zero-egress generation.",
   "type": "module",
   "main": "./lib/index.js",
   "scripts": {
@@ -20,7 +20,6 @@
     "./LICENSE": "./LICENSE"
   },
   "files": [
-    "README.zh.md",
     "lib",
     "assets",
     "cordis.patch.yml",

package/README.zh.md

@@ -1,80 +0,0 @@
-# dsh-h3-image
-
-[English](README.md) | **简体中文**
-
-> **名称已占位。** 当前版本（0.2.0）交付完整本地链路：只读环境体检、一键安装
-> 向导（venv → 钉定引擎 clone → 许可确认 → sha256 校验的权重下载（支持断点
-> 续传）→ 冒烟出图，每个长步骤都是重启不丢的后台任务），以及本地文生图。
-> 全程不调用任何云服务。
-
-一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（DSH）
-插件包，通过 [MLX](https://github.com/ml-explore/mlx) 引擎在你的 **Apple
-Silicon Mac 上完全本地**运行开源的 **MiniMax H3-Image** 文生图模型。
-零 API 密钥、零账号、零按图计费，生图过程零出网。
-
-## 提供什么
-
-| 工具 | 用途 |
-| --- | --- |
-| `h3_status` | 只读体检：平台、统一内存、venv、引擎 commit、权重、文本编码器、可用磁盘——每一项红灯都附修复提示。 |
-| `h3_setup` | 一次性安装向导，可续跑的状态机：`check → venv → engine → license → weights → smoke`。长步骤（引擎安装、约 59 GB 下载 + 转换）以脱离进程组的后台任务运行——提交秒级返回 `job_id`，`action=poll` 从引擎自己的磁盘状态读进度，中断的下载重跑即从 `.part` 续传。进程已死的任务如实报 `interrupted`，绝不谎报"完成"。`action=license` 展示社区许可，只有你本人确认才会记录接受。`action=reset` 清除本机状态记录。 |
-| `h3_image` | 文生图：每次调用一个引擎子进程，内置截止时间，同一时刻只跑一张（第二路立即收到 `busy`），PNG 结构校验通过才报成功，产物落在会话工作区。 |
-
-## 环境要求
-
-- Apple Silicon Mac（引擎仅支持 arm64；Intel/Windows/Linux 在 `h3_status`
-  检查阶段即明确拒绝，而不是崩溃）。
-- **推荐 48 GB 及以上统一内存**；32 GB 机器先警告再确认，低于 32 GB 拒绝。
-- 安装期约 60 GB 可用磁盘（from-zero 安装的实测峰值；引擎删除源分片后的
-  稳态约 53 GB——见下方资源账表）。
-- DSH ≥ 0.2.2-rc.1，Node ≥ 22.19。
-
-## 资源账（实测，裸机验收 2026-11-12/13）
-
-下表每个数字都来自 275 GB Apple Silicon 机器上的一次 from-zero 验收运行
-（无复用候选、全新 venv/引擎/权重）——不是估算。
-
-| 项目 | 实测 |
-| --- | --- |
-| 磁盘峰值（增量，整个安装过程） | 58.6 GB（54.6 GiB）：DiT 打包 21.5 + 文本编码器 28.2 + 在途源分片 5.4 + venv 1.1 |
-| 磁盘稳态（安装完成后） | 53.2 GB（源分片由引擎转换后自行删除） |
-| venv 创建 | 约 18 秒（能发现合适的独立 CPython 就复用，探测不到如实报 miss） |
-| 引擎 clone + pip 安装 | 约 72 秒 |
-| 权重：每个 transformer 分片（下载 5.5 GB + Q8 转换 + 删除） | 约 4–5 分钟 |
-| 权重：续传段（7 分片 + 28.2 GB 文本编码器） | 41 分钟 |
-| 冒烟出图 | 墙钟 30 秒 / 引擎耗时 10.8 秒（1 MP，6 步） |
-| 单图内存峰值（引擎 metrics） | 1 MP 每图 27.5 GB |
-| 运行期间主机已用内存 | 274 GB——含常驻推理服务；插件自身占用即上行 27.5 GB |
-
-中断可续：被杀的下载从 `.part` 继续（Range 请求），已完成分片绝不重下——
-验收运行的续传对账为证（零重下已完成分片）。
-
-## 许可——下载权重前必读
-
-本插件的**代码**是 MIT。**不打包、不转载、不分发模型。** 安装向导从官方
-Hugging Face 仓库按钉定 revision 下载权重，并且**在任何一个字节下载之前，
-向你展示 MiniMax H3 Image 社区许可协议（含其地域排除条款）。由你本人接受；
-插件永不代你接受。** 上游引擎为 Apache-2.0。见
-[THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
-
-## 安装（DSH）
-
-```
-plugin_manager → install_bundle → <本仓库或 npm 包>
-```
-
-然后在 profile 中启用该 bundle，跑一次 `h3_status`——机器还缺什么它逐项
-告诉你。
-
-## 开发
-
-```sh
-npm test                                   # 单元测试（纯检查逻辑）
-npm run release                            # 门禁 + 打包 + tarball 扫描
-```
-
-两道发布门禁在 CI 和 `prepack` 上运行：
-`scripts/check-release-safety.mjs`（零机器指纹、零 AppleDouble、零密钥——
-源码**和**构建出的 tarball 都扫）与
-`scripts/check-version-consistency.mjs`（package.json ↔ CHANGELOG ↔ locale ↔
-钉定 revision 一致性）。