dsh-music-player 0.5.1 → 0.5.3

package/README.md

@@ -4,7 +4,7 @@
 
 DeepSeek Harness 本地音乐/小说播放插件。
 
-写代码写累了、想摸鱼又不想切窗口？这个插件就是你的**摸鱼神器**——直接在 DeepSeek Harness 的网页里塞进一个本地音乐播放器：扫一下你电脑上的音乐目录（默认 `~/Music`）就能在浏览器里听歌，带播放条和可拖拽的播放面板，还能自己建歌单。
+写代码写累了、想摸鱼又不想切窗口？这个插件就是你的**摸鱼神器**——直接在 DeepSeek Harness 的网页里塞进一个 **DSH音乐播放器**：扫一下你电脑上的音乐目录（默认 `~/Music`）就能在浏览器里听歌，带播放条和可拖拽的播放面板，还能自己建歌单。
 
 光听歌还不够，它还能**听书**：把本地 `.txt` 小说丢给 AI 朗读，想听哪章点哪章、声音随便挑。最绝的是它还注册了 `music_play` 模型工具——你连鼠标都不用动，在对话框里跟 agent 说句「播放周杰伦的歌」，音乐分分钟响起来，摸鱼摸出新境界。
 
@@ -52,7 +52,7 @@ dsh plugin --profile <profile> add github:kendu76/dsh-music-player
 > 项目是手写的纯 JS（`lib/` 直接是发布产物），**没有**需要从源码构建的步骤，因此从 GitHub/npm 直装即可使用，无需像 TypeScript 包那样为构建脚本授权。
 
 安装后重启 DSH，打开 Web GUI：
-- 聊天输入区上方会出现「本地音乐播放器」播放条
+- 聊天输入区上方会出现「DSH音乐播放器」播放条
 - 点击右侧「列表」按钮打开播放面板
 - 在面板顶部点击「选择音乐目录」并选定音乐目录（默认 `~/Music`），自动递归扫描
 - 之后可直接在对话框里让 agent 播放，例如「播放周杰伦的歌」

package/lib/client.js

