skill-forge-hub 0.3.0 → 0.5.0

package/annual-report/resources/reference.html

@@ -5,7 +5,55 @@
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>2026 研发年度总结</title>
 <style>
-:root{--cyan:#0ea5e9;--bg:#0a1929;--card:#0b1e37;--border:rgba(14,165,233,.15);--text:#bae6fd;--muted:#5b7fa5;--green:#14b8a6;--orange:#f97316;--purple:#6366f1;--rose:#f43f5e}
+
+/* ═══ 四主题令牌：12 核心契约（与 magic-deck 一致）+ 报告扩展（发光/氛围/热力/语义色）；html[data-theme] 运行时切换，THEME 生成时定默认 ═══ */
+:root, [data-theme="tech"]{
+  --bg:#0a1929; --bg2:#071525; --panel:rgba(11,30,55,.9); --panel-solid:#0b1e37;
+  --text:#bae6fd; --muted:#5b7fa5; --accent:#0ea5e9; --accent2:#14b8a6;
+  --border:rgba(14,165,233,.18); --glow:rgba(14,165,233,.35); --glow-soft:rgba(14,165,233,.15);
+  --title-grad:linear-gradient(90deg,#7dd3fc,#0ea5e9 45%,#818cf8);
+  --tag-bg:rgba(14,165,233,.12);
+  --card-shadow:0 1px 0 rgba(255,255,255,.05) inset,0 12px 32px rgba(1,6,16,.5),0 0 24px rgba(14,165,233,.15);
+  --scan:rgba(0,240,255,.2); --scan-dim:rgba(0,240,255,.05);
+  --heat:rgba(14,165,233,.55);
+  --green:#14b8a6; --orange:#f97316; --rose:#f43f5e;
+}
+[data-theme="biz"]{
+  --bg:#e8ecf5; --bg2:#dde3ef; --panel:rgba(255,255,255,.97); --panel-solid:#ffffff;
+  --text:#1e293b; --muted:#64748b; --accent:#2563eb; --accent2:#0891b2;
+  --border:rgba(37,99,235,.14); --glow:rgba(37,99,235,.18); --glow-soft:rgba(37,99,235,.12);
+  --title-grad:linear-gradient(90deg,#1e40af,#2563eb 55%,#0891b2);
+  --tag-bg:rgba(37,99,235,.08);
+  --card-shadow:0 1px 2px rgba(15,23,42,.05),0 10px 28px rgba(15,23,42,.12);
+  --scan:rgba(37,99,235,.14); --scan-dim:rgba(37,99,235,.04);
+  --heat:rgba(37,99,235,.55);
+  --green:#0d9488; --orange:#ea580c; --rose:#e11d48;
+}
+[data-theme="mono"]{
+  --bg:#f2f2f4; --bg2:#e4e4e8; --panel:rgba(255,255,255,.98); --panel-solid:#ffffff;
+  --text:#16181d; --muted:#6b7280; --accent:#111111; --accent2:#4b5563;
+  --border:rgba(17,17,17,.14); --glow:rgba(17,17,17,.08); --glow-soft:rgba(17,17,17,.1);
+  --title-grad:linear-gradient(90deg,#111,#333 60%,#666);
+  --tag-bg:rgba(17,17,17,.06);
+  --card-shadow:0 1px 2px rgba(0,0,0,.06),0 10px 28px rgba(0,0,0,.1);
+  --scan:rgba(17,17,17,.1); --scan-dim:rgba(17,17,17,.04);
+  --heat:rgba(17,17,17,.55);
+  --green:#0f766e; --orange:#c2410c; --rose:#be123c;
+}
+[data-theme="warm"]{
+  --bg:#f7ebd9; --bg2:#efe0c8; --panel:rgba(255,250,243,.97); --panel-solid:#fffaf3;
+  --text:#43301f; --muted:#8a7565; --accent:#d97706; --accent2:#ea580c;
+  --border:rgba(217,119,6,.18); --glow:rgba(217,119,6,.22); --glow-soft:rgba(217,119,6,.14);
+  --title-grad:linear-gradient(90deg,#b45309,#d97706 50%,#ea580c);
+  --tag-bg:rgba(217,119,6,.1);
+  --card-shadow:0 1px 2px rgba(120,72,24,.07),0 10px 28px rgba(120,72,24,.13);
+  --scan:rgba(217,119,6,.16); --scan-dim:rgba(217,119,6,.04);
+  --heat:rgba(217,119,6,.55);
+  --green:#0d9488; --orange:#c2410c; --rose:#be123c;
+}
+/* 浅色主题下星点氛围自然退隐 */
+[data-theme="biz"] .stars, [data-theme="mono"] .stars, [data-theme="warm"] .stars{ opacity:.28; }
+
 *{margin:0;padding:0;box-sizing:border-box}
 html,body{background:var(--bg)}
 body{
@@ -14,51 +62,51 @@ body{
 }
 /* 三层科技底纹 */
 .grid-pattern{position:fixed;inset:0;z-index:0;pointer-events:none;
-  background:linear-gradient(rgba(0,240,255,.03) 1px,transparent 1px),linear-gradient(90deg,rgba(0,240,255,.03) 1px,transparent 1px);
+  background:linear-gradient(var(--scan-dim) 1px,transparent 1px),linear-gradient(90deg,var(--scan-dim) 1px,transparent 1px);
   background-size:60px 60px}
 .stars{position:fixed;inset:0;z-index:0;pointer-events:none;
   background:radial-gradient(1px 1px at 12% 22%,rgba(255,255,255,.4),transparent),radial-gradient(1px 1px at 28% 68%,rgba(0,240,255,.5),transparent),radial-gradient(1.5px 1.5px at 45% 15%,rgba(168,85,247,.4),transparent),radial-gradient(1px 1px at 62% 78%,rgba(0,255,136,.4),transparent),radial-gradient(1px 1px at 78% 32%,rgba(255,255,255,.35),transparent),radial-gradient(1.5px 1.5px at 88% 58%,rgba(0,240,255,.45),transparent),radial-gradient(1px 1px at 8% 85%,rgba(255,255,255,.3),transparent),radial-gradient(1px 1px at 55% 45%,rgba(0,240,255,.35),transparent)}
 .scanlines{position:fixed;inset:0;z-index:999;pointer-events:none;
-  background:repeating-linear-gradient(0deg,transparent,transparent 2px,rgba(0,240,255,.015) 2px,rgba(0,240,255,.015) 4px)}
+  background:repeating-linear-gradient(0deg,transparent,transparent 2px,var(--scan-dim) 2px,var(--scan-dim) 4px)}
 .scanband{position:fixed;left:0;right:0;height:150px;z-index:998;pointer-events:none;
-  background:linear-gradient(180deg,transparent,rgba(0,240,255,.03) 50%,transparent);
+  background:linear-gradient(180deg,transparent,var(--scan-dim) 50%,transparent);
   animation:scanMove 11s linear infinite}
 @keyframes scanMove{from{top:-22%}to{top:112%}}
-.wrap{position:relative;z-index:1;max-width:760px;margin:0 auto;padding:40px 20px}
+.wrap{width:clamp(640px, 60%, 1200px); margin:0 auto; position:relative; z-index:1; padding:40px 0}
 /* 头部卡片 */
-.header-card{position:relative;overflow:hidden;background:var(--card);border:1px solid var(--border);border-radius:6px;
+.header-card{position:relative;overflow:hidden;background:var(--panel-solid);border:1px solid var(--border);border-radius:6px;
   padding:34px 28px 26px;text-align:center;margin-bottom:18px;
-  box-shadow:0 8px 28px rgba(0,0,0,.35),inset 0 1px 0 rgba(14,165,233,.12);
-  background-image:repeating-linear-gradient(0deg,rgba(14,165,233,.02),rgba(14,165,233,.02) 8px,transparent 8px,transparent 16px)}
+  box-shadow:var(--card-shadow);
+  background-image:repeating-linear-gradient(180deg, rgba(255,255,255,.012) 0 1px, transparent 1px 8px)}
 .header-card h1{font-size:26px;letter-spacing:2px;margin-bottom:8px;
-  background:linear-gradient(90deg,#7dd3fc,#0ea5e9,#5eead4);-webkit-background-clip:text;background-clip:text;color:transparent;
+  background:var(--title-grad);-webkit-background-clip:text;background-clip:text;color:transparent;
   animation:titleGlow 3s ease-in-out infinite}
-@keyframes titleGlow{0%,100%{text-shadow:0 0 8px rgba(14,165,233,.5),0 0 22px rgba(14,165,233,.25)}50%{text-shadow:0 0 14px rgba(14,165,233,.85),0 0 34px rgba(14,165,233,.45)}}
+@keyframes titleGlow{0%,100%{text-shadow:0 0 8px var(--glow),0 0 22px var(--glow-soft)}50%{text-shadow:0 0 14px var(--glow),0 0 34px var(--glow-soft)}}
 .header-sub{font-size:12px;color:var(--muted);letter-spacing:1px;margin-bottom:12px}
-.header-badge{display:inline-block;font-size:11px;color:#7dd3fc;border:1px solid rgba(14,165,233,.3);border-radius:999px;padding:4px 14px}
+.header-badge{display:inline-block;font-size:11px;color:var(--accent);border:1px solid var(--glow);border-radius:999px;padding:4px 14px}
 .card-glow{position:absolute;inset:-40% -20% auto;height:70%;pointer-events:none;
-  background:radial-gradient(ellipse at 50% 10%,rgba(14,165,233,.25),transparent 70%);
+  background:radial-gradient(ellipse at 50% 10%,var(--glow),transparent 70%);
   animation:cardGlow 3s ease-in-out infinite;transform-origin:top center;opacity:.5}
 @keyframes cardGlow{0%,100%{opacity:.5;transform:scale(1)}50%{opacity:1;transform:scale(1.6)}}
 /* 四边浮光线 */
 .scanline-el{position:absolute;pointer-events:none}
-.scan-x{top:0;left:0;height:1px;width:100%;background:linear-gradient(90deg,transparent,var(--cyan),transparent);animation:scanX 3s linear infinite}
-.scan-y{top:0;right:0;width:1px;height:100%;background:linear-gradient(180deg,transparent,var(--cyan),transparent);animation:scanY 3s linear infinite}
-.scan-x-rev{bottom:0;left:0;height:1px;width:100%;background:linear-gradient(90deg,transparent,var(--cyan),transparent);animation:scanXRev 3s linear infinite}
-.scan-y-rev{top:0;left:0;width:1px;height:100%;background:linear-gradient(180deg,transparent,var(--cyan),transparent);animation:scanYRev 3s linear infinite}
+.scan-x{top:0;left:0;height:1px;width:100%;background:linear-gradient(90deg,transparent,var(--accent),transparent);animation:scanX 3s linear infinite}
+.scan-y{top:0;right:0;width:1px;height:100%;background:linear-gradient(180deg,transparent,var(--accent),transparent);animation:scanY 3s linear infinite}
+.scan-x-rev{bottom:0;left:0;height:1px;width:100%;background:linear-gradient(90deg,transparent,var(--accent),transparent);animation:scanXRev 3s linear infinite}
+.scan-y-rev{top:0;left:0;width:1px;height:100%;background:linear-gradient(180deg,transparent,var(--accent),transparent);animation:scanYRev 3s linear infinite}
 @keyframes scanX{from{transform:translateX(-100%)}to{transform:translateX(100%)}}
 @keyframes scanY{from{transform:translateY(-100%)}to{transform:translateY(100%)}}
 @keyframes scanXRev{from{transform:translateX(100%)}to{transform:translateX(-100%)}}
 @keyframes scanYRev{from{transform:translateY(100%)}to{transform:translateY(-100%)}}
 /* 分节卡片 */
-.section{position:relative;overflow:hidden;background:var(--card);border:1px solid var(--border);border-radius:6px;
+.section{position:relative;overflow:hidden;background:var(--panel-solid);border:1px solid var(--border);border-radius:6px;
   padding:22px 24px 22px 32px;margin-bottom:18px;
-  box-shadow:0 8px 28px rgba(0,0,0,.35),inset 0 1px 0 rgba(14,165,233,.12);
-  background-image:repeating-linear-gradient(0deg,rgba(14,165,233,.02),rgba(14,165,233,.02) 8px,transparent 8px,transparent 16px);
+  box-shadow:var(--card-shadow);
+  background-image:repeating-linear-gradient(180deg, rgba(255,255,255,.012) 0 1px, transparent 1px 8px);
   transition:transform .18s ease,box-shadow .18s ease}
-.section:hover{transform:translateY(-2px);box-shadow:0 14px 34px rgba(0,0,0,.45),inset 0 0 22px rgba(14,165,233,.08)}
+.section:hover{transform:translateY(-2px);box-shadow:var(--card-shadow),inset 0 0 22px var(--glow-soft)}
 .sec-bar{position:absolute;left:0;top:0;bottom:0;width:8px}
-.sec-ov .sec-bar{background:linear-gradient(180deg,#38bdf8,#0ea5e9);box-shadow:0 0 12px rgba(14,165,233,.3)}
+.sec-ov .sec-bar{background:linear-gradient(180deg,var(--accent2),var(--accent));box-shadow:0 0 12px var(--glow)}
 .sec-ms .sec-bar{background:linear-gradient(180deg,#5eead4,#14b8a6);box-shadow:0 0 12px rgba(20,184,166,.3)}
 .sec-gw .sec-bar{background:linear-gradient(180deg,#a5b4fc,#6366f1);box-shadow:0 0 12px rgba(99,102,241,.3)}
 .sec-rf .sec-bar{background:linear-gradient(180deg,#fda4af,#e11d48);box-shadow:0 0 12px rgba(244,63,94,.3)}
@@ -66,24 +114,24 @@ body{
 .sec-head{display:flex;align-items:center;gap:10px;margin-bottom:16px}
 .sec-head svg{flex:0 0 auto}
 .sec-head h2{font-size:18px;letter-spacing:1px;animation:secGlow 3s ease-in-out infinite}
-.sec-ov .sec-head h2{color:#7dd3fc}.sec-ms .sec-head h2{color:#5eead4}.sec-gw .sec-head h2{color:#c7d2fe}
+.sec-ov .sec-head h2{color:var(--accent)}.sec-ms .sec-head h2{color:#5eead4}.sec-gw .sec-head h2{color:#c7d2fe}
 .sec-rf .sec-head h2{color:#fda4af}.sec-pl .sec-head h2{color:#fdba74}
-@keyframes secGlow{0%,100%{text-shadow:0 0 6px rgba(14,165,233,.4)}50%{text-shadow:0 0 14px rgba(14,165,233,.8)}}
+@keyframes secGlow{0%,100%{text-shadow:0 0 6px var(--glow)}50%{text-shadow:0 0 14px var(--glow)}}
 /* 概览：TL;DR + 数据卡 */
 .tldr-line{font-size:15px;line-height:1.75;margin-bottom:18px}
-.tldr-line b{color:#7dd3fc;font-weight:700}
+.tldr-line b{color:var(--accent);font-weight:700}
 .stat-row{display:flex;gap:12px;flex-wrap:wrap}
-.stat-card{flex:1 1 160px;position:relative;background:rgba(14,165,233,.05);border:1px solid var(--border);
+.stat-card{flex:1 1 160px;position:relative;background:var(--tag-bg);border:1px solid var(--border);
   border-radius:6px;padding:16px 14px;min-width:140px;overflow:hidden;
   transition:transform .18s ease,box-shadow .18s ease}
 .stat-card:hover{transform:translateY(-2px);box-shadow:0 8px 20px rgba(0,0,0,.35)}
-.stat-card::before{content:'';position:absolute;left:0;top:0;bottom:0;width:4px;background:linear-gradient(180deg,#38bdf8,#0ea5e9)}
+.stat-card::before{content:'';position:absolute;left:0;top:0;bottom:0;width:4px;background:linear-gradient(180deg,var(--accent2),var(--accent))}
 .stat-num{font-size:28px;font-weight:900;letter-spacing:1px;
-  background:linear-gradient(90deg,#7dd3fc,#0ea5e9,#5eead4);-webkit-background-clip:text;background-clip:text;color:transparent}
+  background:var(--title-grad);-webkit-background-clip:text;background-clip:text;color:transparent}
 .stat-label{font-size:12px;color:var(--muted);margin-top:6px}
 /* 里程碑时间线 */
 .timeline{position:relative;padding-left:26px}
-.timeline::before{content:'';position:absolute;left:7px;top:6px;bottom:6px;width:2px;background:linear-gradient(180deg,rgba(14,165,233,.5),rgba(20,184,166,.5))}
+.timeline::before{content:'';position:absolute;left:7px;top:6px;bottom:6px;width:2px;background:linear-gradient(180deg,var(--glow),var(--glow-soft))}
 .tl-group{position:relative;margin-bottom:18px}
 .tl-node{position:absolute;left:-26px;top:0;width:16px;height:16px;border-radius:50%;
   display:flex;align-items:center;justify-content:center;font-size:8px;font-weight:900;color:#fff}
@@ -91,15 +139,15 @@ body{
 .tl-node.q3{background:radial-gradient(circle at 30% 28%,#7dd9cf,#14b8a6 55%,#0d9488);box-shadow:0 0 10px rgba(20,184,166,.5)}
 .tl-node.q4{background:radial-gradient(circle at 30% 28%,#7dd3fc,#0ea5e9 55%,#0369a1);box-shadow:0 0 10px rgba(14,165,233,.5);animation:nodePulse 2.4s ease-in-out infinite}
 @keyframes nodePulse{0%,100%{box-shadow:0 0 8px rgba(14,165,233,.4)}50%{box-shadow:0 0 18px rgba(14,165,233,.8)}}
-.tl-q{font-size:12px;font-weight:700;color:#7dd3fc;letter-spacing:1px;margin-bottom:8px}
-.tl-item{position:relative;padding:10px 0 10px 16px;border-top:1px dashed rgba(14,165,233,.18)}
+.tl-q{font-size:12px;font-weight:700;color:var(--accent);letter-spacing:1px;margin-bottom:8px}
+.tl-item{position:relative;padding:10px 0 10px 16px;border-top:1px dashed var(--border)}
 .tl-item::before{content:'';position:absolute;left:0;top:19px;width:5px;height:5px;border-radius:50%;background:rgba(94,234,212,.8);box-shadow:0 0 6px rgba(94,234,212,.5)}
 .tl-desc{font-size:15px;line-height:1.65}
 .tl-meta{font-size:12px;color:var(--muted);margin-top:4px}
-.tl-badge{display:inline-block;font-size:11px;color:var(--muted);border:1px solid rgba(14,165,233,.2);border-radius:999px;padding:1px 10px;margin-left:6px}
+.tl-badge{display:inline-block;font-size:11px;color:var(--muted);border:1px solid var(--border);border-radius:999px;padding:1px 10px;margin-left:6px}
 .tl-empty{font-size:13px;color:var(--muted);padding:6px 0 10px 16px}
 /* 柱图 */
-.cb-wrap{margin-top:18px;padding-top:14px;border-top:1px dashed rgba(14,165,233,.18)}
+.cb-wrap{margin-top:18px;padding-top:14px;border-top:1px dashed var(--border)}
 .cb-title{font-size:12px;color:var(--muted);margin-bottom:12px;letter-spacing:1px}
 .cb-chart{display:flex;align-items:flex-end;gap:8px;height:110px}
 .cb-col{flex:1;display:flex;flex-direction:column;align-items:center;justify-content:flex-end;height:100%;position:relative}
@@ -108,7 +156,7 @@ body{
 .cb-col:hover .cb-bar{box-shadow:0 0 16px rgba(45,212,191,.6)}
 .cb-label{font-size:9px;color:var(--muted);margin-top:4px}
 .cb-tip{position:absolute;bottom:calc(100% + 6px);left:50%;transform:translateX(-50%) translateY(4px);
-  background:#0b1e37;border:1px solid rgba(14,165,233,.3);color:#bae6fd;font-size:10px;white-space:nowrap;
+  background:var(--panel-solid);border:1px solid var(--glow);color:var(--text);font-size:10px;white-space:nowrap;
   padding:3px 8px;border-radius:4px;opacity:0;pointer-events:none;transition:opacity .18s,transform .18s;z-index:5}
 .cb-col:hover .cb-tip{opacity:1;transform:translateX(-50%) translateY(0)}
 /* 序号徽章 3D 球 */
@@ -127,10 +175,10 @@ body{
 .entry-head{display:flex;align-items:flex-start;gap:12px}
 .desc{font-size:15px;line-height:1.65}
 .meta{display:block;font-size:12px;color:var(--muted);margin-top:4px}
-.meta b{color:rgba(125,211,252,.9);font-weight:700}
+.meta b{color:var(--accent);font-weight:700}
 ol{list-style:none}
 li{display:flex;align-items:flex-start;gap:12px;padding:10px;border-radius:4px;transition:background .18s}
-li:hover{background:rgba(14,165,233,.06)}
+li:hover{background:var(--tag-bg)}
 li:hover .idx{transform:scale(1.18) rotate(-4deg);font-size:14px}
 li:hover .idx b{transform:rotate(-6deg)}
 /* 展望目标卡 */
@@ -140,15 +188,15 @@ li:hover .idx b{transform:rotate(-6deg)}
 .goal-desc{font-size:15px;line-height:1.65;margin-bottom:8px}
 .goal-desc b{color:#fdba74;font-weight:700}
 .goal-q{display:flex;flex-wrap:wrap;gap:6px}
-.q-chip{font-size:11px;color:var(--muted);border:1px solid rgba(14,165,233,.18);background:rgba(14,165,233,.05);
+.q-chip{font-size:11px;color:var(--muted);border:1px solid var(--border);background:var(--tag-bg);
   border-radius:999px;padding:2px 10px}
 /* 复制按钮 */
-.copy-wrap{display:flex;justify-content:center;margin:8px 0 18px}
+.copy-wrap{display:flex;justify-content:center;margin:18px 0 0}
 .copy-btn{display:flex;align-items:center;gap:8px;font-size:14px;font-weight:700;color:#fff;letter-spacing:2px;
-  background:linear-gradient(135deg,var(--cyan),#0284c7);border:none;border-radius:999px;padding:12px 38px;cursor:pointer;
-  box-shadow:0 0 30px rgba(14,165,233,.35);transition:transform .18s ease,box-shadow .18s ease;
+  background:linear-gradient(135deg,var(--accent),var(--accent2));border:none;border-radius:999px;padding:12px 38px;cursor:pointer;
+  box-shadow:0 0 30px var(--glow);transition:transform .18s ease,box-shadow .18s ease;
   font-family:inherit}
-.copy-btn:hover{transform:translateY(-2px);box-shadow:0 0 45px rgba(14,165,233,.5)}
+.copy-btn:hover{transform:translateY(-2px);box-shadow:0 0 45px var(--glow)}
 .copy-btn:active{transform:translateY(1px) scale(.98)}
 /* 页脚 */
 footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;padding:8px 0 4px}
@@ -165,6 +213,26 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
 @keyframes popIn{from{opacity:0;transform:scale(.85)}to{opacity:1;transform:none}}
 /* 卡片 3D 微倾斜（仅 hover 卡片） */
 .section:hover{transform:perspective(900px) translateY(-2px) rotateY(calc(var(--mx,0)*2.5deg)) rotateX(calc(var(--my,0)*-2.5deg))}
+
+/* 主题换肤坞：右下角四色点随点随换，记忆上次选择；打印与截图模式隐藏 */
+.theme-dock{
+  position:fixed; right:18px; bottom:18px; z-index:1001;
+  display:flex; gap:8px; padding:8px 10px; border-radius:999px;
+  background:var(--panel-solid); border:1px solid var(--border);
+  box-shadow:0 4px 18px rgba(0,0,0,.3);
+}
+.theme-dock .th-dot{
+  width:22px; height:22px; border-radius:50%; cursor:pointer;
+  border:2px solid transparent; padding:0;
+  transition:transform .15s ease, border-color .15s ease;
+}
+.theme-dock .th-dot:hover{ transform:scale(1.18); }
+.theme-dock .th-dot.on{ border-color:var(--text); }
+.theme-dock .th-dot[data-theme="tech"]{ background:#0ea5e9; }
+.theme-dock .th-dot[data-theme="biz"]{ background:#2563eb; }
+.theme-dock .th-dot[data-theme="mono"]{ background:#111; }
+.theme-dock .th-dot[data-theme="warm"]{ background:#d97706; }
+@media print{ .theme-dock{ display:none; } }
 </style>
 </head>
 <body>
@@ -182,6 +250,15 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
     <h1>2026 研发年度总结</h1>
     <div class="header-sub">全栈开发工程师 · 2026-01 ~ 2026-11（截至 11-09）</div>
     <span class="header-badge">生成时间 2026-11-09 17:03:01</span>
+    <div class="copy-wrap">
+      <button class="copy-btn" id="copyBtn" type="button">
+        <svg id="copyIcon" viewBox="0 0 16 16" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.4">
+          <rect x="5.5" y="5.5" width="8.5" height="8.5" rx="1.5"/>
+          <path d="M10.5 5.5V4a1.5 1.5 0 0 0-1.5-1.5H4A1.5 1.5 0 0 0 2.5 4v5A1.5 1.5 0 0 0 4 10.5h1.5"/>
+        </svg>
+        <span id="copyText">一键复制</span>
+      </button>
+    </div>
   </header>
 
   <section class="section sec-ov">
@@ -277,9 +354,9 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
       <h2>不足与反思</h2>
     </div>
     <ol>
-      <li><span class="idx rf"><b>1</b></span><div class="entry"><div class="desc">8 月节奏过载：单月 1154 次提交、8-08 单日 95 个版本。</div><div class="meta">影响：文档与代码同步滞后，质量债累积。</div><div class="meta" style="color:rgba(125,211,252,.85)"><b style="color:#7dd3fc">改进：</b>明年收敛为双周聚合发布、月度版本 ≤20 个。</div></div></li>
-      <li><span class="idx rf"><b>2</b></span><div class="entry"><div class="desc">生成物污染统计口径：code-graph 等生成物单文件数十万行噪音曾混入行数统计。</div><div class="meta">影响：工作量指标失真，误导投入判断。</div><div class="meta" style="color:rgba(125,211,252,.85)"><b style="color:#7dd3fc">改进：</b>统计前强制剔除生成物路径白名单。</div></div></li>
-      <li><span class="idx rf"><b>3</b></span><div class="entry"><div class="desc">发布颗粒度两端失衡：Q3 一日最多 95 个 tag，Q4 单次聚合最多 10 个版本。</div><div class="meta">影响：问题定位粒度在过细与过粗之间摇摆。</div><div class="meta" style="color:rgba(125,211,252,.85)"><b style="color:#7dd3fc">改进：</b>固定批次大小，每批 ≤10 版本聚合。</div></div></li>
+      <li><span class="idx rf"><b>1</b></span><div class="entry"><div class="desc">8 月节奏过载：单月 1154 次提交、8-08 单日 95 个版本。</div><div class="meta">影响：文档与代码同步滞后，质量债累积。</div><div class="meta" style="color:var(--accent)"><b style="color:var(--accent)">改进：</b>明年收敛为双周聚合发布、月度版本 ≤20 个。</div></div></li>
+      <li><span class="idx rf"><b>2</b></span><div class="entry"><div class="desc">生成物污染统计口径：code-graph 等生成物单文件数十万行噪音曾混入行数统计。</div><div class="meta">影响：工作量指标失真，误导投入判断。</div><div class="meta" style="color:var(--accent)"><b style="color:var(--accent)">改进：</b>统计前强制剔除生成物路径白名单。</div></div></li>
+      <li><span class="idx rf"><b>3</b></span><div class="entry"><div class="desc">发布颗粒度两端失衡：Q3 一日最多 95 个 tag，Q4 单次聚合最多 10 个版本。</div><div class="meta">影响：问题定位粒度在过细与过粗之间摇摆。</div><div class="meta" style="color:var(--accent)"><b style="color:var(--accent)">改进：</b>固定批次大小，每批 ≤10 版本聚合。</div></div></li>
     </ol>
   </section>
 
@@ -296,17 +373,17 @@ footer{text-align:center;font-size:10px;color:var(--muted);letter-spacing:1px;pa
     <div class="goal"><div class="goal-desc">4、<b>生态落地</b>：spec-once/流水线在 ≥3 个真实项目落地并沉淀案例</div><div class="goal-q"><span class="q-chip">Q2 试点</span><span class="q-chip">Q4 案例库发布</span></div></div>
   </section>
 
-  <div class="copy-wrap">
-    <button class="copy-btn" id="copyBtn" type="button">
-      <svg id="copyIcon" viewBox="0 0 16 16" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.4">
-        <rect x="5.5" y="5.5" width="8.5" height="8.5" rx="1.5"/>
-        <path d="M10.5 5.5V4a1.5 1.5 0 0 0-1.5-1.5H4A1.5 1.5 0 0 0 2.5 4v5A1.5 1.5 0 0 0 4 10.5h1.5"/>
-      </svg>
-      <span id="copyText">一键复制</span>
-    </button>
-  </div>
   <footer>GENERATED BY SPECCORE TEAM · 2026</footer>
 </div>
+
+<!-- 主题换肤坞（四色点） -->
+<div class="theme-dock" id="themeDock">
+  <button class="th-dot" type="button" data-theme="tech" title="深蓝科技"></button>
+  <button class="th-dot" type="button" data-theme="biz" title="浅色商务"></button>
+  <button class="th-dot" type="button" data-theme="mono" title="极简黑白"></button>
+  <button class="th-dot" type="button" data-theme="warm" title="温暖渐变"></button>
+</div>
+
 <script>
 // 复制源 = txt 纯文本全文
 var TXT = "2026 研发年度总结\n\n生成时间：2026-11-09 17:03:01\n\n年度概览\nTL;DR：立项即狂奔的一年：SpecCore 规范驱动开发平台 7 月从零立项，4 个月 1889 次提交、576 个版本发布、代码库净增 19 万行，完成从单机 CLI 到流水线平台的蜕变。\n1、总提交数：1889 次（07-05 ~ 11-05）\n2、版本发布：576 个（v5.13.0 → v8.3.399）\n3、净增代码：+19.0 万行（+32.9 万 / -13.9 万）\n4、月度峰值：1154 次提交（8 月）\n\n核心成果与里程碑\n1、7 月立项首发：SpecCore CLI 完整功能落地，v5.13.0 首版发布（335 次提交、+5.4 万行）- Q3\n2、8 月密集攻坚：知识资产四层覆盖架构（TOC 目录/自动注入/RAG 检索/阅读清单）成形，月内 1154 次提交、+16.4 万行、发布 200+ 版本 - Q3\n3、9 月流水线成形：run 端到端流水线与迭代体系建立，+7.6 万行、328 次提交 - Q3\n4、10 月发布节奏收敛：v8.3 系列起跑，月度发布收紧至约 30 个版本，+1.8 万行 - Q4\n5、11-03 v8.3.370 累积发布：GLOBAL 治乱、反推域隔离、文档生成器升格、澄清链修复 - Q4\n6、11-04 v8.3.388：E2E 全链路深度检查 11 项修复 + execute 意图语义硬化 - Q4\n7、11-04 v8.3.394：反推链接力协议补全、全局分析默认纯技术、QA 环接力协议（exit 10）- Q4\n8、11-05 v8.3.399（截至当前）：用例核对闸开卷设闸——execute 收尾逐用例勾稽，未实现即入修复环 - Q4\n\n经验与成长\n1、沉淀了「四层知识资产架构」（TOC 目录/自动注入/RAG 检索/阅读清单），解决了 AI 对规范库看不见、记不住、找不回的三类可见性断层。\n2、掌握了 ask 引擎意图识别与 AI 接力协议（[SPECCORE_EXEC]/[SPECCORE_PROMPT]/[SPECCORE_CONTINUE] 标记链），人机协作可从任意断点续跑。\n3、建立了「聚合发布」节奏：小步高频提交 + 里程碑聚合 tag，兼顾问题定位粒度与交付速度。\n4、积累了质量门禁体系经验：骨架完成度自检、用例核对闸、QA 三阶段验证环，质量兜底不再依赖人肉复查。\n\n不足与反思\n1、8 月节奏过载：单月 1154 次提交、8-08 单日 95 个版本。\n影响：文档与代码同步滞后，质量债累积。\n改进：明年收敛为双周聚合发布、月度版本 ≤20 个。\n2、生成物污染统计口径：code-graph 等生成物单文件数十万行噪音曾混入行数统计。\n影响：工作量指标失真，误导投入判断。\n改进：统计前强制剔除生成物路径白名单。\n3、发布颗粒度两端失衡：Q3 一日最多 95 个 tag，Q4 单次聚合最多 10 个版本。\n影响：问题定位粒度在过细与过粗之间摇摆。\n改进：固定批次大小，每批 ≤10 版本聚合。\n\n新年展望与规划\n1、发布节奏工程化：双周聚合发布落地，2027 年版本发布总量 ≤120 个（Q1 建立节奏、Q2 稳定运行）。\n2、测试覆盖率跃升：核心链路自动化覆盖 ≥80%，用例核对闸覆盖全部命令（Q1 铺 E2E、Q3 达标）。\n3、生成物与体量治理：启动耗时降 30%、生成物目录隔离入白名单（Q2 完成隔离、Q4 验收性能）。\n4、生态落地：spec-once/流水线在 ≥3 个真实项目落地并沉淀案例（Q2 试点、Q4 案例库发布）。";
@@ -355,6 +432,23 @@ if (location.search.indexOf('shot=content') > -1) {
     el.style.animation = 'none'; el.style.opacity = '1';
   });
 }
+
+// 主题换肤：四套配色随点随换；记忆上次选择（localStorage，失败静默）；?shot 截图模式隐藏坞
+(function(){
+  var THEMES = ['tech','biz','mono','warm'];
+  var dock = document.getElementById('themeDock');
+  if (!dock) return;
+  if (location.search.indexOf('shot=') !== -1){ dock.style.display = 'none'; }
+  function apply(t){ document.documentElement.setAttribute('data-theme', t);
+    dock.querySelectorAll('.th-dot').forEach(function(d){ d.classList.toggle('on', d.getAttribute('data-theme') === t); });
+    try{ localStorage.setItem('sf-report-theme', t); }catch(e){} }
+  var cur = document.documentElement.getAttribute('data-theme');
+  var saved = null; try{ saved = localStorage.getItem('sf-report-theme'); }catch(e){}
+  if (saved && THEMES.indexOf(saved) !== -1 && saved !== cur){ apply(saved); }
+  else{ dock.querySelectorAll('.th-dot').forEach(function(d){ d.classList.toggle('on', d.getAttribute('data-theme') === (cur || 'tech')); }); }
+  dock.querySelectorAll('.th-dot').forEach(function(d){ d.addEventListener('click', function(){ apply(d.getAttribute('data-theme')); }); });
+})();
+
 </script>
 </body>
 </html>

package/annual-report/resources/usage-guide.md

@@ -2,25 +2,66 @@
 
 ## 能干什么
 
-把一年的工作沉淀成五段式年度总结：年度概览（一句话 + 核心数据卡）/ 核心成果与里程碑（季度时间线）/ 经验与成长 / 不足与反思 / 新年展望与规划。适配各行业：内置 12 行业职业词典，报职业自动换术语与指标；不报职业按你的默认角色画像生成。
+把一年的工作沉淀成五段式年度总结：年度概览（一句话 TL;DR + 核心数据卡）/ 核心成果与里程碑（Q1-Q4 季度时间线）/ 经验与成长 / 不足与反思 / 新年展望与规划。适配各行业：内置 12 行业职业词典，报职业自动换术语、指标与标题（如「2026 研发年度总结」「2026 销售年度总结」）；不报职业按你的默认角色画像生成。
 
-## 三种使用方式
+## 基本用法
+- 直接说「写年度总结 / 生成年度总结」→ 默认生成当前自然年的总结，无需指定年份
+- 指定年度（多种说法均可）：
+  - 「2026 年年度总结 / 今年的总结」→ 当前自然年（未过完只算到「今天」，标题注明「截至 2026-11」）
+  - 「去年的总结 / 2025 年总结」→ 上一自然年
+  - 「近一年的总结 / 最近 12 个月的总结」→ 滚动 12 个月（今天往前推 12 个月）
+  - 「2026 财年的总结」→ 财年（可追问起止月，如 3 月~次年 2 月；不追问按自然年处理并注明）
+- 同一份年度总结重复生成默认直接覆盖；说「保留之前的 / 另存 / 不覆盖」→ 文件名追加时间戳另存不覆盖
+- 说「打开 / 查看 2026 年度总结」→ 该报告文件已存在时直接打开不重新生成；不存在则按正常流程生成
+- 开发类用户可说「只算我的提交」→ 只聚合本人提交；默认仓库内全部提交都计入
+- 说「只聚合 xxx 仓库 / 只写 xxx 的年度总结」→ 只收集指定仓库的提交，跳过其它仓库
 
-1. **git 全年聚合**（有代码仓库）：自动统计全年提交数、增删行数、月度分布、版本里程碑，结合你口述的大事生成
-2. **纯文字整理**：把年度大事、成果、感悟直接说给我或发文字
-3. **图片/文件整理**：发总结草稿、聊天记录、日报周报文件，我提取要点
+## 口头补充素材
+- 说「补充一下：Q2 上了对账系统，Q4 拿下金融客户」→ 自动按语义拆成多条，润色为规范格式并入对应季度与段落
+- 拆分信号：时间词（年初/Q1/Q2/Q3/Q4/上半年/下半年）、连接词（还有/另外/以及）、分号顿号列举、数字列举
+- 补充内容带分段词时按段并入：「展望：明年做 XX」→ 新年展望段；「不足：复盘机制缺失」→ 不足与反思段；不带分段词按语义归段（成果 → 里程碑段，感悟 → 成长段）
+- 与提交记录聚合出的成果自动去重，同一件事只保留一条（量化以提交统计为准、定性以口述为准）
 
-三者可混用，有 git 就用 git 数据，没有也能写。
+## 贴文字 / 发图片 / 给文件整理（没有提交记录也适用）
+- 直接贴一段文字说「整理成年度总结 / 把这段文字整理成年度总结」→ 以文字为主源生成，不依赖提交记录（非开发岗位也可用）；说「只整理这段文字 / 只按这段」同样跳过其它来源与会话上下文
+- 发图片（截图/照片等 jpg/png/webp）或给文件（md/txt/docx/pdf 等）说「整理成年度总结」→ 先用 Read 读取：图片按视觉理解提取图中文字信息，md/txt 直接读文本，docx/pdf 优先尝试 pandoc 转文本（无 pandoc 则请用户粘贴文字），再按纯文字模式整理；聊天记录/周报/日报文件也可作为素材
+- 图片模糊/内容读不清时：先把已提取的部分展示给用户确认或补充，不瞎编没读到的内容
+- 素材不足的段写「暂无」并提示用户可补充素材
+- 默认直接生成落盘（CONFIRM: never，无需确认）；把顶部 CONFIRM 改为 text/always，或临时说「先看看效果/先出效果」→ 先在对话输出整理好的报告正文，用户说「可以/确认/落盘」→ 再落盘文件与内容区截图并开 html；说「改一下 xxx」→ 按意见修改后重新出效果再确认
+- 说「不用确认/直接落盘」→ 当次跳过确认直接落盘（临时要求优先于配置）
+- 说「不落盘/别写文件」时跳过确认，直接对话输出
 
-## 常用说法
+## 自定义模板（适配各类岗位）
+- 内置模板为五段式（年度概览/核心成果与里程碑/经验与成长/不足与反思/新年展望与规划），适合开发岗位；其他岗位可自定义模板
+- 临时换模板：说「这次按 xxx 来」→ 口头描述结构（如"按四段：年度工作概述/重点工作与成果/经验与不足/明年工作计划"），当次按该结构生成，不改配置
+- 永久换模板：把顶部配置 TEMPLATE 改为 custom，并按 SKILL.md 的「📝 自定义模板」节说明修改段结构，之后默认按新模板生成
+- 说「以后都用这个模板」→ 自动把当前口述的结构写入「📝 自定义模板」节并把 TEMPLATE 改为 custom
+- 模板优先于纯文字模式的信号词归类：指定了段名后，文字按段名归类填充
 
-- 「写个年度总结」/「2026 年年度总结」→ 当前年或指定年
-- 「去年的年度总结」/「近一年的总结」→ 去年或滚动 12 个月
-- 「以销售经理的身份写年度总结」→ 临时换职业词条
-- 「以后默认用 XX 角色」→ 永久换默认角色
-- 「只要 md」「别开浏览器」「写到桌面」→ 临时改落盘行为
-- 「以后都用这个模板」→ 永久自定义模板
+## 角色定制（我的职业画像）
+- 默认按顶部「默认配置」ROLE 生成（当前：全栈开发工程师（企业内技术开发））；说「我的职业是 XX / 我的主要工作是 XX / 以后默认用 XX 角色」→ 永久修改 ROLE
+- 说「以 XX 的身份写年度总结」→ 当次按该角色生成（内置 12 行业词条：研发/销售/运营/产品/HR/财务/市场/客服/项目/行政/法务/设计可直接用），不改配置
+- 标题随职业词条变化：研发 →「2026 研发年度总结」、销售 →「2026 销售年度总结」等
+- 词典外行业走兜底：按骨架 + 你提供的素材现场生成词条；说「记住这个行业」→ 固化为新词条
 
-## 输出
+## 控制落盘（临时要求，仅对当次生效）
+- 默认：对话输出 Markdown + md/txt/html 三文件 + 内容区截图 content-png 落盘到 DIR（auto 按系统选：macOS=/Users/luzhaosheng/MyWork/智慧食堂/reports、Windows=d:\Workspace_QCoder\reports，路径以 user-config.md 顶部「默认配置」为准）/annual-YYYY/ + html 自动打开（DIR 目录/盘符不存在时自动改用用户主目录下 reports：macOS=~/reports、Windows=%USERPROFILE%\reports）
+- 说「写到桌面」→ 本次落盘到桌面（macOS=~/Desktop、Windows=%USERPROFILE%\Desktop）；说「存到 ~/report / D:\report」→ 本次用指定目录（均自动按年度建子目录）
+- 说「不落盘/别写文件」→ 本次只在对话输出，不写文件、不开浏览器
+- 说「只要 md」「只出 html」「只要内容区截图」→ 本次只落指定格式文件；说「这次不截图」→ 本次跳过截图（content-png = 五张分节卡片整体一张图，四周约 40px 留白，不含头部标题、复制按钮、页脚）
+- 说「只要截图/重新截个图」（如「给 2026 年度总结截个图」）→ 本次不重新生成内容，只对现有 html 执行内容区截图（覆盖 content-png，需 html 已存在，找不到则提示先生成）
+- 说「别开浏览器」→ 本次落盘后不自动打开 html
+- 说「保留之前的」→ 同年度重复生成时不覆盖，文件名追加时间戳另存
 
-对话直接出正文；默认落盘 annual-YYYY/ 目录下的 md/txt/html 三件 + 内容区截图，并自动打开 html（深蓝面板年度版式：发光头部、数据卡、季度时间线）。
+## 配置开关（改 user-config.md 顶部「默认配置」节，长期生效）
+| 配置项 | 作用 | 可选值 / 示例 |
+|---|---|---|
+| DISK | 是否落盘写文件 | true（落盘，默认）/ false（默认只在对话输出） |
+| FORMATS | 落盘哪些格式（数组） | [md, txt, html, content-png]（默认，含内容区截图）/ [md, html] / [md, txt, html]（不截图）；content-png = 五张分节卡片整体截图（四周约 40px 留白），不含头部标题/复制按钮/页脚 |
+| DIR | 落盘根目录 | auto（按当前系统自动选 DIR_MAC / DIR_WIN，默认）；DIR_MAC = macOS 根目录（/Users/luzhaosheng/MyWork/智慧食堂/reports）；DIR_WIN = Windows 根目录（d:\Workspace_QCoder\reports） |
+| OPEN_HTML | 落盘后是否自动打开 html | true（自动打开，默认）/ false（不打开） |
+| TEMPLATE | 报告模板 | default（内置五段式，默认）/ custom（按「📝 自定义模板」节的结构生成） |
+| ROLE | 默认职业角色画像 | 全栈开发工程师（企业内技术开发）等；职业名 + 括号内工作内容 |
+| CONFIRM | 落盘前先出效果确认 | never（直接生成不确认，默认）/ text（纯文字整理模式确认）/ always（所有生成都确认） |
+- 优先级：临时口头要求（不落盘/写到桌面/只要 md/只要内容区截图/这次不截图/别开浏览器/临时换模板等）永远优先于默认配置，仅对当次生效、不改配置
+- DIR（按系统解析）指向的目录/盘符不存在时，自动回退到用户主目录下 reports（macOS=~/reports、Windows=%USERPROFILE%\reports）

package/annual-report/user-config.md

@@ -10,18 +10,19 @@
 
 ```yaml
 DISK: true                     # 是否落盘写文件；false = 默认只在对话输出，不写文件不开浏览器
-CONFIG_VERSION: 1              # 配置结构版本：skill 升级时若配置结构变化会递增；AI 每次执行前对比 SKILL.md「配置版本机制」节声明的当前版本，不一致时按 SKILL.md 的迁移规则处理（先备份本文件为带时间戳 .bak，再迁移，最后对话告知用户）
+CONFIG_VERSION: 2              # 配置结构版本：skill 升级时若配置结构变化会递增；AI 每次执行前对比 SKILL.md「配置版本机制」节声明的当前版本，不一致时按 SKILL.md 的迁移规则处理（先备份本文件为带时间戳 .bak，再迁移，最后对话告知用户）
 FORMATS: [md, txt, html, content-png] # 落盘哪些格式（数组，可删减/增，如 [md, html] / [md, txt, html]（不截图）；content-png = 内容区截图（五张分节卡片整体，不含头部标题/复制按钮/页脚），删除该项即不截图；不影响对话中的 md 正文输出）
 DIR: auto                      # 落盘根目录：auto = 按当前系统自动选 DIR_MAC / DIR_WIN（也可直接写死某个绝对路径）
 DIR_MAC: /Users/luzhaosheng/MyWork/智慧食堂/reports    # macOS 落盘根目录（自动按目标年度建子目录 annual-YYYY；目录不存在时回退用户主目录下 reports）
 DIR_WIN: d:\Workspace_QCoder\reports                   # Windows 落盘根目录（自动按目标年度建子目录 annual-YYYY；目录/盘符不存在时回退用户主目录下 reports）
 OPEN_HTML: true                # 落盘后是否自动用浏览器打开 html（FORMATS 不含 html 时忽略）
+THEME: tech                    # html 页面主题：tech 深蓝科技（默认）/ biz 浅色商务 / mono 极简黑白 / warm 温暖渐变；生成时写 <html data-theme="THEME值"> 定默认，页面右下角换肤坞四色点随点随换（浏览器本地记忆，?shot 截图模式自动隐藏，打印隐藏）
 TEMPLATE: default              # 报告模板：default = 内置五段式（年度概览/核心成果与里程碑/经验与成长/不足与反思/新年展望与规划）；custom = 使用下方「📝 自定义模板」节；口头临时指定模板仅当次生效
 ROLE: 全栈开发工程师（企业内技术开发）  # 用户默认职业角色与主要工作内容（两者并存：职业名 + 括号内工作内容，生成内容/术语/量化指标/里程碑/风险话术全部按此画像走）；用户随口描述职业时（如「我搞装修的，天天跑工地」）→ AI 提炼为规范表述（装修项目经理（负责工地现场管理、施工进度与质量巡检））更新此处；说「以 XX 的身份写」→ 当次临时换角色不改配置；说「以后默认用 XX 角色 / 我的职业是 XX / 我的主要工作是 XX」→ 永久更新此处
 CONFIRM: never                 # 落盘前确认：never = 直接生成落盘不确认（默认）；text = 纯文字整理模式先出效果确认后再落盘；always = 任何方式生成都先确认；临时说「先看看效果」当次先确认、说「不用确认」当次跳过
 ```
 
-> 临时口头要求（仅对当次生效，不修改上方配置）：说「不落盘/别写文件」→ 当次 DISK=false；说「写到桌面/存到 ~/report（macOS）或 D:\report（Windows）」→ 当次改用该 DIR；说「只要 md / 只出 html / 只要内容区截图」→ 当次只落指定格式；说「这次不截图」→ 当次不生成内容区截图；说「只要截图/重新截个图」→ 当次只对现有 html 执行内容区截图（不重新收集 git、不重写 md/txt/html 内容文件）；说「别开浏览器」→ 当次 OPEN_HTML=false；说「这次按 xxx 模板来」→ 当次临时换模板（不改配置）；说「以后都用这个模板」→ 自动写入下方「📝 自定义模板」节并把 TEMPLATE 改为 custom（永久生效）；说「先看看效果/先出效果再落盘」→ 当次先出效果确认后再落盘；说「不用确认/直接落盘」→ 当次跳过确认直接落盘。
+> 临时口头要求（仅对当次生效，不修改上方配置）：说「不落盘/别写文件」→ 当次 DISK=false；说「写到桌面/存到 ~/report（macOS）或 D:\report（Windows）」→ 当次改用该 DIR；说「只要 md / 只出 html / 只要内容区截图」→ 当次只落指定格式；说「这次不截图」→ 当次不生成内容区截图；说「只要截图/重新截个图」→ 当次只对现有 html 执行内容区截图（不重新收集数据、不重写 md/txt/html 内容文件）；说「别开浏览器」→ 当次 OPEN_HTML=false；说「这次按 xxx 模板来」→ 当次临时换模板（不改配置）；说「以后都用这个模板」→ 自动写入下方「📝 自定义模板」节并把 TEMPLATE 改为 custom（永久生效）；说「先看看效果/先出效果再落盘」→ 当次先出效果确认后再落盘；说「不用确认/直接落盘」→ 当次跳过确认直接落盘。说「页面用浅色商务主题/浅色主题」→ 当次 THEME=biz；说「以后默认用暖色主题」→ 永久改 THEME=warm。
 
 ## 📝 自定义模板（TEMPLATE: custom 时启用，用户可手改，适配各类岗位）
 

package/article-to-html/SKILL.md

@@ -47,6 +47,25 @@ Turn any Word/Markdown/plain-text article into a standalone styled HTML page and
 - **为什么只有 Roboto + 思源黑体？** 两者均为免费商用授权，其余字体一律不用，零侵权
 - **单文件版什么时候给？** 定稿后重铸一次；中途调整期间不重铸以省时间
 - **改过的文章再处理？** 会先问「覆盖重生成 / 只重新截图 / 仅改样式」三选一
+- **页面能换主题色吗？** A 款页面右下角四个色点随时切换（科技蓝/暖棕金/墨绿/梅紫），浏览器记住上次选择；默认主题色在 user-config.md 的 THEME 配置里改
+
+## ⚙️ 配置与自定义主题
+
+**执行本 skill 前必须先 Read 同目录 `user-config.md`**：`THEME` 配置决定 A 款页面的默认主题色（tech 科技蓝 / gold 暖棕金 / forest 墨绿 / plum 梅紫）。升级技能时 user-config.md 不会被覆盖，你的修改永久保留。
+
+## 配置版本机制（升级保护）
+
+本 skill 当前配置版本为 `1`（对应 user-config.md 中的 `CONFIG_VERSION`）。执行时若发现 user-config.md 的 CONFIG_VERSION 与本节声明不一致：
+1. 将旧 user-config.md 备份为 `user-config.md.bak-<时间戳>`
+2. 保留用户全部自定义字段，按本节「当前版本变更记录」逐项改写旧字段
+3. 更新 CONFIG_VERSION 为当前版本
+4. 对话中明确告知用户「检测到配置版本从 X 升级到 Y，旧配置已备份至 <路径>」
+
+升级本 skill 时，配置结构如有变化必须同步更新本节的当前版本号与迁移说明；禁止在未声明版本变更的情况下静默修改配置语义。
+
+**无法迁移项处理**（值域失效 / 语义漂移 / 数据不兼容）：三情形——①旧值不在新值域（如旧模板/主题名已移除）②同名键含义变化（单位/枚举变更）③数据文件 schema 不兼容。三绝不：绝不静默（无法迁移项停下问，不猜值）、绝不丢失（旧值永远在 .bak-时间戳）、一次说清（升级报告三段式：⚠️ 版本与备份路径 → ✅ 已自动迁移清单 → 🟡 无法迁移项逐条附原因+影响+建议替代）；随后 AskUserQuestion 三选项（A 用建议值 / B 用户给新值 / C 保持旧配置——不更新 CONFIG_VERSION，每次执行再提醒）；报告必附回滚一句话；数据文件迁移前先复制 .bak-时间戳，能映射则映射、不能则写兼容层或留备份提示手动整理
+
+当前版本变更记录：暂无（初始版本 1，含 THEME 字段）。
 
 ## Prerequisites（新用户准备）
 
@@ -105,6 +124,7 @@ Turn any Word/Markdown/plain-text article into a standalone styled HTML page and
 - 通读解析出的内容，判断文章气质（科技 / 文艺 / 教程 / 科普 / 报道 / 商业等），从 [design-system.md](design-system.md)「0. 风格菜单」的六款版式中选一款
 - 默认款（暗色封面长文风）适用于大多数科技 / 产品文；文艺散文选文艺排版风；教程干货选极简白；硬核技术选终端极客风；科普清单选卡片流；深度报道选报纸分栏
 - 拿不准或用户有明确偏好时，用 AskUserQuestion 让用户在 2-4 款候选里挑（每款附一句话气质描述），不替用户做有风格争议的决定
+- A 款页面主题色默认取 user-config.md 的 `THEME` 值写入 `<html data-theme>`，页面右下角换肤坞四色点随点随换（浏览器本地记忆）
 - 任何风格都不许引入第三个字体：文艺排版风同样只用思源黑体，文艺感靠排版营造（大行距、留白、首字下沉、细分割线），不得改用宋体
 - 无论哪款风格：字体白名单锁死（Roboto + 思源黑体）、零兜底、第 3.5 步核查照跑
 
@@ -113,6 +133,7 @@ Turn any Word/Markdown/plain-text article into a standalone styled HTML page and
 - 先写入当前工作区（如 `outputs/<标题>.html`），完成后用 Bash `cp` 到用户目标目录——Write 工具被沙盒限制在工作区内
 - 大文件分片写：Write 创建文件（head + 封面 + 前几章），后续用 SearchReplace 以文件末尾 `</section>\n</div>\n</body>\n</html>` 为锚点追加章节
 - 使用 [design-system.md](design-system.md) 中的 CSS 变量与组件模式；源文档中每张图表必须有对应的 HTML/CSS 组件；表格 `td` 一律 `vertical-align:middle`
+- A 款生成时 `<html>` 标签必须带 `data-theme="<THEME值>"` + 换肤坞 HTML 与坞 JS（见 design-system.md 骨架模板）；主题色一律用 --accent 家族令牌，禁止硬编码色值
 - 页面背景默认浅灰 `#f6f8fb`；用户要纯白截图时改 `--bg:#ffffff`（深色封面 hero 保持不动）
 
 ### 3.5 交付前零侵权核查（必做，不可跳过）
@@ -204,6 +225,7 @@ grep -nE "PingFang|YaHei|apple-system|sans-serif|serif|monospace|SF Mono|Menlo|M
 - 等价于「更新模式」的「仅改样式保留内容」：只动 CSS（配色/间距/字号/组件样式），不动正文；若外来 HTML 缺章节骨架，可顺手改造成自家骨架（文字不动）
 - **每轮调整后重跑第 3.5 步核查**，防调整引入新字体污染
 - 第 4.5 步双确认闭环照跑：美化完先 RunPreview 问满意，点头才进入截图；至多 3 轮
+- 美化 A 款自家骨架时保留换肤坞（坞 HTML + 坞 JS + [data-theme] 块）；被误删时按 design-system.md 骨架模板补装
 - 美化定稿后用户要截图 → 转 6.3；单文件版如需要，用 inline_fonts.py 重铸
 
 **6.3 只截图**
@@ -237,3 +259,4 @@ grep -nE "PingFang|YaHei|apple-system|sans-serif|serif|monospace|SF Mono|Menlo|M
 5. **宽度一致性**：不注入固定宽度时封面是全宽（视口宽）、章节是内容宽（698px），宽窄不一；必须按第 5 步注入样式后再截
 6. **字体栈严禁兜底**：--sans/--mono 只许 Roboto + 思源黑体（含 Noto/思源黑体别名），加苹方/雅黑兜底会导致字体缺失时静默回退、截图抽检无法发现
 7. **章节截图顺序**：`C00-封面` → `C00-引言` → `C01…C13`，按序拼接即整篇长图
+8. **主题色禁止硬编码**：A 款配色一律走 --accent 家族令牌（--accent/--hero-base/--title-grad 等），写死色值会导致换肤坞失灵、四主题渲染错乱