dsh-bili-watch 0.2.5 → 0.2.7

package/README.md

@@ -25,7 +25,7 @@ dsh plugin --profile web add dsh-bili-watch
 
 插件依赖 DSH 自带的 `@deepseek-ai/dsh-tools`（peer，optional）。profile 里缺这个包时 `index.js` 会报 `ERR_MODULE_NOT_FOUND`，先补装再重启。
 
-插件尚未收录到插件市场，目前只能按上面的命令装。
+插件市场已收录（2026-10-21）：在市场里搜 `dsh-bili-watch` 直接安装，这是最省事的方式；市场里暂时搜不到时，按上面的命令装。
 
 ### 只当命令行工具
 
@@ -47,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`。

package/client.js

@@ -364,22 +364,102 @@ window.__ModuleLoader__.load({
       )
     }
 
+    // 缺依赖横幅（shell.overlay）
+    function OverlayBanner() {
+      const [st, setSt] = React.useState(null)
+      const [visible, setVisible] = React.useState(false)
+      const [dismissed, setDismissed] = React.useState(false)
+
+      React.useEffect(() => {
+        jget('/status').then((j) => {
+          if (!j.ok) return
+          setSt(j.data)
+          const missing = (j.data.deps || []).filter((d) => !d.ok)
+          if (missing.length > 0 && j.data.ui?.hintDismissed !== true) {
+            setVisible(true)
+          }
+        }).catch(() => {})
+      }, [])
+
+      if (!visible || dismissed) return null
+      const missing = (st?.deps || []).filter((d) => !d.ok)
+      const names = missing.map((d) => d.name).join('、')
+
+      return h('div', { 'data-bl-overlay': '' },
+        h('span', { 'data-bl-overlay-text': '' }, `bili-watch 还缺 ${missing.length} 个依赖（${names}）`),
+        h('button', { 'data-bl-btn': 'primary', onClick: async () => { await jpost('/download', { target: 'all' }) } }, '去安装'),
+        h('button', { 'data-bl-btn': '', onClick: () => setDismissed(true) }, '×'),
+        h('button', { 'data-bl-btn': '', onClick: async () => {
+          await jpost('/config', { hintDismissed: true })
+          setDismissed(true)
+        } }, '不再提示'),
+      )
+    }
+
+    // 启用指引（plugins.bundle.activation）
+    function ActivationGuide() {
+      const [seen, setSeen] = React.useState(false)
+      React.useEffect(() => {
+        jget('/status').then((j) => {
+          if (j.ok && j.data.ui?.activationSeen === true) setSeen(true)
+        }).catch(() => {})
+      }, [])
+      if (seen) return null
+      return h('div', { 'data-bl-activation': '' },
+        h('div', { 'data-bl-title': '' }, 'B站看视频插件已启用'),
+        h('div', { 'data-bl-note': '' }, '用它之前建议先装依赖：ffmpeg（抽帧/取音轨）、转写模型（本地转写）。没装也能用：元数据、评论、弹幕、搜索、热榜。'),
+        h('div', { 'data-bl-row': '' },
+          h('button', { 'data-bl-btn': 'primary', onClick: async () => { await jpost('/download', { target: 'all' }) } }, '去安装'),
+          h('button', { 'data-bl-btn': '', onClick: async () => {
+            await jpost('/config', { activationSeen: true })
+            setSeen(true)
+          } }, '先不装')),
+      )
+    }
+
     return {
       inject: ['slots'],
       apply(ctx) {
         const style = document.createElement('style')
         style.setAttribute('data-plugin-css', 'dsh-bili-watch')
-        style.textContent = CSS
+        style.textContent = CSS + `
+[data-bl-overlay]{position:fixed;top:0;left:0;right:0;z-index:9999;display:flex;align-items:center;gap:12px;padding:8px 16px;background:var(--dsw-alias-bg-strong,#2d2d2d);color:var(--dsw-alias-label-primary,#e5e7eb);font-size:13px;box-shadow:0 2px 8px rgba(0,0,0,.3);}
+[data-bl-overlay-text]{flex:1;}
+[data-bl-activation]{display:flex;flex-direction:column;gap:8px;padding:12px;border:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.18));border-radius:8px;background:var(--dsw-alias-bg2,rgba(255,255,255,.04));}
+`
         document.head.appendChild(style)
         if (typeof ctx.effect === 'function') ctx.effect(() => () => style.remove(), 'dsh-bili-watch: 面板样式')
 
         const slots = (typeof ctx.get === 'function' ? ctx.get('slots') : undefined) || ctx.slots
         if (!slots) return
-        // 插件详情页的配置区：key 用包名，按包页面 dispatch（见 Slot 清单 plugins.bundle.config）
+
+        // ① 插件详情页配置区（原有）
         slots.inject('plugins.bundle.config', () => slots.register(
           { name: 'plugins.bundle.config', key: PKG },
           Panel,
         ))
+
+        // ② 启用指引（用户从插件列表点「启用」后渲染）
+        slots.inject('plugins.bundle.activation', () => slots.register(
+          { name: 'plugins.bundle.activation', key: PKG },
+          ActivationGuide,
+        ))
+
+        // ③ 缺依赖横幅（全页浮层）
+        slots.inject('shell.overlay', () => slots.register(
+          { name: 'shell.overlay', key: PKG },
+          OverlayBanner,
+        ))
+
+        // ④ 设置页双面板（读 showInSettings 决定是否注册）
+        jget('/status').then((j) => {
+          if (j.ok && j.data.ui?.showInSettings !== false) {
+            slots.inject('settings.section', () => slots.register(
+              { name: 'settings.section', key: PKG, title: '刷B站' },
+              Panel,
+            ))
+          }
+        }).catch(() => {})
       },
     }
   },

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))
@@ -38,6 +45,21 @@ const FFMPEG_CANDS = [
 const HF_HOME = [join(DEPS, '.hf-home'), join(PROJ, '.hf-home')]
 const SCRIPTS = join(HERE, 'scripts')
 const CACHE_CFG = join(DEPS, 'cache-config.json')
+const UI_CFG = join(DEPS, 'ui-config.json')
+const DEFAULT_UI_CFG = { hintDismissed: false, activationSeen: false, showInSettings: true }
+
+function uiCfg() {
+  try {
+    const raw = JSON.parse(readFileSync(UI_CFG, 'utf8'))
+    return { ...DEFAULT_UI_CFG, ...raw }
+  } catch { return { ...DEFAULT_UI_CFG } }
+}
+function writeUiCfg(patch) {
+  const cur = uiCfg()
+  const next = { ...cur, ...patch }
+  writeFileSync(UI_CFG, JSON.stringify(next, null, 2), 'utf8')
+  return next
+}
 const DEFAULT_CACHE_DAYS = 7
 const DEFAULT_CACHE_MAX_MB = 2048
 const DOWNLOAD_LOG = join(DEPS, 'download.log')
@@ -565,6 +587,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 +666,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 {
@@ -663,6 +689,7 @@ function apply(ctx) {
                     deps: depRows(),
                     cache: { ...dirStat(CACHE), ...cacheCfg(), lastAutoClean: cleaned },
                     lastRun: readLastRun(),
+                    ui: uiCfg(),
                   },
                 })
               }
@@ -703,6 +730,15 @@ function apply(ctx) {
                 if (r.state === 'ok') writeLastRun('login', 0)
                 return sendJson(res, 200, r)
               }
+              if (req.method === 'POST' && url.pathname === '/api/bili-watch/config') {
+                const body = await readJsonBody(req)
+                const patch = {}
+                if (typeof body?.hintDismissed === 'boolean') patch.hintDismissed = body.hintDismissed
+                if (typeof body?.activationSeen === 'boolean') patch.activationSeen = body.activationSeen
+                if (typeof body?.showInSettings === 'boolean') patch.showInSettings = body.showInSettings
+                const next = writeUiCfg(patch)
+                return sendJson(res, 200, { ok: true, data: next })
+              }
               sendJson(res, 404, { ok: false, why: 'not found' })
             } catch (e) {
               sendJson(res, 500, { ok: false, why: String(e?.message || e) })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-bili-watch",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "private": false,
   "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",