dsh-font-enhancer 1.2.0 → 1.3.0

package/README.md

@@ -12,13 +12,14 @@ Chinese/English font, font-size, line-height, weight, italic, and text color.
 Features **unified** global font/color overrides, **theme** save/switch, **框选
 (pick-region)** element selection, and **random** font/color generators.
 
-> ✅ **v1.2.0 同时支持 DSH **网页端**（浏览器访问 Web GUI，默认 `http://127.0.0.1:43120`）
-> 和 **桌面端**（Electron 内置窗口）。** 两端均可正常使用框选区域、字体/颜色设置
-> 等全部功能。
+> ✅ **v1.3.0 同时支持 DSH **网页端**（浏览器访问 Web GUI）和 **桌面端**（Electron 内置窗口）。**
+> 新增**一键下载安装可爱字体**（霞鹜文楷/得意黑/站酷快乐体等，带实时下载进度）、**添加自提供安装包**、
+> **🔄 刷新按钮**、保存方案记住统一状态等功能。搜「字体」即可在插件市场找到本插件。
 >
-> ✅ v1.2.0 supports both the DSH **Web GUI** (browser access, default
-> `http://127.0.0.1:43120`) and the **Desktop Electron window**. All features
-> work in both environments.
+> ✅ v1.3.0 supports both the DSH **Web GUI** (browser) and the **Desktop Electron window**.
+> New: one-click install of cute fonts (LXGW WenKai / Smiley Sans / ZCOOL KuaiLe etc. with live
+> download progress), add your own font file, refresh button, themes remember unified overrides.
+> Search "font / 字体" on the plugin market to find it.
 
 ---
 
@@ -84,9 +85,8 @@ Or copy the folder into `node_modules/` and add the package name to the profile
 ### 版本 Versions
 | 版本 | 说明 |
 |------|------|
-| `v1.2.0` | **网页端+桌面端双端可用**。修复桌面端 Electron 窗口浮球不可见问题。 |
-| `v1.1.0` | 增强版：新增框选区域（pick-region）+ 采集调试 + 随机配色。**仅网页端可用**。 |
-| `v1.0.0` | 旧版：内置区域样式 + 统一控制 + 主题。相对简单，兼容性更好。 |
+| `v1.3.0` | **最新**：网页端+桌面端双端可用。一键下载安装可爱字体（带进度）、添加自提供安装包、刷新按钮、保存方案记住统一状态、字重斜体。搜「字体」可找到。 |
+| `v1.0.0` | 旧版：内置区域样式 + 统一控制 + 主题。 |
 
 ---
 

package/lib/client.js

