dsh-h3-image 0.2.5 → 0.2.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +28 -36
- package/locale/en.json +1 -1
- package/locale/zh.json +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
|
|
15
15
|
| 工具 | 干什么用 |
|
|
16
16
|
| --- | --- |
|
|
17
|
-
| `h3_status` | 只读体检：平台、内存、venv
|
|
17
|
+
| `h3_status` | 只读体检：平台、内存、venv、引擎版本、权重、文本编码器、磁盘逐项检查，缺什么标红并告诉你怎么修。 |
|
|
18
18
|
| `h3_setup` | 安装向导：`check → venv → engine → license → weights → smoke` 一步步走，中断了重跑接着来。耗时长的步骤（装引擎、下 59 GB 权重）放后台跑，提交后马上返回 `job_id`，用 `action=poll` 看进度；下到一半断了，重跑从 `.part` 接着下，下完的分片不会重下；任务被杀会如实报 `interrupted`，不谎报"完成"。`action=license` 展示许可协议，只能由你自己确认接受；`action=reset` 清掉本地状态记录。 |
|
|
19
19
|
| `h3_image` | 文生图。同一时间只跑一张，第二张会立刻收到 `busy`；出图前先校验 PNG 结构，确认是完整图才报成功，图片存到你的会话工作区。 |
|
|
20
20
|
|
|
@@ -25,23 +25,19 @@
|
|
|
25
25
|
- 安装期留约 60GB 磁盘（从零安装实测峰值；装完引擎会自删源分片，之后大约占 53GB——见下面资源占用）。
|
|
26
26
|
- DSH ≥ 0.2.2-rc.1，Node ≥ 22.19。
|
|
27
27
|
|
|
28
|
-
###
|
|
28
|
+
### 资源占用（实测）
|
|
29
29
|
|
|
30
|
-
|
|
30
|
+
数据由 M5 Ultra 256G 设备从零开始安装实测，所需时间因机器及网络情况而不同，仅做参考。
|
|
31
31
|
|
|
32
32
|
| 项目 | 实测 |
|
|
33
33
|
| --- | --- |
|
|
34
|
-
|
|
|
35
|
-
|
|
|
36
|
-
|
|
|
37
|
-
|
|
|
38
|
-
|
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
| 生图内存峰值（引擎 metrics） | 27.5 GB / 张 @ 1 MP |
|
|
42
|
-
| 运行期间电脑已用内存 | 274 GB——含常驻推理服务；插件自己占的就是上面那 27.5 GB |
|
|
43
|
-
|
|
44
|
-
中断的步骤可以接着来：被杀的下载从 `.part` 继续（Range 请求），下完的分片绝不重下——上面那次从零安装的续传过程全程有日志可查。
|
|
34
|
+
| 安装期间磁盘 | 峰值约 60 GB |
|
|
35
|
+
| 装完后磁盘 | 约 53 GB（源分片转换完会自动删掉） |
|
|
36
|
+
| 单张图内存（1 MP） | 约 27.5 GB |
|
|
37
|
+
| 每个权重分片（下载 + 转换） | 约 4–5 分钟，看你的网速 |
|
|
38
|
+
| 第一次出图 | 约 30 秒 |
|
|
39
|
+
|
|
40
|
+
中断的步骤可以接着来：下到一半断了从 `.part` 继续，下完的分片不会重下。内存那行是引擎自己报的单张图占用。
|
|
45
41
|
|
|
46
42
|
### 许可——下载权重前必读
|
|
47
43
|
|
|
@@ -65,7 +61,7 @@ npm test # 单测（纯检查逻辑）
|
|
|
65
61
|
npm run release # 门禁 + pack + tarball 扫描
|
|
66
62
|
```
|
|
67
63
|
|
|
68
|
-
|
|
64
|
+
两个发布检查在 CI 和 `prepack` 里自动跑，你不用记着手动跑：`check-release-safety` 保证源码和发出去的包里不含本机路径、用户名、macOS 垃圾文件和密钥；`check-version-consistency` 保证 package.json、CHANGELOG、两个 locale 里的版本号一致，`lib/pinned.js` 里钉的版本号格式合法。
|
|
69
65
|
|
|
70
66
|
---
|
|
71
67
|
|
|
@@ -73,9 +69,9 @@ npm run release # 门禁 + pack + tarball 扫描
|
|
|
73
69
|
|
|
74
70
|
> **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).
|
|
75
71
|
|
|
76
|
-
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
|
|
72
|
+
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 network access during generation.
|
|
77
73
|
|
|
78
|
-
|
|
74
|
+
Usage is three steps: run `h3_status` to see whether your machine qualifies, let the `h3_setup` wizard install the engine and the weights (you confirm the MiniMax license yourself before anything downloads), then generate images with `h3_image`.
|
|
79
75
|
|
|
80
76
|
### Tools
|
|
81
77
|
|
|
@@ -92,27 +88,23 @@ The current version ships the full local pipeline: the read-only environment che
|
|
|
92
88
|
- ~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 usage below).
|
|
93
89
|
- DSH ≥ 0.2.2-rc.1, Node ≥ 22.19.
|
|
94
90
|
|
|
95
|
-
### Resource usage (measured
|
|
91
|
+
### Resource usage (measured)
|
|
96
92
|
|
|
97
|
-
|
|
93
|
+
Measured on an M5 Ultra with 256 GB of unified memory, from a from-scratch install. Times vary with your machine and your network, so treat them as a reference.
|
|
98
94
|
|
|
99
95
|
| Item | Measured |
|
|
100
96
|
| --- | --- |
|
|
101
|
-
| Disk
|
|
102
|
-
| Disk
|
|
103
|
-
|
|
|
104
|
-
|
|
|
105
|
-
|
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
| Generation peak memory (engine metrics) | 27.5 GB per image at 1 MP |
|
|
109
|
-
| 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 |
|
|
110
|
-
|
|
111
|
-
Interrupted steps resume: a killed download continues from its `.part` (Range requests), and finished shards are never re-fetched — verified during the install above: completed shards were never re-downloaded.
|
|
97
|
+
| Disk during setup | ~60 GB at peak |
|
|
98
|
+
| Disk after setup | ~53 GB (source shards are deleted once converted) |
|
|
99
|
+
| Memory per image (1 MP) | ~27.5 GB |
|
|
100
|
+
| Per weight shard (download + convert) | ~4–5 min, depends on your connection |
|
|
101
|
+
| First image | ~30 s |
|
|
102
|
+
|
|
103
|
+
Interrupted steps resume: a killed download continues from its `.part`, and finished shards are never re-downloaded. The memory figure is the per-image footprint the engine reports itself.
|
|
112
104
|
|
|
113
105
|
### Licenses — read before downloading weights
|
|
114
106
|
|
|
115
|
-
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.
|
|
107
|
+
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. The setup wizard downloads the weights from the official Hugging Face repositories at pinned versions, and before any byte is fetched it **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).
|
|
116
108
|
|
|
117
109
|
### Install (DSH)
|
|
118
110
|
|
|
@@ -132,8 +124,8 @@ npm test # unit tests (pure check logic)
|
|
|
132
124
|
npm run release # gates + pack + tarball scan
|
|
133
125
|
```
|
|
134
126
|
|
|
135
|
-
|
|
136
|
-
`
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
pinned revisions
|
|
127
|
+
The two release checks also run in CI and on `prepack`, so you don't have to remember
|
|
128
|
+
them: `check-release-safety` makes sure the source and the published package are free of
|
|
129
|
+
local paths, usernames, macOS junk files and secrets; `check-version-consistency` checks
|
|
130
|
+
that the version in package.json, CHANGELOG and both locale files agree, and that the
|
|
131
|
+
pinned revisions in `lib/pinned.js` are well-formed.
|
package/locale/en.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"meta": {
|
|
3
3
|
"title": "H3 Image (local MLX)",
|
|
4
|
-
"description": "Unofficial third-party plugin, not affiliated with MiniMax. On Apple Silicon, fully local text-to-image with the open-source MiniMax H3-Image (MLX engine). A one-time setup wizard downloads a fixed version of the 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 network access. 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.
|
|
4
|
+
"description": "Unofficial third-party plugin, not affiliated with MiniMax. On Apple Silicon, fully local text-to-image with the open-source MiniMax H3-Image (MLX engine). A one-time setup wizard downloads a fixed version of the 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 network access. 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.7): read-only environment check, setup wizard, and local generation (the community license must be explicitly accepted by you before the first image)."
|
|
5
5
|
}
|
|
6
6
|
}
|
package/locale/zh.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"meta": {
|
|
3
3
|
"title": "H3 本地生图（MLX）",
|
|
4
|
-
"description": "非官方第三方插件，与 MiniMax 无关联。在 Apple Silicon 上用开源 MiniMax H3-Image（MLX 引擎）做完全本地文生图。安装向导一次性把固定版本的引擎与权重下载到本机（下载前展示 MiniMax 社区许可及地域条款，由你本人确认接受）；之后生图全程离线——不用密钥、不用账号、不联网。安装中的长步骤是后台任务，DSH 重启不丢、断点续传。需 Apple Silicon、48GB 及以上统一内存（32GB 不保证）、安装期约 60GB 可用磁盘；Intel Mac 与其他平台在检查阶段即明确拒绝。当前版本（0.2.
|
|
4
|
+
"description": "非官方第三方插件，与 MiniMax 无关联。在 Apple Silicon 上用开源 MiniMax H3-Image（MLX 引擎）做完全本地文生图。安装向导一次性把固定版本的引擎与权重下载到本机（下载前展示 MiniMax 社区许可及地域条款，由你本人确认接受）；之后生图全程离线——不用密钥、不用账号、不联网。安装中的长步骤是后台任务，DSH 重启不丢、断点续传。需 Apple Silicon、48GB 及以上统一内存（32GB 不保证）、安装期约 60GB 可用磁盘；Intel Mac 与其他平台在检查阶段即明确拒绝。当前版本（0.2.7）：只读环境体检 + 安装向导 + 本地产图（社区许可需你本人确认接受后才会出图）。"
|
|
5
5
|
}
|
|
6
6
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-h3-image",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.7",
|
|
4
4
|
"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.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./lib/index.js",
|