dsh-baleen 0.1.0 → 0.2.0

package/client.js

@@ -234,6 +234,16 @@ window.__ModuleLoader__.load({
           ...(typeof newFolder === 'string' && newFolder.trim() ? { new_folder: newFolder.trim() } : {})
         }),
         folderOp: (action, { id, name } = {}) => post('/folder', { action, ...(id != null ? { id } : {}), ...(name != null ? { name } : {}) }),
+        // 「浏览器打开」走宿主侧 /open：面板只报条目 id，URL 由宿主从库里取（终审真修——
+        // 本宿主把客户端页面的弹窗与外链全部静默拦下，window.open 与 <a target=_blank> 都到不了系统浏览器）。
+        openItem: (itemId) => post('/open', { item_id: itemId }),
+        // 「抓取正文」：面板→宿主的补抓路由（只报条目 id，抓哪条、抓成什么样由宿主定），
+        // 不是 agent 工具——判断那一轮的只读面里没有它。
+        fulltext: (itemId) => post('/fulltext', { item_id: itemId }),
+        // 小红书（M6）：登录态探活与扫码登录。都是面板→宿主路由，不进 agent 工具面。
+        // 状态探活会按需拉起 MCP 子进程，所以是手动按钮触发而非挂载即打。
+        xhsStatus: () => plainGet('/xhs-status'),
+        xhsLoginQr: () => plainGet('/xhs-login-qr'),
         /* 设置页（settings.section）的取数与动作：GET 走 plainGet（不碰共享快照），写走 post/put */
         preferenceGet: () => plainGet('/preference'),
         preferencePut: (section, value) => put('/preference', { section, value }),
