skill-forge-hub 1.1.0 → 1.2.0

package/prompt-pouch/resources/reference.html

@@ -3,7 +3,7 @@
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<meta name="sf-template" content="prompt-pouch@2">
+<meta name="sf-template" content="prompt-pouch@9">
 <meta name="pouch-id" content="REF-POUCH-0000">
 <title>锦囊 Prompt Pouch — 提示词管理台</title>
 <style>
@@ -200,12 +200,13 @@ header{
 /* 侧栏 */
 aside{ width:200px; flex:0 0 auto;
   display:flex; flex-direction:column;
-  position:sticky; top:80px; align-self:flex-start;
-  height:calc(100vh - 100px);
+  align-self:flex-start; /* 自然流式随页面整体滚动：说明卡完整展示，页面滚到底即可读完 */
 }
-/* 侧栏分组滚动区：收藏 + 分组局部滚动，分组下方紧跟「＋ 新建分组」，滚动流末尾附「锦囊用法」说明——滚动区占满「全部」与侧栏底缘之间的剩余屏幕高度（最大占满屏幕），说明被顶出首屏（滚到底可见）；窄滚动条 */
+/* 侧栏分组滚动区：收藏 + 分组局部滚动——滚动区最大高度 = 视口高度减去顶栏、「全部」行与底部「锦囊用法」说明卡（完整展示不裁剪），分组再多说明卡也完整可见；窄滚动条 */
 .nav-scroll{
-  flex:1 1 auto; min-height:0; overflow-y:auto;
+  flex:0 0 auto; min-height:0;
+  max-height:calc(100vh - 360px);
+  overflow-y:auto;
   margin:0 -4px 0 0; padding-right:4px;
   scrollbar-width:thin; scrollbar-color:var(--border) transparent;
 }
@@ -231,8 +232,8 @@ aside{ width:200px; flex:0 0 auto;
 }
 .nav-item.on .cnt{ color:var(--gold); background:var(--gold-dim); }
 .side-tip{
-  flex:0 0 auto;
-  margin:16px 4px 0 0; padding:12px 14px; border-radius:10px; /* margin-right 补偿 nav-scroll 负 margin（-4px）的右侧裁切，虚线边框完整不裁；滚动流末尾，分组多时被顶出首屏 */
+  flex:0 0 auto; /* 完整展示不裁剪：分组滚动区为其留出空间，侧栏随页面整体滚动即可读完 */
+  margin:12px 0 0 0; padding:12px 14px 14px; border-radius:10px;
   border:1px dashed var(--border); font-size:11px; line-height:1.9; color:var(--muted);
 }
 .side-tip b{ color:var(--gold); font-weight:700; }
@@ -246,13 +247,38 @@ main{ flex:1; min-width:0; }
   font-weight:900;
 }
 .bar .total{ font-size:12px; color:var(--muted); }
-.sort-box{ margin-left:auto; display:flex; align-items:center; gap:6px; font-size:11px; color:var(--muted); }
-.sort-box select{
+.sort-box{ margin-left:auto; display:flex; align-items:center; gap:6px; font-size:11px; color:var(--muted); position:relative; }
+.sort-sel{
+  display:flex; align-items:center; gap:7px;
   background:var(--panel2); border:1px solid var(--border); color:var(--text);
   font-family:inherit; font-size:12px; letter-spacing:1px;
-  border-radius:999px; padding:5px 12px; outline:none; cursor:pointer;
-}
-.sort-box select:focus{ border-color:var(--gold); }
+  border-radius:999px; padding:5px 13px; outline:none; cursor:pointer;
+  transition:border-color .15s ease;
+}
+.sort-sel:hover,.sort-sel.open{ border-color:var(--gold); }
+.sort-arrow{ font-size:9px; color:var(--gold); line-height:1; transition:transform .2s ease; }
+.sort-sel.open .sort-arrow{ transform:rotate(180deg); }
+.sort-menu{
+  position:absolute; top:calc(100% + 6px); right:0; z-index:130;
+  display:flex; flex-direction:column; gap:2px; min-width:136px;
+  background:var(--panel2); border:1px solid var(--border); border-radius:12px;
+  padding:5px; box-shadow:0 12px 32px rgba(0,0,0,.45);
+  animation:sortMenuIn .16s ease;
+}
+.sort-menu[hidden]{ display:none; }
+@keyframes sortMenuIn{ from{ opacity:0; transform:translateY(-4px); } to{ opacity:1; transform:none; } }
+.sort-opt{
+  display:flex; align-items:center; gap:8px; width:100%;
+  background:transparent; border:none; border-radius:8px;
+  color:var(--text); font-family:inherit; font-size:12px; letter-spacing:1px;
+  padding:7px 10px; cursor:pointer; text-align:left;
+  transition:background .12s ease,color .12s ease;
+}
+.sort-opt:hover{ background:var(--gold-dim); color:var(--gold); }
+.sort-check{ width:14px; font-size:11px; color:var(--gold); opacity:0; flex:0 0 auto; }
+.sort-opt.on{ color:var(--gold); font-weight:600; }
+.sort-opt.on .sort-check{ opacity:1; }
+[data-theme="light"] .sort-menu{ box-shadow:0 10px 28px rgba(30,31,34,.16); }
 .sort-status{
   font-size:12px; color:var(--muted);
   display:flex; align-items:center; gap:10px;
@@ -521,9 +547,10 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
 }
 /* 页面直写：侧栏分组管理 / 提示词表单 / toast */
 .nav-add{
-  display:flex; align-items:center; justify-content:center; gap:6px;
-  margin-top:10px; padding:10px 14px; border-radius:10px; cursor:pointer;
-  font-size:13px; letter-spacing:1px; color:var(--gold);
+  flex:0 0 auto; /* 「全部」行右侧迷你 + 图标（新建分组），行内不占独立高度 */
+  width:22px; height:22px; margin-left:6px;
+  display:flex; align-items:center; justify-content:center;
+  border-radius:6px; cursor:pointer; font-size:14px; line-height:1; color:var(--gold);
   border:1px dashed var(--border); background:var(--gold-dim);
   transition:all .18s ease; user-select:none;
 }
