dsh-bili-watch 0.2.4 → 0.2.6

package/README.md

@@ -19,11 +19,13 @@ dsh plugin --profile web add dsh-bili-watch
 
 **第二步易漏**：打开 profile 的 `package.json`，在 `dsh.profile.bundles` 数组里加一行 `"dsh-bili-watch"`。`dsh plugin add` 只写 `dependencies`，不写 bundles。漏了这步插件装了但不生效，也不报错。改完重启 DSH。
 
+装完可以验证：`dsh --profile web --dump-config` 里能搜到 `dsh-bili-watch` 才算进了装配。
+
 也可以把本仓库直接放进 `profiles/<名字>/node_modules/dsh-bili-watch`。
 
 插件依赖 DSH 自带的 `@deepseek-ai/dsh-tools`（peer，optional）。profile 里缺这个包时 `index.js` 会报 `ERR_MODULE_NOT_FOUND`，先补装再重启。
 
-插件尚未收录到插件市场，目前只能按上面的命令装。
+插件市场已收录（2026-10-21）：在市场里搜 `dsh-bili-watch` 直接安装，这是最省事的方式；市场里暂时搜不到时，按上面的命令装。
 
 ### 只当命令行工具
 
@@ -45,7 +47,7 @@ dsh plugin --profile web remove dsh-bili-watch
 
 ## 插件面板
 
-装进 DSH 后，设置 → 插件 → `dsh-bili-watch` 的详情页有一块面板，常规操作无需去对话里敲命令：
+装进 DSH 后，打开插件列表，点 `dsh-bili-watch` 卡片进详情页，里面有一块面板（不用先进设置），常规操作无需去对话里敲命令：
 
 - **依赖状态**：ffmpeg、yt-dlp、ASR 环境、OCR 环境、转写模型、登录凭证逐项列出是否就绪、实际路径、占用体积。缺的点击行末「下载」，后台跑 `scripts/fetch-deps`（体积是估算值，实际以跑完为准）。
 - **扫码登录**：凭证未登录时点「重新扫码」，面板里弹出二维码，手机 B 站扫完自动刷新。凭证保存在本机 `deps/credential.json`。
@@ -122,13 +124,13 @@ macOS/Linux 的 ffmpeg 用系统包管理器装，脚本只给提示。其余目
 |---|---|
 | `view <BV或链接或URL>` | 元数据 + 简介 + 热评 |
 | `peek <BV或链接>` | 元数据 + 热评 + 5 张均匀帧（最便宜；仅 B 站） |
-| `sub <BV>` | AI 字幕 + 三判据（字/秒、关键词命中、时长） |
+| `sub <BV或链接>` | AI 字幕 + 三判据（字/秒、关键词命中、时长） |
 | `comments <BV> [N]` | 评论区，默认按热度排序 |
 | `asr <BV或URL>` | 本地转写音频 |
 | `frames <BV或URL> [--step 秒] [--ocr]` | 抽帧；`--ocr` 顺带识别画面文字 |
 | `ocr <BV>` | 抽帧并 OCR |
 | `text <BV或URL>` | 四级链：字幕 → 转写 → 抽帧 OCR |
-| `sheet <BV> [--grid 3x3]` | 均匀挑 9/16 帧拼成一张图 |
+| `sheet <BV> [--grid 3x3]` | 均匀挑帧拼成一张图（只支持 `3x3` / `4x4`，默认 9 帧） |
 | `substrip <BV> [--step 秒]` | 底部字幕竖拼成一张图 |
 | `danmaku <BV>` | 弹幕热区（按时间桶统计峰值） |
 | `search <关键词> [--days 3]` | 搜视频 |
@@ -169,20 +171,20 @@ AI 字幕（需登录）
 | `BILI_WATCH_PROJ` | ASR/OCR 环境目录（默认插件 `deps/`） |
 | `BILI_WATCH_FFMPEG` | ffmpeg 可执行文件路径 |
 | `BILI_WATCH_YTDLP` | yt-dlp 可执行文件路径 |
