dsh-music-player 0.3.5 → 0.3.6

package/lib/client.js

@@ -615,9 +615,40 @@ window.__ModuleLoader__.load({
       if (store.mode !== 'shuffle') return;
       ensureShuffleReady();
     }
+    // play() 的失败原因五花八门：AbortError（被 pause()/load()/切歌中断）、
+    // “interrupted by ...”等都不是自动播放被拦截。这里**反向判断**：只有错误
+    // 明确是自动播放被拦截（NotAllowedError，或 Chromium 的 not-allowed 文案）才
+    // 提示“浏览器拦截了自动播放”。这样双击/连点/快速切歌产生的中断一律不会误报
+    // （本环境里中断错误未必是标准 AbortError，只过滤 AbortError 会漏网）。
+    function isAutoplayBlocked(err) {
+      try {
+        if (!err) return false;
+        const n = String(err.name || '');
+        const m = String((err && err.message) || '');
+        if (n === 'NotAllowedError') return true;
+        return /not allowed|autoplay|user (gesture|interaction|activation)|didn'?t interact|play\(\) failed/i.test(m);
+      } catch (e) { return false; }
+    }
+    // 播放被主动中断（pause/stop/切歌）：用于抑制“播放失败”这类误导提示。
+    function isPlayAborted(err) {
+      try {
+        return !!err && (err.name === 'AbortError' || /abort|interrupted/i.test(String((err && err.message) || '')));
+      } catch (e) { return false; }
+    }
+    // 最近一次点击启动曲目的时刻。双击的第二次点击会落在已激活的行上；部分
+    // 浏览器/环境里那次点击的 detail 仍为 1，仅靠 detail>=2 判断不可靠，这里用
+    // 时间窗兜底：刚（600ms 内）通过点击启动的曲目被再次点击，一律视为双击的
+    // 第二次点击而忽略，避免把它当成“再点一次=暂停/重播”并触发上面的误报。
+    let lastPlayStartTs = 0;
+    function shouldIgnoreRowClick(e, isActive) {
+      if (e && e.detail >= 2) return true;
+      if (isActive && Date.now() - lastPlayStartTs < 600) return true;
+      return false;
+    }
     function startPlay(id) {
       const track = resolvePlayable(id);
       if (track === null) return;
+      lastPlayStartTs = Date.now();
       restoredMusicPos = null;
       bookRestorePos = -1;
       audio.src = track.url;
@@ -629,7 +660,10 @@ window.__ModuleLoader__.load({
       savePlayback();
       const promise = audio.play();
       if (promise !== undefined && typeof promise.catch === 'function') {
-        promise.catch(() => { set({ error: '浏览器拦截了自动播放，请点击一次播放按钮', pendingId: id, pendingName: track.name }); });
+        promise.catch((err) => {
+          if (!isAutoplayBlocked(err)) return;
+          set({ error: '浏览器拦截了自动播放，请点击一次播放按钮', pendingId: id, pendingName: track.name });
+        });
       }
     }
     const bookById = (id) => (store.books || []).find((b) => b.id === id) || null;
@@ -664,6 +698,12 @@ window.__ModuleLoader__.load({
                            // continuous book-wide time readout that never resets)
     let bookStuckTimer = null; // single synthesis-timeout guard (see playBookFrom)
     let lastPosSaveAt = 0;     // throttle for the periodic playback-state save
+    // 单块时长上限：分块是 ≤150 字的散文，实测全书块长 10~36 秒，极端慢读也不
+    // 会超过 2 分钟。若浏览器报的 duration 远超此值，说明该块 WAV 异常（截断/
+    // 字节率错误导致时长虚高）——否则 <audio> 会「播静音」直到虚高时长走完。
+    // 注意：这只是兜底。命中时仅静音重试一次；重试后仍超长则正常播放、不报错
+    // （万一真是极慢的真实长块也不会被误杀）。主防御在 Host 的 WAV 头/静音校验。
+    const BOOK_MAX_CHUNK_SEC = 180;
     let restoredMusicPos = null; // restored music position to display until the audio truly reaches it
     let bookRestorePos = -1;   // restored book's in-chunk position, seeked on play
     // 当前块是否已自动重试过一次（瞬时 LLM 合成失败时先静音重试一次，
@@ -768,6 +808,9 @@ window.__ModuleLoader__.load({
     async function playBookFrom(id, from, silent) {
       const book = bookById(id);
       if (book === null) return;
+      // 用户点击/跳章启动小说同样刷新双击时间窗（与音乐 startPlay 对齐），
+      // 保证 detail 不可靠的环境里双击小说的第二次点击也能被忽略。
+      lastPlayStartTs = Date.now();
       restoredMusicPos = null;
       const wasFresh = from === 0;
       // `silent` is set for the hidden ended→next auto-advance: the switch is
@@ -903,7 +946,7 @@ window.__ModuleLoader__.load({
           if (bookTotal >= 0 && bookFromRef + 1 < bookTotal) preloadBook(id, bookFromRef + 1);
         }
         const promise = audio.play();
-        if (promise !== undefined && typeof promise.catch === 'function') promise.catch(() => set({ error: '浏览器拦截了自动播放，请点击播放按钮' }));
+        if (promise !== undefined && typeof promise.catch === 'function') promise.catch((err) => { if (isAutoplayBlocked(err)) set({ error: '浏览器拦截了自动播放，请点击播放按钮' }); });
         // Envelope decoding is deferred to play (see loadTracks) — decode the
         // restored track lazily so its spectrum is ready once it resumes.
         if (!String(store.currentId).startsWith('book:')) {
@@ -1112,6 +1155,19 @@ window.__ModuleLoader__.load({
         // before metadata loads audio.duration is NaN and we'd clobber a
         // restored/stored value with 0 (leaving "0:00").
         if (Number.isFinite(audio.duration) && audio.duration > 0) {
+          // 讲书块兜底：若浏览器报的时长远超正常范围，先静音重试一次（坏 WAV
+          // 可能靠重试恢复）。重试后仍超长则按真实长块正常播放——Host 已做
+          // WAV 头/静音校验，能到这里的几乎不可能是坏 WAV，因此绝不误杀。
+          if (store.currentId !== null && String(store.currentId).startsWith('book:')
+            && audio.duration > BOOK_MAX_CHUNK_SEC) {
+            if (!bookAutoRetried) {
+              bookAutoRetried = true;
+              const id = String(store.currentId).slice('book:'.length);
+              unlockAutoplay();
+              playBookFrom(id, bookFromRef, true);
+              return; // retry re-loads; don't clobber duration yet
+            }
+          }
           set({ duration: (bookTimeBase() + audio.duration) });
         }
       };
@@ -1131,7 +1187,7 @@ window.__ModuleLoader__.load({
         if (store.mode === 'single' && store.currentId !== null) {
           audio.currentTime = 0;
           const promise = audio.play();
-          if (promise !== undefined && typeof promise.catch === 'function') promise.catch(() => set({ error: '播放失败', playing: false }));
+          if (promise !== undefined && typeof promise.catch === 'function') promise.catch((err) => { if (!isPlayAborted(err)) set({ error: '播放失败', playing: false }); });
           return;
         }
         step(1);
@@ -1379,6 +1435,30 @@ window.__ModuleLoader__.load({
       }
       return Math.round(bytes / 1024) + ' KB';
     }
+    // 目录面包屑：把绝对路径渲染成逐个可点击的目录名，点击任一段即可直接跳到
+    // 该目录；最后一段（当前目录）高亮展示、不可点击。crumbs 为空时回退显示
+    // 目录名/路径纯文本（例如驱动列表或家目录未配置）。
+    function renderCrumbs(crumbs, path, name, onGo) {
+      if (!crumbs || crumbs.length === 0) {
+        return React.createElement('span', { className: 'dsh-music-crumb-plain' }, name || path || '家目录');
+      }
+      const els = [];
+      crumbs.forEach((c, i) => {
+        if (i > 0) els.push(React.createElement('span', { key: 'sep' + i, className: 'dsh-music-crumb-sep' }, '\u203A'));
+        const isLast = i === crumbs.length - 1;
+        if (isLast) {
+          els.push(React.createElement('span', { key: 'c' + i, className: 'dsh-music-crumb cur', title: c.path }, c.name));
+        } else {
+          els.push(React.createElement('button', {
+            key: 'c' + i,
+            className: 'dsh-music-crumb',
+            title: c.path,
+            onClick: () => onGo(c.path),
+          }, c.name));
+        }
+      });
+      return els;
+    }
     function MusicNote(props) {
       const cls = props.className || '';
       return React.createElement('svg', { className: cls, width: 12, height: 12, viewBox: '0 0 24 24', fill: 'currentColor', 'aria-hidden': true },
@@ -1675,7 +1755,11 @@ window.__ModuleLoader__.load({
           key: i,
           className: 'dsh-music-toc-item' + (active ? ' active' : ''),
           title: sec.heading,
-          onClick: () => {
+          // Same double-click guard as the track/book rows: the second click of a
+          // dblclick must not re-start the chapter (which would re-synthesize the
+          // same chunk and visibly restart it).
+          onClick: (e) => {
+            if (e.detail >= 2) return;
             if (id !== null) playBook(id, sec.fromChunk);
             closeToc();
           },
@@ -1834,8 +1918,14 @@ window.__ModuleLoader__.load({
         return React.createElement('div', { key: t.id, className: 'dsh-music-track-row' + (active ? ' active' : '') },
           React.createElement('button', {
             className: 'dsh-music-track' + (active ? ' active' : ''),
-            title: t.url,
-            onClick: () => { if (active) togglePlay(); else startPlayFrom(t.id, 'library'); },
+            title: t.path,
+            // A browser's double-click fires the row's click twice: the first
+            // click starts the track, the second lands on the now-active row and
+            // would togglePlay() it (pausing it and aborting its pending play
+            // promise — historically misreported as an autoplay block). Ignore
+            // the repeat click (detail >= 2, plus a time-window fallback) so a
+            // double-click keeps playing.
+            onClick: (e) => { if (shouldIgnoreRowClick(e, active)) return; if (active) togglePlay(); else startPlayFrom(t.id, 'library'); },
           },
             React.createElement('span', { className: 'dsh-music-track-name' }, (playing ? '▶ ' : '') + t.name),
             React.createElement('span', { className: 'dsh-music-track-size' }, formatSize(t.size)),
@@ -1853,8 +1943,8 @@ window.__ModuleLoader__.load({
         return React.createElement('button', {
           key: b.id,
           className: 'dsh-music-track' + (active ? ' active' : ''),
-          title: b.url,
-          onClick: () => { if (active) togglePlay(); else resumeOrPlayBook(b.id); },
+          title: b.path || b.name,
+          onClick: (e) => { if (shouldIgnoreRowClick(e, active)) return; if (active) togglePlay(); else resumeOrPlayBook(b.id); },
         },
           React.createElement('span', { className: 'dsh-music-track-name' }, (playing ? '▶ ' : '') + b.name),
           React.createElement('span', { className: 'dsh-music-track-size' }, formatSize(b.size)),
@@ -1905,7 +1995,8 @@ window.__ModuleLoader__.load({
         s.tab === 'music' ? musicSubTabs : null,
         // While a novel is playing, keep music-only errors/scanning out of the
         // panel (novel status shows on the playback bar instead).
-        !isBook && s.error ? React.createElement('div', { className: 'dsh-music-error' }, s.error) : null,
+        // 音乐/小说统一在主列表区上方显示 error（设置块不再重复/分模式显示）。
+        s.error ? React.createElement('div', { className: 'dsh-music-error' }, s.error) : null,
         !isBook && s.loading ? React.createElement('div', { className: 'dsh-music-loading' }, '扫描中…') : null,
         React.createElement('div', { className: 'dsh-music-list', style: pos === null ? null : { maxHeight: 'none' }, ref: (el) => { listRef.current = el; } }, listBody),
         React.createElement('div', { className: 'dsh-music-resize', title: '拖动调整面板大小', onPointerDown: onResizeDown, onPointerMove: onResizeMove, onPointerUp: onResizeUp }),
@@ -1921,9 +2012,10 @@ window.__ModuleLoader__.load({
       const s = useStore();
       const [pickerOpen, setPickerOpen] = useState(false);
       const [dirs, setDirs] = useState([]);
+      const [files, setFiles] = useState([]);
       const [curPath, setCurPath] = useState('');
       const [curName, setCurName] = useState('');
-      const [curUp, setCurUp] = useState(null);
+      const [curCrumbs, setCurCrumbs] = useState([]);
       const [dirError, setDirError] = useState(null);
       const isBook = s.tab === 'book';
       const activeRoot = isBook ? s.bookRoot : s.root;
@@ -1936,27 +2028,29 @@ window.__ModuleLoader__.load({
           React.createElement('span', { className: 'dsh-music-settings-cur', title: activeRoot || '' },
             '📁 ' + (activeRoot || '未配置')),
           React.createElement('button', { className: 'dsh-music-settings-btn', onClick: () => openPicker() }, pickerTitle)),
-        s.error ? React.createElement('p', { className: 'dsh-music-error' }, s.error) : null,
         React.createElement('p', { className: 'dsh-music-hint' }, hint),
         pickerOpen ? portalToBody(React.createElement('div', { className: 'dsh-music-picker-overlay' },
           React.createElement('div', { className: 'dsh-music-picker' },
             React.createElement('div', { className: 'dsh-music-picker-head' },
               React.createElement('span', { className: 'dsh-music-picker-title' }, pickerTitle)),
             React.createElement('div', { className: 'dsh-music-picker-cur', title: curPath },
-              curName || curPath || '家目录'),
+              renderCrumbs(curCrumbs, curPath, curName, browse)),
             React.createElement('div', { className: 'dsh-music-picker-list' },
-              dirs.length > 0
-                ? dirs.map((d) => React.createElement('button', {
-                  key: d.path,
-                  className: 'dsh-music-picker-item',
-                  title: d.path,
-                  onClick: () => browse(d.path),
-                }, '📁 ' + d.name))
-                : React.createElement('div', { className: 'dsh-music-picker-empty' }, '本目录下无子目录，可直接选择。'),
+              // 目录排在前（可点击进入），文件排在后（仅作展示，不响应点击）。
+              dirs.map((d) => React.createElement('button', {
+                key: d.path,
+                className: 'dsh-music-picker-item',
+                title: d.path,
+                onClick: () => browse(d.path),
+              }, '📁 ' + d.name)),
+              files.map((f) => React.createElement('span', {
+                key: f.path,
+                className: 'dsh-music-picker-item file',
+                title: f.path,
+              }, '📄 ' + f.name)),
               dirError ? React.createElement('div', { className: 'dsh-music-error' }, dirError) : null,
             ),
             React.createElement('div', { className: 'dsh-music-picker-foot' },
-              React.createElement('button', { className: 'dsh-music-settings-btn ghost', onClick: () => goUp() }, '返回上级'),
               React.createElement('button', { className: 'dsh-music-settings-btn', onClick: () => pickCurrent() }, '选择此目录'),
               React.createElement('button', { className: 'dsh-music-settings-btn ghost', onClick: () => setPickerOpen(false) }, '取消'),
             ),
@@ -1977,26 +2071,13 @@ window.__ModuleLoader__.load({
           if (data && data.error) { setDirError(data.error); return; }
           setCurPath(data.path || '');
           setCurName(data.name || '');
-          setCurUp(data.up || null);
+          setCurCrumbs(data.crumbs || []);
           setDirs(data.dirs || []);
+          setFiles(data.files || []);
         } catch (err) {
           setDirError('读取目录失败：' + String((err && err.message) || err));
         }
       }
-      function goUp() {
-        // Prefer the parent path computed by the host (correct separators per OS).
-        // At a drive root the host reports the "__drives__" sentinel, so "up"
-        // jumps to the drive list and lets the user switch disks.
-        if (curUp === '__drives__') { browse('__drives__'); return; }
-        if (curUp !== null && curUp !== undefined && curUp !== '') { browse(curUp); return; }
-        // fallback: derive the parent locally when the host omitted `up`.
-        // Handle both "\" and "/" so Windows paths never dead-end (the old
-        // POSIX-only parse did nothing on backslash paths like C:\Users\x).
-        if (curPath === '' || curPath === '/' || /^[A-Za-z]:[\\/]?$/.test(curPath)) return;
-        const idx = Math.max(curPath.lastIndexOf('/'), curPath.lastIndexOf('\\'));
-        if (idx <= 0) return;
-        browse(curPath.slice(0, idx));
-      }
       function pickCurrent() {
         const p = curPath;
         // The drive-list view ("__drives__") is not a real directory.
@@ -2057,8 +2138,10 @@ window.__ModuleLoader__.load({
         return React.createElement('div', { key: t.id, className: 'dsh-music-playlist-row' + (active ? ' active' : '') },
           React.createElement('button', {
             className: 'dsh-music-track',
-            title: t.url,
-            onClick: () => { if (active) togglePlay(); else startPlayFrom(t.id, 'playlist', pl.id); },
+            title: t.path,
+            // Same double-click guard as the library rows: the second click of a
+            // dblclick must not togglePlay() (pause) the just-started track.
+            onClick: (e) => { if (shouldIgnoreRowClick(e, active)) return; if (active) togglePlay(); else startPlayFrom(t.id, 'playlist', pl.id); },
           },
             React.createElement('span', { className: 'dsh-music-track-name' }, (playing ? '▶ ' : '') + (idx + 1) + '. ' + t.name),
             React.createElement('span', { className: 'dsh-music-track-size' }, formatSize(t.size)),
@@ -2082,7 +2165,7 @@ window.__ModuleLoader__.load({
     }
     // 文件系统多选器：浏览目录 + 勾选音频文件，用于歌单「添加歌曲」。
     function FilePicker({ pl, onClose }) {
-      const [cur, setCur] = useState({ path: '', name: '', up: null, dirs: [], files: [] });
+      const [cur, setCur] = useState({ path: '', name: '', dirs: [], files: [], crumbs: [] });
       const [sel, setSel] = useState(new Set());
       const [err, setErr] = useState(null);
       const [busy, setBusy] = useState(false);
@@ -2091,7 +2174,7 @@ window.__ModuleLoader__.load({
         try {
           const data = await jsonGet('/dsh-music/files?path=' + encodeURIComponent(p || ''));
           if (data && data.error) { setErr(data.error); return; }
-          setCur({ path: data.path || '', name: data.name || '', up: data.up || null, dirs: data.dirs || [], files: data.files || [] });
+          setCur({ path: data.path || '', name: data.name || '', dirs: data.dirs || [], files: data.files || [], crumbs: data.crumbs || [] });
         } catch (e) { setErr('读取目录失败：' + String((e && e.message) || e)); }
       };
       // 默认定位到音乐目录（store.root），未配置时回退家目录。
@@ -2112,7 +2195,8 @@ window.__ModuleLoader__.load({
           React.createElement('div', { className: 'dsh-music-picker-head' },
             React.createElement('span', { className: 'dsh-music-picker-title' }, '添加歌曲到「' + pl.name + '」'),
           ),
-          React.createElement('div', { className: 'dsh-music-picker-cur', title: cur.path }, cur.name || cur.path || '家目录'),
+          React.createElement('div', { className: 'dsh-music-picker-cur', title: cur.path },
+            renderCrumbs(cur.crumbs, cur.path, cur.name, browse)),
           React.createElement('div', { className: 'dsh-music-picker-list' },
             (cur.dirs || []).map((d) => React.createElement('button', {
               key: d.path, className: 'dsh-music-picker-item', title: d.path,
@@ -2134,21 +2218,11 @@ window.__ModuleLoader__.load({
             err ? React.createElement('div', { className: 'dsh-music-error' }, err) : null,
           ),
           React.createElement('div', { className: 'dsh-music-picker-foot' },
-            React.createElement('button', { className: 'dsh-music-settings-btn ghost', onClick: () => goUp() }, '上一级'),
             React.createElement('button', { className: 'dsh-music-settings-btn', onClick: confirmAdd, disabled: busy }, '确定添加（' + sel.size + '）'),
             React.createElement('button', { className: 'dsh-music-settings-btn ghost', onClick: onClose }, '取消'),
           ),
         ),
       ));
-      function goUp() {
-        const u = cur.up;
-        if (u === '__drives__') { browse('__drives__'); return; }
-        if (u) { browse(u); return; }
-        if (cur.path === '' || cur.path === '/' || /^[A-Za-z]:[\\/]?$/.test(cur.path)) return;
-        const idx = Math.max(cur.path.lastIndexOf('/'), cur.path.lastIndexOf('\\'));
-        if (idx <= 0) return;
-        browse(cur.path.slice(0, idx));
-      }
     }
 
     const inject = ['slots'];
@@ -2203,7 +2277,7 @@ window.__ModuleLoader__.load({
           if (action === 'pause') { audio.pause(); set({ playing: false }); return; }
           if (action === 'resume') {
             const p = audio.play();
-            if (p !== undefined && typeof p.catch === 'function') p.catch(() => set({ error: '播放失败' }));
+            if (p !== undefined && typeof p.catch === 'function') p.catch((err) => { if (!isPlayAborted(err)) set({ error: '播放失败' }); });
             return;
           }
           if (action === 'stop') { stop(); return; }
@@ -2242,7 +2316,10 @@ window.__ModuleLoader__.load({
             savePlayback();
             const promise = audio.play();
             if (promise !== undefined && typeof promise.catch === 'function') {
-              promise.catch(() => set({ error: '浏览器拦截了自动播放，请在播放条点击▶解锁', pendingId: intent.id, pendingName: track.name }));
+              promise.catch((err) => {
+                if (!isAutoplayBlocked(err)) return;
+                set({ error: '浏览器拦截了自动播放，请在播放条点击▶解锁', pendingId: intent.id, pendingName: track.name });
+              });
             }
           }
         }).catch(() => {});
@@ -2350,11 +2427,19 @@ window.__ModuleLoader__.load({
       '.dsh-music-picker { box-sizing: border-box; width: 88%; max-width: 640px; max-height: 100%; margin: auto; display: flex; flex-direction: column; gap: 8px; padding: 12px; background: var(--dsw-alias-bg-overlay, #1e1f22); border: 1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.35)); border-radius: 12px; color: var(--dsw-alias-label-primary, #e6e6e6); }\n' +
       '.dsh-music-picker-head { display: flex; align-items: center; flex: none; }\n' +
       '.dsh-music-picker-title { font-weight: 600; }\n' +
-      '.dsh-music-picker-cur { flex: none; font-size: 12px; color: var(--dsw-alias-label-secondary, #8a8f98); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n' +
+      '.dsh-music-picker-cur { flex: none; font-size: 12px; color: var(--dsw-alias-label-secondary, #8a8f98); white-space: nowrap; overflow-x: auto; overflow-y: hidden; padding-bottom: 2px; }\n' +
+      '.dsh-music-picker-cur::-webkit-scrollbar { height: 4px; }\n' +
+      '.dsh-music-picker-cur::-webkit-scrollbar-thumb { background: var(--dsw-alias-bg-layer-2, rgba(255,255,255,0.14)); border-radius: 4px; }\n' +
+      '.dsh-music-crumb { display: inline-block; padding: 1px 4px; border: none; background: transparent; color: var(--dsw-alias-label-secondary, #8a8f98); cursor: pointer; font-size: 12px; border-radius: 4px; }\n' +
+      '.dsh-music-crumb:hover { background: var(--dsw-alias-bg-layer-2, rgba(255,255,255,0.08)); color: var(--dsw-alias-label-primary, #e6e6e6); }\n' +
+      '.dsh-music-crumb.cur { color: var(--dsw-alias-label-primary, #e6e6e6); font-weight: 600; cursor: default; }\n' +
+      '.dsh-music-crumb-sep { margin: 0 2px; color: var(--dsw-alias-label-secondary, #8a8f98); }\n' +
+      '.dsh-music-crumb-plain { color: var(--dsw-alias-label-secondary, #8a8f98); }\n' +
       '.dsh-music-picker-list { flex: 1; overflow-y: auto; display: flex; flex-direction: column; gap: 2px; }\n' +
       '.dsh-music-picker-item { text-align: left; padding: 6px 8px; border: none; background: transparent; border-radius: 6px; color: var(--dsw-alias-label-primary, #e6e6e6); cursor: pointer; font-size: 13px; }\n' +
       '.dsh-music-picker-item:hover { background: var(--dsw-alias-bg-layer-2, rgba(255,255,255,0.06)); }\n' +
-      '.dsh-music-picker-empty { padding: 8px; font-size: 12px; color: var(--dsw-alias-label-secondary, #8a8f98); }\n' +
+      // 文件条目：仅作展示，不可点击（无 hover 高亮，光标为默认）。
+      '.dsh-music-picker-item.file { color: var(--dsw-alias-label-secondary, #8a8f98); cursor: default; }\n' +
       '.dsh-music-picker-foot { display: flex; gap: 8px; justify-content: flex-end; }\n' +
       '.dsh-music-hint { font-size: 12px; color: var(--dsw-alias-label-secondary, #8a8f98); }\n' +
       // 讲书时章节名是主信息：占满剩余弹性空间、尽量完整显示；书名让出空间（可截断）。

package/lib/index.js

@@ -277,6 +277,154 @@ export function parseBookStructure(text, filenameHint = '') {
   }
 }
 
+// ---- book chunking into TTS blocks ----
+// Maximum length of a "clean, short" chapter heading that gets its own
+// dedicated TTS chunk. Real headings are a handful of characters (e.g.
+// "第一章 闪电划过星空"); anything longer is almost certainly an inline heading
+// that has already swallowed the following body text (parseBookStructure
+// classifies whole lines), so we refuse to isolate it — isolating would only
+// move the merged body into a "heading" chunk. Keep the old merge behaviour
+// for those instead.
+const MAX_HEADING_CHARS = 30
+
+// Locate where a heading ends inside a sentence segment, using two bounds and
+// taking the smaller one:
+//   1) the end of the heading's own line (next '\n') — exact when the heading
+//      sits on its own line (the normal case);
+//   2) the end of an elastic-whitespace match of the heading string against the
+//      source — guards against inline headings so a short heading never
+//      swallows the rest of a long paragraph.
+// `heading` is the cleaned heading (WPS codes / full-width spaces already
+// stripped by structClassifyLine), so source whitespace runs are treated
+// elastically.
+function headingEndInSegment(segText, from, heading) {
+  // Bound 1: end of the heading's line in the raw segment (newlines preserved).
+  const nl = segText.indexOf('\n', from)
+  const lineEnd = nl === -1 ? segText.length : nl
+  // Bound 2: elastic whitespace match of the heading string.
+  let i = from
+  let j = 0
+  while (j < heading.length) {
+    const hc = heading[j]
+    if (/\s/.test(hc)) { j++; continue } // heading whitespace: skip (any run)
+    while (i < segText.length && /\s/.test(segText[i])) i++ // source whitespace: skip
+    if (i >= segText.length || segText[i] !== hc) break // mismatch → heading ends here
+    i++
+    j++
+  }
+  // Skip a trailing whitespace run so "标题　" does not keep its padding.
+  while (i < segText.length && /\s/.test(segText[i])) i++
+  return Math.min(lineEnd, i)
+}
+
+/**
+ * Split prose into natural chunks (<= MAX_TTS_CHARS each). Sentences are
+ * accumulated up to the cap (so each block is a few sentences of speech),
+ * only closing a block when the next sentence would overflow. Paragraph
+ * newlines are folded into whitespace. A single over-long sentence becomes
+ * its own block (hard-capped).
+ *
+ * Optional `breaks` = sorted list of section headings, each
+ * { start, text } where `start` is the heading's char offset in `text` and
+ * `text` is the heading string (s.heading from parseBookStructure). A break is
+ * applied at sub-segment precision: text before the break stays in the previous
+ * chunk, and the heading itself opens a NEW chunk — so a chapter jump starts
+ * exactly at the heading even when a divider page ("《书名》作者") shares the
+ * sentence segment with it.
+ *
+ * A clean short heading (< = MAX_HEADING_CHARS) gets its own dedicated chunk so
+ * the TTS reads the chapter title alone with a natural pause before the body;
+ * long/inline-polluted headings fall back to the old merge (title + body in the
+ * same chunk) so we never turn a whole paragraph into a "heading" block.
+ *
+ * Exported for tests (same pattern as parseBookStructure).
+ * Returns { chunks, fromChunkOfBreak } where fromChunkOfBreak[i] is the chunk
+ * index opened by breaks[i] (undefined if that break opened no chunk).
+ */
+export function splitBookChunks(text, breaks = null) {
+  const chunks = []
+  const fromChunkOfBreak = []
+  // Sentence segments with their original char offsets in `text`.
+  const segs = []
+  let segStart = 0
+  for (let i = 0; i < text.length; i++) {
+    if ('。！？；…'.indexOf(text[i]) !== -1) {
+      segs.push({ s: text.slice(segStart, i + 1), start: segStart })
+      segStart = i + 1
+    }
+  }
+  if (segStart < text.length) segs.push({ s: text.slice(segStart), start: segStart })
+  let cur = ''
+  let curOpener = -1 // break index that opened the chunk being accumulated
+  let bi = 0
+  const push = () => {
+    if (cur.trim().length > 0) {
+      if (curOpener >= 0) fromChunkOfBreak[curOpener] = chunks.length
+      chunks.push(cur.trim())
+    }
+    cur = ''
+    curOpener = -1
+  }
+  const addSentence = (rawSentence) => {
+    const sentence = rawSentence.replace(/\s*\n+\s*/g, ' ').trim()
+    if (sentence.length === 0) return
+    if (cur.length > 0 && cur.length + sentence.length > MAX_TTS_CHARS) push()
+    // A single sentence longer than the cap must be split itself.
+    if (sentence.length > MAX_TTS_CHARS) {
+      if (cur.length > 0) push()
+      for (let i = 0; i < sentence.length; i += MAX_TTS_CHARS) {
+        if (curOpener >= 0) fromChunkOfBreak[curOpener] = chunks.length
+        chunks.push(sentence.slice(i, i + MAX_TTS_CHARS))
+        curOpener = -1
+      }
+    } else {
+      cur += sentence
+    }
+  }
+  for (const seg of segs) {
+    if (breaks && breaks.length > 0) {
+      while (bi < breaks.length && breaks[bi].start < seg.start) bi++
+      if (bi < breaks.length && breaks[bi].start < seg.start + seg.s.length) {
+        const off = breaks[bi].start - seg.start
+        if (off > 0) addSentence(seg.s.slice(0, off))
+        push()
+        const headingText = breaks[bi].text
+        // A clean short heading gets its own dedicated chunk so the TTS reads
+        // "第一章 闪电划过星空" alone with a natural pause before the body.
+        // Long headings are almost certainly inline-polluted (the parser has
+        // already merged the body into the heading string) — keep them merged.
+        const cleanShort = typeof headingText === 'string' && headingText.length > 0 && headingText.length <= MAX_HEADING_CHARS
+        if (cleanShort) {
+          const hEnd = headingEndInSegment(seg.s, off, headingText)
+          const headingPiece = seg.s.slice(off, hEnd).trim()
+          if (headingPiece.length > 0 && hEnd > off) {
+            curOpener = bi // the heading chunk opens this section
+            addSentence(headingPiece)
+            push() // records fromChunkOfBreak[bi] = heading chunk index
+            addSentence(seg.s.slice(hEnd)) // body continues in a fresh chunk
+          } else {
+            // Could not match the heading in the source — fall back to the
+            // original behaviour (heading + body share a chunk).
+            curOpener = bi
+            addSentence(seg.s.slice(off))
+          }
+        } else {
+          curOpener = bi
+          addSentence(seg.s.slice(off))
+        }
+        bi++
+        // swallow any further breaks inside this same segment (rare)
+        while (bi < breaks.length && breaks[bi].start < seg.start + seg.s.length) bi++
+        continue
+      }
+    }
+    addSentence(seg.s)
+  }
+  push()
+  if (chunks.length === 0) chunks.push(text.trim())
+  return { chunks, fromChunkOfBreak }
+}
+
 export const name = 'dsh-music-player'
 export const inject = ['webServer', 'fs', 'shell', 'tools', 'systemPrompt', 'llm']
 
@@ -355,7 +503,7 @@ export function apply(ctx) {
     id: t.id, name: t.name, url: t.url, size: t.size, ext: t.ext, path: t.path,
   }))
   const publicBooks = () => books.map((b) => ({
-    id: b.id, name: b.name, size: b.size, url: '/dsh-music/book/' + b.id,
+    id: b.id, name: b.name, size: b.size, url: '/dsh-music/book/' + b.id, path: b.path,
   }))
 
   // ---- 自建歌单（playlists）----
@@ -733,6 +881,7 @@ export function apply(ctx) {
     let fmtRate = -1
     let fmtCh = -1
     let fmtBits = -1
+    let fmtByteRate = -1
     let dataSize = -1
     let dataStart = -1
     let off = 12
@@ -743,6 +892,7 @@ export function apply(ctx) {
         fmtFormat = buf.readUInt16LE(off + 8)
         fmtCh = buf.readUInt16LE(off + 10)
         fmtRate = buf.readUInt32LE(off + 12)
+        fmtByteRate = buf.readUInt32LE(off + 16)
         fmtBits = buf.readUInt16LE(off + 22)
       } else if (id === 'data') {
         dataSize = sz
@@ -752,13 +902,45 @@ export function apply(ctx) {
       if (off > buf.length) break
     }
     const actualData = (dataSize >= 0 && dataStart >= 0) ? Math.min(dataSize, Math.max(0, buf.length - dataStart)) : 0
+    const available = (dataStart >= 0) ? Math.max(0, buf.length - dataStart) : 0
     const problems = []
     if (fmtFormat !== 1) problems.push('非 PCM 格式(fmt=' + fmtFormat + ')')
     if (!(fmtRate >= 4000 && fmtRate <= 192000)) problems.push('采样率异常(' + fmtRate + 'Hz)')
     if (!(fmtCh >= 1 && fmtCh <= 8)) problems.push('声道数异常(' + fmtCh + ')')
+    if (!(fmtBits === 8 || fmtBits === 16 || fmtBits === 24 || fmtBits === 32)) problems.push('位深异常(' + fmtBits + ')')
+    // Byte rate must be consistent with the header, else the browser computes a
+    // wildly wrong duration (duration = dataSize / byteRate) and "plays" silence
+    // for the inflated remainder — the "没声音但时长差 3 分钟" symptom.
+    if (fmtBits % 8 === 0 && fmtByteRate > 0 && fmtByteRate !== fmtRate * fmtCh * (fmtBits / 8)) {
+      problems.push('字节率异常(byteRate=' + fmtByteRate + '，应为' + (fmtRate * fmtCh * (fmtBits / 8)) + ')')
+    }
     if (dataSize < 2 || actualData < 2) problems.push('音频数据为空(data=' + dataSize + ')')
+    // Truncated data chunk: declared length bigger than what's actually in the
+    // buffer — same inflated-duration/silence symptom in the browser.
+    if (dataSize >= 0 && dataStart >= 0 && dataSize > available) {
+      problems.push('音频数据被截断(声明=' + dataSize + '，实际=' + available + ')')
+    }
+    // Sample-level silence detection: reject wavs whose PCM content is
+    // effectively silent (all samples near zero). Real speech peaks at 1e4~3e4
+    // (16-bit full scale 32767); genuine silence sits at ~0, so a low threshold
+    // never rejects real speech. Early-exit on the first audible sample, so real
+    // chunks are scanned almost instantly (only silent wavs scan the whole data).
+    if (fmtBits === 16 && actualData >= 2 && !problems.some((p) => p.startsWith('音频数据为空') || p.startsWith('音频数据被截断'))) {
+      const n = Math.floor(actualData / 2)
+      let peak = 0
+      for (let i = 0; i < n; i++) {
+        const a = Math.abs(buf.readInt16LE(dataStart + i * 2))
+        if (a > peak) peak = a
+        if (peak > 200) break
+      }
+      if (peak <= 200) problems.push('音频内容静音(峰值=' + peak + ')')
+    }
     if (problems.length > 0) {
-      logTts({ kind: 'degenerate', detail: problems.join('，') })
+      logTts({
+        kind: 'degenerate',
+        detail: problems.join('，'),
+        wav: { rate: fmtRate, ch: fmtCh, bits: fmtBits, byteRate: fmtByteRate, declared: dataSize, actual: available, bytes: buf.length },
+      })
       throw new Error('TTS 返回的 WAV 异常（' + problems.join('，') + '）——该段无法朗读，请重试或检查 API')
     }
   }
@@ -844,80 +1026,6 @@ export function apply(ctx) {
     return text
   }
 
-  // Split prose into natural chunks (<= MAX_TTS_CHARS each). Sentences are
-  // accumulated up to the cap (so each block is a few sentences of speech),
-  // only closing a block when the next sentence would overflow. Paragraph
-  // newlines are folded into whitespace. A single over-long sentence becomes
-  // its own block (hard-capped).
-  // Optional `breaks` = sorted char offsets in `text` where a NEW chunk must
-  // start. A break is applied at sub-segment precision: text before the break
-  // stays in the previous chunk, text from the break (the chapter heading)
-  // opens a fresh chunk — so a chapter jump starts exactly at the heading even
-  // when a divider page ("《书名》作者") shares the sentence segment with it.
-  // Returns { chunks, fromChunkOfBreak } where fromChunkOfBreak[i] is the chunk
-  // index opened by breaks[i] (undefined if that break opened no chunk).
-  const splitBookChunks = (text, breaks = null) => {
-    const chunks = []
-    const fromChunkOfBreak = []
-    // Sentence segments with their original char offsets in `text`.
-    const segs = []
-    let segStart = 0
-    for (let i = 0; i < text.length; i++) {
-      if ('。！？；…'.indexOf(text[i]) !== -1) {
-        segs.push({ s: text.slice(segStart, i + 1), start: segStart })
-        segStart = i + 1
-      }
-    }
-    if (segStart < text.length) segs.push({ s: text.slice(segStart), start: segStart })
-    let cur = ''
-    let curOpener = -1 // break index that opened the chunk being accumulated
-    let bi = 0
-    const push = () => {
-      if (cur.trim().length > 0) {
-        if (curOpener >= 0) fromChunkOfBreak[curOpener] = chunks.length
-        chunks.push(cur.trim())
-      }
-      cur = ''
-      curOpener = -1
-    }
-    const addSentence = (rawSentence) => {
-      const sentence = rawSentence.replace(/\s*\n+\s*/g, ' ').trim()
-      if (sentence.length === 0) return
-      if (cur.length > 0 && cur.length + sentence.length > MAX_TTS_CHARS) push()
-      // A single sentence longer than the cap must be split itself.
-      if (sentence.length > MAX_TTS_CHARS) {
-        if (cur.length > 0) push()
-        for (let i = 0; i < sentence.length; i += MAX_TTS_CHARS) {
-          if (curOpener >= 0) fromChunkOfBreak[curOpener] = chunks.length
-          chunks.push(sentence.slice(i, i + MAX_TTS_CHARS))
-          curOpener = -1
-        }
-      } else {
-        cur += sentence
-      }
-    }
-    for (const seg of segs) {
-      if (breaks && breaks.length > 0) {
-        while (bi < breaks.length && breaks[bi] < seg.start) bi++
-        if (bi < breaks.length && breaks[bi] < seg.start + seg.s.length) {
-          const off = breaks[bi] - seg.start
-          if (off > 0) addSentence(seg.s.slice(0, off))
-          push()
-          curOpener = bi
-          bi++
-          addSentence(seg.s.slice(off))
-          // swallow any further breaks inside this same segment (rare)
-          while (bi < breaks.length && breaks[bi] < seg.start + seg.s.length) bi++
-          continue
-        }
-      }
-      addSentence(seg.s)
-    }
-    push()
-    if (chunks.length === 0) chunks.push(text.trim())
-    return { chunks, fromChunkOfBreak }
-  }
-
   // Load a book's text and split into chunks; cache per path to avoid re-reading
   // the file on every block request. Chunks are aligned so each section heading
   // starts a new chunk (structure-aware), which makes chapter jumps exact.
@@ -929,7 +1037,9 @@ export function apply(ctx) {
     const st = bookStructCache[absPath] !== undefined
       ? bookStructCache[absPath]
       : (bookStructCache[absPath] = parseBookStructure(text, filenameHint || basename(absPath)))
-    const breaks = st.sections.map((s) => s.textStart).filter((n) => Number.isFinite(n) && n >= 0)
+    const breaks = st.sections
+      .filter((s) => Number.isFinite(s.textStart) && s.textStart >= 0)
+      .map((s) => ({ start: s.textStart, text: s.heading }))
     bookChunksCache[absPath] = splitBookChunks(text, breaks).chunks
     return bookChunksCache[absPath]
   }
@@ -947,7 +1057,9 @@ export function apply(ctx) {
     const st = bookStructCache[absPath] !== undefined
       ? bookStructCache[absPath]
       : (bookStructCache[absPath] = parseBookStructure(text, filenameHint))
-    const breaks = st.sections.map((s) => s.textStart).filter((n) => Number.isFinite(n) && n >= 0)
+    const breaks = st.sections
+      .filter((s) => Number.isFinite(s.textStart) && s.textStart >= 0)
+      .map((s) => ({ start: s.textStart, text: s.heading }))
     const { chunks, fromChunkOfBreak } = splitBookChunks(text, breaks)
     const cum = []
     let acc = 0
@@ -1000,6 +1112,35 @@ export function apply(ctx) {
     return out
   }
 
+  // Breadcrumb segments for an absolute native path, ordered from the root down
+  // to the deepest component. Each crumb carries its cumulative path so the
+  // browser picker can jump straight to any ancestor directory (and, at the
+  // root crumb, back to the filesystem root). The root itself (e.g. "/" or
+  // "C:\") is the leading crumb. The sentinel drive-list view has no real path,
+  // so it yields no crumbs.
+  const buildCrumbs = (abs) => {
+    if (!abs || abs === '__drives__') return []
+    const parsed = pathParse(abs)
+    const root = parsed.root || ''
+    const crumbs = []
+    if (root) crumbs.push({ name: root, path: root })
+    const parts = []
+    let d = parsed.dir
+    if (d && d !== root) {
+      while (d && d !== root) { parts.unshift(basename(d)); d = dirname(d) }
+    }
+    let cur = root
+    for (const p of parts) {
+      cur = cur === '' ? p : pathJoin(cur, p)
+      crumbs.push({ name: p, path: cur })
+    }
+    if (parsed.base && parsed.base !== root) {
+      cur = cur === '' ? parsed.base : pathJoin(cur, parsed.base)
+      crumbs.push({ name: parsed.base, path: cur })
+    }
+    return crumbs
+  }
+
   // ---- shared HTTP helpers ----
   const writeJson = (res, value, status) => {
     res.writeHead(status || 200, { 'content-type': 'application/json; charset=utf-8' })
@@ -1070,8 +1211,11 @@ export function apply(ctx) {
       }
       // List the immediate subdirectories of a library-visible path, for the
       // browser directory picker used by the playback-list "选择音乐目录" button.
-      // An empty/missing path starts from the user's home directory. Only
-      // directories are returned; file entries are skipped.
+      // List the immediate subdirectories AND files of a library-visible path,
+      // for the browser directory picker used by the playback-list
+      // "选择音乐目录" button. Directories come first (their entries are
+      // browsable); file entries are informational and not navigable. An
+      // empty/missing path starts from the user's home directory.
       if (pathname === '/dsh-music/dir' && req.method === 'GET') {
         await ensureStarted()
         const raw = url.searchParams.get('path') || ''
@@ -1088,9 +1232,9 @@ export function apply(ctx) {
                 const root = letter + ':\\'
                 try { if (existsSync(root)) roots.push({ name: root, path: root }) } catch {}
               }
-              writeJson(res, { path: '__drives__', name: '本机磁盘', up: null, dirs: roots })
+              writeJson(res, { path: '__drives__', name: '本机磁盘', up: null, dirs: roots, files: [], crumbs: [] })
             } else {
-              writeJson(res, { path: '/', name: '/', up: null, dirs: [] })
+              writeJson(res, { path: '/', name: '/', up: null, dirs: [], files: [], crumbs: buildCrumbs('/') })
             }
             return
           }
@@ -1114,11 +1258,15 @@ export function apply(ctx) {
             : dirname(abs)
           // Tolerant listing (see listEntries): skip unreadable entries so
           // drive roots like C:\ still show their normal folders instead of an
-          // empty list. Only directories are offered by the picker.
-          const dirs = listEntries(abs)
-            .filter((e) => e.isDir)
-            .map((e) => ({ name: e.name, path: pathJoin(abs, e.name) }))
-          writeJson(res, { path: abs, name: basename(abs) || abs, up, dirs })
+          // empty list. Directories are offered by the picker (browsable);
+          // plain files are listed after them purely as context (not navigable).
+          const dirs = []
+          const files = []
+          for (const e of listEntries(abs)) {
+            const item = { name: e.name, path: pathJoin(abs, e.name) }
+            if (e.isDir) dirs.push(item); else files.push(item)
+          }
+          writeJson(res, { path: abs, name: basename(abs) || abs, up, dirs, files, crumbs: buildCrumbs(abs) })
         } catch (err) {
           writeJson(res, { error: String((err && err.message) || err) }, 500)
         }
@@ -1309,9 +1457,9 @@ export function apply(ctx) {
                 const root = letter + ':\\'
                 try { if (existsSync(root)) roots.push({ name: root, path: root }) } catch {}
               }
-              writeJson(res, { path: '__drives__', name: '本机磁盘', up: null, dirs: roots, files: [] })
+              writeJson(res, { path: '__drives__', name: '本机磁盘', up: null, dirs: roots, files: [], crumbs: [] })
             } else {
-              writeJson(res, { path: '/', name: '/', up: null, dirs: [], files: [] })
+              writeJson(res, { path: '/', name: '/', up: null, dirs: [], files: [], crumbs: buildCrumbs('/') })
             }
             return
           }
@@ -1339,7 +1487,7 @@ export function apply(ctx) {
               }
             } catch { /* skip unreadable entries */ }
           }
-          writeJson(res, { path: abs, name: basename(abs) || abs, up, dirs, files })
+          writeJson(res, { path: abs, name: basename(abs) || abs, up, dirs, files, crumbs: buildCrumbs(abs) })
         } catch (err) {
           writeJson(res, { error: String((err && err.message) || err) }, 500)
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-music-player",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "DeepSeek Harness 本地音乐 + AI 讲书插件：Host 扫描音乐目录并以 HTTP 流式提供音频、解析 .txt 小说结构并经 MiMo TTS 合成朗读，浏览器侧提供播放条/播放面板/章节目录跳转/多声音选择/实时频谱，并注册 music_play 模型工具",
   "type": "module",
   "main": "lib/index.js",