@@ -636,13 +663,16 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
       <span class="tag-filter" id="tagFilterChip" style="display:none"><span class="tf-ico">🏷</span><b id="tagFilterName"></b><button class="tf-x" id="tagFilterClear" title="清除标签过滤">✕</button></span>
       <button class="btn primary" id="btnAddItem">＋ 新增提示词</button>
       <div class="sort-box">
-        <label for="sortSel">排序</label>
-        <select id="sortSel" title="切换卡片排序方式">
-          <option value="added">最新添加</option>
-          <option value="recent">最近使用</option>
-          <option value="freq">使用频率</option>
-          <option value="manual">手动顺序</option>
-        </select>
+        <label>排序</label>
+        <button class="sort-sel" id="sortSel" type="button" title="切换卡片排序方式">
+          <span class="sort-sel-txt" id="sortTxt">最新添加</span><span class="sort-arrow">▾</span>
+        </button>
+        <div class="sort-menu" id="sortMenu" hidden>
+          <button class="sort-opt on" data-mode="added" type="button"><span class="sort-check">✓</span>最新添加</button>
+          <button class="sort-opt" data-mode="recent" type="button"><span class="sort-check">✓</span>最近使用</button>
+          <button class="sort-opt" data-mode="freq" type="button"><span class="sort-check">✓</span>使用频率</button>
+          <button class="sort-opt" data-mode="manual" type="button"><span class="sort-check">✓</span>手动顺序</button>
+        </div>
       </div>
       <div class="sort-status" id="sortStatus">
         <button class="btn" id="btnSortCmd" disabled>📋 复制变更指令</button>
@@ -812,6 +842,9 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
   var searchClear = document.getElementById('searchClear');
   var sortStatus = document.getElementById('sortStatus');
   var sortSel = document.getElementById('sortSel');
+  var sortMenu = document.getElementById('sortMenu');
+  var sortTxt = document.getElementById('sortTxt');
+  var SORT_LABELS = { added:'最新添加', recent:'最近使用', freq:'使用频率', manual:'手动顺序' };
   var btnSortCmd = document.getElementById('btnSortCmd');
   var btnMarkSaved = document.getElementById('btnMarkSaved');
   var bkStatus = document.getElementById('bkStatus');
@@ -944,16 +977,15 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
     var html = '';
     var all = state.data.prompts.length;
     var favN = state.data.prompts.filter(function(p){ return p.favorite; }).length;
-    html += '<div class="nav-item' + (state.curGroup==='all'?' on':'') + '" data-g="all"><span class="icon">🗂️</span>全部<span class="cnt">' + all + '</span></div>';
+    html += '<div class="nav-item' + (state.curGroup==='all'?' on':'') + '" data-g="all"><span class="icon">🗂️</span>全部<span class="cnt">' + all + '</span><span class="nav-add" id="navAdd" title="新建分组">＋</span></div>';
     html += '<div class="nav-scroll">';
     html += '<div class="nav-item' + (state.curGroup==='fav'?' on':'') + '" data-g="fav"><span class="icon">⭐</span>收藏<span class="cnt">' + favN + '</span></div>';
     state.data.groups.forEach(function(g){
       var n = state.data.prompts.filter(function(p){ return p.group === g.id; }).length;
       html += '<div class="nav-item' + (state.curGroup===g.id?' on':'') + '" data-g="' + g.id + '" draggable="true" title="拖拽调整分组顺序"><span class="icon">' + g.icon + '</span><span class="g-name">' + escapeHtml(g.name) + '</span><span class="cnt">' + n + '</span><span class="g-ops"><button class="g-edit" title="编辑分组">✎</button><button class="g-del" title="删除分组">🗑</button></span></div>';
     });
-    html += '<div class="nav-add" id="navAdd">＋ 新建分组</div>';
-    html += '<div class="side-tip"><b>锦囊用法</b><br>· 页面直接增删改：＋ 新建分组 / ＋ 新增提示词 / ✎ 编辑 / 🗑 删除（授权目录即写即存）<br>· 也可对 AI 说「把 XX 加到写作输出分组」<br>· 顶栏切换排序；⇄ 移组、拖卡片排序自动保存；拖分组条调整分组顺序<br>· 点卡片标签按标签筛选（再点取消）；标签悬停 ✕ 删 / ＋ 加；⤓ 导出 / ⤒ 导入 JSON 备份<br>· ⭐ 收藏常用 · 复制次数在卡片右上角</div>';
     html += '</div>';
