@tmmk/media-suite 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,56 @@
-# Temporary Holding Version
+# media-suite · 媒体工具
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+媒体插件家族的一键安装入口。
+
+## 它做什么
+
+```text
+media-suite
+  ├─ 挂载自己的一行
+  ├─ 依赖 media-qwen
+  └─ 依赖 media-runninghub
+```
+
+装一个 `media-suite`，得到：
+
+- `media-qwen` 的 `qwen_omni` / `qwen_tts` / `qwen_audio`
+- `media-runninghub` 的 `runninghub_image`
+- 两个 provider 各自的设置页
+
+## 它不做什么
+
+- 不调用任何 provider API
+- 不保存任何 API Key
+- 不注册任何模型工具
+- **没有自己的配置页**：输出位置不是 profile 设置
+
+## 输出位置
+
+默认固定为：
+
+```text
+<当前工作目录>/output/media/qwen/...​
+<当前工作目录>/output/media/runninghub/...​
+```
+
+需要写到别处时，**在每次调用里传 `output`**：
+
+```json
+{ "prompt": "...",​ "output": "D:/projects/ep01/stills" }
+```
+
+相对路径按当前工作目录解析，目录会自动创建。这样同一个会话里不同任务可以各自落到各自的目录，不需要改插件配置。
+
+## 挂载方式
+
+`cordis.patch.yml` **只插入 `media-suite` 自己这一行**。
+
+provider 是独立的 bundle，各自带 `dsh.bundle.patch`。它们在 suite 的 `dependencies` 里声明，由插件管理器一起装进 profile，再由各自的 patch 插入各自的 row。
+
+> 不要在 suite 的 patch 里再插入 `media-qwen` / `media-runninghub`：那会和它们自己的 patch 撞同一个 id，导致两个插件都激活失败。
+
+## 安装
+
+```powershell
+plugin_manager install_bundle .\packages\media-suite
+```

package/client.js

@@ -0,0 +1,25 @@
+/**
+ * Client half of the media-suite bundle.
+ *
+ * The suite has no settings of its own: provider keys live on each provider's
+ * page, and the output location is a per-call argument rather than a profile
+ * setting. This module deliberately registers nothing, and exists only because a
+ * bundle's client entry is declared in `package.json`.
+ */
+window.__ModuleLoader__.load({
+  id: 'media-suite',
+  factory(require) {
+    const module = { exports: {} }
+    const exports = module.exports
+
+    /**
+     * No slots, no locale, no Remote contribution. The suite is a composition
+     * layer: installing it mounts the provider bundles, and each of those owns
+     * its own settings page.
+     */
+    exports.inject = []
+    exports.apply = function apply() {}
+
+    return module.exports
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,10 @@
+# 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.
+#
+# 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'

package/icon.svg

@@ -0,0 +1,21 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 120 120" width="120" height="120">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#7c3aed"/>
+      <stop offset="1" stop-color="#2563eb"/>
+    </linearGradient>
+  </defs>
+  <rect x="4" y="4" width="112" height="112" rx="24" fill="url(#bg)"/>
+  <!-- film-strip sprocket holes, left -->
+  <g fill="#ffffff" opacity="0.85">
+    <rect x="16" y="22" width="5" height="6" rx="1"/>
+    <rect x="16" y="48" width="5" height="6" rx="1"/>
+    <rect x="16" y="74" width="5" height="6" rx="1"/>
+    <!-- film-strip sprocket holes, right -->
+    <rect x="99" y="22" width="5" height="6" rx="1"/>
+    <rect x="99" y="48" width="5" height="6" rx="1"/>
+    <rect x="99" y="74" width="5" height="6" rx="1"/>
+  </g>
+  <rect x="26" y="26" width="68" height="68" rx="12" fill="#ffffff"/>
+  <polygon points="54,50 54,70 68,62" fill="#2563eb"/>
+</svg>

package/index.js

@@ -0,0 +1,29 @@
+/**
+ * Host half of the media-suite bundle.
+ *
+ * The suite is a distribution shell: its bundle patch mounts the provider
+ * packages, so installing the suite once gives the whole family.
+ *
+ * It deliberately has no Config, no Settings page, and no shared output setting.
+ * Generated files always land under the Session directory's `output` folder, and
+ * a tool call that needs a different destination passes an `output` argument for
+ * that one call. Nothing about where a file goes belongs in profile
+ * configuration.
+ *
+ * It performs no provider API calls, holds no API keys, and registers no model
+ * tools.
+ */
+
+export const name = 'media-suite'
+export const inject = []
+
+/**
+ * Mount the suite.
+ *
+ * The provider packages are separate bundles with their own patches; their rows
+ * come from those patches, not from this one. Re-inserting the same ids here
+ * would collide with them and stop both providers from activating.
+ */
+export function apply() {
+  // Nothing to register: composition is the suite's whole contribution.
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Media Tools",
+    "description": "The media plugin family: install Qwen and RunningHub media capabilities together, with one cross-provider output root setting."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "媒体工具",
+    "description": "媒体插件家族：一次安装 Qwen 与 RunningHub 媒体能力，并提供跨 provider 的全局输出目录设置。"
+  }
+}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@tmmk/media-suite",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "type": "module",
+  "main": "index.js",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "packageManager": "pnpm@11.7.0",
+  "description": "媒体插件家族：一次安装 Qwen 与 RunningHub 媒体能力，并提供跨 provider 的全局设置。",
+  "license": "Apache-2.0",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "README.md"
+  ],
+  "dependencies": {
+    "@tmmk/media-qwen": "^0.1.0",
+    "@tmmk/media-runninghub": "^0.1.0"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    }
+  }
+}