codebee 0.1.47 → 0.1.49

package/app/ui/app.js

@@ -10,7 +10,7 @@ function codebeeDocumentTitle(lang) {
 document.title = codebeeDocumentTitle((localStorage.getItem("orch.lang") || "zh").toLowerCase());
 
 const $ = (id) => document.getElementById(id);
-const S = { state: null, catalog: null, catSig: "", providers: null, bindings: null, modelsSig: "", bindSig: "", tab: "tasks", detailRunId: null, pollTimer: null, showArchived: false, /* 会话内开关：每次加载默认隐藏已归档、图标不选中（不持久化，见 btn-side-arch） */ selProvs: {}, selModels: {}, selRuns: {}, bindSel: {}, catalogChecking: false, updateCheckAt: 0, control: null, sseLive: false, es: null, flows: null, orch: null, skills: null, orchSig: "", settings: null, sessionAgents: new Set(), atts: [], gitInfo: null, gitWb: null, gitWbKey: "", gitWbAt: 0, gitWbBusy: false, creatingTask: false, inspKey: null, inspData: null, inspSig: "", inspAt: 0, inspTab: "git", inspAutoSig: "", rdTab: null, rdTabSig: "", rdTabPin: false, _rdCtx: {}, lastPrefs: null, prefsApplied: false };
+const S = { state: null, catalog: null, catSig: "", providers: null, bindings: null, modelsSig: "", bindSig: "", tab: "tasks", mainPage: "", /* 主栏正显示的全局页（"" = 新建任务表单）；左栏是任务树还是设置导航看 body.settings-mode */ detailRunId: null, pollTimer: null, showArchived: false, /* 会话内开关：每次加载默认隐藏已归档、图标不选中（不持久化，见 btn-side-arch） */ selProvs: {}, selModels: {}, selRuns: {}, bindSel: {}, catalogChecking: false, updateCheckAt: 0, control: null, sseLive: false, es: null, flows: null, orch: null, skills: null, orchSig: "", settings: null, sessionAgents: new Set(), atts: [], gitInfo: null, gitWb: null, gitWbKey: "", gitWbAt: 0, gitWbBusy: false, creatingTask: false, inspKey: null, inspData: null, inspSig: "", inspAt: 0, inspTab: "git", inspAutoSig: "", rdTab: null, rdTabSig: "", rdTabPin: false, _rdCtx: {}, lastPrefs: null, prefsApplied: false };
 
 /* ---------------------------------------------------------- 任务类型（流程） */
 async function loadFlows() {
@@ -301,7 +301,8 @@ function onTypeChange() {
   const bibleCreate = $("bible-create-field");
   const isSerialReview = isReview && !!(flow && flow.serial);
   if (bibleCreate) bibleCreate.classList.toggle("hidden", !isSerialReview);
-  const clearSerialFields = () => ["f-chapters", "f-words-per-ch", "f-variants", "f-bible"].forEach((id) => {
+  const clearSerialFields = () => ["f-chapters", "f-words-per-ch", "f-variants", "f-bible",
+    "f-vol-chapters", "f-vol-spec"].forEach((id) => {
     const el = $(id);
     if (el) el.value = "";
   });
@@ -330,6 +331,12 @@ function onTypeChange() {
     if (flow.serial) {
       if (!$("f-chapters").value) $("f-chapters").value = lp.chapters || flow.serial.chapters || "";
       if (!$("f-words-per-ch").value) $("f-words-per-ch").value = lp.words_per_chapter || flow.serial.words_per_chapter || "";
+      // 分卷开箱即用：没填过就预填一个常见每卷章数（用户可改；清空 = 不分卷）。
+      // 卷边界由后端按全书章号推导，续写批次自动接上同一卷。
+      if (!$("f-vol-chapters").value && !$("f-vol-spec").value) {
+        $("f-vol-chapters").value = (lp.volume_chapters != null && lp.volume_chapters !== "")
+          ? lp.volume_chapters : (flow.serial.volume_chapters || 20);
+      }
     } else clearSerialFields();
   } else {
     // 隐藏控件仍保留 DOM 值；换流程时清理，避免章节/圣经状态污染下一次提交。
@@ -1002,6 +1009,7 @@ function applyState(d) {
   $("conn").textContent = t("已连接");
   $("conn").className = "conn ok";
   restoreInspector();   // 刷新后恢复上次打开的检查器（只在已开时为空操作）
+  ovMaybeRefresh();     // 停在概览页时：概览语与最近运行跟着这次状态一起刷新
 }
 
 /* ---------------------------------------------------------- 供应商健康告警横幅 */
@@ -2464,6 +2472,12 @@ async function createTask() {
         words_per_chapter: parseInt($("f-words-per-ch").value, 10) || 2500,
         variants: Math.max(1, Math.min(3, parseInt($("f-variants").value, 10) || 1)),
       };
+      // 分卷：显式卷结构文本优先（后端解析成卷表），否则用每卷章数。
+      // 两个都留空 = 不分卷（后端收到 0/缺字段即不分卷）。
+      const volSpec = ($("f-vol-spec") || {}).value ? $("f-vol-spec").value.trim() : "";
+      const volPer = parseInt(($("f-vol-chapters") || {}).value, 10);
+      if (volSpec) payload.serial.volumes_text = volSpec;
+      else if (volPer >= 2) payload.serial.volume_chapters = volPer;
     } else if (flow.serial) {
       // 显式 null 覆盖 serial_novel 的流程默认，空章节就是单稿件。
       payload.serial = null;
@@ -3138,6 +3152,16 @@ function newFromTask(id) {
     $("f-chapters").value = tk.serial ? tk.serial.chapters : "";
     $("f-words-per-ch").value = tk.serial ? tk.serial.words_per_chapter : "";
     $("f-variants").value = tk.serial && tk.serial.variants ? tk.serial.variants : "";
+    // 分卷：还原每卷章数；指定卷结构还原成可读文本（卷名 + 章数/章号范围）
+    $("f-vol-chapters").value = tk.serial && tk.serial.volume_chapters ? tk.serial.volume_chapters : "";
+    $("f-vol-spec").value = tk.serial && Array.isArray(tk.serial.volumes)
+      ? tk.serial.volumes.map((v) => {
+          const ttl = (v && v.title) || "未命名";
+          if (v && v.start && v.end) return ttl + " 第" + v.start + "-" + v.end + "章";
+          if (v && v.chapters) return ttl + " " + v.chapters + "章";
+          return ttl;
+        }).join("；")
+      : "";
     const want = new Set(tk.critics || []);
     $("f-critics").querySelectorAll("input").forEach((i) => { i.checked = want.has(i.value); });
     // 同目录同稿件名再开一篇会覆盖旧产出——提醒但不阻止（有意重写也合理）
@@ -3643,7 +3667,7 @@ function showDetailInMain() {
 function jumpToRun(id) {
   S.focusStep = 0;
   S.focusDone = false;
-  if (document.body.classList.contains("settings-mode")) switchTab("runs");
+  if (document.body.classList.contains("settings-mode")) switchTab("runs", "settings");   // 已在设置里：留在设置侧栏
   else showDetailInMain();
   openRun(id);
 }
@@ -3991,12 +4015,17 @@ function closeRun() {
   detailSideReset();
   $("run-detail").classList.add("hidden");
   renderChatNav();   // 解除 main.chat-fill（对话为主的固定高度），恢复外层滚动
-  if (document.body.classList.contains("settings-mode")) {
+  if (document.body.classList.contains("settings-mode") || S.mainPage === "runs") {
+    // 回运行列表：设置导航里点进来的，或主栏本就停在运行记录页（快捷导航/概览的入口）
     document.querySelector("#sub-runs .panel:first-child").classList.remove("hidden");
+  } else if (S.mainPage) {
+    // 主栏停在别的快捷导航页（概览/自动化）：返回点开详情前那一页，左栏任务树不动
+    switchTab(S.mainPage, "main");
   } else {
     // 从主视图（侧栏点任务行）进来的详情：返回直接回任务页，不露出运行列表
     document.querySelectorAll("#page-settings .subpage").forEach((d) => d.classList.toggle("hidden", d.id !== "sub-tasks"));
     document.querySelectorAll(".set-item").forEach((b) => b.classList.toggle("active", b.dataset.sub === "tasks"));
+    document.querySelectorAll(".qitem").forEach((b) => b.classList.remove("active"));
     const title = $("page-title");
     if (title) title.textContent = tabTitle("tasks");
   }
@@ -4725,8 +4754,11 @@ window.pbUploadChapter = async function (taskId, platform) {
   if (!box.classList.contains("hidden")) { box.classList.add("hidden"); return; }
   box.classList.remove("hidden");
   box.innerHTML = '<div class="pb-loading">' + esc(t("正在列出章节文件…")) + "</div>";
-  let wd = "";
-  try { const tk = ((S.state || {}).tasks || []).find((x) => x.id === taskId); wd = (tk && tk.workdir) || ""; } catch (e) { /* 兜底空 */ }
+  let wd = "", pubTask = null;
+  try {
+    pubTask = ((S.state || {}).tasks || []).find((x) => x.id === taskId);
+    wd = (pubTask && pubTask.workdir) || "";
+  } catch (e) { /* 兜底空 */ }
   if (!wd) { box.innerHTML = '<div class="pb-err">' + esc(t("找不到任务工作目录")) + "</div>"; return; }
   let files = [];
   try {
@@ -4739,11 +4771,33 @@ window.pbUploadChapter = async function (taskId, platform) {
   }
   if (!files.length) { box.innerHTML = '<div class="pb-err">' + esc(t("工作目录里没有 .md 章稿")) + "</div>"; return; }
   files.sort((a, b) => (a.name > b.name ? 1 : -1));
-  box.innerHTML = '<div class="pb-hint">' + esc(t("选一章发送（表单填好后停，人工确认提交）；已成功发过的章会被台账拦下：")) + "</div>" +
-    files.map((f) =>
-      '<button class="ghost pb-ch-item" onclick="pbSendChapter(\'' + esc(taskId) + "', '" + platform +
-      '\',\'' + esc(f.name) + '\')" title="' + esc(f.name) + '">' + esc(f.name.split("/").pop()) + "</button>"
-    ).join("");
+  const item = (f) =>
+    '<button class="ghost pb-ch-item" onclick="pbSendChapter(\'' + esc(taskId) + "', '" + platform +
+    '\',\'' + esc(f.name) + '\')" title="' + esc(f.name) + '">' + esc(f.name.split("/").pop()) + "</button>";
+  const hint = '<div class="pb-hint">' + esc(t("选一章发送（表单填好后停，人工确认提交）；已成功发过的章会被台账拦下：")) + "</div>";
+  // 最高章号：让卷规划表铺到最后一章（否则超出显式卷表的章节会掉进「其他」）
+  let maxCh = 0;
+  files.forEach((f) => {
+    const n = chapterNumOf(f.name);
+    if (n > maxCh) maxCh = n;
+  });
+  const plan = volumePlanOf(pubTask, maxCh);
+  if (!plan.length) { box.innerHTML = hint + files.map(item).join(""); return; }
+  // 分卷：按卷分组列出可发章节（章号取自 chapter-NN.md）。未落入卷的文件归「其他」。
+  const groups = plan.map((v) => ({ v: v, files: [] }));
+  const rest = [];
+  files.forEach((f) => {
+    const n = chapterNumOf(f.name);
+    if (!n) { rest.push(f); return; }
+    const g = groups.find((x) => n >= x.v.first && (x.v.last == null || n <= x.v.last));
+    if (g) g.files.push(f); else rest.push(f);
+  });
+  box.innerHTML = hint + groups.filter((g) => g.files.length).map((g) => {
+    const label = t("第") + " " + g.v.vol + " " + t("卷") + (g.v.title ? " 《" + g.v.title + "》" : "");
+    return '<div class="pb-vol"><div class="pb-vol-head">' + esc(label) + "</div>" +
+      g.files.map(item).join("") + "</div>";
+  }).join("") + (rest.length ? '<div class="pb-vol"><div class="pb-vol-head">' +
+    esc(t("其他文件")) + "</div>" + rest.map(item).join("") + "</div>" : "");
 };
 
 window.pbSendChapter = async function (taskId, platform, relName) {
@@ -5231,7 +5285,7 @@ window.toggleInspector = function () {
   openInspector(key);
 };
 
-/* 检查器只属于「列表快捷预览」上下文：设置子页、新建表单、运行/任务详情一律收起。
+/* 检查器只属于「列表快捷预览」上下文：设置子页、快捷导航页、新建表单、运行/任务详情一律收起。
  * 详情页已铺开全部信息（蜂巢/步骤/成果/版本/圣经/指挥），检查器留着只会同屏
  * 出现两份标题/成品/Git——让它让位，但不丢选中，回到列表上下文自动滑回 */
 function syncInspectorVis() {
@@ -5243,11 +5297,12 @@ function syncInspectorVis() {
   // 主视图下正在看「要完成什么？」新建表单：不是任务上下文，不自动滑出。
   // （本函数只在模式切换时调用，不在轮询里——用户在表单页手动点树里的任务，
   //   openInspector 直接开，不会被这里关掉）
-  const onComposer = !document.body.classList.contains("settings-mode") &&
+  const onComposer = !S.mainPage && !document.body.classList.contains("settings-mode") &&
     !$("sub-tasks").classList.contains("hidden");
   // 主栏正开着运行/任务详情：详情页是全功能视图，检查器同屏只会重复
   const onDetail = !$("run-detail").classList.contains("hidden");
-  if (document.body.classList.contains("settings-mode") || onComposer || onDetail ||
+  // 主栏停在快捷导航页（概览/运行记录/自动化）：同设置子页，检查器让位不抢版面
+  if (document.body.classList.contains("settings-mode") || S.mainPage || onComposer || onDetail ||
       !S.inspKey || runsGone) {
     document.body.classList.remove("inspector-open");
     insp.classList.add("hidden");
@@ -5853,36 +5908,117 @@ function stepsMatch(runs, current) {
     (r.steps || []).some((s) => s.log === current.rel));
 }
 
+/* 从章稿文件名取全书章号：chapter-07.md → 7；非章稿（或解析不出）返回 0。
+ * 只认「chapter-数字.md」这一约定（与后端 _CH_FILE_RE 一致）。 */
+function chapterNumOf(name) {
+  const base = String(name || "").split("/").pop();
+  if (!/^chapter-\d{1,4}\.md$/i.test(base)) return 0;
+  const digits = base.slice("chapter-".length, -3);
+  const n = parseInt(digits, 10);
+  return n > 0 ? n : 0;
+}
+
+/* 分卷规划表（前端只读副本）：把任务的 serial 分卷配置还原成
+ * [{vol, title, first, last}]，供发布页按卷分组列章。后端 volumes.py 是唯一
+ * 真源（写作与成书都走它）；这里只做「列清单」这一用途的最小推导，取不到
+ * 分卷配置时返回 []（调用方退化为平铺列表）。
+ *   serial.volumes        显式卷表：[{title, chapters|start/end}]（优先）
+ *   serial.volume_chapters 每卷章数：等长切卷（兜底）
+ * last=null 表示开放到书末。 */
+function volumePlanOf(task, upto) {
+  const s = (task || {}).serial || {};
+  const spec = Array.isArray(s.volumes) ? s.volumes : [];
+  let per = parseInt(s.volume_chapters, 10);
+  if (!(per >= 2)) per = 0;
+  if (!spec.length && !per) return [];
+  const plan = [];
+  let prevLast = 0;
+  const push = (title, first, last) => plan.push({ vol: plan.length + 1, title: title || "", first: first, last: last });
+  for (const it of spec) {
+    if (!it) continue;
+    const first = (it.start > 0) ? it.start : prevLast + 1;
+    let last = null;
+    if (it.end > 0) last = it.end;
+    else if (it.chapters > 0) last = first + it.chapters - 1;
+    if (last != null && last < first) last = first;
+    push(it.title, first, last);
+    if (last == null) return plan;     // 开放卷：后面不再有卷
+    prevLast = last;
+  }
+  // 显式卷表用尽后按每卷章数（或末卷长度）续卷，保证覆盖到 upto（与后端
+  // volumes.build_plan 同规则）——否则第 21 章起会掉进「其他文件」分组。
+  const fb = per || (plan.length && plan[plan.length - 1].last != null
+    ? plan[plan.length - 1].last - plan[plan.length - 1].first + 1 : 0);
+  if (fb > 0) {
+    let cursor = prevLast + 1;
+    const limit = (upto > 0) ? upto : (plan.length ? prevLast : fb);
+    while (cursor <= limit && plan.length < 200) {
+      push("", cursor, cursor + fb - 1);
+      cursor += fb;
+    }
+  }
+  return plan;
+}
+
+
 /* 连载章节评审卡：每章均分/是否达标/字数 + 逐项目标审稿结果（event_check，
  * 借鉴 AI-Novel-Writer：大纲要点逐项判定+正文证据）。非连载 run 无
- * chapter_scores 保持隐藏。 */
+ * chapter_scores 保持隐藏。
+ * 分卷：章节卡按卷分组显示（卷名来自 run.volumes / chapter_scores[].vol_title），
+ * 不分卷时退化为原来的平铺列表，视觉零变化。 */
 function renderChapterScores(run) {
   const box = $("rd-chapters");
   if (!box) return;
   const cs = run && run.chapter_scores;
   if (!Array.isArray(cs) || !cs.length) { box.classList.add("hidden"); return; }
   box.classList.remove("hidden");
-  box.innerHTML = '<h3 class="sec-title">' + t("章节评审") +
-    '<span class="tag">' + cs.filter((c) => c.passed).length + "/" + cs.length + " " + t("达标") + "</span></h3>" +
-    cs.map((c) => {
-      const means = c.means || {};
-      const dims = Object.keys(means).map((d) =>
-        '<span class="ch-dim' + (means[d] >= 7 ? "" : " low") + '">' + esc(d) + " " + means[d] + "</span>").join("");
-      const ev = (c.event_check || []).map((line) => {
-        const ok = /已完成/.test(line), bad = /未完成/.test(line);
-        return '<div class="ch-ev' + (ok ? " ok" : bad ? " bad" : "") + '">' + esc(line) + "</div>";
-      }).join("");
-      return '<div class="ch-row' + (c.passed ? "" : " fail") + '">' +
-        '<div class="ch-head"><b>' + esc(t("第") + " " + c.chapter + " " + t("章")) + '</b>' +
-        '<span class="ch-title">' + esc(c.title || "") + "</span>" +
-        '<span class="tag">' + (c.passed ? t("达标") : t("未达标")) + "</span>" +
-        (c.reused ? '<span class="tag">' + t("沿用") + "</span>" : "") +
-        '<span class="ch-meta">' + Number(c.words || 0) + t(" 字") +
-        (c.rounds > 1 ? " · " + c.rounds + t(" 轮") : "") + "</span></div>" +
-        (dims ? '<div class="ch-dims">' + dims + "</div>" : "") +
-        (ev ? '<div class="ch-evs"><span class="hint">' + t("逐项目标核对：") + "</span>" + ev + "</div>" : "") +
-        "</div>";
+  // 卷名表：优先 run.volumes（全书卷规划），退到章节自带的 vol_title
+  const volTitles = {};
+  (run.volumes || []).forEach((v) => { volTitles[v.vol] = v.title || ""; });
+  cs.forEach((c) => {
+    if (c.vol && c.vol_title && !volTitles[c.vol]) volTitles[c.vol] = c.vol_title;
+  });
+  const rowHtml = (c) => {
+    const means = c.means || {};
+    const dims = Object.keys(means).map((d) =>
+      '<span class="ch-dim' + (means[d] >= 7 ? "" : " low") + '">' + esc(d) + " " + means[d] + "</span>").join("");
+    const ev = (c.event_check || []).map((line) => {
+      const ok = /已完成/.test(line), bad = /未完成/.test(line);
+      return '<div class="ch-ev' + (ok ? " ok" : bad ? " bad" : "") + '">' + esc(line) + "</div>";
     }).join("");
+    return '<div class="ch-row' + (c.passed ? "" : " fail") + '">' +
+      '<div class="ch-head"><b>' + esc(t("第") + " " + c.chapter + " " + t("章")) + '</b>' +
+      '<span class="ch-title">' + esc(c.title || "") + "</span>" +
+      '<span class="tag">' + (c.passed ? t("达标") : t("未达标")) + "</span>" +
+      (c.reused ? '<span class="tag">' + t("沿用") + "</span>" : "") +
+      '<span class="ch-meta">' + Number(c.words || 0) + t(" 字") +
+      (c.rounds > 1 ? " · " + c.rounds + t(" 轮") : "") + "</span></div>" +
+      (dims ? '<div class="ch-dims">' + dims + "</div>" : "") +
+      (ev ? '<div class="ch-evs"><span class="hint">' + t("逐项目标核对：") + "</span>" + ev + "</div>" : "") +
+      "</div>";
+  };
+  const head = '<h3 class="sec-title">' + t("章节评审") +
+    '<span class="tag">' + cs.filter((c) => c.passed).length + "/" + cs.length + " " + t("达标") + "</span></h3>";
+  const hasVol = cs.some((c) => c.vol);
+  if (!hasVol) { box.innerHTML = head + cs.map(rowHtml).join(""); return; }
+  // 按卷分组（章号顺序，卷内保持原序）
+  const groups = [];
+  cs.forEach((c) => {
+    const v = c.vol || 0;
+    let g = groups.find((x) => x.vol === v);
+    if (!g) { g = { vol: v, rows: [] }; groups.push(g); }
+    g.rows.push(c);
+  });
+  box.innerHTML = head + groups.map((g) => {
+    const title = volTitles[g.vol] || "";
+    const nPass = g.rows.filter((c) => c.passed).length;
+    const label = g.vol ? (t("第") + " " + g.vol + " " + t("卷") + (title ? " 《" + title + "》" : "")) : t("未分卷");
+    return '<div class="ch-vol"><div class="ch-vol-head"><b>' + esc(label) + "</b>" +
+      '<span class="tag">' + nPass + "/" + g.rows.length + " " + t("达标") + "</span>" +
+      '<span class="ch-meta">' + t("第 ") + g.rows[0].chapter + "–" +
+      g.rows[g.rows.length - 1].chapter + t(" 章") + "</span></div>" +
+      g.rows.map(rowHtml).join("") + "</div>";
+  }).join("");
 }
 
 function renderPlan(run) {
@@ -8354,6 +8490,7 @@ function flowForm(fid) {
     '<div class="field"><label>' + t("连载章节数（留空 = 单稿件）") + '</label><input id="fl-chapters" type="number" min="2" max="20" value="' + (f && f.serial ? f.serial.chapters : "") + '" placeholder="' + t("例：8") + '"></div>' +
     '<div class="field"><label>' + t("每章约字数") + '</label><input id="fl-words-per-ch" type="number" min="500" max="8000" step="100" value="' + (f && f.serial ? f.serial.words_per_chapter : "") + '" placeholder="' + t("例：2500") + '"></div>' +
     '<div class="field"><label>' + t("同章赛马稿件数") + '</label><input id="fl-variants" type="number" min="1" max="3" step="1" value="' + (f && f.serial ? (f.serial.variants || 1) : 1) + '" placeholder="' + t("1 = 关闭") + '"></div>' +
+    '<div class="field"><label>' + t("分卷：每卷章数（留空 = 不分卷）") + '</label><input id="fl-vol-chapters" type="number" min="2" max="200" step="1" value="' + (f && f.serial && f.serial.volume_chapters ? f.serial.volume_chapters : "") + '" placeholder="' + t("例：20") + '"></div>' +
     "</div>" +
     '<div class="field"><label>' + t("起草提示词（可选，占位符 __FILE__ __GOAL__ __CONTEXT__ __SKILLS__）") + '</label><textarea id="fl-draft" rows="3" placeholder="' + t("留空 = 内置通用模板") + '">' + esc(f && f.draft_prompt ? f.draft_prompt : "") + "</textarea></div>" +
     '<div class="field"><label>' + t("评审提示词（可选，占位符 __DIMKEYS__ __MANUSCRIPT__）") + '</label><textarea id="fl-critique" rows="3" placeholder="' + t("留空 = 内置通用模板") + '">' + esc(f && f.critique_prompt ? f.critique_prompt : "") + "</textarea></div>" +
@@ -8393,11 +8530,15 @@ async function saveFlow() {
     const rb = $("fl-rubric").value.split(/[,，、]/).map((s) => s.trim()).filter(Boolean);
     if (rb.length) payload.rubric = rb;
     const ch = parseInt($("fl-chapters").value, 10);
-    if (ch >= 2) payload.serial = {
-      chapters: ch,
-      words_per_chapter: parseInt($("fl-words-per-ch").value, 10) || 2500,
-      variants: Math.max(1, Math.min(3, parseInt($("fl-variants").value, 10) || 1)),
-    };
+    if (ch >= 2) {
+      payload.serial = {
+        chapters: ch,
+        words_per_chapter: parseInt($("fl-words-per-ch").value, 10) || 2500,
+        variants: Math.max(1, Math.min(3, parseInt($("fl-variants").value, 10) || 1)),
+      };
+      const vp = parseInt(($("fl-vol-chapters") || {}).value, 10);
+      if (vp >= 2) payload.serial.volume_chapters = vp;   // 流程默认分卷（任务级可覆盖）
+    }
     const dp = $("fl-draft").value.trim();
     if (dp) payload.draft_prompt = dp;
     const cp = $("fl-critique").value.trim();
@@ -8694,6 +8835,26 @@ function autoStatusTag(tsk) {
   return "";
 }
 
+/* 运行偏好标签：只显示「偏离默认」的那些（编排默认 auto、思考默认 standard），
+ * 否则每张卡都挂两颗没有信息量的胶囊，反而盖住真正要看的节奏与流程 */
+function autoPrefTags(tsk) {
+  const MODE = { auto: "自动", fast: "快速", expert: "专家", manual: "手动" };
+  const TH = { auto: "自动", low: "快速", standard: "标准", high: "深度" };
+  const out = [];
+  if (tsk.mode && tsk.mode !== "auto" && MODE[tsk.mode]) {
+    out.push(t("编排模式") + "：" + t(MODE[tsk.mode]));
+  }
+  if (tsk.thinking && tsk.thinking !== "standard" && TH[tsk.thinking]) {
+    out.push(t("思考程度") + "：" + t(TH[tsk.thinking]));
+  }
+  if (tsk.direct_provider_id) {
+    const p = directProviders().find((x) => x.id === tsk.direct_provider_id);
+    out.push(t("对话模型") + "：" + (p ? (p.name || p.id) : tsk.direct_provider_id) +
+      "/" + (tsk.direct_model || t("随厂商推荐")));
+  }
+  return out.map((s) => '<span class="tag">' + esc(s) + "</span>").join("");
+}
+
 function autoCardHtml(tsk) {
   const flow = tsk.flow ? flowById(tsk.flow) : null;
   return '<div class="card' + (tsk.enabled ? "" : " off") + '"><div class="head">' +
@@ -8703,7 +8864,8 @@ function autoCardHtml(tsk) {
     ' onchange="autoToggle(\'' + esc(tsk.id) + '\', this.checked)"><span>' + (tsk.enabled ? t("启用中") : t("已停用")) + "</span></label>" +
     "</div>" +
     '<div class="auto-kind">' + esc(autoKindText(tsk)) +
-    (flow ? '<span class="tag">' + t("流程：") + esc(t(flow.name)) + "</span>" : "") + "</div>" +
+    (flow ? '<span class="tag">' + t("流程：") + esc(t(flow.name)) + "</span>" : "") +
+    autoPrefTags(tsk) + "</div>" +
     '<div class="auto-prompt">' + esc(tsk.prompt) + "</div>" +
     '<div class="auto-meta">' +
     (tsk.enabled && tsk.next_run ? "<span>" + t("下次运行 ") + esc(tsk.next_run) + "</span>" : "") +
@@ -8746,6 +8908,8 @@ async function autoForm(task, tpl) {
   const f = task || {};
   const kind = f.kind || (tpl && tpl.suggested_kind) || "daily";
   const curFlow = f.flow || (tpl && tpl.suggested_flow) || "";
+  const mode = f.mode || "auto";
+  const thinking = f.thinking || "standard";
   const wdOpts = AUTO_WD.map((w, i) =>
     '<option value="' + i + '"' + (Number(f.weekday) === i || (!task && tpl && tpl.suggested_weekday === i) ? " selected" : "") + ">" + t(w) + "</option>").join("");
   const runAt = f.run_at ? String(f.run_at).replace(" ", "T").slice(0, 16) : "";
@@ -8769,6 +8933,18 @@ async function autoForm(task, tpl) {
         '<option value="' + esc(fl.id) + '"' + (fl.id === curFlow ? " selected" : "") + ">" + esc(t(fl.name)) + "</option>").join("") +
       "</select></div>" +
     "</div>" +
+    /* 运行偏好：与新建任务 Composer 的三颗胶囊同一套取值（编排模式/思考程度/
+       对话模型），到点拉起的运行与手动建的任务完全等价 */
+    '<div class="grid-2">' +
+    '<div class="field"><label>' + t("编排模式") + "</label>" +
+      autoPillHtml("au-mode", AUTO_MODES, mode) + "</div>" +
+    '<div class="field"><label>' + t("思考程度") + "</label>" +
+      autoPillHtml("au-thinking", AUTO_THINKINGS, thinking) + "</div>" +
+    "</div>" +
+    '<div id="au-model-field" class="field hidden"><label>' + t("对话模型（可选）") + '</label><div class="grid-2">' +
+      '<select id="au-direct-provider" aria-label="' + t("对话厂商") + '"></select>' +
+      '<select id="au-direct-model-name" aria-label="' + t("对话模型") + '"></select>' +
+      '</div><p class="hint">' + t("只对「直接执行」类流程生效；留「自动推荐」时按系统路由挑模型。") + "</p></div>" +
     '<div class="grid-2">' +
     '<div class="field au-fld" data-k="time"><label>' + t("时间") + '</label><input id="au-time" type="time" value="' +
       esc(f.time || (tpl && tpl.suggested_time) || "09:00") + '"></div>' +
@@ -8788,6 +8964,71 @@ async function autoForm(task, tpl) {
     kindSel.addEventListener("change", autoFormSyncKind);
     autoFormSyncKind();
   }
+  ["au-mode", "au-thinking"].forEach((id) => {
+    const sel = $(id);
+    if (sel) sel.addEventListener("change", () => syncCmpSelFace(id));
+    syncCmpSelFace(id);   // 弹框是动态插入的：选项文字要在这里同步一次
+  });
+  renderAuModelPicker(f.direct_provider_id || "", f.direct_model || "");
+  const flowSel = $("au-flow");
+  if (flowSel) {
+    flowSel.addEventListener("change", autoFormSyncFlow);
+    autoFormSyncFlow();
+  }
+}
+
+/* 运行偏好取值（真源 = automation.py 的 MODES/THINKINGS，选项文案与 Composer 共用） */
+const AUTO_MODES = [
+  { v: "auto", label: "自动（推荐）：按任务类型与风险动态决定步骤" },
+  { v: "fast", label: "快速：少步骤优先，先做确定性验收" },
+  { v: "expert", label: "专家：完整规划、多评审、失败修复与换将" },
+  { v: "manual", label: "手动：自行指定实现者与评审组" },
+];
+const AUTO_THINKINGS = [
+  { v: "standard", label: "标准：平衡质量与速度" },
+  { v: "auto", label: "自动：随任务难度调整" },
+  { v: "low", label: "快速：少推理、优先响应" },
+  { v: "high", label: "深度：更多推理与检查" },
+];
+
+/* 偏好胶囊：外观与 Composer 同款（透明原生 select 铺满整颗，短名由
+ * syncCmpSelFace 从选中 option 文本截取——语言切换后短名跟着换） */
+function autoPillHtml(id, opts, cur) {
+  return '<span class="cmp-sel"><select id="' + id + '" class="cmp-sel-native" aria-label="' +
+    esc(id === "au-mode" ? t("编排模式") : t("思考程度")) + '">' +
+    opts.map((o) => '<option value="' + o.v + '"' + (o.v === cur ? " selected" : "") +
+      ' data-i18n="' + esc(o.label) + '">' + esc(t(o.label)) + "</option>").join("") +
+    '</select><span class="cmp-sel-face" id="' + id + '-face"></span>' +
+    '<svg class="ico chev" aria-hidden="true"><use href="#i-chevron-r"></use></svg></span>';
+}
+
+/* 对话模型（仅 direct 流程）：复用 Composer 的厂商/模型数据源与重建规则 */
+function renderAuModelPicker(pid, model) {
+  const ps = $("au-direct-provider"), ms = $("au-direct-model-name");
+  if (!ps || !ms) return;
+  const provs = directProviders();
+  const keepP = pid != null ? pid : ps.value;
+  ps.innerHTML = '<option value="">' + t("自动推荐") + "</option>" + provs.map((p) =>
+    '<option value="' + esc(p.id) + '">' + esc(p.name || p.id) + "</option>").join("");
+  ps.value = provs.some((p) => p.id === keepP) ? keepP : "";
+  const fillModels = (keepM) => {
+    const p = provs.find((x) => x.id === ps.value);
+    const names = p ? (p.models || []).filter((m) => !m.hidden)
+      .map((m) => m.name).filter(Boolean) : [];
+    ms.innerHTML = '<option value="">' + t("随厂商推荐") + "</option>" + names.map((name) =>
+      '<option value="' + esc(name) + '">' + esc(name) + "</option>").join("");
+    ms.value = names.includes(keepM) ? keepM : "";
+  };
+  fillModels(model != null ? model : ms.value);
+  // 换厂商 = 旧模型名多半不在新厂商名录里：回「随厂商推荐」，不留悬空值
+  ps.onchange = () => fillModels("");
+}
+
+/* 流程 → 对话模型字段显隐：只有 direct 引擎流程用得上（其余流程模型由系统路由） */
+function autoFormSyncFlow() {
+  const flow = flowById(($("au-flow") || {}).value);
+  const box = $("au-model-field");
+  if (box) box.classList.toggle("hidden", !(flow && flow.engine === "direct"));
 }
 
 /* 类型 → 字段联动：daily/weekly→时间；weekly→星期几；interval→N 小时；once→未来时间 */
@@ -8812,6 +9053,17 @@ async function saveAutoForm(id) {
   if (!prompt) { toast(t("请填写执行内容"), true); return; }
   const kind = $("au-kind").value;
   const payload = { name, prompt, workdir: ($("au-workdir").value || "").trim(), kind, flow: $("au-flow").value };
+  // 运行偏好：与 Composer 同名字段，后端 _apply_run_prefs 再归一一次
+  payload.mode = $("au-mode") ? $("au-mode").value : "";
+  payload.thinking = $("au-thinking") ? $("au-thinking").value : "";
+  if (!$("au-model-field") || !$("au-model-field").classList.contains("hidden")) {
+    payload.direct_provider_id = $("au-direct-provider") ? $("au-direct-provider").value : "";
+    payload.direct_model = $("au-direct-model-name") ? $("au-direct-model-name").value : "";
+    if (payload.direct_model && !payload.direct_provider_id) {
+      toast(t("选择对话模型前请先选厂商"), true);
+      return;
+    }
+  }
   if (kind === "daily" || kind === "weekly") payload.time = $("au-time").value;
   if (kind === "weekly") payload.weekday = parseInt($("au-weekday").value, 10);
   if (kind === "interval") payload.interval_hours = parseInt($("au-interval").value, 10) || 0;
@@ -8931,7 +9183,31 @@ function ztProdChanged(el) {
 
 /* 工作目录「选择…」：复用全局 pickFolder（原生对话框→网页目录弹框回落），回填同一行的输入框 */
 function ztWdPick(btn) {
-  window.pickFolder(btn.closest(".zt-wd-row").querySelector(".zt-p-wd"), true);
+  const inp = btn.closest(".zt-wd-row").querySelector(".zt-p-wd");
+  window.pickFolder(inp, true);
+  // 选完目录顺手拉该仓库的分支清单，基线分支变下拉可选
+  const card = btn.closest(".zt-prof");
+  const side = inp.dataset.side;
+  if (card && side) setTimeout(() => ztRevFill(card, side), 400);
+}
+
+/* 基线分支下拉（datalist）：从仓库工作目录拉本地分支列表。
+ * 复用 /api/git/info（只读探测，仅限本机）；拉不到就保持手填，不报错打扰。 */
+function ztRevFill(card, side, force) {
+  if (!card) return;
+  const wd = (card.querySelector(".zt-p-wd") || {}).value || "";
+  const rev = card.querySelector(".zt-p-rev");
+  const dl = card.querySelector('datalist[data-side="' + side + '"]');
+  if (!rev || !dl) return;
+  if (!wd.trim()) { dl.innerHTML = ""; return; }
+  if (!force && dl.options.length) return;   // 已有清单不重拉
+  api("/api/git/info?workdir=" + encodeURIComponent(wd.trim()))
+    .then((r) => {
+      if (!r || !r.repo) return;
+      dl.innerHTML = (r.branches || []).map((b) =>
+        '<option value="' + esc(b) + '">').join("");
+    })
+    .catch(() => {});
 }
 
 function ztRepoHtml(i, side) {
@@ -8942,7 +9218,10 @@ function ztRepoHtml(i, side) {
   return '<label>' + cn + t("仓库·工作目录") + '</label><span class="zt-wd-row">' +
     '<input class="zt-p-wd" data-side="' + side + '" value="' + esc(repo.workdir || "") + '" placeholder="' + t("空 = 用默认保存路径") + '">' +
     '<button class="ghost small" type="button" title="' + t("浏览本机目录选择") + '" onclick="ztWdPick(this)">' + t("选择…") + "</button></span>" +
-    '<label>' + cn + t("仓库·基线分支") + '</label><input class="zt-p-rev" data-side="' + side + '" value="' + esc(repo.git_rev || "") + '" placeholder="' + t("如 main；空 = 直接改工作目录") + '">' +
+    '<label>' + cn + t("仓库·基线分支") + '</label><span class="zt-wd-row">' +
+    '<input class="zt-p-rev" data-side="' + side + '" list="zt-rev-' + i + '-' + side + '" value="' + esc(repo.git_rev || "") + '" placeholder="' + t("如 main；空 = 直接改工作目录") + '" onfocus="ztRevFill(this.closest(\'.zt-prof\'), \'' + side + '\')">' +
+    '<button class="ghost small" type="button" title="' + t("刷新分支列表") + '" onclick="ztRevFill(this.closest(\'.zt-prof\'), \'' + side + '\', true)">▾</button>' +
+    '<datalist id="zt-rev-' + i + '-' + side + '" data-side="' + side + '"></datalist></span>' +
     '<label>' + cn + t("仓库·验证命令") + '</label><input class="zt-p-verify" data-side="' + side + '" value="' + esc(repo.verify_command || "") + '" placeholder="' + t("如 npm test；空 = 靠评审把关") + '">' +
     '<label>' + cn + t("仓库·一句话描述") + '</label><input class="zt-p-hint" data-side="' + side + '" value="' + esc(hint) + '" placeholder="' + t("给 AI 排查看，如：Vue3 管理台前端") + '">';
 }
@@ -9090,7 +9369,10 @@ async function ztFetchMods(i, silent) {
 
 /* 拉产品/账号清单：产品 ID 变下拉，负责人/转派账号挂 datalist。silent=进页自动拉 */
 async function ztFetchCatalog(silent) {
-  const grab = (url) => api(url, { method: "POST", body: "{}" })
+  // 后台拉清单：静默（不画顶部滑动线、不挂按钮转圈）+ 前端 45s 超时——
+  // 禅道内网不可达时此前会挂住页面加载指示十几二十秒（用户实测反馈）
+  const grab = (url) => api(url, { method: "POST", body: "{}",
+    timeout: 45000, busy: false, silent: true })
     .catch((e) => ({ ok: false, error: e.message }));
   const [pr, ur] = await Promise.all([grab("/api/zentao/products"), grab("/api/zentao/users")]);
   if (pr && pr.ok) S.ztProducts = pr.products || [];
@@ -9111,6 +9393,99 @@ async function ztFetchCatalog(silent) {
   else toast((pr && pr.error) || (ur && ur.error) || t("拉取失败——先「测试连接」确认可用"), true);
 }
 
+/* ---------------------------------------------------------- 钩子（任务生命周期） */
+/* 设置 → 钩子：task_start / message_submit / run_end 三事件挂本机命令。
+ * stdin 收 JSON、stdout 回 {"inject"} 或纯文本即注入；失败超时静默跳过。 */
+function loadHooksPanel() {
+  api("/api/hooks").then((d) => {
+    S.hooks = d.hooks || [];
+    S.hookEvents = d.events || [];
+    renderHooks();
+  }).catch((e) => toast(t("加载失败：") + (e.message || e), true));
+}
+
+function renderHooks() {
+  const box = $("hooks-list"), empty = $("hooks-empty");
+  if (!box) return;
+  const list = S.hooks || [];
+  if (empty) empty.classList.toggle("hidden", list.length > 0);
+  const evLabel = { task_start: t("任务开始"), message_submit: t("消息送达"), run_end: t("运行结束") };
+  box.innerHTML = list.map((h, i) => {
+    return '<div class="card hook-card" data-i="' + i + '">' +
+      '<div class="hook-row">' +
+      '<input class="hook-name" value="' + esc(h.name || "") + '" placeholder="' + esc(t("钩子名称")) + '" data-hf="name">' +
+      '<select class="hook-event" data-hf="event">' +
+      ["task_start", "message_submit", "run_end"].map((ev) =>
+        '<option value="' + ev + '"' + (h.event === ev ? " selected" : "") + ">" +
+        esc(evLabel[ev]) + "</option>").join("") +
+      "</select>" +
+      "</div>" +
+      '<input class="hook-cmd mono" value="' + esc(h.cmd || "") + '" placeholder="' +
+      esc(t('命令：python D:\\proj\\hook.py（stdin 收 JSON，stdout 回 {"inject":"文本"}）')) + '" data-hf="cmd">' +
+      '<div class="hook-row hook-foot">' +
+      '<label class="switch" title="' + esc(t("启用")) + '"><input type="checkbox" data-hf="enabled"' +
+      (h.enabled ? " checked" : "") + '><span></span><em>' + esc(t("启用")) + '</em></label>' +
+      '<span class="hook-foot-lab">' + esc(t("超时（秒）")) + '</span>' +
+      '<input class="hook-timeout" type="number" min="1" max="120" value="' + Number(h.timeout_s || 10) + '" data-hf="timeout_s">' +
+      '<button type="button" class="ghost small" data-hook-test="' + i + '">' + t("测试") + "</button>" +
+      '<button type="button" class="ghost small" onclick="removeHook(' + i + ')">' + t("删除") + "</button>" +
+      '<span class="hint hook-test-out"></span>' +
+      "</div></div>";
+  }).join("");
+}
+
+window.removeHook = function (i) {
+  (S.hooks || []).splice(i, 1);
+  renderHooks();
+};
+
+function hookHarvest() {
+  return Array.from(document.querySelectorAll("#hooks-list .hook-card")).map((card) => {
+    const gv = (f) => card.querySelector('[data-hf="' + f + '"]');
+    return { id: (S.hooks || [])[Number(card.dataset.i)]?.id || "",
+      name: gv("name").value.trim(), event: gv("event").value,
+      cmd: gv("cmd").value.trim(), enabled: gv("enabled").checked,
+      timeout_s: Number(gv("timeout_s").value || 10) };
+  });
+}
+
+function bindHooksPanel() {
+  if ($("btn-hooks-add").dataset.bound) return;
+  $("btn-hooks-add").dataset.bound = "1";
+  $("btn-hooks-add").addEventListener("click", () => {
+    S.hooks = S.hooks || [];
+    S.hooks.push({ id: "hk-" + Date.now(), name: "", event: "task_start",
+      cmd: "", enabled: true, timeout_s: 10 });
+    renderHooks();
+  });
+  $("btn-hooks-save").addEventListener("click", async () => {
+    try {
+      const r = await api("/api/hooks/save", { method: "POST",
+        body: JSON.stringify({ hooks: hookHarvest() }) });
+      S.hooks = r.hooks || [];
+      renderHooks();
+      toast(t("钩子已保存"));
+    } catch (e) { toast(t("保存失败：") + (e.message || e), true); }
+  });
+  $("hooks-list").addEventListener("click", async (e) => {
+    const btn = e.target.closest("[data-hook-test]");
+    if (!btn) return;
+    const card = btn.closest(".hook-card");
+    const gv = (f) => card.querySelector('[data-hf="' + f + '"]');
+    const out = card.querySelector(".hook-test-out");
+    btn.disabled = true;
+    out.textContent = t("运行中…");
+    try {
+      const r = await api("/api/hooks/test", { method: "POST",
+        body: JSON.stringify({ cmd: gv("cmd").value.trim(), event: gv("event").value,
+          timeout_s: Number(gv("timeout_s").value || 10) }) });
+      out.textContent = (r.ok ? "✓ " : "✗ ") + String(r.output || "").slice(0, 120);
+    } catch (e2) { out.textContent = "✗ " + (e2.message || e2); }
+    btn.disabled = false;
+  });
+}
+bindHooksPanel();
+
 /* ---- 状态行 / 修复记录 ---- */
 
 function zentaoStateTag(st) {
@@ -10333,13 +10708,29 @@ async function suStartupCheck() {
 }
 
 /* ---------------------------------------------------------- 页签 & 初始化 */
-const TAB_TITLES = { tasks: "任务", runs: "运行记录", automation: "自动化", zentao: "禅道 Bug 自动修复", __wxdigest: "群摘要", usage: "用量统计", agents: "本机智能体", models: "模型接入", bindings: "模型调度（可选）", skills: "经验库", knowledge: "知识库", market: "插件市场", orch: "编排设置", data: "数据与备份", appearance: "皮肤", about: "关于与更新" };
-const SET_TABS = new Set(Object.keys(TAB_TITLES));   // 设置导航里的子页（__phone 是弹框，不算）
+const TAB_TITLES = { overview: "概览", tasks: "任务", runs: "运行记录", automation: "自动化", zentao: "禅道 Bug 自动修复", __wxdigest: "群摘要", usage: "用量统计", agents: "本机智能体", models: "模型接入", bindings: "模型调度（可选）", skills: "经验库", knowledge: "知识库", market: "插件市场", orch: "编排设置", data: "数据与备份", appearance: "皮肤", about: "关于与更新" };
+const SET_TABS = new Set(Object.keys(TAB_TITLES));   // 全部设置子页（__phone 是弹框，不算）
 
 function tabTitle(name) {
   return t(TAB_TITLES[name]) || t("设置");
 }
 
+/* 左栏两套导航各管哪些页，一律从 index.html 现读——HTML 改了 JS 自动跟上，
+ * 不再各存一份常量、两处漂移：
+ *   .side-quick    快捷导航（概览/运行记录/自动化）→ main 形态：只换主栏内容，左栏任务树不动
+ *   .side-settings 设置导航                        → settings 形态：左栏整体换成设置导航
+ * 同一个页只应挂在其中一边（重复挂就是两处入口）。 */
+function mainPageSubs() {
+  const s = new Set();
+  document.querySelectorAll(".side-quick .qitem").forEach((b) => { if (b.dataset.page) s.add(b.dataset.page); });
+  return s;
+}
+function settingsNavSubs() {
+  const s = new Set();
+  document.querySelectorAll(".side-settings .set-item").forEach((b) => { if (b.dataset.sub) s.add(b.dataset.sub); });
+  return s;
+}
+
 
 
 /* ---------------------------------------------------------- 用量统计 */
@@ -10516,12 +10907,57 @@ function setLangBtn(lang) {
   }
 }
 
-/* 卡片标签：图标 + 名称（图标用精灵表，stroke=currentColor 自动跟随主题） */
-function kpiCard(label, value, sub, wide, icon) {
-  const ico = icon ? '<svg class="ico" aria-hidden="true"><use href="#' + icon + '"></use></svg>' : "";
-  return '<div class="kpi' + (wide ? " wide" : "") + '"><div class="kpi-v">' + value +
-    '</div><div class="kpi-l">' + ico + esc(label) + "</div>" +
-    (sub ? '<div class="kpi-s">' + esc(sub) + "</div>" : "") + "</div>";
+/* KPI 卡：图标块 + 环比徽章 + 数值 + 标签 + 副行 + 迷你走势图。
+ * opts 全部可选；不传时回落成旧版布局（图标内联在标签行），老调用点无需改动。
+ *   tone:  图标块/走势图色相（accent|ok|warn|bad|calm）
+ *   delta: { pct:Number, invert?:true } 环比；invert 给花钱类指标（涨了显示告警色）
+ *   spark: [Number,...] 迷你走势序列 */
+function kpiCard(label, value, sub, wide, icon, opts) {
+  opts = opts || {};
+  const tone = opts.tone || "accent";
+  const ico = icon ? '<span class="kpi-ico t-' + esc(tone) + '">' +
+    '<svg class="ico" aria-hidden="true"><use href="#' + esc(icon) + '"></use></svg></span>' : "";
+  const delta = kpiDelta(opts.delta);
+  const top = (ico || delta) ? '<div class="kpi-top">' + ico + delta + "</div>" : "";
+  const spark = (opts.spark && opts.spark.length > 1)
+    ? '<div class="kpi-spark">' + kpiSparkSvg(opts.spark, tone) + "</div>" : "";
+  return '<div class="kpi' + (wide ? " wide" : "") + (top ? " has-top" : "") +
+    (spark ? " has-spark" : "") + '">' + top +
+    '<div class="kpi-v">' + value + "</div>" +
+    '<div class="kpi-l">' + (top ? "" : ico) + esc(label) + "</div>" +
+    (sub ? '<div class="kpi-s">' + esc(sub) + "</div>" : "") + spark + "</div>";
+}
+
+/* 环比徽章：涨跌用颜色区分，不用箭头字符（几何字形跨平台宽度不一）。 
+ * 花钱类指标要 invert——费用涨 20% 不是好事，不能标绿。 */
+function kpiDelta(d) {
+  if (!d || typeof d.pct !== "number" || !isFinite(d.pct)) return "";
+  const pct = d.pct;
+  const flat = Math.abs(pct) < 0.05;
+  const dir = flat ? "flat" : (pct > 0 ? "up" : "down");
+  const happy = d.invert ? (dir === "down") : (dir === "up");
+  const cls = flat ? "flat" : (happy ? "good" : "bad");
+  const sign = pct > 0 ? "+" : "";
+  return '<span class="kpi-delta ' + cls + '" title="' +
+    esc(t("与上一个同长周期相比")) + '">' + esc(t("较上期")) + " " +
+    esc(sign + pct.toFixed(1) + "%") + "</span>";
+}
+
+/* 迷你走势图：折线 + 面积。preserveAspectRatio=none 让图随卡宽拉伸，
+ * 折线靠 vector-effect 保住描边不被横向拉粗。 */
+function kpiSparkSvg(vals, tone) {
+  const w = 88, h = 26, n = vals.length;
+  const max = Math.max.apply(null, vals), min = Math.min.apply(null, vals);
+  const span = Math.max(1, max - min);
+  const px = (i) => (n <= 1 ? w : i * w / (n - 1));
+  const py = (v) => h - 3 - (v - min) * (h - 8) / span;
+  const line = vals.map((v, i) => px(i).toFixed(1) + "," + py(v).toFixed(1)).join(" ");
+  const area = "0," + h + " " + line + " " + w + "," + h;
+  return '<svg class="kspark t-' + esc(tone) + '" viewBox="0 0 ' + w + " " + h +
+    '" preserveAspectRatio="none" aria-hidden="true" focusable="false">' +
+    '<polygon class="ks-area" points="' + area + '"></polygon>' +
+    '<polyline class="ks-line" points="' + line +
+    '" vector-effect="non-scaling-stroke"></polyline></svg>';
 }
 
 /* 单日没有趋势可言，一根孤柱悬在空白里很难看：改画全宽的
@@ -10875,20 +11311,28 @@ function renderUsage() {
   // 回填记录只有总量、没有输入/输出细分：细分全为 0 时说明当前范围只有历史数据，
   // 不提示的话「输入 0 · 输出 0」会被误读成统计坏了
   const noBreakdown = tot.tokens > 0 && !tot.input && !tot.output && !tot.cached;
+  // 迷你走势取范围内逐日真值（by_day 已连续补零）；单日范围只有一格，kpiCard 自动不出图。
+  // 用量页不做环比：范围由用户任选（含「全部」），没有等长上一期可比，硬算会是假数。
+  const dayTok = (u.by_day || []).map((d) => d.tokens || 0);
+  const dayDur = (u.by_day || []).map((d) => d.duration_s || 0);
   $("usage-kpis").innerHTML = [
     kpiCard(t("累计 Token 数"), fmtTok(tot.tokens),
       t("调用 ") + fmtTok(tot.calls) + t(" 次 · 成功率 ") +
       (tot.calls ? Math.round(tot.ok * 100 / tot.calls) : 0) + "% · " +
       t("失败 ") + fmtTok(tot.failed || 0) + t(" · ") + fmtUsd(tot.cost_usd),
-      true, "i-sigma"),
+      true, "i-sigma", { tone: "accent", spark: dayTok }),
     kpiCard(t("峰值 Token 数"), fmtTok(tot.peak_tokens),
-      t("单日最高 · 日均 ") + fmtTok(activeDays ? tot.tokens / activeDays : 0), false, "i-gauge"),
+      t("单日最高 · 日均 ") + fmtTok(activeDays ? tot.tokens / activeDays : 0),
+      false, "i-gauge", { tone: "warn" }),
     kpiCard(t("最长单次时长"), fmtDur(tot.max_duration_s),
-      t("累计调用 ") + fmtDur(tot.duration_s), false, "i-history"),
+      t("累计调用 ") + fmtDur(tot.duration_s), false, "i-history",
+      { tone: "calm", spark: dayDur }),
     kpiCard(t("当前连续天数"), fmtTok(tot.streak_current) + t(" 天"),
-      t("范围内活跃 ") + fmtTok(activeDays) + t(" 天"), false, "i-calendar-days"),
+      t("范围内活跃 ") + fmtTok(activeDays) + t(" 天"), false, "i-calendar-days",
+      { tone: "ok" }),
     kpiCard(t("最长连续天数"), fmtTok(tot.streak_longest) + t(" 天"),
-      t("缓存命中率 ") + (tot.cache_rate || 0) + "%", false, "i-calendar-days"),
+      t("缓存命中率 ") + (tot.cache_rate || 0) + "%", false, "i-calendar-days",
+      { tone: "ok" }),
   ].join("");
   const note = $("usage-note");
   if (note) {
@@ -10912,6 +11356,213 @@ function renderUsage() {
 
 
 
+/* ---------------------------------------------------------- 概览首页 */
+/* 数据全部来自真实台账与运行记录，没有任何占位假数：
+ *   - /api/usage?days=60 一次拿两期：by_day 是连续补零的日序列，前 30 天=上期、
+ *     后 30 天=本期，环比在本地对半切算出来，不额外发请求、不加后端端点；
+ *   - 最近运行取 S.state.runs（SSE 推送，天然实时，不需要自己轮询）。
+ * 周期固定 60 天而不是可调：环比必须有等长的上一期，做成可选范围就得再拉一次。 */
+const OV_PERIOD = 30;               // 一期长度（上期 / 本期各 30 天）
+const OV_DAYS_KEY = "orch.ovDays";  // 趋势图范围（7 / 30），与用量页的范围各自独立
+let _ovSeq = 0;                     // 请求序号：重入/切走时丢弃过期响应
+
+function ovDays() {
+  if (S.ovDays === undefined || S.ovDays === null || S.ovDays === "") {
+    let saved = null;
+    try { saved = localStorage.getItem(OV_DAYS_KEY); } catch (e) { /* 隐私模式忽略 */ }
+    S.ovDays = Number(saved) === 30 ? 30 : 7;
+  }
+  return S.ovDays === 30 ? 30 : 7;
+}
+
+function setOvDays(n) {
+  S.ovDays = Number(n) === 30 ? 30 : 7;
+  try { localStorage.setItem(OV_DAYS_KEY, String(S.ovDays)); } catch (e) { /* 隐私模式忽略 */ }
+  syncOvRanges();
+  renderOverviewTrend();
+}
+
+function syncOvRanges() {
+  const cur = ovDays();
+  document.querySelectorAll("#ov-ranges [data-days]").forEach((b) =>
+    b.classList.toggle("active", Number(b.dataset.days) === cur));
+}
+
+async function loadOverview() {
+  const seq = ++_ovSeq;
+  const kp = $("ov-kpis");
+  if (kp) kp.innerHTML = '<p class="hint">' + t("加载中…") + "</p>";
+  try {
+    const u = await api("/api/usage?days=" + (OV_PERIOD * 2));
+    if (seq !== _ovSeq) return;      // 期间已切走/重入：过期响应不落盘
+    S.ovUsage = u;
+  } catch (e) {
+    if (seq !== _ovSeq) return;
+    S.ovUsage = null;
+  }
+  renderOverview();
+}
+
+/* 日序列对半切：前一半=上期，后一半=本期。服务刚装不久、总天数不足两期时
+ * 上期为空数组，环比自然不显示（而不是拿不足一期的数据硬算出一个假百分比）。 */
+function ovSplit(byDay) {
+  const days = byDay || [];
+  const cut = Math.max(0, days.length - OV_PERIOD);
+  return { prev: days.slice(0, cut), cur: days.slice(cut) };
+}
+
+function ovSum(rows, k) {
+  return (rows || []).reduce((s, r) => s + (Number(r[k]) || 0), 0);
+}
+
+/* 环比：上期为 0 时不显示——除零得到 Infinity，硬算出来是假数 */
+function ovDelta(cur, prev, invert) {
+  if (!prev) return null;
+  return { pct: (cur - prev) * 100 / prev, invert: !!invert };
+}
+
+/* 日期眉标：跟随界面语言排版（en 走 en-US），拿不到就回落空串不阻塞渲染 */
+function ovDateText() {
+  try {
+    return new Date().toLocaleDateString(getLang() === "en" ? "en-US" : "zh-CN",
+      { weekday: "long", month: "long", day: "numeric" });
+  } catch (e) { return ""; }
+}
+
+function renderOverview() {
+  ovRenderHead();
+  ovRenderKpis();
+  syncOvRanges();
+  renderOverviewTrend();
+  ovRenderQuick();
+  ovRenderRecent();
+}
+
+function ovRenderHead() {
+  const dateEl = $("ov-date");
+  if (dateEl) dateEl.textContent = ovDateText();
+  const sub = $("ov-sub");
+  if (!sub) return;
+  const u = S.ovUsage;
+  if (!u || !u.totals) { sub.textContent = ""; return; }
+  const cur = ovSplit(u.by_day).cur;
+  const calls = ovSum(cur, "calls"), ok = ovSum(cur, "ok");
+  const rate = calls ? Math.round(ok * 100 / calls) : 0;
+  let s = t("近 30 天执行 ") + fmtTok(calls) + t(" 次 · 成功率 ") + rate + "%" +
+    t(" · 消耗 ") + fmtTok(ovSum(cur, "tokens")) + t(" tokens · 费用 ") + fmtUsd(ovSum(cur, "cost_usd"));
+  const running = ((S.state && S.state.runs) || []).filter((r) => r.status === "running").length;
+  if (running) s += t(" · 当前 ") + running + t(" 个任务运行中");
+  sub.textContent = s;
+}
+
+function ovRenderKpis() {
+  const box = $("ov-kpis");
+  if (!box) return;
+  const u = S.ovUsage;
+  if (!u || !u.totals) {
+    box.innerHTML = '<p class="hint">' + t("暂无用量记录。跑一个任务后这里会出现统计。") + "</p>";
+    return;
+  }
+  const { prev, cur } = ovSplit(u.by_day);
+  const C = { calls: ovSum(cur, "calls"), ok: ovSum(cur, "ok"),
+    tok: ovSum(cur, "tokens"), cost: ovSum(cur, "cost_usd") };
+  const P = { calls: ovSum(prev, "calls"), ok: ovSum(prev, "ok"),
+    tok: ovSum(prev, "tokens"), cost: ovSum(prev, "cost_usd") };
+  const cRate = C.calls ? C.ok * 100 / C.calls : 0;
+  const pRate = P.calls ? P.ok * 100 / P.calls : 0;
+  // 两个「日均」按真实活跃天数算：刚装不久只跑了 3 天，除以 30 会得到一个
+  // 看着像「用量很低」的假平均值
+  const activeDays = Math.max(1, cur.filter((d) => (d.calls || 0) > 0).length);
+  box.innerHTML = [
+    kpiCard(t("执行次数"), fmtTok(C.calls),
+      t("成功 ") + fmtTok(C.ok) + t(" · 失败 ") + fmtTok(Math.max(0, C.calls - C.ok)),
+      false, "i-tasks",
+      { tone: "accent", delta: ovDelta(C.calls, P.calls),
+        spark: cur.map((d) => d.calls || 0) }),
+    // 成功率环比给「百分点差」：98.7% 比 96.3% 高 2.4 个点，写成 (+2.4/96.3)=+2.5%
+    // 反而绕；kpiDelta 输出的 +X.X% 在这里就是百分点，读起来是对的
+    kpiCard(t("成功率"), C.calls ? cRate.toFixed(1) + "%" : "—",
+      t("上期 ") + (P.calls ? pRate.toFixed(1) + "%" : "—"),
+      false, "i-clip-check",
+      { tone: "ok", delta: (P.calls && C.calls) ? { pct: cRate - pRate } : null,
+        spark: cur.map((d) => ((d.calls || 0) ? (d.ok || 0) * 100 / d.calls : 0)) }),
+    kpiCard(t("Token 消耗"), fmtTok(C.tok),
+      t("日均 ") + fmtTok(C.tok / activeDays),
+      false, "i-sigma",
+      { tone: "calm", delta: ovDelta(C.tok, P.tok),
+        spark: cur.map((d) => d.tokens || 0) }),
+    kpiCard(t("费用"), fmtUsd(C.cost),
+      t("日均 ") + fmtUsd(C.cost / activeDays),
+      false, "i-coin",
+      { tone: "warn", delta: ovDelta(C.cost, P.cost, true),
+        spark: cur.map((d) => d.cost_usd || 0) }),
+  ].join("");
+}
+
+/* 趋势复用用量页同一套折线（Top5 模型 + 其他），只是把日序列截到所选范围 */
+function renderOverviewTrend() {
+  const box = $("ov-trend-body");
+  if (!box) return;
+  const u = S.ovUsage;
+  if (!u || !u.by_day || !u.by_day.length) {
+    box.innerHTML = '<p class="hint">' + t("（暂无数据）") + "</p>";
+    return;
+  }
+  const byDay = u.by_day.slice(-ovDays());
+  const modelOfDay = {};
+  (u.by_day_model || []).forEach((d) => { modelOfDay[d.day] = d.models || {}; });
+  box.innerHTML = usageMultilineSvg(byDay,
+    byDay.map((d) => ({ day: d.day, models: modelOfDay[d.day] || {} })));
+}
+
+function ovRenderQuick() {
+  const box = $("ov-quick-body");
+  if (!box) return;
+  const items = [
+    { key: "tasks", icon: "i-plus", label: t("新建任务"), sub: t("描述目标，交给智能体执行") },
+    { key: "knowledge", icon: "i-sigma", label: t("知识库"), sub: t("项目资料与沉淀") },
+    { key: "market", icon: "i-blocks", label: t("插件市场"), sub: t("装技能扩展能力") },
+    { key: "automation", icon: "i-calendar-days", label: t("自动化"), sub: t("定时与周期执行") },
+  ];
+  box.innerHTML = items.map((it) =>
+    '<button class="ov-q" type="button" onclick="switchTab(\'' + it.key + '\')">' +
+    '<span class="ov-q-ico"><svg class="ico" aria-hidden="true"><use href="#' + it.icon + '"></use></svg></span>' +
+    '<span class="ov-q-text"><b>' + esc(it.label) + "</b><i>" + esc(it.sub) + "</i></span>" +
+    '<span class="ov-q-go" aria-hidden="true"><svg class="ico" aria-hidden="true"><use href="#i-arrow-up"></use></svg></span>' +
+    "</button>").join("");
+}
+
+/* 最近运行：状态点复用侧栏那套字形（staskGlyph），行样式照参考站的
+ * 「图标 + 主副标题 + 右侧状态与相对时间」。点击走 jumpToRun——
+ * 它会先切到运行记录页再开详情；在概览页直接 openRun 会把详情开在错的分区上。 */
+function ovRenderRecent() {
+  const box = $("ov-recent-body");
+  if (!box) return;
+  const runs = ((S.state && S.state.runs) || []).slice(0, 5);
+  if (!runs.length) { box.innerHTML = '<div class="empty">' + t("暂无运行记录") + "</div>"; return; }
+  box.innerHTML = runs.map((r) => {
+    const st = String(r.status || "");
+    const sub = String(r.summary || r.error || "").trim();
+    return '<button class="ov-run" type="button" onclick="jumpToRun(\'' + esc(r.id) + '\')">' +
+      '<span class="ov-run-ico">' + staskGlyph(st) + "</span>" +
+      '<span class="ov-run-main"><b>' + esc(r.title || "") + "</b>" +
+      (sub ? "<i>" + esc(sub.length > 90 ? sub.slice(0, 89) + "…" : sub) + "</i>" : "") +
+      "</span>" +
+      '<span class="ov-run-meta">' +
+      '<span class="chip ' + esc(st) + '">' + esc(runStatusText(r)) + "</span>" +
+      '<span class="ov-run-time">' + esc(relTime(r.created_at)) + "</span>" +
+      "</span></button>";
+  }).join("");
+}
+
+/* 运行状态经 SSE 推来：停在概览页时只重画依赖 runs 的两处（概览语 + 最近运行），
+ * 不重新拉用量（台账不会因为一次运行状态变化就变） */
+function ovMaybeRefresh() {
+  if (S.tab !== "overview") return;
+  ovRenderHead();
+  ovRenderRecent();
+}
+
 /* ---------------------------------------------------------- 手机连接（扫码） */
 /* ZCode 桌面端式样：大二维码居中，地址+复制在下方；多来源（Tailscale/局域网）用 chips 切换 */
 async function openPhoneConnect() {
@@ -11169,16 +11820,23 @@ function collapseDrawerIfMobile() {
   if (window.innerWidth < 900) document.body.classList.add("side-collapsed");
 }
 
-function switchTab(name) {
+/* 切页：主栏换成目标子页。shell 决定左栏形态——"main" 保持任务树、"settings" 换成
+ * 设置导航，缺省按目标页归哪套导航自动选（见 mainPageSubs/settingsNavSubs）。 */
+function switchTab(name, shell) {
   if (name === "__phone") { openPhoneConnect(); return; }  // 手机连接是弹框，不切页
   if (name === "__guide") { welcomeOpen(); return; }       // 帮助中心是弹层，不切页（设置导航「软件」组）
-  // 导航收进「设置」：进设置后左栏整体换成设置导航，内容铺满
+  // 形态由目标页决定：快捷导航页（概览/运行记录/自动化）走 main——只换主栏内容、
+  // 左栏任务树原地不动；其余页进设置导航。调用方可用 shell 显式覆盖（如已在设置里
+  // 点运行详情，仍要留在设置侧栏）。用户主动进设置时左栏一定会换成设置导航。
+  const inMain = (shell || (mainPageSubs().has(name) ? "main" : "settings")) === "main";
   S.tab = name;
-  if (SET_TABS.has(name)) localStorage.setItem("orch.setTab", name);
-  document.body.classList.add("settings-mode");
-  document.body.classList.remove("files-mode");   // 文件浏览页与设置导航互斥，别叠在左栏
+  S.mainPage = inMain ? name : "";   // 主栏停在哪个全局页；closeRun 靠它回到点开详情前那一页
+  if (settingsNavSubs().has(name)) localStorage.setItem("orch.setTab", name);
+  document.body.classList.toggle("settings-mode", !inMain);
+  document.body.classList.remove("files-mode");   // 文件浏览页与两套导航都互斥，别叠在左栏
   document.querySelectorAll(".page").forEach((p) => p.classList.toggle("hidden", p.id !== "page-settings"));
-  document.querySelectorAll(".set-item").forEach((b) => b.classList.toggle("active", b.dataset.sub === name));
+  document.querySelectorAll(".set-item").forEach((b) => b.classList.toggle("active", !inMain && b.dataset.sub === name));
+  document.querySelectorAll(".qitem").forEach((b) => b.classList.toggle("active", inMain && b.dataset.page === name));
   document.querySelectorAll("#page-settings .subpage").forEach((d) => d.classList.toggle("hidden", d.id !== "sub-" + name));
   const title = $("page-title");
   if (title) title.textContent = tabTitle(name);
@@ -11189,11 +11847,13 @@ function switchTab(name) {
   if (name === "knowledge") loadKnowledge();   // 进知识库页拉取条目
   if (name === "automation") { loadAutomation(); startAutoPoll(); }   // 进自动化页：拉取 + 页面可见时每 8s 轮询
   else stopAutoPoll();   // 离开自动化页（或切到别的子页）即停表
+  if (name === "hooks") loadHooksPanel();   // 进钩子页：拉配置渲染管理列表
   if (name === "zentao") loadZentao();   // 进禅道页：拉配置与修复记录回填表单
   if (name === "__wxdigest") { beeRefresh(); beeMarkSeen(); }   // 进群摘要页：拉取视图并清未读
   if (name === "market") loadMarket();   // 进插件市场页拉取目录
   if (name === "data") loadDataPage();   // 进数据与备份页：清理配置/状态/可清理预估
   if (name === "usage") { syncUsageRange(); loadUsage(); }   // 进用量页：对齐范围选中态并拉取
+  if (name === "overview") { ovDays(); loadOverview(); }   // 进概览页：对齐趋势范围并拉两期台账
   if (name === "appearance") renderAppearance();   // 进皮肤页：按当前皮肤/明暗重画卡片
   if (name === "appearance") renderCodeSettings();  // 代码设置行 + 双主题预览卡同步当前值
   if (name === "about") loadSelfupdate(false);     // 进关于页：拉版本与更新状态
@@ -11201,13 +11861,15 @@ function switchTab(name) {
   syncInspectorVis();    // 检查器只属于任务上下文：进设置子页自动收起
 }
 
-/* 退出设置：左栏恢复任务树，内容回到任务页 */
+/* 退出设置/回到新建任务表单：左栏恢复任务树，主栏回到任务页 */
 function exitSettings() {
   S.tab = "tasks";
+  S.mainPage = "";   // 主栏回到表单：不再是快捷导航页
   stopAutoPoll();   // 离开设置视图：自动化页轮询一并停掉
   document.querySelectorAll(".page").forEach((p) => p.classList.toggle("hidden", p.id !== "page-settings"));
   document.querySelectorAll("#page-settings .subpage").forEach((d) => d.classList.toggle("hidden", d.id !== "sub-tasks"));
   document.querySelectorAll(".set-item").forEach((b) => b.classList.toggle("active", b.dataset.sub === "tasks"));
+  document.querySelectorAll(".qitem").forEach((b) => b.classList.remove("active"));
   document.body.classList.remove("settings-mode");
   document.body.classList.remove("files-mode");
   cmpGreeting();   // 回到任务页：问候语刷新
@@ -11217,10 +11879,12 @@ function exitSettings() {
   syncInspectorVis();    // 回到新建表单：不是任务上下文，检查器收起（点运行详情才会滑回）
 }
 
-/* 侧栏底部齿轮：直接进设置（左栏换成设置导航，不再弹菜单）。回到上次看的那页，默认编排设置 */
+/* 侧栏底部齿轮：直接进设置（左栏换成设置导航，不再弹菜单）。回到上次看的那页，默认编排设置。
+ * 只认设置导航里真实存在的子页——概览/运行记录/自动化已升为快捷导航，落回它们会停在
+ * 一个没有导航项高亮的设置页。 */
 function enterSettings() {
   const saved = localStorage.getItem("orch.setTab") || "";
-  switchTab(SET_TABS.has(saved) ? saved : "orch");
+  switchTab(settingsNavSubs().has(saved) ? saved : "orch", "settings");
 }
 
 window.openRun = openRun;
@@ -11247,6 +11911,8 @@ window.bindPromote = bindPromote;
 window.mgmt = mgmt;
 window.switchTab = switchTab;
 window.setUsageDays = setUsageDays;
+window.setOvDays = setOvDays;
+window.jumpToRun = jumpToRun;
 window.saveProvider = saveProvider;
 window.delProvider = delProvider;
 window.openAddProviderDialog = openAddProviderDialog;
@@ -11567,9 +12233,11 @@ document.addEventListener("DOMContentLoaded", () => {
     if (e.target.closest("button, summary, .stask")) collapseDrawerIfMobile();
   });
   $("btn-new-task").addEventListener("click", exitSettings);
-  // 主侧栏快捷入口：直达自动化 / 插件市场（switchTab 自己会切设置模式并挂载页面）
-  $("btn-q-automation").addEventListener("click", () => switchTab("automation"));
-  $("btn-q-market").addEventListener("click", () => switchTab("market"));
+  // 侧栏快捷导航：主栏换成目标页，左栏任务树不动（shell="main"）。
+  // 页面清单以 index.html .side-quick 的 data-page 为准，这里逐项绑 id。
+  $("btn-q-overview").addEventListener("click", () => switchTab("overview", "main"));
+  $("btn-q-runs").addEventListener("click", () => switchTab("runs", "main"));
+  $("btn-q-automation").addEventListener("click", () => switchTab("automation", "main"));
   bindCtxMenus();
   bindInspector();
   if (window.innerWidth < 900) document.body.classList.add("side-collapsed");