+    html += '<div class="side-tip"><b>锦囊用法</b><br>· 页面直接增删改：＋ 新建分组 / ＋ 新增提示词 / ✎ 编辑 / 🗑 删除（授权目录即写即存）<br>· 也可对 AI 说「把 XX 加到写作输出分组」<br>· 顶栏切换排序；⇄ 移组、拖卡片排序自动保存；拖分组条调整分组顺序<br>· 点卡片标签按标签筛选（再点取消）；标签悬停 ✕ 删 / ＋ 加；⤓ 导出 / ⤒ 导入 JSON 备份<br>· ⭐ 收藏常用 · 复制次数在卡片右上角</div>';
     sideNav.innerHTML = html;
     sideNav.querySelectorAll('.nav-item').forEach(function(el){
       el.addEventListener('click', function(){
@@ -1001,7 +1033,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
       });
     });
     var addBtn = sideNav.querySelector('#navAdd');
-    if (addBtn) addBtn.addEventListener('click', function(){ openGroupForm(null); });
+    if (addBtn) addBtn.addEventListener('click', function(e){ e.stopPropagation(); openGroupForm(null); });
   }
 
   function render(){
@@ -1198,7 +1230,12 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
     persistUserState();
     scheduleBackup();
   }
-  function syncSortUI(){ if (sortSel) sortSel.value = state.sortMode; }
+  function syncSortUI(){
+    if (sortTxt) sortTxt.textContent = SORT_LABELS[state.sortMode] || SORT_LABELS.added;
+    if (sortMenu) sortMenu.querySelectorAll('.sort-opt').forEach(function(o){
+      o.classList.toggle('on', o.getAttribute('data-mode') === state.sortMode);
+    });
+  }
   function ensureManual(){
     if (state.sortMode === 'manual') return;
     state.sortMode = 'manual';
@@ -1279,10 +1316,30 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
       if (!gpopEl.contains(e.target) && !onAnchor){ closeGpop(); }
     }
   });
