dsh-watch-video
面向 DeepSeek Harness 的字幕优先视频转录插件。优先读取字幕；字幕不可用时使用 faster-whisper large-v3，并生成摘要与 SRT。插件不调用外部 LLM，也不保留原视频。
核心能力
- 支持 HTTP(S) 视频地址，使用
yt-dlp获取媒体。 - 字幕优先；必要时下载音频并用 Whisper 转录。
- 输出
transcript.txt、transcript.json、transcript.srt、summary.md和metadata.json。 - 支持任务取消、状态查询、任务列表和转录并发限制。
- 支持 Windows、Linux、macOS；任务超时会清理整个进程树。
- 只保留转录所需音频与派生产物，不保留原视频。
- DSH 重启后会按
staleJobAfterMs将过期的 running 任务恢复为interrupted，并清理不完整产物。默认阈值为 6 小时，异常心跳会保守跳过。
子进程输出按流独立进行有界保留：stdout 保留前缀，stderr 保留末尾；限制按 UTF-8 字节计算，并持续 drain 两个流。超时、取消或输出超限会终止整个进程树，并返回有限的诊断信息。maxOutputBytes 优先于旧配置名 outputLimitBytes。
安装依赖
需要 Node.js 20+、Python 3.10+、yt-dlp 和 ffmpeg。在项目目录运行：
npm install
python -m pip install -r requirements.txt
powershell -ExecutionPolicy Bypass -File scripts/bootstrap.ps1
npm run doctor首次真正使用 Whisper fallback 时，faster-whisper 会下载 large-v3 模型，需要数 GB 磁盘空间。测试和打包检查不会下载模型或访问真实站点。
DSH 工具
dsh_watch_video：提交视频转录任务。dsh_watch_video_status：查询单个任务状态。dsh_watch_video_list：列出当前进程中的任务。dsh_watch_video_cancel：取消运行中的任务。
任务查询和取消是当前 Node 进程内能力；DSH 重启后，旧 jobId 不再可查询。
安全边界
只接受不含凭证和控制字符的 HTTP(S) 地址；不绕过登录、付费墙、DRM 或平台限制。外部进程使用参数数组和 shell: false。请确认你对内容拥有访问、下载、转录和保存权限。
验证
npm test
npm run typecheck
npm run pack:check
npm run verify:pack
node scripts/doctor.mjs --files-only完整配置、产物协议、取消语义和平台边界见 README.zh.md。
