bili-transcript 0.0.0-stage → 1.0.1

package/src/fetch.mjs

@@ -0,0 +1,128 @@
+// 提取字幕 / AI 总结 —— 核心逻辑，返回结构化数据
+import { API, getJson, wbiQuery, check, parseBvid, ts } from './api.mjs';
+
+/**
+ * 取视频信息 + 字幕 +（可选）AI 总结
+ * 返回结构化对象，由调用方决定怎么渲染。
+ */
+export async function fetchVideo(target, { page = 1, summary = false } = {}) {
+  const vid = parseBvid(target);
+  const view = check(
+    await getJson(vid.startsWith('av')
+      ? `${API}/x/web-interface/view?aid=${vid.slice(2)}`
+      : `${API}/x/web-interface/view?bvid=${vid}`),
+    '视频信息');
+
+  const bvid = view.bvid;
+  const pages = view.pages;
+  if (page > pages.length) {
+    const e = new Error(`该视频只有 ${pages.length} 个分P`);
+    e.code = 'bad-page';
+    throw e;
+  }
+  const pg = pages[page - 1];
+  const aid = view.aid;
+  const cid = pg.cid;
+
+  const result = {
+    bvid,
+    aid,
+    cid,
+    title: view.title,
+    part: pages.length > 1 ? pg.part : null,
+    page,
+    pageCount: pages.length,
+    duration: pg.duration,
+    uploader: view.owner.name,
+    uploaderMid: view.owner.mid,
+    url: `https://www.bilibili.com/video/${bvid}`,
+    subtitles: [],
+    // ⚠️ 只用 wbi 版。老接口 x/player/v2 会返回别的视频的字幕，绝不回退。
+    body: [],
+    warning: null,
+    summary: null,
+  };
+
+  const pv = check(await getJson(`${API}/x/player/wbi/v2?${await wbiQuery({ bvid, cid, aid })}`), '字幕列表');
+  const subs = (pv.subtitle && pv.subtitle.subtitles) || [];
+  result.subtitles = subs.map((s) => ({
+    lan: s.lan,
+    lanDoc: s.lan_doc,
+    url: s.subtitle_url && s.subtitle_url.startsWith('//') ? 'https:' + s.subtitle_url : s.subtitle_url,
+  }));
+
+  if (!subs.length) {
+    result.noSubtitleReason = pv.need_login_subtitle ? 'need-login' : 'none-available';
+    return result;
+  }
+
+  const items = (await getJson(result.subtitles[0].url)).body || [];
+  result.body = items
+    .filter((it) => (it.content || '').trim())
+    .map((it) => ({ from: Number(it.from || 0), to: Number(it.to || 0), text: it.content.trim() }));
+
+  // 数据自洽校验：防「拿到别的视频的字幕」
+  if (result.body.length) {
+    const end = result.body[result.body.length - 1].to;
+    if (end < pg.duration * 0.7) {
+      result.warning = `字幕只到 ${end.toFixed(0)}s，视频有 ${pg.duration}s，可能是分段轨或数据不匹配，请核对。`;
+    }
+  }
+
+  if (summary) {
+    try {
+      const qs = await wbiQuery({ bvid, cid, up_mid: String(view.owner.mid) });
+      const r = await getJson(`${API}/x/web-interface/view/conclusion/get?${qs}`);
+      if (r.code === 0 && r.data) {
+        const m = r.data.model_result || {};
+        result.summary = {
+          text: m.summary || '',
+          outline: (m.outline || []).map((o) => ({
+            title: o.title,
+            points: (o.part_outline || []).map((pt) => ({
+              timestamp: Number(pt.timestamp || 0),
+              text: pt.content,
+            })),
+          })),
+        };
+      }
+    } catch { /* 拿不到总结不算失败 */ }
+  }
+
+  return result;
+}
+
+/** 渲染成人读的文本 */
+export function renderText(v, { plain = false, list = false } = {}) {
+  const out = [];
+  out.push('# ' + v.title + (v.part ? `  [P${v.page} ${v.part}]` : ''));
+  out.push(`UP: ${v.uploader} | 时长 ${v.duration}s | ${v.url}`);
+
+  if (v.noSubtitleReason === 'need-login') {
+    out.push('\n[字幕接口要求登录：当前无有效凭据，拿不到字幕轨。运行 `bili login` 扫码登录]');
+  } else if (v.noSubtitleReason === 'none-available') {
+    out.push('\n[该视频没有字幕轨。纯音乐 / MV / CG 类视频通常没有。可加 --summary 试试 B 站的 AI 总结。]');
+  }
+
+  if (list) {
+    if (!v.subtitles.length) out.push('该视频没有字幕轨。');
+    for (const s of v.subtitles) out.push(`- ${s.lanDoc} (${s.lan}) ${s.url}`);
+  }
+
+  if (v.body.length) {
+    out.push(`\n## 字幕：${v.subtitles[0].lanDoc || v.subtitles[0].lan}（${v.body.length} 条）\n`);
+    if (v.warning) out.push(`⚠️ ${v.warning}\n`);
+    for (const it of v.body) out.push(plain ? it.text : `[${ts(it.from)}] ${it.text}`);
+  }
+
+  if (v.summary) {
+    out.push('\n## B站 AI 总结\n');
+    if (v.summary.text) out.push(v.summary.text);
+    for (const o of v.summary.outline) {
+      out.push(`\n### ${o.title}`);
+      for (const p of o.points) out.push(`- [${ts(p.timestamp)}] ${p.text}`);
+    }
+  }
+
+  return out.join('\n') + '\n';
+}