-  sortSel.addEventListener('change', function(){
-    state.sortMode = sortSel.value;
+  function toggleSortMenu(force){
+    if (!sortMenu) return;
+    var willOpen = (force !== undefined) ? force : sortMenu.hidden;
+    sortMenu.hidden = !willOpen;
+    sortSel.classList.toggle('open', willOpen);
+  }
+  sortSel.addEventListener('click', function(e){
+    e.stopPropagation();
+    toggleSortMenu();
+  });
+  sortMenu.addEventListener('click', function(e){
+    var opt = e.target.closest('.sort-opt');
+    if (!opt) return;
+    state.sortMode = opt.getAttribute('data-mode');
     persistUserState();
     render();
+    syncSortUI();
+    toggleSortMenu(false);
+  });
+  document.addEventListener('click', function(e){
+    if (!sortMenu.hidden){
+      var onSel = e.target.closest && e.target.closest('#sortSel');
+      if (!sortMenu.contains(e.target) && !onSel){ toggleSortMenu(false); }
+    }
   });
 
   /* ---------- 模板插值（{{变量}} / {变量}） ---------- */
@@ -1448,6 +1505,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
         if (next === null) return false;
         return bkWrite('prompts.json', 'data', JSON.stringify(next, null, 2)).then(function(){
           state.data = next;
+          syncMirror(next);
           applyUserState();
           state.dirty = false; state.moves = [];
           persistUserState(); refreshDirtyUI();
@@ -1484,6 +1542,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
         });
         return bkWrite('prompts.json', 'data', JSON.stringify(latest, null, 2)).then(function(){
           state.data = latest;
+          syncMirror(latest);
           applyUserState();
           state.dirty = false; state.moves = [];
           persistUserState(); refreshDirtyUI();
@@ -1868,6 +1927,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
     if (e.key === 'Escape'){
       closeFillPanel();
       closeGpop();
+      toggleSortMenu(false);
       closeItemForm();
       closeGroupForm();
       document.getElementById('bkMask').classList.remove('open');
@@ -2030,6 +2090,19 @@ if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(POUC
       });
     });
   }
+  /* 数据镜像：localStorage 存全量数据快照（file:// 下 IndexedDB 偶发不可用时兜底恢复，键按 pouch-id 隔离） */
+  function syncMirror(data){
+    try{ localStorage.setItem(SF_NS + '-mirror', JSON.stringify(data)); }catch(e){}
+  }
+  function readMirror(){
+    try{
+      var raw = localStorage.getItem(SF_NS + '-mirror');
+      if (!raw) return null;
+      var d = JSON.parse(raw);
+      if (d && d.groups && d.prompts) return d;
+    }catch(e){}
+    return null;
+  }
   /* 备份文件读：backup/ 优先，读不到回退根目录旧文件（旧目录结构兼容） */
   function readBk(name){
     return bkRead(name, 'backup').then(function(text){
@@ -2122,6 +2195,7 @@ if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(POUC
         try{ localStorage.removeItem(SF_NS + '-bk-declined'); }catch(e){}
         idbSet('bkHandle', bkDirHandle);
         updateBkUI();
+        reloadFromDirIfNeeded();
         return true;
       })
       .catch(function(){ pendingAuth = false; updateBkUI(); return false; });
@@ -2168,6 +2242,43 @@ if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(POUC
       pendingAuth = false;
     }).catch(function(){});
   }
+  /* file:// 直开补洞：fetch 被浏览器拦截读不到数据文件时，授权目录后直读 data/prompts.json 替换示例/快照 */
+  function reloadFromDirIfNeeded(){
+    if (!bkDirHandle || bootMode === 'live') return;
+    readPouch().then(function(text){
+      if (text === null) return;
+      var data = JSON.parse(text);
+      state.data = data;
+      idbSet('lastData', data);
+      syncMirror(data);
+      bootMode = 'live';
+      cacheBadge.style.display = 'none';
+      applyUserState();
+      renderNav(); render();
+      toast('✓ 已直读 data/prompts.json，你的分组与提示词已载入');
+    }).catch(function(){});
+  }
+  /* 「🔓 恢复数据」：已授权过目录但刷新后权限需重新确认（file:// 权限不跨会话持久）→ 一键 requestPermission 后直读，免重新选目录 */
+  function restoreAuth(){
+    if (!bkDirHandle || typeof bkDirHandle.requestPermission !== 'function') return;
+    bkDirHandle.requestPermission({ mode: 'readwrite' }).then(function(st){
+      if (st === 'granted'){
+        pendingAuth = false; updateBkUI();
+        reloadFromDirIfNeeded();
+      } else {
+        toast('未获授权：点「💾 授权目录」重新选择目录', true);
+      }
+    }).catch(function(){ toast('权限恢复失败，请重新授权目录', true); });
+  }
+  function updateBootBadge(){
+    if (bootMode === 'live' || !bkDirHandle || !bootRendered) return;
+    var link = ' <a id="bootRestore" style="cursor:pointer;text-decoration:underline">🔓 恢复数据</a>';
+    cacheBadge.innerHTML = (bootMode === 'cache'
+      ? '⚠️ 快照模式：当前显示上次快照，目录权限需确认后直读最新数据'
+      : '📌 示例模式：检测到曾授权过目录，点击确认权限即可载入你的数据') + link;
+    cacheBadge.style.display = '';
+    document.getElementById('bootRestore').addEventListener('click', restoreAuth);
+  }
   btnBkEnable.addEventListener('click', function(){
     if (bkDirHandle && !pendingAuth){
       writeBackupNow().then(function(ok){ toast(ok ? '✓ 备份完成 · backup/pouch-backup.json' : '备份失败，请重新授权目录', !ok); });
@@ -2179,7 +2290,7 @@ if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(POUC
     }
     if (bkDirHandle && pendingAuth){
       bkDirHandle.requestPermission({ mode: 'readwrite' }).then(function(st){
-        if (st === 'granted'){ pendingAuth = false; updateBkUI(); writeBackupNow(); }
+        if (st === 'granted'){ pendingAuth = false; updateBkUI(); writeBackupNow(); reloadFromDirIfNeeded(); }
         else bkStatus.textContent = '未获授权，备份暂停';
       }).catch(function(){});
       return;
@@ -2191,6 +2302,7 @@ if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(POUC
         idbSet('bkHandle', bkDirHandle);
         updateBkUI();
         writeBackupNow();
+        reloadFromDirIfNeeded();
       })
       .catch(function(){});
   });
@@ -2204,6 +2316,7 @@ if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(POUC
         idbSet('bkHandle', bkDirHandle);
         updateBkUI();
         writeBackupNow();
+        reloadFromDirIfNeeded();
       })
       .catch(function(){});
   });
