codebee 0.1.100 → 0.1.102

package/app/core/store.py

@@ -145,8 +145,15 @@ def create_task(payload):
     goal = _text(payload.get("goal"), "goal")
     workdir = _text(payload.get("workdir"), "workdir")
     if not goal:
-        raise ValueError("目标描述不能为空")
-    title = title or goal.splitlines()[0][:30]  # 标题可省略，自动取目标首行
+        # 扫榜选材的菜单承诺「方向可留空，默认分析总榜热门题材」——
+        # paihang.rank_scan_prompt 与 pipeline 两侧均已支持空 goal，这里放行；
+        # 其余类型目标必填不变。
+        if payload.get("type") == "rank_scan":
+            title = title or flow.get("name") or "扫榜选材"
+        else:
+            raise ValueError("目标描述不能为空")
+    else:
+        title = title or goal.splitlines()[0][:30]  # 标题可省略，自动取目标首行
     if not workdir:
         # 未指定目录 → 用「默认保存路径」（设置里可改；内置回落 <数据目录>/workspace）。
         # 默认路径允许自动创建；用户显式给的目录仍必须已存在。
@@ -1723,12 +1730,27 @@ def retry_task(task_id):
                 # 结构——这正是「重写未达标章」按钮（前端 done+未达标态放行
                 # retry）区别于断点续跑的语义。
                 redo = set()
+                redo_issues = []
                 if (prev.get("verdict") or {}).get("publishable") is False:
                     redo = {int(c["chapter"]) for c in v_scores
                             if not c.get("passed") and c.get("chapter") is not None}
+                    # 未达标原因账（verdict.major_issues，章节级+全局级）随继承
+                    # 下发：流水线把本章点名项与全书级项渲染进重写章起草提示词，
+                    # 作者第一遍就知道往哪改，不再盲写等修订拉回。被 major 点名
+                    # 的过线章一并回炉——总判定卡在 major 上时只重写未过线章
+                    # 消不掉账，「重写未达标章」会空转（2026-10-10 实案）。
+                    for x in (prev.get("verdict") or {}).get("major_issues") or []:
+                        if not isinstance(x, dict):
+                            continue
+                        redo_issues.append(x)
+                        try:
+                            redo.add(int(x.get("chapter")))
+                        except (TypeError, ValueError):
+                            pass
                 if redo:
                     done = [n for n in done if n not in redo]
-                    v_scores = [c for c in v_scores if c.get("passed")]
+                    v_scores = [c for c in v_scores if c.get("passed")
+                                and c.get("chapter") not in redo]
                 if done or redo:
                     if redo:
                         scores = v_scores          # 未达标重写：只带已过线章的分数
@@ -1743,6 +1765,8 @@ def retry_task(task_id):
                         # 落账的 chapter_scores——否则多轮失败恢复会把全部
                         # 已过线章节重新评审（实测一晚白烧数百万 token）
                         "chapter_scores": scores,
+                        # 未达标重写的原因账（达标续跑时为空表）
+                        "redo_issues": redo_issues,
                     }
                     break
         else:
@@ -2111,7 +2135,7 @@ def clear_stream_state(run_id=None, n=None):
 
 def finish_step(run_id, n, status, summary="", exit_code=None,
                 cost_usd=0.0, tokens=0.0, duration_s=None, model=None, output=None,
-                followups=None, thinking=None, partial=False):
+                followups=None, thinking=None, partial=False, acp_events=None):
     with LOCK:
         run = _RUNS.get(run_id)
         if not run:
@@ -2146,6 +2170,9 @@ def finish_step(run_id, n, status, summary="", exit_code=None,
                     s["partial"] = True
                 else:
                     s.pop("partial", None)
+                if acp_events:
+                    s["acp_events"] = [dict(item) for item in acp_events[:200]
+                                       if isinstance(item, dict)]
                 # 收尾即清运行中态：stream/activity/live 只是过程快照，留着会让
                 # 前端把「已结束」的步骤仍当实时流渲染（也白占 run.json 体积）
                 s.pop("stream", None)

package/app/main.py

@@ -2848,6 +2848,7 @@ class Handler(BaseHTTPRequestHandler):
                 "thinking": s.get("thinking") or "",
                 "stream": (s.get("stream") or "") if running else "",
                 "activity": (s.get("activity") or []) if running else [],
+                "acp_events": s.get("acp_events") or [],
                 "live": s.get("live") or 0,
             })
 

