@pls-compile-owo/fisheye 0.4.2 → 0.7.2

package/lib/ytdlp.mjs

@@ -0,0 +1,393 @@
+// 通用平台视频（可选）：yt-dlp 下载 → 本地 mp4 → 交给本地视频模式（抽帧 / 字幕带）
+//
+// 定位：fisheye 原来只有两路信息源——B站（官方 API）和本地文件。
+// YouTube / 抖音 / Twitter 这些平台没有统一的公开 API，但 yt-dlp 一个二进制就能抓，
+// 下载完的视频和用户手动放进来的本地文件没有任何区别，所以这里只负责「拿到一个视频路径」，
+// 后续抽帧、字幕、预算分配全部复用现成流程。
+//
+// 设计约束（和 audio.mjs 一致）：
+// · 零 npm 依赖，Node ≥18
+// · 子进程一律 spawnSync；下载主流程 stdio:'ignore'（沙箱禁管道捕获），
+//   探测类命令（where / --version）把 stdout+stderr 重定向到临时文件再读
+// · 这是**可选能力**：没有 yt-dlp / URL 非法 / 网络失败 / 超时一律返回 null，绝不让整个看片流程失败
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import crypto from 'node:crypto'
+import { spawnSync } from 'node:child_process'
+import { FFMPEG, PKG_DIR } from './env.mjs'
+
+const IS_WIN = process.platform === 'win32'
+const EXE = (name) => (IS_WIN ? `${name}.exe` : name)
+
+// yt-dlp 在 PATH 上的命令名；Windows 下 where 能靠 PATHEXT 命中 yt-dlp.exe
+const YTDLP_NAMES = ['yt-dlp', 'yt-dlp.exe']
+
+// 下载产物可能是这几种容器（--merge-output-format mp4 时是 mp4，降级单文件时可能是 webm/mkv）
+const MEDIA_EXT = new Set(['.mp4', '.mkv', '.webm', '.mov', '.m4v', '.flv', '.ts'])
+
+// -f 选择器：默认 best video + best audio，合不上时退回「最佳单文件」
+const QUALITY = {
+  best: 'bv*+ba/b',
+  '2160': 'bv*[height<=2160]+ba/b[height<=2160]/b',
+  '1440': 'bv*[height<=1440]+ba/b[height<=1440]/b',
+  '1080': 'bv*[height<=1080]+ba/b[height<=1080]/b',
+  '720': 'bv*[height<=720]+ba/b[height<=720]/b',
+  '480': 'bv*[height<=480]+ba/b[height<=480]/b',
+}
+
+// --version 探测要启动一次单文件 exe（约 0.3~2s），findYtdlp / ytdlpCaps / downloadVideo 都会调，缓存一次
+const versionCache = new Map()
+
+const stripQuotes = (s) => String(s ?? '').trim().replace(/^"(.*)"$/, '$1').replace(/^'(.*)'$/, '$1')
+
+function readText(file) {
+  try { return fs.readFileSync(file, 'utf8').replace(/^\uFEFF/, '') } catch { return '' }
+}
+
+function tmpFile(tag) {
+  return path.join(os.tmpdir(), `fisheye-${tag}-${process.pid}-${crypto.randomUUID().slice(0, 8)}.txt`)
+}
+
+/**
+ * 跑一个短命令并把 stdout+stderr 落到临时文件。
+ * 沙箱里不能捕获管道，所以不能用 spawnSync 的 'pipe' —— 只能 fd 重定向。
+ */
+function capture(cmd, args, timeoutMs = 8000) {
+  const file = tmpFile('cap')
+  let fd = null
+  try {
+    fd = fs.openSync(file, 'w')
+    const r = spawnSync(cmd, args, {
+      stdio: ['ignore', fd, fd],
+      timeout: timeoutMs,
+      windowsHide: true,
+    })
+    return {
+      ok: r.status === 0,
+      status: r.status,
+      error: r.error,
+      out: readText(file).slice(0, 65536),
+    }
+  } catch (e) {
+    return { ok: false, status: null, error: e, out: '' }
+  } finally {
+    if (fd !== null) try { fs.closeSync(fd) } catch {}
+    try { fs.unlinkSync(file) } catch {}
+  }
+}
+
+// where.exe / which 的全部命中行（没有命中返回 []）
+function whereAll(name) {
+  const r = capture(IS_WIN ? 'where.exe' : 'which', [name], 5000)
+  if (r.status !== 0) return []
+  return r.out.split(/\r?\n/).map((s) => s.trim()).filter(Boolean)
+}
+
+/**
+ * 判断一个 where 命中项是否值得 spawn。
+ * Windows 上 where 会命中 .cpl/.dll 之类（PATHEXT），spawn 会 ENOENT；
+ * .bat/.cmd 也排除：spawnSync 不带 shell 无法直接执行它们。
+ */
+function spawnable(p) {
+  if (!p) return false
+  const ext = path.extname(p).toLowerCase()
+  if (IS_WIN && ['.cpl', '.dll', '.msi', '.sys', '.scr', '.bat', '.cmd', '.ps1', '.vbs', '.js'].includes(ext)) return false
+  const looksPath = p.includes('/') || p.includes('\\')
+  if (looksPath && !fs.existsSync(p)) return false
+  try {
+    if (fs.existsSync(p)) {
+      const st = fs.statSync(p)
+      if (!st.isFile() || st.size === 0) return false
+    }
+  } catch { return false }
+  return true
+}
+
+// yt-dlp --version 输出形如 2026.10.26（nightly 多一段数字），用它确认「这个文件真的是 yt-dlp」
+function looksLikeVersion(text) {
+  return /^\d{4}\.\d{2}\.\d{2}/m.test(String(text ?? '').trim())
+}
+
+function versionOf(cmd) {
+  const key = String(cmd).toLowerCase()
+  if (versionCache.has(key)) return versionCache.get(key)
+  const r = capture(cmd, ['--version'], 10000)
+  const version = looksLikeVersion(r.out) ? r.out.trim().split(/\r?\n/)[0] : null
+  const info = { ok: r.ok && Boolean(version), version, status: r.status, error: r.error }
+  versionCache.set(key, info)
+  return info
+}
+
+// 常见安装位置：用户按 README 手动放的位置优先于系统级安装
+function commonYtdlpPaths(env = process.env) {
+  const home = os.homedir()
+  const localAppData = stripQuotes(env.LOCALAPPDATA) || path.join(home, 'AppData', 'Local')
+  return [
+    path.join(home, '.dsh', 'surfcore', 'yt-dlp', EXE('yt-dlp')),
+    path.join(localAppData, 'Programs', 'yt-dlp', EXE('yt-dlp')),
+    path.join(localAppData, 'Microsoft', 'WinGet', 'Links', EXE('yt-dlp')),
+    path.join(PKG_DIR, 'bin', EXE('yt-dlp')),
+  ]
+}
+
+/**
+ * 探测 yt-dlp，同时把探测过程记成 notes（给 selftest / caps 用）。
+ * @returns {{ ytdlp: { cmd: string, source: string, version: string|null } | null, notes: string[] }}
+ */
+function findYtdlpDetailed({ env = process.env } = {}) {
+  const notes = []
+
+  // 1) 环境变量显式指定（用户可以指到任意位置的单文件 exe）
+  const fromEnv = stripQuotes(env.FISHEYE_YTDLP)
+  if (fromEnv) {
+    if (!spawnable(fromEnv)) {
+      notes.push(`FISHEYE_YTDLP=${fromEnv} 不是可执行文件，已忽略`)
+    } else {
+      const v = versionOf(fromEnv)
+      if (v.ok) return { ytdlp: { cmd: fromEnv, source: '环境变量 FISHEYE_YTDLP', version: v.version }, notes }
+      notes.push(`FISHEYE_YTDLP=${fromEnv} 跑 --version 不像 yt-dlp，已忽略`)
+    }
+  }
+
+  // 2) PATH
+  for (const name of YTDLP_NAMES) {
+    for (const cmd of whereAll(name).filter(spawnable)) {
+      const v = versionOf(cmd)
+      if (v.ok) return { ytdlp: { cmd, source: `PATH（${name}）`, version: v.version }, notes }
+    }
+  }
+
+  // 3) 常见安装路径（用户手动解压 yt-dlp.exe 时它通常不在 PATH 里）
+  for (const cmd of commonYtdlpPaths(env)) {
+    if (!fs.existsSync(cmd) || !spawnable(cmd)) continue
+    const v = versionOf(cmd)
+    if (v.ok) return { ytdlp: { cmd, source: '常见安装路径', version: v.version }, notes }
+  }
+
+  return { ytdlp: null, notes }
+}
+
+/** ffmpeg 解析：显式参数 → FFMPEG 环境变量 → env.mjs → 本机常见目录 → PATH */
+function resolveFfmpeg({ env = process.env, explicit } = {}) {
+  const home = os.homedir()
+  const cands = [
+    explicit,
+    env.FFMPEG,
+    FFMPEG,
+    path.join(home, '.dsh', 'surfcore', 'bili', 'bin', EXE('ffmpeg')),
+    path.join(home, '.dsh', 'surfcore', 'bin', EXE('ffmpeg')),
+    path.join(PKG_DIR, 'bin', EXE('ffmpeg')),
+  ].filter(Boolean).map(stripQuotes)
+
+  for (const c of cands) {
+    try {
+      if (fs.existsSync(c) && fs.statSync(c).isFile()) return c
+    } catch { /* 下一个 */ }
+  }
+  return whereAll('ffmpeg').filter(spawnable)[0] ?? null
+}
+
+/**
+ * 探测可用的 yt-dlp。
+ * 顺序：FISHEYE_YTDLP → PATH 上的 yt-dlp → 常见路径（~/.dsh/surfcore/yt-dlp、%LOCALAPPDATA%\Programs\yt-dlp、项目 bin/）。
+ * @param {{ env?: NodeJS.ProcessEnv, ffmpeg?: string }} [opts]
+ * @returns {{ cmd: string, ffmpeg: string|null, version: string|null, source: string } | null}
+ */
+export function findYtdlp({ env, ffmpeg } = {}) {
+  try {
+    const e = env ?? process.env
+    const { ytdlp } = findYtdlpDetailed({ env: e })
+    if (!ytdlp) return null
+    return {
+      cmd: ytdlp.cmd,
+      ffmpeg: resolveFfmpeg({ env: e, explicit: ffmpeg }),
+      version: ytdlp.version,
+      source: ytdlp.source,
+    }
+  } catch {
+    return null
+  }
+}
+
+/**
+ * 能力描述（给 CLI / selftest 打印用）。
+ * available 为 true 表示「现在能把一个平台 URL 下成视频文件」。
+ * 没有 ffmpeg 仍然可用，只是退化为单文件格式（不少平台没有单文件高清流，画质会低一些）。
+ * @param {{ env?: NodeJS.ProcessEnv, ffmpeg?: string, ytdlp?: object }} [options]
+ * @returns {{ available: boolean, reason: string, summary: string, hint: string|null,
+ *             cmd: string|null, ffmpeg: string|null, version: string|null, notes: string[] }}
+ */
+export function ytdlpCaps(options = {}) {
+  const env = options.env ?? process.env
+  try {
+    const detail = options.ytdlp
+      ? { ytdlp: options.ytdlp, notes: [] }
+      : findYtdlpDetailed({ env })
+    const y = detail.ytdlp
+    const ffmpeg = resolveFfmpeg({ env, explicit: options.ffmpeg })
+    const caps = {
+      available: false,
+      reason: '',
+      summary: '',
+      hint: null,
+      cmd: y?.cmd ?? null,
+      version: y?.version ?? null,
+      ffmpeg: ffmpeg ?? null,
+      notes: detail.notes ?? [],
+    }
+
+    if (!y) {
+      caps.reason = '未找到 yt-dlp（已试 FISHEYE_YTDLP / PATH / ~/.dsh/surfcore/yt-dlp / %LOCALAPPDATA%\\Programs\\yt-dlp / 项目 bin/）'
+      caps.hint = '从 https://github.com/yt-dlp/yt-dlp/releases/latest 下载 yt-dlp.exe 放到 ~/.dsh/surfcore/yt-dlp/，'
+        + '或设 FISHEYE_YTDLP=<yt-dlp 完整路径>'
+    } else {
+      caps.available = true
+      const bits = [`yt-dlp ${y.version ?? ''}（${path.basename(y.cmd)}，${y.source}）`.replace('  ', ' ')]
+      if (ffmpeg) bits.push(`ffmpeg ${path.basename(ffmpeg)}（合并音视频）`)
+      else bits.push('无 ffmpeg（降级单文件格式，画质受限）')
+      caps.reason = bits.join('；')
+      if (!ffmpeg) caps.hint = '设 FFMPEG=<ffmpeg 完整路径> 或把 ffmpeg 装到 PATH，才能合并 1080p+ 的分离音视频流'
+    }
+
+    caps.summary = `通用平台视频（yt-dlp）：${caps.available ? '可用' : '不可用'} —— ${caps.reason}`
+    return caps
+  } catch (e) {
+    return {
+      available: false,
+      reason: `能力探测异常：${String(e?.message ?? e).slice(0, 120)}`,
+      summary: '通用平台视频（yt-dlp）：不可用 —— 能力探测异常',
+      hint: null,
+      cmd: null,
+      version: null,
+      ffmpeg: null,
+      notes: [],
+    }
+  }
+}
+
+/**
+ * 校验 URL：只接受 http/https，其余（file:、javascript:、ftp:、裸字符串）一律拒绝。
+ * @returns {string|null} 归一化后的 URL
+ */
+function normalizeUrl(input) {
+  if (typeof input !== 'string') return null
+  const raw = input.trim()
+  if (!raw || raw.length > 8192) return null
+  let u
+  try { u = new URL(raw) } catch { return null }
+  if (u.protocol !== 'http:' && u.protocol !== 'https:') return null
+  if (!u.hostname) return null
+  return u.toString()
+}
+
+// 目录里 sinceMs 之后生成的最新媒体文件（排除 .part / .ytdl 半成品）
+function newestMedia(dir, sinceMs) {
+  let names = []
+  try { names = fs.readdirSync(dir) } catch { return null }
+  let best = null
+  for (const n of names) {
+    if (n.startsWith('.')) continue
+    const ext = path.extname(n).toLowerCase()
+    if (!MEDIA_EXT.has(ext)) continue
+    if (/\.(part|ytdl|temp)$/i.test(n)) continue
+    const full = path.join(dir, n)
+    try {
+      const st = fs.statSync(full)
+      if (!st.isFile() || st.size === 0) continue
+      if (st.mtimeMs < sinceMs) continue
+      if (!best || st.mtimeMs > best.mtimeMs) best = { file: full, mtimeMs: st.mtimeMs }
+    } catch { /* 跳过读不到的文件 */ }
+  }
+  return best?.file ?? null
+}
+
+/**
+ * 用 yt-dlp 把一个平台 URL 下载成视频文件（放进 outDir）。
+ *
+ * @param {string} url        http(s) 视频页链接
+ * @param {string} outDir     产物目录（不存在会自动创建）
+ * @param {{ timeoutMs?: number, quiet?: boolean, quality?: 'best'|'2160'|'1440'|'1080'|'720'|'480',
+ *           ytdlp?: object, ffmpeg?: string, env?: NodeJS.ProcessEnv }} [options]
+ * @returns {{ file: string, cmd: string } | null} 失败 / 超时 / 无 yt-dlp / URL 非法 → null（不抛）
+ */
+export function downloadVideo(url, outDir, options = {}) {
+  const env = options.env ?? process.env
+  const quiet = options.quiet === true
+  const timeoutMs = Number.isFinite(options.timeoutMs) && options.timeoutMs > 0 ? options.timeoutMs : 600000
+  const warn = (msg) => { if (!quiet) console.warn(`[yt-dlp] ${msg}`) }
+
+  try {
+    const target = normalizeUrl(url)
+    if (!target) {
+      warn(`跳过下载：不是合法的 http(s) 链接（${String(url ?? '').slice(0, 120) || '(空)'}）`)
+      return null
+    }
+
+    if (!outDir || typeof outDir !== 'string') {
+      warn('没有指定输出目录，跳过下载')
+      return null
+    }
+
+    const found = options.ytdlp ?? findYtdlp({ env, ffmpeg: options.ffmpeg })
+    if (!found?.cmd) {
+      warn('没有 yt-dlp，跳过下载（放一个 yt-dlp.exe 到 ~/.dsh/surfcore/yt-dlp/ 或设 FISHEYE_YTDLP）')
+      return null
+    }
+
+    const dir = path.resolve(outDir)
+    fs.mkdirSync(dir, { recursive: true })
+
+    const quality = QUALITY[String(options.quality ?? 'best')] ? String(options.quality ?? 'best') : 'best'
+    const started = Date.now() - 2000 // 给文件系统 mtime 精度留余量
+
+    // --no-playlist：只下一个视频，别把整个播放列表拖下来
+    const args = ['--no-playlist']
+    if (found.ffmpeg) {
+      args.push('-f', QUALITY[quality], '--merge-output-format', 'mp4')
+      // ffmpeg 不在 PATH 时（本机就在 surfcore\bili\bin），必须显式告诉 yt-dlp 去哪找
+      args.push('--ffmpeg-location', path.dirname(found.ffmpeg))
+    } else {
+      // 没有 ffmpeg 就无法合并分离的音视频流，退回「最佳单文件」
+      args.push('-f', 'b')
+    }
+    args.push('-o', path.join(dir, '%(title).80s [%(id)s].%(ext)s'))
+    args.push(target)
+
+    warn(`下载中（quality=${quality}，最多等 ${Math.round(timeoutMs / 1000)}s）：${target}`)
+    const r = spawnSync(found.cmd, args, {
+      stdio: 'ignore',
+      timeout: timeoutMs,
+      windowsHide: true,
+      env,
+    })
+
+    const timedOut = Boolean(r.error)
+      && (r.error.code === 'ETIMEDOUT' || r.error.errno === 'ETIMEDOUT' || r.signal === 'SIGTERM')
+    if (timedOut) {
+      warn(`下载超时（${Math.round(timeoutMs / 1000)}s），放弃：${target}`)
+      return null
+    }
+    if (r.error) {
+      warn(`启动 yt-dlp 失败：${String(r.error.message ?? r.error).slice(0, 160)}`)
+      return null
+    }
+
+    // 成功时优先取本次新生成的文件；失败时隔一段时间才出现的半成品也不认
+    let file = newestMedia(dir, started)
+    if (!file && r.status === 0) {
+      // yt-dlp 遇到同名已存在文件会直接跳过，此时 mtime 是旧的 —— 退回目录里最新的媒体文件
+      file = newestMedia(dir, 0)
+      if (file) warn(`没有发现本次新生成的文件，使用 outDir 里最新的：${path.basename(file)}`)
+    }
+    if (!file) {
+      warn(`yt-dlp 退出码 ${r.status}，outDir 里没有可用的视频文件：${dir}`)
+      return null
+    }
+
+    return { file, cmd: found.cmd }
+  } catch (e) {
+    warn(`下载异常：${String(e?.message ?? e).slice(0, 160)}`)
+    return null
+  }
+}

