codebee 0.1.15 → 0.1.17

package/app/ui/app.js

@@ -412,7 +412,7 @@ function runStatusText(run) {
   if (st === "queued" && run && run.resume_enqueue_at) {
     const at = Date.parse(String(run.resume_enqueue_at).replace(" ", "T"));
     if (!isNaN(at) && Date.now() < at)
-      return t("将于 ") + String(run.resume_enqueue_at).slice(11, 16) + t(" 自动续跑");
+      return t("将于 {0} 自动续跑", String(run.resume_enqueue_at).slice(11, 16));
   }
   return { queued: t("排队中"), running: t("运行中"), done: t("完成"),
     failed: t("失败"), cancelled: t("已取消"), timeout: t("超时") }[st] || st;
@@ -822,6 +822,11 @@ function renderBindings() {
   if (sig === S.bindSig) return;
   S.bindSig = sig;
   syncSaveAllBtn();
+  if (!targets.length) {
+    bbox.innerHTML = '<div class="empty">' + t("还没有装好的 CLI 智能体（codex / claude / kimi 等）。") +
+      '<a href="#" onclick="return helpOpenTopic(\'quickstart\')">' + t("看看快速上手") + '</a></div>';
+    return;
+  }
   bbox.innerHTML = targets.map((c) => {
     const b = (S.bindings || {})[c.id] || {};
     const opts = '<option value="">' + t("不绑定（用 CLI 自身的凭据与配置）") + '</option>' + bindable.map((p) => {
@@ -900,6 +905,7 @@ function renderProvList() {
       '<div class="pi-body"><div class="pi-top"><div class="pi-name">' + esc(p.name) + "</div>" +
       '<span class="pi-n">' + st + "</span></div>" +
       '<div class="pi-meta"><span class="tag">' + esc(protoLabel(p)) + "</span>" +
+      (p.protocol === "auto" ? "" : wireCapTags(p, p.protocol)) +
       ((p.keys || []).length > 1 ? '<span class="tag">' + t("%1 把密钥").replace("%1", (p.keys || []).length) + "</span>" : "") +
       (off ? '<span class="tag">' + t("已停用") + "</span>" : "") +
       "</div></div></div>";
@@ -970,17 +976,18 @@ function renderProvDetail() {
   const p = (S.providers || []).find((x) => x.id === S.selProv);
   if (!p) {
     box.innerHTML = '<div class="empty">' + t("左侧选择供应商；还没有供应商时点左上角「导入」，") +
-      t("可从 CCSwitch / Codex / Claude Code / ZCode / Qwen / Gemini / OpenCode / Continue / Cursor / Trae 扫描带入。") + '</div>';
+      t("可从 CCSwitch / Codex / Claude Code / ZCode / Qwen / Gemini / OpenCode / Continue / Cursor / Trae 扫描带入。") +
+      '<br><a href="#" onclick="return helpOpenTopic(\'models\')">' + t("还没配过模型？看「模型接入与绑定」帮助") + '</a></div>';
     return;
   }
   const tp = (S.testProvState || {})[p.id];
   const tpHtml = tp ? (tp.ok
-    ? '<span class="badge ok">' + t("✓ 连通 ") + tp.latency_ms + "ms · " + tp.count + t(" 个模型") + "</span>"
+    ? '<span class="badge ok"' + (tp.note ? ' title="' + esc(tp.note) + '"' : "") + '>' +
+      t("✓ 连通 ") + tp.latency_ms + "ms" +
+      (tp.note ? " · " + t("无模型列表接口") : " · " + tp.count + t(" 个模型")) + "</span>"
     : '<span class="badge bad" title="' + esc(tp.error || "") + '">✗ ' + esc((tp.error || t("失败")).slice(0, 60)) + "</span>") : "";
-  // 适配测试通过的 wire（同密钥实测可注入的另一条协议面）
-  const capTags = Object.entries(p.wire_caps || {}).map(([pr, cap]) =>
-    '<span class="tag ok" title="' + esc(t("适配测试通过：同密钥实测支持该协议注入") +
-      (cap.checked_at ? " · " + cap.checked_at : "")) + '">' + esc(pr) + " ✓</span>").join("");
+  // 适配测试通过的 wire（同密钥实测可注入的另一条协议面）；形态随徽章标出
+  const capTags = wireCapTags(p, "");
   const pb = (S.probeState || {})[p.id];
   const pbHtml = !pb ? "" : (pb.busy
     ? '<span class="badge">' + esc(t("适配测试中…")) + "</span>"
@@ -1161,6 +1168,24 @@ async function duplicateProvider(pid) {
   poll();
 }
 
+/* 多 wire 网关的「另一条协议面」徽章：适配测试实测通过、又不是当前分组的 wire。
+ * 同一份模型列表在两条 wire 上都能注入（解析走适配端点），列表不重复摆两份，
+ * 但得把另一面亮出来——否则页面看上去只有一种协议能用，OpenAI 面永远被忽略。
+ * 形态必须标出：chat 形态除 codex 外都能用（codex 0.154+ 只讲 responses），
+ * 不标的话模型接入页一片 ✓、codex 链上却 ⚠ 协议不匹配，两个页面自相矛盾。 */
+function wireCapTags(p, excludeProto) {
+  return Object.keys((p || {}).wire_caps || {}).filter((pr) => pr !== excludeProto).map((pr) => {
+    const cap = (p.wire_caps || {})[pr] || {};
+    const chat = (cap.wire_api || "responses") === "chat";
+    const tip = (chat
+      ? t("适配测试实测：该面为 chat 形态——除 codex 外的 openai 系 CLI 可用；codex 只讲 responses，链上注入会被跳过")
+      : t("适配测试实测：同密钥也可走 {0} wire——这组模型同样可注入 {0} 系 CLI（codex/dsh 等），运行时自动走适配端点", pr)) +
+      (cap.checked_at ? " · " + cap.checked_at : "");
+    return '<span class="tag ok" title="' + esc(tip) + '">' +
+      esc(pr) + " ✓" + (chat ? " · chat" : "") + "</span>";
+  }).join("");
+}
+
 /* 模型分组区 HTML（全量重绘与过滤重绘共用；过滤时暂停拖拽排序） */
 function provModelGroupsHtml(p) {
   const kw = ((S.modelFilter || {})[p.id] || "").trim().toLowerCase();
@@ -1187,6 +1212,7 @@ function provModelGroupsHtml(p) {
       '<label class="pcheck-all"><input type="checkbox"' + (allSel ? " checked" : "") +
       ' onchange="toggleGroupSel(\'' + esc(p.id) + '\', \'' + esc(g) + '\', this.checked)">' + t("全选") + '</label>' +
       esc(g) + t(" 协议 · ") + gm.length + t(" 个") +
+      wireCapTags(p, g) +
       (kw ? t("（过滤中，拖拽排序暂停）") : t("（拖动 ☰ 调序；启用的排最前）")) + "</div>";
     for (const m of gm) html += provModelRow(p.id, m, g);
     html += "</div>";
@@ -1497,6 +1523,7 @@ async function refreshProviderModels(id) {
   try {
     const r = await api("/api/models/refresh", { method: "POST", body: JSON.stringify({ id }) });
     if (!r.ok && r.message) toast(t("获取失败：") + r.message, true);
+    else if (r.note) toast(r.note);   // 网关无模型列表接口（404）：良性提示，不算失败
     else toast(t("已获取模型列表 · wire 适配测试后台进行中"));
   } catch (e) { toast(t("获取失败：") + e.message, true); }
   poll();
@@ -1652,7 +1679,7 @@ async function openImportDialog() {
       '<input type="checkbox" value="' + esc(s.id) + '"' + (ok ? " checked" : " disabled") +
       (ok ? ' onchange="updateImportSelHint()"' : "") + ">" +
       '<div class="src-main">' +
-      '<div class="src-name">' + esc(s.name) + status + "</div>" +
+      '<div class="src-name">' + esc(t(s.name)) + status + "</div>" +
       '<div class="src-desc">' + esc(t(s.desc)) + "</div>" +
       '<div class="src-path">' + esc((s.paths || []).join("  ·  ")) + "</div>" +
       (s.note ? '<div class="src-note">' + esc(t.apply(null, [s.note].concat(s.note_args || []))) + "</div>" : "") +
@@ -1803,6 +1830,26 @@ function renderClarify(questions, goal, resetSubmit) {
     ta.value = ta.value.trim() + (ta.value.includes(line) ? "" : (ta.value ? "\n" : "") + line);
     b.classList.add("picked");
     b.disabled = true;
+    // spec 分段签核（借鉴 superpowers「分段短块逐段消化」）：全部问题选完后
+    // 显示已确认摘要条 + 「确认开跑」——用户看一眼再动手，不蒙头就创建
+    const allPicked = questions.every((it) =>
+      Array.from(box.querySelectorAll(".cl-opt")).some(
+        (x) => x.dataset.q === it.q && x.classList.contains("picked")));
+    let bar = box.querySelector("#clarify-confirm");
+    if (allPicked && !bar) {
+      bar = document.createElement("div");
+      bar.id = "clarify-confirm";
+      bar.className = "cl-confirm";
+      bar.innerHTML = '<button type="button" class="primary small" id="clarify-go">' +
+        esc(t("已确认，开跑")) + "</button></div>";
+      box.appendChild(bar);
+      bar.querySelector("#clarify-go").addEventListener("click", () => {
+        box.classList.add("hidden");
+        box.innerHTML = "";
+        S.clarifyDone = true;
+        $("btn-create").click();
+      });
+    }
   }));
   function it0safe(q, o) { return q + "：" + o; }
   const skip = $("clarify-skip");
@@ -3266,12 +3313,12 @@ function drawTaskDetail(key, runs) {
       } catch (e) {
         // 拉取失败不再静默留白（手机端「报告空空」的来源之一）：给可见提示，
         // 不落缓存，下一轮轮询签名变化时自动重试
-        hint(t("报告读取失败（") + ((e || {}).message || t("网络异常")) + t("），稍后自动重试"));
+        hint(t("报告读取失败（{0}），稍后自动重试", (e || {}).message || t("网络异常")));
       }
     } else if (latest.status === "running" || latest.status === "queued") {
       hint(t("本次运行进行中：报告结束后在这里生成，实时进度看「步骤」页签"));
     } else {
-      const st = { failed: "失败", cancelled: "已取消", timeout: "超时" }[latest.status] || latest.status || "";
+      const st = { failed: t("失败"), cancelled: t("已取消"), timeout: t("超时") }[latest.status] || latest.status || "";
       hint(t("本次运行没有生成报告") + (st ? t("（状态：") + st + t("）") : "") +
         t("；各步骤日志在「步骤」页签"));
     }
@@ -3630,11 +3677,11 @@ async function renderRunDetail() {
       // 拉取失败不再静默留白：给可见提示（下轮轮询重画会重试）
       if (S.detailRunId === id && !S.detailTaskKey)
         $("rd-report").innerHTML = '<div class="hint">' +
-          esc(t("报告读取失败（") + ((e || {}).message || t("网络异常")) + t("），稍后自动重试")) + "</div>";
+          esc(t("报告读取失败（{0}），稍后自动重试", (e || {}).message || t("网络异常"))) + "</div>";
     }
     loadArtifacts(id);
   } else {
-    const st = { failed: "失败", cancelled: "已取消", timeout: "超时" }[run.status] || run.status || "";
+    const st = { failed: t("失败"), cancelled: t("已取消"), timeout: t("超时") }[run.status] || run.status || "";
     $("rd-report").innerHTML = '<div class="hint">' +
       (run.status === "running" || run.status === "queued"
         ? esc(t("本次运行进行中：报告结束后在这里生成，实时进度看「步骤」页签"))
@@ -3799,6 +3846,7 @@ function renderBookMetaPanel(task) {
   let html = '<div class="bm-head"><svg class="ico" aria-hidden="true"><use href="#i-idcard"/></svg>' +
     '<span class="sec-title">' + t("作品信息") + "</span>" +
     '<span class="hint">' + esc(t("按发布平台生成建书表单资料，逐字段复制过去")) + "</span>" +
+    '<button class="hhelp" data-help-topic="publish" title="' + esc(t("这是什么？点开看帮助")) + '" aria-label="' + esc(t("帮助")) + '"><svg class="ico" aria-hidden="true"><use href="#i-help"></use></svg></button>' +
     '<span class="flex1"></span>';
   if (taskBusy) html += '<span class="bm-warn">' + esc(t("任务运行中，生成将在本轮结束后可用")) + "</span>";
   html += "</div>";
@@ -3854,14 +3902,24 @@ function renderBookMetaPanel(task) {
       pbBlock(task, p.id) +
       "</div>";
   }).join("") + "</div>";
-  // 封面卡（covergen，借鉴 oh-story 封面图环节）：curl 落盘运行目录，done 后可点开预览
+  // 封面卡（covergen，借鉴 oh-story 封面图环节）：curl 落盘运行目录，
+  // done 后卡片内直接嵌缩略图（/api/runs/<id>/cover 专用通道），点开新页看大图
   const cg = task.cover_gen || {};
   const cgSt = cg.status || "";
   let cgBody = "";
   if (cgSt === "running") {
     cgBody = '<div class="bm-empty"><svg class="ico spin" aria-hidden="true"><use href="#i-refresh"/></svg> ' + esc(t("生成中…")) + "</div>";
+  } else if (cgSt === "done" && cg.run_id) {
+    const covUrl = "/api/runs/" + encodeURIComponent(cg.run_id) + "/cover" +
+      (cg.at ? "?ts=" + encodeURIComponent(cg.at) : "");   // at 当缓存戳，重生成后缩略图跟着换
+    cgBody = '<div class="bm-cover-wrap">' +
+      '<a href="' + esc(urlAuth(covUrl)) + '" target="_blank" rel="noopener" title="' + esc(t("点击查看大图")) + '">' +
+      '<img class="bm-cover-img" src="' + esc(urlAuth(covUrl)) + '" alt="cover.png" ' +
+      'onerror="this.closest(&quot;.bm-cover-wrap&quot;).classList.add(&quot;noimg&quot;)"></a>' +
+      '<span class="bm-cover-fallback">' + esc(t("cover.png 已不在运行目录")) + "</span>" +
+      '<div class="bm-cover-meta">' + esc([cg.model, cg.provider, cg.size].filter(Boolean).join(" · ")) + "</div></div>";
   } else if (cgSt === "done") {
-    cgBody = '<div class="bm-empty">' + esc(t("封面已生成（cover.png），在「成果」页签查看")) + "</div>";
+    cgBody = '<div class="bm-empty">' + esc(t("封面已生成，但缺少运行记录归属")) + "</div>";
   } else if (cgSt === "failed") {
     cgBody = '<div class="bm-errhint">' + esc(cg.error || t("生成失败")) + "</div>";
   } else {
@@ -4076,7 +4134,7 @@ window.pbUploadChapter = async function (taskId, platform) {
 };
 
 window.pbSendChapter = async function (taskId, platform, relName) {
-  if (!confirm(t("将把《" + relName + "》填进平台章节编辑器，填好后由你人工提交。继续？"))) return;
+  if (!confirm(t("将把《{0}》填进平台章节编辑器，填好后由你人工提交。继续？", relName))) return;
   try {
     await api("/api/publish/task/" + encodeURIComponent(taskId) + "/chapter",
       { method: "POST", body: JSON.stringify({ platform, file: relName }) });
@@ -4091,8 +4149,7 @@ window.pbPublishAll = async function (taskId, platform) {
   const au = (((S.pubAuto && S.pubAuto.books) || [])
     .find((b) => b.platform === platform)) || {};
   if (!au.pending) return;
-  if (!confirm(t("将从最靠前的待发章节开始填稿（共 " + au.pending +
-    " 章待发）。本轮只填一章并停在表单页，由你在浏览器里确认提交；提交后再点一次即发下一章。护栏（每日上限/连续失败暂停）生效。继续？"))) return;
+  if (!confirm(t("将从最靠前的待发章节开始填稿（共 {0} 章待发）。本轮只填一章并停在表单页，由你在浏览器里确认提交；提交后再点一次即发下一章。护栏（每日上限/连续失败暂停）生效。继续？", au.pending))) return;
   try {
     await api("/api/publish/task/" + encodeURIComponent(taskId) + "/publish-all",
       { method: "POST", body: JSON.stringify({ platform }) });
@@ -4228,6 +4285,7 @@ function _renderGitSnapshot(run, task) {
   let html =
     '<div class="git-head"><svg class="ico" aria-hidden="true"><use href="#i-git-branch"></use></svg>' +
     '<span class="sec-title">' + t("代码版本隔离") + '</span>' +
+    '<button class="hhelp" data-help-topic="code" title="' + esc(t("这是什么？点开看帮助")) + '" aria-label="' + esc(t("帮助")) + '"><svg class="ico" aria-hidden="true"><use href="#i-help"></use></svg></button>' +
     '<code class="git-branch" title="' + esc(t("任务分支：产物提交在此，原分支未受影响")) + '">' + esc(g.branch) + "</code>";
   const addT = ch.add_total, delT = ch.del_total;
   if (addT != null && delT != null) {
@@ -4323,7 +4381,8 @@ function renderGitWbMain(d, task) {
   sel += "</select>";
   let html =
     '<div class="git-head"><svg class="ico" aria-hidden="true"><use href="#i-git-branch"></use></svg>' +
-    '<span class="sec-title">' + t("Git 工作台") + "</span>" + sel +
+    '<span class="sec-title">' + t("Git 工作台") + "</span>" +
+    '<button class="hhelp" data-help-topic="code" title="' + esc(t("这是什么？点开看帮助")) + '" aria-label="' + esc(t("帮助")) + '"><svg class="ico" aria-hidden="true"><use href="#i-help"></use></svg></button>' + sel +
     '<code class="git-branch" title="HEAD">' + esc(d.head || "") + "</code>" +
     (d.upstream ? '<span class="gm" title="' + esc(d.upstream) + '">↑' + (d.ahead || 0) + " ↓" + (d.behind || 0) + "</span>" : "") +
     '<span class="flex1"></span>' +
@@ -6548,6 +6607,17 @@ function provAdaptedProto(p, allow, kind) {
     && !chatBlocked((caps[pr] || {}).wire_api)) || "";
 }
 
+/* 死因细化：协议适配失败里最常见的一种是「openai 面实测只探到 chat 形态」
+ * （codex 0.154+ 只讲 responses，其余 CLI 不受影响）。按真实死因说话——
+ * 模型接入页明明亮着 openai ✓，链上却笼统说「协议不匹配」，看着就像自相矛盾。 */
+function chatShapedFace(pv, allow) {
+  if (!pv) return false;
+  const chat = (w) => (w || "responses") === "chat";
+  if (allow.indexOf(pv.protocol) >= 0 && chat(pv.wire_api)) return true;
+  const caps = pv.wire_caps || {};
+  return allow.some((pr) => (caps[pr] || {}).base && chat((caps[pr] || {}).wire_api));
+}
+
 /* CLI 允许注入的供应商 wire 协议——与 modelhub.resolve_binding 的 allowed 规则
  * 保持一致（codex 只吃 openai wire、claude 只吃 anthropic、dsh 只吃 OpenAI
  * 兼容端点，其余两种皆可）。后端会跳过不匹配的链条目，这里在选择层就挡住。 */
@@ -6674,7 +6744,10 @@ function chainDeadReasons(c, chain) {
     const pv = (S.providers || []).find((p) => p.id === x.p);
     if (!pv) return t("供应商已删除");
     if (pv.enabled === false) return t("供应商已停用");
-    if (!provAdaptedProto(pv, allow, c.orch_kind)) return t("协议不匹配");
+    if (!provAdaptedProto(pv, allow, c.orch_kind))
+      return chatShapedFace(pv, allow)
+        ? t("openai 面仅 chat 形态（codex 只讲 responses）")
+        : t("协议不匹配");
     const ks = pv.keys || [];
     if (ks.length && !ks.some((k) => k.enabled !== false && !k.cooling))
       return t("密钥全部冷却中");
@@ -6820,7 +6893,9 @@ function bindModelBox(c, provId) {
           "<b>" + (i === 0 ? t("主") : t("备")) + "</b>" + esc(pname) + " · " + esc(c2.m) +
           (modelHasImage(c2.p, c2.m)
             ? ' <span class="tag ok" title="' + esc(t("支持图片输入")) + '">' + t("图") + "</span>" : "") +
-          (dead ? ' <span class="hint warn">⚠ ' + esc(t("协议不匹配，解析时跳过")) + "</span>" : badge) +
+          (dead ? ' <span class="hint warn">⚠ ' + esc(chatShapedFace(pv, allow)
+            ? t("openai 面仅 chat 形态（codex 只讲 responses），解析时跳过")
+            : t("协议不匹配，解析时跳过")) + "</span>" : badge) +
           (i > 0 ? '<button class="mini" data-m="' + esc(c2.m) + '" data-p="' + esc(c2.p) +
                   '" title="' + t("设为主模型") + '" onclick="bindPromote(\'' + esc(c.id) + '\', this)">' +
                   '<svg class="ico" aria-hidden="true"><use href="#i-arrow-up"></use></svg></button>' : "") +
@@ -7683,8 +7758,8 @@ function autoTemplate(tplId) {
 }
 
 /* ---------------------------------------------------------- 禅道 Bug 自动修复 */
-/* /api/zentao → {config(脱敏), claims, last_scan, next_scan, last_error}。
- * 进页拉一次回填表单；保存/测试/扫描各自 POST 后重拉。 */
+/* /api/zentao → {config(脱敏，含 product_profiles), claims, last_scan, next_scan, last_error}。
+ * 产品档案卡：结构增删走「先采集 DOM 回 S.ztProfiles → 改 → 重渲染」，保住已输入值。 */
 
 async function loadZentao() {
   let v = null;
@@ -7696,35 +7771,180 @@ async function loadZentao() {
   set("zt-account", cfg.account);
   const pw = $("zt-password");
   if (pw) { pw.value = ""; pw.placeholder = cfg.has_password ? t("已保存（不改就留空）") : ""; }
-  set("zt-products", (cfg.products || []).join(","));
-  set("zt-assigned", cfg.assigned_to);
-  const sev = $("zt-sev"); if (sev) sev.value = String(cfg.severity_cap || 0);
-  set("zt-workdir", cfg.workdir);
-  set("zt-gitrev", cfg.git_rev);
-  set("zt-verify", cfg.verify_command);
   const tg = (id, on) => { const el = $(id); if (el) el.checked = !!on; };
+  tg("zt-triageai", cfg.triage_ai);
   tg("zt-autoresolve", cfg.auto_resolve);
   tg("zt-automerge", cfg.auto_merge);
   tg("zt-poll", cfg.poll_enabled);
   set("zt-interval", cfg.interval_hours || 2);
+  S.ztProfiles = JSON.parse(JSON.stringify(cfg.product_profiles || []));
+  renderZentaoProfiles();
   renderZentaoStatus();
   renderZentaoClaims();
 }
 
+/* ---- 产品档案：渲染与采集 ---- */
+
+const ZT_SIDES = ["backend", "frontend"];
+
+function ztRepoHtml(i, side) {
+  const cn = side === "backend" ? t("后端") : t("前端");
+  const p = (S.ztProfiles[i] || {});
+  const repo = (p.repos || {})[side] || {};
+  const hint = (p.repo_hints || {})[side] || "";
+  return '<label>' + cn + t("仓库·工作目录") + '</label><input class="zt-p-wd" data-side="' + side + '" value="' + esc(repo.workdir || "") + '" placeholder="' + t("空 = 不用该端") + '">' +
+    '<label>' + cn + t("仓库·基线分支") + '</label><input class="zt-p-rev" data-side="' + side + '" value="' + esc(repo.git_rev || "") + '" placeholder="' + t("如 main；空 = 直接改工作目录") + '">' +
+    '<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 管理台前端") + '">';
+}
+
+function ztProfCardHtml(p, i) {
+  const ours = p.our_sides || [];
+  const routes = p.module_routes || [];
+  const SIDE_OPTS = [["backend", "后端"], ["frontend", "前端"], ["both", "双端"], ["not_ours", "非我方"]];
+  const rows = routes.map((r, j) =>
+    '<div class="zt-mr-row" data-j="' + j + '">' +
+    '<input class="zt-mr-module zt-num" list="zt-mods-' + i + '" placeholder="' + t("模块 ID") + '" value="' + esc(r.module || "") + '">' +
+    '<select class="zt-mr-side">' + SIDE_OPTS.map((o) =>
+      '<option value="' + o[0] + '"' + (r.side === o[0] ? " selected" : "") + ">" + t(o[1]) + "</option>").join("") + "</select>" +
+    '<input class="zt-mr-account" placeholder="' + t("转给谁（禅道账号，可空）") + '" value="' + esc(r.account || "") + '">' +
+    '<button class="ghost small" onclick="ztMrDel(' + i + "," + j + ')">' + t("删") + "</button>" +
+    "</div>").join("");
+  const owners = p.owners || {};
+  return '<div class="card zt-prof" data-i="' + i + '"><div class="head">' +
+    '<span class="name">' + t("产品") + ' <input class="zt-p-product zt-num" type="number" min="1" value="' + esc(p.product || "") + '" placeholder="ID"></span>' +
+    '<button class="danger small" onclick="ztProfDel(' + i + ')">' + t("删除产品") + "</button></div>" +
+    '<div class="zt-grid">' +
+    '<label data-i18n="只认领指派给">只认领指派给</label><input class="zt-p-assigned" value="' + esc(p.assigned_to || "") + '" placeholder="' + t("禅道账号名，空 = 不按指派过滤") + '">' +
+    '<label data-i18n="严重度上限">严重度上限</label><select class="zt-p-sev">' +
+    [0, 1, 2, 3, 4].map((n) => '<option value="' + n + '"' + (Number(p.severity_cap || 0) === n ? " selected" : "") + ">" +
+      (n === 0 ? t("不限") : n + (n === 1 ? t("（最严重）") : "")) + "</option>").join("") + "</select>" +
+    "</div>" +
+    '<div class="zt-ours"><span>' + t("我方端（自动修）：") + "</span>" +
+    ZT_SIDES.map((s) =>
+      '<label class="toggle"><input type="checkbox" class="zt-p-ours" data-side="' + s + '"' + (ours.indexOf(s) >= 0 ? " checked" : "") + "><span>" +
+      (s === "backend" ? t("后端") : t("前端")) + "</span></label>").join("") +
+    '<span class="hint">' + t("都不勾 = 该产品只排查转派，不自动修") + "</span></div>" +
+    '<div class="zt-grid">' + ZT_SIDES.map((s) => ztRepoHtml(i, s)).join("") + "</div>" +
+    '<div class="zt-grid">' +
+    '<label data-i18n="后端负责人">后端负责人</label><input class="zt-p-owner" data-side="backend" value="' + esc(owners.backend || "") + '" placeholder="' + t("禅道账号，转派/升级用") + '">' +
+    '<label data-i18n="前端负责人">前端负责人</label><input class="zt-p-owner" data-side="frontend" value="' + esc(owners.frontend || "") + '" placeholder="' + t("禅道账号，转派/升级用") + '">' +
+    '<label data-i18n="非我方转派给">非我方转派给</label><input class="zt-p-owner" data-side="not_ours" value="' + esc(owners.not_ours || "") + '" placeholder="' + t("空 = 指回报告人") + '">' +
+    "</div>" +
+    '<div class="zt-mrs"><div class="zt-mr-head">' + t("模块路由（模块 → 端/人，排查优先级最高）") +
+    '<button class="ghost small" onclick="ztFetchMods(' + i + ')">' + t("拉取模块清单") + "</button>" +
+    '<button class="ghost small" onclick="ztMrAdd(' + i + ')">' + t("＋ 加路由") + "</button></div>" +
+    (rows || '<div class="hint">' + t("未配路由——模块不在路由里的 Bug 走 AI 排查") + "</div>") +
+    '<datalist id="zt-mods-' + i + '"></datalist>' +
+    "</div></div>";
+}
+
+function renderZentaoProfiles() {
+  const box = $("zt-profiles");
+  if (!box) return;
+  box.innerHTML = (S.ztProfiles || []).map((p, i) => ztProfCardHtml(p, i)).join("") ||
+    '<div class="empty">' + t("还没有产品档案——点「＋ 添加产品」，填产品 ID 与两端仓库。") + "</div>";
+}
+
+/* DOM 卡片 → profiles 数组（结构变化前采集，保住已输入值） */
+function ztHarvestProfiles() {
+  return Array.from(document.querySelectorAll("#zt-profiles .zt-prof")).map((card) => {
+    const gv = (sel) => { const el = card.querySelector(sel); return el ? (el.value || "").trim() : ""; };
+    const routes = Array.from(card.querySelectorAll(".zt-mr-row")).map((row) => ({
+      module: parseInt((row.querySelector(".zt-mr-module").value || ""), 10) || 0,
+      side: row.querySelector(".zt-mr-side").value,
+      account: (row.querySelector(".zt-mr-account").value || "").trim(),
+    })).filter((r) => r.module > 0);
+    return {
+      product: parseInt(gv(".zt-p-product"), 10) || 0,
+      assigned_to: gv(".zt-p-assigned"),
+      severity_cap: parseInt(gv(".zt-p-sev"), 10) || 0,
+      our_sides: Array.from(card.querySelectorAll(".zt-p-ours:checked")).map((el) => el.dataset.side),
+      repos: {
+        backend: { workdir: gv('.zt-p-wd[data-side="backend"]'), git_rev: gv('.zt-p-rev[data-side="backend"]'), verify_command: gv('.zt-p-verify[data-side="backend"]') },
+        frontend: { workdir: gv('.zt-p-wd[data-side="frontend"]'), git_rev: gv('.zt-p-rev[data-side="frontend"]'), verify_command: gv('.zt-p-verify[data-side="frontend"]') },
+      },
+      repo_hints: {
+        backend: gv('.zt-p-hint[data-side="backend"]'),
+        frontend: gv('.zt-p-hint[data-side="frontend"]'),
+      },
+      owners: {
+        backend: gv('.zt-p-owner[data-side="backend"]'),
+        frontend: gv('.zt-p-owner[data-side="frontend"]'),
+        not_ours: gv('.zt-p-owner[data-side="not_ours"]'),
+      },
+      module_routes: routes,
+    };
+  });
+}
+
+function ztProfAdd() {
+  S.ztProfiles = ztHarvestProfiles();
+  S.ztProfiles.push({ product: 0, assigned_to: "", severity_cap: 0, our_sides: ["backend"],
+    repos: { backend: {}, frontend: {} }, repo_hints: { backend: "", frontend: "" },
+    owners: { backend: "", frontend: "", not_ours: "" }, module_routes: [] });
+  renderZentaoProfiles();
+}
+
+function ztProfDel(i) {
+  S.ztProfiles = ztHarvestProfiles();
+  S.ztProfiles.splice(i, 1);
+  renderZentaoProfiles();
+}
+
+function ztMrAdd(i) {
+  S.ztProfiles = ztHarvestProfiles();
+  (S.ztProfiles[i].module_routes = S.ztProfiles[i].module_routes || []).push({ module: "", side: "backend", account: "" });
+  renderZentaoProfiles();
+}
+
+function ztMrDel(i, j) {
+  S.ztProfiles = ztHarvestProfiles();
+  S.ztProfiles[i].module_routes.splice(j, 1);
+  renderZentaoProfiles();
+}
+
+async function ztFetchMods(i) {
+  const pid = parseInt(($("zt-profiles").querySelectorAll(".zt-prof")[i]?.querySelector(".zt-p-product").value) || "", 10);
+  if (!pid) { toast(t("先填产品 ID 再拉模块清单"), true); return; }
+  let r;
+  try {
+    r = await api("/api/zentao/modules", { method: "POST", body: JSON.stringify({ product: pid }) });
+  } catch (e) { toast(e.message, true); return; }
+  if (!r.ok) { toast(r.error || t("拉取失败"), true); return; }
+  const dl = $("zt-mods-" + i);
+  if (dl) dl.innerHTML = (r.modules || []).map((m) =>
+    '<option value="' + esc(m.id) + '">' + esc(m.name || "") + "</option>").join("");
+  toast(t("模块清单已拉到 ") + (r.modules || []).length + t(" 条，输入框可下拉选择"));
+}
+
+/* ---- 状态行 / 修复记录 ---- */
+
 function zentaoStateTag(st) {
   const MAP = {
     fixing: ["修复中", "zt-tag-fix"],
     resolved: ["已解决", "zt-tag-ok"],
+    transferred: ["已转派", "zt-tag-fix"],
+    escalated: ["已升级转派", "zt-tag-warn"],
     merge_failed: ["合并失败", "zt-tag-warn"],
     commented: ["已评论留人工", "zt-tag-warn"],
     resolve_failed: ["回写失败", "zt-tag-warn"],
     done_manual: ["待人工确认", "zt-tag-warn"],
+    need_manual: ["需人工", "zt-tag-warn"],
     lost: ["记录丢失", "zt-tag-err"],
   };
   const m = MAP[st] || [st || "?", ""];
   return '<span class="tag ' + m[1] + '">' + t(m[0]) + "</span>";
 }
 
+function zentaoTriText(c) {
+  const tri = c.triage || {};
+  if (!tri.side) return "";
+  const NAME = { backend: "后端问题", frontend: "前端问题", both: "双端问题", not_ours: "非我方", unknown: "待人工" };
+  const by = tri.by === "rule" ? t("模块路由") : tri.by === "ai" ? "AI" : "";
+  return t("排查：") + t(NAME[tri.side] || tri.side) + (by ? "（" + by + "）" : "");
+}
+
 function renderZentaoStatus() {
   const box = $("zentao-status");
   if (!box) return;
@@ -7745,37 +7965,35 @@ function renderZentaoClaims() {
   const box = $("zentao-claims");
   if (!box) return;
   const claims = (S.zentao && S.zentao.claims) || [];
-  box.innerHTML = claims.map((c) =>
-    '<div class="card"><div class="head"><span class="name">#' + esc(c.bug_id) + " " + esc(c.title || "") + "</span>" +
-    zentaoStateTag(c.state) + "</div>" +
-    '<div class="auto-meta">' +
-    "<span>" + t("修复任务：") + '<a href="#" onclick="zentaoOpenTask(\'' + esc(c.task_id || "") + '\');return false;">' + esc(c.task_id || "?") + "</a></span>" +
-    (c.claimed_at ? "<span>" + t("认领于 ") + esc(c.claimed_at) + "</span>" : "") +
-    "</div>" +
-    (c.note ? '<div class="note">' + esc(c.note) + "</div>" : "") +
-    "</div>"
-  ).join("") || '<div class="empty">' + t("还没有认领过 Bug——配置好连接与产品 ID 后点「立即扫描」。") + "</div>";
+  box.innerHTML = claims.map((c) => {
+    const tasks = (c.tasks || []).map((tk) =>
+      "<span>【" + (tk.side === "frontend" ? t("前端") : t("后端")) + "】" +
+      '<a href="#" onclick="zentaoOpenRun(\'' + esc(tk.run_id || "") + '\');return false;">' + esc(tk.task_id || "?") + "</a></span>").join("");
+    return '<div class="card"><div class="head"><span class="name">#' + esc(c.bug_id) + " " + esc(c.title || "") + "</span>" +
+      zentaoStateTag(c.state) + "</div>" +
+      '<div class="auto-meta">' +
+      (zentaoTriText(c) ? "<span>" + esc(zentaoTriText(c)) + "</span>" : "") +
+      (tasks || "") +
+      (c.claimed_at ? "<span>" + t("认领于 ") + esc(c.claimed_at) + "</span>" : "") +
+      "</div>" +
+      (c.note ? '<div class="note">' + esc(c.note) + "</div>" : "") +
+      "</div>";
+  }).join("") || '<div class="empty">' + t("还没有认领过 Bug——配置好连接与产品档案后点「立即扫描」。") + "</div>";
 }
 
-function zentaoOpenTask(taskId) {
-  const c = ((S.zentao && S.zentao.claims) || []).find((x) => x.task_id === taskId);
-  if (c && c.run_id) { openRun(c.run_id); return; }
+function zentaoOpenRun(runId) {
+  if (runId) { openRun(runId); return; }
   switchTab("tasks");
 }
 
 /* 表单 → 保存配置。password 只在用户输入了才提交（空 = 保持已存密码）。 */
 async function saveZentao() {
   const val = (id) => (($(id).value || "").trim());
-  const products = val("zt-products").split(/[,，\s]+/).filter(Boolean).map(Number);
   const payload = {
     base_url: val("zt-base-url"),
     account: val("zt-account"),
-    products,
-    assigned_to: val("zt-assigned"),
-    severity_cap: parseInt($("zt-sev").value, 10) || 0,
-    workdir: val("zt-workdir"),
-    git_rev: val("zt-gitrev"),
-    verify_command: val("zt-verify"),
+    product_profiles: ztHarvestProfiles(),
+    triage_ai: $("zt-triageai").checked,
     auto_resolve: $("zt-autoresolve").checked,
     auto_merge: $("zt-automerge").checked,
     poll_enabled: $("zt-poll").checked,
@@ -7976,7 +8194,7 @@ function mkrCardHtml(p) {
   const meta = [p.author, p.version ? "v" + p.version : ""].filter(Boolean).join(" · ");
   return '<div class="card mk-card' + (p.compat === "blocked" ? " blocked" : "") + '"><div class="head">' +
     '<span class="name">' + esc(t(p.title || p.name)) + "</span>" +
-    '<span class="tag mk-src">' + esc(p.source_name || "") + "</span>" +
+    '<span class="tag mk-src">' + esc(t(p.source_name || "")) + "</span>" +
     (p.category ? '<span class="tag">' + esc(p.category) + "</span>" : "") +
     "</div>" +
     '<div class="note">' + esc(t(p.desc || "")) + "</div>" +
@@ -7999,7 +8217,7 @@ function renderMarketRemote() {
   if (srcSel && !srcSel.options.length) {
     srcSel.innerHTML = '<option value="">' + t("全部来源") + "</option>" +
       (data.sources || []).map((s) =>
-        '<option value="' + esc(s.id) + '">' + esc(s.name) + t("（") + s.count + t("）") + "</option>").join("");
+        '<option value="' + esc(s.id) + '">' + esc(t(s.name)) + t("（") + s.count + t("）") + "</option>").join("");
   }
   const times = (data.sources || []).map((s) => s.fetched_at).filter(Boolean);
   const meta = $("mkr-meta");
@@ -8054,7 +8272,7 @@ async function mkrRefresh() {
       const keep = srcSel.value;
       srcSel.innerHTML = '<option value="">' + t("全部来源") + "</option>" +
         (r.sources || []).map((s) =>
-          '<option value="' + esc(s.id) + '">' + esc(s.name) + t("（") + s.count + t("）") + "</option>").join("");
+          '<option value="' + esc(s.id) + '">' + esc(t(s.name)) + t("（") + s.count + t("）") + "</option>").join("");
       srcSel.value = keep;
     }
     mkrLoadPage(true);
@@ -8174,7 +8392,7 @@ async function loadSettingsV2() {
         inp = '<input id="' + iid + '" type="text" value="' + esc(String(cur)) + '">';
       }
       html += '<div class="set-v2-row">' + inp +
-        '<span class="set-v2-lb" title="' + esc(f.description || f.path) + '">' + esc(f.description || f.path) + "</span></div>";
+        '<span class="set-v2-lb" title="' + esc(t(f.description || f.path)) + '">' + esc(t(f.description || f.path)) + "</span></div>";
     }
     html += '<div class="input-row" style="margin-top:6px"><button class="ghost small" onclick="saveSettingsV2(\'' + esc(ns) + '\')">' + t("保存") + "</button>" +
       '<span class="set-v2-msg msg"></span></div></div>';
@@ -8352,13 +8570,158 @@ function maybeWhatsnew() {
   }
 }
 
-/* ===== 首次启动欢迎引导：产品是什么 + 装完三步开工 =====
- * localStorage orch.welcomed 记账，只自动弹一次；「关于与更新」页可手动重开。
- * 令牌门在场时让位（远端新设备先输令牌，下次启动引导照常弹）。 */
-function welcomeOpen() {
+/* ===== 帮助中心（首启欢迎引导升级版）：左目录右内容 =====
+ * 首启自动弹（orch.welcomed 记账只弹一次，徽章「首次启动」，落在「快速上手」章）；
+ * 手动开（设置导航/关于页/Ctrl+K）徽章「帮助中心」。加新章 = HELP_CHAPTERS
+ * 追加一条 + helpChapterBody 加一个分支；todo:true 的章自动渲染「整理中」占位。 */
+var HELP_CHAPTERS = [
+  { id: "quickstart", icon: "i-rocket",        label: "快速上手" },
+  { id: "models",     icon: "i-blocks",        label: "模型接入与绑定" },
+  { id: "features",   icon: "i-bee",           label: "功能一览" },
+  { id: "serial",     icon: "i-book-open",     label: "连载创作流程" },
+  { id: "publish",    icon: "i-clapper",       label: "发布上架" },
+  { id: "code",       icon: "i-git-branch",    label: "代码任务与版本" },
+  { id: "auto",       icon: "i-calendar-days", label: "自动化与技能市场" },
+  { id: "faq",        icon: "i-search",        label: "常见问题" },
+];
+var helpCur = "quickstart";
+var helpFirst = false;   // 本次打开是否首启自动弹（决定徽章文案；语言切换时也要用）
+
+function helpChapterBody(id) {
+  if (id === "quickstart") {
+    return '<div class="welcome-steps">' +
+      '<div class="wstep"><b>1</b><span>' + t("添加模型供应商：设置 → 模型接入，填入 API Key") + '</span></div>' +
+      '<div class="wstep"><b>2</b><span>' + t("绑定 CLI 智能体：点「一键推荐绑定」自动配好") + '</span></div>' +
+      '<div class="wstep"><b>3</b><span>' + t("新建任务：选工作目录、写目标，蜂群开工") + '</span></div>' +
+      '</div>' +
+      '<p class="help-note">' + t("任务跑起来后，详情页能看到步骤、蜂巢、成果文件与 Git 版本；「直接执行」类任务还能像聊天一样边跑边追加消息。") + '</p>' +
+      '<div class="welcome-acts">' +
+      '<button class="wl-btn primary" onclick="welcomeGo(\'models\')"><span>' + t("开始配置模型") + '</span><svg class="ico" aria-hidden="true"><use href="#i-chevron-r"></use></svg></button>' +
+      '<button class="wl-btn" onclick="welcomeGo(\'bindings\')"><span>' + t("绑定 CLI 智能体") + '</span><svg class="ico" aria-hidden="true"><use href="#i-chevron-r"></use></svg></button>' +
+      '<button class="wl-btn ghost" onclick="welcomeClose()"><span>' + t("先跳过，直接体验") + '</span></button>' +
+      '</div>';
+  }
+  if (id === "models") {
+    return '<h3 class="help-h3">' + t("第一步：添加供应商") + '</h3>' +
+      '<p class="help-p">' + t("「设置 → 模型接入 → 添加供应商」：填名称、API Key、接口地址（一般用默认）。保存后点「获取模型列表」自动拉取该厂商的模型；网关不提供列表接口时直接手工填模型名即可。同一厂商可配多把 Key，按顺序轮换，某把欠费自动切下一把。") + '</p>' +
+      '<h3 class="help-h3">' + t("第二步：认识协议徽章") + '</h3>' +
+      '<p class="help-p">' + t("新供应商默认自动识别协议，保存后在后台实测支持哪些调用形态，结果以徽章标在卡片上。带「· chat」表示该模型只适合站内直连对话；codex 这类只讲 responses 协议的 CLI 用不了它，绑定页会自动剔除，不用自己排查。") + '</p>' +
+      '<h3 class="help-h3">' + t("第三步：绑定 CLI 智能体") + '</h3>' +
+      '<p class="help-p">' + t("「设置 → CLI 绑定」给每个智能体配一条模型链，运行时按顺序故障转移。「一键推荐绑定」只填空缺，不覆盖手工配置；删除或停用厂商后链会自动补绑。") + '</p>' +
+      '<h3 class="help-h3">' + t("报错速查") + '</h3>' +
+      '<ul class="help-list">' +
+      '<li><b>401</b><span>' + t("Key 无效或过期——检查或更换 Key。") + '</span></li>' +
+      '<li><b>404</b><span>' + t("模型名不对；若发生在「获取模型列表」，是网关不提供列表接口，能正常对话就不用管。") + '</span></li>' +
+      '<li><b>503</b><span>' + t("该模型当前无可用渠道——查余额或换一个模型。") + '</span></li>' +
+      '<li><b>' + t("冷却中") + '</b><span>' + t("这把 Key 连续失败被暂停 30 分钟，到期自动恢复，也可在密钥旁手动重置。") + '</span></li>' +
+      '</ul>' +
+      '<p class="help-note">' + t("想零成本先跑通：挑有免费档位的厂商配一个模型，跑通第一个任务后再按需加码。") + '</p>';
+  }
+  if (id === "features") {
+    return '<ul class="help-feats">' +
+      '<li><svg class="ico" aria-hidden="true"><use href="#i-workflow"></use></svg><div><b>' + t("多智能体编排") + '</b><span>' + t("规划 · 实现 · 评审 · 打磨，接棒交付") + '</span></div></li>' +
+      '<li><svg class="ico" aria-hidden="true"><use href="#i-book-open"></use></svg><div><b>' + t("连载写作") + '</b><span>' + t("断点续跑 · 经验沉淀 · 作品资料") + '</span></div></li>' +
+      '<li><svg class="ico" aria-hidden="true"><use href="#i-clapper"></use></svg><div><b>' + t("发布上架") + '</b><span>' + t("一键发布到番茄、七猫，含封面与作品资料") + '</span></div></li>' +
+      '<li><svg class="ico" aria-hidden="true"><use href="#i-git-branch"></use></svg><div><b>' + t("版本工作台") + '</b><span>' + t("任务分支隔离，改动可审可合") + '</span></div></li>' +
+      '<li><svg class="ico" aria-hidden="true"><use href="#i-calendar-days"></use></svg><div><b>' + t("自动化") + '</b><span>' + t("定时任务，无人值守") + '</span></div></li>' +
+      '<li><svg class="ico" aria-hidden="true"><use href="#i-library"></use></svg><div><b>' + t("经验库") + '</b><span>' + t("内置规范包 + 自动沉淀教训，越用越顺手") + '</span></div></li>' +
+      '<li><svg class="ico" aria-hidden="true"><use href="#i-blocks"></use></svg><div><b>' + t("插件市场") + '</b><span>' + t("600+ 技能，一键安装") + '</span></div></li>' +
+      '</ul>';
+  }
+  if (id === "serial") {
+    return '<h3 class="help-h3">' + t("开一本新书") + '</h3>' +
+      '<p class="help-p">' + t("新建任务选「连载写作」类型，目标里写清书名、题材和计划篇幅（如「都市异能，先写 20 章」）。目标写得太笼统时，蜂群会先反问几个澄清问题再开工。开书前会先准备作品资料：书简介与分类标签可一键生成，按平台官方选项实抓，不用自己去查规则。") + '</p>' +
+      '<h3 class="help-h3">' + t("每章怎么跑") + '</h3>' +
+      '<p class="help-p">' + t("大纲确认后分章推进：起草 → 跨厂商评审 → 打磨 → 定稿。评审不过会自动换将重写，不带着问题过关；需要你拍板的地方会亮起「待裁决」。写作时详情页可实时预览章节，蜂巢页每个智能体一格，点开能看谁在干什么。") + '</p>' +
+      '<h3 class="help-h3">' + t("中断了怎么办") + '</h3>' +
+      '<p class="help-p">' + t("任务随时可续跑：已写章节都落了盘，续跑接着往下写，不会从头再来。单章失败会自动退避重试，任务状态里会显示「将于 HH:MM 自动续跑」，不用盯着等。") + '</p>' +
+      '<h3 class="help-h3">' + t("递话与经验") + '</h3>' +
+      '<p class="help-p">' + t("跑的过程中可以在详情页给蜂群递话（文字/截图/附件），下一轮生效。每轮结束复盘官会把踩过的坑沉淀进经验库，后续任务自动复用，越用越顺手。") + '</p>';
+  }
+  if (id === "publish") {
+    return '<h3 class="help-h3">' + t("第一次发布前：登录平台") + '</h3>' +
+      '<p class="help-p">' + t("目前支持番茄小说与七猫。第一次发布会引导你在浏览器里登录平台账号（扫码或账密），登录态保存在本机，之后发布免登录；过期了重新登一次即可。") + '</p>' +
+      '<h3 class="help-h3">' + t("建书：资料与封面") + '</h3>' +
+      '<p class="help-p">' + t("连载任务的建书面板里，作品简介、分类标签可以按平台官方选项一键生成；封面点「生成封面」自动出竖版图（cover.png 落在任务运行目录）。") + '</p>' +
+      '<h3 class="help-h3">' + t("发章与确认") + '</h3>' +
+      '<p class="help-p">' + t("章稿定稿后一键发布：自动填标题正文、处理平台的各类弹层，但提交前会停下来让你确认——绝不静默替你上架。发布完成后任务详情里能看到结果与章节链接。") + '</p>' +
+      '<h3 class="help-h3">' + t("发布失败") + '</h3>' +
+      '<p class="help-p">' + t("平台改版或登录态过期会导致失败，失败信息会写明原因。重新登录后再点重试即可；反复失败可以到 GitHub 提 Issue 附上失败截图。") + '</p>';
+  }
+  if (id === "code") {
+    return '<h3 class="help-h3">' + t("代码任务怎么跑") + '</h3>' +
+      '<p class="help-p">' + t("新建任务选开发类类型，目标写清楚要做什么（可以附需求文档、截图，附件会进入上下文）。蜂群先出计划再实现：实现 → 客观验证 → 跨厂商评审 → 修复，单路实现失败还有多候选赛马——各候选在隔离的 worktree 里各写各的，择优采纳。跑的过程中可以在详情页递话（文字/截图），下一轮生效。") + '</p>' +
+      '<h3 class="help-h3">' + t("任务分支隔离：你的工作区不受影响") + '</h3>' +
+      '<p class="help-p">' + t("启用代码版本隔离的任务会检出独立的任务分支（codebee/任务ID），所有改动只落在那条分支上，你当前的分支和未提交的改动完全不动——开跑前工作区有脏改动会先帮你收起（stash），跑完自动还原。") + '</p>' +
+      '<h3 class="help-h3">' + t("版本裁决：合并还是丢弃") + '</h3>' +
+      '<p class="help-p">' + t("任务跑完后，「版本」页签会亮起「待裁决」等你拍板：先看变更清单，双击文件能看 diff；满意点「合并」，任务分支合回基线分支；不满意点「丢弃」，分支和工作现场自动清场。中途停下的任务也会留好提交，可以继续跑完再裁决。合并与丢弃绝不静默替你决定。") + '</p>' +
+      '<h3 class="help-h3">' + t("哪里看细节") + '</h3>' +
+      '<p class="help-p">' + t("「蜂巢」页签看每个智能体实时在干什么（点格子看实时日志）；「步骤」页签看任务拆解、每步实际用的模型、耗时与失败原因，评审分数与打磨记录也在这里。") + '</p>';
+  }
+  if (id === "auto") {
+    return '<h3 class="help-h3">' + t("定时任务") + '</h3>' +
+      '<p class="help-p">' + t("设置 → 自动化：把任意任务类型挂上时间表（每天/每周固定时刻），到点自动按真实运行链开跑，结果照常落盘。配合群机器人（钉钉/飞书/企微自动适配）可以把完成状态推到群里。") + '</p>' +
+      '<h3 class="help-h3">' + t("禅道 Bug 自动修复") + '</h3>' +
+      '<p class="help-p">' + t("设置 → 禅道：配好地址与产品档案后，定时扫描激活 Bug，按模块路由 / AI 排查定责（前端/后端/双端/非我方）；我方端的 Bug 自动创建代码修复任务，修完自动合并、resolve 并回写报告到群里；测试指错人的也会按排查结论改派。合并失败不 resolve 不转派，留人工兜底。") + '</p>' +
+      '<h3 class="help-h3">' + t("技能市场") + '</h3>' +
+      '<p class="help-p">' + t("设置 → 插件市场：600+ 技能一键安装，来源包括内置库和 ZCode、Anthropic 等多个外部目录。装上的技能会注入智能体能力，按任务类型生效。") + '</p>' +
+      '<h3 class="help-h3">' + t("用量台账") + '</h3>' +
+      '<p class="help-p">' + t("设置 → 用量统计：每次调用的模型、token 与费用按多个维度聚合展示，历史运行会在启动时自动回填——每个任务花了多少，一目了然。") + '</p>';
+  }
+  if (id === "faq") {
+    return '<div class="help-qa"><b>' + t("点「获取模型列表」报 404？") + '</b><p>' + t("部分网关不提供模型列表接口，属正常现象；只要能正常对话就不用管，模型名手工填即可。") + '</p></div>' +
+      '<div class="help-qa"><b>' + t("报 503 / 无可用渠道？") + '</b><p>' + t("该模型当前没有可用渠道，最常见是余额耗尽。查一下余额或换个模型；同一厂商配了多把 Key 会自动轮换。") + '</p></div>' +
+      '<div class="help-qa"><b>' + t("「冷却中」是什么意思？") + '</b><p>' + t("一把 Key 连续失败会被暂停 30 分钟，防止反复撞墙烧钱，到期自动恢复；也可以在密钥旁手动重置。") + '</p></div>' +
+      '<div class="help-qa"><b>' + t("任务一直显示「排队」？") + '</b><p>' + t("本地默认最多 6 个任务同时跑，排满就排队。排队时可以打开详情看前面还有几个；个别卡死的任务，看门狗会自动清理补队。") + '</p></div>' +
+      '<div class="help-qa"><b>' + t("状态里写着「将于 HH:MM 自动续跑」？") + '</b><p>' + t("这一步失败了，正在退避等待自动重试，到点会接着跑，不需要手动干预；等不及也可以在详情页手动重试。") + '</p></div>' +
+      '<div class="help-qa"><b>' + t("生成的文件在哪？") + '</b><p>' + t("写作类任务的章节、封面、报告都落在任务的运行目录，详情页「成果」页签可浏览和预览。代码类任务则在仓库的任务分支上改代码，详情页「版本」里审阅后再合并。") + '</p></div>' +
+      '<div class="help-qa"><b>' + t("忘了令牌 / 手机打不开页面？") + '</b><p>' + t("服务启动日志里有带令牌的完整访问地址；远程设备必须用带令牌的 URL 打开（或在令牌门里输入一次），否则会一直要求授权。") + '</p></div>' +
+      '<div class="help-qa"><b>' + t("升级后数据会丢吗？") + '</b><p>' + t("不会。任务、配置、用量台账都在独立的数据目录里，升级只替换程序本体；老版本装新版会自动沿用原数据目录。") + '</p></div>' +
+      '<div class="help-qa"><b>' + t("页面打不开 / 服务起不来？") + '</b><p>' + t("多半是默认端口 8765 被旧进程占着：结束旧的 python 进程，或启动时用 --port 换个端口。还不行就到 GitHub 提 Issue。") + '</p></div>';
+  }
+  const ch = HELP_CHAPTERS.find((c) => c.id === id);
+  if (ch && ch.todo) {
+    return '<div class="help-todo"><b>' + t(ch.label || "") + '</b><p>' +
+      t("本章节正在整理，可先看「快速上手」与「模型接入与绑定」，或到 GitHub 提 Issue 提问。") + '</p></div>';
+  }
+  return "";
+}
+
+function renderHelp() {
+  const toc = $("help-toc");
+  if (toc) {
+    toc.innerHTML = HELP_CHAPTERS.map((c) =>
+      '<button class="hitem' + (c.id === helpCur ? " active" : "") + (c.todo ? " todo" : "") +
+      '" data-ch="' + c.id + '" onclick="helpGo(\'' + c.id + '\')">' +
+      '<svg class="ico" aria-hidden="true"><use href="#' + c.icon + '"></use></svg><span>' + t(c.label) + '</span>' +
+      (c.todo ? '<em class="h-todo">' + t("整理中") + '</em>' : "") +
+      '</button>').join("");
+  }
+  const body = $("help-body");
+  if (body) {
+    body.innerHTML = helpChapterBody(helpCur);
+  }
+}
+function setHelpChapter(id) {
+  helpCur = HELP_CHAPTERS.some((c) => c.id === id) ? id : "quickstart";
+  renderHelp();
+}
+function helpGo(id) { setHelpChapter(id); }
+function paintHelpChrome() {
+  const badge = $("welcome-badge");
+  if (badge) badge.textContent = t(helpFirst ? "首次启动" : "帮助中心");
+  const title = $("welcome-title");
+  if (title) title.textContent = t(helpFirst ? "欢迎使用 CodeBee" : "帮助中心");
+}
+function welcomeOpen(opts) {
   const w = $("welcome");
   if (!w) return;
   if (!$("token-gate").classList.contains("hidden")) return;
+  helpFirst = !!(opts && opts.firstRun);
+  if (helpFirst) helpCur = "quickstart";
+  else if (opts && opts.topic && HELP_CHAPTERS.some((c) => c.id === opts.topic)) helpCur = opts.topic;
+  paintHelpChrome();
+  renderHelp();
   w.classList.remove("hidden");
   document.body.classList.add("welcome-open");
 }
@@ -8376,11 +8739,22 @@ function welcomeGo(tab) {
 function maybeWelcome() {
   let seen = "";
   try { seen = localStorage.getItem("orch.welcomed"); } catch (e) { /* ignore */ }
-  if (!seen) welcomeOpen();
+  if (!seen) welcomeOpen({ firstRun: true });
 }
 window.welcomeOpen = welcomeOpen;
 window.welcomeClose = welcomeClose;
 window.welcomeGo = welcomeGo;
+window.helpGo = helpGo;
+// 空状态里的「看帮助」链接用：打开帮助中心对应章并吞掉默认跳转
+window.helpOpenTopic = function (topic) { welcomeOpen({ topic: topic }); return false; };
+
+/* 就地帮助问号：页面里任何 .hhelp（data-help-topic）点击直达帮助中心对应章。
+ * 事件委托挂在 document 上，动态渲染出来的问号无需逐个接线。 */
+document.addEventListener("click", (e) => {
+  const btn = e.target && e.target.closest ? e.target.closest(".hhelp") : null;
+  if (!btn) return;
+  welcomeOpen({ topic: btn.dataset.helpTopic });
+});
 
 function renderSu() {
   const info = $("su-info");
@@ -8485,7 +8859,7 @@ async function suCheck() {
   finally { if (b) b.disabled = false; }
   if (!s) { toast(t("检查更新失败：服务未连接"), true); return; }
   if (s.has_update) toast(t("发现新版本 v") + s.latest + t("，点「升级到新版」即可"));
-  else if (s.note) toast(s.note);
+  else if (s.note) toast(t(s.note));
   else toast(t("已是最新版"));
 }
 
@@ -8718,6 +9092,11 @@ function setLangBtn(lang) {
   paintArchToggle();
   syncSideExpandBtn();
   renderCodePreviews();   // 预览徽章是动态文案：语言切换时若停在皮肤页要跟着换
+  // 帮助中心若开着：徽章/标题/目录/正文跟着换语言重画
+  if (!$("welcome").classList.contains("hidden")) {
+    paintHelpChrome();
+    renderHelp();
+  }
   // 重画还在缓存里的页面标题
   const title = $("page-title");
   if (title && S.tab) title.textContent = tabTitle(S.tab);
@@ -9196,7 +9575,7 @@ function collapseDrawerIfMobile() {
 
 function switchTab(name) {
   if (name === "__phone") { openPhoneConnect(); return; }  // 手机连接是弹框，不切页
-  if (name === "__guide") { welcomeOpen(); return; }       // 使用引导是弹层，不切页（设置导航「软件」组）
+  if (name === "__guide") { welcomeOpen(); return; }       // 帮助中心是弹层，不切页（设置导航「软件」组）
   // 导航收进「设置」：进设置后左栏整体换成设置导航，内容铺满
   S.tab = name;
   if (SET_TABS.has(name)) localStorage.setItem("orch.setTab", name);
@@ -9683,6 +10062,7 @@ document.addEventListener("DOMContentLoaded", () => {
         && e.target.tagName !== "TEXTAREA") { _askClose(true); return; }
     // 文件内容弹窗(240) 夹在 ask(250) 与 modal(200) 之间，Esc 同样逐层关
     if (e.key === "Escape" && filePopIsOpen()) { window.filePopClose(); return; }
+    if (e.key === "F1") { e.preventDefault(); welcomeOpen(); return; }   // F1 = 帮助中心（浏览器帮助被拦下）
     if (e.key === "Escape" && !$("welcome").classList.contains("hidden")) { welcomeClose(); return; }
     if (e.key === "Escape" && !$("modal").classList.contains("hidden")) closeModal();
     // 日志抽屉：Esc 收起（最底层，放在弹窗之后）
@@ -9715,6 +10095,7 @@ document.addEventListener("DOMContentLoaded", () => {
   $("btn-zentao-test").addEventListener("click", testZentao);
   $("btn-zentao-scan").addEventListener("click", scanZentao);
   $("btn-zentao-save").addEventListener("click", saveZentao);
+  $("btn-zentao-addprofile").addEventListener("click", ztProfAdd);
   $("auto-filter").addEventListener("click", (e) => {
     const b = e.target.closest("[data-f]");
     if (!b) return;
@@ -9780,7 +10161,7 @@ function cmdkOps() {
     { icon: "i-cpu", label: t("智能体管理"), run: () => switchTab("agents") },
     { icon: "i-chart", label: t("用量统计"), run: () => switchTab("usage") },
     { icon: "i-gear", label: t("设置"), run: () => enterSettings() },
-    { icon: "i-bee", label: t("使用引导"), run: () => welcomeOpen() },
+    { icon: "i-bee", label: t("帮助中心"), run: () => welcomeOpen() },
     { icon: "i-phone", label: t("手机连接"), run: () => switchTab("__phone") },
   ];
 }