package/app/ui/app.js

@@ -3123,7 +3123,20 @@ async function createTask() {
     workdir: $("f-workdir").value.trim(),
     thinking: $("f-thinking").value,
   };
-  if (!payload.goal) {
+  const sandboxBackend = $("f-sandbox-backend").value;
+  if (sandboxBackend === "docker") {
+    const dockerImage = $("f-sandbox-image").value.trim();
+    if (!dockerImage) {
+      msg.className = "msg err";
+      msg.textContent = t("选择 Docker 后请填写镜像名");
+      $("f-sandbox-image").focus();
+      resetSubmit();
+      return;
+    }
+    payload.sandbox = { backend: "docker", docker_image: dockerImage };
+  }
+  // 扫榜选材允许目标留空（菜单承诺：默认分析总榜热门题材），其余类型必填
+  if (!payload.goal && payload.type !== "rank_scan") {
     msg.className = "msg err";
     msg.textContent = t("请先填写目标");
     $("f-goal").focus();
@@ -3252,6 +3265,12 @@ async function createTask() {
   }
 }
 
+function syncSandboxComposer() {
+  const docker = $("f-sandbox-backend") && $("f-sandbox-backend").value === "docker";
+  const row = $("row-sandbox-image");
+  if (row) row.classList.toggle("hidden", !docker);
+}
+
 /* ---------------------------------------------------------- 附件（截图/文件） */
 /* 待提交附件：选中/粘贴即上传到服务端 pending 区，创建任务时随 payload 落盘
  * 到工作目录 _attachments/ 并注入上下文。图片另走 codex 原生 -i 直读；
@@ -3957,6 +3976,10 @@ async function newFromTaskAsync(id) {
   // 不随预填带走：新任务要么重新上传，要么由 _attachments 路径引用
   $("f-context").value = (tk.context || "").split("\n## 附件材料")[0].trimEnd();
   $("f-workdir").value = tk.workdir || "";
+  const taskSandbox = tk.sandbox || {};
+  $("f-sandbox-backend").value = taskSandbox.backend === "docker" ? "docker" : "native";
+  $("f-sandbox-image").value = taskSandbox.docker_image || "";
+  syncSandboxComposer();
   S.atts = []; renderAttachChips();  // 附件清单不继承：同目录引用已随 context 保留
   queueGitProbe();  // 工作目录变了，重新探测代码版本
   $("f-mode").value = ["fast", "expert", "manual"].includes(tk.mode) ? tk.mode : "auto";
@@ -4815,7 +4838,13 @@ window.loadRunCheckpoints = async function (requestedRunId) {
     const run = (S.lastRun && S.lastRun.id === runId) ? S.lastRun : latest;
     box.dataset.hasRestorable = files.some((file) => file.restorable) ? "true" : "false";
     refreshCheckpointRestoreAvailability(run);
-    body.innerHTML = (data.files && data.files.warning ? '<p class="hint">' + esc(data.files.warning) + "</p>" : "") +
+    const checkpoint = data.checkpoint || {};
+    const steps = Array.isArray(checkpoint.steps) ? checkpoint.steps : [];
+    const stepSummary = steps.length ? '<div class="rd-checkpoint-steps"><strong>' + esc(t("步骤回放预览")) + '</strong>' +
+      steps.map((step) => '<div class="rd-checkpoint-step"><span>#' + esc(String(step.step ?? "")) + ' · ' + esc(step.role || t("未命名步骤")) + '</span><span class="chip">' + esc(step.status || step.event || "unknown") + (step.attempt ? ' · ' + esc(t("第") + step.attempt + t("次")) : "") + '</span></div>').join("") +
+      (checkpoint.truncated ? '<p class="hint">' + esc(t("仅显示最近 200 个步骤，共 ") + (checkpoint.total_steps || steps.length)) + '</p>' : '') +
+      (checkpoint.replayable ? '<p class="hint">' + esc(t("所有步骤均已完成，可人工复核后继续")) + '</p>' : '<p class="hint">' + esc(t("无法安全自动回放：") + (checkpoint.blocked_reason || t("需要人工核对"))) + '</p>') + '</div>' : '';
+    body.innerHTML = (data.files && data.files.warning ? '<p class="hint">' + esc(data.files.warning) + "</p>" : "") + stepSummary +
       (files.length ? files.map((file) => '<article class="rd-checkpoint-row"><strong>' + esc(file.path) + '</strong><span class="chip">' + esc(file.status) + (file.restorable ? " · " + esc(t("可恢复")) : "") + '</span><pre>' + esc(file.diff || "") + "</pre></article>").join("") : '<span class="hint">' + esc(t("此运行没有文件快照")) + "</span>");
     box.dataset.runId = runId;
     box.classList.remove("needs-load");
@@ -6185,6 +6214,11 @@ function pbBlock(task, platform) {
       S.pubAuto.running.platform === platform) ? S.pubAuto.running : null;
     if (run && run.status === "running") {
       btns += '<span class="pb-book">' + esc((run.as_draft ? t("存草稿中 ") : t("自动发布中 ")) + run.done + "/" + run.total) + "</span>";
+    }
+    if (run && Array.isArray(run.notes) && run.notes.length) {
+      // 对账剔除/跳过/重试的过程记录（auto 层 notes），最近三条
+      btns += '<div class="pb-hint">' +
+        esc(run.notes.slice(-3).join("；")) + "</div>";
     } else if (au.pending > 0) {
       // 门禁不再禁用按钮：点了走 pbApiWithQualityOverride 的复审/强制对话，
       // 死按钮只会让用户无路可走（2026-10-08 实案：guard false 全灰点不了）
@@ -6209,9 +6243,6 @@ function pbBlock(task, platform) {
       const key = task.id + ":" + platform;
       const sig = its.map((x) => x.n).join(",");
       S.pbSel = S.pbSel || {};
-      if (!S.pbSel[key] || S.pbSel[key].sig !== sig)
-        S.pbSel[key] = { sig, sel: new Set(its.map((x) => x.n)) };
-      const sel = S.pbSel[key].sel;
       // 连续段按卷名分组；无卷计划的整块平铺不显示卷头
       const groups = [];
       for (const x of its) {
@@ -6219,10 +6250,22 @@ function pbBlock(task, platform) {
         if (g && g.v === x.v) g.ns.push(x.n);
         else groups.push({ v: x.v, ns: [x.n] });
       }
+      if (!S.pbSel[key] || S.pbSel[key].sig !== sig)
+        S.pbSel[key] = { sig, sel: new Set(its.map((x) => x.n)), groups };
+      const sel = S.pbSel[key].sel;
       let chips = "";
-      for (const g of groups) {
-        if (groups.length > 1 || g.v)
-          chips += '<div class="pb-vol">' + esc(g.v || t("未分卷")) + "</div>";
+      for (let gi = 0; gi < groups.length; gi++) {
+        const g = groups[gi];
+        if (groups.length > 1 || g.v) {
+          // 卷头＝整卷开关：全选打勾、部分选中显示 已选/总（2026-10-10 按卷选章）
+          const cnt = g.ns.filter((n) => sel.has(n)).length;
+          const allOn = cnt === g.ns.length;
+          chips += '<div class="pb-vol"><label class="pb-vol-sel' + (allOn ? " on" : "") +
+            '" title="' + esc(t("勾选卷头＝整卷进所选，再点取消")) + '">' +
+            '<input type="checkbox" ' + (allOn ? "checked" : "") +
+            ' onchange="pbSelVolume(\'' + esc(task.id) + "','" + platform + "'," + gi + ',this.checked)">' +
+            esc(g.v || t("未分卷")) + t("（") + (allOn ? "" : cnt + "/") + g.ns.length + t("）") + "</label></div>";
+        }
         for (const n of g.ns)
           chips += '<label class="pb-chip' + (sel.has(n) ? " on" : "") + '">' +
             '<input type="checkbox" ' + (sel.has(n) ? "checked" : "") +
@@ -6580,6 +6623,17 @@ window.pbSelAll = function (taskId, platform, all) {
   S._pbSig = ""; pbKick();
 };
 
+window.pbSelVolume = function (taskId, platform, gi, on) {
+  const key = taskId + ":" + platform;
+  const ent = (S.pbSel || {})[key];
+  const g = ent && ent.groups && ent.groups[gi];
+  if (!g || !g.ns.length) return;
+  if (on) for (const n of g.ns) ent.sel.add(n);
+  else for (const n of g.ns) ent.sel.delete(n);
+  pbSelCountSync(key);
+  S._pbSig = ""; pbKick();
+};
+
 window.pbPublishSelected = async function (taskId, platform, autoSubmit) {
   const key = taskId + ":" + platform;
   const ent = (S.pbSel || {})[key];
@@ -8578,15 +8632,15 @@ function hiveThinkLine(lines) {
  * localStorage 持久化/WebGL 不可用降级，以及把 renderHive 的泳道数据翻译给场景。 —— */
 let hiveScene = null;          // Hive3D 场景实例（懒创建）
 let hiveSceneDead = false;     // WebGL 不可用/上下文丢失——本次页面周期内不再尝试
-let hiveMode = "3d";           // 当前视图模式（orch.hiveView）
+let hiveMode = "live3d";     // live3d is the real scene; reference and 2d remain opt-in views
 let hiveRunId = "";            // 最近一次 renderHive 的 run.id（尾巴/思考缓存键前缀）
 const hiveLiveMeta = {};       // rel -> { started_at }（3D 芯片秒表用）
 let hiveDialogPoll = null;
 let hiveDialogKey = "";
 
-function setHiveSceneButtons(is3d) {
+function setHiveSceneButtons(mode) {
   document.querySelectorAll("[data-hive-view]").forEach((button) => {
-    const active = button.dataset.hiveView === (is3d ? "3d" : "2d");
+    const active = button.dataset.hiveView === mode;
     button.classList.toggle("active", active);
     button.setAttribute("aria-pressed", active ? "true" : "false");
   });
@@ -8657,28 +8711,80 @@ function closeHiveMonitorLog() {
 function setHiveSceneMode(mode, opts) {
   const viewport = $("rd-hive-viewport");
   if (!viewport) return;
-  let is3d = mode !== "2d";
-  if (is3d) {
+  let selected = ["live3d", "2d"].includes(mode) ? mode : "reference";
+  if (selected !== "2d") {
     const sc = ensureHiveScene();
     if (!sc) {
-      is3d = false;
+      selected = "2d";
       if (!(opts && opts.silent)) toast(t("当前环境不支持 WebGL，已切换 2D 列表"), true);
     }
   }
-  hiveMode = is3d ? "3d" : "2d";
-  if (hiveScene) hiveScene.setActive(is3d);
-  viewport.classList.toggle("hive-mode-3d", is3d);
-  viewport.classList.toggle("hive-mode-2d", !is3d);
+  hiveMode = selected;
+  if (hiveScene) {
+    hiveScene.setDisplayMode(selected);
+    hiveScene.setActive(selected !== "2d");
+  }
+  viewport.classList.toggle("hive-mode-3d", selected === "reference");
+  viewport.classList.toggle("hive-mode-live3d", selected === "live3d");
+  viewport.classList.toggle("hive-mode-2d", selected === "2d");
   const tools = document.querySelector(".hive-scene-tools");
-  if (tools) tools.classList.toggle("hive-2d", !is3d);
-  setHiveSceneButtons(is3d);
-  try { localStorage.setItem("orch.hiveView", hiveMode); } catch (e) { /* 隐私模式等 */ }
+  if (tools) tools.classList.toggle("hive-2d", selected === "2d");
+  setHiveSceneButtons(selected);
+  const hint = document.querySelector(".hive-scene-hint");
+  if (hint) {
+    const hintKey = selected === "live3d"
+      ? "拖动旋转 · Shift+拖动平移 · 滚轮缩放 · 双击复位 · 点击屏幕看日志"
+      : selected === "2d" ? "点击格子看日志"
+      : "拖动平移 · 滚轮缩放 · 双击复位 · 点击屏幕看日志";
+    hint.dataset.i18n = hintKey;
+    hint.textContent = t(hintKey);
+  }
+  try { localStorage.setItem("orch.hiveView.v2", hiveMode); } catch (e) { /* 隐私模式等 */ }
+}
+
+function syncHiveFullscreenButton() {
+  const stage = $("hive-scene-stage");
+  const button = $("hive-scene-fullscreen");
+  const active = !!stage && document.fullscreenElement === stage;
+  if (stage) stage.classList.toggle("is-fullscreen", active);
+  if (!button) return;
+  const textKey = active ? "退出全屏" : "全屏";
+  const labelKey = active ? "退出全屏" : "进入全屏";
+  button.dataset.i18n = textKey;
+  button.dataset.i18nTitle = labelKey;
+  button.dataset.i18nAria = labelKey;
+  button.textContent = t(textKey);
+  button.title = t(labelKey);
+  button.setAttribute("aria-label", t(labelKey));
+  button.setAttribute("aria-pressed", active ? "true" : "false");
+}
+
+async function toggleHiveFullscreen() {
+  const stage = $("hive-scene-stage");
+  if (!stage) return;
+  try {
+    if (document.fullscreenElement === stage) {
+      await document.exitFullscreen();
+      return;
+    }
+    if (typeof stage.requestFullscreen !== "function" || document.fullscreenEnabled === false) {
+      toast(t("当前浏览器不支持全屏"), true);
+      return;
+    }
+    await stage.requestFullscreen();
+  } catch (error) {
+    toast(t("全屏失败：") + (error && error.message ? error.message : ""), true);
+  }
 }
 
 function setupHiveSceneControls() {
   const viewport = $("rd-hive-viewport");
   if (!viewport || viewport.dataset.controlsReady) return;
   viewport.dataset.controlsReady = "true";
+  const fullscreenButton = $("hive-scene-fullscreen");
+  if (fullscreenButton) fullscreenButton.addEventListener("click", toggleHiveFullscreen);
+  document.addEventListener("fullscreenchange", syncHiveFullscreenButton);
+  syncHiveFullscreenButton();
   const hiveDialog = $("hive-log-dialog");
   const hiveClose = $("hive-log-close");
   if (hiveClose) hiveClose.addEventListener("click", closeHiveMonitorLog);
@@ -8691,14 +8797,23 @@ function setupHiveSceneControls() {
   });
   document.querySelectorAll("[data-hive-scene-action]").forEach((button) => {
     button.addEventListener("click", () => {
-      if (hiveMode !== "3d" || !hiveScene) return;
+      if (hiveMode === "2d" || !hiveScene) return;
       if (button.dataset.hiveSceneAction === "reset") hiveScene.resetView();
       else hiveScene.zoomAt(button.dataset.hiveSceneAction === "zoom-in" ? 1 / 1.18 : 1.18);
     });
   });
-  let saved = "3d";
-  try { saved = localStorage.getItem("orch.hiveView") || "3d"; } catch (e) { /* ignore */ }
-  setHiveSceneMode(saved === "2d" ? "2d" : "3d", { silent: true });
+  let saved = "live3d";
+  try {
+    saved = localStorage.getItem("orch.hiveView.v2") || "";
+    if (!saved) {
+      // Migrate an explicitly selected 2D/live3D preference; the old default "reference"
+      // was auto-persisted for every new visitor, so it is not a reliable user preference.
+      const legacy = localStorage.getItem("orch.hiveView");
+      saved = legacy === "2d" || legacy === "live3d" ? legacy : "live3d";
+      localStorage.setItem("orch.hiveView.v2", saved);
+    }
+  } catch (e) { /* ignore storage restrictions and keep the live 3D default */ }
+  setHiveSceneMode(["reference", "live3d", "2d"].includes(saved) ? saved : "live3d", { silent: true });
 }
 
 /* renderHive → 场景数据翻译：泳道=蜂巢塔的一层，格子按状态映射高度/颜色。
@@ -8758,7 +8873,8 @@ function hiveSceneSync(run, lanes, byStage) {
   const sc = ensureHiveScene();
   if (!sc) return;
   sc.sync(model);                    // 2D 模式也同步：切回 3D 时数据即 ready（画布未激活零 GPU 开销）
-  sc.setActive(hiveMode === "3d");
+  sc.setDisplayMode(hiveMode);
+  sc.setActive(hiveMode !== "2d");
 }
 
 window.renderHive = function (run) {
@@ -9322,6 +9438,20 @@ function chatThinkHTML(it) {
     '<div class="ct-body">' + esc(think) + "</div></details>";
 }
 
+function chatAcpEventsHTML(it) {
+  const events = Array.isArray(it.acp_events) ? it.acp_events.slice(-8) : [];
+  if (!events.length) return "";
+  return '<details class="chat-think chat-acp-events"><summary>' + esc(t("ACP 活动")) +
+    '<span class="ct-len">' + events.length + ' ' + esc(t("条")) + '</span></summary>' +
+    '<div class="ct-acts">' + events.map((event) => {
+      const type = String(event.sessionUpdate || "event");
+      const label = event.title || event.status || event.modeId || "";
+      const entries = Array.isArray(event.entries) ? event.entries.map((entry) =>
+        '<div class="rd-acp-plan-entry">' + esc(entry.status || "") + ' · ' + esc(entry.content || "") + '</div>').join("") : "";
+      return '<div><code>' + esc(type) + '</code>' + (label ? ' · ' + esc(label) : "") + entries + '</div>';
+    }).join("") + '</div></details>';
+}
+
 /* 运行中直连对话的快轮询：SSE/轮询最密 2s、闲时 8s，思考是逐句吐的——
  * 1.2s 直拉时间线把增量打印出来。run 终态、切详情、分区隐藏即停。 */
 function stopChatLive() {
@@ -9424,6 +9554,7 @@ function drawChatFlow(run, data, active) {
     (it.status || "") + ":" + String(it.text || "").length + ":" +
     String(it.thinking || "").length + ":" + String(it.stream || "").length + ":" +
     (it.activity || []).length + ":" + (it.followups || []).length +
+    ":" + (it.acp_events || []).length +
     ":" + (it.consumed ? 1 : 0), "") + "|" + ((data && data.result) ? "r" : "");
   if (liveSig === chatLiveSig && flow.childElementCount) return;
   chatLiveSig = liveSig;
@@ -9497,6 +9628,7 @@ function drawChatFlow(run, data, active) {
       '<span class="chat-avatar" aria-hidden="true"><svg class="ico"><use href="#i-bee"></use></svg></span>' +
       '<div class="chat-bubble agent">' +
       chatThinkHTML(it) +
+      chatAcpEventsHTML(it) +
       '<div class="chat-body">' + bodyHtml + "</div>" +
       '<div class="chat-meta">' + esc(it.who || "") + " " + esc(chatTime(it.at)) +
       (metaBad ? " · " + t(it.status === "failed" ? "失败" : "已取消") : "") + actsA + "</div>" +
@@ -10389,7 +10521,7 @@ function codeThemeFor(mode) {
   return ok ? ok.id : (mode === "dark" ? "github-dark" : "github");
 }
 function codeLineNum() { return localStorage.getItem(CT_LINENUM_KEY) !== "0"; }   // 缺省开
-function codeWrap() { return localStorage.getItem(CT_WRAP_KEY) === "1"; }
+function codeWrap() { return localStorage.getItem(CT_WRAP_KEY) !== "0"; }   // 缺省开：长行自动换行，别撑出横向滚动条
 function codeFontSize() {
   const n = parseFloat(localStorage.getItem(CT_SIZE_KEY) || "12.5");
   return isFinite(n) ? Math.min(22, Math.max(10, n)) : 12.5;
@@ -16070,6 +16202,9 @@ window.suRestart = suRestart;
 window.updDismiss = updDismiss;
 
 document.addEventListener("DOMContentLoaded", () => {
+  // Initialize Hive3D controls independently of run data. A fresh workspace may have no
+  // active run yet, but fullscreen/view controls must still be wired and usable.
+  setupHiveSceneControls();
   // 远程地址里带的 ?token= 存起来并从地址栏抹掉，之后所有请求走请求头
   const urlTok = new URLSearchParams(location.search).get("token");
   if (urlTok) {
@@ -16411,6 +16546,8 @@ document.addEventListener("DOMContentLoaded", () => {
   localStorage.removeItem("orch.showArchived");   // 清掉旧版持久化残留，避免误解为默认选中
   $("f-resume-agent").addEventListener("change", loadSessions);
   $("f-resume-session").addEventListener("change", showResumeHint);
+  $("f-sandbox-backend").addEventListener("change", syncSandboxComposer);
+  syncSandboxComposer();
   /* 工作目录不再用「上次用过」的旧记忆预填：那样改默认保存路径后，新建任务仍会被
    * 旧目录盖过。首屏默认选中设置里的默认路径（loadSettings 落值），克隆/右键新建
    * 等显式入口各自直接写字段值，不跨刷新持久化。清掉旧版残留键，避免误解为默认选中。 */