package/mcp-video-server.js

@@ -0,0 +1,261 @@
+// fisheye 的 MCP（Model Context Protocol）server —— 可选组件，不是 fisheye 内核依赖。
+//
+// 作用：把 fisheye 的能力包装成 MCP 工具（stdio），让 AI agent（DSH / Claude Code /
+// Cursor 等支持 MCP 的环境）不必自己拼命令行，就能在 token 预算内「看」一条 B站 视频。
+//
+// 工具：
+//   vwatch_scan —— 快速扫一眼：单段九宫格拼图，直接返回画面
+//   vwatch_deep —— 深入看懂：自动规划抽帧 + 官方字幕 → 交给独立 headless 会话读完 →
+//                  只返回「它自己看完能写出的」完整复述（不占当前对话上下文）
+//
+// 工具名沿用 vwatch_*（fisheye 的旧名），以免破坏已有的 MCP 配置；想看 fisheye 本体
+// 请直接用 `node fisheye.mjs <命令>`。
+//
+// ── 可选依赖：fisheye 核心保持零依赖，本文件的两个包请自行安装 ────────────────
+//
+//   npm i @modelcontextprotocol/sdk zod
+//
+// 没装这两个包时不要启动本 server —— node 会在 import 阶段直接报 MODULE_NOT_FOUND，
+// 这是预期行为（MCP 是可选组件，CLI 本身完全不需要它们）。
+//
+// 除 npm 包外还需要：
+//   · node 18+（与 fisheye 一致）
+//   · 同目录的 fisheye.mjs 与 lib/（本仓库）
+//   · ffmpeg（FFMPEG 环境变量、~/.config/fisheye/config.json，或 PATH）
+//   · B站 登录态（BILI_CRED 或 credentials.json）：两个工具都走 B站 接口
+//   · vwatch_deep 的「独立会话复述」需要本机装有 DeepSeek Harness 桌面版；
+//     没有时会自动降级，直接返回抽帧规划 + 官方字幕原文
+//
+// 安全：只认 BV 号（正则提取），execFile 参数数组，不拼命令行、不接受任意路径。
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { fileURLToPath } from 'node:url';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+const execFileP = promisify(execFile);
+const HERE = path.dirname(fileURLToPath(import.meta.url));
+const FISHEYE = path.join(HERE, 'fisheye.mjs');
+// 与 lib/env.mjs 保持一致：FISHEYE_HOME 可把数据目录挪到别处
+const WS = process.env.FISHEYE_HOME || HERE;
+const OUT = path.join(WS, 'out');
+
+/** 只认 BV 号（或含 BV 号的链接），防止把任意字符串当参数递进子进程。 */
+function normalizeBvid(input) {
+  const m = /(BV[0-9A-Za-z]{10})/.exec(String(input ?? '').trim());
+  return m ? m[1] : '';
+}
+
+function safeTime(v, label) {
+  const s = String(v ?? '').trim();
+  if (!s) return '';
+  if (!/^\d+(:\d{1,2}){0,2}$/.test(s)) throw new Error(`${label} 时间格式无效：${s}（支持 330 / 5:30 / 1:05:30）`);
+  return s;
+}
+
+async function runFisheye(args, timeoutMs = 600_000) {
+  const { stdout, stderr } = await execFileP(process.execPath, [FISHEYE, ...args], {
+    cwd: HERE, timeout: timeoutMs, maxBuffer: 16 * 1024 * 1024, windowsHide: true, env: { ...process.env }
+  });
+  return `${stdout ?? ''}\n${stderr ?? ''}`;
+}
+
+function readManifest(id) {
+  try {
+    const mf = JSON.parse(fs.readFileSync(path.join(OUT, `${id}-manifest.json`), 'utf8'));
+    return Array.isArray(mf?.chunks) ? mf : null;
+  } catch { return null; }
+}
+
+function readSubs(id) {
+  const candidates = [path.join(OUT, `${id}-official-subs.txt`), path.join(OUT, `${id}-official-subs-plain.txt`)];
+  for (const f of candidates) {
+    try { const t = fs.readFileSync(f, 'utf8').trim(); if (t) return t; } catch {}
+  }
+  return '';
+}
+
+// ── 独立 headless 会话（自清洁：临时工作区，跑完即删，会话文件不残留）────────────
+function findDesktopExe() {
+  const candidates = [
+    process.env.DSH_DESKTOP_EXE,
+    process.env.LOCALAPPDATA ? path.join(process.env.LOCALAPPDATA, 'Programs', 'DeepSeek Harness', 'DeepSeek Harness.exe') : '',
+    path.join('C:\\Program Files', 'DeepSeek Harness', 'DeepSeek Harness.exe'),
+    path.join('C:\\Program Files (x86)', 'DeepSeek Harness', 'DeepSeek Harness.exe')
+  ].filter(Boolean);
+  return candidates.find((p) => { try { return fs.statSync(p).isFile(); } catch { return false; } }) || '';
+}
+
+function dshHome() { return process.env.DSH_HOME || path.join(os.homedir(), '.dsh'); }
+
+// ── 视频独立会话工作记录（state/video-jobs.jsonl，每行一条）────────────────────
+const VIDEO_JOB_FILE = path.join(HERE, 'state', 'video-jobs.jsonl');
+
+function videoJobCount() {
+  try {
+    const text = fs.readFileSync(VIDEO_JOB_FILE, 'utf8').trim();
+    return text ? text.split('\n').filter(Boolean).length : 0;
+  } catch { return 0; }
+}
+
+function appendVideoJob(job) {
+  try {
+    fs.mkdirSync(path.dirname(VIDEO_JOB_FILE), { recursive: true });
+    fs.appendFileSync(VIDEO_JOB_FILE, JSON.stringify({ seq: videoJobCount() + 1, at: new Date().toISOString(), ...job }) + '\n', 'utf8');
+  } catch {}
+}
+
+function cleanupVideoSessions() {
+  const root = path.join(dshHome(), 'sessions');
+  let removed = 0;
+  try {
+    for (const ws of fs.readdirSync(root, { withFileTypes: true })) {
+      if (!ws.isDirectory() || !ws.name.includes('dsh-video-')) continue;
+      try { fs.rmSync(path.join(root, ws.name), { recursive: true, force: true }); removed += 1; } catch {}
+    }
+  } catch {}
+  return removed;
+}
+
+async function runHeadless(prompt, timeoutMs = 600_000) {
+  const exe = findDesktopExe();
+  if (!exe) throw new Error('找不到 DeepSeek Harness.exe（独立会话模式需要桌面版；可用环境变量 DSH_DESKTOP_EXE 指定）');
+  const bin = path.join(path.dirname(exe), 'resources', 'app.asar', 'dsh', 'node_modules', '@deepseek-ai', 'dsh', 'lib', 'bin.js');
+  const tmpDir = path.join(os.tmpdir(), `dsh-video-${randomUUID()}`);
+  fs.mkdirSync(tmpDir, { recursive: true });
+  const env = { ...process.env, ELECTRON_RUN_AS_NODE: '1', DSH_HOME: dshHome() };
+  try {
+    const { stdout, stderr } = await execFileP(
+      exe,
+      ['--expose-internals', bin, '--profile', 'headless', prompt],
+      { cwd: tmpDir, env, timeout: timeoutMs, windowsHide: true, maxBuffer: 8 * 1024 * 1024 }
+    );
+    const answer = String(stdout ?? '').trim();
+    if (!answer) throw new Error(`headless 没有输出（stderr 末段：${String(stderr ?? '').slice(-500)}）`);
+    return answer;
+  } finally {
+    cleanupVideoSessions();
+    try { fs.rmSync(tmpDir, { recursive: true, force: true }); } catch {}
+  }
+}
+
+function buildDeepPrompt(id, fisheyeText, subs, sheets) {
+  const sheetList = sheets.length ? sheets.map((s, i) => `${i + 1}. ${s}`).join('\n') : '（本次没有抽帧拼图，只有字幕文本）';
+  return [
+    '你是独立视频处理会话。请深入看懂下面这条 B站 视频，然后写出完整的视频内容复述，要求达到「你自己逐帧看过画面、也读过字幕」之后的转述水平。',
+    '',
+    '══ 素材 ══',
+    '【fisheye 规划与信息】',
+    fisheyeText || '（空）',
+    '',
+    '【官方字幕全文】',
+    subs || '（无官方字幕）',
+    '',
+    `【抽帧拼图文件（按时间顺序，共 ${sheets.length} 张）】`,
+    sheetList,
+    '',
+    '══ 任务 ══',
+    '1. 用 read_image 依次读取上面每一张拼图文件（拼图内部按从左到右、从上到下的时间顺序）。',
+    '2. 结合字幕与画面，写出一份完整复述：视频主线；关键桥段按时间顺序，字幕和画面互相印证，画面里有但字幕没说的补上，字幕与画面不一致处指出；出现过的名字、数字、梗、结尾画面。',
+    '3. 输出要求：完整、准确、第一人称口吻（「我看下来……」），像自己真的看完后在转述；不要提「拼图/素材/任务/read_image」这些词；只有画面确实糊到无法辨认时才说看不清。',
+    '直接输出复述正文，不要标题，不要分点编号。'
+  ].join('\n');
+}
+
+const server = new McpServer({ name: 'fisheye', version: '0.3.0' });
+
+server.tool(
+  'vwatch_scan',
+  '快速扫一眼一条 B站 视频：对开头一段抽帧拼成九宫格截图，直接返回画面（不含文字总结）。适合"这是什么视频"这种扫一眼需求；要完整内容请用 vwatch_deep。只读公开视频；约 20~60 秒。',
+  {
+    bvid: z.string().describe('B站 视频的 BV 号（如 BV1iLYm6VET3）或含 BV 号的视频链接'),
+    grid: z.string().optional().describe('抽帧格数：3x3（9帧，默认）、4x4（16帧）、5x5（25帧）')
+  },
+  async ({ bvid, grid }) => {
+    const id = normalizeBvid(bvid);
+    if (!id) return { content: [{ type: 'text', text: '没有识别出 BV 号，请传 BV 号或含 BV 号的视频链接。' }] };
+    const g = ['3x3', '4x4', '5x5'].includes(String(grid ?? '').trim()) ? String(grid).trim() : '3x3';
+    try {
+      const out = await runFisheye(['grid', id, '--chunk', '60', '--grid', g]);
+      const mf = readManifest(id);
+      const sheet = (mf?.chunks ?? []).map((c) => c.sheet).find((s) => s && fs.existsSync(s));
+      if (!sheet) {
+        return { content: [{ type: 'text', text: `没有生成拼图（BV=${id}）。输出末段：${out.slice(-600)}` }] };
+      }
+      const bytes = fs.readFileSync(sheet);
+      if (bytes.length > 4 * 1024 * 1024) return { content: [{ type: 'text', text: '截图过大，已跳过。' }] };
+      return {
+        content: [
+          { type: 'text', text: `视频开头一段的 ${g} 抽帧画面（BV=${id}，仅第一段；看全片内容请用 vwatch_deep）。` },
+          { type: 'image', data: bytes.toString('base64'), mimeType: 'image/jpeg' }
+        ]
+      };
+    } catch (error) {
+      const message = String(error?.message ?? error);
+      const hint = /timeout|timed out/i.test(message) ? '（超时：视频大或网络慢，稍后再试）' : '';
+      return { content: [{ type: 'text', text: `扫一眼失败（BV=${id}）：${message}${hint}` }] };
+    }
+  }
+);
+
+server.tool(
+  'vwatch_deep',
+  '深入看懂一条 B站 视频：自动按 token 预算决定采样密度、优先读取官方字幕（省 token 且比 OCR 准）、长视频分成多张拼图；然后全部交给独立的视频处理会话读完，只返回「它自己读完能写出的」完整复述（主线+桥段+字幕画面互证+细节），不占当前对话上下文。参数 bvid 传 BV 号或链接；from/to 可只看一段；page 选分P；budget 控制采样密度（默认 20000）。整个流程 1~4 分钟；同一个视频不要重复看。',
+  {
+    bvid: z.string().describe('B站 视频的 BV 号（如 BV1iLYm6VET3）或含 BV 号的视频链接'),
+    from: z.string().optional().describe('只看这一段：起始时间，如 330 / 5:30 / 1:05:30'),
+    to: z.string().optional().describe('只看这一段：结束时间，写法同 from'),
+    page: z.string().optional().describe('分P 序号（1~200），默认 1'),
+    budget: z.string().optional().describe('token 预算（2000~200000），默认 20000；越小采样越稀')
+  },
+  async ({ bvid, from, to, page, budget }) => {
+    const id = normalizeBvid(bvid);
+    if (!id) return { content: [{ type: 'text', text: '没有识别出 BV 号，请传 BV 号或含 BV 号的视频链接。' }] };
+    let args;
+    try {
+      args = ['auto', id];
+      const b = Number(budget ?? 20000);
+      if (Number.isFinite(b)) args.push('--budget', String(Math.min(200000, Math.max(2000, Math.round(b)))));
+      const f = safeTime(from, 'from');
+      const t = safeTime(to, 'to');
+      if (f) args.push('--from', f);
+      if (t) args.push('--to', t);
+      const p = Number(page ?? 1);
+      if (Number.isInteger(p) && p >= 1 && p <= 200) args.push('--p', String(p));
+    } catch (error) {
+      return { content: [{ type: 'text', text: String(error?.message ?? error) }] };
+    }
+    const t0 = Date.now();
+    try {
+      const fisheyeText = (await runFisheye(args)).trim();
+      const subs = readSubs(id);
+      const mf = readManifest(id);
+      const sheets = (mf?.chunks ?? []).map((c) => c.sheet).filter((s) => s && fs.existsSync(s));
+      const secs = ((Date.now() - t0) / 1000).toFixed(1);
+
+      let summary = null;
+      try {
+        summary = await runHeadless(buildDeepPrompt(id, fisheyeText, subs, sheets));
+      } catch {}
+
+      const header = `视频：${id}（抽帧+字幕耗时 ${secs}s${summary ? '，独立会话已读完并复述' : '；独立会话不可用，以下为原始素材'}）\n`;
+      if (summary) {
+        appendVideoJob({ tool: 'vwatch_deep', bvid: id, args: { from: String(from ?? ''), to: String(to ?? ''), page: String(page ?? 1), budget: String(budget ?? 20000) }, chars: summary.length, output: summary });
+        return { content: [{ type: 'text', text: `${header}—— 独立会话的完整复述 ——\n${summary}` }] };
+      }
+      const fallback = [`${header}`, '', fisheyeText, '', subs ? `══ 官方字幕 ══\n${subs}` : ''].filter(Boolean).join('\n');
+      return { content: [{ type: 'text', text: fallback }] };
+    } catch (error) {
+      const message = String(error?.message ?? error);
+      const hint = /timeout|timed out/i.test(message) ? '（超时：视频太大/网络慢/预算算出的张数太多，可调小 budget 或加 from/to 缩小范围再试）' : '';
+      return { content: [{ type: 'text', text: `深度看视频失败（BV=${id}）：${message}${hint}` }] };
+    }
+  }
+);
+
+await server.connect(new StdioServerTransport());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pls-compile-owo/fisheye",
-  "version": "0.4.2",
+  "version": "0.7.2",
   "description": "Token-budget-aware video understanding for AI agents: official subtitles -> burned-in subtitle band -> danmaku highlights -> adaptive keyframe grids -> targeted refine.",
   "type": "module",
   "bin": {
@@ -18,7 +18,8 @@
     "README.en.md",
     "CHANGELOG.md",
     "LICENSE",
-    "docs/"
+    "docs/",
+    "mcp-video-server.js"
   ],
   "engines": {
     "node": ">=18"