diff --git a/webui/app.js b/webui/app.js
index 0cd53f4..3febcb9 100644
--- a/webui/app.js
+++ b/webui/app.js
@@ -1806,7 +1806,6 @@ function renderPath(data) {
     return;
   }
   const weeks = stageWeeks(data.learning_path.length);
-  const weeks = stageWeeks(data.learning_path.length);
   /* 阶段语义化命名：基础补齐 → 岗位核心（可多个）→ 项目验证 */
   const stageName = (i, n) =>
     i === 0 ? "基础补齐" : i === n - 1 ? "项目验证" : "岗位核心";
diff --git a/webui/index.html b/webui/index.html
index 27445c5..9f0e40d 100644
--- a/webui/index.html
+++ b/webui/index.html
@@ -300,6 +300,7 @@
             <div id="evo-tab-scan" class="hidden">
               <!-- 全部岗位演化热力图：仅近 12 季度，无事件格子置为极浅色 -->
               <div class="evo-chart-title text-aux text-secondary">全部岗位演化热力图 · 近 12 季度（每格 = 该季度演化事件数，点击行切换岗位并回到岗位报告）</div>
+              <div class="evo-chart-desc">怎么看：每行一个岗位、每列一个季度，颜色越深说明该岗位当季能力变化越多。用于快速发现"哪些岗位正在剧烈变化"；点击行标签进入该岗位的详细报告。</div>
               <div class="evo-heatmap" id="evo-heatmap"><div class="empty small">加载中…</div></div>
             </div>
 
@@ -309,14 +310,17 @@
 
             <!-- 本期结论（最近两个季度的新增/增强/减弱/退出） -->
             <div class="evo-chart-title text-aux text-secondary">本期结论（最近两个季度）</div>
+            <div class="evo-chart-desc">是什么：系统根据近两个季度的招聘 JD 自动归纳出的能力变化结论。新增=以前不要求、现在要求；增强=要求变重；减弱=要求变少；退出=不再要求。每条结论都可追溯到原始 JD 证据。</div>
             <div class="evo-summary" id="evo-summary"><div class="empty small">加载中…</div></div>
 
             <!-- 能力生命线（Swimlane）：每个核心技能一行，线段=生效区间，圆点=变更事件 -->
             <div class="evo-chart-title text-aux text-secondary">能力生命线（近 8 季度 · 按当前需求指数取 Top 12；线段 = 生效区间，圆点 = 变更事件）</div>
+            <div class="evo-chart-desc">怎么看：每行是一项核心技能的"在岗生命周期"——横线表示这段时间里该技能属于岗位要求，彩色圆点标记发生变化的时间点（颜色含义见图例）。一眼看出技能何时进入、何时增强、何时退出。</div>
             <div class="evo-gantt" id="evo-gantt"></div>
 
             <!-- 能力更替流：旧核心 → 持续能力 → 新核心 -->
             <div class="evo-chart-title text-aux text-secondary">能力更替流（旧核心 → 持续能力 → 新核心）</div>
+            <div class="evo-chart-desc">是什么：把岗位技能按演化结果分三列——左边是已退出的旧要求，中间是一直有效的持续能力，右边是新进入的要求。用于回答"这个岗位正在从什么技术栈转向什么技术栈"。</div>
             <div class="evo-replace" id="evo-replace"></div>
 
             <!-- 时点对比器 -->
@@ -330,11 +334,13 @@
                   <button class="btn btn-secondary btn-sm" id="evo-compare-btn">对比</button>
                 </div>
               </div>
+              <div class="evo-chart-desc">怎么用：选择两个日期，系统回放该岗位在两个时点的完整能力画像并求差集——红色=左边时点有、后来退出；绿色=右边时点新增；灰色=一直保留（带↑表示从加分升级为必备）。</div>
               <div class="evo-diff" id="evo-diff"></div>
             </div>
 
             <!-- 变更类型构成（堆叠柱状） -->
             <div class="evo-chart-title text-aux text-secondary">变更类型构成（每季度 新增/增强/减弱/退出）</div>
+            <div class="evo-chart-desc">怎么看：每根柱子是一个季度，四种颜色堆叠表示该季度四类变化的数量。柱子变高=该岗位在加速变化；绿色段厚=能力在扩张；橙红段厚=能力在收缩。用于判断岗位所处阶段（扩张期/调整期/稳定期）。</div>
             <div class="evo-heat-wrap"><canvas id="evo-stack-canvas"></canvas></div>
             <div class="stack-legend" id="stack-legend"></div>
 
@@ -346,10 +352,12 @@
                 <button data-range="all">全部</button>
               </span>
             </div>
+            <div class="evo-chart-desc">是什么：该岗位每个季度实际生效的技能总数（按岗位-技能关系的生效区间统计）。曲线上升=岗位要求在扩充，下降=在精简，平直=稳定。可切换近 8 季 / 全部历史。</div>
             <div class="evo-heat-wrap"><canvas id="evo-heat-canvas"></canvas></div>
 
             <!-- 本期变化卡：事件时间轴，每条含变化前后/支撑证据入口 -->
             <div class="evo-chart-title text-aux text-secondary">本期变化卡（变化前 → 变化后 / 支撑 JD 数 / 点击查看证据原文）</div>
+            <div class="evo-chart-desc">怎么用：每一次能力变化的明细卡片，含变化说明、前后需求指数、支撑 JD 数量。点击任意卡片可查看支撑该结论的原始 JD 证据（来源平台、企业、发布时间、原文片段）。</div>
             <div class="timeline" id="evo-timeline"></div>
             </div>
           </div>
diff --git a/webui/style.css b/webui/style.css
index 31f983f..5c06e19 100644
--- a/webui/style.css
+++ b/webui/style.css
@@ -1165,3 +1165,6 @@ svg { width: 16px; height: 16px; stroke: currentColor; fill: none; stroke-width:
 
 /* 驾驶舱事件流主图限高 */
 #trend-canvas { max-height: 260px; }
+
+/* 演化页图表说明文字 */
+.evo-chart-desc { font-size: 12px; color: var(--text-3); line-height: 1.7; margin: -2px 0 8px; }