skill-forge-hub 0.5.1 → 0.5.3

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 SkillForge（技能锻造坊）npm 包 `skill-forge-hub`（命令名 `skill-forge`）版本变更记录。
 
+## 0.5.3（2026-11-11）
+
+**锦囊数据目录正名：cache/ → data/**
+
+- DATA_DIR 默认值 `cache` → `data`（语义正名：目录放的是全量数据不是缓存，缓存语义留给将来真正的过程性缓存）；CONFIG_VERSION v3 → v4
+- 页面读侧三级兜底：`data/prompts.json` → 旧默认 `cache/prompts.json` → 根目录旧平铺文件；写侧一律写 `data/`；页面文案全部同步
+- 升级迁移：AI 发现 v3 旧默认 cache/ 目录 → 备份后改名迁移为 data/ 并告知用户（用户显式自定义目录名则尊重不动）
+
+## 0.5.2（2026-11-11）
+
+**锦囊 mono 主题换装 JetBrains Darcula**
+
+- 从「Linear 式纯黑」改为 Darcula 官方色板：背景 `#2b2b2b` / 面板 `#3c3f41` / 卡片渐变 `#313335` / 正文蓝灰 `#a9b7c6` / 边框 `#4e5254`——深灰底 + 蓝灰字 + 灰阶面板，与 JetBrains IDE 观感一致，久看不累
+- 组件适配全面蓝灰化：魔法棒/图标滤镜、标签、星标、弹层、输入区、卡片内描边与 hover 描边、换肤坞色点
+- 主题名同步：「极简黑白」→「Darcula 深灰蓝」（SKILL.md / user-config.md / usage-guide.md / 换肤坞 title）
+
 ## 0.5.1（2026-11-11）
 
 **自检闭环补全**（交付前硬门禁，四技能全覆盖）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-forge-hub",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "SkillForge (技能锻造坊) — a curated collection of AI craft skills. Install once, then pick skills interactively: daily/weekly/annual reports, article-to-HTML, magic-deck slides, deck-stage PPTX, prompt-pouch manager, Pandoc doc converters, meta-forge.",
   "bin": {
     "skill-forge": "cli.js"

package/prompt-pouch/SKILL.md

@@ -2,11 +2,11 @@
 name: prompt-pouch
 description: >
   锦囊（prompt-pouch）提示词管理 Skill：生成并维护一个本地 HTML 提示词管理页面（锦囊管理台），
-  暖棕金/深蓝科技/极简黑白/薄荷绿四套主题（右下角换肤坞随时切换，THEME 配置可设默认），功能为分组侧栏（带计数徽章）+ 搜索（关键词高亮）+ 卡片网格 + 四种排序（最新添加默认/最近使用/使用频率/手动，
+  暖棕金/深蓝科技/Darcula 深灰蓝/薄荷绿四套主题（右下角换肤坞随时切换，THEME 配置可设默认），功能为分组侧栏（带计数徽章）+ 搜索（关键词高亮）+ 卡片网格 + 四种排序（最新添加默认/最近使用/使用频率/手动，
   拖拽与 ▲▼ 自动切手动）+ 使用统计 + 收藏星标 + {变量} 插值填充面板 + 一键复制 + 卡片「👁 详情」弹窗
-  （全文滚动查看 / 复制 / 修改 / 创建修改时间线）；数据存 <DIR>/cache/prompts.json（DATA_DIR 可配），
+  （全文滚动查看 / 复制 / 修改 / 创建修改时间线）；数据存 <DIR>/data/prompts.json（DATA_DIR 可配），
   页面与数据严格分离，双笔协作（页面经授权目录直写，AI 代笔维护）。三类任务：①初始化——目标目录无页面时确认目录（默认用户配置 DIR）
-  并生成 prompt-pouch.html（样式真相源为 resources/reference.html，原样复制）与 cache/prompts.json
+  并生成 prompt-pouch.html（样式真相源为 resources/reference.html，原样复制）与 data/prompts.json
   （默认示例五组：写作输出/沟通协作/规划执行/复盘成长/提问艺术，每条带 createdAt；页面另内置同款示例种子 DEFAULT_POUCH，prompts.json 读不到时兜底展示）；②维护——按用户口述增删改提示词与分组、调整排序、
   切换收藏，读写 prompts.json（UTF-8、2 空格缩进），用户刷新页面即见；③打开——用户说「打开锦囊」时
   起本地服务并按平台打开浏览器访问管理页面。
@@ -62,14 +62,14 @@ disable-model-invocation: false
 
 **执行本 skill 前必须先 Read 同目录 `user-config.md`**：目录（DIR/DIR_WIN）、端口（PORT）、初始化数据（INIT_DATA）、确认开关（CONFIRM）、主题（THEME）等默认配置都在该文件中，以它为准。升级技能时 user-config.md 不会被覆盖，你的修改永久保留。
 
-**THEME 主题机制**：页面内置四套主题——gold 暖棕金（默认）/ tech 深蓝科技 / mono 极简黑白 / mint 薄荷绿。初始化复制 reference.html 后，将 html 根标签 `data-theme` 属性值设为配置 `THEME`（仅此一处修改）；页面右下角「换肤坞」色点可随时切换主题，选择经浏览器 localStorage 持久（key: sf-pouch-theme），刷新后保持；localStorage 优先级高于根标签 data-theme。已初始化的页面改配置 THEME 不追溯——用户手动换过主题即以其选择为准。
+**THEME 主题机制**：页面内置四套主题——gold 暖棕金（默认）/ tech 深蓝科技 / mono Darcula 深灰蓝（JetBrains IDE 同款观感）/ mint 薄荷绿。初始化复制 reference.html 后，将 html 根标签 `data-theme` 属性值设为配置 `THEME`（仅此一处修改）；页面右下角「换肤坞」色点可随时切换主题，选择经浏览器 localStorage 持久（key: sf-pouch-theme），刷新后保持；localStorage 优先级高于根标签 data-theme。已初始化的页面改配置 THEME 不追溯——用户手动换过主题即以其选择为准。
 
-**配置版本机制（升级保护）**：user-config.md 头部 `CONFIG_VERSION` 标识结构版本。升级 skill 后若发现新版本结构（如 v2 新增 THEME 字段）而用户配置是旧版：先备份旧配置为 `user-config.md.bak-时间戳`，将旧值迁移进新结构（保留用户已有 DIR/PORT/INIT_DATA/CONFIRM，缺失字段补默认值），更新 CONFIG_VERSION，最后用一句话告知用户配置已升级、旧文件备份在哪。 **无法迁移项处理**（值域失效 / 语义漂移 / 数据不兼容）：三绝不——绝不静默（无法迁移项停下问，不猜值）、绝不丢失（旧值永远在备份）、一次说清（升级报告三段式：⚠️ 版本与备份路径 / ✅ 已自动迁移 / 🟡 无法迁移项逐条附原因+影响+建议替代）；随后 AskUserQuestion 三选项（A 用建议值 / B 用户给新值 / C 保持旧配置——不更新 CONFIG_VERSION，每次执行再提醒）；报告必附回滚一句话；数据文件（prompts.json）迁移前先复制 .bak-时间戳，能映射则映射、不能则写兼容层（旧 id 兼容保留即范例）或留备份提示手动整理
+**配置版本机制（升级保护）**：user-config.md 头部 `CONFIG_VERSION` 标识结构版本。升级 skill 后若发现新版本结构（如 v2 新增 THEME 字段）而用户配置是旧版：先备份旧配置为 `user-config.md.bak-时间戳`，将旧值迁移进新结构（保留用户已有 DIR/PORT/INIT_DATA/CONFIRM，缺失字段补默认值），更新 CONFIG_VERSION，最后用一句话告知用户配置已升级、旧文件备份在哪。v4 特例：用户配置 DATA_DIR: cache（v3 旧默认、非用户显式自定义）→ 目录改名 cache→data（先复制 .bak-时间戳）并同步更新配置值；用户显式自定义过其它目录名则尊重其选择不动。 **无法迁移项处理**（值域失效 / 语义漂移 / 数据不兼容）：三绝不——绝不静默（无法迁移项停下问，不猜值）、绝不丢失（旧值永远在备份）、一次说清（升级报告三段式：⚠️ 版本与备份路径 / ✅ 已自动迁移 / 🟡 无法迁移项逐条附原因+影响+建议替代）；随后 AskUserQuestion 三选项（A 用建议值 / B 用户给新值 / C 保持旧配置——不更新 CONFIG_VERSION，每次执行再提醒）；报告必附回滚一句话；数据文件（prompts.json）迁移前先复制 .bak-时间戳，能映射则映射、不能则写兼容层（旧 id 兼容保留即范例）或留备份提示手动整理
 
 ## 核心约束
 
 - **页面与数据分离**：HTML 不内嵌用户数据——一切用户数据只进 <DATA_DIR>/prompts.json；HTML 内置只读示例种子（DEFAULT_POUCH 五组 15 条），仅当 prompts.json 读不到且浏览器无缓存快照时兜底展示（file:// 直开也能看到示范数据），一旦读到 prompts.json 即以文件为准；样式升级只改仓库 reference.html 后重新复制到目标目录（用户数据不受影响）
-- **目录结构（v3）**：数据文件默认 `<DIR>/<DATA_DIR>/prompts.json`（默认 cache/），自动备份默认 `<DIR>/<BACKUP_DIR>/`（默认 backup/，pouch-backup.json + .prev.json 滚动双备份）；页面读侧兼容旧平铺结构（新路径读不到时兜底读根目录旧文件），写侧一律写新路径；AI 初始化/维护时发现旧平铺结构（根目录 prompts.json / pouch-backup*.json）→ 建子目录并迁移文件（迁移前先复制 .bak-时间戳），一句话告知用户
+- **目录结构（v4）**：数据文件默认 `<DIR>/<DATA_DIR>/prompts.json`（默认 data/，v4 起语义正名——目录放的是全量数据不是缓存），自动备份默认 `<DIR>/<BACKUP_DIR>/`（默认 backup/，pouch-backup.json + .prev.json 滚动双备份）；页面读侧三级兜底（data/ → 旧默认 cache/ → 根目录旧平铺文件），写侧一律写新路径；AI 初始化/维护时发现旧结构（v3 默认 cache/ 目录、或根目录平铺 prompts.json / pouch-backup*.json）→ 迁移为 data/ 结构（迁移前先复制 .bak-时间戳），一句话告知用户
 - **双笔协作**：页面（授权目录时）与 AI 都可写 prompts.json——页面上有「＋ 新增提示词 / ✎ / 🗑 / 分组管理」表单直写；AI 落盘前必须重读最新文件再合并写回（见「页面双笔纪律」）
 - **prompts.json 结构必须合法**：写回前自查 schema（version/groups[]/prompts[] 各字段齐全、group 引用存在、order 连续）
 - **排序四模式**：页面顶栏切换「最新添加（默认，按 createdAt 倒序）/ 最近使用 / 使用频率 / 手动顺序」；最近使用与使用频率由页面在复制时自动统计（浏览器本地态，AI 不落盘）；用户在非手动模式下拖动卡片或点 ▲▼ 会自动切回手动顺序、点卡片 ⇄ 可把提示词移到其它分组——用户随后粘贴「复制变更指令」，AI 必须按指令落盘：先执行「分组调整」节（改各条 group），再按「各组顺序」节每组列出的顺序重写各条 `order`，写回后提醒用户刷新并点页面「✓ 已落盘」清除标记

package/prompt-pouch/resources/reference.html

@@ -30,34 +30,34 @@
   --btn-ink:#041018;
   --bar-hi:rgba(10,25,41,.96); --bar-lo:rgba(10,25,41,.88);
 }
-/* ═══ mono 深黑极简：Linear 式黑画布 + 纯白强调 + 灰阶层次（黑底白字，货真价实的黑色主题） ═══ */
+/* ═══ mono 深灰蓝：JetBrains Darcula 色系（深灰底 + 蓝灰文字 + 灰阶面板，IDE 同款观感） ═══ */
 [data-theme="mono"]{
-  --bg:#0a0a0b; --bg2:#121215;
-  --panel:#17171a; --panel2:#1e1e22;
-  --text:#f5f5f7; --muted:#9b9ba4;
-  --gold:#ffffff; --gold2:#d9d9de; --gold-dim:rgba(255,255,255,.09);
-  --border:rgba(255,255,255,.11);
-  --tag-bg:rgba(255,255,255,.07);
-  --star:#f5f5f7;
-  --glow:rgba(255,255,255,.16);
-  --btn-ink:#0a0a0b;
-  --bar-hi:rgba(10,10,11,.96); --bar-lo:rgba(10,10,11,.88);
+  --bg:#2b2b2b; --bg2:#313335;
+  --panel:#3c3f41; --panel2:#313335;
+  --text:#a9b7c6; --muted:#808080;
+  --gold:#a9b7c6; --gold2:#6b7280; --gold-dim:rgba(169,183,198,.12);
+  --border:#4e5254;
+  --tag-bg:#3c3f41;
+  --star:#d7dce3;
+  --glow:rgba(169,183,198,.18);
+  --btn-ink:#2b2b2b;
+  --bar-hi:rgba(43,43,43,.96); --bar-lo:rgba(43,43,43,.88);
 }