@@ -2267,6 +2380,7 @@ if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(POUC
     // 先把当前状态固化进备份（目录备份滚入 .prev.json / 快照环记一份），再应用所选备份
     (bkDirHandle ? writeBackupNow() : writeSnapNow()).then(function(){
       state.data = snap.data;
+      syncMirror(snap.data);
       applyUserStateFrom(snap.userState || {});
       state.dirty = false; state.moves = [];
       persistUserState();
@@ -2303,7 +2417,7 @@ if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(POUC
     render();
     if (bootMode === 'cache') cacheBadge.style.display = '';
     if (bootMode === 'demo'){
-      cacheBadge.textContent = '📌 示例模式：未读到 data/prompts.json，当前展示系统自带示例提示词（file:// 直开或数据文件尚未生成）。经 HTTP 打开页面并生成数据文件后即为你的提示词，示例可随时删除。';
+      cacheBadge.textContent = '📌 示例模式：未读到 data/prompts.json，当前展示系统自带示例。若你有自己的数据文件：点顶部「💾 授权目录」选 prompt-pouch.html 所在文件夹即可直读载入；或经 HTTP 打开页面（file:// 直开会被浏览器拦截文件读取）。';
       cacheBadge.style.display = '';
     }
   }
@@ -2319,26 +2433,49 @@ if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(POUC
     .then(function(data){
       state.data = data;
       idbSet('lastData', data);
+      syncMirror(data);
       bootMode = 'live';
       firstRender();
     })
     .catch(function(){
-      idbGet('lastData').then(function(cached){
-        if (cached){
-          state.data = cached;
-          bootMode = 'cache';
-          firstRender();
-        } else {
-          state.data = DEFAULT_POUCH;
-          bootMode = 'demo';
-          firstRender();
-        }
+      // file:// 场景：fetch 被浏览器拦截 → 已授权目录则直读 data/prompts.json（File System Access API）
+      return dirHandleReady.then(function(){
+        return readPouch().then(function(text){
+          if (text !== null) return JSON.parse(text);
+          throw new Error('no-fs');
+        });
+      }).then(function(data){
+        state.data = data;
+        idbSet('lastData', data);
+        syncMirror(data);
+        bootMode = 'live';
+        firstRender();
+      }).catch(function(){
+        idbGet('lastData').then(function(cached){
+          if (cached){
+            state.data = cached;
+            bootMode = 'cache';
+            firstRender();
+          } else {
+            var mirror = readMirror();
+            if (mirror){
+              state.data = mirror;
+              bootMode = 'cache';
+              firstRender();
+            } else {
+              state.data = DEFAULT_POUCH;
+              bootMode = 'demo';
+              firstRender();
+            }
+          }
+        });
       });
     });
   // 本地态并行：可用则应用收藏与排序并刷新备份区（不阻塞数据展示）
+  var dirHandleReady = idbOpen().then(function(){ return loadDirHandle(); }).catch(function(){});
   idbOpen()
     .then(loadLocalState)
-    .then(loadDirHandle)
+    .then(function(){ return dirHandleReady; })
     .catch(function(){})
     .then(function(){
       applyUserState();
@@ -2346,6 +2483,7 @@ if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(POUC
       refreshDirtyUI();
       if (bootRendered){ renderNav(); render(); }
       updateBkUI();
+      updateBootBadge();
     });
 })();
 

package/prompt-pouch/resources/skillforge-guide.html

@@ -361,6 +361,7 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
       <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
       <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
+      <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
     </table>
     <div class="faq">
       <div class="faq-title">常见问题</div>

package/prompt-pouch/resources/skillforge-guide.txt

@@ -122,6 +122,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 | 查全部命令 | skill-forge --help |
 | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
 | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
+| 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
 
 ## 六、常见问题
 

package/prompt-pouch/resources/usage-guide.md

@@ -4,13 +4,13 @@
 
 ## 怎么用
 
-1. **打开页面**：对 AI 说「打开锦囊」即可（自动起服务并打开浏览器）；手动方式：`cd <目录> && python3 -m http.server 8933`（Windows 用 `py -m http.server`），浏览器访问 `http://localhost:8933/prompt-pouch.html`（HTTP 方式才能读 data/prompts.json；file:// 直开时回退浏览器缓存快照，无快照则展示内置示例提示词（仅作示范），不推荐日常使用）
+1. **打开页面**：对 AI 说「打开锦囊」即可（自动起服务并打开浏览器）；手动方式：`cd <目录> && python3 -m http.server 8933`（Windows 用 `py -m http.server`），浏览器访问 `http://localhost:8933/prompt-pouch.html`（HTTP 方式自动读 data/prompts.json；file:// 直开时浏览器会拦截文件读取——已授权目录则刷新自动直读 data/prompts.json，权限需重新确认时点徽标「🔓 恢复数据」一键续权（免重新选目录），读不到则回退本地快照/镜像、再回退内置示例，点页面「💾 授权目录」即可载入你的数据，但仍推荐 HTTP 打开）
 2. **添加提示词**：页面点「＋ 新增提示词」填表保存（已授权目录即写即存）；或对 AI 说「把 XX 加到锦囊的写作输出分组」（不说分组也行，AI 会列出现有分组让你选；分组不存在时会问你是否新建）
 3. **查看与修改**：卡片正文超长只显示前三行，点「👁 详情」弹窗看全文（超长限高滚动），弹窗内可直接「⧉ 复制」或「✎ 修改」，并附时间线——创建时间、上次修改时间（修改过才显示）、最近使用时间（用过才显示）；卡片上也能直接点「✎」改完保存；或对 AI 说「修改锦囊里『日报速写』的内容」，改后刷新
 4. **删除**：页面点卡片「🗑」；或对 AI 说「删掉锦囊里『XX』这条」
 5. **排序与移组**：顶栏「排序」切换四种方式——最新添加（默认）/ 最近使用 / 使用频率 / 手动顺序；想手动排时拖动卡片或点 ▲▼（自动切回手动），点卡片 ⇄ 可把提示词移到其它分组；已授权目录时排序/移组 2 秒内自动保存，未授权时点「📋 复制变更指令」把指令发给 AI 落盘；复制过提示词后卡片右上角会显示「⧉ N 次 · 最近时间」（最近使用/使用频率排序即按复制统计）；AI 落盘后回页面点「✓ 已落盘」清除未保存标记
 6. **收藏**：卡片右上角星标，收藏/取消收藏指令由 AI 同步到数据文件
-7. **分组管理**：分组下方「＋ 新建分组」（紧随分组列表）；悬停分组名出现「✎ 改名 / 🗑 删除」（组内还有提示词时不允许删，先移出或删条目）；重名分组会提示；新建/编辑分组时图标输入框下方有快捷 emoji 面板（点击即填入、选中高亮，输入框仍可手输/粘贴任意 emoji）
+7. **分组管理**：「全部」行右侧「＋」小图标新建分组；悬停分组名出现「✎ 改名 / 🗑 删除」（组内还有提示词时不允许删，先移出或删条目）；重名分组会提示；新建/编辑分组时图标输入框下方有快捷 emoji 面板（点击即填入、选中高亮，输入框仍可手输/粘贴任意 emoji）
 8. **标签全交互**：点卡片标签立即按标签筛选（顶栏出现「🏷 标签」胶囊，点 ✕ 或再点同标签取消，切分组自动清除，与搜索叠加）；标签悬停出「✕」点它直接删除该标签；标签不满 3 个时悬停出「＋」快速加标签（多个用逗号分隔）——已授权目录即写即存，未授权时操作指令复制给 AI 落盘
 9. **分组排序**：左侧分组条可直接拖拽调整顺序（已授权目录即写即存，未授权时指令自动复制给 AI 落盘）
 10. **导入 / 导出**：顶栏「⤓ 导出」把当前全部数据下载为 JSON 备份文件（文件名带时间戳）；「⤒ 导入」选择 JSON 文件整库覆盖现有数据（导入前自动备份，可从「↩ 恢复」回滚；未授权目录时导出仍可用、导入需先授权）
@@ -22,7 +22,7 @@
 - **自动备份（默认开启）**：数据一有变更 2 秒内自动备份——首次变更会请求授权写入 prompt-pouch.html 所在目录（弹窗选同目录即可，选一次后浏览器记住），写 backup/pouch-backup.json 并滚动保留上一版 .prev.json；未授权或浏览器不支持时自动降级为本地快照（浏览器内保留最近 5 份），页内「↩ 恢复」均可一键回滚；顶栏「📂 换目录」可随时重新配置备份目录
 - **详情弹窗**：点卡片「👁 详情」弹出全文查看（超长内容限高 52vh 内滚动），带复制与修改入口，附时间线（创建 / 上次修改 / 最近使用）；含 {变量} 的模板会在弹窗里标出变量清单，复制时自动进入填充面板
 - **页面直写（双笔）**：页面增删改直接写入 data/prompts.json（与自动备份共用同一目录授权）；未授权时自动降级——生成操作指令复制到剪贴板，粘贴给 AI 落盘
-- **侧栏局部滚动**：分组较多时，左侧「收藏 + 分组列表」区域独立滚动（窄滚动条，滚动区最大占满屏幕剩余高度），「＋ 新建分组」紧随分组流、「锦囊用法」滚到底可见，「全部」固定不滚；窄屏下自动恢复平铺排列
+- **侧栏局部滚动**：分组较多时，左侧「收藏 + 分组列表」区域独立滚动（窄滚动条，滚动区最大高度 = 屏幕高度减去顶栏、「全部」行与底部说明卡），「＋ 新建分组」在「全部」行右侧不随滚动、「全部」固定不滚；底部「锦囊用法」说明卡完整展示不裁剪，侧栏随页面整体滚动即可读完；窄屏下自动恢复平铺排列
 - **批量整理入囊**：把一堆文字/文件交给 AI，或说「把最近对话框内容整理进锦囊」——两段确认：先定条目（AI 默认智能打标——每条自动配 1-3 个语义标签，可改可删；含具体词的可泛化为 {变量} 插值，附改写示例）→ 再定分组（归组理由 + 装不下的推荐新分组名），都确认后一次性写入；条目少（≤3 条）两段合一
 - **标签全交互**：点标签即筛选（顶栏胶囊一键清除，再点取消，切分组自动清除，与搜索叠加）；标签悬停「✕」删、「＋」加（最多 3 个），授权目录即写即存，未授权指令交 AI
 - **导入 / 导出 JSON**：顶栏「⤓ 导出」一键下载全量数据为 JSON 备份文件（文件名带时间戳）；「⤒ 导入」选择 JSON 文件整库覆盖（导入前自动备份、可恢复）；未授权目录时导出仍可用、导入需先授权

package/quarterly-report/SKILL.md

@@ -34,7 +34,7 @@ disable-model-invocation: false
 
 ## 配置版本机制（升级保护）
 
-本 skill 当前配置版本为 `3`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明的当前版本不一致：先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）→ 按本节「当前版本变更记录」迁移字段（新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认）→ 更新 CONFIG_VERSION 为当前版本 → 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」。禁止在未声明版本变更的情况下静默修改配置语义。
+本 skill 当前配置版本为 `3`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明的当前版本不一致：先将旧 user-config.md 备份为 `user-config.bak-<时间戳>.md`（同目录，绝不删除旧值）→ 按本节「当前版本变更记录」迁移字段（新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认）→ 更新 CONFIG_VERSION 为当前版本 → 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」。禁止在未声明版本变更的情况下静默修改配置语义。
 
 **无法迁移项处理**（值域失效 / 语义漂移 / 数据不兼容）：三情形——①旧值不在新值域（如旧模板/主题名已移除）②同名键含义变化（单位/枚举变更）③数据文件 schema 不兼容。三绝不：绝不静默（无法迁移项停下问，不猜值）、绝不丢失（旧值永远在 .bak-时间戳）、一次说清（升级报告三段式：⚠️ 版本与备份路径 → ✅ 已自动迁移清单 → 🟡 无法迁移项逐条附原因+影响+建议替代）；随后 AskUserQuestion 三选项（A 用建议值 / B 用户给新值 / C 保持旧配置——不更新 CONFIG_VERSION，每次执行再提醒）；报告必附回滚一句话。
 

package/quarterly-report/resources/skillforge-guide.html

@@ -361,6 +361,7 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
       <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
       <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
+      <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
     </table>
     <div class="faq">
       <div class="faq-title">常见问题</div>

package/quarterly-report/resources/skillforge-guide.txt

@@ -122,6 +122,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 | 查全部命令 | skill-forge --help |
 | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
 | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
+| 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
 
 ## 六、常见问题
 

package/quarterly-report/user-config.md

@@ -2,7 +2,7 @@
 
 > 你的个人配置全放在这里。skill-forge 升级技能时官方只更新 SKILL.md 与 resources/，
 > 本文件始终保留你的版本——落盘目录、格式、角色画像、自定义模板放心改。
-> 官方升级若带来新配置点，会另存 `user-config.md.upstream` 对照文件到同目录，
+> 官方升级若带来新配置点，会另存 `user-config.upstream.md` 对照文件到同目录，
 > 你按需查看并手动合并新配置点到本文件。
 
 

package/release-notes/SKILL.md

@@ -20,13 +20,13 @@ disable-model-invocation: false
 
 ## ⚙️ 配置与自定义
 
-**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（REPO/LANG/CHANGELOG_FILE/REL_DIR/STATS/SCOPE_HINT）都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（REPO/LANG/CHANGELOG_FILE/REL_DIR/STATS/SCOPE_HINT）都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.upstream.md` 对照文件，可按需手动合并新配置点。
 
 ## 配置版本机制（升级保护）
 
 本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明不一致：
 
-1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+1. 先将旧 user-config.md 备份为 `user-config.bak-<时间戳>.md`（同目录，绝不删除旧值）
 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
 3. 更新 CONFIG_VERSION 为当前版本
 4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」

package/release-notes/resources/skillforge-guide.html

@@ -361,6 +361,7 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
       <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
       <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
+      <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
     </table>
     <div class="faq">
       <div class="faq-title">常见问题</div>

package/release-notes/resources/skillforge-guide.txt

@@ -122,6 +122,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 | 查全部命令 | skill-forge --help |
 | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
 | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
+| 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
 
 ## 六、常见问题
 

package/release-notes/user-config.md

@@ -1,5 +1,5 @@
 # user-config.md（本文件不会被 skill 升级覆盖，你的修改永久保留）
-# 官方配置更新时，另存 user-config.md.upstream 对照文件，可手动合并新配置点
+# 官方配置更新时，另存 user-config.upstream.md 对照文件，可手动合并新配置点
 
 ```yaml
 CONFIG_VERSION: 1  # 配置结构版本，skill 升级迁移依据

package/skill-doctor/SKILL.md

@@ -19,13 +19,13 @@ disable-model-invocation: false
 
 ## ⚙️ 配置与自定义
 
-**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（TARGET/CHECKS/FIX）都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（TARGET/CHECKS/FIX）都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.upstream.md` 对照文件，可按需手动合并新配置点。
 
 ## 配置版本机制（升级保护）
 
 本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明不一致：
 
-1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+1. 先将旧 user-config.md 备份为 `user-config.bak-<时间戳>.md`（同目录，绝不删除旧值）
 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
 3. 更新 CONFIG_VERSION 为当前版本
 4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」

package/skill-doctor/resources/skillforge-guide.html

@@ -361,6 +361,7 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <tr><td>查全部命令</td><td><span class="cmd-in">skill-forge --help</span></td></tr>
       <tr><td>问单个技能用法</td><td>直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出</td></tr>
       <tr><td>问 SkillForge 本身</td><td>问「skillforge 怎么用」，AI 朗读本指引并打开排版页</td></tr>
+      <tr><td>查技能双语简介 / 实操文章</td><td><span class="cmd-in">SKILLS_CATALOG.md</span>（21 技能逐条中英简介）/ <span class="cmd-in">docs/articles/</span>（实操文章）/ <span class="cmd-in">docs/directory-submission.md</span>（目录收录素材）</td></tr>
     </table>
     <div class="faq">
       <div class="faq-title">常见问题</div>

package/skill-doctor/resources/skillforge-guide.txt

@@ -122,6 +122,7 @@ skill-forge init --skills daily-report,weekly-report --yes
 | 查全部命令 | skill-forge --help |
 | 问单个技能用法 | 直接问「XX 技能怎么用」，AI 会读该技能的使用说明输出 |
 | 问 SkillForge 本身 | 问「skillforge 怎么用」，AI 朗读本指引并打开排版页 |
+| 查技能双语简介 / 实操文章 | SKILLS_CATALOG.md（21 技能逐条中英简介）/ docs/articles/（实操文章）/ docs/directory-submission.md（目录收录素材） |
 
 ## 六、常见问题
 

package/skill-doctor/user-config.md

@@ -1,5 +1,5 @@
 # user-config.md（本文件不会被 skill 升级覆盖，你的修改永久保留）
-# 官方配置更新时，另存 user-config.md.upstream 对照文件，可手动合并新配置点
+# 官方配置更新时，另存 user-config.upstream.md 对照文件，可手动合并新配置点
 
 ```yaml
 CONFIG_VERSION: 1  # 配置结构版本，skill 升级迁移依据

package/spec-doc2spec/SKILL.md

@@ -1,12 +1,6 @@
 ---
 name: spec-doc2spec
-description: >
-  文档转高质量 Markdown Skill（doc2spec）。把 Word / PDF / Markdown 文档转成结构化 Markdown——Pandoc 负责机械转换，AI 全程校对防错（量化校验断言、双通道完整性比对、表格列表修复、图片提取与 EMF/WMF 自动转 PNG、乱码与修订痕清理），转换后整理成干净的正文稿落盘。
-  可选「需求加工档」：用户要求整理成需求规格时，另出需求点+验收标准与功能单元切片。
-  图片自动提取到 assets/images（可配置 IMG_DIR）；输出默认源文档同目录下 {文档名}-spec/ 子目录，可配置 OUTPUT_DIR（绝对路径同样按文档名建子目录，多文档互不覆盖）。
-  跨系统适配 macOS / Windows / Linux（Pandoc 安装、EMF 转换工具链探测）。支持 .docx（Pandoc 转换）/ .md（直接读取）/ .pdf（LibreOffice 转 docx 优先保留图片版式，降级 pdftotext 纯文本）。
-  不处理一般性的文档内容讨论（如「帮我看看这份文档讲了什么」），只处理「文档 → Markdown / 需求规格」的转换任务。
-  用户询问用法（doc2spec 怎么用/使用说明/能干什么）时走使用说明应答：读 resources/usage-guide.md 原样输出（首行标题改为「doc2spec 使用指南」），不执行任何转换命令。
+description: 文档转高质量 Markdown Skill（doc2spec）。把 Word / PDF / Markdown 文档转成结构化 Markdown——Pandoc 负责机械转换，AI 全程校对防错（量化校验断言、双通道完整性比对、表格列表修复、图片提取与 EMF/WMF 自动转 PNG、乱码与修订痕清理），转换后整理成干净的正文稿落盘。 可选「需求加工档」：用户要求整理成需求规格时，另出需求点+验收标准与功能单元切片。 图片自动提取到 assets/images（可配置 IMG_DIR）；输出默认源文档同目录下 {文档名}-spec/ 子目录，可配置 OUTPUT_DIR（绝对路径同样按文档名建子目录，多文档互不覆盖）。 跨系统适配 macOS / Windows / Linux（Pandoc 安装、EMF 转换工具链探测）。支持 .docx（Pandoc 转换）/ .md（直接读取）/ .pdf（LibreOffice 转 docx 优先保留图片版式，降级 pdftotext 纯文本）。 不处理一般性的文档内容讨论（如「帮我看看这份文档讲了什么」），只处理「文档 → Markdown / 需求规格」的转换任务。 用户询问用法（doc2spec 怎么用/使用说明/能干什么）时走使用说明应答：读 resources/usage-guide.md 原样输出（首行标题改为「doc2spec 使用指南」），不执行任何转换命令。
 allowed-tools: ["Bash", "Read", "Write", "Edit"]
 disable-model-invocation: false
 ---
@@ -28,13 +22,13 @@ disable-model-invocation: false
 
 ## ⚙️ 配置与自定义
 
-**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（OUTPUT_DIR/IMG_DIR/EMF_POLICY/CONFIRM/CONFIG_VERSION）与临时口头要求说明都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.md.upstream` 对照文件，可按需手动合并新配置点。
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：默认配置（OUTPUT_DIR/IMG_DIR/EMF_POLICY/CONFIRM/CONFIG_VERSION）与临时口头要求说明都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留；官方更新配置时另存 `user-config.upstream.md` 对照文件，可按需手动合并新配置点。
 
 ## 配置版本机制（升级保护）
 
 本 skill 当前配置版本为 `2`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明的当前版本不一致：
 
-1. 先将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`（同目录，绝不删除旧值）
+1. 先将旧 user-config.md 备份为 `user-config.bak-<时间戳>.md`（同目录，绝不删除旧值）
 2. 按本节「配置升级规则」迁移字段：新增字段补默认值、改名字段按映射改写、删除字段的值保留在备份中并在对话提示用户手动确认
 3. 更新 CONFIG_VERSION 为当前版本
 4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」