@tmmk/media-suite 0.1.2 → 0.1.4

package/README.md

@@ -1,56 +1,82 @@
-# media-suite · 媒体工具
+# media-suite · 媒体工具套装
 
-媒体插件家族的一键安装入口。
+一次安装，得到 Qwen 与 RunningHub 的全部媒体能力。
 
-## 它做什么
+## 装一次就有什么
 
 ```text
 media-suite
-  ├─ 挂载自己的一行
-  ├─ 依赖 media-qwen
-  └─ 依赖 media-runninghub
+  ├─ media-qwen        多模态理解 / 语音合成 / 场景音频生成
+  └─ media-runninghub  图片生成 / 工作流任务池（11 种任务类型）
 ```
 
-装一个 `media-suite`，得到：
+装完你会得到：
 
-- `media-qwen` 的 `qwen_omni` / `qwen_tts` / `qwen_audio`
-- `media-runninghub` 的 `runninghub_image`
-- 两个 provider 各自的设置页
+**Qwen 媒体**（设置 → Qwen 媒体）
+- `qwen_omni` —— 视频 / 音频 / 图片理解，返回文本
+- `qwen_tts` —— 文字转语音，支持预置音色与情绪指令
+- `qwen_audio` —— 按描述生成完整音频场景，支持参考音色
 
-## 它不做什么
+**RunningHub 媒体**（设置 → RunningHub 媒体）
+- `runninghub_image` —— Nano Banana 2 同步出图（文生图 / 改图 / 多图融合）
+- `runninghub_workflow_submit` / `_types` / `_status` —— 工作流任务池，支持文生图、改图、文生视频、数字人、语音克隆、文生音乐、人声分离
+- 配套技能 `runninghub-workflow`，告诉模型该怎么用任务池
+
+两个 provider 各有自己的设置页，各自管理自己的 Key。
+
+## 它本身不做什么
 
 - 不调用任何 provider API
 - 不保存任何 API Key
 - 不注册任何模型工具
-- **没有自己的配置页**：输出位置不是 profile 设置
+- 没有自己的设置页
+
+它只做一件事：**把两个 provider 挂起来**。所以它的包很小，也几乎不会有 bug。
 
 ## 输出位置
 
-默认固定为：
+所有产物默认落在**当前会话目录**下：
 
 ```text
-<当前工作目录>/output/media/qwen/...​
-<当前工作目录>/output/media/runninghub/...​
+<会话目录>/output/media/qwen/...
+<会话目录>/output/media/runninghub/...
+```
+
+需要写到别处时，在**每次调用**里指定：
+
+- RunningHub 任务池：传 `outputDir` / `outputName`
+- Qwen 音频：传 `output`
+- RunningHub 同步出图：传 `output`
+
+相对路径按当前工作目录解析，目录自动创建。这样同一个会话里不同任务可以各自落到各自的目录，不需要改插件配置。
+
+## 安装
+
+```bash
+dsh plugin --profile <profile> add @tmmk/media-suite
 ```
 
-需要写到别处时，**在每次调用里传 `output`**：
+装完重启 DSH，两个设置页都会出现。
+
+**也可以只装其中一个**：
 
-```json
-{ "prompt": "...",​ "output": "D:/projects/ep01/stills" }
+```bash
+dsh plugin --profile <profile> add @tmmk/media-qwen
+dsh plugin --profile <profile> add @tmmk/media-runninghub
 ```
 
-相对路径按当前工作目录解析，目录会自动创建。这样同一个会话里不同任务可以各自落到各自的目录，不需要改插件配置。
+## 关于「已安装」列表
 
-## 挂载方式
+插件管理器里会**只显示 `@tmmk/media-suite` 一个条目**，它的行里包含三个插件（suite + qwen + runninghub）。这是套装模式的正常表现——provider 不作为独立 bundle 出现在列表里，但工具和设置页都已正常工作。
 
-`cordis.patch.yml` **只插入 `media-suite` 自己这一行**。
+## 挂载方式（给排查问题的人）
 
-provider 是独立的 bundle，各自带 `dsh.bundle.patch`。它们在 suite 的 `dependencies` 里声明，由插件管理器一起装进 profile，再由各自的 patch 插入各自的 row。
+`cordis.patch.yml` **插入三行**：`media-suite` + `media-qwen` + `media-runninghub`。
 
-> 不要在 suite 的 patch 里再插入 `media-qwen` / `media-runninghub`：那会和它们自己的 patch 撞同一个 id，导致两个插件都激活失败。
+为什么必须这样：`dsh plugin add` 只把**显式安装的包**（这里是 media-suite）写进 `dsh.profile.bundles`，两个 provider 作为传递依赖只进 `dependencies`。而 DSH 只应用 `bundles` 里包的 patch——所以 provider 自己的 patch 不会跑，必须由套装自己插入它们的行。
 
-## 安装
+> 不要在 profile 里**另外单独**再装 provider：那会让它的 patch 和套装的 patch 插同一个 id，产生冲突。只装套装即可。
 
-```powershell
-plugin_manager install_bundle .\packages\media-suite
-```
+## 开源许可
+
+Apache-2.0，详见根目录 [LICENSE](../../LICENSE)。

package/cordis.patch.yml

@@ -1,10 +1,20 @@
-# media-suite mounts only its own row. The provider packages are separate
-# bundles with their own patches: the plugin manager installs them alongside this
-# suite, and their bundle patches insert their rows. Re-inserting the same ids
-# here would collide with those patches, so this file deliberately does not.
+# media-suite is the distribution shell: installing it must mount the provider
+# rows too, because its providers arrive as plain npm dependencies and
+# dependencies are NOT added to dsh.profile.bundles by `dsh plugin add`. Only
+# bundle patches of packages listed in dsh.profile.bundles are applied, so the
+# providers' own patches would never run. The suite therefore inserts all three
+# rows itself.
 #
 # The suite has no config: where files land is a per-call choice, not a profile
 # setting.
 - insert:
     - id: media-suite
       name: '@tmmk/media-suite'
+    - id: media-qwen
+      name: '@tmmk/media-qwen'
+    - id: media-runninghub
+      name: '@tmmk/media-runninghub'
+      config:
+        surface: jobs
+        concurrency: 2
+        pollIntervalSeconds: 30

package/package.json

@@ -1,14 +1,25 @@
 {
   "name": "@tmmk/media-suite",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "type": "module",
   "main": "index.js",
-  "engines": {
-    "node": "^22.19.0 || >=24.0.0"
-  },
+  "engines": { "node": "^22.19.0 || >=24.0.0", "dsh": ">=0.2.1-rc.3" },
   "packageManager": "pnpm@11.7.0",
   "description": "媒体插件家族：一次安装 Qwen 与 RunningHub 媒体能力，并提供跨 provider 的全局设置。",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/do-nothing/media-suite.git",
+    "directory": "packages/media-suite"
+  },
+  "homepage": "https://github.com/do-nothing/media-suite/tree/main/packages/media-suite",
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "media",
+    "bundle"
+  ],
   "license": "Apache-2.0",
+  "publishConfig": { "registry": "https://registry.npmjs.org/", "access": "public" },
   "exports": {
     ".": "./index.js",
     "./client": "./client.js",
@@ -25,8 +36,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@tmmk/media-qwen": "^0.1.1",
-    "@tmmk/media-runninghub": "^0.1.1"
+    "@tmmk/media-qwen": "^0.1.2",
+    "@tmmk/media-runninghub": "^0.1.3"
   },
   "dsh": {
     "bundle": {