package/src/install-skill.mjs

@@ -0,0 +1,63 @@
+// 安装 agent skill —— 首选 npx skills add，失败则自己往已知目录写
+import { existsSync, mkdirSync, copyFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = join(HERE, '..');
+const SKILL_MD = join(PKG_ROOT, 'SKILL.md');
+
+// 各 agent 的 skill 目录（装了就往这些地方放）
+const KNOWN_DIRS = [
+  '~/.claude/skills',
+  '~/.codex/skills',
+  '~/.config/agent-skills',
+  '~/.agents/skills',
+];
+
+export async function installSkill({ global: isGlobal = true } = {}) {
+  const log = console.log;
+
+  // 1) 首选：npx skills add（走官方生态，兼容性最好）
+  log('尝试 `npx skills add` …');
+  const r = spawnSync('npx', ['-y', 'skills@latest', 'add', 'dongliang/bili-transcript',
+                              isGlobal ? '-g' : '-p', '-y'],
+                      { stdio: 'inherit', shell: process.platform === 'win32' });
+  if (r.status === 0) {
+    log('\n✅ 已通过 npx skills 安装。');
+    return true;
+  }
+
+  // 2) 降级：自己往已知目录写
+  log(`\n⚠️  npx skills 不可用（退出码 ${r.status}），改用内置安装：`);
+  if (!existsSync(SKILL_MD)) {
+    log(`❌ 找不到 ${SKILL_MD}，无法安装。`);
+    return false;
+  }
+
+  const targets = KNOWN_DIRS
+    .map((d) => d.replace(/^~/, homedir()))
+    .filter((d) => existsSync(dirname(d)));
+
+  if (!targets.length) {
+    log('❌ 没有找到任何已知的 agent skill 目录。');
+    log('   请手动把包里的 SKILL.md 复制到你的 agent skill 目录。');
+    return false;
+  }
+
+  for (const t of targets) {
+    const dest = join(t, 'bilibili-transcript');
+    try {
+      mkdirSync(dest, { recursive: true });
+      copyFileSync(SKILL_MD, join(dest, 'SKILL.md'));
+      log(`  ✅ ${dest}/SKILL.md`);
+    } catch (e) {
+      log(`  ❌ ${dest}：${e.message}`);
+    }
+  }
+
+  log('\n注意：降级安装只放 SKILL.md，agent 需要能通过 `npx bili-transcript` 调用工具。');
+  return true;
+}

package/src/login.mjs

@@ -0,0 +1,116 @@
+// 扫码登录 —— 纯命令行，不需要任何浏览器
+import { writeFileSync, readFileSync, existsSync } from 'node:fs';
+import { encodeQR, renderText, writePNG } from './qr.mjs';
+import { UA, API } from './api.mjs';
+import { saveAuth, AUTH_PATH, findSessdata } from './auth.mjs';
+
+const H = { 'User-Agent': UA, Referer: 'https://www.bilibili.com/' };
+const QRAPI = 'https://passport.bilibili.com/x/passport-login/web/qrcode';
+const KEYFILE = '/tmp/bili_qr.json';
+
+/** 读 cookie 头。不同 Node 构建行为不一致：getSetCookie() 可能不存在，get() 可能返回数组 */
+function readSetCookies(resp) {
+  const h = resp.headers;
+  if (typeof h.getSetCookie === 'function') {
+    const v = h.getSetCookie();
+    if (v && v.length) return v;
+  }
+  const raw = h.get('set-cookie');
+  if (Array.isArray(raw)) return raw;
+  return raw ? [raw] : [];
+}
+
+export async function whoami() {
+  const nav = await (await fetch(`${API}/x/web-interface/nav`, { headers: H })).json();
+  return nav.data?.isLogin ? nav.data : null;
+}
+
+export async function login({ png = null, qrOnly = false, resume = false, timeout = 180, force = false, log = console.log }) {
+  if (!force && !resume && !qrOnly) {
+    const who = await whoami().catch(() => null);
+    if (who) {
+      log(`已经登录过了：${who.uname}（uid ${who.mid}）`);
+      log(`凭据位置：${AUTH_PATH}`);
+      log('要重新登录请加 --force');
+      return { alreadyLoggedIn: true, user: who };
+    }
+  }
+
+  let url, key;
+  if (resume) {
+    if (!existsSync(KEYFILE)) throw new Error('没有找到之前生成的二维码，请先运行 `bili login --qr-only`');
+    const s = JSON.parse(readFileSync(KEYFILE, 'utf8'));
+    url = s.url; key = s.key;
+    const age = Math.round((Date.now() - s.ts) / 1000);
+    log(`沿用 ${age}s 前生成的二维码`);
+    if (age > 170) log('⚠️ 已接近过期，若失败请重新生成');
+  } else {
+    const gen = await (await fetch(`${QRAPI}/generate`, { headers: H })).json();
+    if (gen.code !== 0) throw new Error(`生成二维码失败：code=${gen.code} ${gen.message || ''}`);
+    url = gen.data.url; key = gen.data.qrcode_key;
+  }
+
+  const matrix = encodeQR(url);
+
+  if (!resume && !qrOnly) {
+    log('\n用手机 B 站 App 扫码登录：\n');
+    log(renderText(matrix));
+    log(`链接：${url}\n`);
+  }
+
+  if (png) {
+    const r = writePNG(matrix, png, { scale: 8, quiet: 4 });
+    log(`二维码图片已写入 ${png}（${r.width}×${r.height}）`);
+  }
+
+  if (qrOnly) {
+    writeFileSync(KEYFILE, JSON.stringify({ url, key, ts: Date.now() }) + '\n');
+    log(`已保存二维码到 ${KEYFILE}。给用户看完后用 --resume 继续轮询。`);
+    return { qrOnly: true, url, key, png };
+  }
+
+  log('等待扫码…（二维码约 3 分钟过期）');
+  const deadline = Date.now() + timeout * 1000;
+  const jar = {};
+  let lastState = null;
+
+  while (Date.now() < deadline) {
+    let resp;
+    try {
+      resp = await fetch(`${QRAPI}/poll?qrcode_key=${key}`, { headers: H });
+    } catch {
+      await sleep(2000);
+      continue;
+    }
+    for (const c of readSetCookies(resp)) {
+      const nv = c.split(';')[0];
+      const i = nv.indexOf('=');
+      if (i > 0) jar[nv.slice(0, i)] = nv.slice(i + 1);
+    }
+    let body;
+    try { body = await resp.json(); } catch { await sleep(2000); continue; }
+    const code = body.data?.code;
+    if (code !== lastState) {
+      lastState = code;
+      const label = { 86101: '未扫码', 86090: '已扫码，等待确认', 86038: '二维码已过期' }[code] || `code=${code}`;
+      log(`  [${new Date().toTimeString().slice(0, 8)}] ${label}`);
+    }
+    if (code === 0) break;
+    if (code === 86038) throw new Error('二维码已过期，请重新运行');
+    await sleep(2000);
+  }
+
+  if (!jar.SESSDATA) throw new Error('超时，或没能拿到凭据。请重试。');
+
+  saveAuth(jar);
+  const who = await whoami().catch(() => null);
+
+  log('\n=== 登录成功 ===');
+  if (who) log(`  账号：${who.uname}（uid ${who.mid}）`);
+  log(`  拿到 ${Object.keys(jar).length} 项凭据：${Object.keys(jar).join(', ')}`);
+  log(`  已保存到 ${AUTH_PATH}（权限 0600）`);
+
+  return { ok: true, user: who, cookies: Object.keys(jar) };
+}
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));