@@ -33,6 +33,30 @@ window.__ModuleLoader__.load({
       : (node) => node; // defensive fallback (react-dom is always provided by DSH)
     const portalToBody = (node) => createPortal(node, document.body);
 
+    // 以播放面板中心为基准的固定定位样式（面板可拖拽，弹窗随其居中）。
+    // halfW 为目标弹窗的近似半宽；maxH 为弹窗最大高度（px）：垂直 clamp 用
+    // maxH 的一半，保证 translate 居中后弹窗完整落在视口内；内容超过 maxH 时
+    // 由内部 .dsh-music-picker-list 滚动承载（底部按钮保持固定可见）。
+    // 面板不可见/无尺寸（如关闭态）时回退到视口中心。on 控制是否真正计算。
+    const panelCenterStyle = (panelRef, on, halfW, maxH) => {
+      if (!on) return null;
+      const pr = (panelRef && panelRef.current) ? panelRef.current.getBoundingClientRect() : null;
+      const vw = window.innerWidth, vh = window.innerHeight;
+      const cx = (pr && pr.width > 0) ? pr.left + pr.width / 2 : vw / 2;
+      const cy = (pr && pr.height > 0) ? pr.top + pr.height / 2 : vh / 2;
+      const clampC = (v, lo, hi) => (lo <= hi ? Math.max(lo, Math.min(v, hi)) : v);
+      const halfWm = Math.min(halfW, vw / 2);
+      const halfHm = Math.min(maxH / 2, vh / 2);
+      return {
+        position: 'fixed',
+        left: clampC(cx, halfWm, vw - halfWm),
+        top: clampC(cy, halfHm, vh - halfHm),
+        transform: 'translate(-50%, -50%)',
+        maxHeight: maxH + 'px',
+        margin: 0,
+      };
+    };
+
     // This host/environment throws a harmless, unhandled rejection from
     // Chromium's media pipeline — "Cannot read properties of undefined (reading
     // 'getTopURL')" — whenever an <audio> element loads or plays. Playback and
@@ -202,6 +226,12 @@ window.__ModuleLoader__.load({
       // 已收藏到「我喜欢」的歌曲 songid / songmid 集合（用于判断当前曲目是否已收藏）。
       qqFavIds: [],
       qqFavMids: [],
+      // 「我喜欢」收藏成功/取消成功后的递增计数，供 QQ 面板刷新该歌单数目。
+      qqFavRev: 0,
+      // 自定义输入弹窗（替代浏览器 prompt）：{ id, title, initial, onOk } | null。
+      prompt: null,
+      // 自定义确认弹窗（替代浏览器 confirm）：{ title, message, onOk, okText, danger } | null。
+      confirm: null,
     };
     const listeners = new Set();
     function set(patch) {
@@ -222,6 +252,24 @@ window.__ModuleLoader__.load({
       }, []);
       return snap;
     }
+    // 自定义输入弹窗（替代浏览器 prompt）：openPrompt 打开、closePrompt 关闭，
+    // onOk(value) 在用户点「确定」时收到去空格后的值；点「取消」/关闭不回调。
+    let promptSeq = 0;
+    function openPrompt(title, initial, onOk) {
+      set({ prompt: { id: ++promptSeq, title, initial: (initial || ''), onOk } });
+    }
+    function closePrompt() {
+      set({ prompt: null });
+    }
+    // 自定义确认弹窗（替代浏览器 confirm）：点「确定」回调 onOk()；
+    // 点「取消」/关闭/Esc 不回调。danger=true 时确定按钮用危险色提示。
+    function openConfirm(title, message, onOk, okText, danger) {
+      set({ confirm: { title, message: (message || ''), onOk, okText: (okText || '确定'), danger: !!danger } });
+    }
+    function closeConfirm() {
+      set({ confirm: null });
+    }
+
     const trackById = (id) => (store.tracks || []).find((t) => t.id === id) || null;
 
     // ---- 自建歌单：范围 / 解析 / 收藏 ----
@@ -340,6 +388,8 @@ window.__ModuleLoader__.load({
               set({ qqFavIds: idsA, qqFavMids: midsA });
               persistQQFav(idsA, midsA);
             }
+            // 通知 QQ 面板刷新「我喜欢」歌单的数目。
+            set({ qqFavRev: (store.qqFavRev || 0) + 1 });
           }
           else if (d && d.error) set({ error: d.error });
           else set({ error: '收藏失败（HTTP ' + status + '），请重试' });
@@ -409,59 +459,59 @@ window.__ModuleLoader__.load({
     }
     // 歌单管理：新建 / 重命名 / 删除 / 移动歌曲。
     function onCreatePlaylist() {
-      const name = window.prompt('新建歌单名称', '');
-      if (name === null) return;
-      const trimmed = name.trim();
-      if (trimmed === '') return;
-      fetch('/dsh-music/playlist', {
-        method: 'POST', cache: 'no-store',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({ name: trimmed }),
-      }).then((r) => r.json()).then((r) => {
-        if (r && r.playlist) {
-          set({ playlists: [...(store.playlists || []), r.playlist], subTab: r.playlist.id });
-        }
-      }).catch(() => {});
+      openPrompt('新建歌单名称', '', (trimmed) => {
+        if (!trimmed) return;
+        fetch('/dsh-music/playlist', {
+          method: 'POST', cache: 'no-store',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({ name: trimmed }),
+        }).then((r) => r.json()).then((r) => {
+          if (r && r.playlist) {
+            set({ playlists: [...(store.playlists || []), r.playlist], subTab: r.playlist.id });
+          }
+        }).catch(() => {});
+      });
     }
     function onRenamePlaylist(pl) {
-      const name = window.prompt('重命名歌单「' + pl.name + '」', pl.name);
-      if (name === null) return;
-      const trimmed = name.trim();
-      if (trimmed === '' || trimmed === pl.name) return;
-      fetch('/dsh-music/playlist/rename', {
-        method: 'POST', cache: 'no-store',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({ id: pl.id, name: trimmed }),
-      }).then((r) => r.json()).then((r) => { if (r && r.playlist) updatePlaylistInStore(r.playlist); }).catch(() => {});
+      openPrompt('重命名歌单「' + pl.name + '」', pl.name, (trimmed) => {
+        if (trimmed === pl.name) return;
+        fetch('/dsh-music/playlist/rename', {
+          method: 'POST', cache: 'no-store',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({ id: pl.id, name: trimmed }),
+        }).then((r) => r.json()).then((r) => { if (r && r.playlist) updatePlaylistInStore(r.playlist); }).catch(() => {});
+      });
     }
     function onDeletePlaylist(pl) {
-      if (!window.confirm('删除歌单「' + pl.name + '」？歌曲文件不会被删除。')) return;
-      fetch('/dsh-music/playlist/delete', {
-        method: 'POST', cache: 'no-store',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({ id: pl.id }),
-      }).then((r) => r.json()).then((r) => {
-        if (r && r.ok) {
-          const next = (store.playlists || []).filter((p) => p.id !== pl.id);
-          set({ playlists: next, subTab: 'library' });
-          if (store.scope && store.scope.kind === 'playlist' && store.scope.id === pl.id) {
-            set({ scope: { kind: 'library' } });
+      openConfirm('删除歌单', '删除歌单「' + pl.name + '」？歌曲文件不会被删除。', () => {
+        fetch('/dsh-music/playlist/delete', {
+          method: 'POST', cache: 'no-store',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({ id: pl.id }),
+        }).then((r) => r.json()).then((r) => {
+          if (r && r.ok) {
+            const next = (store.playlists || []).filter((p) => p.id !== pl.id);
+            set({ playlists: next, subTab: 'library' });
+            if (store.scope && store.scope.kind === 'playlist' && store.scope.id === pl.id) {
+              set({ scope: { kind: 'library' } });
+            }
           }
-        }
-      }).catch(() => {});
+        }).catch(() => {});
+      }, '删除', true);
     }
     // 一键清空歌单（任何歌单都可用，含系统「我最喜欢」；仅从歌单移除，不删文件）。
     function onClearPlaylist(pl) {
       const n = (pl.tracks || []).length;
       if (n === 0 && !pl.missing) return;
-      if (!window.confirm('清空歌单「' + pl.name + '」？将移除全部 ' + n + ' 首歌曲' + (pl.missing > 0 ? '（另有 ' + pl.missing + ' 首已失效一并清除）' : '') + '，歌曲文件不会被删除。')) return;
-      fetch('/dsh-music/playlist/clear', {
-        method: 'POST', cache: 'no-store',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({ id: pl.id }),
-      }).then((r) => r.json()).then((r) => {
-        if (r && r.playlist) updatePlaylistInStore(r.playlist);
-      }).catch(() => {});
+      openConfirm('清空歌单', '清空歌单「' + pl.name + '」？将移除全部 ' + n + ' 首歌曲' + (pl.missing > 0 ? '（另有 ' + pl.missing + ' 首已失效一并清除）' : '') + '，歌曲文件不会被删除。', () => {
+        fetch('/dsh-music/playlist/clear', {
+          method: 'POST', cache: 'no-store',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({ id: pl.id }),
+        }).then((r) => r.json()).then((r) => {
+          if (r && r.playlist) updatePlaylistInStore(r.playlist);
+        }).catch(() => {});
+      }, '确定', true);
     }
     function movePlaylistTrack(pl, path, dir) {
       const paths = (pl.tracks || []).map((t) => t.path);
@@ -710,6 +760,10 @@ window.__ModuleLoader__.load({
     let shuffleQueue = [];
     let shufflePos = -1;
     let shuffleScopeKey = null;
+    // 在线 QQ 队列连续失败的跳过次数：某首歌因版权下架/拿不到地址而触发
+    // <audio> error 时自动跳到下一首；连续跳过次数达到队列长度（整列都试过）
+    // 即停止报错——且停止后不再 step，杜绝无限循环跳歌。成功播放(onPlay)清零。
+    let qqErrorSkipCount = 0;
     function buildShuffleQueue(anchorId) {
       const ids = activeIds();
       // Fisher-Yates
@@ -1310,7 +1364,7 @@ window.__ModuleLoader__.load({
           set({ duration: (bookTimeBase() + audio.duration) });
         }
       };
-      const onPlay = () => { set({ playing: true, error: null }); acquireWakeLock(); };
+      const onPlay = () => { qqErrorSkipCount = 0; set({ playing: true, error: null }); acquireWakeLock(); };
       const onPause = () => { set({ playing: false }); savePlayback(); releaseWakeLock(); };
       const onEnded = () => {
         // A novel plays chunk-by-chunk: when a chunk ends, auto-advance to the
@@ -1359,6 +1413,17 @@ window.__ModuleLoader__.load({
             }).catch(() => {});
           }
         } else {
+          // 在线 QQ 队列：某首歌因版权下架/拿不到播放地址而加载失败时，自动
+          // 跳到下一首继续播放（不因单曲失败中断整个队列）；只有队列里就这一
+          // 首、或连续跳过次数已达队列长度（整列都试过）才停下报错——且停止后
+          // 不再 step，杜绝无限循环跳歌。
+          const isQQTrack = store.currentId !== null && String(store.currentId).startsWith('qq:');
+          const qLen = (store.qqQueue || []).length;
+          if (isQQTrack && qLen > 1 && qqErrorSkipCount < qLen) {
+            qqErrorSkipCount++;
+            step(1);
+            return;
+          }
           set({ error: '音频加载或解码失败', playing: false });
         }
       };
@@ -1798,7 +1863,7 @@ window.__ModuleLoader__.load({
         React.createElement('div', { className: 'dsh-music-bar' + (isBook ? ' book' : '') },
           hasTrack
             ? React.createElement('span', { className: 'dsh-music-bar-name', title: name + (artistText ? ' - ' + artistText : '') }, note, ' ', name, artistEl, sourceBadge, afterName)
-            : React.createElement('span', { className: 'dsh-music-bar-idle' }, note, ' 本地音乐播放器'),
+            : React.createElement('span', { className: 'dsh-music-bar-idle' }, note, ' DSH音乐播放器'),
           // 章节名独立占一整行、完整显示（不再被省略号截断）。
           sectionBadge,
           !isBook && hasTrack && s.playing ? React.createElement('canvas', { className: 'dsh-music-viz', width: 64, height: 14, ref: (el) => { barCanvasNode = el; } }) : null,
@@ -1980,7 +2045,7 @@ window.__ModuleLoader__.load({
     // 在线 QQ 面板的「上次所在层」只在本次会话首次挂载时恢复一次，避免切 tab
     // （QQ 音乐 ↔ 本地音乐/AI讲书）重新挂载时又被 localStorage 里的旧层拉回播放列表页。
     let qqUiRestored = false;
-    function QQOnlinePanel() {
+    function QQOnlinePanel({ panelRef }) {
       const s = useStore();
       const [loggedIn, setLoggedIn] = useState(s.qqLoggedIn || false);
       const [uin, setUin] = useState(s.qqUin || '');
@@ -1998,6 +2063,15 @@ window.__ModuleLoader__.load({
       const [plResults, setPlResults] = useState([]);
       const [qError, setQError] = useState('');
       const [resultTab, setResultTab] = useState('songs'); // 搜索结果内：songs | playlists
+      // 搜索分页：page 从 1 起、每页 20。「是否还有下一页」由最近一页是否返回满页判断，
+      // 不依赖 QQ 接口必返的 totalnum（歌单搜索的 totalnum 可能缺失/不可靠）。
+      const QQLIST_PAGE = 20;
+      const [searchPage, setSearchPage] = useState(1);
+      const [searchLastLen, setSearchLastLen] = useState(0);
+      const [searchingMore, setSearchingMore] = useState(false);
+      const [plSearchPage, setPlSearchPage] = useState(1);
+      const [plSearchLastLen, setPlSearchLastLen] = useState(0);
+      const [plSearchingMore, setPlSearchingMore] = useState(false);
       // 搜索历史（localStorage 持久化，最近在前）。
       const [hist, setHist] = useState([]);
       const [histOpen, setHistOpen] = useState(false);
@@ -2011,6 +2085,17 @@ window.__ModuleLoader__.load({
       const [curCategory, setCurCategory] = useState(null);
       const [browseErr, setBrowseErr] = useState('');
       const [browseLoading, setBrowseLoading] = useState(false);
+      // 「加入歌单」弹窗：{ song, x, y }（锚点=「＋」按钮的视口坐标），点击弹出我的歌单列表。
+      const [qqJoin, setQqJoin] = useState(null);
+      const [qqJoinMsg, setQqJoinMsg] = useState('');
+      const qqJoinRef = useRef(null);
+      // 点击弹窗外关闭「加入歌单」弹窗。
+      useEffect(() => {
+        if (qqJoin === null) return;
+        const onDown = (e) => { if (qqJoinRef.current !== null && !qqJoinRef.current.contains(e.target)) setQqJoin(null); };
+        document.addEventListener('mousedown', onDown);
+        return () => document.removeEventListener('mousedown', onDown);
+      }, [qqJoin]);
       // 推荐歌单加载更多：热门推荐 12 条后用「全部分类」分页续载。
       const [recPage, setRecPage] = useState(1);
       const [recLoadingMore, setRecLoadingMore] = useState(false);
@@ -2064,20 +2149,34 @@ window.__ModuleLoader__.load({
           setActivePl({ name: s.qqSource || '在线播放列表', songs: s.qqQueue || [], source: s.qqSource || '在线' });
         }
       };
+      // ① 挂载时只做本地初始化：读搜索历史（localStorage）+ 查登录态（status 由
+      // host 读本地 cookie 文件，不发任何外部网络请求）。外部数据（分类/推荐/我的
+      // 歌单）一律延后到登录后（见下方 [loggedIn] effect），未登录零外部请求——
+      // 本插件 QQ 在线功能以「登录」为门槛。
       useEffect(() => {
         setHist(loadHist());
         jsonGet('/dsh-music/qq/status').then((d) => { if (d) { setLoggedIn(!!d.loggedIn); setUin(d.uin || ''); setNickname(d.nickname || ''); } }).catch(() => {});
-        json('/dsh-music/qq/playlist-categories').then((d) => { if (d && d.ok) setCategories(d.categories || []); });
-        // 默认落在「我的歌单」tab：登录态下加载我的歌单；未登录时主 UI 不显示。
-        loadMine();
-        loadRecommended();
-        // 仅本次会话首次挂载时恢复上次所在层；之后切 tab 重挂不再拉回旧层。
-        if (!qqUiRestored) { qqUiRestored = true; restoreUi(loadUi()); }
         // 点击搜索框外时关闭历史下拉。
         const onDocClick = (e) => { if (histRef.current !== null && !histRef.current.contains(e.target)) setHistOpen(false); };
         document.addEventListener('mousedown', onDocClick);
         return () => { clearPoll(); document.removeEventListener('mousedown', onDocClick); };
       }, []);
+      // ② 登录态变化时才加载在线数据：未登录（loggedIn=false）一个外部请求都不发；
+      // 登录成功（setLoggedIn(true)）或已登录刷新页面（status 返回 true）时自动加载
+      // 分类 / 我的歌单 / 推荐，并恢复上次所在层。登出后不再加载。
+      useEffect(() => {
+        if (!loggedIn) return;
+        json('/dsh-music/qq/playlist-categories').then((d) => { if (d && d.ok) setCategories(d.categories || []); });
+        // 默认落在「我的歌单」tab：登录态下加载我的歌单；未登录时主 UI 不显示。
+        loadMine();
+        loadRecommended();
+        // 仅本次会话首次登录时恢复上次所在层；之后切 tab 重挂不再拉回旧层。
+        if (!qqUiRestored) { qqUiRestored = true; restoreUi(loadUi()); }
+      }, [loggedIn]);
+      // ③ 收藏/取消收藏「我喜欢」后刷新「我的歌单」，让「我喜欢」歌单数目随之更新。
+      useEffect(() => {
+        if (s.qqFavRev > 0 && loggedIn) loadMine();
+      }, [s.qqFavRev]);
 
       async function loadRecommended() {
         setBrowseLoading(true); setBrowseErr('');
@@ -2175,12 +2274,14 @@ window.__ModuleLoader__.load({
         setHistOpen(false);
         saveHist(kw);
         setSearching(true); setQError(''); setResults([]); setPlResults([]); setSearched(true); setCurCategory(null);
+        setSearchPage(1); setSearchLastLen(0); setPlSearchPage(1); setPlSearchLastLen(0);
         const [songs, pls] = await Promise.all([
-          json('/dsh-music/qq/search?w=' + encodeURIComponent(kw)),
-          json('/dsh-music/qq/playlist-search?w=' + encodeURIComponent(kw)),
+          json('/dsh-music/qq/search?w=' + encodeURIComponent(kw) + '&page=1'),
+          json('/dsh-music/qq/playlist-search?w=' + encodeURIComponent(kw) + '&page=1'),
         ]);
-        if (songs && songs.ok) setResults(songs.results || []); else setQError((songs && songs.error) || '歌曲搜索失败');
-        if (pls && pls.ok) setPlResults(pls.playlists || []);
+        if (songs && songs.ok) { setResults(songs.results || []); setSearchLastLen((songs.results || []).length); setSearchPage(songs.page || 1); }
+        else setQError((songs && songs.error) || '歌曲搜索失败');
+        if (pls && pls.ok) { setPlResults(pls.playlists || []); setPlSearchLastLen((pls.playlists || []).length); setPlSearchPage(pls.page || 1); }
         // 默认打开「有结果」的那个 tab（歌曲优先）。
         const sLen = (songs && songs.ok && (songs.results || []).length) || 0;
         const pLen = (pls && pls.ok && (pls.playlists || []).length) || 0;
@@ -2188,6 +2289,37 @@ window.__ModuleLoader__.load({
         else if (pLen > 0) setResultTab('playlists');
         setSearching(false);
       }
+      // 搜索结果「加载更多」：追加下一页（共用当前关键词 q）。
+      async function loadMoreSongs() {
+        const kw = q.trim();
+        if (kw === '' || searchingMore) return;
+        const next = searchPage + 1;
+        setSearchingMore(true);
+        try {
+          const d = await json('/dsh-music/qq/search?w=' + encodeURIComponent(kw) + '&page=' + next);
+          if (d && d.ok) {
+            setResults((cur) => cur.concat(d.results || []));
+            setSearchLastLen((d.results || []).length);
+            setSearchPage(d.page || next);
+          }
+        } catch {}
+        setSearchingMore(false);
+      }
+      async function loadMorePls() {
+        const kw = q.trim();
+        if (kw === '' || plSearchingMore) return;
+        const next = plSearchPage + 1;
+        setPlSearchingMore(true);
+        try {
+          const d = await json('/dsh-music/qq/playlist-search?w=' + encodeURIComponent(kw) + '&page=' + next);
+          if (d && d.ok) {
+            setPlResults((cur) => cur.concat(d.playlists || []));
+            setPlSearchLastLen((d.playlists || []).length);
+            setPlSearchPage(d.page || next);
+          }
+        } catch {}
+        setPlSearchingMore(false);
+      }
       function playSong(song, queue, sourceLabel) {
         // 未登录时点击 VIP 歌曲：不要启动注定失败的播放（否则播放条会误报
         // 「频谱不可用/音频加载失败」，重试也无济于事），改为提示并弹出登录。
@@ -2246,15 +2378,79 @@ window.__ModuleLoader__.load({
         const playing = active && s.playing;
         const vip = song.payplay === 1;
         const artists = (song.artists || []).join('/');
-        return React.createElement('button', {
-          key: id, className: 'dsh-music-track' + (active ? ' active' : ''), title: song.title + ' - ' + artists,
-          onClick: () => { if (active) togglePlay(); else playSong(song, queue, sourceLabel); },
-        },
-          React.createElement('span', { className: 'dsh-music-track-name qq' },
-            React.createElement('span', { className: 'dsh-music-track-title' }, (playing ? '▶ ' : '') + song.title),
-            vip ? React.createElement('span', { className: 'dsh-music-online-tag vip' }, 'VIP') : null),
-          React.createElement('span', { className: 'dsh-music-online-tag' }, artists || 'QQ'));
+        return React.createElement('div', { key: id, className: 'dsh-music-track-row' + (active ? ' active' : '') },
+          React.createElement('button', {
+            className: 'dsh-music-track' + (active ? ' active' : ''), title: song.title + ' - ' + artists,
+            onClick: () => { if (active) togglePlay(); else playSong(song, queue, sourceLabel); },
+          },
+            React.createElement('span', { className: 'dsh-music-track-name qq' },
+              React.createElement('span', { className: 'dsh-music-track-title' }, (playing ? '▶ ' : '') + song.title),
+              vip ? React.createElement('span', { className: 'dsh-music-online-tag vip' }, 'VIP') : null),
+            React.createElement('span', { className: 'dsh-music-online-tag' }, artists || 'QQ')),
+          React.createElement('button', {
+            className: 'dsh-music-playlist-mini add',
+            title: '加入我的歌单',
+            onClick: (e) => { e.stopPropagation(); openQqJoin(song, e); },
+          }, '＋'));
       };
+      // 「加入歌单」：打开弹窗（列出我的歌单），并把歌曲加入所选歌单 / 新建歌单。
+      function openQqJoin(song, e) {
+        const r = e.currentTarget.getBoundingClientRect();
+        if (minePlays.length === 0 && !mineLoaded) loadMine();
+        setQqJoinMsg('');
+        setQqJoin({ song, x: r.right, y: r.top });
+      }
+      async function qqJoinAddTo(pl) {
+        const song = qqJoin && qqJoin.song;
+        if (!song) return;
+        try {
+          // dirId 用歌单的权威 dirId（dirid），tid 固定 0（「我喜欢」dirId=201,tid=0 的可用模式）。
+          const d = await jsonPost('/dsh-music/qq/playlist-add', { song, dirId: (pl && (pl.dirId || pl.tid || pl.id)) || 0, tid: 0 });
+          if (!d || !d.ok) throw new Error((d && d.error) || '加入歌单失败');
+          // 本地乐观 +1，并异步刷新「我的歌单」，让数目与实际一致。
+          if (pl) {
+            const pid = String(pl.id);
+            setMinePlays((cur) => cur.map((p) => (String(p.id) === pid ? { ...p, trackCount: (Number(p.trackCount) || 0) + 1 } : p)));
+            loadMine();
+          }
+          setQqJoin(null);
+        } catch (err) { setQqJoinMsg(String((err && err.message) || err)); }
+      }
+      async function qqJoinCreate() {
+        const song = qqJoin && qqJoin.song;
+        openPrompt('新建歌单名称', '', async (trimmed) => {
+          if (!trimmed) return;
+          try {
+            const d = await jsonPost('/dsh-music/qq/playlist-create', { name: trimmed });
+            if (!d || !d.ok || !d.playlist) throw new Error((d && d.error) || '创建歌单失败');
+            const created = d.playlist;
+            // AddPlaylist 返回的 id 即新歌单 dirid；AddSonglist 用该 dirid + tid=0 加歌。
+            if (song) {
+              const add = await jsonPost('/dsh-music/qq/playlist-add', { song, dirId: Number(created.id) || 0, tid: 0 });
+              if (!add || !add.ok) throw new Error((add && add.error) || '加入新歌单失败');
+            }
+            loadMine();
+            setQqJoin(null);
+          } catch (err) { setQqJoinMsg(String((err && err.message) || err)); }
+        });
+      }
+      const qqJoinMenu = qqJoin ? portalToBody((() => {
+        const openUp = (qqJoin.y || 0) > ((window.innerHeight || 0) - 240);
+        const style = {
+          left: Math.max(8, (qqJoin.x || 0) - 150),
+          top: openUp ? (qqJoin.y || 0) - 6 : (qqJoin.y || 0) + 8,
+          transform: openUp ? 'translateY(-100%)' : 'none',
+        };
+        return React.createElement('div', { className: 'dsh-music-add-pop', ref: qqJoinRef, style },
+          qqJoinMsg ? React.createElement('div', { className: 'dsh-music-hint', style: { padding: '2px 8px', color: 'var(--dsw-alias-state-error-primary, #e5534b)' } }, qqJoinMsg) : null,
+          minePlays.length > 0 ? minePlays.map((p) => React.createElement('button', {
+            key: p.id, className: 'dsh-music-add-pop-item',
+            title: '加入「' + p.name + '」',
+            onClick: () => qqJoinAddTo(p),
+          }, p.name + (p.trackCount ? '（' + p.trackCount + '）' : ''))) : React.createElement('div', { className: 'dsh-music-hint', style: { padding: '2px 8px' } }, '暂无我的歌单，请先创建。'),
+          React.createElement('button', { className: 'dsh-music-add-pop-item new', onClick: qqJoinCreate }, '＋ 新建歌单'),
+        );
+      })()) : null;
       const playRow = (pl) => {
         const meta = (pl.trackCount > 0 ? pl.trackCount + ' 首' : '')
           + (pl.playCount ? ' · 播放 ' + fmtCount(pl.playCount) : '');
@@ -2313,8 +2509,10 @@ window.__ModuleLoader__.load({
             }, kw)))
           : null);
 
+      // 扫码框以面板中心为基准居中（面板可拖拽），贴边时 clamp 不被裁掉。
+      const qqLoginStyle = panelCenterStyle(panelRef, loginMode !== null, 170, 460);
       const loginModal = loginMode !== null ? portalToBody(React.createElement('div', { className: 'dsh-music-picker-overlay' },
-        React.createElement('div', { className: 'dsh-music-picker qq-login' },
+        React.createElement('div', { className: 'dsh-music-picker qq-login', style: qqLoginStyle },
           React.createElement('div', { className: 'dsh-music-picker-head' },
             React.createElement('span', { className: 'dsh-music-picker-title' }, 'QQ 音乐登录'),
             React.createElement('button', { className: 'dsh-music-icon-btn', title: '关闭', onClick: closeLogin }, '✕')),
@@ -2334,9 +2532,23 @@ window.__ModuleLoader__.load({
           React.createElement('div', { className: 'dsh-music-qq-login-center' },
             React.createElement('button', { className: 'dsh-music-qq-login-btn', onClick: () => startLogin('qq') }, 'QQ 登录'),
             React.createElement('button', { className: 'dsh-music-qq-login-btn', onClick: () => startLogin('wx') }, '微信登录'),
-            React.createElement('p', { className: 'dsh-music-qq-login-warn' },
-              '免责声明：扫码登录走非官方接口，仅供个人试听。登录及播放存在账号风控、封禁与合规风险，请知悉并自行承担后果；如有顾虑请勿登录。')),
-          loginModal);
+            React.createElement('div', { className: 'dsh-music-qq-login-warn' },
+              React.createElement('div', { className: 'dsh-music-qq-login-warn-title' }, '使用声明（重要）'),
+              React.createElement('div', { className: 'dsh-music-qq-login-warn-p' },
+                '在线 QQ 音乐功能通过非官方接口访问 QQ 音乐资源，所播放/收藏的内容版权归版权方及 QQ 音乐平台所有。本功能仅供个人学习、技术研究、日常试听使用，严禁用于任何商业用途、公开传播、二次分发或盈利行为。使用本功能即表示您已知悉并同意：'),
+              React.createElement('div', { className: 'dsh-music-qq-login-warn-item' },
+                React.createElement('span', { className: 'dsh-music-qq-login-warn-num' }, '1'),
+                React.createElement('span', null, '您应对自己的使用行为及其后果负责。')),
+              React.createElement('div', { className: 'dsh-music-qq-login-warn-item' },
+                React.createElement('span', { className: 'dsh-music-qq-login-warn-num' }, '2'),
+                React.createElement('span', null, '因使用非官方接口登录/播放导致的账号风控、封禁、限流，以及可能引发的法律、版权纠纷，均由使用者自行承担。')),
+              React.createElement('div', { className: 'dsh-music-qq-login-warn-item' },
+                React.createElement('span', { className: 'dsh-music-qq-login-warn-num' }, '3'),
+                React.createElement('span', null, '本项目作者不承担任何因此产生的直接或间接责任。')),
+              React.createElement('div', { className: 'dsh-music-qq-login-warn-p' },
+                '如您不同意以上条款，请勿使用本功能。'))),
+          loginModal,
+          qqJoinMenu);
       }
 
       // ---- 播放列表UI（第 2 层）：返回 + 可滚动歌曲列表 ----
@@ -2355,7 +2567,8 @@ window.__ModuleLoader__.load({
               : (pl.songs && pl.songs.length
                 ? React.createElement('div', null, pl.songs.map((song) => songRow(song, pl.songs, pl.name)))
                 : React.createElement('div', { className: 'dsh-music-hint' }, '暂无歌曲。'))),
-          loginModal);
+          loginModal,
+          qqJoinMenu);
       }
 
       // ---- 主UI（第 1 层）：顶部工具栏 + 4 个子tab，只滚动子tab内容区 ----
@@ -2364,6 +2577,17 @@ window.__ModuleLoader__.load({
         const hasSongs = results.length > 0;
         const hasPls = plResults.length > 0;
         let resultContent = null;
+        // 搜索分页「加载更多」按钮：最近一页返回满页（==20）就认为还有下一页。
+        const songMoreBtn = (searchLastLen >= QQLIST_PAGE)
+          ? React.createElement('div', { className: 'dsh-music-qq-loadmore' },
+            React.createElement('button', { className: 'dsh-music-qq-loadmore-btn', onClick: loadMoreSongs },
+              searchingMore ? '加载中…' : '加载更多'))
+          : null;
+        const plMoreBtn = (plSearchLastLen >= QQLIST_PAGE)
+          ? React.createElement('div', { className: 'dsh-music-qq-loadmore' },
+            React.createElement('button', { className: 'dsh-music-qq-loadmore-btn', onClick: loadMorePls },
+              plSearchingMore ? '加载中…' : '加载更多'))
+          : null;
         if (searching) {
           resultContent = React.createElement('div', { className: 'dsh-music-hint' }, '搜索中…');
         } else if (qError || !(hasSongs || hasPls)) {
@@ -2375,12 +2599,12 @@ window.__ModuleLoader__.load({
               resultTabBtn('songs', '歌曲'),
               resultTabBtn('playlists', '相关歌单')),
             resultTab === 'playlists'
-              ? plResults.map(playRow)
-              : results.map((song) => songRow(song, results, '搜索结果')));
+              ? React.createElement('div', null, plResults.map(playRow), plMoreBtn)
+              : React.createElement('div', null, results.map((song) => songRow(song, results, '搜索结果')), songMoreBtn));
         } else if (hasSongs) {
-          resultContent = results.map((song) => songRow(song, results, '搜索结果'));
+          resultContent = React.createElement('div', null, results.map((song) => songRow(song, results, '搜索结果')), songMoreBtn);
         } else {
-          resultContent = plResults.map(playRow);
+          resultContent = React.createElement('div', null, plResults.map(playRow), plMoreBtn);
         }
         body = React.createElement('div', null, searchBox,
           searched ? React.createElement('div', null, resultContent) : null);
@@ -2500,6 +2724,7 @@ window.__ModuleLoader__.load({
         head,
         React.createElement('div', { className: 'dsh-music-qq-body' }, body),
         loginModal,
+        qqJoinMenu,
       );
     }
 
@@ -2526,7 +2751,10 @@ window.__ModuleLoader__.load({
       // with only top+left and the CSS max-height:72vh still applying, a fixed
       // element whose CSS also sets the translate would collapse/clamp and shift
       // by half its own size while dragging.
-      const style = pos === null ? null : { left: pos.x, top: pos.y, width: pos.w, height: pos.h, maxHeight: 'none', transform: 'none' };
+      // 面板常驻不卸载：关闭时仅用 display:none 隐藏（子树、QQ 面板状态全保留），
+      // 重新打开时按播放类别重设 tab（见 togglePanel）并恢复显示。因此组件不会
+      // 在关闭时 unmount，切 tab / 关面板重开都不会丢内部 useState 状态。
+      const rootStyle = { ...(pos === null ? null : { left: pos.x, top: pos.y, width: pos.w, height: pos.h, maxHeight: 'none', transform: 'none' }), display: s.panelOpen ? '' : 'none' };
 
       const onHeadDown = (e) => {
         if (e.button !== undefined && e.button !== 0) return;
@@ -2615,9 +2843,10 @@ window.__ModuleLoader__.load({
         // The directory/file pickers are portaled to <body>, so a click inside
         // them is technically outside the panel's DOM — treat those as "inside"
         // so interacting with the picker never closes the panel underneath.
+        // The「加入歌单」弹窗（含本地+QQ）同样 portal 到 body，点击其内菜单不应关面板。
         const onDown = (e) => {
           if (panelRef.current !== null && !panelRef.current.contains(e.target)
-            && !(e.target.closest && e.target.closest('.dsh-music-picker-overlay'))) {
+            && !(e.target.closest && (e.target.closest('.dsh-music-picker-overlay') || e.target.closest('.dsh-music-add-pop')))) {
             set({ panelOpen: false });
           }
         };
@@ -2633,7 +2862,7 @@ window.__ModuleLoader__.load({
       }, [s.panelOpen, s.currentId]);
       // 面板关闭时清掉「加入歌单」弹层状态，避免重开面板时残留。
       useEffect(() => { if (!s.panelOpen) setAddMenu(null); }, [s.panelOpen]);
-      if (!s.panelOpen) return null;
+      // 面板常驻不卸载：关闭时用根 div 的 display:none 隐藏，而非 return null。
       const rows = s.tracks.map((t) => {
         const active = t.id === s.currentId;
         const playing = active && s.playing;
@@ -2693,20 +2922,29 @@ window.__ModuleLoader__.load({
       const isPlaylistView = s.subTab !== 'library';
       const plView = isPlaylistView ? playlistById(s.subTab) : null;
       const musicBody = plView
-        ? React.createElement(PlaylistDetail, { pl: plView })
+        ? React.createElement(PlaylistDetail, { pl: plView, panelRef })
         : (rows.length > 0
           ? rows
           : React.createElement('div', { className: 'dsh-music-empty' }, '暂无音乐。点击上方“选择音乐目录”并选择目录后自动扫描。'));
-      const listBody = s.tab === 'music'
-        ? musicBody
-        : s.tab === 'qq'
-          ? React.createElement(QQOnlinePanel, null)
-          : (s.books.length > 0
-            ? bookRows
-            : (s.ttsConfigured
-              ? React.createElement('div', { className: 'dsh-music-empty' }, '未发现 .txt 小说文件。')
-              : React.createElement('div', { className: 'dsh-music-error' }, s.ttsReason || '未配置xiaomi提供方。')));
-      return React.createElement('div', { className: 'dsh-music-panel', ref: panelRef, style },
+      // 三个 tab 的内容常驻渲染、非活动 tab 用 display:none 隐藏：这样切 tab 时
+      // 不会卸载任何面板（本地音乐 / QQ 面板 / AI 讲书），各自内部 useState 状态
+      // 全部保留（例如 QQ 面板当前在「我的歌单/搜索/歌单详情」的哪个 UI）。
+      const paneStyle = (key) => ({ display: s.tab === key ? '' : 'none' });
+      const bookEmptyBody = s.books.length > 0
+        ? bookRows
+        : (s.ttsConfigured
+          ? React.createElement('div', { className: 'dsh-music-empty' }, '未发现 .txt 小说文件。')
+          : React.createElement('div', { className: 'dsh-music-error' }, s.ttsReason || '未配置xiaomi提供方。'));
+      // 三个 pane 直接在 .dsh-music-list（flex column）里；仅 QQ pane 设
+      // flex:1 + min-height:0 + overflow:hidden（见 .dsh-music-qq-pane），让
+      // .dsh-music-qq 撑满 pane 高度、.dsh-music-qq-body 独立滚动：播放列表 UI
+      // 只滚歌曲列表，head（返回按钮/歌单名）固定不滚。本地音乐/讲书 pane 保持
+      // 普通块级，超高时仍由 .dsh-music-list 滚动。
+      const listBody = React.createElement('div', { className: 'dsh-music-list-body' },
+        React.createElement('div', { style: paneStyle('music') }, musicBody),
+        React.createElement('div', { className: 'dsh-music-qq-pane', style: paneStyle('qq') }, React.createElement(QQOnlinePanel, { panelRef })),
+        React.createElement('div', { style: paneStyle('book') }, bookEmptyBody));
+      return React.createElement('div', { className: 'dsh-music-panel', ref: panelRef, style: rootStyle },
         React.createElement('div', {
           className: 'dsh-music-panel-head dsh-music-panel-drag',
           onPointerDown: onHeadDown, onPointerMove: onHeadMove, onPointerUp: onHeadUp,
@@ -2715,7 +2953,7 @@ window.__ModuleLoader__.load({
           React.createElement('span', { className: 'dsh-music-panel-title' }, '播放列表'),
           React.createElement('button', { className: 'dsh-music-icon-btn', title: '关闭', onClick: () => set({ panelOpen: false }) }, '✕')),
         React.createElement('div', { className: 'dsh-music-tabs' }, tabBtn('music', '本地音乐'), tabBtn('qq', 'QQ音乐'), tabBtn('book', 'AI讲书')),
-        s.tab === 'qq' ? null : React.createElement(DirectorySetting, null),
+        s.tab === 'qq' ? null : React.createElement(DirectorySetting, { panelRef }),
         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).
@@ -2728,11 +2966,71 @@ window.__ModuleLoader__.load({
           track: addMenu.track, anchor: { x: addMenu.x, y: addMenu.y },
           onClose: () => setAddMenu(null),
         }) : null,
+        s.prompt ? React.createElement(PromptModal, { key: s.prompt.id, panelRef }) : null,
+        s.confirm ? React.createElement(ConfirmModal, { key: s.confirm.title, panelRef }) : null,
       );
     }
+    // 自定义输入弹窗（替代浏览器 prompt）：新建/重命名歌单等需要名称输入的场景。
+    // 以面板中心为基准居中；回车=确定、Esc/点遮罩/关闭=取消。key 由父级传 id，
+    // 保证每次 openPrompt 打开时重新挂载、初始输入值正确。
+    function PromptModal({ panelRef }) {
+      const s = useStore();
+      const p = s.prompt;
+      if (p === null) return null;
+      const [value, setValue] = useState(p.initial || '');
+      const inputRef = useRef(null);
+      useEffect(() => { if (inputRef.current) { inputRef.current.focus(); inputRef.current.select(); } }, []);
+      const submit = () => {
+        const v = value.trim();
+        if (v === '') return;
+        closePrompt();
+        if (typeof p.onOk === 'function') p.onOk(v);
+      };
+      const cancel = () => closePrompt();
+      const onKeyDown = (e) => {
+        if (e.key === 'Enter') { e.preventDefault(); submit(); }
+        else if (e.key === 'Escape') { e.preventDefault(); cancel(); }
+      };
+      return portalToBody(React.createElement('div', { className: 'dsh-music-picker-overlay' },
+        React.createElement('div', { className: 'dsh-music-picker prompt', style: panelCenterStyle(panelRef, true, 150, 160) },
+          React.createElement('div', { className: 'dsh-music-picker-head' },
+            React.createElement('span', { className: 'dsh-music-picker-title' }, p.title),
+            React.createElement('button', { className: 'dsh-music-icon-btn', title: '关闭', onClick: cancel }, '✕')),
+          React.createElement('input', {
+            className: 'dsh-music-prompt-input', ref: inputRef, value,
+            placeholder: '请输入名称', onChange: (e) => setValue(e.target.value), onKeyDown,
+            'aria-label': p.title,
+          }),
+          React.createElement('div', { className: 'dsh-music-picker-foot' },
+            React.createElement('button', { className: 'dsh-music-settings-btn', onClick: submit }, '确定'),
+            React.createElement('button', { className: 'dsh-music-settings-btn ghost', onClick: cancel }, '取消')),
+        )));
+    }
+    // 自定义确认弹窗（替代浏览器 confirm）：删除/清空歌单等破坏性操作前的确认。
+    // 无输入框，仅标题 + 提示消息 + 确定/取消；以面板中心为基准居中。
+    function ConfirmModal({ panelRef }) {
+      const s = useStore();
+      const c = s.confirm;
+      if (c === null) return null;
+      const ok = () => { closeConfirm(); if (typeof c.onOk === 'function') c.onOk(); };
+      const onKeyDown = (e) => {
+        if (e.key === 'Enter') { e.preventDefault(); ok(); }
+        else if (e.key === 'Escape') { e.preventDefault(); closeConfirm(); }
+      };
+      return portalToBody(React.createElement('div', { className: 'dsh-music-picker-overlay' },
+        React.createElement('div', { className: 'dsh-music-picker confirm', style: panelCenterStyle(panelRef, true, 150, 280), onKeyDown },
+          React.createElement('div', { className: 'dsh-music-picker-head' },
+            React.createElement('span', { className: 'dsh-music-picker-title' }, c.title),
+            React.createElement('button', { className: 'dsh-music-icon-btn', title: '关闭', onClick: closeConfirm }, '✕')),
+          c.message ? React.createElement('p', { className: 'dsh-music-hint' }, c.message) : null,
+          React.createElement('div', { className: 'dsh-music-picker-foot' },
+            React.createElement('button', { className: 'dsh-music-settings-btn' + (c.danger ? ' danger' : ''), onClick: ok }, c.okText),
+            React.createElement('button', { className: 'dsh-music-settings-btn ghost', onClick: closeConfirm }, '取消')),
+        )));
+    }
     // Directory setting block, embedded in the player panel (the former
     // 设置 → 音乐播放器 page moved in-panel so all library config lives in one place).
-    function DirectorySetting() {
+    function DirectorySetting({ panelRef }) {
       const s = useStore();
       const [pickerOpen, setPickerOpen] = useState(false);
       const [dirs, setDirs] = useState([]);
@@ -2754,9 +3052,10 @@ window.__ModuleLoader__.load({
           React.createElement('button', { className: 'dsh-music-settings-btn', onClick: () => openPicker() }, pickerTitle)),
         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', style: panelCenterStyle(panelRef, pickerOpen, 320, Math.round(window.innerHeight * 0.72)) },
             React.createElement('div', { className: 'dsh-music-picker-head' },
-              React.createElement('span', { className: 'dsh-music-picker-title' }, pickerTitle)),
+              React.createElement('span', { className: 'dsh-music-picker-title' }, pickerTitle),
+              React.createElement('button', { className: 'dsh-music-icon-btn', title: '关闭', onClick: () => setPickerOpen(false) }, '✕')),
             React.createElement('div', { className: 'dsh-music-picker-cur', title: curPath },
               renderCrumbs(curCrumbs, curPath, curName, browse)),
             React.createElement('div', { className: 'dsh-music-picker-list' },
@@ -2828,20 +3127,19 @@ window.__ModuleLoader__.load({
       const list = store.playlists || [];
       const addTo = (id) => { apiPlaylistAdd(id, [track.path], () => onClose()); };
       const addNew = () => {
-        const name = window.prompt('新建歌单名称', '');
-        if (name === null) return;
-        const trimmed = name.trim();
-        if (trimmed === '') return;
-        fetch('/dsh-music/playlist', {
-          method: 'POST', cache: 'no-store',
-          headers: { 'content-type': 'application/json' },
-          body: JSON.stringify({ name: trimmed }),
-        }).then((r) => r.json()).then((r) => {
-          if (r && r.playlist) {
-            set({ playlists: [...(store.playlists || []), r.playlist] });
-            apiPlaylistAdd(r.playlist.id, [track.path], () => onClose());
-          }
-        }).catch(() => onClose());
+        openPrompt('新建歌单名称', '', (trimmed) => {
+          if (!trimmed) return;
+          fetch('/dsh-music/playlist', {
+            method: 'POST', cache: 'no-store',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ name: trimmed }),
+          }).then((r) => r.json()).then((r) => {
+            if (r && r.playlist) {
+              set({ playlists: [...(store.playlists || []), r.playlist] });
+              apiPlaylistAdd(r.playlist.id, [track.path], () => onClose());
+            }
+          }).catch(() => onClose());
+        });
       };
       return React.createElement('div', { className: 'dsh-music-add-pop', ref, style },
         list.length > 0 ? list.map((p) => React.createElement('button', {
@@ -2854,7 +3152,7 @@ window.__ModuleLoader__.load({
       );
     }
     // 歌单详情：添加歌曲 + 重命名/删除 + 歌曲列表（移除/上移/下移）。
-    function PlaylistDetail({ pl }) {
+    function PlaylistDetail({ pl, panelRef }) {
       const [pickerOpen, setPickerOpen] = useState(false);
       const rows = (pl.tracks || []).map((t, idx) => {
         const active = t.id === store.currentId;
@@ -2884,11 +3182,11 @@ window.__ModuleLoader__.load({
           pl.missing > 0 ? React.createElement('span', { className: 'dsh-music-playlist-missing', title: '部分歌曲文件已被移动或删除' }, pl.missing + ' 首已失效') : null,
         ),
         rows.length > 0 ? rows : React.createElement('div', { className: 'dsh-music-empty dsh-music-playlist-empty' }, '歌单为空，点击「添加歌曲」从本地文件选择音乐。'),
-        pickerOpen ? React.createElement(FilePicker, { pl, onClose: () => setPickerOpen(false) }) : null,
+        pickerOpen ? React.createElement(FilePicker, { pl, panelRef, onClose: () => setPickerOpen(false) }) : null,
       );
     }
     // 文件系统多选器：浏览目录 + 勾选音频文件，用于歌单「添加歌曲」。
-    function FilePicker({ pl, onClose }) {
+    function FilePicker({ pl, panelRef, onClose }) {
       const [cur, setCur] = useState({ path: '', name: '', dirs: [], files: [], crumbs: [] });
       const [sel, setSel] = useState(new Set());
       const [err, setErr] = useState(null);
@@ -2915,10 +3213,10 @@ window.__ModuleLoader__.load({
         apiPlaylistAdd(pl.id, paths, () => onClose());
       };
       return portalToBody(React.createElement('div', { className: 'dsh-music-picker-overlay' },
-        React.createElement('div', { className: 'dsh-music-picker' },
+        React.createElement('div', { className: 'dsh-music-picker', style: panelCenterStyle(panelRef, true, 320, Math.round(window.innerHeight * 0.72)) },
           React.createElement('div', { className: 'dsh-music-picker-head' },
             React.createElement('span', { className: 'dsh-music-picker-title' }, '添加歌曲到「' + pl.name + '」'),
-          ),
+            React.createElement('button', { className: 'dsh-music-icon-btn', title: '关闭', onClick: onClose }, '✕')),
           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' },
@@ -3140,6 +3438,12 @@ window.__ModuleLoader__.load({
       '.dsh-music-mode-item:hover { background: var(--dsw-alias-bg-layer-2, rgba(255,255,255,0.06)); color: var(--dsh-music-accent, #2f9e6e); }\n' +
       '.dsh-music-mode-item.active { background: var(--dsh-music-accent, #2f9e6e); color: var(--dsh-music-accent-fg, #fff); }\n' +
       '.dsh-music-list { flex: 1; overflow-y: auto; display: flex; flex-direction: column; gap: 2px; min-height: 60px; max-height: 40vh; }\n' +
+      // pane 层的包裹 div：改成 flex 列容器（否则它是块级元素，QQ pane 的 flex:1
+      // 不生效、没有确定高度，导致 .dsh-music-qq-body 不滚动、整棵被 .dsh-music-list
+      // 滚走 → 滚动条会盖住固定的 head）。设为 flex:1+min-height:0 撑满列表区高度：
+      // QQ pane 内的 .dsh-music-qq-body 成为唯一滚动容器，滚动条只出现在 head 下方。
+      // 本地音乐/讲书 pane 因 min-height:auto 不会被压缩、仍超高溢出、由列表滚动，行为不变。
+      '.dsh-music-list-body { flex: 1; min-height: 0; display: flex; flex-direction: column; }\n' +
       '.dsh-music-track { display: flex; align-items: center; gap: 8px; width: 100%; text-align: left; padding: 6px 8px; border: none; background: transparent; border-radius: 6px; color: var(--dsw-alias-label-primary, #e6e6e6); cursor: pointer; font-size: 12px; }\n' +
       '.dsh-music-track:hover { background: var(--dsw-alias-bg-layer-2, rgba(255,255,255,0.06)); }\n' +
       '.dsh-music-track.active { color: var(--dsh-music-accent, #2f9e6e); }\n' +
@@ -3169,10 +3473,11 @@ window.__ModuleLoader__.load({
       '.dsh-music-settings-cur { flex: 1; min-width: 0; padding: 6px 10px; border-radius: 8px; border: 1px solid var(--dsw-alias-border-l1, rgba(128,128,128,0.3)); background: var(--dsw-alias-bg-layer-1, rgba(0,0,0,0.04)); color: var(--dsw-alias-label-primary, #e6e6e6); font-size: 12px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }\n' +
       '.dsh-music-settings-btn { padding: 6px 12px; border-radius: 8px; border: none; background: var(--dsh-music-accent, #2f9e6e); color: var(--dsh-music-accent-fg, #fff); cursor: pointer; font-size: 13px; white-space: nowrap; }\n' +
       '.dsh-music-settings-btn.ghost { background: transparent; border: 1px solid var(--dsw-alias-border-l1, rgba(128,128,128,0.3)); color: var(--dsw-alias-label-secondary, #8a8f98); }\n' +
+      '.dsh-music-settings-btn.danger { background: #c9352c; color: #fff; }\n' +
       '.dsh-music-picker-overlay { position: fixed; inset: 0; z-index: 2000; display: flex; overflow: auto; padding: 16px; background: rgba(0,0,0,0.45); }\n' +
       '.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-title { font-weight: 600; margin-right: auto; }\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' +
@@ -3186,7 +3491,12 @@ window.__ModuleLoader__.load({
       '.dsh-music-picker-item:hover { background: var(--dsw-alias-bg-layer-2, rgba(255,255,255,0.06)); }\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-picker-foot { display: flex; gap: 8px; justify-content: flex-end; flex: none; }\n' +
+      // 自定义输入弹窗（新建/重命名歌单）的输入框。
+      '.dsh-music-prompt-input { box-sizing: border-box; width: 100%; padding: 8px 10px; font-size: 13px; color: var(--dsw-alias-label-primary, #e6e6e6); background: var(--dsw-alias-bg-layer-2, rgba(255,255,255,0.06)); border: 1px solid var(--dsw-alias-border-l2, rgba(128,128,128,0.35)); border-radius: 8px; outline: none; }\n' +
+      '.dsh-music-prompt-input:focus { border-color: var(--dsh-music-accent, #2f9e6e); }\n' +
+      // 新建/重命名/删除/清空弹窗较窄，不用居中列表那种 640px 宽。
+      '.dsh-music-picker.prompt, .dsh-music-picker.confirm { width: 300px; max-width: 90vw; }\n' +
       '.dsh-music-hint { font-size: 12px; color: var(--dsw-alias-label-secondary, #8a8f98); }\n' +
       // ---- 在线 QQ 音乐 ----
       '.dsh-music-qq { display: flex; flex-direction: column; gap: 10px; }\n' +
@@ -3221,8 +3531,14 @@ window.__ModuleLoader__.load({
       '.dsh-music-qq-topname { font-weight: 600; }\n' +
       '.dsh-music-qq-topmeta { font-size: 12px; color: var(--dsw-alias-label-secondary, #8a8f98); }\n' +
       '.dsh-music-qq-detail-head { display: flex; gap: 8px; align-items: center; margin: 6px 0; }\n' +
-      '.dsh-music-qq { display: flex; flex-direction: column; flex: 1; min-height: 0; }\n' +
-      '.dsh-music-qq-head { flex: none; z-index: 3; background: var(--dsw-alias-bg-overlay, #1e1f22); padding-bottom: 4px; }\n' +
+      '.dsh-music-qq { display: flex; flex-direction: column; flex: 1; min-height: 0; height: 100%; }\n' +
+      // QQ 面板所在 pane 不设 overflow:hidden（否则它自身会成为一个滚动容器，把
+      // sticky 的 head 困在内部、无法吸附到真正滚动的 .dsh-music-list）。pane 保持
+      // 普通流式布局，滚动交给 head 下方的 .dsh-music-list / .dsh-music-qq-body。
+      '.dsh-music-qq-pane { flex: 1; min-height: 0; overflow: visible; display: flex; flex-direction: column; }\n' +
+      // head 用 sticky 固定在滚动区顶部：无论实际滚动容器是 .dsh-music-list
+      // 还是 .dsh-music-qq-body，返回按钮行 / 子tab 行都不会被列表滚走（内容在其下方滑动）。
+      '.dsh-music-qq-head { flex: none; position: sticky; top: 0; z-index: 3; background: var(--dsw-alias-bg-overlay, #1e1f22); padding-bottom: 4px; }\n' +
       '.dsh-music-qq-body { flex: 1; overflow-y: auto; min-height: 0; }\n' +
       '.dsh-music-qq-section { font-size: 12px; color: var(--dsw-alias-label-secondary, #8a8f98); margin: 10px 0 4px; font-weight: 600; }\n' +
       '.dsh-music-qq-now { display: flex; align-items: center; gap: 4px; padding: 6px 10px; border-radius: 8px; border: 1px solid var(--dsw-alias-border-l1, rgba(128,128,128,0.3)); background: var(--dsw-alias-bg-layer-1, rgba(0,0,0,0.04)); font-size: 12px; color: var(--dsw-alias-label-primary, #e6e6e6); }\n' +
@@ -3233,7 +3549,12 @@ window.__ModuleLoader__.load({
       '.dsh-music-qq-login { flex: 1; min-height: 200px; display: flex; align-items: center; justify-content: center; }\n' +
       '.dsh-music-qq-login-center { display: flex; flex-direction: column; gap: 12px; align-items: center; max-width: 320px; }\n' +
       '.dsh-music-qq-login-btn { width: 200px; padding: 10px 16px; font-size: 15px; }\n' +
-      '.dsh-music-qq-login-warn { font-size: 12px; color: var(--dsw-alias-state-warn-primary, #d9a441); text-align: center; line-height: 1.6; margin-top: 4px; }\n' +
+      // 免责声明：居中块内的左对齐编号列表，阅读更清晰。
+      '.dsh-music-qq-login-warn { display: flex; flex-direction: column; gap: 4px; width: 100%; max-width: 300px; margin-top: 4px; font-size: 12px; color: var(--dsw-alias-state-warn-primary, #d9a441); line-height: 1.5; text-align: left; box-sizing: border-box; max-height: 30vh; overflow-y: auto; }\n' +
+      '.dsh-music-qq-login-warn-title { font-weight: 600; margin-bottom: 2px; }\n' +
+      '.dsh-music-qq-login-warn-p { margin: 0; }\n' +
+      '.dsh-music-qq-login-warn-item { display: flex; gap: 6px; align-items: flex-start; }\n' +
+      '.dsh-music-qq-login-warn-num { flex: none; }\n' +
       // 讲书时章节名是主信息：占满剩余弹性空间、尽量完整显示；书名让出空间（可截断）。
       '.dsh-music-bar.book .dsh-music-bar-name { max-width: 24%; }\n' +
       '.dsh-music-bar-section { margin-left: 8px; flex: 0 1 auto; min-width: 0; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; color: var(--dsw-alias-label-secondary, #8a8f98); font-size: 11px; border: 1px solid var(--dsw-alias-border-l1, rgba(128,128,128,0.25)); border-radius: 6px; padding: 0 6px; line-height: 16px; }\n' +

package/lib/index.js

@@ -1592,11 +1592,12 @@ export function apply(ctx) {
       if (pathname === '/dsh-music/qq/search' && req.method === 'GET') {
         const w = (url.searchParams.get('w') || '').trim()
         if (w === '') { writeJson(res, { ok: false, error: 'missing query' }, 400); return }
+        const page = Math.max(1, parseInt(url.searchParams.get('page') || '1', 10) || 1)
         await loadQQCookie()
         try {
           const isVip = await refreshQQVip()
-          const results = await QQ.search(w, qq.cookie)
-          writeJson(res, { ok: true, isVip, results })
+          const s = await QQ.search(w, qq.cookie, page)
+          writeJson(res, { ok: true, isVip, results: s.results, total: s.total, page: s.page })
         } catch (err) {
           writeJson(res, { ok: false, error: String((err && err.message) || err) }, 502)
         }
@@ -1643,8 +1644,12 @@ export function apply(ctx) {
       if (pathname === '/dsh-music/qq/playlist-search' && req.method === 'GET') {
         const w = (url.searchParams.get('w') || '').trim()
         if (w === '') { writeJson(res, { ok: false, error: 'missing query' }, 400); return }
+        const page = Math.max(1, parseInt(url.searchParams.get('page') || '1', 10) || 1)
         await loadQQCookie()
-        try { writeJson(res, { ok: true, playlists: await QQ.searchPlaylist(w, qq.cookie) }) }
+        try {
+          const s = await QQ.searchPlaylist(w, qq.cookie, page)
+          writeJson(res, { ok: true, playlists: s.results, total: s.total, page: s.page })
+        }
         catch (err) { writeJson(res, { ok: false, error: String((err && err.message) || err) }, 502) }
         return
       }
@@ -1680,6 +1685,31 @@ export function apply(ctx) {
         } catch (err) { writeJson(res, { ok: false, error: String((err && err.message) || err) }, 502) }
         return
       }
+      // 把在线歌曲加入某个自建歌单（dirId/tid 取自我的歌单）。
+      if (pathname === '/dsh-music/qq/playlist-add' && req.method === 'POST') {
+        const body = await readBody(req)
+        const song = (body && body.song) || {}
+        const dirId = Number((body && body.dirId)) || 0
+        const tid = Number((body && body.tid)) || 0
+        await loadQQCookie()
+        try {
+          const ok = await QQ.addSongToPlaylist(song, dirId, tid, qq.cookie)
+          writeJson(res, { ok })
+        } catch (err) { writeJson(res, { ok: false, error: String((err && err.message) || err) }, 502) }
+        return
+      }
+      // 创建自建歌单（DirCreate），返回新歌单 id/name。
+      if (pathname === '/dsh-music/qq/playlist-create' && req.method === 'POST') {
+        const body = await readBody(req)
+        const name = String((body && body.name) || '').trim()
+        if (name === '') { writeJson(res, { ok: false, error: '歌单名不能为空' }, 400); return }
+        await loadQQCookie()
+        try {
+          const created = await QQ.createPlaylist(name, qq.cookie)
+          writeJson(res, { ok: true, playlist: created })
+        } catch (err) { writeJson(res, { ok: false, error: String((err && err.message) || err) }, 502) }
+        return
+      }
       // 获取「我喜欢」已收藏歌曲的 songid + songmid 列表（供播放时判断当前曲目是否已收藏）。
       if (pathname === '/dsh-music/qq/liked' && req.method === 'GET') {
         await loadQQCookie()
@@ -1900,7 +1930,7 @@ export function apply(ctx) {
       if (action === 'play' && source === 'web' && query0 !== '') {
         try {
           const isVip = await refreshQQVip()
-          const results = await QQ.search(query0, qq.cookie)
+          const { results } = await QQ.search(query0, qq.cookie)
           if (results.length === 0) {
             return { action, played: false, track: '', matches: 0, count: 0, notice: '在线 QQ 音乐未找到「' + query0 + '」' }
           }
@@ -1967,7 +1997,7 @@ export function apply(ctx) {
   // ---- light prompt hint so the agent knows it can play local music/novels ----
   ctx.systemPrompt.section({
     name: 'tool:music-player', order: 116,
-    text: '本机已挂载本地音乐播放器与 AI 讲书：可用 music_play 工具按关键词播放 ~/Music（或设置的目录）里的音乐，或按歌单名播放自建歌单（playlist 参数），或按小说名播放本地 .txt 小说（AI 讲书，需配置xiaomi提供方）；也可传 source=web 播放在线 QQ 音乐（需在播放面板登录，登录后可播 VIP/高音质）；并支持 action 暂停/继续/停止/下一首·下一章/上一首·上一章。',
+    text: '本机已挂载 DSH音乐播放器 与 AI 讲书：可用 music_play 工具按关键词播放 ~/Music（或设置的目录）里的音乐，或按歌单名播放自建歌单（playlist 参数），或按小说名播放本地 .txt 小说（AI 讲书，需配置xiaomi提供方）；也可传 source=web 播放在线 QQ 音乐（需在播放面板登录，登录后可播 VIP/高音质）；并支持 action 暂停/继续/停止/下一首·下一章/上一首·上一章。',
   })
 
   void loadQQCookie()

package/lib/qq.js

@@ -320,14 +320,16 @@ function parseWXUUID(raw) {
 // =====================================================================
 // 搜索（legacy，匿名可用）与登录态取链（UrlGetVkey，可反 VIP/高音质）
 // =====================================================================
-// 歌曲搜索：返回歌曲数组（兼容既有调用方：results[0].songmid / results.length）。
-export async function search(keyword, cookie = '') {
-  const url = `https://c.y.qq.com/soso/fcgi-bin/client_search_cp?${new URLSearchParams({ w: keyword, format: 'json', p: '1', n: '20', t: '0', cr: '1' }).toString()}`
+// 歌曲搜索：支持分页（page 从 1 起，每页 n=20）。返回 { results, total, page }，
+// total 为 QQ 接口返回的总条数（totalnum），取不到时回退为当前页条数。
+export async function search(keyword, cookie = '', page = 1) {
+  const p = Math.max(1, parseInt(page, 10) || 1)
+  const url = `https://c.y.qq.com/soso/fcgi-bin/client_search_cp?${new URLSearchParams({ w: keyword, format: 'json', p: String(p), n: '20', t: '0', cr: '1' }).toString()}`
   const headers = { 'User-Agent': UA, 'Referer': 'https://y.qq.com/' }
   if (cookie) headers['Cookie'] = cookie
   const res = await fetchWithTimeout(url, { headers })
   const j = await res.json()
-  return (j.data?.song?.list || []).map(s => ({
+  const results = (j.data?.song?.list || []).map(s => ({
     id: s.songmid, songmid: s.songmid, title: dec(s.songname),
     songid: s.songid, songtype: s.songtype || 0,
     artists: (s.singer || []).map(x => dec(x.name)),
@@ -335,6 +337,8 @@ export async function search(keyword, cookie = '') {
     payplay: s.pay?.payplay, pay: s.pay,
     source: 'qq',
   }))
+  const total = Number(j.data?.song?.totalnum) || results.length
+  return { results, total, page: p }
 }
 
 export async function detectVip(cookie) {
@@ -437,19 +441,23 @@ export async function getCategoryPlaylists(categoryID = '10000000', page = 1, li
   }))
 }
 
-export async function searchPlaylist(keyword, cookie = '') {
-  const p = new URLSearchParams({ query: keyword, page_no: '0', num_per_page: '20', format: 'json', remoteplace: 'txt.yqq.playlist', flag_qc: '0' })
-  const apiURL = `http://c.y.qq.com/soso/fcgi-bin/client_music_search_songlist?${p.toString()}`
+export async function searchPlaylist(keyword, cookie = '', page = 1) {
+  const p = Math.max(1, parseInt(page, 10) || 1)
+  const param = new URLSearchParams({ query: keyword, page_no: String(p - 1), num_per_page: '20', format: 'json', remoteplace: 'txt.yqq.playlist', flag_qc: '0' })
+  const apiURL = `http://c.y.qq.com/soso/fcgi-bin/client_music_search_songlist?${param.toString()}`
   const res = await fetchWithTimeout(apiURL, { headers: { 'User-Agent': UA, 'Referer': 'https://y.qq.com/portal/search.html', ...(cookie ? { Cookie: cookie } : {}) } })
   let text = await res.text()
   const i = text.indexOf('('); const e = text.lastIndexOf(')')
   if (i >= 0 && e > i) text = text.slice(i + 1, e)
   const j = JSON.parse(text)
-  return (j.data && j.data.list || []).filter((x) => x.dissid && x.dissname).map((x) => ({
+  const results = (j.data && j.data.list || []).filter((x) => x.dissid && x.dissname).map((x) => ({
     id: x.dissid, name: dec(x.dissname), cover: httpsCover(x.imgurl),
     trackCount: x.song_count || 0, playCount: x.listennum || 0, creator: dec((x.creator && x.creator.name) || ''),
     source: 'qq', link: plLink(x.dissid),
   }))
+  const d = j.data || {}
+  const total = Number(d.totalnum ?? d.total_num) || results.length
+  return { results, total, page: p }
 }
 
 export async function getPlaylistSongs(id, cookie = '') {
@@ -520,7 +528,8 @@ export async function getMyPlaylists(cookie = '') {
   if (Number(res.code) !== 0) throw new Error('获取我的歌单失败：' + ((res.message || res.msg) || ('code ' + res.code)) + '｜raw=' + rawSnippet(res))
   const list = res.data?.v_playlist || []
   return list.filter((x) => x.tid && x.dirName).map((x) => ({
-    id: String(x.tid), name: dec(x.dirName), cover: httpsCover(x.picUrl),
+    id: String(x.tid), dirId: Number(x.dirId) || Number(x.tid) || 0, tid: Number(x.tid) || 0,
+    name: dec(x.dirName), cover: httpsCover(x.picUrl),
     trackCount: x.songNum || 0, playCount: 0, creator: dec(x.nick || ''), source: 'qq', link: plLink(x.tid),
   }))
 }
@@ -549,40 +558,39 @@ function qqGtk(musickey) {
   return h & 0x7fffffff
 }
 
-// 把歌曲加入/移出「我喜欢」歌单（dirId 固定 201）。song 需含 songid（数值）、songtype。
-// 参考 qq-music-api 的 music.musicasset.PlaylistDetailWrite / AddSonglist(DelSonglist)。
-async function qqFavWrite(song, cookie, method) {
-  if (!cookie || !song) throw new Error('未登录，无法收藏')
+// 通用的「歌单写操作」：调用指定 module 的写接口。
+// method 为 AddSonglist / DelSonglist（PlaylistDetailWrite）或 AddPlaylist / DelPlaylist（PlaylistBaseWrite）。
+// 成功返回 res.data（可能为 {}）；失败抛错。写操作需要登录态 + g_tk(CSRF)。
+async function playlistDetailWrite(method, param, cookie, module = 'music.musicasset.PlaylistDetailWrite') {
+  if (!cookie) throw new Error('未登录，无法操作歌单')
   const { comm, musickey } = buildAuthedComm(cookie)
-  // 写操作需要 g_tk（CSRF）。
   const g_tk = qqGtk(musickey)
   if (g_tk) { comm.g_tk = g_tk; comm.g_tk_new_20200303 = g_tk }
-  const songId = Number(song.songid) || 0
-  if (!songId) throw new Error('缺少歌曲 songid，无法收藏')
-  const body = {
-    comm,
-    req_0: {
-      module: 'music.musicasset.PlaylistDetailWrite',
-      method,
-      param: {
-        dirId: 201,
-        tid: 0,
-        bFmtUtf8: true,
-        v_songInfo: [{ songId, songType: Number(song.songtype) || 0 }],
-      },
-    },
-  }
+  const body = { comm, req_0: { module, method, param } }
   const j = await postMusicu(body, cookie)
-  const res = j.req_0 || j['music.musicasset.PlaylistDetailWrite']
+  const res = j.req_0 || j[module]
   const rawSnippet = (x) => { try { const s = JSON.stringify(x); return s ? s.slice(0, 300) : String(x) } catch { return String(x) } }
   const retCode = res?.data?.retCode
   if (retCode !== undefined) {
-    if (Number(retCode) === 0) return true
-    throw new Error('收藏接口失败（retCode=' + retCode + '，raw=' + rawSnippet(j) + '）')
+    if (Number(retCode) === 0) return res.data || {}
+    throw new Error('歌单操作失败（retCode=' + retCode + '，raw=' + rawSnippet(j) + '）')
   }
   const code = res ? Number(res.code) : (j.code !== undefined ? Number(j.code) : NaN)
-  if (code === 0) return true
-  throw new Error('收藏接口失败（code=' + code + '，raw=' + rawSnippet(j) + '）')
+  if (code === 0) return (res && res.data) || {}
+  throw new Error('歌单操作失败（code=' + code + '｜method=' + method + '｜param=' + rawSnippet(param) + '｜raw=' + rawSnippet(j) + '）')
+}
+
+// 收藏/取消收藏歌曲到「我喜欢」（dirId 固定 201）。song 需含 songid（数值）、songtype。
+async function qqFavWrite(song, cookie, method) {
+  const songId = Number(song.songid) || 0
+  if (!songId) throw new Error('缺少歌曲 songid，无法收藏')
+  await playlistDetailWrite(method, {
+    dirId: 201,
+    tid: 0,
+    bFmtUtf8: true,
+    v_songInfo: [{ songId, songType: Number(song.songtype) || 0 }],
+  }, cookie)
+  return true
 }
 
 export async function addQQFav(song, cookie = '') {
@@ -592,6 +600,30 @@ export async function removeQQFav(song, cookie = '') {
   return qqFavWrite(song, cookie, 'DelSonglist')
 }
 
+// 把歌曲加入某个自建歌单（dirId = 该歌单的目录 id，tid = 歌单 tid，可为 0）。
+export async function addSongToPlaylist(song, dirId, tid = 0, cookie = '') {
+  const songId = Number(song.songid) || 0
+  if (!songId) throw new Error('缺少歌曲 songid，无法加入歌单')
+  await playlistDetailWrite('AddSonglist', {
+    dirId: Number(dirId) || 0,
+    tid: Number(tid) || 0,
+    bFmtUtf8: true,
+    v_songInfo: [{ songId, songType: Number(song.songtype) || 0 }],
+  }, cookie)
+  return true
+}
+
+// 创建自建歌单（AddPlaylist / PlaylistBaseWrite），返回 { id, name }。
+// AddPlaylist 响应把新歌单信息嵌套在 data.result 下（dirId/dirName/tid）。
+export async function createPlaylist(name, cookie = '') {
+  const dirName = String(name || '').trim()
+  if (dirName === '') throw new Error('歌单名不能为空')
+  const data = await playlistDetailWrite('AddPlaylist', { dirName }, cookie, 'music.musicasset.PlaylistBaseWrite')
+  const result = (data && data.result) || data || {}
+  const id = Number(result.dirId) || Number(result.dirid) || Number(result.tid) || Number(result.id) || Number(result.content_id) || 0
+  return { id, name: dec(result.dirName || result.dirname || result.name || dirName) }
+}
+
 // 获取「我喜欢」（dirid=201）里已收藏歌曲的 songid + songmid 集合，用于播放时判断当前曲目是否已收藏。
 // 返回 { ids: number[], mids: string[] }——songmid 是稳定字符串标识，避免 songid 大整数/类型不一致导致匹配失败。
 export async function getQQFavIds(cookie = '') {

package/package.json

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