@@ -54,7 +54,7 @@ window.__ModuleLoader__.load({
     // old region colors (e.g. the first cyan/blue scheme) are dropped and the
     // latest DEFAULT_REGIONS() palette is loaded instead. This makes palette
     // refreshes survive a restart without needing the user to clear localStorage.
-    var SCHEMA_VERSION = 21;
+    var SCHEMA_VERSION = 22;
     // 21: DEFAULT_REGIONS 清空 —— 用户从零开始逐项框选/添加、逐项测试颜色稳定生效
 
     // ---------- helpers ----------
@@ -118,28 +118,30 @@ window.__ModuleLoader__.load({
       return d;
     }
     function DEFAULT_REGIONS() {
-      // 默认区域 = 用户采集到的「稳定 DOM 路径」（operation.log REC_NEW），跨重启有效。
-      // 每项先用统一红色 #FF0000 验证是否稳定定位+变色，确认后再逐项调整颜色。
-      // 注意：部分类名是 CSS-Modules 哈希（.mMKm6W_*/.xUkysG_*），若 DSH 升级 re-hash 会失效，需重新采集。
+      // 默认区域 = 用 data-slot 稳定属性定位（不受 DSH 前端 CSS-Modules re-hash 影响）。
+      // 校准自 DSH 2.0.4 真实 DOM（2026-09-01 operation.log CALIBRATE 探针数据）。
+      // 每项先给一个独特颜色供交叉验证，确认稳定后固化。
+      // 注意：CSS-Modules 哈希类名（如 .mMKm6W_*）可能随 DSH 升级变化，尽量用 data-slot 定位。
       function mk(o) { var d = defaultRegion(); return Object.assign(d, o); }
       return [
-        // 探针方案：每个区域一个独特颜色，用户重启后对照界面变色位置→告诉我颜色对应哪个区域，我据此固化正确默认。
-        // logo（红）
-        mk({ name: "logo", selector: '[data-slot="sidebar"] .xUkysG_logoRow, [data-slot="sidebar"] [class*="logo"]', enabled: true, useColor: true, color: "#FF0000", group: "其他" }),
-        // 按钮（橙）
-        mk({ name: "按钮", selector: '[data-slot="sidebar"] .xUkysG_newSession, [data-slot="sidebar"] .dsh-atb-entry, [data-slot="sidebar"] .dsw-web-sessions-badge, [data-slot="sidebar"] .zOa2rq_trigger', enabled: true, useColor: true, color: "#FF8C00", group: "左侧栏" }),
-        // 对话栏上方（金）
-        mk({ name: "对话栏上方", selector: '[data-slot="conversation"] ._4RFuWq_titleRow, [data-slot="conversation"] ._4RFuWq_tabs', enabled: true, useColor: true, color: "#FFD700", group: "对话区" }),
-        // 工作区（亮绿）
-        mk({ name: "工作区", selector: '[data-slot="sidebar"] .xUkysG_regionArea', enabled: true, useColor: true, color: "#00FF00", group: "左侧栏" }),
-        // 对话区（深天蓝）
-        mk({ name: "对话区", selector: '[data-slot="conversation.chat.node"] .sDVxEG_body, [data-slot*="conversation.chat.node"] [data-slot="markdown"]', enabled: true, useColor: true, color: "#00BFFF", group: "对话区" }),
-        // 对话信息显示（蓝紫）
-        mk({ name: "对话信息显示", selector: '[data-slot="conversation.chat.node"] ._row_luwio_16, [data-slot="conversation.chat.node"] .QWj8lG_actions', enabled: true, useColor: true, color: "#8A2BE2", group: "对话区" }),
+        // 左侧栏整体（红）
+        mk({ name: "左侧栏", selector: '[data-slot="sidebar"]', enabled: true, useColor: true, color: "#FF0000", group: "左侧栏" }),
+        // 对话区消息（深天蓝）— 用 chat.node + markdown 双重定位
+        mk({ name: "对话区", selector: '[data-slot="markdown"], [data-slot="conversation.chat.node"] > div', enabled: true, useColor: true, color: "#00BFFF", group: "对话区" }),
+        // 对话栏上方（金）— header 区域
+        mk({ name: "对话栏上方", selector: '[data-slot="conversation.session.header"]', enabled: true, useColor: true, color: "#FFD700", group: "对话区" }),
         // 输入区（品红）
-        mk({ name: "输入区", selector: '[data-slot*="conversation.composer"] .krUYjW_card, [data-slot*="conversation.composer"] textarea, [data-slot*="conversation.composer"] [contenteditable="true"]', enabled: true, useColor: true, color: "#FF00FF", group: "对话区" }),
-        // 对话栏底部区域（青）
-        mk({ name: "对话栏底部区域", selector: '[data-slot="conversation.composer.dock"] .q2FAPq_root, [data-slot="conversation.composer.dock"] span button', enabled: true, useColor: true, color: "#00FFFF", group: "对话区" })
+        mk({ name: "输入区", selector: '[data-slot="conversation.composer"]', enabled: true, useColor: true, color: "#FF00FF", group: "对话区" }),
+        // 对话栏底部区域（青）— dock
+        mk({ name: "对话栏底部区域", selector: '[data-slot="conversation.input.dock"]', enabled: true, useColor: true, color: "#00FFFF", group: "对话区" }),
+        // 工作区 / 项目列表（亮绿）
+        mk({ name: "工作区", selector: '[data-slot="sidebar.workspaces"]', enabled: true, useColor: true, color: "#00FF00", group: "左侧栏" }),
+        // 对话信息显示（蓝紫）— 对话底部 footer/actions 区域
+        mk({ name: "对话信息显示", selector: '[data-slot="conversation.session.header.utilities"], [data-slot="conversation.session.header.actions"]', enabled: true, useColor: true, color: "#8A2BE2", group: "对话区" }),
+        // 品牌/Logo（橙）
+        mk({ name: "品牌标识", selector: '[data-slot="sidebar.brand.mark"], [data-slot="sidebar.brand.name"]', enabled: true, useColor: true, color: "#FF8C00", group: "左侧栏" }),
+        // 底部操作栏（灰）
+        mk({ name: "底部操作栏", selector: '[data-slot="sidebar.footer.action"]', enabled: true, useColor: true, color: "#808080", group: "左侧栏" })
       ];
     }
     function normThemes(o) {
@@ -149,7 +151,7 @@ window.__ModuleLoader__.load({
       });
     }
     function normUnified(o) {
-      var u = { uc: { enabled: false, color: "#FFFFFF" }, uf: { enabled: false, en: "Times New Roman", zh: "KaiTi", size: 15 } };
+      var u = { uc: { enabled: false, color: "#FFFFFF" }, uf: { enabled: false, en: "Times New Roman", zh: "KaiTi", size: 15, weight: 400, italic: false } };
       if (!o || !o.unified || typeof o.unified !== "object") return u;
       var s = o.unified;
       if (s.uc && typeof s.uc === "object") {
@@ -161,24 +163,27 @@ window.__ModuleLoader__.load({
         if (typeof s.uf.en === "string") u.uf.en = s.uf.en;
         if (typeof s.uf.zh === "string") u.uf.zh = s.uf.zh;
         u.uf.size = clamp(s.uf.size, 12, 22);
+        u.uf.weight = clamp(s.uf.weight, 100, 900);
+        u.uf.italic = s.uf.italic === true;
       }
       return u;
     }
     function loadSettings() {
       try {
         var raw = localStorage.getItem(STORE_KEY);
-        if (!raw) return { regions: DEFAULT_REGIONS(), themes: [], unified: normUnified(null), bx: null, by: null };
+        if (!raw) return { regions: DEFAULT_REGIONS(), themes: [], unified: normUnified(null), customFonts: [], bx: null, by: null };
         var o = JSON.parse(raw);
         var themes = normThemes(o);
         var unified = normUnified(o);
+        var customFonts = Array.isArray(o.customFonts) ? o.customFonts : [];
         if (o && (typeof o.ver !== "number" || o.ver < SCHEMA_VERSION)) {
           // Version bump: write back fresh region palette but KEEP themes &
-          // unified settings so users don't lose their saved themes.
-          var fresh = { regions: DEFAULT_REGIONS(), themes: themes, unified: unified, ver: SCHEMA_VERSION };
+          // unified & customFonts settings so users don't lose their saved themes.
+          var fresh = { regions: DEFAULT_REGIONS(), themes: themes, unified: unified, customFonts: customFonts, ver: SCHEMA_VERSION };
           if (typeof o.bx === "number") fresh.bx = o.bx;
           if (typeof o.by === "number") fresh.by = o.by;
           localStorage.setItem(STORE_KEY, JSON.stringify(fresh));
-          return { regions: DEFAULT_REGIONS(), themes: themes, unified: unified, bx: typeof o.bx === "number" ? o.bx : null, by: typeof o.by === "number" ? o.by : null };
+          return { regions: DEFAULT_REGIONS(), themes: themes, unified: unified, customFonts: customFonts, bx: typeof o.bx === "number" ? o.bx : null, by: typeof o.by === "number" ? o.by : null };
         }
         if (o && Array.isArray(o.regions)) {
           var loaded = o.regions.map(normRegion).filter(function (x) { return x.group !== "已识别"; });
@@ -192,6 +197,7 @@ window.__ModuleLoader__.load({
             regions: regions,
             themes: themes,
             unified: unified,
+            customFonts: customFonts,
             bx: typeof o.bx === "number" ? o.bx : null,
             by: typeof o.by === "number" ? o.by : null
           };
@@ -207,9 +213,9 @@ window.__ModuleLoader__.load({
         g.lh = clamp(o.lh, 1.3, 2.2);
         g.weight = clamp(o.weight, 100, 900);
         g.italic = o.italic === true;
-        return { regions: [g], themes: themes, unified: unified, bx: typeof o.bx === "number" ? o.bx : null, by: typeof o.by === "number" ? o.by : null };
+        return { regions: [g], themes: themes, unified: unified, customFonts: customFonts, bx: typeof o.bx === "number" ? o.bx : null, by: typeof o.by === "number" ? o.by : null };
       } catch (e) {
-        return { regions: DEFAULT_REGIONS(), themes: [], unified: normUnified(null), bx: null, by: null };
+        return { regions: DEFAULT_REGIONS(), themes: [], unified: normUnified(null), customFonts: [], bx: null, by: null };
       }
     }
     function saveSettings(data) {
@@ -269,8 +275,8 @@ window.__ModuleLoader__.load({
             en: u.uf.enabled ? u.uf.en : r.en,
             zh: u.uf.enabled ? u.uf.zh : r.zh,
             size: u.uf.enabled ? u.uf.size : r.size,
-            weight: r.weight,
-            italic: r.italic,
+            weight: u.uf.enabled ? u.uf.weight : r.weight,
+            italic: u.uf.enabled ? u.uf.italic : r.italic,
             lh: r.lh,
             useColor: u.uc.enabled || r.useColor,
             color: u.uc.enabled ? u.uc.color : r.color
@@ -393,6 +399,26 @@ window.__ModuleLoader__.load({
         "",
         "/* ── hint ── */",
         "#dsh-fe-hint{margin-top:12px;font-size:10px;color:#6b7280;line-height:1.6;padding:10px 12px;background:rgba(255,255,255,.02);border-radius:10px;border:1px solid rgba(255,255,255,.04)}",
+        "#dsh-fe-customfont{margin:12px 0 10px;padding:10px 12px;background:rgba(255,255,255,.03);border:1px solid rgba(255,255,255,.06);border-radius:12px}",
+        "#dsh-fe-customfont .dsh-fe-cf-label{font-size:10px;color:#6b7280;font-weight:600;letter-spacing:.03em;text-transform:uppercase;margin-bottom:8px}",
+        "#dsh-fe-customfont .dsh-fe-cf-list{display:flex;flex-direction:column;gap:4px}",
+        "#dsh-fe-customfont .dsh-fe-cf-item{display:flex;align-items:center;gap:6px;padding:4px 6px;border-radius:6px;background:rgba(255,255,255,.03);border:1px solid rgba(255,255,255,.04)}",
+        "#dsh-fe-customfont .dsh-fe-cf-name{flex:1;min-width:0;font-size:11px;color:#cfd4dc}",
+        "#dsh-fe-customfont .dsh-fe-cf-link{font-size:10px;color:#6aa6ff;text-decoration:none;flex-shrink:0}",
+        "#dsh-fe-customfont .dsh-fe-cf-link:hover{text-decoration:underline}",
+        "#dsh-fe-customfont .dsh-fe-cf-item button{flex-shrink:0;padding:2px 8px;border-radius:5px;border:1px solid rgba(255,255,255,.1);background:rgba(255,255,255,.06);color:#cfd4dc;cursor:pointer;font:inherit;font-size:10px}",
+        "#dsh-fe-customfont .dsh-fe-cf-item button:hover{background:rgba(255,255,255,.12)}",
+        "#dsh-fe-customfont .dsh-fe-cf-tip{font-size:10px;color:#6b7280;margin-top:6px;line-height:1.5}",
+        "#dsh-fe-customfont .dsh-fe-cf-file{margin-top:10px;padding-top:10px;border-top:1px dashed rgba(255,255,255,.08)}",
+        "#dsh-fe-customfont .dsh-fe-cf-file .dsh-fe-cf-label{margin-bottom:6px}",
+        "#dsh-fe-customfont .dsh-fe-cf-file-row{display:flex;gap:6px;align-items:center}",
+        "#dsh-fe-customfont .dsh-fe-cf-file-row input[type=file]{flex:1;min-width:0;font-size:11px;color:#cfd4dc}",
+        "#dsh-fe-customfont .dsh-fe-cf-file-row button{flex-shrink:0;padding:5px 10px;border-radius:7px;border:1px solid rgba(255,255,255,.1);background:rgba(255,255,255,.06);color:#cfd4dc;cursor:pointer;font:inherit;font-size:12px}",
+        "#dsh-fe-customfont .dsh-fe-cf-file-row button:hover{background:rgba(255,255,255,.12)}",
+        "#dsh-fe-guide{margin-top:12px;padding:12px 14px;background:rgba(255,255,255,.02);border:1px solid rgba(255,255,255,.05);border-radius:12px;font-size:12px;line-height:1.7;color:#cfd4dc}",
+        "#dsh-fe-guide h4{margin:0 0 8px;font-size:14px;color:#f0f2f5}",
+        "#dsh-fe-guide p{margin:0 0 10px}",
+        "#dsh-fe-guide b{color:#8ab8ff}",
         "",
         "/* ── toast ── */",
         "#dsh-fe-toast{position:fixed;left:50%;bottom:72px;z-index:2147483601;transform:translateX(-50%);padding:8px 18px;border-radius:10px;font:12px/1.4 KaiTi,'Microsoft YaHei',sans-serif;background:rgba(0,0,0,.85);border:1px solid rgba(255,255,255,.12);box-shadow:0 4px 20px rgba(0,0,0,.5);pointer-events:none;opacity:0;transition:opacity .25s;white-space:nowrap;color:#e6e6e6}",
@@ -404,6 +430,7 @@ window.__ModuleLoader__.load({
 
     // ---------- state ----------
     var state = loadSettings();
+    state.customFonts = state.customFonts || [];
     var regions = state.regions;
     var root = null;
     var panel = null;
@@ -474,7 +501,22 @@ window.__ModuleLoader__.load({
       return Array.isArray(state.themes) ? state.themes : [];
     }
     function persist() {
-      saveSettings({ regions: regions, themes: getThemes(), unified: state.unified, bx: state.bx, by: state.by });
+      saveSettings({ regions: regions, themes: getThemes(), unified: state.unified, customFonts: state.customFonts || [], bx: state.bx, by: state.by });
+    }
+    // Return merged font lists: built-ins + user custom fonts (deduped).
+    function mergedEnFonts() {
+      var list = EN_FONTS.slice();
+      (state.customFonts || []).forEach(function (f) {
+        if (f && f.en && !list.some(function (x) { return x[1] === f.en; })) list.push([f.en, f.en]);
+      });
+      return list;
+    }
+    function mergedZhFonts() {
+      var list = ZH_FONTS.slice();
+      (state.customFonts || []).forEach(function (f) {
+        if (f && f.zh && !list.some(function (x) { return x[1] === f.zh; })) list.push([f.zh, f.zh]);
+      });
+      return list;
     }
 
     // ── Point-and-pick custom region: hover to preview, click to select, name ─
@@ -819,6 +861,12 @@ window.__ModuleLoader__.load({
           color: r.color, useColor: r.useColor === true
         };
       });
+      // 记住全局统一的勾选状态和值，应用主题时能完整复原
+      var u = state.unified || {};
+      recipe.__unified = {
+        uc: u.uc ? { enabled: u.uc.enabled === true, color: u.uc.color } : { enabled: false, color: "#FFFFFF" },
+        uf: u.uf ? { enabled: u.uf.enabled === true, en: u.uf.en, zh: u.uf.zh, size: u.uf.size, weight: u.uf.weight, italic: u.uf.italic === true } : { enabled: false, en: "Times New Roman", zh: "KaiTi", size: 15, weight: 400, italic: false }
+      };
       var th = getThemes();
       // 只新增或覆盖同名主题，绝不删除其他主题
       var found = false;
@@ -877,16 +925,31 @@ window.__ModuleLoader__.load({
           r.color = rc.color; r.useColor = rc.useColor === true;
         }
       });
-      // 应用主题时自动关闭统一颜色和统一字体，以免覆盖
-      if (state.unified.uc.enabled) {
-        state.unified.uc.enabled = false;
-        var ucEl = root.querySelector("#dsh-fe-u-color");
-        if (ucEl) ucEl.checked = false;
-      }
-      if (state.unified.uf.enabled) {
-        state.unified.uf.enabled = false;
-        var ufEl = root.querySelector("#dsh-fe-u-font");
-        if (ufEl) ufEl.checked = false;
+      // 应用主题时恢复保存的统一状态（勾选 + 值），实现完整复原
+      if (t.recipe && t.recipe.__unified) {
+        var sun = t.recipe.__unified;
+        state.unified = state.unified || {};
+        if (sun.uc) { state.unified.uc = { enabled: sun.uc.enabled === true, color: sun.uc.color || "#FFFFFF" }; }
+        if (sun.uf) {
+          state.unified.uf = {
+            enabled: sun.uf.enabled === true, en: sun.uf.en || "Times New Roman",
+            zh: sun.uf.zh || "KaiTi", size: sun.uf.size != null ? sun.uf.size : 15,
+            weight: sun.uf.weight != null ? sun.uf.weight : 400, italic: sun.uf.italic === true
+          };
+        }
+        // 同步界面上的统一控件
+        var ucEl2 = root.querySelector("#dsh-fe-u-color"); var ucVal2 = root.querySelector("#dsh-fe-u-color-val");
+        var ufEl2 = root.querySelector("#dsh-fe-u-font");
+        var ufEn2 = root.querySelector("#dsh-fe-u-en"); var ufZh2 = root.querySelector("#dsh-fe-u-zh");
+        var ufSz2 = root.querySelector("#dsh-fe-u-size"); var ufWt2 = root.querySelector("#dsh-fe-u-weight"); var ufIt2 = root.querySelector("#dsh-fe-u-italic");
+        if (ucEl2) ucEl2.checked = state.unified.uc.enabled; if (ucVal2) ucVal2.value = state.unified.uc.color;
+        if (ufEl2) ufEl2.checked = state.unified.uf.enabled; if (ufEn2) ufEn2.value = state.unified.uf.en;
+        if (ufZh2) ufZh2.value = state.unified.uf.zh; if (ufSz2) ufSz2.value = state.unified.uf.size;
+        if (ufWt2) ufWt2.value = state.unified.uf.weight; if (ufIt2) ufIt2.checked = state.unified.uf.italic;
+      } else {
+        // 旧主题没有 __unified：回退为关闭统一，避免误覆盖
+        if (state.unified.uc && state.unified.uc.enabled) { state.unified.uc.enabled = false; var ucEl3 = root.querySelector("#dsh-fe-u-color"); if (ucEl3) ucEl3.checked = false; }
+        if (state.unified.uf && state.unified.uf.enabled) { state.unified.uf.enabled = false; var ufEl3 = root.querySelector("#dsh-fe-u-font"); if (ufEl3) ufEl3.checked = false; }
       }
       renderCards();
       applyAll(regions);
@@ -911,8 +974,8 @@ window.__ModuleLoader__.load({
         body =
           '<div class="dsh-fe-card-body">' +
           '<div class="dsh-fe-body-col">' +
-          "<label>英文字体</label><select data-rid='" + r.id + "' data-fld='en'>" + optionsHtml(EN_FONTS, r.en) + "</select>" +
-          "<label>中文字体</label><select data-rid='" + r.id + "' data-fld='zh'>" + optionsHtml(ZH_FONTS, r.zh) + "</select>" +
+          "<label>英文字体</label><select data-rid='" + r.id + "' data-fld='en'>" + optionsHtml(mergedEnFonts(), r.en) + "</select>" +
+          "<label>中文字体</label><select data-rid='" + r.id + "' data-fld='zh'>" + optionsHtml(mergedZhFonts(), r.zh) + "</select>" +
           "</div>" +
           '<div class="dsh-fe-body-col">' +
           '<div class="dsh-fe-row"><div><label>字号</label><input type="number" min="12" max="22" step="1" data-rid="' + r.id + '" data-fld="size" value="' + r.size + '"></div>' +
@@ -973,13 +1036,15 @@ window.__ModuleLoader__.load({
         '<button id="dsh-fe-toggle" type="button" title="字体区域设置 Font settings">Aa</button>' +
         '<div id="dsh-fe-panel" style="display:none">' +
         '<div class="dsh-fe-header"><div class="dsh-fe-hl"><h4>字体区域设置</h4><div class="dsh-fe-sub">每个区域独立调字体/颜色</div></div><button id="dsh-fe-close" type="button" title="关闭">✕</button></div>' +
+        '<div style="font-size:11px;color:#8b93a1;padding:4px 4px 8px;line-height:1.5">⬇️ 下滑至底部有 <b style="color:#8ab8ff">快速上手说明</b>；换字体/颜色、框选、一键装可爱字体都在这里。</div>' +
         '<div class="dsh-fe-themeblock">' +
         '<select id="dsh-fe-theme-sel"></select>' +
         '<input type="text" id="dsh-fe-theme-name" placeholder="主题名" style="width:60px;padding:4px 6px;border-radius:6px;border:1px solid rgba(255,255,255,.1);background:rgba(0,0,0,.35);color:#e6e6e6;font:inherit;font-size:11px">' +
-        '<button type="button" data-act="themeSave" title="保存当前设置为选中主题">💾存</button>' +
+        '<button type="button" data-act="themeSave" title="把当前所有区域的字体/颜色保存为一个方案（填入上方名称）">💾 保存方案</button>' +
         '<button type="button" data-act="themeRename" title="重命名所选主题为输入框的名字">✏改</button>' +
         '<button type="button" data-act="themeApply" title="应用选中主题">应用</button>' +
         '<button type="button" data-act="themeDel" title="删除选中主题">🗑</button>' +
+        '<button type="button" data-act="themeClearAll" title="删除所有已保存的主题" style="color:#e08080">🗑 清空全部</button>' +
         "</div>" +
         '<div class="dsh-fe-unified" id="dsh-fe-unified">' +
         '<div class="dsh-fe-u-row">' +
@@ -991,24 +1056,57 @@ window.__ModuleLoader__.load({
         "</div>" +
         '<div class="dsh-fe-u-row">' +
         '<label><input type="checkbox" id="dsh-fe-u-font" data-u="uf" data-u-fld="enabled">统一字体</label>' +
-        '<select id="dsh-fe-u-en" data-u="uf" data-u-fld="en" style="min-width:80px">' + optionsHtml(EN_FONTS, "Times New Roman") + "</select>" +
-        '<select id="dsh-fe-u-zh" data-u="uf" data-u-fld="zh" style="min-width:70px">' + optionsHtml(ZH_FONTS, "KaiTi") + "</select>" +
+        '<select id="dsh-fe-u-en" data-u="uf" data-u-fld="en" style="min-width:80px">' + optionsHtml(mergedEnFonts(), "Times New Roman") + "</select>" +
+        '<select id="dsh-fe-u-zh" data-u="uf" data-u-fld="zh" style="min-width:70px">' + optionsHtml(mergedZhFonts(), "KaiTi") + "</select>" +
         '<input type="number" id="dsh-fe-u-size" data-u="uf" data-u-fld="size" value="15" min="12" max="22" step="1" style="width:44px" title="字号">' +
+        '<input type="number" id="dsh-fe-u-weight" data-u="uf" data-u-fld="weight" value="400" min="100" max="900" step="100" style="width:48px" title="字重(100-900)">' +
+        '<label title="统一斜体"><input type="checkbox" id="dsh-fe-u-italic" data-u="uf" data-u-fld="italic">斜体</label>' +
         "</div>" +
         "</div>" +
         '<div class="dsh-fe-toolbar">' +
         '<button type="button" data-act="pickMode" title="在界面框选文字元素，合并成一个区域并命名">🖱 框选区域</button>' +
-        '<button type="button" data-act="recordToggle" title="开启后框选/加元素会记录元素稳定定位到文件，用于排查定位区域是否跨重启失效">🔴 采集区域</button>' +
         '<button type="button" data-act="randomAllFonts" title="给所有启用区域随机分配英/中文字体">🎲 随机字体</button>' +
         '<button type="button" class="dsh-fe-btn-accent" data-act="randomAllColors" title="给所有启用区域随机分配颜色">🎨 随机颜色</button>' +
         "</div>" +
         '<div class="dsh-fe-toolbar dsh-fe-toolbar2">' +
         '<button type="button" data-act="replacePicked" title="删除全部默认区域，只保留你框选的区域">⟳ 框选取代默认</button>' +
         '<button type="button" data-act="restoreDefault" title="删除新增的框选区域，恢复内置默认区域">↺ 恢复默认区域</button>' +
-        '<button type="button" class="dsh-fe-btn-accent" data-act="saveConfig" title="保存当前框选区域配置方案">💾 保存方案</button>' +
+        '<button type="button" data-act="reloadUI" title="刷新界面（新安装的字体立即生效，无需关闭面板）">🔄 刷新</button>' +
         "</div>" +
         '<div id="dsh-fe-cards"></div>' +
-        '<div id="dsh-fe-hint">勾选区域前的复选框展开该区域设置。🎲字体只随机英/中文字体，🎨颜色随机颜色。调好的配置可保存为主题随时切换。<br><br>💡 插件卡顿/卡住时：① 点击 DSH 左下角"重载"按钮；② 或点一下右下角 Aa 悬浮球把它折叠，即可刷新插件样式。</div>' +
+        '<div class="dsh-fe-customfont">' +
+        '<div class="dsh-fe-cf-label">🎨 推荐可爱/奇特字体（一键下载安装 → 添加启用）</div>' +
+        '<div class="dsh-fe-cf-list">' +
+        '<div class="dsh-fe-cf-item"><span class="dsh-fe-cf-name">霞鹜文楷（中文手写）</span><button type="button" data-act="installFont" data-font-id="LXGW WenKai" data-font-zh="霞鹜文楷">⬇ 一键安装</button></div>' +
+        '<div class="dsh-fe-cf-item"><span class="dsh-fe-cf-name">得意黑（中文动感）</span><button type="button" data-act="installFont" data-font-id="Smiley Sans" data-font-zh="Smiley Sans">⬇ 一键安装</button></div>' +
+        '<div class="dsh-fe-cf-item"><span class="dsh-fe-cf-name">站酷快乐体（中文圆润）</span><button type="button" data-act="installFont" data-font-id="ZCOOL KuaiLe" data-font-zh="站酷快乐体">⬇ 一键安装</button></div>' +
+        '<div class="dsh-fe-cf-item"><span class="dsh-fe-cf-name">Comic Neue（英文手写·已内置）</span><button type="button" data-act="installFont" data-font-id="Comic Neue" data-font-en="Comic Neue">⬇ 一键安装</button></div>' +
+        '<div class="dsh-fe-cf-item"><span class="dsh-fe-cf-name">Baloo 2（英文圆润）</span><button type="button" data-act="installFont" data-font-id="Baloo 2" data-font-en="Baloo 2">⬇ 一键安装</button></div>' +
+        '<div class="dsh-fe-cf-item"><span class="dsh-fe-cf-name">Fredoka（英文柔和）</span><button type="button" data-act="installFont" data-font-id="Fredoka" data-font-en="Fredoka">⬇ 一键安装</button></div>' +
+        '<div class="dsh-fe-cf-item"><span class="dsh-fe-cf-name">Nunito（英文圆角）</span><button type="button" data-act="installFont" data-font-id="Nunito" data-font-en="Nunito">⬇ 一键安装</button></div>' +
+        '<div class="dsh-fe-cf-item"><span class="dsh-fe-cf-name">Caveat（英文手写）</span><button type="button" data-act="installFont" data-font-id="Caveat" data-font-en="Caveat">⬇ 一键安装</button></div>' +
+        "</div>" +
+        '<div class="dsh-fe-cf-file">' +
+        '<div class="dsh-fe-cf-label">📁 添加自提供安装包（清单里没有的字体）</div>' +
+        '<div class="dsh-fe-cf-file-row">' +
+        '<input type="file" id="dsh-fe-font-file" accept=".ttf,.otf,application/x-font-ttf,application/x-font-opentype" style="flex:1;min-width:0;color:#cfd4dc;font-size:12px">' +
+        '<button type="button" data-act="installCustomFile" style="flex-shrink:0;padding:5px 10px;border-radius:7px;border:1px solid rgba(255,255,255,.1);background:rgba(255,255,255,.06);color:#cfd4dc;cursor:pointer;font:inherit;font-size:12px">安装并添加</button>' +
+        "</div>" +
+        '<div class="dsh-fe-cf-tip">选择电脑上已有的字体安装包（.ttf/.otf），点「安装并添加」，自动装到系统并加入字体下拉。</div>' +
+        "</div>" +
+        '<div class="dsh-fe-cf-tip">💡 点「⬇ 一键安装」自动下载并装到系统，安装成功后<strong>自动添加到字体下拉</strong>，无需手动操作。安装路径会显示在提示里。中文字体较大（几MB），请耐心等待下载完成。</div>' +
+        "</div>" +
+        '<div id="dsh-fe-guide" class="dsh-fe-guide">' +
+        "<h4>📖 快速上手（30 秒学会）</h4>" +
+        "<p><b>① 改某个区域的字体/颜色</b><br>勾选区域卡片前的 ☑ → 展开设置 → 左边选字体，右边调字号/字重/斜体/颜色，马上生效。</p>" +
+        "<p><b>② 一键统一所有区域</b><br>「全局统一」区勾选 <b>统一颜色</b> 或 <b>统一字体</b>，一个设置全界面生效。</p>" +
+        "<p><b>③ 框选自己想要调整的区域</b><br>点 <b>🖱 框选区域</b> → 在界面上点选文字元素（可多选）→ 起个名字 → 确定，就能单独调它。</p>" +
+        "<p><b>④ 保存方案，随时切换</b><br>调好后填个名字 → 点 <b>💾 保存方案</b>。以后下拉选它 → 点 <b>应用</b> 一键还原。</p>" +
+        "<p><b>⑤ 用可爱字体（一键安装）</b><br>在下方字体列表点 <b>⬇ 一键安装</b> → 等下载完 → 点 <b>🔄 刷新</b>，新字体就在下拉里了。</p>" +
+        "<p><b>⑥ 添加自己下载的字体</b><br>点「📁 添加自提供安装包」→ 选电脑上的 .ttf/.otf 文件 → 点 <b>安装并添加</b>。</p>" +
+        "<p><b>⑦ 卡住了？</b><br>点 <b>🔄 刷新</b>，或点右下角 Aa 悬浮球收起来再展开。</p>" +
+        "<p style='color:#e0a060'><b>⚠️ 网页端提示</b>：如果用的是手机/浏览器打开网页端，装完新字体后需要<b>刷新网页</b>（F5）才能显示新字体；桌面端窗口无需刷新。</p>" +
+        "</div>" +
         '<div id="dsh-fe-toast"></div>' +
         "</div>";
       // Mount to the outermost <html> element, NOT document.body — DSH gives
@@ -1074,10 +1172,14 @@ window.__ModuleLoader__.load({
       var ufEn = root.querySelector("#dsh-fe-u-en");
       var ufZh = root.querySelector("#dsh-fe-u-zh");
       var ufSz = root.querySelector("#dsh-fe-u-size");
+      var ufWt = root.querySelector("#dsh-fe-u-weight");
+      var ufIt = root.querySelector("#dsh-fe-u-italic");
       if (ufEl) ufEl.checked = u.uf.enabled;
       if (ufEn) ufEn.value = u.uf.en;
       if (ufZh) ufZh.value = u.uf.zh;
       if (ufSz) ufSz.value = u.uf.size;
+      if (ufWt) ufWt.value = u.uf.weight;
+      if (ufIt) ufIt.checked = u.uf.italic;
 
       // Direct event listener for unified color picker (bypass delegation)
       var ucPicker = root.querySelector("#dsh-fe-u-color-val");
@@ -1237,6 +1339,8 @@ window.__ModuleLoader__.load({
         else if (fld === "color") state.unified[sect].color = el.value;
         else if (fld === "en" || fld === "zh") state.unified[sect][fld] = el.value;
         else if (fld === "size") state.unified[sect].size = clamp(el.value, 12, 22);
+        else if (fld === "weight") state.unified[sect].weight = clamp(el.value, 100, 900);
+        else if (fld === "italic") state.unified[sect].italic = el.checked;
         else return;
         applyAll(regions);
         persist();
@@ -1259,6 +1363,7 @@ window.__ModuleLoader__.load({
         if (!btn) return;
         var act = btn.getAttribute("data-act");
         var rid = btn.getAttribute("data-rid");
+        var el = btn;
 
         if (act === "resetAll") {
           regions = DEFAULT_REGIONS();
@@ -1278,6 +1383,113 @@ window.__ModuleLoader__.load({
         if (act === "themeRename") { themeRename(); return; }
         if (act === "themeApply") { applyTheme(); return; }
         if (act === "themeDel") { deleteTheme(); return; }
+        if (act === "themeClearAll") { state.themes = []; renderThemeSel(); persist(); showToast("已清空全部主题", "ok"); return; }
+        if (act === "reloadUI") {
+          // 强制 Chromium 加载新安装的字体，并刷新下拉列表（不关闭面板）
+          var names = [];
+          (state.customFonts || []).forEach(function (f) {
+            if (f.en) names.push(f.en);
+            if (f.zh) names.push(f.zh);
+          });
+          if (document.fonts && document.fonts.load) {
+            names.forEach(function (n) {
+              try { document.fonts.load('16px "' + n + '"').catch(function(){}); } catch (e) {}
+            });
+          }
+          renderCards();
+          renderThemeSel();
+          applyAll(regions);
+          showToast("🔄 已刷新，新字体应已生效", "ok");
+          return;
+        }
+        if (act === "installFont") {
+          var fid = el.getAttribute("data-font-id") || "";
+          var fzh = el.getAttribute("data-font-zh") || "";
+          var fen = el.getAttribute("data-font-en") || "";
+          if (!fid) { showToast("字体信息缺失", "err"); return; }
+          var btn = el; btn.textContent = "⏳ 下载中 0%"; btn.disabled = true;
+          var done = false;
+          // 轮询下载进度，更新按钮百分比
+          var poll = setInterval(function () {
+            if (done) return;
+            try {
+              fetch("/dsh-font-enhancer/font-progress?fontId=" + encodeURIComponent(fid), { cache: "no-store" })
+                .then(function (r) { return r.json(); })
+                .then(function (pg) {
+                  if (done || !pg) return;
+                  if (pg.state === "downloading" && pg.pct >= 0) { btn.textContent = "⏳ 下载中 " + pg.pct + "%"; }
+                  else if (pg.state === "done") { clearInterval(poll); }
+                  else if (pg.state === "error") { clearInterval(poll); }
+                })
+                .catch(function () {});
+            } catch (e) {}
+          }, 400);
+          try {
+            fetch("/dsh-font-enhancer/install-font", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ fontId: fid }) })
+              .then(function (r) { return r.json(); })
+              .then(function (res) {
+                done = true; clearInterval(poll);
+                if (res && res.ok) {
+                  if (fzh && !state.customFonts.some(function (x) { return x.zh === fzh; })) state.customFonts.push({ zh: fzh });
+                  if (fen && !state.customFonts.some(function (x) { return x.en === fen; })) state.customFonts.push({ en: fen });
+                  persist(); renderCards(); renderThemeSel();
+                  var dest = res.dest ? "，路径：" + res.dest : "";
+                  btn.textContent = "✅ 已安装"; btn.disabled = true;
+                  showToast("✅ 字体已" + (res.already ? "存在" : "安装") + "：" + (fzh || fen) + "，已自动添加" + dest, "ok");
+                } else {
+                  btn.textContent = "⬇ 重试安装"; btn.disabled = false;
+                  showToast("安装失败：" + (res && res.error || "未知错误"), "err");
+                }
+              })
+              .catch(function () { done = true; clearInterval(poll); btn.textContent = "⬇ 重试安装"; btn.disabled = false; showToast("安装失败，请检查网络", "err"); });
+          } catch (e) { done = true; clearInterval(poll); btn.textContent = "⬇ 重试安装"; btn.disabled = false; showToast("安装失败：" + e, "err"); }
+          return;
+        }
+        if (act === "addCustomFont") {
+          var en = el.getAttribute("data-font-en") || "";
+          var zh = el.getAttribute("data-font-zh") || "";
+          if (!en && !zh) { showToast("字体信息缺失", "err"); return; }
+          if (en) { if (!state.customFonts.some(function (f) { return f.en === en; })) state.customFonts.push({ en: en }); }
+          if (zh) { if (!state.customFonts.some(function (f) { return f.zh === zh; })) state.customFonts.push({ zh: zh }); }
+          persist(); renderCards(); renderThemeSel(); showToast("已添加字体" + (en || zh), "ok");
+          return;
+        }
+        if (act === "installCustomFile") {
+          var fileInput = root.querySelector("#dsh-fe-font-file");
+          var file = fileInput && fileInput.files && fileInput.files[0];
+          if (!file) { showToast("请先选择字体文件（.ttf/.otf）", "err"); return; }
+          var okExt = /\.(ttf|otf)$/i.test(file.name);
+          if (!okExt) { showToast("请选择 .ttf 或 .otf 字体文件", "err"); return; }
+          var btn2 = el; btn2.textContent = "⏳ 上传中..."; btn2.disabled = true;
+          var reader = new FileReader();
+          reader.onload = function (e) {
+            var base64 = String(e.target.result).split(",")[1] || "";
+            try {
+              fetch("/dsh-font-enhancer/upload-font", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ fileName: file.name, data: base64 }) })
+                .then(function (r) { return r.json(); })
+                .then(function (res) {
+                  btn2.textContent = "安装并添加"; btn2.disabled = false;
+                  if (res && res.ok) {
+                    // 自动添加字体（用文件名去掉扩展名作为字体名）
+                    var fam = (res.fontName || file.name.replace(/\.(ttf|otf)$/i, "")).trim();
+                    if (fam && !state.customFonts.some(function (x) { return x.en === fam; }) && !state.customFonts.some(function (x) { return x.zh === fam; })) {
+                      state.customFonts.push({ en: fam, zh: fam });
+                    }
+                    persist(); renderCards(); renderThemeSel();
+                    var dest = res.dest ? "，路径：" + res.dest : "";
+                    showToast("✅ 字体已安装并添加：" + fam + dest, "ok");
+                    if (fileInput) fileInput.value = "";
+                  } else {
+                    showToast("安装失败：" + (res && res.error || "未知错误"), "err");
+                  }
+                })
+                .catch(function () { btn2.textContent = "安装并添加"; btn2.disabled = false; showToast("上传失败，请重试", "err"); });
+            } catch (e2) { btn2.textContent = "安装并添加"; btn2.disabled = false; showToast("安装失败：" + e2, "err"); }
+          };
+          reader.onerror = function () { btn2.textContent = "安装并添加"; btn2.disabled = false; showToast("读取文件失败", "err"); };
+          reader.readAsDataURL(file);
+          return;
+        }
 
         var r = rid ? findRegion(rid) : null;
         if (!r) return;

package/lib/index.js

@@ -3,13 +3,37 @@
 // host registers a loopback-only settings/health API so the bundle has a real cordis
 // activate (inject=['webServer']); visual work lives in lib/client.js, mounted by the
 // client-modules system once the host activates. Works on both web and desktop profiles.
-import { existsSync, readFileSync, writeFileSync, mkdirSync, appendFileSync } from "node:fs";
-import { join, dirname } from "node:path";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, appendFileSync, copyFileSync } from "node:fs";
+import { join, dirname, basename } from "node:path";
 import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+import { get as httpsGet } from "node:https";
 
 var SETTINGS_PREFIX = "/dsh-font-enhancer";
 var SETTINGS_STORE = join(homedir(), ".dsh", "data", "dsh-font-enhancer", "settings.json");
 var OPERATION_LOG = join(homedir(), ".dsh", "data", "dsh-font-enhancer", "operation.log");
+// Fonts directory: sibling of this file (lib/fonts), resolved via import.meta.url
+// so it works no matter where the package is installed.
+var FONTS_DIR = join(dirname(fileURLToPath(import.meta.url)), "fonts");
+// User-scoped Windows fonts dir (no admin needed): %LOCALAPPDATA%\Microsoft\Windows\Fonts
+var USER_FONTS_DIR = join(homedir(), "AppData", "Local", "Microsoft", "Windows", "Fonts");
+
+// Curated font catalog: name -> direct .ttf download URL (OFL/free-commercial).
+// Chinese fonts are too large to bundle, so we fetch on demand into the user
+// fonts dir and register with Windows. Using the same file each install keeps
+// idempotence (copy is skipped if the target already exists).
+var FONT_CATALOG = {
+  "LXGW WenKai": { url: "https://github.com/lxgw/LxgwWenKai/releases/download/v1.330/LXGWWenKai-Regular.ttf", file: "LXGWWenKai-Regular.ttf", zh: "霞鹜文楷" },
+  "Smiley Sans": { url: "https://github.com/atelier-anchor/smiley-sans/releases/download/v2.0.1/SmileySans-Oblique.ttf", file: "SmileySans-Oblique.ttf", zh: "得意黑" },
+  "ZCOOL KuaiLe": { url: "https://github.com/google/fonts/raw/main/ofl/zcoolkuaile/ZCOOLKuaiLe-Regular.ttf", file: "ZCOOLKuaiLe-Regular.ttf", zh: "站酷快乐体" },
+  "Comic Neue": { url: "", file: "ComicNeue.ttf", en: "Comic Neue", bundled: true },
+  "Baloo 2": { url: "https://github.com/google/fonts/raw/main/ofl/baloo2/Baloo2-Regular.ttf", file: "Baloo2-Regular.ttf", en: "Baloo 2" },
+  "Fredoka": { url: "https://github.com/google/fonts/raw/main/ofl/fredoka/Fredoka-Regular.ttf", file: "Fredoka-Regular.ttf", en: "Fredoka" },
+  "Nunito": { url: "https://github.com/google/fonts/raw/main/ofl/nunito/Nunito-Regular.ttf", file: "Nunito-Regular.ttf", en: "Nunito" },
+  "Caveat": { url: "https://github.com/google/fonts/raw/main/ofl/caveat/Caveat-Regular.ttf", file: "Caveat-Regular.ttf", en: "Caveat" }
+};
+// In-memory download progress tracker: fontId -> { received, total, pct, state }
+var DOWNLOAD_PROGRESS = {};
 
 export var name = "dsh-font-enhancer";
 export var inject = ["webServer"];
@@ -37,6 +61,58 @@ function writeSettings(data) {
   } catch (e) { return false; }
 }
 
+// Download a URL to a local file (follows redirects via https.get default),
+// tracking progress into DOWNLOAD_PROGRESS[fontId] for the client to poll.
+function downloadTo(url, dest, fontId) {
+  return new Promise(function (resolve, reject) {
+    try {
+      httpsGet(url, function (res) {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          res.resume();
+          resolve(downloadTo(res.headers.location, dest, fontId));
+          return;
+        }
+        if (res.statusCode !== 200) { res.resume(); if (fontId) DOWNLOAD_PROGRESS[fontId] = { state: "error", error: "HTTP " + res.statusCode }; reject(new Error("HTTP " + res.statusCode)); return; }
+        var total = parseInt(res.headers["content-length"] || "0", 10) || 0;
+        var received = 0;
+        var chunks = [];
+        res.on("data", function (c) {
+          chunks.push(c);
+          received += c.length;
+          if (fontId) DOWNLOAD_PROGRESS[fontId] = total > 0
+            ? { state: "downloading", received: received, total: total, pct: Math.floor(received / total * 100) }
+            : { state: "downloading", received: received, total: 0, pct: -1 };
+        });
+        res.on("end", function () {
+          try { writeFileSync(dest, Buffer.concat(chunks)); if (fontId) DOWNLOAD_PROGRESS[fontId] = { state: "done", pct: 100, received: received, total: total, dest: dest }; resolve(dest); }
+          catch (e) { if (fontId) DOWNLOAD_PROGRESS[fontId] = { state: "error", error: String(e) }; reject(e); }
+        });
+        res.on("error", function (e) { if (fontId) DOWNLOAD_PROGRESS[fontId] = { state: "error", error: String(e) }; reject(e); });
+      }).on("error", function (e) { if (fontId) DOWNLOAD_PROGRESS[fontId] = { state: "error", error: String(e) }; reject(e); });
+    } catch (e) { if (fontId) DOWNLOAD_PROGRESS[fontId] = { state: "error", error: String(e) }; reject(e); }
+  });
+}
+
+// Install a font to the per-user Windows fonts dir. No admin needed for
+// %LOCALAPPDATA%\Microsoft\Windows\Fonts. Returns true if newly copied,
+// false if it already exists (idempotent).
+function installFont(file, url, fontId) {
+  return new Promise(function (resolve) {
+    try {
+      mkdirSync(USER_FONTS_DIR, { recursive: true });
+      var dest = join(USER_FONTS_DIR, file);
+      if (existsSync(dest)) { if (fontId) DOWNLOAD_PROGRESS[fontId] = { state: "done", already: true, pct: 100, dest: dest }; resolve({ ok: true, already: true, dest: dest }); return; }
+      if (fontId) DOWNLOAD_PROGRESS[fontId] = { state: "started", received: 0, total: 0, pct: 0 };
+      downloadTo(url, dest, fontId).then(function () {
+        resolve({ ok: true, already: false, dest: dest });
+      }).catch(function (e) {
+        try { if (existsSync(dest)) { try { require("node:fs").unlinkSync(dest); } catch (eu) {} } } catch (eu2) {}
+        resolve({ ok: false, error: String(e && e.message || e) });
+      });
+    } catch (e) { if (fontId) DOWNLOAD_PROGRESS[fontId] = { state: "error", error: String(e) }; resolve({ ok: false, error: String(e && e.message || e) }); }
+  });
+}
+
 export function apply(ctx) {
   ctx.logger.info("dsh-font-enhancer: host half mounted (settings api + client)");
   ctx.effect(function () {
@@ -92,6 +168,103 @@ export function apply(ctx) {
         res.end(JSON.stringify({ ok: true }));
       });
     }});
-    return function () { h1(); h2(); h3(); h4(); h5(); };
+    // Font file serving: serve .woff2/.ttf/.otf from the plugin's fonts dir.
+    // The prefix route matches any path below /dsh-font-enhancer/fonts/.
+    var h6 = ctx.webServer.register({ kind: "prefix", path: SETTINGS_PREFIX + "/fonts", handler: function (req, res) {
+      if (!isLoopback(req)) { res.writeHead(403); res.end(); return; }
+      var rel = decodeURIComponent(req.url.slice(SETTINGS_PREFIX.length + "/fonts".length));
+      if (!rel || rel.includes("..") || rel.includes("\0")) { res.writeHead(400); res.end(); return; }
+      var target = join(FONTS_DIR, rel.replace(/^\/+/, ""));
+      if (!existsSync(target)) { res.writeHead(404); res.end(); return; }
+      var ext = target.slice(target.lastIndexOf(".")).toLowerCase();
+      var mime = ext === ".woff2" ? "font/woff2" : ext === ".ttf" ? "font/ttf" : ext === ".otf" ? "font/otf" : ext === ".woff" ? "font/woff" : "application/octet-stream";
+      res.writeHead(200, { "content-type": mime, "cache-control": "public, max-age=86400" });
+      res.end(readFileSync(target));
+    }});
+    // Font install route: POST /dsh-font-enhancer/install-font { fontId }
+    // Downloads the font file from the catalog and installs to user fonts dir.
+    var h7 = ctx.webServer.register({ kind: "exact", path: SETTINGS_PREFIX + "/install-font", handler: function (req, res) {
+      if (!isLoopback(req)) { res.writeHead(403); res.end(); return; }
+      var chunks = [];
+      req.on("data", function (c) { chunks.push(c); });
+      req.on("end", async function () {
+        var body;
+        try { body = JSON.parse(Buffer.concat(chunks).toString("utf8")); } catch (e) { body = {}; }
+        var fontId = body.fontId || "";
+        var info = FONT_CATALOG[fontId];
+        if (!info) { res.writeHead(404, { "content-type": "application/json" }); res.end(JSON.stringify({ ok: false, error: "unknown font: " + fontId })); return; }
+        if (info.bundled) {
+          // bundled font: copy from plugin's fonts dir to user fonts dir
+          try {
+            mkdirSync(USER_FONTS_DIR, { recursive: true });
+            var src = join(FONTS_DIR, info.file);
+            var dest = join(USER_FONTS_DIR, info.file);
+            if (!existsSync(dest) && existsSync(src)) { copyFileSync(src, dest); }
+            res.writeHead(200, { "content-type": "application/json" });
+            res.end(JSON.stringify({ ok: true, already: existsSync(dest) && existsSync(src) ? false : true, dest: dest, fontId: fontId }));
+            return;
+          } catch (e) { res.writeHead(500, { "content-type": "application/json" }); res.end(JSON.stringify({ ok: false, error: String(e) })); return; }
+        }
+        if (!info.url) { res.writeHead(400, { "content-type": "application/json" }); res.end(JSON.stringify({ ok: false, error: "no download url for " + fontId })); return; }
+        try {
+          var result = await installFont(info.file, info.url, fontId);
+          res.writeHead(result.ok ? 200 : 500, { "content-type": "application/json" });
+          res.end(JSON.stringify(result));
+        } catch (e) {
+          res.writeHead(500, { "content-type": "application/json" });
+          res.end(JSON.stringify({ ok: false, error: String(e) }));
+        }
+      });
+    }});
+    // Font progress route: GET /dsh-font-enhancer/font-progress?fontId=xxx
+    var h9 = ctx.webServer.register({ kind: "exact", path: SETTINGS_PREFIX + "/font-progress", handler: function (req, res) {
+      if (!isLoopback(req)) { res.writeHead(403); res.end(); return; }
+      var q = req.url.indexOf("?") >= 0 ? req.url.slice(req.url.indexOf("?") + 1) : "";
+      var m = /fontId=([^&]+)/.exec(q);
+      var fontId = m ? decodeURIComponent(m[1]) : "";
+      res.writeHead(200, { "content-type": "application/json; charset=utf-8", "cache-control": "no-store" });
+      if (fontId && DOWNLOAD_PROGRESS[fontId]) { res.end(JSON.stringify(DOWNLOAD_PROGRESS[fontId])); }
+      else { res.end(JSON.stringify({ state: "none" })); }
+    }});
+    if (h7) { /* keep reference */ }
+    // Upload-font route: POST /dsh-font-enhancer/upload-font { fileName, data(base64) }
+    // Receives a user-provided .ttf/.otf, writes it to the per-user fonts dir.
+    var h8 = ctx.webServer.register({ kind: "exact", path: SETTINGS_PREFIX + "/upload-font", handler: function (req, res) {
+      if (!isLoopback(req)) { res.writeHead(403); res.end(); return; }
+      var chunks = [];
+      req.on("data", function (c) { chunks.push(c); });
+      req.on("end", function () {
+        var body;
+        try { body = JSON.parse(Buffer.concat(chunks).toString("utf8")); } catch (e) { body = {}; }
+        var fileName = body.fileName || "";
+        var data = body.data || "";
+        if (!/\.(ttf|otf)$/i.test(fileName) || !data) {
+          res.writeHead(400, { "content-type": "application/json" });
+          res.end(JSON.stringify({ ok: false, error: "need .ttf/.otf file data" }));
+          return;
+        }
+        try {
+          var buf = Buffer.from(data, "base64");
+          if (!buf || buf.length < 4) { res.writeHead(400, { "content-type": "application/json" }); res.end(JSON.stringify({ ok: false, error: "invalid file data" })); return; }
+          // basic signature check: TTF starts with 00 01 00 00, OTF with OTTO
+          var sig = buf.toString("ascii", 0, 4);
+          var ext = fileName.slice(fileName.lastIndexOf(".")).toLowerCase();
+          var okSig = (ext === ".ttf" && buf[0] === 0x00 && buf[1] === 0x01 && buf[2] === 0x00 && buf[3] === 0x00) || (ext === ".otf" && sig === "OTTO");
+          if (!okSig) { res.writeHead(400, { "content-type": "application/json" }); res.end(JSON.stringify({ ok: false, error: "file is not a valid TTF/OTF font" })); return; }
+          mkdirSync(USER_FONTS_DIR, { recursive: true });
+          // sanitize filename to avoid path traversal
+          var safeName = basename(fileName).replace(/[^A-Za-z0-9._-]/g, "_");
+          var dest = join(USER_FONTS_DIR, safeName);
+          writeFileSync(dest, buf);
+          var fontName = safeName.replace(/\.(ttf|otf)$/i, "");
+          res.writeHead(200, { "content-type": "application/json" });
+          res.end(JSON.stringify({ ok: true, dest: dest, fontName: fontName, file: safeName }));
+        } catch (e) {
+          res.writeHead(500, { "content-type": "application/json" });
+          res.end(JSON.stringify({ ok: false, error: String(e) }));
+        }
+      });
+    }});
+    return function () { h1(); h2(); h3(); h4(); h5(); h6(); try { h7(); } catch (e) {} try { h8(); } catch (e) {} try { h9(); } catch (e) {} };
   }, "dsh-font-enhancer: settings routes");
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-font-enhancer",
-  "version": "1.2.0",
-  "description": "DIY 你的 DSH 界面：按区域自定义字体/字号/颜色，支持全局统一设置、主题保存切换、框选区域、随机配色与字体。DIY your DSH UI fonts & colors: per-region font/size/color styling, pick-region element selection, unified overrides, theme save & switch, random font/color.",
+  "version": "1.3.0",
+  "description": "DSH 字体样式 DIY 插件（搜「字体」找到我）：按区域自定义中英文字体/字号/字重/斜体/颜色，框选元素创建自定义区域，全局统一控制，主题保存/切换，随机配色，支持自定义字体。DIY your DSH UI fonts & colors: per-region custom font/size/weight/italic/color, pick elements to create custom regions, unified overrides, theme save/switch, random color, custom fonts.",
   "type": "module",
   "main": "lib/index.js",
   "sideEffects": false,
@@ -15,6 +15,7 @@
   },
   "files": [
     "lib/**/*.js",
+    "lib/fonts/*.ttf",
     "cordis.patch.yml",
     "README.md",
     "LICENSE"
@@ -24,14 +25,31 @@
     "dsh-plugin",
     "deepseek-harness",
     "font",
+    "字体",
     "typography",
+    "排版",
+    "DIY",
     "theme",
+    "主题",
+    "color",
+    "颜色",
     "ui",
+    "区域",
+    "styling",
+    "样式",
     "chinese-font",
+    "中文字体",
     "english-font",
-    "color-theme",
     "font-picker",
-    "text-styling"
+    "font-size",
+    "字重",
+    "斜体",
+    "theme-switch",
+    "主题切换",
+    "text-styling",
+    "文字样式",
+    "custom-font",
+    "自定义字体"
   ],
   "repository": {
     "type": "git",