dsh-film 0.3.1 → 0.3.2

package/README.md

@@ -37,14 +37,14 @@ A film workbench for DeepSeek Harness and VibeDev: three right-sidebar tabs —
 **从 GitHub Release 安装**：插件页的“包名或地址”和上面的命令也接受 Release 里的 `.tgz` 直链，例如
 
 ```
-https://github.com/CrisLIUning/dsh-film/releases/download/v0.3.1/dsh-film-0.3.1.tgz
+https://github.com/VibeDev-Si/dsh-film/releases/download/v0.3.2/dsh-film-0.3.2.tgz
 ```
 
 直链不经过安装源，需要本机能直接访问 GitHub（或配好代理）。包约 3 MB。网速很慢时仍可能超过 pnpm 默认的 60 秒下载时限而失败：这时改为按包名从中国大陆镜像源安装；也可以把时限调长：pnpm 11（DeepSeek Harness 和 VibeDev 桌面版自带的就是它）不再从 `~/.npmrc` 读取这个设置，要在 pnpm 的全局配置 `config.yaml` 里加一行 `fetchTimeout: 600000`（Windows：`%LOCALAPPDATA%\pnpm\config\config.yaml`；macOS：`~/Library/Preferences/pnpm/config.yaml`；Linux：`~/.config/pnpm/config.yaml`），或设环境变量 `pnpm_config_fetch_timeout=600000`；pnpm 10 及更早的版本则在 `~/.npmrc` 里加 `fetch-timeout=600000`。
 
 **刚发布的版本**：pnpm 11 默认只安装发布满一天的版本（`minimumReleaseAge`）。第一个版本不受影响：按包名安装一个此前没有任何版本的包时，pnpm 照样装上它，并把它记进 `minimumReleaseAgeExclude`。之后每次发布新版本，头一天按包名安装得到的是上一个版本；要马上装新版本，按确切版本安装（包名写成 `dsh-film@<版本>`），或者用上面的 Release 直链。
 