-| `BILI_WATCH_SEEN` | `seen.md` 去重文件路径（默认 `deps/seen.md`） |
+| `BILI_WATCH_SEEN` | `seen.md` 去重文件路径（默认 `deps/seen.md`）。文件不存在时 `--mark-seen` 记不了，先建一个空文件即可 |
 
 ## 成本
 
-- 字幕一次请求，最省。
+- 字幕接口带一次重试；`text` 最多次试两次（先匿名、有凭证再试一次）。
 - 抽帧会下载视频（360p）并跑 ffmpeg。`--step` 调低抽帧频率，脚本另外限了 `-threads 2`。
-- 九宫格和字幕带把多帧压成一张图，省 token。
+- 拼图和字幕带把多帧压成一张图，省 token。
 
 ## 限制与风险
 
 - **不支持**：点赞、评论、发弹幕、留观看历史；B 站侧只读。本机会写登录凭证、抽帧缓存与 `seen.md` 去重文件。
 - **只支持 B 站与 yt-dlp 能下的站点**；`peek` / `sub` / `comments` / `danmaku` / `sheet` / `substrip` / `ocr` 仅限 B 站。
 - **凭证**：等同账号登录态，泄露即被盗。只存本机，不进日志。
-- **频率**：正常看几条没问题；批量扫几百条会触发风控。
+- **频率**：脚本没有硬限速（只在字幕重试时随机等几百毫秒）；批量跑请自己加 sleep，别连着扫。
 - **任意 http(s) 地址都会被请求**：通用 URL 走 yt-dlp 时不做内网地址过滤，别拿它请求内网服务。
 
 ## 许可

package/index.js

@@ -14,7 +14,14 @@ import { appendFileSync, existsSync, readFileSync, readdirSync, rmSync, statSync
 import { tmpdir } from 'node:os'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
-import { defineTool } from '@deepseek-ai/dsh-tools'
+// @deepseek-ai/dsh-tools 是可选 peer：桌面版 autoInstallPeers:false，市场安装时不会自动装上。
+// 缺了只少一个 bili_watch 工具，/bili 命令、插件面板与路由照常工作，不能因此整块加载失败。
+let defineTool = null
+try {
+  ({ defineTool } = await import('@deepseek-ai/dsh-tools'))
+} catch {
+  defineTool = null
+}
 import QRCode from 'qrcode'
 
 const HERE = dirname(fileURLToPath(import.meta.url))
@@ -565,6 +572,7 @@ function apply(ctx) {
   // ② 同名工具：模型可调，需要看视频时自己来，不依赖用户敲命令
   //    必须用 defineTool 包一层：ctx.tools.register 收的是编译好的 tool 对象，
   //    直接传 options 会让发往模型的 parameters 变成 null（报 INVALID_REQUEST: schema must be type "object"）。
+  if (defineTool) {
   ctx.tools.register(defineTool({
     name: 'bili_watch',
     description:
@@ -643,6 +651,9 @@ function apply(ctx) {
       return { ok: r.ok, text: r.text }
     },
   }))
+  } else {
+    console.warn('[dsh-bili-watch] 未找到 @deepseek-ai/dsh-tools，bili_watch 工具未注册（/bili 命令与插件面板不受影响）')
+  }
 
   // ③ 设置页：读盘状态 + 清缓存（只读优先；唯一写操作是删本机抽帧缓存目录）
   try {

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-bili-watch",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "private": false,
-  "description": "Bilibili video reader for DSH: subtitles, ASR, frame OCR, comments, danmaku.",
+  "description": "Reads Bilibili (and generic URLs via yt-dlp) into text for DSH agents: search, hot, metadata, comments, danmaku, AI subtitles, local ASR, frame OCR.",
   "type": "module",
   "main": "index.js",
   "bin": {