-/* mono 深黑组件适配：魔法棒黑白化、白标签、白星标、深色弹层、输入区半透明白、黑点白描边 */
-[data-theme="mono"] .lg{ filter:grayscale(1) brightness(.3); }
+/* mono 深灰蓝组件适配：魔法棒灰化、蓝灰标签、浅蓝灰星标、深灰弹层、输入区微亮蓝灰、色点蓝灰描边 */
+[data-theme="mono"] .lg{ filter:grayscale(1) brightness(.45); }
 [data-theme="mono"] .nav-item .icon,
-[data-theme="mono"] .search .kw{ filter:grayscale(1) brightness(1.35); }
-[data-theme="mono"] .tpl-badge{ color:#f5f5f7; background:rgba(255,255,255,.12); }
-[data-theme="mono"] .op.star-on{ color:#ffffff; border-color:rgba(255,255,255,.42); background:rgba(255,255,255,.15); }
-[data-theme="mono"] .gpop{ background:#1e1e22; border-color:rgba(255,255,255,.13); box-shadow:0 12px 32px rgba(0,0,0,.55); }
+[data-theme="mono"] .search .kw{ filter:grayscale(1) brightness(1.15); }
+[data-theme="mono"] .tpl-badge{ color:#a9b7c6; background:rgba(169,183,198,.14); }
+[data-theme="mono"] .op.star-on{ color:#d7dce3; border-color:rgba(169,183,198,.45); background:rgba(169,183,198,.16); }
+[data-theme="mono"] .gpop{ background:#3c3f41; border-color:#4e5254; box-shadow:0 12px 32px rgba(0,0,0,.6); }
 [data-theme="mono"] .fp-preview,
 [data-theme="mono"] .fp-field input,
 [data-theme="mono"] .fp-field textarea,
 [data-theme="mono"] .fp-field select,
 [data-theme="mono"] .fp-live textarea,
 [data-theme="mono"] .bk-item,
-[data-theme="mono"] .detail-content{ background:rgba(255,255,255,.05); }
-[data-theme="mono"] .theme-dock .th-dot[data-theme="mono"]{ border:1.5px solid rgba(255,255,255,.5); }
+[data-theme="mono"] .detail-content{ background:rgba(169,183,198,.07); }
+[data-theme="mono"] .theme-dock .th-dot[data-theme="mono"]{ border:1.5px solid rgba(169,183,198,.55); }
 [data-theme="mint"]{ /* 薄荷绿 */
   --bg:#0d1a12; --bg2:#12241a;
   --panel:#182f22; --panel2:#1e3a2a;
@@ -197,8 +197,8 @@ main{ flex:1; min-width:0; }
   cursor:grab; display:flex; flex-direction:column; gap:8px;
 }
 .card:hover{ transform:translateY(-3px); box-shadow:0 8px 24px rgba(0,0,0,.35); border-color:var(--glow); }
-[data-theme="mono"] .card{ box-shadow:0 1px 0 rgba(255,255,255,.05) inset; }
-[data-theme="mono"] .card:hover{ box-shadow:0 10px 30px rgba(0,0,0,.55),0 0 0 1px rgba(255,255,255,.09); }
+[data-theme="mono"] .card{ box-shadow:0 1px 0 rgba(169,183,198,.07) inset; }
+[data-theme="mono"] .card:hover{ box-shadow:0 10px 30px rgba(0,0,0,.55),0 0 0 1px rgba(169,183,198,.14); }
 .card.dragging{ opacity:.35; cursor:grabbing; }
 .card.drop-target{ border-color:var(--gold); box-shadow:0 0 0 2px var(--gold-dim); }
 .card-top{ display:flex; align-items:center; gap:8px; }
@@ -473,7 +473,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
 .theme-dock .th-dot.on{ border-color:var(--text); }
 .theme-dock .th-dot[data-theme="gold"]{ background:#e8b04b; }
 .theme-dock .th-dot[data-theme="tech"]{ background:#0ea5e9; }
-.theme-dock .th-dot[data-theme="mono"]{ background:#111; }
+.theme-dock .th-dot[data-theme="mono"]{ background:#2b2b2b; }
 .theme-dock .th-dot[data-theme="mint"]{ background:#4ade80; }
 @media print{ .theme-dock{ display:none; } }
 </style>
@@ -517,7 +517,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
         <button class="btn" id="btnMarkSaved" style="display:none" title="把指令交给 AI 落盘后点此清除未保存标记">✓ 已落盘</button>
       </div>
       <div class="bk-wrap" id="bkWrap">
-        <span class="cache-badge" id="cacheBadge" style="display:none">⚠️ 缓存模式：cache/prompts.json 读取失败，当前显示上次快照</span>
+        <span class="cache-badge" id="cacheBadge" style="display:none">⚠️ 快照模式：data/prompts.json 读取失败，当前显示上次快照</span>
         <button class="btn" id="btnBkEnable" style="display:none">💾 授权目录备份</button>
         <span class="bk-status" id="bkStatus">本地快照备份中</span>
         <button class="btn" id="btnBkChange" style="display:none">📂 换目录</button>
@@ -570,7 +570,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
   <div class="fill-panel">
     <div class="fp-head">
       <div class="fp-title" id="itemTitle">新增提示词</div>
-      <span class="fp-count">落盘 cache/prompts.json · 刷新即见</span>
+      <span class="fp-count">落盘 data/prompts.json · 刷新即见</span>
     </div>
     <div class="fp-fields">
       <div class="fp-field"><label for="itemName">标题</label><input id="itemName" placeholder="如：日报速写" /></div>
@@ -590,7 +590,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
   <div class="fill-panel" style="width:460px;">
     <div class="fp-head">
       <div class="fp-title" id="groupTitle">新建分组</div>
-      <span class="fp-count">落盘 cache/prompts.json · 刷新即见</span>
+      <span class="fp-count">落盘 data/prompts.json · 刷新即见</span>
     </div>
     <div class="fp-fields">
       <div class="fp-field"><label for="groupName">分组名</label><input id="groupName" placeholder="如：灵感" /></div>
@@ -635,7 +635,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
     <div class="hp-grid">
       <div class="hp-item">
         <div class="hp-t">① 添加与修改</div>
-        <div class="hp-d">页面点 <b>「＋ 新增提示词」/「👁 详情」/「✎」/「🗑」</b>（授权目录即写即存），或对 AI 说 <b>「把 XX 加到锦囊的写作输出分组」</b>，AI 写入 cache/prompts.json，刷新即见。</div>
+        <div class="hp-d">页面点 <b>「＋ 新增提示词」/「👁 详情」/「✎」/「🗑」</b>（授权目录即写即存），或对 AI 说 <b>「把 XX 加到锦囊的写作输出分组」</b>，AI 写入 data/prompts.json，刷新即见。</div>
       </div>
       <div class="hp-item">
         <div class="hp-t">② 排序与移动</div>
@@ -643,7 +643,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
       </div>
       <div class="hp-item">
         <div class="hp-t">③ 打开方式</div>
-        <div class="hp-d">HTTP 访问读 cache/prompts.json；file:// 直开则回退到本地缓存快照。</div>
+        <div class="hp-d">HTTP 访问读 data/prompts.json；file:// 直开则回退到本地缓存快照。</div>
       </div>
       <div class="hp-item">
         <div class="hp-t">④ 数据安全</div>
@@ -1232,17 +1232,20 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
       return writeBackupNow().then(function(){
         return readPouch().then(function(text){
           if (text) return JSON.parse(text);
-          return fetch('cache/prompts.json', { cache: 'no-store' })
+          return fetch('data/prompts.json', { cache: 'no-store' })
             .then(function(r){ if (!r.ok) throw new Error('nf'); return r.json(); })
             .catch(function(){
-              return fetch('prompts.json', { cache: 'no-store' }).then(function(r2){ return r2.json(); });
+              return fetch('cache/prompts.json', { cache: 'no-store' }).then(function(r2){ if (!r2.ok) throw new Error('nf'); return r2.json(); });
+            })
+            .catch(function(){
+              return fetch('prompts.json', { cache: 'no-store' }).then(function(r3){ return r3.json(); });
             })
             .catch(function(){ return state.data; });
         });
       }).then(function(latest){
         var next = op.apply(latest);
         if (next === null) return false;
-        return bkWrite('prompts.json', 'cache', JSON.stringify(next, null, 2)).then(function(){
+        return bkWrite('prompts.json', 'data', JSON.stringify(next, null, 2)).then(function(){
           state.data = next;
           applyUserState();
           state.dirty = false; state.moves = [];
@@ -1251,7 +1254,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
           return true;
         });
       }).catch(function(){
-        toast('写入 cache/prompts.json 失败，请检查目录授权', true);
+        toast('写入 data/prompts.json 失败，请检查目录授权', true);
         return false;
       });
     });
@@ -1261,10 +1264,13 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
     if (!state.dirty || !bkDirHandle) return Promise.resolve();
     return readPouch().then(function(text){
       if (text) return JSON.parse(text);
-      return fetch('cache/prompts.json', { cache: 'no-store' })
+      return fetch('data/prompts.json', { cache: 'no-store' })
         .then(function(r){ if (!r.ok) throw new Error('nf'); return r.json(); })
         .catch(function(){
-          return fetch('prompts.json', { cache: 'no-store' }).then(function(r2){ return r2.json(); });
+          return fetch('cache/prompts.json', { cache: 'no-store' }).then(function(r2){ if (!r2.ok) throw new Error('nf'); return r2.json(); });
+        })
+        .catch(function(){
+          return fetch('prompts.json', { cache: 'no-store' }).then(function(r3){ return r3.json(); });
         })
         .catch(function(){ return state.data; });
     })
@@ -1275,7 +1281,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
           var m = byId[p.id];
           if (m){ p.order = m.order; p.group = m.group; }
         });
-        return bkWrite('prompts.json', 'cache', JSON.stringify(latest, null, 2)).then(function(){
+        return bkWrite('prompts.json', 'data', JSON.stringify(latest, null, 2)).then(function(){
           state.data = latest;
           applyUserState();
           state.dirty = false; state.moves = [];
@@ -1674,11 +1680,14 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
       return h;
     });
   }
-  /* 数据文件读：cache/prompts.json 优先，读不到回退根目录旧文件（旧目录结构兼容） */
+  /* 数据文件读：data/prompts.json 优先，读不到回退旧默认 cache/，再回退根目录旧文件（结构兼容） */
   function readPouch(){
-    return bkRead('prompts.json', 'cache').then(function(text){
+    return bkRead('prompts.json', 'data').then(function(text){
       if (text !== null) return text;
-      return bkRead('prompts.json');
+      return bkRead('prompts.json', 'cache').then(function(text2){
+        if (text2 !== null) return text2;
+        return bkRead('prompts.json');
+      });
     });
   }
   /* 备份文件读：backup/ 优先，读不到回退根目录旧文件（旧目录结构兼容） */
@@ -1954,15 +1963,18 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
     render();
     if (bootMode === 'cache') cacheBadge.style.display = '';
     if (bootMode === 'demo'){
-      cacheBadge.textContent = '📌 示例模式：未读到 cache/prompts.json，当前展示系统自带示例提示词（file:// 直开或数据文件尚未生成）。经 HTTP 打开页面并生成数据文件后即为你的提示词，示例可随时删除。';
+      cacheBadge.textContent = '📌 示例模式：未读到 data/prompts.json，当前展示系统自带示例提示词（file:// 直开或数据文件尚未生成）。经 HTTP 打开页面并生成数据文件后即为你的提示词，示例可随时删除。';
       cacheBadge.style.display = '';
     }
   }
   // 数据优先：fetch 主链不依赖本地存储，页面尽快可见
-  fetch('cache/prompts.json', { cache: 'no-store' })
+  fetch('data/prompts.json', { cache: 'no-store' })
     .then(function(r){ if (!r.ok) throw new Error('nf'); return r.json(); })
     .catch(function(){
-      return fetch('prompts.json', { cache: 'no-store' }).then(function(r2){ return r2.json(); });
+      return fetch('cache/prompts.json', { cache: 'no-store' }).then(function(r2){ if (!r2.ok) throw new Error('nf'); return r2.json(); });
+    })
+    .catch(function(){
+      return fetch('prompts.json', { cache: 'no-store' }).then(function(r3){ return r3.json(); });
     })
     .then(function(data){
       state.data = data;
@@ -2031,7 +2043,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
   <div class="theme-dock" id="themeDock">
     <button class="th-dot" type="button" data-theme="gold" title="gold 暖棕金"></button>
     <button class="th-dot" type="button" data-theme="tech" title="tech 深蓝科技"></button>
-    <button class="th-dot" type="button" data-theme="mono" title="mono 极简黑白"></button>
+    <button class="th-dot" type="button" data-theme="mono" title="mono Darcula 深灰蓝"></button>
     <button class="th-dot" type="button" data-theme="mint" title="mint 薄荷绿"></button>
   </div>
 </body>

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

@@ -1,10 +1,10 @@
 # 锦囊使用指南
 
-锦囊（prompt-pouch）是一个本地 HTML 提示词管理台：暖棕金默认配色，内置四套主题（暖棕金/深蓝科技/极简黑白/薄荷绿，右下角换肤坞随时切换），分组侧栏 + 搜索 + 卡片网格，妙计入囊、随取随用。页面与数据分离——页面可直写、AI 可代笔（双笔协作），你只管说，刷新即见。
+锦囊（prompt-pouch）是一个本地 HTML 提示词管理台：暖棕金默认配色，内置四套主题（暖棕金/深蓝科技/Darcula 深灰蓝/薄荷绿，右下角换肤坞随时切换），分组侧栏 + 搜索 + 卡片网格，妙计入囊、随取随用。页面与数据分离——页面可直写、AI 可代笔（双笔协作），你只管说，刷新即见。
 
 ## 怎么用
 
-1. **打开页面**：对 AI 说「打开锦囊」即可（自动起服务并打开浏览器）；手动方式：`cd <目录> && python3 -m http.server 8933`（Windows 用 `py -m http.server`），浏览器访问 `http://localhost:8933/prompt-pouch.html`（HTTP 方式才能读 cache/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:// 直开时回退浏览器缓存快照，无快照则展示内置示例提示词（仅作示范），不推荐日常使用）
 2. **添加提示词**：页面点「＋ 新增提示词」填表保存（已授权目录即写即存）；或对 AI 说「把 XX 加到锦囊的写作输出分组」（不说分组也行，AI 会列出现有分组让你选；分组不存在时会问你是否新建）
 3. **查看与修改**：卡片正文超长只显示前三行，点「👁 详情」弹窗看全文（超长限高滚动），弹窗内可直接「⧉ 复制」或「✎ 修改」，并附时间线——创建时间、上次修改时间（修改过才显示）、最近使用时间（用过才显示）；卡片上也能直接点「✎」改完保存；或对 AI 说「修改锦囊里『日报速写』的内容」，改后刷新
 4. **删除**：页面点卡片「🗑」；或对 AI 说「删掉锦囊里『XX』这条」
@@ -18,7 +18,7 @@
 - **{变量} 插值**：内容含花括号占位（如「{功能名}」）的提示词，点复制会自动弹出填充面板，填入变量后实时预览再复制
 - **自动备份（默认开启）**：数据一有变更 2 秒内自动备份——首次变更会请求授权写入 prompt-pouch.html 所在目录（弹窗选同目录即可，选一次后浏览器记住），写 backup/pouch-backup.json 并滚动保留上一版 .prev.json；未授权或浏览器不支持时自动降级为本地快照（浏览器内保留最近 5 份），页内「↩ 恢复」均可一键回滚；顶栏「📂 换目录」可随时重新配置备份目录
 - **详情弹窗**：点卡片「👁 详情」弹出全文查看（超长内容限高 52vh 内滚动），带复制与修改入口，附时间线（创建 / 上次修改 / 最近使用）；含 {变量} 的模板会在弹窗里标出变量清单，复制时自动进入填充面板
-- **页面直写（双笔）**：页面增删改直接写入 cache/prompts.json（与自动备份共用同一目录授权）；未授权时自动降级——生成操作指令复制到剪贴板，粘贴给 AI 落盘
+- **页面直写（双笔）**：页面增删改直接写入 data/prompts.json（与自动备份共用同一目录授权）；未授权时自动降级——生成操作指令复制到剪贴板，粘贴给 AI 落盘
 - **侧栏局部滚动**：分组较多时，左侧「收藏 + 分组列表」区域独立滚动（窄滚动条），「全部」「＋ 新建分组」「锦囊用法」固定不滚；窄屏下自动恢复平铺排列
 - **批量整理入囊**：把一堆文字/文件交给 AI，或说「把最近对话框内容整理进锦囊」，AI 按现有分组归档、装不下的推荐新分组，你调整确认后一次性写入
 - **四种排序**：最新添加（按添加时间倒序，全时间范围）/ 最近使用 / 使用频率 / 手动顺序；排序选择会自动记住，下次打开不变
@@ -28,5 +28,5 @@
 
 ## 提醒
 
-- 数据在 cache/prompts.json（备份在 backup/ 目录）；迁移/备份复制 cache/ 与 backup/ 两个目录即可
+- 数据在 data/prompts.json（备份在 backup/ 目录）；迁移/备份复制 data/ 与 backup/ 两个目录即可
 - 页面样式与脚本升级由仓库 reference.html 重新复制完成，不影响你的数据

package/prompt-pouch/user-config.md

@@ -1,21 +1,21 @@
-CONFIG_VERSION: 3
+CONFIG_VERSION: 4
 
 # 页面与数据目录（prompt-pouch.html 与 prompts.json 的落盘处）
 DIR: /Users/luzhaosheng/MyWork/prompt-pouch
 DIR_WIN: %USERPROFILE%\prompt-pouch
 
-# 本地预览端口（HTTP 方式访问 cache/prompts.json）
+# 本地预览端口（HTTP 方式访问 data/prompts.json）
 PORT: 8933
 
-# 数据与备份子目录（相对 DIR；空串 = 平铺在 DIR 根下，旧行为）
-DATA_DIR: cache
+# 数据与备份子目录（相对 DIR；空串 = 平铺在 DIR 根下，旧行为）。v4 起 DATA_DIR 默认 data（语义正名：目录放的是全量数据不是缓存；v3 及以前默认 cache）
+DATA_DIR: data
 BACKUP_DIR: backup
 
 # 首次初始化数据：example = 示例五组（写作输出/沟通协作/规划执行/复盘成长/提问艺术，各职业通用）；empty = 空结构
 INIT_DATA: example
 
 # 页面主题（初始化时写入页面根标签 data-theme；页面右下角换肤坞可随时切换）
-# 可选：gold 暖棕金（默认）/ tech 深蓝科技 / mono 极简黑白 / mint 薄荷绿
+# 可选：gold 暖棕金（默认）/ tech 深蓝科技 / mono Darcula 深灰蓝 / mint 薄荷绿
 THEME: gold
 
 # 初始化/落盘前是否先确认目标目录