@@ -320,6 +330,21 @@ window.__ModuleLoader__.load({
      */
     const judgeHint = '对会话说一句「把今天的候选判一下」'
 
+    /**
+     * 只认 http/https 的绝对地址，其余（空、非字符串、别的协议、javascript:）一律 null。
+     * 库里 url/thumb 都是平台给的原样字段，直接塞进 href/src 等于把外来的字符串当可执行入口。
+     */
+    function httpUrl(v) {
+      const s = typeof v === 'string' ? v.trim() : ''
+      return /^https?:\/\//i.test(s) ? s : null
+    }
+
+    /**
+     * 封面地址：和链接同一套判定。视图拿它决定画不画 <img>——坏值不许变成
+     * "空 src 的裂图标"，那比灰占位更难看也更可疑。
+     */
+    const thumbSrc = (thumb) => httpUrl(thumb)
+
     // ---- src/client/css.js ----
     /**
      * 面板样式。**这份 CSS 里一个颜色字面量都没有**：所有颜色都从宿主 token 取，
@@ -347,9 +372,11 @@ window.__ModuleLoader__.load({
     .bl-issues{display:flex;flex-direction:column;gap:4px;font-size:12px;color:var(--dsw-alias-state-error-primary)}
     .bl-pending{font-size:12px;color:var(--dsw-alias-label-secondary)}
     .bl-actions{display:flex;gap:8px;margin:10px 0 2px}
-    .bl-actions button,.bl-detail{appearance:none;font-family:inherit;font-size:12px;min-height:32px;padding:5px 11px;border-radius:7px;border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-label-primary);cursor:pointer}
-    .bl-actions button:hover,.bl-detail:hover{background:var(--dsw-alias-interactive-bg-hover)}
-    .bl-actions button:disabled{color:var(--dsw-alias-label-dimmed);cursor:progress}
+    .bl-actions button,.bl-detail,.bl-fetch{appearance:none;font-family:inherit;font-size:12px;min-height:32px;padding:5px 11px;border-radius:7px;border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-label-primary);cursor:pointer}
+    .bl-actions button:hover,.bl-detail:hover,.bl-fetch:hover{background:var(--dsw-alias-interactive-bg-hover)}
+    .bl-actions button:disabled,.bl-fetch:disabled{color:var(--dsw-alias-label-dimmed);cursor:progress}
+    /* 「抓取正文」是这一屏唯一会出去抓东西的按钮，给个品牌色边框让它站得出来（仍走宿主 token） */
+    .bl-fetch{border-color:var(--dsw-alias-brand-primary);color:var(--dsw-alias-brand-primary);align-self:flex-start}
     .bl-today,.bl-video,.bl-article,.bl-digest{display:flex;flex-direction:column;gap:8px;min-width:0}
     .bl-rail{margin-top:18px;min-width:0}
     .bl-rail h3{font-size:13px;font-weight:500;margin:0 0 8px;color:var(--dsw-alias-label-primary)}
@@ -361,20 +388,25 @@ window.__ModuleLoader__.load({
     .bl-grid{display:grid;grid-template-columns:repeat(auto-fill, minmax(260px, 1fr));gap:12px;min-width:0}
     .bl-card,.bl-row{appearance:none;text-align:left;font-family:inherit;color:inherit;background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:9px 10px;cursor:pointer;display:flex;flex-direction:column;gap:5px;min-height:32px;min-width:0}
     .bl-card:hover,.bl-row:hover,.bl-row[aria-selected="true"]{background:var(--dsw-alias-bg-layer-2);border-color:var(--dsw-alias-border-l2)}
-    .bl-card:focus-visible,.bl-row:focus-visible,.bl-navitem:focus-visible,.bl-actions button:focus-visible,.bl-detail:focus-visible,.bl-dbtns button:focus-visible,.bl-dbar button:focus-visible,.bl-facets input:focus-visible,.bl-collect input:focus-visible,.bl-newfolder input:focus-visible,.bl-newfolder button:focus-visible,.bl-toolbar button:focus-visible,.bl-foldertab:focus-visible,.bl-confirm button:focus-visible,.bl-setsave:focus-visible,.bl-setflag input:focus-visible,.bl-srcrow-head button:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:2px}
+    .bl-card:focus-visible,.bl-row:focus-visible,.bl-navitem:focus-visible,.bl-actions button:focus-visible,.bl-detail:focus-visible,.bl-dbtns button:focus-visible,.bl-dbar button:focus-visible,.bl-facets input:focus-visible,.bl-collect input:focus-visible,.bl-newfolder input:focus-visible,.bl-newfolder button:focus-visible,.bl-toolbar button:focus-visible,.bl-foldertab:focus-visible,.bl-openbtns button:focus-visible,.bl-url:focus-visible,.bl-confirm button:focus-visible,.bl-setsave:focus-visible,.bl-setflag input:focus-visible,.bl-srcrow-head button:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:2px}
     .bl-card-title,.bl-row-title{font-size:13px;line-height:1.4;color:var(--dsw-alias-label-primary)}
     .bl-card-meta,.bl-row-meta{font-size:11px;color:var(--dsw-alias-label-tertiary);display:flex;gap:6px;flex-wrap:wrap}
     .bl-why,.bl-row-why{font-size:12px;color:var(--dsw-alias-label-secondary);border-left:2px solid var(--dsw-alias-border-l2);padding-left:7px;margin-top:auto}
     .bl-tier{font-size:11px;color:var(--dsw-alias-label-primary)}
     .bl-play{font-size:11px;color:var(--dsw-alias-label-dimmed)}
-    .bl-thumb{position:relative;aspect-ratio:16/9;border-radius:6px;background:var(--dsw-alias-bg-layer-3);display:block}
+    .bl-thumb{position:relative;aspect-ratio:16/9;border-radius:6px;background:var(--dsw-alias-bg-layer-3);display:block;overflow:hidden}
+    .bl-thumb img{width:100%;height:100%;object-fit:cover;display:block}
     .bl-dur{position:absolute;right:5px;bottom:5px;font-size:11px;padding:1px 5px;border-radius:4px;background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-secondary)}
     .bl-two{display:grid;grid-template-columns:minmax(0,1fr) minmax(0,1.1fr);gap:14px;align-items:start;min-width:0}
     .bl-list{display:flex;flex-direction:column;gap:8px;min-width:0}
-    .bl-reader{background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:13px 15px;min-height:200px;min-width:0;display:flex;flex-direction:column;gap:8px}
-    .bl-reader h4{margin:0;font-size:13px;font-weight:500;line-height:1.4;color:var(--dsw-alias-label-primary)}
+    .bl-reader{background:var(--dsw-alias-bg-layer-1);border:1px solid var(--dsw-alias-border-l1);border-radius:8px;padding:16px 18px;min-height:200px;min-width:0;display:flex;flex-direction:column;gap:9px}
+    .bl-reader h4{margin:0;font-size:15px;font-weight:500;line-height:1.45;color:var(--dsw-alias-label-primary)}
     .bl-reader-by,.bl-reader-hint,.bl-reader-link{font-size:11px;color:var(--dsw-alias-label-secondary);margin:0}
-    .bl-reader-body{font-size:13px;white-space:pre-wrap;word-break:break-word;color:var(--dsw-alias-label-primary)}
+    /* 阅读排版（护眼三件事）：14px/1.8 的中文长文才读得动；行长封顶 42em（约 42 个汉字，
+       超过就得转头）；空行成段、段间 0.75em，段内单换行原样保留（字幕逐行紧排靠它）。
+       限宽只落在文字本身，阅读卡照常填满栏宽——不碰「容器不许限宽」的那条规矩。 */
+    .bl-reader-body{font-size:14px;line-height:1.8;white-space:pre-wrap;word-break:break-word;color:var(--dsw-alias-label-primary);max-width:42em;display:flex;flex-direction:column;gap:0.75em}
+    .bl-reader-body p{margin:0}
     .bl-library{display:grid;grid-template-columns:150px minmax(0,1fr);gap:14px;align-items:start;min-width:0}
     .bl-library-body{display:flex;flex-direction:column;gap:10px;min-width:0}
     .bl-facets{display:flex;flex-direction:column;gap:12px;font-size:12px;min-width:0}
@@ -406,7 +438,7 @@ window.__ModuleLoader__.load({
     .bl-dmain{padding:12px 14px;display:flex;flex-direction:column;gap:11px;overflow-y:auto;font-size:12px;min-width:0}
     .bl-dmain section{display:flex;flex-direction:column;gap:4px}
     .bl-dmain h5{margin:0 0 3px;font-size:11px;font-weight:500;color:var(--dsw-alias-label-tertiary)}
-    .bl-dmain p{margin:0;word-break:break-word;color:var(--dsw-alias-label-primary)}
+    .bl-dmain p{margin:0;word-break:break-word;color:var(--dsw-alias-label-primary);line-height:1.65}
     .bl-kv{display:flex;gap:8px;flex-wrap:wrap;font-size:11px;color:var(--dsw-alias-label-secondary)}
     .bl-missing{color:var(--dsw-alias-state-error-primary)}
     .bl-collect{display:flex;flex-wrap:wrap;gap:2px 12px;font-size:12px}
@@ -420,7 +452,36 @@ window.__ModuleLoader__.load({
     .bl-newfolder button:hover{background:var(--dsw-alias-interactive-bg-hover)}
     .bl-newfolder button:disabled{color:var(--dsw-alias-label-dimmed);cursor:progress}
     .bl-kw{font-size:11px;color:var(--dsw-alias-label-secondary)}
-    .bl-url{font-size:12px;color:var(--dsw-alias-brand-primary);word-break:break-all}
+    .bl-url{font-size:12px;color:var(--dsw-alias-brand-primary);word-break:break-all;text-decoration:underline}
+    /* 内嵌播放器（V5）与侧栏播放（M7）共用一套舞台。宿主不拦 iframe（真机实证），
+       bilibili 试图跳出顶层会被 Chromium 自己拦下，无需 sandbox（加了反而杀播放器脚本） */
+    .bl-player{display:block;width:100%;border:0;background:var(--dsw-alias-bg-layer-2)}
+    /* 舞台：裁切窗与 16:9 视频面等大（aspect-ratio 跟容器宽度走），不再是写死的像素对——
+       早先 360px 窗 + 900px iframe，窄容器漏推荐流、宽容器把 B 站控制条（音量在那）裁出窗外。
+       YouTube embed 本来就是纯 16:9 播放器，窗口精确合围即止。
+       B 站是完整页，实测（无头 Edge 量四档宽度，见 docs/verification.md）：视频面恒为
+       ~660x371（版心固定；容器再宽只是右侧多出推荐列，更窄则横向溢出），页头到视频顶
+       ~170px。所以 iframe 恒定 660 虚拟宽（永不进"播放器+推荐列"的宽版式）、按容器宽
+       等比缩放（tan(atan2()) 是 CSS 做长度除法的既定写法，Chromium 111+；宿主是 2026 年
+       的 Electron，Chromium 远新于此，不支持的老引擎会退化成"页头占掉窗口"的坏样子，
+       那不是可支持的配置），页头偏移同比上移——任何宽度下视频都精确 16:9 填满
+       窗口、控制条（音量）完整在窗内、页头/推荐流/弹幕侧栏都推出窗外。两个常数是真机
+       待校值，平台改版错位的退路仍是设置页「裁掉推荐区」开关。 */
+    .bl-stage{--bl-nav:170px;--bl-frame:660px;container-type:inline-size;width:100%;overflow:hidden;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;background:var(--dsw-alias-bg-layer-2)}
+    .bl-stage-crop{aspect-ratio:16/9}
+    .bl-stage>.bl-player{border-radius:0}
+    .bl-stage:not(.bl-stage-crop)>.bl-player{height:640px}
+    .bl-stage-crop>.bl-player{height:100%}
+    .bl-stage-bili>.bl-player{--bl-scale:tan(atan2(100cqw, var(--bl-frame)));width:var(--bl-frame);height:calc(var(--bl-nav) + var(--bl-frame) * 0.5625);margin-top:calc(var(--bl-nav) * var(--bl-scale) * -1);transform:scale(var(--bl-scale));transform-origin:0 0}
+    /* 内层全屏（播放器自己的全屏键）把宿主 iframe 提成 :fullscreen——把缩放与偏移还原，
+       不然全屏画面缩在角落 */
+    .bl-player:fullscreen{width:100%;height:100%;margin-top:0;transform:none}
+    .bl-tab{padding:8px;display:flex;flex-direction:column;gap:6px}
+    .bl-tab-head{display:flex;align-items:center;gap:8px;min-width:0;margin:0}
+    .bl-tab-title{flex:1;min-width:0;font-size:12px;color:var(--dsw-alias-label-primary);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+    .bl-openbtns{display:flex;gap:8px;flex-wrap:wrap;margin-top:4px}
+    .bl-openbtns button{appearance:none;font-family:inherit;font-size:12px;min-height:32px;padding:5px 11px;border-radius:7px;border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-label-primary);cursor:pointer;white-space:nowrap}
+    .bl-openbtns button:hover{background:var(--dsw-alias-interactive-bg-hover)}
     .bl-feedback{margin:0;padding:7px 14px;font-size:12px;background:var(--dsw-alias-bg-layer-2);border-top:1px solid var(--dsw-alias-border-l1);color:var(--dsw-alias-label-primary)}
     .bl-dbtns{display:flex;gap:8px;padding:11px 14px;border-top:1px solid var(--dsw-alias-border-l1)}
     .bl-dbtns button{flex:1;appearance:none;font-family:inherit;font-size:12px;min-height:32px;border-radius:7px;border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-label-primary);cursor:pointer}
@@ -442,6 +503,8 @@ window.__ModuleLoader__.load({
     .bl-setsave{appearance:none;font-family:inherit;font-size:12px;min-height:32px;padding:5px 11px;border-radius:7px;border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-label-primary);cursor:pointer;align-self:flex-start}
     .bl-setsave:hover{background:var(--dsw-alias-interactive-bg-hover)}
     .bl-setsave:disabled{color:var(--dsw-alias-label-dimmed);cursor:progress}
+    /* 小红书扫码二维码（M6）：PNG 自带白底（QR 可读性在图里），尺寸固定不参与伸缩 */
+    .bl-xhsqr{width:180px;height:180px;padding:8px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px}
     .bl-setflag{display:flex;gap:6px;align-items:center;flex-wrap:wrap;min-height:32px;font-size:12px;color:var(--dsw-alias-label-secondary);cursor:pointer}
     .bl-setflag:hover{color:var(--dsw-alias-label-primary)}
     .bl-setflag input{width:14px;height:14px;flex:none;cursor:pointer;accent-color:var(--dsw-alias-brand-primary)}
@@ -583,7 +646,10 @@ window.__ModuleLoader__.load({
 
     function Card({ item, onOpen }) {
       return vnode('button', { type: 'button', className: 'bl-card', onClick: () => onOpen?.(item.id) }, [
-        item.kind === 'video' ? vnode('span', { className: 'bl-thumb' }, [vnode('span', { className: 'bl-dur' }, [fmtDuration(item.duration_sec) || '—'])]) : null,
+        item.kind === 'video' ? vnode('span', { className: 'bl-thumb' }, [
+          thumbSrc(item.thumb) ? vnode('img', { src: thumbSrc(item.thumb), alt: '', loading: 'lazy' }) : null,
+          vnode('span', { className: 'bl-dur' }, [fmtDuration(item.duration_sec) || '—'])
+        ].filter(Boolean)) : null,
         vnode('span', { className: 'bl-card-title' }, [item.title || '（无标题）']),
         vnode('span', { className: 'bl-card-meta' }, [item.source_id, item.kind === 'note' ? '图文笔记' : item.kind === 'video' ? '视频' : '文章']),
         vnode('span', { className: 'bl-tier' }, [item.verdict_tier ? `已判：${item.verdict_tier}` : '待判']),
@@ -658,7 +724,10 @@ window.__ModuleLoader__.load({
 
     function VideoCard({ item, onOpen }) {
       return vnode('button', { type: 'button', className: 'bl-card', key: item.id, onClick: () => onOpen?.(item.id) }, [
-        vnode('span', { className: 'bl-thumb' }, [vnode('span', { className: 'bl-dur' }, [fmtDuration(item.duration_sec) || '—'])]),
+        vnode('span', { className: 'bl-thumb' }, [
+          thumbSrc(item.thumb) ? vnode('img', { src: thumbSrc(item.thumb), alt: '', loading: 'lazy' }) : null,
+          vnode('span', { className: 'bl-dur' }, [fmtDuration(item.duration_sec) || '—'])
+        ].filter(Boolean)),
         vnode('span', { className: 'bl-card-title' }, [item.title || '（无标题）']),
         vnode('span', { className: 'bl-card-meta' }, [
           item.author || item.source_id,
@@ -666,9 +735,9 @@ window.__ModuleLoader__.load({
         ]),
         vnode('span', { className: 'bl-tier' }, [item.verdict_tier ? `${item.verdict_tier}：${item.verdict_why || '（这条没写理由）'}` : '待判']),
         vnode('span', { className: 'bl-why' }, [reasonOf(item)]),
-        // M4a 裁定：内嵌播放器 V5 才评估，哪个平台都还没法在抽屉里播——卡片统一只说跳转，
-        // 不许再对 B 站单独许诺"可在抽屉内播"（抽屉的能力边界同一时刻在说反话）。
-        vnode('span', { className: 'bl-play' }, ['只能跳转'])
+        // 尾标必须与抽屉的能力边界一致：能解析出嵌入形态的（B 站 BV / YouTube）就是"抽屉里能播"，
+        // 解析不出的（b23.tv 短链、别的平台）才写"只能跳转"。
+        vnode('span', { className: 'bl-play' }, [playerEmbed(item.url) ? '抽屉里能播' : '只能跳转'])
       ])
     }
 
@@ -712,6 +781,8 @@ window.__ModuleLoader__.load({
       missing: '读不到内容（没有语音，也没抓到正文）',
       burned_in: '硬字幕读不到（字烧在画面上，不是插件偷懒）'
     }
+    /** 已经有正文的那几种：再摆一颗「抓取正文」就是假动作——点了也不会变，反倒让人怀疑是没生效 */
+    const HAS_BODY = new Set(['full', 'subtitle', 'transcribed'])
     const STATE_OPTIONS = [
       ['full', '全文'], ['summary_only', '仅摘要'], ['subtitle', '字幕'],
       ['transcribed', '转写'], ['missing', '读不到'], ['burned_in', '硬字幕']
@@ -732,10 +803,30 @@ window.__ModuleLoader__.load({
       return typeof t === 'string' ? t.trim() : ''
     }
 
-    function ArticleView({ items = [], filters = {}, selectedId, onFilter, onSelect, onOpen }) {
+    /**
+     * 正文分段：空行（\n{2,}）是段界，段内单换行原样保留。一条规则服务两种内容——
+     * 文章有真实段距，字幕逐行紧排不被拆散（行间的单换行交给 CSS pre-wrap 折行）。
+     * 先把 \r\n / \r 归一成 \n：Windows 作者的 feed 里段界是 \r\n\r\n，两个 \n 被
+     * \r 隔开就永远凑不成"连续两个换行"，分段会静默失效。空白/非字符串返回空数组，
+     * 调用方给占位句。
+     */
+    function readerParagraphs(text) {
+      const s = typeof text === 'string' ? text.replace(/\r\n?/g, '\n') : ''
+      return s.split(/\n{2,}/).map((p) => p.trim()).filter(Boolean)
+    }
+
+    /** 右栏当前是哪一条：选中项被筛掉时回落第一条。视图与装配层共用这一条规则，
+     *  否则「正在抓的是哪条」会跟右栏画的那条各算一遍，忙态就贴到别人身上。 */
+    function currentArticle(items, filters = {}, selectedId) {
       const list = visibleArticles(items, filters)
-      const cur = list.find((i) => i.id === selectedId) ?? list[0] ?? null
+      return list.find((i) => i.id === selectedId) ?? list[0] ?? null
+    }
+
+    function ArticleView({ items = [], filters = {}, selectedId, onFilter, onSelect, onOpen, onFulltext, fetching = false }) {
+      const list = visibleArticles(items, filters)
+      const cur = currentArticle(items, filters, selectedId)
       const body = cur ? readableBody(cur) : ''
+      const paras = readerParagraphs(body)
       const sources = [...new Set(items.filter((i) => i.kind !== 'video').map((i) => i.source_id))]
 
       return vnode('div', { className: 'bl-article' }, [
@@ -771,8 +862,20 @@ window.__ModuleLoader__.load({
               Number(cur.time_estimated) > 0 ? `约 ${Math.round(Number(cur.time_estimated))} 分钟` : ''
             ]),
             STATE_HINT[cur.body_state] ? vnode('p', { className: 'bl-reader-hint' }, [STATE_HINT[cur.body_state]]) : null,
-            vnode('div', { className: 'bl-reader-body' }, [body || '（没有正文，只能看原文）']),
+            vnode('div', { className: 'bl-reader-body' },
+              paras.length ? paras.map((p, i) => vnode('p', { key: i }, [p])) : ['（没有正文，只能看原文）']),
             vnode('p', { className: 'bl-reader-link' }, ['读原文：' + (cur.url || '（这条没带链接）')]),
+            // 已经有正文的（full/subtitle/transcribed）不画这颗按钮：点了也不会有新东西，
+            // 摆在那儿只会让人把手里已经有的正文再怀疑一遍。
+            HAS_BODY.has(cur.body_state) ? null : vnode('button', {
+              type: 'button', className: 'bl-fetch', disabled: Boolean(fetching),
+              onClick: () => onFulltext?.(cur.id)
+            }, [fetching ? '正在抓取…' : '抓取正文']),
+            // 这句不是内容说明（那句在 STATE_HINT 里），是这颗按钮的预期管理：抓不到是常态，
+            // 别让人点完一次就以为插件坏了。
+            cur.body_state === 'summary_only'
+              ? vnode('p', { className: 'bl-reader-hint' }, ['只拿到摘要。点上面的按钮去原文抓一次正文；抓不到就还是看原文。'])
+              : null,
             vnode('button', { type: 'button', className: 'bl-detail', onClick: () => onOpen?.(cur.id) }, ['详情与反馈'])
           ].filter(Boolean) : [
             vnode('p', { className: 'bl-empty' }, ['左边没有条目。多半是这个筛选太窄，或者这一轮还没抓到东西。'])
@@ -929,12 +1032,56 @@ window.__ModuleLoader__.load({
      * 早先只回一句的话，B 站硬字幕条目会被播放器的说法盖掉，看不出内容其实读不到。
      * 播放器 M4a 没做（V5 先探后定），所以这里不许预告任何接入时间——跳转就是现状。
      */
+    /**
+     * 内嵌播放器（V5 真机实证 2026-11-01：面板页 iframe 不被宿主 CSP 拦）。
+     * B 站=完整页 iframe（bilibili 试图跳出顶层会被 Chromium 自动拦，实测无害；
+     * 官方 player.html 反而是空壳）；YouTube=官方 embed，带 rel=0——播完不出
+     * 相关视频网格，跟"不让你顺着推荐刷下去"是同一条产品意图。作者关了嵌入的
+     * 视频会显示 YouTube 自己的提示，此时走「浏览器打开」。其余平台返回 null。
+     */
+    function playerEmbed(url) {
+      const s = String(url ?? '')
+      const bili = /bilibili\.com\/video\/(BV[0-9A-Za-z]+)/.exec(s)
+      if (bili) return { kind: 'bili', src: 'https://www.bilibili.com/video/' + bili[1] }
+      const yt = /[?&]v=([0-9A-Za-z_-]{11})/.exec(s) || /youtu\.be\/([0-9A-Za-z_-]{11})/.exec(s)
+      if (yt && /youtube\.com|youtu\.be/.test(s)) return { kind: 'youtube', src: 'https://www.youtube.com/embed/' + yt[1] + '?rel=0' }
+      return null
+    }
+
+    /**
+     * 播放器舞台：抽屉与侧栏 tab 共用这一份标记、同一套 .bl-stage* 样式。
+     * 裁切窗跟着容器宽度走（aspect-ratio 16:9 = 视频面本来的形状），不再是写死的
+     * 像素对——窄容器漏推荐流、宽容器把 B 站控制条（音量在那）裁出窗外，都是固定值惹的。
+     * B 站是完整页，多带一个 bl-stage-bili 让 CSS 做版心缩放 + 页头偏移（css.js 的
+     * --bl-frame/--bl-nav）；YouTube embed 本来就是纯 16:9 播放器，精确合围即止。
+     * 裁切模式给 iframe 加 scrolling=no：内页滚不动，推荐流连滚出来的机会都没有；
+     * 还原模式（crop=false）保留滚动——那本来就是"看完整页"的路。
+     * 音量/倍速这些控件在跨源 iframe 里面，我们够不着，也不打算假装够得着——界面上明说用原播放器的。
+     */
+    function playerStage(embed, crop) {
+      const cls = ['bl-stage']
+      if (crop) cls.push('bl-stage-crop')
+      if (crop && embed.kind === 'bili') cls.push('bl-stage-bili')
+      return vnode('div', { className: cls.join(' ') }, [
+        vnode('iframe', {
+          className: 'bl-player',
+          src: embed.src,
+          title: '视频播放器',
+          allow: 'autoplay; fullscreen',
+          allowfullscreen: true,
+          scrolling: crop ? 'no' : 'auto'
+        })
+      ])
+    }
+
     function boundaryNote(item) {
       const bits = []
       if (item?.kind === 'video') {
-        bits.push(item.source_id === 'bili'
-          ? 'B 站：抽屉内嵌播放器还没定下来，现在跳到浏览器里看。'
-          : '这个平台没有可靠的嵌入方案，只能跳到浏览器里看。')
+        bits.push(playerEmbed(item?.url)
+          ? '内嵌播放器在上方，直接看；弹幕和评论区要去原站。'
+          : item.source_id === 'bili'
+            ? '这个视频的地址解析不出嵌入形态，只能跳到浏览器里看。'
+            : '这个平台没有可靠的嵌入方案，只能跳到浏览器里看。')
       }
       if (LIMITS.has(item?.body_state)) bits.push(STATE_NOTE[item.body_state])
       return bits.join(' ')
@@ -975,7 +1122,7 @@ window.__ModuleLoader__.load({
     const namesOf = (item, folders, ids) => (ids ?? []).map((id) =>
       (folders ?? []).find((f) => f.id === id)?.name ?? `#${id}（这个夹已经没了）`).join(' / ') || '（现在不在任何夹里）'
 
-    function Drawer({ item, api = {}, onClose, onDone, note, folders = [], collecting = false, newFolderName = '', onNewFolderName = () => {} }) {
+    function Drawer({ item, api = {}, onClose, onDone, note, folders = [], collecting = false, newFolderName = '', onNewFolderName = () => {}, onOpenUrl, sidebar = null }) {
       async function fire(action) {
         let res = null
         try {
@@ -1036,7 +1183,10 @@ window.__ModuleLoader__.load({
 
       const m = matchInfo(item)
       const body = typeof item.body_text === 'string' ? item.body_text.trim() : ''
+      const paras = readerParagraphs(body)
       const hasFolders = (folders ?? []).length > 0
+      const link = httpUrl(item.url)
+      const embed = playerEmbed(item.url)
 
       return vnode('aside', { className: 'bl-drawer', role: 'dialog', 'aria-label': '条目详情' }, [
         vnode('header', { className: 'bl-dbar' }, [
@@ -1064,11 +1214,24 @@ window.__ModuleLoader__.load({
           Section({
             title: item.kind === 'video' ? '字幕原文' : '正文',
             children: [
-              vnode('p', {}, [body || '（没有可读内容）']),
+              // 正文与阅读器同一条分段规则（readerParagraphs）：空行成段、单换行保留，
+              // 字幕在抽屉里也逐行可读；排版类 bl-reader-body 与文章页同一份。
+              vnode('div', { className: 'bl-reader-body' },
+                paras.length ? paras.map((p, i) => vnode('p', { key: i }, [p])) : ['（没有可读内容）']),
               STATE_NOTE[item.body_state] ? vnode('p', { className: 'bl-reader-hint' }, [STATE_NOTE[item.body_state]]) : null
             ]
           }),
           item.verdict_why ? Section({ title: '会话的判断', children: [vnode('p', {}, [`为什么判成「${item.verdict_tier}」：${item.verdict_why}`])] }) : null,
+          // 内嵌播放（V5 实证可行）：视频且能解析出嵌入形态就直接在抽屉里放，
+          // 不把人跳去平台——须鲸的初衷是"在你待着的地方看"。舞台用与侧栏 tab 同一份
+          // playerStage()：完整页 iframe 往下会带出平台的推荐流，裁掉是产品意图。
+          embed ? Section({
+            title: '内嵌播放',
+            children: [
+              playerStage(embed, true),
+              vnode('p', { className: 'bl-note' }, ['只露播放器本体，推荐流被裁掉是不想让你刷下去；音量、倍速用画面里的原播放器控件。'])
+            ]
+          }) : null,
           boundaryNote(item) ? Section({ title: '能力边界', children: [vnode('p', {}, [boundaryNote(item)])] }) : null,
           Section({
             title: '收藏到…',
@@ -1101,7 +1264,39 @@ window.__ModuleLoader__.load({
               ])
             ]
           }),
-          item.url ? Section({ title: '链接', children: [vnode('p', { className: 'bl-url' }, [item.url])] }) : null,
+          // 原文地址：真的 <a href>。早先这里是 <p>，那句话"跳到浏览器里看"等于空头支票。
+          // 地址不是 http/https 就整段不画——不拿一个点不动的假链接充数。
+          // （2026-10-31 真机验收：本宿主把客户端页面的弹窗与外链全部静默拦下，<a> 与
+          // window.open 都到不了系统浏览器——「浏览器打开」改走宿主侧 /open 路由，面板
+          // 只报条目 id、URL 由宿主从库里取。
+          // 「侧栏播放」在 0.30.1 语义下回归：面板在前台时 openTab 进 pending 队列，
+          // 会话回到前台由 better-sidebar 的 flushPending 落进右侧栏——不是死按钮，
+          // 是异步开；前提是排队语义写在按钮提示与回显里，不让人点了没反应。）
+          link ? Section({
+            title: '原文',
+            children: [
+              vnode('p', {}, [vnode('a', { className: 'bl-url', href: link, target: '_blank', rel: 'noopener noreferrer' }, [link])]),
+              vnode('div', { className: 'bl-openbtns' }, [
+                vnode('button', { type: 'button', onClick: () => onOpenUrl?.(link, item.id) }, ['浏览器打开']),
+                item.kind === 'video' && embed && sidebar?.available
+                  ? vnode('button', {
+                      type: 'button',
+                      title: '在侧栏里播这条，不去平台。面板在前台时它会先排队，切回会话页签自动出现',
+                      onClick: () => {
+                        if (sidebar.open(item.url, item.title)) {
+                          onDone?.({ message: '已请求侧栏播放——右侧栏没立刻出现的话，切回会话页签它会自动开。' })
+                        } else {
+                          onDone?.({ message: '侧栏没接住这条——先在抽屉里播，或者去浏览器打开。' })
+                        }
+                      }
+                    }, ['侧栏播放'])
+                  : null
+              ].filter(Boolean)),
+              vnode('p', { className: 'bl-note' }, [embed
+                ? '侧栏要是有会话在前台就当场开，否则先排队——切回会话页签它自动出现。'
+                : '这条解析不出嵌入形态，侧栏也播不了；要去系统浏览器就用上面的按钮。'])
+            ]
+          }) : null,
           vnode('p', { className: 'bl-note' }, ['下面两个按钮只调来源权重，不改你的主题词；当前偏移在设置页能看到也能一键归零。'])
         ]),
         note ? vnode('p', { className: 'bl-feedback', role: 'status' }, [note]) : null,
@@ -1308,7 +1503,7 @@ window.__ModuleLoader__.load({
       const s = (stateSources ?? []).find((x) => x.id === id)
       if (!s) return '还没抓过（保存后下一轮才碰它）'
       if (s.ok) return '最近抓取：正常'
-      if (s.error_class === 'needs_login') return '最近抓取：需要重新登录（去「凭据与环境」贴 cookie）'
+      if (s.error_class === 'needs_login') return '最近抓取：需要重新登录（B 站贴 cookie / 小红书扫码，都在「凭据与环境」）'
       return `最近抓取：失败（${s.error_class ?? '未知'}），游标没推进，下轮自动补`
     }
 
@@ -1556,6 +1751,15 @@ window.__ModuleLoader__.load({
         vnode('h4', {}, ['判断开关']),
         flag('require_theme_hit', '没有命中任何主题组的条目直接丢弃', '关掉后全靠预筛分与源权重，条目会多很多', pref?.require_theme_hit),
         flag('inject_prompt', '每轮把待判清单注入会话（判断轮的触发器）', '关掉能省一点上下文', pref?.inject_prompt),
+        // 正文补抓（M8）：RSS 只给摘要，开着就会回原文抓正文。关掉 = 文章永远只有 feed 给的那一句话，
+        // 面板里的「抓取正文」按钮仍能手动点（那是按条目单次触发，不受这个开关管）。
+        flag('fulltext', '文章只有摘要时，回原文抓一次正文', '关掉就不抓：文章只剩 feed 给的那一句，且不会有任何额外请求', pref?.fulltext),
+
+        // 侧栏播放（M7）：这两个开关只在装了 dsh-better-sidebar 的机器上有实际效果，
+        // 没装就是不注册侧栏 tab、面板照旧——界面上要说清，别让人以为关了它就能装出功能。
+        vnode('h4', {}, ['侧栏播放（需要 dsh-better-sidebar）']),
+        flag('sidebar_takeover', '会话里点 B 站 / YouTube 链接时，落进侧栏播放而不是系统浏览器', '关掉后这些链接照旧开去系统浏览器；侧栏 tab 本身还在，抽屉里的「侧栏播放」仍可用', pref?.sidebar_takeover),
+        flag('sidebar_crop', '侧栏播 B 站时裁掉下面的相关推荐', '平台改版导致裁切错位、把播放控制条也遮住了，就用这个还原完整页', pref?.sidebar_crop),
 
         vnode('h4', {}, ['章程（charter）']),
         Field({
@@ -1588,7 +1792,7 @@ window.__ModuleLoader__.load({
     /* ---------------- 页签三：凭据与环境 ---------------- */
 
     function CredsTab({ cred, env, cookieDraft = '', onCookieDraft, onCookieSubmit,
-      diagText = null, onCopyDiag, busy = false }) {
+      diagText = null, onCopyDiag, busy = false, xhs = null, xhsQr = null, onXhsQr, onXhsStatus }) {
       const bili = cred?.bili
       const cookieStatus = bili == null
         ? 'B 站 cookie：状态还没读到'
@@ -1603,6 +1807,13 @@ window.__ModuleLoader__.load({
           `库大小：${fmtBytes(env.db_bytes)}`,
           `家目录：${env.home_writable === false ? '不可写（检查磁盘权限）' : '可写'}`
         ]
+      const xhsLine = xhs == null
+        ? '小红书：状态还没读到（点「刷新登录状态」，首次会拉起 MCP 子进程）'
+        : !xhs.configured
+          ? '小红书：MCP 未配置（preference.yaml 的 xhs.mcp_path 为空，通道不启用）'
+          : xhs.loggedIn
+            ? `小红书：已登录（${xhs.username || '用户名未知'}）`
+            : `小红书：未登录——${xhs.text || '点「扫码登录」'}`
       return vnode('div', { className: 'bl-setblock' }, [
         vnode('h4', {}, ['B 站凭据']),
         vnode('p', { className: 'bl-kv' }, [cookieStatus]),
@@ -1617,9 +1828,17 @@ window.__ModuleLoader__.load({
             SaveBtn({ text: '写入 cookie', disabled: busy || !String(cookieDraft).trim(), onClick: () => onCookieSubmit?.(cookieDraft) })
           ]
         }),
+        vnode('h4', {}, ['小红书（实验接入）']),
+        vnode('p', { className: 'bl-kv' }, [xhsLine]),
+        vnode('div', { className: 'bl-setrow' }, [
+          vnode('button', { type: 'button', className: 'bl-setsave', disabled: busy || undefined, onClick: () => onXhsQr?.() },
+            ['扫码登录（弹二维码，两分钟内有效）']),
+          vnode('button', { type: 'button', disabled: busy || undefined, onClick: () => onXhsStatus?.() },
+            ['刷新登录状态'])
+        ]),
+        xhsQr ? vnode('img', { src: xhsQr, className: 'bl-xhsqr', alt: '小红书登录二维码，用小红书 App 扫码' }) : null,
         vnode('h4', {}, ['环境']),
         vnode('ul', { className: 'bl-kv' }, envLines.map((l, i) => vnode('li', { key: i }, [l]))),
-        vnode('p', { className: 'bl-empty' }, ['小红书：未接入']),
         vnode('p', { className: 'bl-empty' }, ['转写依赖：未实现（随 ASR 一起）']),
         vnode('h4', {}, ['诊断']),
         vnode('div', { className: 'bl-setrow' }, [
@@ -1699,6 +1918,96 @@ window.__ModuleLoader__.load({
       ])
     }
 
+    // ---- src/client/views/player-tab.js ----
+    /**
+     * 侧栏/工作台里的播放器外壳。与抽屉共用 playerEmbed() 与 playerStage()——
+     * 嵌入正则和舞台标记抄两遍必然漂移。
+     *
+     * 这里只读：不收藏、不调权重、不提供"去浏览器"。侧栏手里只有一条 URL，而宿主的
+     * /open 只认 item_id（URL 一律从库里取），这条守卫不为了侧栏放宽。
+     * 音量/倍速在跨源 iframe 里面，我们够不着——界面上明说用画面里的原播放器控件，
+     * 不摆假滑杆。裁切窗跟容器宽度走（aspect-ratio 16:9），B 站完整页多一层页头偏移，
+     * 让视频面精确填满窗口、控制条完整可见（css.js 的 .bl-stage-* 一族）。
+     */
+
+    const KIND_LABEL = { bili: 'B 站', youtube: 'YouTube' }
+
+    function PlayerTab({ url, title = '', crop = true }) {
+      const embed = playerEmbed(url)
+      if (!embed) {
+        return vnode('div', { className: 'bl-tab' }, [
+          vnode('p', { className: 'bl-note' }, ['这个地址解析不出嵌入形态，侧栏播不了——回面板抽屉里用「浏览器打开」。'])
+        ])
+      }
+      return vnode('div', { className: 'bl-tab' }, [
+        title ? vnode('p', { className: 'bl-tab-head' }, [
+          vnode('span', { className: 'bl-badge' }, [KIND_LABEL[embed.kind] || '视频']),
+          vnode('span', { className: 'bl-tab-title' }, [title])
+        ]) : null,
+        playerStage(embed, crop),
+        vnode('p', { className: 'bl-note' }, [crop
+          ? '只露播放器本体：推荐流被裁掉，是不想让你顺着刷下去；音量、倍速用画面里的原播放器控件。设置页「裁掉推荐区」关掉就还原完整页。'
+          : '完整页在这里，往下滑会看到平台的推荐流。'])
+      ])
+    }
+
+    // ---- src/client/sidebar-tab.js ----
+    /**
+     * 侧栏播放 tab 的纯构建层：外链认领谓词 + descriptor + 手动播放的 seed。
+     * 这层不认识宿主也不认识 ctx——装配（真 ctx）留在 _footer，全部可以拿假 service 单测。
+     *
+     * 页签有两个入口：① 认领——better-sidebar 自己在拦截会话外链时打开（URL 挂在
+     * `tab.path` 上，实测）；② 手动——抽屉「侧栏播放」按钮经 videoTabSeed 构造 seed
+     * 调 openTab。两条路都走 `url` 载荷（实测定的，docs/verification.md 的 M7 探针）：
+     * 带 url/path 的 open 落 DSH 原生右侧栏。面板在前台时 open 会先排队，
+     * 会话回到前台由 better-sidebar 的 flushPending 落地——回显必须把这话讲清楚。
+     */
+
+    const TAB_ID = 'dsh-baleen:player'
+
+    /** 手动播放的 seed：url 载荷进原生右侧栏，标题缺省给个能认的名字 */
+    function videoTabSeed(url, title = '') {
+      return { type: TAB_ID, url, title: title || 'Baleen 播放' }
+    }
+
+    /** 认不出来就返回 null：宁可让链接照旧去系统浏览器，也不开一个播不了的门 */
+    function parseVideoUrl(raw) {
+      let u = null
+      try { u = raw instanceof URL ? raw : new URL(String(raw ?? '')) } catch { return null }
+      if (u.protocol !== 'https:' && u.protocol !== 'http:') return null
+      if (u.username || u.password) return null
+      const embed = playerEmbed(u.href)
+      return embed ? { ...embed, url: u.href } : null
+    }
+
+    /** 原生侧栏把认领来的 URL 挂在页签记录的 path 上（实测 tab18），不是 tab.url */
+    const urlOf = (tab) => String(tab?.path ?? '')
+
+    function buildTabDescriptor({ render, flags }) {
+      return {
+        id: TAB_ID,
+        title: 'Baleen 播放',
+        description: '把 B 站 / YouTube 视频在侧栏里播，不跳平台',
+        order: 60,
+        single: false,
+        dedupeKey: (tab) => TAB_ID + ':' + urlOf(tab),
+        urlTarget: (url) => Boolean(flags.takeover()) && Boolean(parseVideoUrl(url)),
+        component: (props) => render({ url: urlOf(props?.tab), title: String(props?.tab?.title ?? 'Baleen 播放') })
+      }
+    }
+
+    function registerSidebarTab(service, descriptor) {
+      const noop = () => {}
+      if (!service || typeof service.registerTab !== 'function') return noop
+      try {
+        const disposer = service.registerTab(descriptor)
+        return typeof disposer === 'function' ? disposer : noop
+      } catch (e) {
+        console.error('[dsh-baleen] 侧栏 tab 注册失败：' + ((e && e.message) || e))
+        return noop
+      }
+    }
+
 
     /**
      * 视图只产 {type, props, children} 这种纯数据（不碰 React，才能在 Node 里断言），
@@ -1715,7 +2024,7 @@ window.__ModuleLoader__.load({
     }
 
     let clientCtx = null
-    const inject = ['slots', 'layout']
+    const inject = ['slots', 'layout', 'betterSidebar']
 
     /** 只有声明过的服务读得到；这条 helper 存在的意义就是不让人手写裸属性回退 */
     function safeGet(name) {
@@ -1732,6 +2041,45 @@ window.__ModuleLoader__.load({
       try { return (clientCtx && clientCtx.layout) || null } catch { return null }
     }
 
+    /**
+     * 侧栏播放（M7）只由 better-sidebar 的 urlTarget 认领触发：用户点会话里的视频链接时
+     * 必然有会话在前台，那是唯一满足原生挂载条件的路径。面板里不放「侧栏播放」按钮——
+     * 实测面板在前台时 openTab 只进 pending 队列（见上面的机制注释），点了什么都不出现，
+     * 和 2026-10-31 撤掉的那个死按钮是同一个坑。想看就用抽屉里的内嵌播放器。
+     */
+    let takeoverOn = true      // 偏好读回来之前按默认值，与 DEFAULTS.sidebar_takeover 一致
+    let cropOn = true
+
+    /**
+     * 侧栏播放能力（抽屉「侧栏播放」按钮的落点）。available 与 open 都在调用时现取服务：
+     * better-sidebar 可能被禁用或根本没装，取不到就如实返回 false（按钮压根不画、点了明说
+     * 没接住），面板其余功能不牵连。手动 open 与认领（urlTarget）互不挂钩——关掉
+     * 「侧栏接管链接」只是不抢会话里的链接，按钮照样能用。
+     */
+    const sidebarTab = {
+      get available() {
+        const bs = safeGet('betterSidebar')
+        return Boolean(bs && typeof bs.openTab === 'function')
+      },
+      open(url, title) {
+        const bs = safeGet('betterSidebar')
+        if (!bs || typeof bs.openTab !== 'function' || !parseVideoUrl(url)) return false
+        try { bs.openTab(videoTabSeed(url, title)); return true }
+        catch (e) {
+          console.error('[dsh-baleen] 侧栏没接住这条：' + ((e && e.message) || e))
+          return false
+        }
+      }
+    }
+
+    /** 打开原链接只剩一条路：宿主侧 /open 路由。2026-10-31 真机验收实证，本宿主把
+     *  客户端页面的弹窗与外链全部静默拦下（webview 客体的 window-open 处理），window.open
+     *  与 <a target=_blank> 都到不了系统浏览器。
+     *  M7 补了机制（docs/verification.md 的探针）：dsh-better-sidebar 的原生挂载按
+     *  `mountedSessionId(ctx) === sessionId` 决定放不放行，会话不在前台时 open 是**进队列
+     *  等着**，`openTab` 返回 void、调用方拿不到失败信号——所以"面板在前台开侧栏"这条
+     *  不是被拒绝，是看起来什么都没发生。 */
+
     /** 导航项 ↔ 渲染器。VIEW_RENDER 的键必须与 view-state 的 VIEWS 一字不差（测试守着）。
      *  六个值全是视图本身：收藏页要多带的夹列表、草稿与二次确认态由 Panel 在调用时并进 props
      *  （那些 state 只存在于组件里，包在 VIEW_RENDER 里反而取不到）。 */
@@ -1757,6 +2105,28 @@ window.__ModuleLoader__.load({
     /** 取数的请求序号（终审 C14）：只在工厂作用域，Panel 每帧重跑不能把它清零。 */
     let refreshSeq = 0
 
+    /** 抽屉滚动位置的记忆：宿主侧的重渲染会波及面板 DOM，把 .bl-dmain 的 scrollTop
+     *  钳回 0（2026-10-31 真机实证：同节点、scrollHeight 不变、scrollTop 归零，且面板
+     *  自己没有定时器——唯一执行源就是重渲染）。对策是渲染期捕捉提交前的位置、提交后
+     *  回填，重渲染从哪来都免疫。两个纯函数只算"记不记、回不回"，DOM 读写挂线在
+     *  Panel 里，Node 测试不碰 document。 */
+    let drawerScrollMemo = { id: null, top: 0, max: 0 }
+
+    /** 记忆更新：换条目从零记；同条目只记"自洽"的滚动（top 在 [0, 可滚上限] 内）——
+     *  内容塌陷瞬间的钳位读数（top=0 而 max 为负）不许覆盖旧值，否则记忆会被弄丢
+     *  它的那一下自己抹掉。 */
+    function scrollMemoNext(memo, id, top, max) {
+      if (id !== memo.id) return { id, top: 0, max: 0 }
+      if (top < 0 || top > max) return memo
+      return { id, top, max }
+    }
+
+    /** 回填判定：同一条目、记忆停得比现在深、且那个位置在当前布局下仍达得到，才回填。 */
+    function scrollRestoreTarget(memo, id, top, max) {
+      if (memo.id !== id || memo.top <= top || memo.top > max) return null
+      return memo.top
+    }
+
     function Panel() {
       // api 与首屏状态都得只建一次：useState 的惰性初始化是唯一入口（useMemo 在桩里等价于直接调）
       const [api] = React.useState(() => createApi({ fetch: globalThis.fetch, storage: globalThis.localStorage }))
@@ -1774,6 +2144,9 @@ window.__ModuleLoader__.load({
       // 第二次会拿到 name_taken，回显对着刚建好的夹说"已经有这个夹了"。
       const [folderBusy, setFolderBusy] = React.useState(false)
       const [knownFolders, setKnownFolders] = React.useState(null)
+      // 「抓取正文」的在途条目（照抄 collecting 的规矩：没有它，连点会叠请求，
+      // 也说不清"正在抓的到底是哪一条"）。null = 没在抓。
+      const [fetchingId, setFetchingId] = React.useState(null)
       // 收藏页的瞬时态（一律不进 reducer：刷新就没的输入草稿 + 一次二次确认 + 一行回显）。
       // renameId 记着"这份草稿是改哪个夹的"，换夹就丢掉，不许把上一个夹的半截名字带过去。
       const [pendingDelete, setPendingDelete] = React.useState(null)
@@ -1814,6 +2187,16 @@ window.__ModuleLoader__.load({
         })
       }
       React.useEffect(() => { refresh() }, [snap.view, snap.filters.collections?.folder])
+      // 抽屉滚动回填（无依赖：每帧提交后都跑）。回调引用了下方才声明的 drawerOpen /
+      // snap——执行时它们已初始化。测试桩会执行 effect 且 document 是没有 querySelector
+      // 的假货，守卫要查到函数级。
+      React.useEffect(() => {
+        if (!drawerOpen || typeof document === 'undefined' || typeof document.querySelector !== 'function') return
+        const dmEl = document.querySelector('.bl-dmain')
+        if (!dmEl) return
+        const target = scrollRestoreTarget(drawerScrollMemo, snap.drawerItemId, dmEl.scrollTop, dmEl.scrollHeight - dmEl.clientHeight)
+        if (target != null) dmEl.scrollTop = target
+      })
 
       function onRun() {
         setBusy(true)
@@ -1892,7 +2275,12 @@ window.__ModuleLoader__.load({
         onFacet: dispatch,
         onSelect: (id) => dispatch({ type: 'select', id }),
         onOpen: (id) => dispatch({ type: 'open-drawer', id }),
-        onPickView: pickView
+        onPickView: pickView,
+        // 「抓取正文」只归文章区认领。忙态按"正在抓的是不是右栏这一条"算——
+        // 拿 fetchingId 一刀切会让右栏换了条之后，忙态贴在一条没在抓的正文上。
+        onFulltext: runFulltext,
+        fetching: view === 'article' && fetchingId != null &&
+          currentArticle(data.items, snap.filters.article || {}, snap.selectedId)?.id === fetchingId
       }
       const body = render(view === 'collections' ? { ...baseProps, ...collectionsProps } : baseProps)
       const drawerOpen = snap.drawerItemId != null
@@ -1901,6 +2289,15 @@ window.__ModuleLoader__.load({
       // 所以收藏成功后要把服务端读回的归属覆盖上去——只覆盖抽屉这一条的展示，不改 data.items。
       // 覆盖规则抽成纯函数 drawerItemWithFolders（views/drawer.js），连点不互抹的不变量由测试钉住。
       const drawerItem = drawerItemWithFolders(found, knownFolders)
+      // 渲染期捕捉（提交前）：此刻的 scrollTop 还是上一帧的，正是上游重渲染可能弄丢的
+      // 那个值。抽屉刚开时 memo.id 不匹配，从零起记。测试桩的 document 是没有
+      // querySelector 的假货，守卫要查到函数级。
+      if (drawerOpen && typeof document !== 'undefined' && typeof document.querySelector === 'function') {
+        const dmEl = document.querySelector('.bl-dmain')
+        if (dmEl) {
+          drawerScrollMemo = scrollMemoNext(drawerScrollMemo, snap.drawerItemId, dmEl.scrollTop, dmEl.scrollHeight - dmEl.clientHeight)
+        }
+      }
       // 包一层 collecting：点一下即生效意味着连点会叠请求，全量替换下后到的旧集合会盖掉新决定。
       function runCollect(...args) {
         setCollecting(true)
@@ -1909,6 +2306,40 @@ window.__ModuleLoader__.load({
           (e) => { setCollecting(false); throw e }
         )
       }
+      /**
+       * 「抓取正文」：面板只报条目 id，抓哪条、抓成什么样由宿主定（/fulltext）。
+       * 成败都要收口：成功就重读当前视图，让右栏换成新正文；失败给一句人话并指回原文——
+       * 静默失败会让人以为"点了没反应"，而这颗按钮恰恰是摘要条目唯一的出路。
+       * 在途标记按"是不是这一条"清，不吃掉别人后来点的那一次。
+       */
+      function runFulltext(itemId) {
+        if (!Number.isInteger(itemId)) return Promise.resolve()
+        setFetchingId(itemId)
+        return api.fulltext(itemId).then(
+          (r) => {
+            setFetchingId((cur) => (cur === itemId ? null : cur))
+            if (!r.ok) {
+              setFeedbackMsg('这次没抓到正文，还是只有摘要——原文链接在上面')
+              return undefined
+            }
+            return refresh()
+          },
+          (e) => {
+            setFetchingId((cur) => (cur === itemId ? null : cur))
+            setFeedbackMsg(`这次没抓到正文，还是只有摘要——原文链接在上面（${(e && e.message) || '宿主接口没应答'}）`)
+            return undefined
+          }
+        )
+      }
+      // 「浏览器打开」：成功不需要说什么——浏览器自己会弹到前头；失败要说明白，
+      // 顺手给出路（复制地址）。清掉旧回显免得上一句收藏反馈还挂在上面。
+      function runOpenExternal(itemId) {
+        if (!Number.isInteger(itemId)) return Promise.resolve()
+        return api.openItem(itemId).then(
+          () => setFeedbackMsg(''),
+          () => setFeedbackMsg('宿主没能拉起系统浏览器，直接复制上面的地址吧。')
+        )
+      }
       return h('div', { className: 'bl-root' }, [
         // 外壳三件（Nav / TopBar / NotReady）与视图同构，都产纯对象，所以一律经 toElement，
         // 不能 h(Nav)：函数组件返回普通对象的话，真 React 会直接抛"Objects are not valid as a React child"。
@@ -1924,6 +2355,8 @@ window.__ModuleLoader__.load({
             collecting,
             newFolderName,
             onNewFolderName: setNewFolderName,
+            onOpenUrl: (url, itemId) => runOpenExternal(itemId),
+            sidebar: sidebarTab,
             onClose: () => { setFeedbackMsg(''); setNewFolderName(''); dispatch({ type: 'close-drawer' }) },
             onDone: (r) => {
               setFeedbackMsg(r.message)
@@ -1970,6 +2403,10 @@ window.__ModuleLoader__.load({
       // 凭据页签
       const [cookieDraft, setCookieDraft] = React.useState('')
       const [diagText, setDiagText] = React.useState(null)
+      // 小红书（M6）：登录状态与扫码二维码。都是手动触发（探活会按需拉起 MCP 子进程，
+      // 挂载即打会让每次开设置页都 spawn 一个浏览器栈）。
+      const [xhsInfo, setXhsInfo] = React.useState(null)
+      const [xhsQr, setXhsQr] = React.useState(null)
       // 库页签
       const [cleanupDays, setCleanupDays] = React.useState('')
       const [askCleanup, setAskCleanup] = React.useState(false)
@@ -2059,6 +2496,28 @@ window.__ModuleLoader__.load({
           return undefined
         })
       }
+      /** 小红书（M6）：登录态探活与扫码。成功失败都落在 xhsInfo/回显里，不静默。 */
+      function onXhsStatus() {
+        setBusy(true)
+        api.xhsStatus().then((r) => {
+          setBusy(false)
+          if (r.ok && r.data) setXhsInfo(r.data)
+          else setNote(`小红书状态没读到（${r.error || '宿主接口没应答'}）`)
+        })
+      }
+      function onXhsQr() {
+        setBusy(true)
+        api.xhsLoginQr().then((r) => {
+          setBusy(false)
+          if (r.ok && r.data && r.data.image) {
+            setXhsQr(r.data.image)
+            setXhsInfo({ configured: true, loggedIn: false, text: r.data.text })
+            setNote('二维码两分钟内有效——扫完点「刷新登录状态」')
+            return
+          }
+          setNote(`二维码没拿到（${r.error || '宿主接口没应答'}）`)
+        })
+      }
       /** 复制诊断：tail 已在服务端逐行脱敏；剪贴板拿不到就降级成文本块让人手动复制。 */
       function onCopyDiag() {
         api.diagTail(50).then((r) => {
@@ -2124,6 +2583,7 @@ window.__ModuleLoader__.load({
         onSave: putSection,
         askResetTuning, onAskResetTuning: () => setAskResetTuning(true), onCancelResetTuning: () => setAskResetTuning(false), onResetTuning,
         cred, env, cookieDraft, onCookieDraft: setCookieDraft, onCookieSubmit, diagText, onCopyDiag,
+        xhs: xhsInfo, xhsQr, onXhsQr, onXhsStatus,
         home: hostState?.home ?? '<HOME>',
         cleanupDays, onCleanupDays: setCleanupDays, askCleanup, onAskCleanup: () => setAskCleanup(true), onCancelCleanup: () => setAskCleanup(false), onCleanup,
         wipeText, onWipeText: setWipeText, onWipe, onExport
@@ -2137,7 +2597,7 @@ window.__ModuleLoader__.load({
       const slots = safeGet('slots')
       if (!slots) {
         console.error('[dsh-baleen] 拿不到 slots 服务，界面不注册')
-        return { registeredSlots: [] }
+        return { registeredSlots: [], sidebarTab }
       }
       const registered = []
 
@@ -2175,7 +2635,23 @@ window.__ModuleLoader__.load({
         () => h(SettingsView, { key: 'settings' }),
         'settings.section')
 
-      return { registeredSlots: registered }
+      // 侧栏播放 tab（M7）：只在拿得到服务时注册。取不到就整段跳过，面板其余照旧。
+      const betterSidebar = safeGet('betterSidebar')
+      if (betterSidebar && typeof betterSidebar.registerTab === 'function') {
+        ctx.effect(() => registerSidebarTab(betterSidebar, buildTabDescriptor({
+          flags: { takeover: () => takeoverOn },
+          render: ({ url, title }) => toElement(PlayerTab({ url, title, crop: cropOn }))
+        })))
+        // urlTarget 是同步谓词，所以偏好只能读一次缓存进布尔；读不到就保持默认开
+        const prefApi = createApi({ fetch: globalThis.fetch, storage: globalThis.localStorage })
+        prefApi.preferenceGet().then((r) => {
+          const p = r && r.data && r.data.pref    // plainGet 的形状是 {ok, stale, data}，pref 在 data 里
+          if (typeof p?.sidebar_takeover === 'boolean') takeoverOn = p.sidebar_takeover
+          if (typeof p?.sidebar_crop === 'boolean') cropOn = p.sidebar_crop
+        }).catch(() => {})
+      }
+
+      return { registeredSlots: registered, sidebarTab }
     }
 
     exports.apply = apply
@@ -2183,6 +2659,8 @@ window.__ModuleLoader__.load({
     exports.__test = {
       PANEL_ID, VIEW_KEY, API_BASE, SNAPSHOT_KEY, VIEWS, VIEW_RENDER, viewQuery, NAV_ITEMS,
       Nav, NotReady, TopBar, Panel, toElement, createApi, getLayout, safeGet,
+      scrollMemoNext, scrollRestoreTarget,
+      scrollMemoNext, scrollRestoreTarget,
       reduce, encodeState, decodeState, TodayView, Drawer, CollectionsView,
       SettingsView, SettingsPage, parseThemes, serializeThemes, splitThemes
     }