-**不能从 Git 仓库安装**：不要在插件页填仓库地址 `https://github.com/CrisLIUning/dsh-film`，也不要对它运行 `dsh plugin add`。`lib/`、`client/` 和 `apps/`（分镜画布和导演台的前端）都是构建产物，不在 git 里，从仓库安装会失败（不会留下装了却用不了的插件）。
+**不能从 Git 仓库安装**：不要在插件页填仓库地址 `https://github.com/VibeDev-Si/dsh-film`，也不要对它运行 `dsh plugin add`。`lib/`、`client/` 和 `apps/`（分镜画布和导演台的前端）都是构建产物，不在 git 里，从仓库安装会失败（不会留下装了却用不了的插件）。
 
 **「VibeDev 账号与模型」插件是可选的**：只有在分镜画布里生成图片和视频才需要另装 [@vibedev-si/dsh-vibedev](https://github.com/VibeDev-Si/dsh-vibedev)（原 dsh-media，包名 `@vibedev-si/dsh-vibedev`，装法相同；在侧边栏底部或「设置 → VibeDev 账号」登录 VibeDev，走 VibeDev 网关，按用量从 VibeDev 余额扣费）。不装也能写剧本、排分镜和调度导演台；从 VibeDev 插件中心安装影视工作台时会把它一并装上。分镜画布给每个视频模型列出的模式与该插件实际接受的一致：声明不收首帧的线路（Seedance 2.5（VibeDev）、2.5 30s（VibeDev）、2.5 480p 30s（山海）和三条 lec 线路；Seedance 2.5 特价按次收首帧，仍有图生视频）不显示“图生视频”，接一张图时改走“全能参考”，图作为参考图发送；以前保存成“图生视频”的节点在这些线路上也按全能参考生成。
 
@@ -56,13 +56,19 @@ Requires DeepSeek Harness 0.2.x or VibeDev (VibeDev Next), which is built on it.
 
 - **Plugin page** (recommended): Plugins → Add plugin → install a third-party plugin by package name, enter `dsh-film`, pick the npm registry or the China mirror under the install source, and install.
 - **Command line**: for the DeepSeek Harness desktop app, quit it fully, then run `dsh plugin --profile desktop add dsh-film` (the `dsh` command is installed from the app menu). VibeDev Next's command is `vibedev-app` (app menu → Manage vibedev-app Command…): quit the app fully, then run `vibedev-app plugin --profile desktop add dsh-film`; it keeps its data in `~/.vibedev-app`, which `dsh` does not reach. With the npm `dsh` CLI, run `dsh plugin add dsh-film`.
-- **GitHub Release**: the plugin page and the commands also take the release asset URL, e.g. `https://github.com/CrisLIUning/dsh-film/releases/download/v0.3.1/dsh-film-0.3.1.tgz`. It is fetched straight from GitHub, not through a registry. The file is about 3 MB; if a very slow connection still hits pnpm's default 60-second fetch timeout, install by name from the mirror instead, or raise the timeout — pnpm 11 (the one the desktop apps ship) no longer reads it from `~/.npmrc`, so add `fetchTimeout: 600000` to pnpm's global `config.yaml` (Windows `%LOCALAPPDATA%\pnpm\config\config.yaml`, macOS `~/Library/Preferences/pnpm/config.yaml`, Linux `~/.config/pnpm/config.yaml`) or set `pnpm_config_fetch_timeout=600000`; pnpm 10 and earlier take `fetch-timeout=600000` in `~/.npmrc`.
+- **GitHub Release**: the plugin page and the commands also take the release asset URL, e.g. `https://github.com/VibeDev-Si/dsh-film/releases/download/v0.3.2/dsh-film-0.3.2.tgz`. It is fetched straight from GitHub, not through a registry. The file is about 3 MB; if a very slow connection still hits pnpm's default 60-second fetch timeout, install by name from the mirror instead, or raise the timeout — pnpm 11 (the one the desktop apps ship) no longer reads it from `~/.npmrc`, so add `fetchTimeout: 600000` to pnpm's global `config.yaml` (Windows `%LOCALAPPDATA%\pnpm\config\config.yaml`, macOS `~/Library/Preferences/pnpm/config.yaml`, Linux `~/.config/pnpm/config.yaml`) or set `pnpm_config_fetch_timeout=600000`; pnpm 10 and earlier take `fetch-timeout=600000` in `~/.npmrc`.
 - **A fresh release**: pnpm 11 installs only versions published at least a day ago (`minimumReleaseAge`). The very first version is not held back: installing by name a package with no earlier version installs it and adds it to `minimumReleaseAgeExclude`. After each later release, an install by name gets the previous version for a day; to get the new one at once, install the exact version (`dsh-film@<version>`) or use the release URL.
 - **Not from the git repository**: `lib/`, `client/` and `apps/` (the storyboard and director desk front ends) are build outputs that are not in git, so installing from the repository URL fails (it does not leave a plugin that cannot work).
 - **The VibeDev account & models plugin is optional**: only image and video generation on the storyboard needs [@vibedev-si/dsh-vibedev](https://github.com/VibeDev-Si/dsh-vibedev) (formerly dsh-media; sign in to VibeDev at the bottom of the sidebar or in Settings → VibeDev account). Everything else works without it; installing the workbench from the VibeDev Plugin Center installs it too. The storyboard lists for each video model the modes that plugin accepts: lanes that declare no first frame (Seedance 2.5 (VibeDev), 2.5 30s (VibeDev), 2.5 480p 30s (山海) and the three lec lanes; Seedance 2.5 特价按次 takes a first frame and keeps image-to-video) offer no image-to-video, and a single image goes as a 全能参考 (multi-reference) reference image instead, also for nodes saved as image-to-video earlier.
 
 Then open the right sidebar of a session that has a workspace and pick a part on its start page. The first time a film tab opens, the plugin creates the film — named after the workspace folder, 16:9, with an empty storyboard — with no form to fill in. Rename it and pick its frame in the header the three tabs share: click the title to edit it (up to 80 characters; Enter or clicking away saves, Esc cancels); the frame is the film's aspect ratio, which the storyboard canvas and the director desk use (16:9, 9:16, 1:1, 4:5, 21:9, 2.39:1). A 4:3 film made by 0.1.0 keeps and shows its frame. To upgrade, install the new version over the old one (no need to uninstall first), then restart DeepSeek Harness / VibeDev: until you do, the workbench shows a banner asking for the restart and does not open the storyboard or the director desk. Your film stays in the workspace's `film/` folder either way.
 
+### 0.3.2 版本说明 · 0.3.2 release note
+
+- **新增「相关组件」入口**：剧本、分镜画布和导演台三个标签的尾部多了一张卡片，按宿主真实的安装情况，缺哪个 VibeDev 组件就逐条说明它管什么——不装「[VibeDev 账号与模型](https://github.com/VibeDev-Si/dsh-vibedev)」就生成不了图片和视频，不装「媒体预览与画廊」就不能在右侧栏直接播生成的结果；点一下打开 VibeDev 插件中心（宿主没有中心页面时退回它的安装对话框，再不然给出可以复制的包名），不会自动安装。宿主已经安装或应用自己内置的组件不会重复推荐，两件都有时只给「更多创作工具」这一个入口。升级插件不动工作区 `film/` 下的作品文件，也不影响 VibeDev 账号登录。
+
+- **A 相关组件 (related components) entry**: the end of each of the three tabs — script, storyboard and director desk — carries a card that, from what the Host actually has, names each VibeDev component still missing and what it is for — without [VibeDev Account & Models](https://github.com/VibeDev-Si/dsh-vibedev) the storyboard and the director desk cannot generate images or video, and without Media Viewer generated video and audio cannot be played in the sidebar. One click opens the VibeDev plugin centre (the Host's install dialog when it has no centre page, and otherwise a package name to copy) and nothing is installed by it. A component the Host already has, or that the application itself provides, is not offered again: with both present the card offers only "more tools for creators". Updating the plugin neither touches the film/ files in your workspace nor affects your VibeDev sign-in.
+
 ### 0.3.1 版本说明 · 0.3.1 release note
 
 - **配合改名后的「VibeDev 账号与模型」插件**（[@vibedev-si/dsh-vibedev](https://github.com/VibeDev-Si/dsh-vibedev)，原 dsh-media）：未登录时的提示改为指向侧边栏底部「登录 VibeDev」和「设置 → VibeDev 账号」（dsh-media 的设置页里并没有登录入口）；缺少插件时的提示写明新的插件名和包名；Agent 工具说明里的 dsh-media 改称 VibeDev 插件。功能没有变化：分镜画布照旧通过 `vibedevMedia` 服务生成，新旧两个插件都提供这个服务。
@@ -225,6 +231,14 @@ npm run build      # 先删掉 lib/ 和 client/，再构建 lib/（Host 一侧
 
 Only `lib/` and `client/` build from this repository. `apps/` is built by `node scripts/build-apps.mjs canvas` from sibling checkouts — `../canvas` on `feat/dsh-host` (vibedev-canvas) and `../director-desk` on `feat/dsh-procedural-mannequin` (vibedev-director-desk); both are private repositories, so only maintainers can rebuild `apps/`. The script replaces only `apps/canvas`: a checkout that comes from 0.1 must delete the other folders under `apps/` by hand, or the package check refuses to pack. The same step removes the files `scripts/app-excludes.mjs` lists (the director desk's experiment and smoke-test pages, benchmark image, and the model-runtime page with its toolchain, about 10 MB) and writes the app's licences and `THIRD-PARTY-NOTICES.txt` (every production npm dependency the bundle can contain, with version, licence, repository and licence text). `node scripts/build-apps.mjs notices canvas` rewrites only those, warning when a checkout is not at the commit the app's `component-build.json` records; `trim` only removes the excluded files. `prepack` builds and then runs `scripts/check-package.mjs`, which refuses to pack without the app, the licence and notice files (with the Apache License beside the director desk's glTF decoders when it has them), with a canvas catalogue that fails the check the agent's tools apply when they read it, with the FFmpeg AAC encoder still in the canvas build (an `aac-encoder` chunk or `licenses/FFmpeg-LGPL-2.1.txt`; this release does not ship it, and the page re-encodes sound with the browser's own AAC encoder), with anything but `canvas` under `apps/`, with a top-level `vendor/` or `models/`, with excluded files present, with stale files in `lib/`, or with build-machine paths in `lib/` or `client/`. `publishConfig` sends `npm publish` to the npm registry.
 
+## 可信发布 · Trusted publishing
+
+维护者先在本地构建私有前端、运行类型检查和测试、打出已测 tgz，再为对应源码创建版本标签和附带 `dsh-film-<版本>.tgz` 的正式 GitHub Release。`.github/workflows/publish.yml` 通过 npm OIDC 发布这个原包，不在公共 runner 上重建私有画布和导演台。工作流核对 tag、源码和包内版本、Release 附件摘要；相同版本已发布且字节一致则跳过，内容不同则拒绝；发布后下载 npm 完整包再比对。手动重试未发布版本时，工作流 ref 选对应版本标签。
+
+npm Trusted Publisher 填 GitHub owner `VibeDev-Si`、repository `dsh-film`、workflow `publish.yml`，Environment 留空，勾选 **Allow npm publish**；需要管理 `latest` / `next` 时同时勾选 **Allow npm dist-tag**。仓库不保存 npm token。可信发布不授权 `npm deprecate`，弃用操作仍需交互认证。
+
+Maintainers build and test locally, including the private front ends, then attach the tested archive to the matching tagged GitHub Release. The OIDC workflow publishes those exact bytes, validates the Release digest and source version, refuses conflicting immutable npm versions, and verifies the published tarball. Configure the owner/repository/workflow above; retries of an unpublished version run on its tag ref. Deprecation uses separate interactive authentication.
+
 ## 许可 · License
 
 本插件以 MIT 许可证发布，见 `LICENSE`。包里还带着别人的代码，许可证和第三方声明放在这些地方：

package/client/client.js

@@ -22,6 +22,16 @@ window.__ModuleLoader__.load({ id: "dsh-film", factory: (require) => {
 			"runtime.restartOlder": "影视工作台已更新：已安装 {installed}，但正在运行的还是更早的版本。请重启 DeepSeek Harness / VibeDev，新版本才会生效；重启之前这里的页面无法使用。",
 			"runtime.unknown": "未知版本",
 			"runtime.retiredView": "这个标签已不再提供。",
+			"suite.missing.title": "还差一件，这份工作才走得完",
+			"suite.account.missing": "「VibeDev 账号与模型」：装上并登录后，分镜画布和导演台才能生成图片和视频（按用量从 VibeDev 余额扣费）。在 VibeDev 应用里它已经内置，不用另装。",
+			"suite.viewer.missing": "「媒体预览与画廊」：生成好的视频和音频在右侧栏直接播放——拖进度、倍速、循环，还能按文件夹看整批素材。",
+			"suite.missing.keep": "补齐之后，已保存的作品、剧本和账号登录都不受影响：升级插件不动工作区里的 film/ 文件。",
+			"suite.tools.title": "更多创作工具",
+			"suite.tools.hint": "VibeDev 账号与模型、媒体预览与画廊，以及插件中心里的其他创作插件，都列在插件中心，可以一并查看和升级。",
+			"suite.open": "在插件中心查看",
+			"suite.manual": "也可以打开「插件 → 添加插件」，填入这个包名：",
+			"suite.copy": "复制包名",
+			"suite.copied": "已复制",
 			"story.title": "剧本",
 			"story.guide.description": "分场大纲、角色和版本，写好交给分镜画布",
 			"board.title": "分镜画布",
@@ -304,6 +314,16 @@ window.__ModuleLoader__.load({ id: "dsh-film", factory: (require) => {
 			"runtime.restartOlder": "The film workbench was updated: {installed} is installed, but an earlier version is still running. Restart DeepSeek Harness / VibeDev for the new version to take effect; until then the pages here cannot be used.",
 			"runtime.unknown": "an unknown version",
 			"runtime.retiredView": "This tab is no longer offered.",
+			"suite.missing.title": "One piece is still missing for this work",
+			"suite.account.missing": "\"VibeDev Account & Models\": once installed and signed in, the storyboard canvas and the director desk can generate images and video (billed by usage against your VibeDev balance). The VibeDev app ships with it built in, so there is nothing to add there.",
+			"suite.viewer.missing": "\"Media Viewer\": play the video and audio you generated right in the sidebar — seek, change speed, loop, and browse a whole folder as a gallery.",
+			"suite.missing.keep": "Adding these leaves your saved work, screenplays and sign-in untouched: updating a plugin never touches the film/ files in your workspace.",
+			"suite.tools.title": "More tools for creators",
+			"suite.tools.hint": "VibeDev Account & Models, Media Viewer, and the other creator plugins are all listed in the plugin centre, where they can be reviewed and updated together.",
+			"suite.open": "Open the plugin centre",
+			"suite.manual": "You can also open Plugins → Add plugin and paste this package name:",
+			"suite.copy": "Copy package name",
+			"suite.copied": "Copied",
 			"story.title": "Script",
 			"story.guide.description": "Scene outline, characters and versions, handed to the storyboard when ready",
 			"board.title": "Storyboard",
@@ -576,6 +596,302 @@ window.__ModuleLoader__.load({ id: "dsh-film", factory: (require) => {
 			"sw.impact.locate": "Locate on canvas"
 		};
 		//#endregion
+		//#region src/client/suite.ts
+		/**
+		* The complementary VibeDev components this plugin's own work leans on, and the
+		* way to the plugin centre that lists the rest.
+		*
+		* What the Host actually has comes from its plugin inventory (a bundle the
+		* profile installed, or one the application provides itself); the centre's own
+		* page is opened where it is registered, and otherwise the Host's install
+		* entry, and otherwise the spec a person can paste into the Plugins page. Every
+		* service is read optionally through a property check, so a Host without a
+		* plugin manager, without a panel layout, or without the plugin navigation
+		* contract keeps this plugin working and simply shows no entry, or the manual
+		* one. Nothing here installs anything: the centre and the Plugins page own
+		* every install, approval and progress.
+		*
+		* Package names are the stable ones the centre's catalogue and the plugin
+		* manager know; no version is named here, because the catalogue and the install
+		* dialog are what discover the current one.
+		*/
+		/** The VibeDev components by package name; the centre is the way to all of them. */
+		const SUITE = {
+			account: "@vibedev-si/dsh-vibedev",
+			center: "@vibedev-si/dsh-ecosystem",
+			film: "dsh-film",
+			viewer: "@vibedev-si/dsh-media-viewer"
+		};
+		/** The package a person can add on the Plugins page when nothing can open the centre. */
+		const CENTER_SPEC = SUITE.center;
+		/** The main panel the VibeDev plugin centre registers its page under. */
+		const CENTER_PANEL = "vibedev-center";
+		/** A property value read as a record, without trusting its declared type. */
+		function asRecord(value) {
+			return typeof value === "object" && value !== null ? value : void 0;
+		}
+		/**
+		* One service of the client context, read optionally.
+		* `ctx.get(name)` answers for an absent or inactive service without the strict property read;
+		* a Host, or a service, whose own getter throws answers undefined here rather than failing the plugin.
+		* @param ctx - the client context.
+		* @param name - the service name.
+		* @returns the service, or undefined when this Host does not serve it.
+		*/
+		function service(ctx, name) {
+			const record = asRecord(ctx);
+			if (record === void 0) return void 0;
+			const get = record.get;
+			if (typeof get === "function") try {
+				const value = get.call(record, name);
+				if (value !== void 0) return value;
+			} catch (_error) {}
+			try {
+				return record[name];
+			} catch (_error) {
+				return;
+			}
+		}
+		/**
+		* Whether the Host has a bundle: the profile installed it, or the application provides it itself.
+		* @param bundle - one inventory row.
+		* @returns whether the component is usable without installing anything.
+		*/
+		function bundlePresent(bundle) {
+			return bundle.installed === true || bundle.removable === false && !bundle.source;
+		}
+		/**
+		* The present package names of one inventory answer's rows.
+		* @param answer - the Host's answer to `listBundles`.
+		* @returns the names, empty when the answer carries no list.
+		*/
+		function presentFrom(answer) {
+			const rows = asRecord(answer)?.value;
+			if (!Array.isArray(rows)) return /* @__PURE__ */ new Set();
+			const names = /* @__PURE__ */ new Set();
+			for (const row of rows) {
+				const bundle = asRecord(row);
+				if (bundle === void 0 || !bundlePresent(bundle)) continue;
+				if (typeof bundle.name === "string" && bundle.name !== "") names.add(bundle.name);
+			}
+			return names;
+		}
+		/**
+		* What one inventory answer means. Only an accepted envelope carrying a list is an inventory:
+		* a refused answer (`ok: false` with an error) and a value that is not a list are both unread,
+		* never an empty Host, so nothing is ever reported missing on the strength of a failure.
+		* A Host that answers with the list itself is accepted as well.
+		* @param answer - the Host's answer to `listBundles`.
+		* @returns the read, with `ok` false when nothing could be learned.
+		*/
+		function presentFromAnswer(answer) {
+			const record = asRecord(answer);
+			if (record === void 0) return {
+				ok: false,
+				present: /* @__PURE__ */ new Set()
+			};
+			if (record.ok === true && Array.isArray(record.value)) return {
+				ok: true,
+				present: presentFrom(record)
+			};
+			if (Array.isArray(answer)) return {
+				ok: true,
+				present: presentFrom({ value: answer })
+			};
+			return {
+				ok: false,
+				present: /* @__PURE__ */ new Set()
+			};
+		}
+		/**
+		* Read the Host's plugin inventory once.
+		* @param ctx - the client context.
+		* @returns what is present, or `ok: false` when no inventory could be read.
+		*/
+		async function readPresence(ctx) {
+			const manager = asRecord(service(service(ctx, "remote"), "pluginManager"));
+			const listBundles = manager?.listBundles;
+			if (typeof listBundles !== "function") return {
+				ok: false,
+				present: /* @__PURE__ */ new Set()
+			};
+			try {
+				return presentFromAnswer(await listBundles.call(manager));
+			} catch (_error) {
+				return {
+					ok: false,
+					present: /* @__PURE__ */ new Set()
+				};
+			}
+		}
+		/**
+		* Hear about installs, removals and activations.
+		* @param ctx - the client context.
+		* @param listener - called after every change.
+		* @returns the unsubscribe, a no-op on a Host without the event bus.
+		*/
+		function observePresence(ctx, listener) {
+			const remote = asRecord(service(ctx, "remote"));
+			const on = remote?.$on;
+			if (typeof on !== "function") return () => {};
+			try {
+				const off = on.call(remote, "plugin-manager/changed", listener);
+				if (typeof off !== "function") return () => {};
+				const stop = off;
+				return () => {
+					stop();
+				};
+			} catch (_error) {
+				return () => {};
+			}
+		}
+		/**
+		* The centre's main panel, where this Host registered one.
+		* A slots entry keeps its identity in `options` (`options.key` is the panel id the layout
+		* selects); older shapes kept `key`/`id` at the top level, which is still read as a fallback.
+		* @param ctx - the client context.
+		* @returns the panel id the layout selects, or undefined when there is no centre page.
+		*/
+		function centerPanel(ctx) {
+			const slots = asRecord(service(ctx, "slots"));
+			const entries = slots?.entries;
+			if (typeof entries !== "function") return void 0;
+			const listed = entries.call(slots, "main");
+			if (!Array.isArray(listed)) return void 0;
+			for (const entry of listed) {
+				const record = asRecord(entry);
+				const options = asRecord(record?.options);
+				if ((options?.key ?? record?.key ?? options?.id ?? record?.id) === CENTER_PANEL) return CENTER_PANEL;
+			}
+		}
+		/**
+		* Send the person to the VibeDev plugin centre, or to the Host's own way of installing it.
+		* A panel that is gone, a layout that refuses, and a missing navigation contract each fall
+		* through to the next, and the last answer is the spec to paste.
+		* @param ctx - the client context.
+		* @returns what was opened.
+		*/
+		function openCenter(ctx) {
+			const panel = centerPanel(ctx);
+			const selectPanel = asRecord(service(ctx, "layout"))?.selectPanel;
+			if (panel !== void 0 && typeof selectPanel === "function") try {
+				selectPanel.call(service(ctx, "layout"), panel);
+				return { kind: "center" };
+			} catch (_error) {}
+			const navigation = asRecord(service(ctx, "pluginNavigation"));
+			const openBundle = navigation?.openBundle;
+			if (typeof openBundle === "function") try {
+				openBundle.call(navigation, SUITE.center);
+				return { kind: "plugins" };
+			} catch (_error) {}
+			const openInstall = navigation?.openInstall;
+			if (typeof openInstall === "function") try {
+				openInstall.call(navigation, { spec: CENTER_SPEC });
+				return { kind: "plugins" };
+			} catch (_error) {}
+			return {
+				kind: "manual",
+				spec: CENTER_SPEC
+			};
+		}
+		/**
+		* Which of `wanted` this Host does not have yet.
+		* @param present - what the Host has.
+		* @param wanted - the components, in the order the surface lists them.
+		* @returns the absent ones.
+		*/
+		function missingFrom(present, wanted) {
+			return wanted.filter((want) => !present.has(want.package));
+		}
+		/**
+		* What a surface says: the reasons something is absent, or the one way to the rest.
+		* An inventory that could not be read claims nothing and offers the centre.
+		* @param read - the inventory read.
+		* @param wanted - the components this surface leans on.
+		* @param translate - the entry's bound dictionary, so a card renders lines rather than keys.
+		* @returns the hint the card renders.
+		*/
+		function suiteHint(read, wanted, translate) {
+			if (!read.ok) return {
+				kind: "tools",
+				missing: []
+			};
+			const missing = missingFrom(read.present, wanted);
+			if (missing.length === 0) return {
+				kind: "tools",
+				missing: []
+			};
+			return {
+				kind: "missing",
+				missing: missing.map((want) => ({
+					package: want.package,
+					line: translate(want.key)
+				}))
+			};
+		}
+		/** Write text through the browser's clipboard, where the page has one. */
+		async function writeClipboard(text) {
+			const clipboard = asRecord(asRecord(globalThis)?.navigator)?.clipboard;
+			const writeText = asRecord(clipboard)?.writeText;
+			if (typeof writeText !== "function") return false;
+			try {
+				await writeText.call(clipboard, text);
+				return true;
+			} catch (_error) {
+				return false;
+			}
+		}
+		/**
+		* The entry's read of what this Host has, shared by every card it hands to the workbench.
+		* @param ctx - the client context.
+		* @param wanted - the components this plugin's own work leans on.
+		* @param translate - the entry's bound dictionary.
+		* @returns the store: subscribe and render through {@link SuiteView}, and start it inside an effect.
+		*/
+		function createSuiteStore(ctx, wanted, translate) {
+			let snapshot = {
+				read: false,
+				found: {
+					ok: false,
+					present: /* @__PURE__ */ new Set()
+				},
+				hint: {
+					kind: "tools",
+					missing: []
+				}
+			};
+			const listeners = /* @__PURE__ */ new Set();
+			const publish = (next) => {
+				snapshot = next;
+				for (const listener of [...listeners]) listener();
+			};
+			const read = async () => {
+				const found = await readPresence(ctx);
+				publish({
+					read: true,
+					found,
+					hint: suiteHint(found, wanted, translate)
+				});
+			};
+			return {
+				subscribe(listener) {
+					listeners.add(listener);
+					return () => {
+						listeners.delete(listener);
+					};
+				},
+				getSnapshot: () => snapshot,
+				open: () => openCenter(ctx),
+				copy: writeClipboard,
+				start: () => {
+					read();
+					return observePresence(ctx, () => {
+						read();
+					});
+				}
+			};
+		}
+		//#endregion
 		//#region src/client/artwork.tsx
 		/**
 		* The script part: a page with lines.
@@ -795,7 +1111,7 @@ window.__ModuleLoader__.load({ id: "dsh-film", factory: (require) => {
 		* @param props - the tab, the session and this part.
 		* @returns the body.
 		*/
-		function TabBody({ useTabInfo, sessionId, useSessions, translate: t, view }) {
+		function TabBody({ useTabInfo, sessionId, useSessions, translate: t, view, suite }) {
 			const { tab } = useTabInfo();
 			const cwd = useSessions((sessions) => sessions.byId[sessionId]?.cwd);
 			const [attempt, setAttempt] = (0, react.useState)(0);
@@ -825,7 +1141,8 @@ window.__ModuleLoader__.load({ id: "dsh-film", factory: (require) => {
 							t,
 							openView: (next) => {
 								tab.actions.openTab(kindOf(next));
-							}
+							},
+							suite
 						})
 					})
 				}, attempt)
@@ -846,6 +1163,18 @@ window.__ModuleLoader__.load({ id: "dsh-film", factory: (require) => {
 		*/
 		/** The dictionary namespace this plugin owns. */
 		const LOCALE_NAMESPACE = "dsh-film";
+		/**
+		* The components this workbench's own work leans on: generating in the storyboard needs the
+		* VibeDev account, and the results are watched in the media viewer. A Host that has both is
+		* offered the centre instead, for everything else.
+		*/
+		const WANTED = [{
+			package: SUITE.account,
+			key: "suite.account.missing"
+		}, {
+			package: SUITE.viewer,
+			key: "suite.viewer.missing"
+		}];
 		const name = "dsh-film";
 		const inject = [
 			"slots",
@@ -862,6 +1191,8 @@ window.__ModuleLoader__.load({ id: "dsh-film", factory: (require) => {
 				en
 			}), "dsh-film: dictionaries");
 			const t = ctx.locale.bind(LOCALE_NAMESPACE);
+			const suite = createSuiteStore(ctx, WANTED, t);
+			ctx.effect(() => suite.start(), "dsh-film: suite presence");
 			for (const part of PARTS) {
 				ctx.effect(() => ctx.sidebarRightTabs.register({
 					id: part.id,
@@ -882,7 +1213,8 @@ window.__ModuleLoader__.load({ id: "dsh-film", factory: (require) => {
 					locale: LOCALE_NAMESPACE,
 					inject: () => ({
 						translate: t,
-						view: part.view
+						view: part.view,
+						suite
 					})
 				}, TabBody)), `dsh-film: ${part.kind} body`);
 			}

package/client/client.workbench.js

@@ -178,7 +178,7 @@ window.__ModuleLoader__.load({ id: "dsh-film", chunk: "client.workbench.js", fac
 		}
 		//#endregion
 		//#region \0dsh-film-css:src/client/workbench/workbench.module.css.mjs
-		const css$1 = ".dshfilm_Z9L7vq_root{flex-direction:column;flex:auto;min-height:0;display:flex}.dshfilm_Z9L7vq_header{box-sizing:border-box;border-bottom:.5px solid var(--dsw-alias-border-l3);flex:none;align-items:center;gap:8px;height:38px;padding:0 12px 0 16px;display:flex}.dshfilm_Z9L7vq_titleHeading{min-width:0;max-width:60%;font-size:inherit;font-weight:inherit;flex:0 auto;align-items:center;margin:0;display:flex}.dshfilm_Z9L7vq_title{min-width:0;max-width:100%;height:26px;color:var(--dsw-alias-label-primary);font:inherit;font-size:var(--dsh-content-font-size-primary,14px);text-align:left;white-space:nowrap;text-overflow:ellipsis;cursor:text;background:0 0;border:0;border-radius:6px;flex:0 auto;margin:0 0 0 -6px;padding:0 6px;font-weight:600;overflow:hidden}.dshfilm_Z9L7vq_title:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}.dshfilm_Z9L7vq_title:disabled{color:var(--dsw-alias-label-secondary);cursor:default}.dshfilm_Z9L7vq_titleInput{flex:0 260px;width:260px;min-width:120px;margin-left:-6px}.dshfilm_Z9L7vq_aspect{font-variant-numeric:tabular-nums;flex:none}.dshfilm_Z9L7vq_headerError{color:var(--dsw-alias-state-error-primary);white-space:nowrap;text-overflow:ellipsis;margin-left:auto;font-size:12px;overflow:hidden}.dshfilm_Z9L7vq_file{color:var(--dsw-alias-label-tertiary);white-space:nowrap;text-overflow:ellipsis;margin-left:auto;font-size:12px;overflow:hidden}.dshfilm_Z9L7vq_body{scrollbar-gutter:stable;flex:auto;min-height:0;padding:12px 16px 16px;overflow:auto}.dshfilm_Z9L7vq_frameBody{flex-direction:column;flex:auto;min-height:0;display:flex;overflow:hidden}.dshfilm_Z9L7vq_appFrame{background:var(--dsw-alias-bg-base);border:0;flex:auto;width:100%;min-height:0}.dshfilm_Z9L7vq_restartBanner{border-bottom:.5px solid var(--dsw-alias-border-l3);background:var(--dsw-alias-state-warn-tertiary,var(--dsw-alias-bg-layer-2));color:var(--dsw-alias-state-warn-label,var(--dsw-alias-label-primary));flex:none;margin:0;padding:8px 16px;font-size:13px;line-height:1.5}.dshfilm_Z9L7vq_notice{color:var(--dsw-alias-label-secondary);flex-direction:column;align-items:flex-start;gap:12px;margin:0;padding:16px;display:flex}.dshfilm_Z9L7vq_notice p{margin:0}.dshfilm_Z9L7vq_detail{color:var(--dsw-alias-label-tertiary);word-break:break-word;font-size:12px}.dshfilm_Z9L7vq_soon{color:var(--dsw-alias-label-tertiary);margin:0}";
+		const css$1 = ".dshfilm_Z9L7vq_root{flex-direction:column;flex:auto;min-height:0;display:flex}.dshfilm_Z9L7vq_header{box-sizing:border-box;border-bottom:.5px solid var(--dsw-alias-border-l3);flex:none;align-items:center;gap:8px;height:38px;padding:0 12px 0 16px;display:flex}.dshfilm_Z9L7vq_titleHeading{min-width:0;max-width:60%;font-size:inherit;font-weight:inherit;flex:0 auto;align-items:center;margin:0;display:flex}.dshfilm_Z9L7vq_title{min-width:0;max-width:100%;height:26px;color:var(--dsw-alias-label-primary);font:inherit;font-size:var(--dsh-content-font-size-primary,14px);text-align:left;white-space:nowrap;text-overflow:ellipsis;cursor:text;background:0 0;border:0;border-radius:6px;flex:0 auto;margin:0 0 0 -6px;padding:0 6px;font-weight:600;overflow:hidden}.dshfilm_Z9L7vq_title:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover)}.dshfilm_Z9L7vq_title:disabled{color:var(--dsw-alias-label-secondary);cursor:default}.dshfilm_Z9L7vq_titleInput{flex:0 260px;width:260px;min-width:120px;margin-left:-6px}.dshfilm_Z9L7vq_aspect{font-variant-numeric:tabular-nums;flex:none}.dshfilm_Z9L7vq_headerError{color:var(--dsw-alias-state-error-primary);white-space:nowrap;text-overflow:ellipsis;margin-left:auto;font-size:12px;overflow:hidden}.dshfilm_Z9L7vq_file{color:var(--dsw-alias-label-tertiary);white-space:nowrap;text-overflow:ellipsis;margin-left:auto;font-size:12px;overflow:hidden}.dshfilm_Z9L7vq_body{scrollbar-gutter:stable;flex:auto;min-height:0;padding:12px 16px 16px;overflow:auto}.dshfilm_Z9L7vq_frameBody{flex-direction:column;flex:auto;min-height:0;display:flex;overflow:hidden}.dshfilm_Z9L7vq_appFrame{background:var(--dsw-alias-bg-base);border:0;flex:auto;width:100%;min-height:0}.dshfilm_Z9L7vq_restartBanner{border-bottom:.5px solid var(--dsw-alias-border-l3);background:var(--dsw-alias-state-warn-tertiary,var(--dsw-alias-bg-layer-2));color:var(--dsw-alias-state-warn-label,var(--dsw-alias-label-primary));flex:none;margin:0;padding:8px 16px;font-size:13px;line-height:1.5}.dshfilm_Z9L7vq_notice{color:var(--dsw-alias-label-secondary);flex-direction:column;align-items:flex-start;gap:12px;margin:0;padding:16px;display:flex}.dshfilm_Z9L7vq_notice p{margin:0}.dshfilm_Z9L7vq_detail{color:var(--dsw-alias-label-tertiary);word-break:break-word;font-size:12px}.dshfilm_Z9L7vq_soon{color:var(--dsw-alias-label-tertiary);margin:0}.dshfilm_Z9L7vq_suite{border:.5px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-l2,transparent);border-radius:10px;flex-direction:column;flex:none;gap:4px;margin:8px 12px 12px;padding:10px 12px;display:flex}.dshfilm_Z9L7vq_suiteMissing{border-color:var(--dsw-alias-state-warning-primary,var(--dsw-alias-border-l2))}.dshfilm_Z9L7vq_suiteTitle{color:var(--dsw-alias-label-primary);margin:0;font-size:13px;font-weight:500}.dshfilm_Z9L7vq_suiteLine{color:var(--dsw-alias-label-secondary);margin:0;font-size:12px;line-height:1.6}.dshfilm_Z9L7vq_suiteActions{flex-wrap:wrap;gap:8px;padding-top:2px;display:flex}.dshfilm_Z9L7vq_suiteManual{flex-wrap:wrap;align-items:center;gap:6px;padding-top:2px;display:flex}.dshfilm_Z9L7vq_suiteSpec{background:var(--dsw-alias-bg-l1,transparent);color:var(--dsw-alias-label-primary);user-select:text;border-radius:6px;padding:2px 6px;font-size:12px}";
 		const tagId$1 = "dsh-film/workbench.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
 			const tag = document.createElement("style");
@@ -200,6 +200,13 @@ window.__ModuleLoader__.load({ id: "dsh-film", chunk: "client.workbench.js", fac
 			"restartBanner": "dshfilm_Z9L7vq_restartBanner",
 			"root": "dshfilm_Z9L7vq_root",
 			"soon": "dshfilm_Z9L7vq_soon",
+			"suite": "dshfilm_Z9L7vq_suite",
+			"suiteActions": "dshfilm_Z9L7vq_suiteActions",
+			"suiteLine": "dshfilm_Z9L7vq_suiteLine",
+			"suiteManual": "dshfilm_Z9L7vq_suiteManual",
+			"suiteMissing": "dshfilm_Z9L7vq_suiteMissing",
+			"suiteSpec": "dshfilm_Z9L7vq_suiteSpec",
+			"suiteTitle": "dshfilm_Z9L7vq_suiteTitle",
 			"title": "dshfilm_Z9L7vq_title",
 			"titleHeading": "dshfilm_Z9L7vq_titleHeading",
 			"titleInput": "dshfilm_Z9L7vq_titleInput"
@@ -693,7 +700,7 @@ window.__ModuleLoader__.load({ id: "dsh-film", chunk: "client.workbench.js", fac
 		* an older dictionary, whose translate function echoes keys it lacks.
 		*/
 		/** The version this bundle was built as (tsdown defines it); `dev` where nothing does (node tests). */
-		const CLIENT_VERSION = "0.3.1";
+		const CLIENT_VERSION = "0.3.2";
 		/**
 		* Whether the page should ask for a restart.
 		* @param client - the version this page was built as.
@@ -5828,6 +5835,104 @@ window.__ModuleLoader__.load({ id: "dsh-film", chunk: "client.workbench.js", fac
 			});
 		}
 		//#endregion
+		//#region src/client/workbench/SuiteCard.tsx
+		/**
+		* The footer of a workbench part: what this Host still lacks for the work this part does, or,
+		* when nothing is missing, one quiet way into the plugin centre for everything else.
+		*
+		* It is a plain card at the end of the part, drawn from the entry's own read of the Host
+		* (passed in as {@link SuiteView}); nothing here installs, navigates on its own, or appears
+		* before the read settled. Opening the centre is the person's click, and a Host where nothing
+		* can open shows the package spec instead, to copy into the Plugins page.
+		*/
+		/**
+		* Draw the card from a settled read.
+		* @param props - the translated hint, the manual fallback and the two clicks.
+		* @returns the card.
+		*/
+		function suiteCardView({ t, hint, manual, copied, onOpen, onCopy }) {
+			const missing = hint.kind === "missing";
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+				className: `${workbench_module_css_default.suite} ${missing ? workbench_module_css_default.suiteMissing : ""}`,
+				"data-dsh-film-suite": hint.kind,
+				"aria-label": t(missing ? "suite.missing.title" : "suite.tools.title"),
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: workbench_module_css_default.suiteTitle,
+						children: t(missing ? "suite.missing.title" : "suite.tools.title")
+					}),
+					hint.missing.map((want) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: workbench_module_css_default.suiteLine,
+						children: want.line
+					}, want.package)),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+						className: workbench_module_css_default.suiteLine,
+						children: t(missing ? "suite.missing.keep" : "suite.tools.hint")
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: workbench_module_css_default.suiteActions,
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+							variant: "outline",
+							size: "sm",
+							onClick: onOpen,
+							children: t("suite.open")
+						})
+					}),
+					manual === void 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: workbench_module_css_default.suiteManual,
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: workbench_module_css_default.suiteLine,
+								children: t("suite.manual")
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("code", {
+								className: workbench_module_css_default.suiteSpec,
+								children: manual.spec
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+								variant: "ghost",
+								size: "sm",
+								onClick: () => {
+									onCopy(manual.spec);
+								},
+								children: t(copied ? "suite.copied" : "suite.copy")
+							})
+						]
+					})
+				]
+			});
+		}
+		/**
+		* Draw the card.
+		* @param props - the entry's suite view and this plugin's dictionary.
+		* @returns the card, or nothing before the first read settled.
+		*/
+		function SuiteCard({ suite, t }) {
+			const { read, hint } = (0, react.useSyncExternalStore)(suite.subscribe, suite.getSnapshot, suite.getSnapshot);
+			/** Set once a click found nothing to open: the spec to copy is then on screen. */
+			const [manual, setManual] = (0, react.useState)(void 0);
+			const [copied, setCopied] = (0, react.useState)(false);
+			if (!read) return null;
+			const open = () => {
+				const target = suite.open();
+				setCopied(false);
+				setManual(target.kind === "manual" ? { spec: target.spec } : void 0);
+			};
+			const copy = (spec) => {
+				suite.copy(spec).then((written) => {
+					setCopied(written);
+				});
+			};
+			return suiteCardView({
+				t,
+				hint,
+				manual,
+				copied,
+				onOpen: open,
+				onCopy: copy
+			});
+		}
+		//#endregion
 		//#region src/client/workbench/workbench.tsx
 		/**
 		* The film workbench, loaded on first use as client/client.workbench.js.
@@ -5888,7 +5993,7 @@ window.__ModuleLoader__.load({ id: "dsh-film", chunk: "client.workbench.js", fac
 			});
 		}
 		/** A part this build draws, under the restart banner. */
-		function ProjectPart({ view, cwd, visible, t, openView, banner, notice }) {
+		function ProjectPart({ view, cwd, visible, t, openView, suite, banner, notice }) {
 			const { state, reload } = useProject(cwd, visible);
 			if (state.status === "loading") return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: workbench_module_css_default.root,
@@ -5937,6 +6042,7 @@ window.__ModuleLoader__.load({ id: "dsh-film", chunk: "client.workbench.js", fac
 				visible,
 				t,
 				openView,
+				suite,
 				project: state.project
 			});
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -5964,6 +6070,10 @@ window.__ModuleLoader__.load({ id: "dsh-film", chunk: "client.workbench.js", fac
 							}),
 							blocked: notice === null ? void 0 : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: restartText(t, notice) })
 						}, `${view}:${state.project.id}`)
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SuiteCard, {
+						suite,
+						t
 					})
 				]
 			});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-film",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "VibeDev 影视工作台：在 DeepSeek Harness 和 VibeDev 的右侧侧栏里写剧本、排分镜和调度导演台，Agent 用影视工具协同改片 · Film workbench for DeepSeek Harness and VibeDev: screenplay, storyboard canvas and director desk in the right sidebar, with film tools for the agent",
   "type": "module",
   "main": "lib/index.js",
@@ -53,13 +53,13 @@
     "storyboard",
     "ai-agent"
   ],
-  "homepage": "https://github.com/CrisLIUning/dsh-film#readme",
+  "homepage": "https://github.com/VibeDev-Si/dsh-film#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/CrisLIUning/dsh-film.git"
+    "url": "git+https://github.com/VibeDev-Si/dsh-film.git"
   },
   "bugs": {
-    "url": "https://github.com/CrisLIUning/dsh-film/issues"
+    "url": "https://github.com/VibeDev-Si/dsh-film/issues"
   },
   "license": "MIT",
   "engines": {