dsh-watch-together

dsh-watch-together 陪智能体一起看视频：跟着你的真实播放进度，在你快看完这一段时，把这一段的画面分镜和带秒台词一起递过去；它还能在悬浮窗里出声、也听得见房间里的声音 —— 它看到的是画面，不是一段转写文本。 名字全小写，带横杠 —— 和 dsh-video-storyboard 同一个风格。

English TL;DR — a DSH plugin that watches a video *together* with the agent, in sync with the real playback position a browser extension reports. Each segment arrives as one storyboard image plus its subtitle lines just before that segment ends; the floating window carries spoken replies (through whatever voice adapter you plug in) and live room audio. The agent gets picture, text and sound — not a transcript. Code, identifiers and the tool schema are English; the docs below are Chinese. 它是什么：一个 DSH 插件，只注册一个工具 watch_together 它不是什么：不是全片概览，不是播放器，也不带 TTS 引擎（声音自己接，见 §接声音） 依赖：node + ffmpeg + 一个浏览器扩展（可选但强烈建议） 30 秒开始

然后在会话里：

配置在哪、缺什么怎么补：全部集中在 docs/CONFIG.zh.md —— ffmpeg / yt-dlp / B 站 cookies / ASR / 浏览器扩展 / 调试端口 / 声音 / 悬浮窗，一节一个服务。 它和 dsh-video-storyboard 是什么关系

两个插件，一个依赖。 这不是一个包里的两个开关。 陪看天生建立在视频识别之上：它每次交付的那一格画面和清单，都是调用 dsh-video-storyboard 的 runStoryboard() 算出来的。所以本包把 dsh-video-storyboard 写成普通依赖（^0.5.0）， npm i dsh-watch-together 会连它一起装上 —— 装的是库代码，不会因此多注册四个 video_* 工具 （工具由各自的插件入口注册）。

想只要视频识别、不要陪看：装 dsh-video-storyboard 就行，本包不会被拖进来。 发布顺序 —— 但版本号不需要对齐

本包依赖 dsh-video-storyboard@^0.5.0。这是范围，不是等号：semver 对 0.x 的规定是 ^0.5.0 = >=0.5.0 本包的 dependencies 里已经声明了 dsh-video-storyboard，所以不用手动装第二个包。 浏览器扩展在这个包里（ /node_modules/dsh-watch-together/extension）， 装完按「进度从哪来」加载一次就行。 从源码装 / 本地双仓库开发

scripts/install-dev.mjs 是开发用的：它把本地的自己和同级 dsh-video-storyboard 复制进 profile，避免开发时用到 npm 上的旧版。

从"陪看还在 storyboard 里"的旧版本升级（重要）

旧版 dsh-video-storyboard@0.4.x 自己就注册了 watch_together。如果宿主 profile 里还留着那份旧副本， 而这个包装上之后同一个工具会被注册两遍。升级顺序：

（这是本地副本的清理路径。走 dsh plugin 装的话，profile 里只有一份，不存在重复注册。）