dsh-film 0.3.3 → 0.3.4

package/README.md

@@ -37,7 +37,7 @@ A film workbench for DeepSeek Harness and VibeDev: three right-sidebar tabs —
 **从 GitHub Release 安装**：插件页的“包名或地址”和上面的命令也接受 Release 里的 `.tgz` 直链，例如
 
 ```
-https://github.com/VibeDev-Si/dsh-film/releases/download/v0.3.3/dsh-film-0.3.3.tgz
+https://github.com/VibeDev-Si/dsh-film/releases/download/v0.3.4/dsh-film-0.3.4.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`。
@@ -56,13 +56,18 @@ 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/VibeDev-Si/dsh-film/releases/download/v0.3.3/dsh-film-0.3.3.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.4/dsh-film-0.3.4.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.4 版本说明 · 0.3.4 release note
+
+- **视频读取范围修复**：媒体服务完整返回播放器所请求的单个字节区间，取消把请求主动截短到 8 MiB 的行为。原片的尾部索引因此能正常读取；响应继续从文件流式发送，客户端断开即停止，不重编码、不替换素材。桌面视频跳转还需要 VibeDev Next 的未压缩响应长度保留修复，两者配合验收。
+- **Media ranges**: the server returns the entire requested byte range rather than truncating it at 8 MiB, allowing players to reach the original file's trailing index. File streaming and cancellation remain intact; media is neither re-encoded nor replaced. Desktop seeking also requires the VibeDev Next fix that retains uncompressed response lengths.
+
 ### 0.3.3 版本说明 · 0.3.3 release note
 
 - **撤回了 0.3.2 的「相关组件」入口**：上一版加在剧本、分镜画布和导演台三个标签页尾的那张卡片（插件之间的推荐位）影响页面观感，已经整个去掉；怎么引荐、在哪引荐等重新设计之后再考虑。工作区 `film/` 里的作品和 VibeDev 账号登录都不受影响，其它功能与 0.3.1 一致。

package/client/client.workbench.js

@@ -693,7 +693,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.3";
+		const CLIENT_VERSION = "0.3.4";
 		/**
 		* Whether the page should ask for a restart.
 		* @param client - the version this page was built as.

package/lib/files.d.ts

@@ -1,11 +1,14 @@
 /**
- * Serving one file from disk: a single byte range (so media can be scrubbed
- * and large files are sent in pieces), a validator for cheap revalidation,
- * and a streamed body that stops when the client goes away.
+ * Serving one file from disk: the byte range the client asked for (so media can
+ * be scrubbed, and so a player can reach a trailing `moov`), a validator for
+ * cheap revalidation, and a streamed body that stops when the client goes away.
+ *
+ * A range response carries exactly the bytes the request named — no server-side
+ * chunking. Memory stays bounded and a lost client stops the read because the
+ * body is a file stream, not a buffer; capping the bytes instead would hand a
+ * player a truncated file it cannot demux.
  * @module dsh-film/files
  */
-/** The most bytes one range response carries; the client asks again for the rest. */
-export declare const RANGE_CHUNK: number;
 /**
  * Read a `Range` header against a file size.
  * @param header - the request's `Range` header.

package/lib/files.js

@@ -1,13 +1,16 @@
 /**
- * Serving one file from disk: a single byte range (so media can be scrubbed
- * and large files are sent in pieces), a validator for cheap revalidation,
- * and a streamed body that stops when the client goes away.
+ * Serving one file from disk: the byte range the client asked for (so media can
+ * be scrubbed, and so a player can reach a trailing `moov`), a validator for
+ * cheap revalidation, and a streamed body that stops when the client goes away.
+ *
+ * A range response carries exactly the bytes the request named — no server-side
+ * chunking. Memory stays bounded and a lost client stops the read because the
+ * body is a file stream, not a buffer; capping the bytes instead would hand a
+ * player a truncated file it cannot demux.
  * @module dsh-film/files
  */
 import { createReadStream } from 'node:fs';
 import { Readable } from 'node:stream';
-/** The most bytes one range response carries; the client asks again for the rest. */
-export const RANGE_CHUNK = 8 * 1024 * 1024;
 /**
  * Read a `Range` header against a file size.
  * @param header - the request's `Range` header.
@@ -42,7 +45,7 @@ export function parseRange(header, size) {
             return 'unsatisfiable';
         end = last === '' ? size - 1 : Math.min(Number(last), size - 1);
     }
-    return { start, end: Math.min(end, start + RANGE_CHUNK - 1) };
+    return { start, end };
 }
 /**
  * The weak validator of a file version: size and modification time.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-film",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "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",