codebee 0.1.66 → 0.1.68

package/app/ui/style.css

@@ -18,6 +18,7 @@
   --log-bg: #161616;
   --log-text: #c3c9d6;
   --shadow: 0 18px 48px rgba(7, 19, 38, .16);
+  --mask: rgba(0, 0, 0, .5);
   --mono: "Cascadia Code", Consolas, monospace;
   --font-ui: "Aptos", "Segoe UI", sans-serif;
   --font-display: "Aptos Display", "Trebuchet MS", sans-serif;
@@ -1134,7 +1135,7 @@ body.inspector-open #inspector { display: flex; }
   }
   body.inspector-open #insp-mask {
     display: block; position: fixed; inset: 0; z-index: 55;
-    background: rgba(0, 0, 0, .45);
+    background: var(--mask);
   }
 }
 
@@ -1155,7 +1156,7 @@ body.inspector-open #inspector { display: flex; }
   body:not(.side-collapsed) #sidebar { transform: none; }
   body:not(.side-collapsed) #drawer-mask {
     display: block; position: fixed; inset: 0; z-index: 55;
-    background: rgba(0, 0, 0, .45);
+    background: var(--mask);
   }
   main { padding: 18px 14px 70px; }
   .panel { padding: 16px; }
@@ -1424,7 +1425,7 @@ details.prow-hidden[open] > summary { margin-bottom: 6px; }
 
 /* ---- 通用弹框 ---- */
 .modal-wrap { position: fixed; inset: 0; z-index: 200; display: flex; align-items: center; justify-content: center; padding: 24px; }
-.modal-mask { position: absolute; inset: 0; background: rgba(0, 0, 0, .5); }
+.modal-mask { position: absolute; inset: 0; background: var(--mask); }
 .modal {
   position: relative; width: 100%; max-width: 620px; max-height: calc(100vh - 48px);
   display: flex; flex-direction: column; background: var(--bg);
@@ -1901,7 +1902,7 @@ html[data-theme="light"] .seg-btn.active { box-shadow: 0 1px 3px rgba(0, 0, 0, .
  * 层级 240：高于主 modal(200)、低于 #ask(250)，Esc 逐层关 */
 #file-pop {
   position: fixed; inset: 0; z-index: 240; display: flex; align-items: center; justify-content: center;
-  padding: 4vh 4vw; background: rgba(0, 0, 0, 0.45);
+  padding: 4vh 4vw; background: var(--mask);
 }
 #file-pop.hidden { display: none; }
 #file-pop .fp-panel {
@@ -2386,7 +2387,7 @@ html.code-wrap #file-pop .fp-ln { white-space: pre-wrap; word-break: break-word;
 /* ============ 命令面板（Ctrl+K / 侧栏搜索行唤起）============ */
 .cmdk-mask {
   position: fixed; inset: 0; z-index: 300;
-  background: rgba(0, 0, 0, .45); backdrop-filter: blur(2px);
+  background: var(--mask); backdrop-filter: blur(2px);
   display: flex; align-items: flex-start; justify-content: center; padding-top: 11vh;
 }
 .cmdk-mask.hidden { display: none; }
@@ -2589,15 +2590,15 @@ details.sf-dir > summary i, a.sf-file i { font-style: normal; color: var(--muted
   user-select: none;
 }
 .health-banner.alerting {
-  background: rgba(220, 38, 38, 0.14);
-  color: #dc2626;
-  border: 1px solid rgba(220, 38, 38, 0.45);
+  background: color-mix(in srgb, var(--bad) 14%, transparent);
+  color: var(--bad);
+  border: 1px solid color-mix(in srgb, var(--bad) 45%, transparent);
   animation: health-pulse 2s ease-in-out infinite;
 }
 .health-banner.recovered {
-  background: rgba(34, 197, 94, 0.12);
-  color: #16a34a;
-  border: 1px solid rgba(34, 197, 94, 0.4);
+  background: color-mix(in srgb, var(--ok) 12%, transparent);
+  color: var(--ok);
+  border: 1px solid color-mix(in srgb, var(--ok) 40%, transparent);
 }
 @keyframes health-pulse {
   0%, 100% { opacity: 1; }
@@ -2612,15 +2613,15 @@ details.sf-dir > summary i, a.sf-file i { font-style: normal; color: var(--muted
 
 /* ---- 供应商健康告警弹框：禁用厂商的危险按钮 ---- */
 .modal-foot button.danger {
-  background: rgba(220, 38, 38, 0.12);
-  color: #dc2626;
-  border: 1px solid rgba(220, 38, 38, 0.45);
+  background: color-mix(in srgb, var(--bad) 12%, transparent);
+  color: var(--bad);
+  border: 1px solid color-mix(in srgb, var(--bad) 45%, transparent);
 }
-.modal-foot button.danger:hover { background: rgba(220, 38, 38, 0.22); }
+.modal-foot button.danger:hover { background: color-mix(in srgb, var(--bad) 22%, transparent); }
 
 /* 运行中指挥：未消费指令的撤回按钮（贴右侧，hover 提亮） */
 .rd-msg .m-retract { float: right; margin-left: 8px; padding: 0 7px; font-size: 11.5px; opacity: .8; }
-.rd-msg .m-retract:hover { opacity: 1; color: #dc2626; border-color: rgba(220, 38, 38, .45); }
+.rd-msg .m-retract:hover { opacity: 1; color: var(--bad); border-color: color-mix(in srgb, var(--bad) 45%, transparent); }
 
 /* 外部目录滚动分页：续页提示行 + 哨兵（追加于文件尾，防并行重排） */
 .mkr-more { display: flex; align-items: center; justify-content: center; gap: 10px; padding: 10px 0 2px; }
@@ -5010,7 +5011,7 @@ html::-webkit-scrollbar-track { background: transparent; }
 
 /* ---- 帮助中心（首启欢迎引导升级版）：左目录右内容，随皮肤 accent ---- */
 .welcome-wrap { position: fixed; inset: 0; z-index: 195; display: flex; align-items: center; justify-content: center; padding: 24px; }
-.welcome-mask { position: absolute; inset: 0; background: rgba(0, 0, 0, .5); }
+.welcome-mask { position: absolute; inset: 0; background: var(--mask); }
 .welcome-card {
   position: relative; display: flex; width: min(920px, 100%); height: min(620px, calc(100vh - 48px));
   background: var(--bg); border: 1px solid var(--border-strong);
@@ -5338,7 +5339,7 @@ body.welcome-open { overflow: hidden; }
   flex-direction: column; gap: 10px; min-height: 46px; }
 .bee-digest { border: 1px solid var(--border); border-radius: var(--r-md); padding: 8px 10px; }
 .bee-digest-head { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; margin-bottom: 6px; }
-.bee-tag { background: rgba(245, 185, 66, .16); color: var(--warn);
+.bee-tag { background: color-mix(in srgb, var(--warn) 16%, transparent); color: var(--warn);
   border-radius: 6px; padding: 1px 8px; font-size: 12px; font-weight: 600; }
 .bee-meta { font-size: 11.5px; color: var(--muted); }
 .bee-text { font-size: 12.5px; line-height: 1.55; white-space: pre-wrap;
@@ -5382,7 +5383,7 @@ body.welcome-open { overflow: hidden; }
 .bee-g { display: flex; align-items: center; gap: 8px; padding: 3px 6px;
   border-radius: 6px; cursor: pointer; font-size: 12.5px; }
 .bee-g:hover { background: var(--panel2); }
-.bee-g.on { background: rgba(245, 185, 66, .12); }
+.bee-g.on { background: color-mix(in srgb, var(--warn) 12%, transparent); }
 .bee-g span:first-of-type { flex: 1; overflow: hidden; text-overflow: ellipsis;
   white-space: nowrap; }
 .bee-g input { flex: none; }
@@ -6091,10 +6092,10 @@ button.request-busy > * { opacity: .18; }
 .outcome-warn {
   margin-top: 8px;
   padding: 8px 10px;
-  border: 1px solid rgba(217, 119, 6, .45);
+  border: 1px solid color-mix(in srgb, var(--warn) 45%, transparent);
   border-radius: 8px;
-  background: rgba(217, 119, 6, .08);
-  color: #b45309;
+  background: color-mix(in srgb, var(--warn) 8%, transparent);
+  color: var(--warn);
   font-size: 12px;
   line-height: 1.5;
 }
@@ -6102,6 +6103,77 @@ button.request-busy > * { opacity: .18; }
 /* 「完成·未达标」：跑完但评审未过——不用成功绿，用琥珀警告色（2026-09-23
  * 禅道双单实案：用户把未达标误读成修好了） */
 .chip.done.unqualified {
-  background: color-mix(in srgb, #d97706 16%, transparent);
-  color: #b45309;
+  background: color-mix(in srgb, var(--warn) 16%, transparent);
+  color: var(--warn);
+}
+
+/* ---- 市场安装预览弹框（先看后装，两阶段确认；追加于文件尾防并行重排） ---- */
+.mkpv-name { font-size: 14px; font-weight: 700; margin-bottom: 4px; }
+.mkpv-meta { display: flex; flex-wrap: wrap; gap: 6px 14px; font-size: 12.5px; color: var(--muted); margin-bottom: 8px; }
+.mkpv-skills { display: flex; flex-wrap: wrap; align-items: center; gap: 6px; margin: 0 0 8px; font-size: 12.5px; }
+.mkpv-sum { font-size: 12.5px; color: var(--muted); margin-bottom: 6px; }
+.mkpv-files { width: 100%; border-collapse: collapse; font-family: var(--mono); font-size: 11.5px; margin: 4px 0 10px; }
+.mkpv-files th { text-align: left; font-family: var(--font-ui); font-size: 11.5px; color: var(--muted); font-weight: 600; padding: 2px 10px 4px 0; border-bottom: 1px solid var(--border-strong); }
+.mkpv-files td { padding: 2px 10px 2px 0; border-bottom: 1px solid var(--border); max-width: 400px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.mkpv-files td.mkpv-chars { color: var(--muted); white-space: nowrap; text-align: right; }
+.mkpv-files td.mkpv-more, .mkpv-strip li.mkpv-more { color: var(--muted); list-style: none; }
+.mkpv-sec { font-size: 12.5px; color: var(--warn); margin: 6px 0 4px; }
+.mkpv-strip { margin: 2px 0 8px 16px; padding: 0; font-family: var(--mono); font-size: 11.5px; color: var(--muted); max-height: 110px; overflow: auto; }
+.mkpv-strip li { margin: 1px 0; }
+
+/* 「已安装 N」过滤入口：active 时随 accent 提亮 */
+#mkr-installed.active { border-color: color-mix(in srgb, var(--accent) 55%, transparent); color: var(--accent); }
+
+/* ---- docx 只读预览（渲染器注入的 .docx-wrapper 改随皮肤；纸面保持白——
+ *      文档画布是内容不是 UI，白底是刻意的（令牌规则豁免项）） ---- */
+#file-pop .fp-docx { min-height: 100%; padding: 12px; }
+#file-pop .fp-docx .docx-wrapper { background: transparent; padding: 0; }
+#file-pop .fp-docx .docx-wrapper > section.docx {
+  background: #fff; color: #000; margin-bottom: 14px;
+  box-shadow: 0 2px 12px rgba(0, 0, 0, .3);
+}
+#file-pop .fp-docx-load { padding: 24px 18px; color: var(--muted); font-size: 12.5px; }
+
+/* 步骤卡「实际用上游」小徽章（借鉴 WorkDSH ResolvedExecutionBinding，追加于文件尾
+ * 防并行重排）：与 st-model 同族但用独立类名——ui_hive_model_think 断言
+ * .st-model 徽章数，复用类名会破锚点。虚线边框与模型徽章区分。 */
+.step .st-prov {
+  font-size: 10.5px; color: var(--muted); opacity: .85;
+  border: 1px dashed var(--border); border-radius: 999px; padding: 0 7px; line-height: 16px;
+  max-width: 200px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+}
+
+/* PDF/xlsx 只读预览（成品弹窗，WorkDSH「真任务以可读产物收尾」切片；
+ * 追加于文件尾防并行重排）。PDF 纸面白底与 docx 同理：文档画布是内容不是 UI */
+#file-pop .fp-pdf { padding: 12px; display: flex; flex-direction: column; align-items: center; gap: 12px; }
+#file-pop .fp-pdf canvas.fp-pdf-page {
+  background: #fff; box-shadow: 0 2px 12px rgba(0, 0, 0, .3); max-width: 100%;
+}
+#file-pop .fp-xlsx { padding: 12px; overflow: auto; }
+.fp-xls-tabs { display: flex; flex-wrap: wrap; gap: 6px; margin-bottom: 8px; }
+.fp-xls-tabs .fp-xls-tab.active {
+  border-color: color-mix(in srgb, var(--accent) 55%, transparent);
+  color: var(--accent);
 }
+table.fp-xls { border-collapse: collapse; font-family: var(--mono); font-size: 11.5px; }
+.fp-xls th, .fp-xls td {
+  border: 1px solid var(--border); padding: 2px 8px; white-space: nowrap;
+  max-width: 320px; overflow: hidden; text-overflow: ellipsis;
+}
+.fp-xls th { color: var(--muted); font-weight: 600; font-family: var(--font-ui); }
+
+/* ---------------- 成品两版对比（artdiff.js + artifactDiffBody） ----------------
+ * 行色复用 insp-plus/insp-minus 同源变量（var(--ok)/var(--bad)），随皮肤走。 */
+.art-diff { margin: 0; padding: 6px 0 10px; font-family: var(--mono); font-size: 12px; line-height: 1.6; }
+.art-diff .dl-ln { display: flex; gap: 8px; padding: 0 14px; white-space: pre-wrap; word-break: break-word; }
+.art-diff .dl-ln i { flex: none; width: 12px; text-align: center; font-style: normal; opacity: .75; }
+.art-diff .dl-eq { color: var(--muted); }
+.art-diff .dl-add { color: var(--ok); background: color-mix(in srgb, var(--ok) 10%, transparent); }
+.art-diff .dl-del { color: var(--bad); background: color-mix(in srgb, var(--bad) 10%, transparent); text-decoration: none; }
+.art-diff .dl-gap { padding: 4px 14px; color: var(--muted); font-family: var(--font-ui); font-size: 11px; opacity: .85; }
+
+/* 任务总时限行（任务信息弹层内，rd-meta 下方独立一行；不随轮询重建） */
+.rd-timeout-row { display: flex; align-items: center; gap: 8px; padding: 8px 14px; border-top: 1px solid var(--hairline, rgba(128,128,128,.18)); font-size: 12px; }
+.rd-timeout-row label { color: var(--muted); white-space: nowrap; }
+.rd-timeout-row select { flex: 0 0 auto; min-width: 96px; }
+.rd-timeout-row select:disabled { opacity: .55; cursor: not-allowed; }

package/bin/tutti.js

@@ -1,147 +1,147 @@
-#!/usr/bin/env node
-'use strict';
-/*
- * CodeBee 启动垫片：在本机找 Python 3.8+，以子进程方式运行包内 app/main.py。
- * npm 只负责分发与版本管理，不携带解释器——所以运行时才探测 python，
- * 找不到就报错并给出安装指引（不写 postinstall，避免在别人机器上制造环境事故）。
- *
- * 安全边界：
- *  - 子进程可执行文件全部是本文件内的字面量（py / python / python3）——包括
- *    TUTTI_PYTHON 覆盖时：它只允许在这三个字面量里选一个，绝不拼接任意路径；
- *  - 参数数组全由字面量常量拼成，不启用 shell；
- *  - 探测只传 `--version`（不向解释器传递任何代码）；Windows 商店的 python.exe
- *    假占位会非零退出，被 catch 后自然跳过；
- *  - 用户参数逐个过白名单校验（仅字母数字与 _ - . : = / @ % 空格），
- *    含 shell 元字符/控制字符的参数直接拒绝。
- */
-const { execFileSync, spawn } = require('child_process');
-const path = require('path');
-
-const MIN_MAJOR = 3;
-const MIN_MINOR = 8;
-const MAIN = path.join(__dirname, '..', 'app', 'main.py');
-const SAFE_ARG = /^[A-Za-z0-9_\-.:=/@% ]+$/;
-
-// 解析 `--version` 输出：形如 "Python 3.12.4"，返回 {ver, major, minor} 或 null。
-// 纯字符串切分，不用正则匹配执行路径。
-function parseVersion(text) {
-  const at = String(text).indexOf('Python ');
-  if (at === -1) return null;
-  const parts = String(text).slice(at + 7).trim().split(' ')[0].split('.');
-  const major = Number(parts[0]);
-  const minor = Number(parts[1]);
-  if (!Number.isFinite(major) || !Number.isFinite(minor)) return null;
-  return { ver: major + '.' + minor, major: major, minor: minor };
-}
-
-function probePy() {
-  try {
-    return parseVersion(execFileSync('py', ['-3', '--version'],
-      { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }));
-  } catch (e) { return null; }
-}
-function probePython() {
-  try {
-    return parseVersion(execFileSync('python', ['--version'],
-      { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }));
-  } catch (e) { return null; }
-}
-function probePython3() {
-  try {
-    return parseVersion(execFileSync('python3', ['--version'],
-      { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }));
-  } catch (e) { return null; }
-}
-
-// 探测顺序：win32 优先 py 启动器（跨版本选真 3.x），其余按 python3 → python。
-function resolvePython() {
-  const order = process.platform === 'win32'
-    ? [['py', probePy], ['python', probePython], ['python3', probePython3]]
-    : [['python3', probePython3], ['python', probePython]];
-  for (const [name, probe] of order) {
-    const hit = probe();
-    if (!hit) continue;
-    if (hit.major > MIN_MAJOR || (hit.major === MIN_MAJOR && hit.minor >= MIN_MINOR)) {
-      return { name: name };
-    }
-    return { tooOld: true, name: name, ver: hit.ver };
-  }
-  return null;
-}
-
-function guide() {
-  const url = { win32: 'https://www.python.org/downloads/windows/',
-    darwin: 'https://www.python.org/downloads/macos/',
-    linux: 'https://docs.python.org/3/using/unix.html' }[process.platform]
-    || 'https://www.python.org/downloads/';
-  return 'CodeBee 需要本机安装 Python 3.8+（npm 包不含解释器）。\n'
-    + '  · 安装：' + url + '\n'
-    + '  · Windows 安装时勾选 “Add python.exe to PATH”（自带 py 启动器）\n'
-    + '装好后重新运行：codebee';
-}
-
-const py = resolvePython();
-if (!py) {
-  console.error('[CodeBee] 未找到可用的 Python。\n' + guide());
-  process.exit(1);
-}
-if (py.tooOld) {
-  console.error('[CodeBee] 找到 ' + py.name + '（' + py.ver + '），但版本过低。\n' + guide());
-  process.exit(1);
-}
-
-const userArgs = [];
-for (const a of process.argv.slice(2)) {
-  if (typeof a === 'string' && SAFE_ARG.test(a)) {
-    userArgs.push(a);
-  } else {
-    console.error('[CodeBee] 参数含非法字符，已拒绝：' + String(a).slice(0, 80));
-    process.exit(2);
-  }
-}
-
-// CLI 转发契约：codebee 之后的用户参数（已过白名单）原样作为 main.py 的 argv。
-// 控制台日志即见：GBK 控制台下强制 UTF-8 输出（否则中文 print 触发 UnicodeEncodeError 静默卡死）。
-const childEnv = Object.assign({}, process.env, { PYTHONIOENCODING: 'utf-8', PYTHONUTF8: '1', PYTHONUNBUFFERED: '1' });
-// TUTTI_PYTHON 覆盖解释器：只允许在三个字面量里选（py/python/python3，.exe
-// 后缀可选、大小写不限）——环境变量永远只做「选择题」，不做「填空题」；
-// 机器上有多个解释器且探测选错时，用它切换。
-let exe = py.name;
-const ovRaw = String(process.env.TUTTI_PYTHON || '').trim().toLowerCase();
-const ov = ovRaw.endsWith('.exe') ? ovRaw.slice(0, -4) : ovRaw;
-if (ov === 'python') {
-  exe = 'python';
-} else if (ov === 'python3') {
-  exe = 'python3';
-} else if (ov === 'py') {
-  exe = 'py';
-}
-
-let child;
-if (exe === 'py') {
-  child = spawn('py', ['-3', MAIN, ...userArgs], { stdio: 'inherit', env: childEnv });
-} else if (exe === 'python') {
-  child = spawn('python', [MAIN, ...userArgs], { stdio: 'inherit', env: childEnv });
-} else {
-  child = spawn('python3', [MAIN, ...userArgs], { stdio: 'inherit', env: childEnv });
-}
-console.log('[CodeBee] 正在启动（Python: ' + exe + '）… 浏览器将自动打开 http://127.0.0.1:8765；'
-  + '本窗口保持开着就是服务，Ctrl+C 退出。');
-
-for (const sig of ['SIGINT', 'SIGTERM']) {
-  process.on(sig, () => { try { child.kill(sig); } catch (e) { /* 已退出 */ } });
-}
-const t0 = Date.now();
-child.on('exit', (code, signal) => {
-  if (!signal && code != null && code !== 0 && Date.now() - t0 < 4000) {
-    // 秒退：多半是 py 启动器指到了坏解释器（如损坏的 Anaconda）。给排障出口。
-    console.error('[CodeBee] 启动失败：Python 进程 ' + (code ? '退出码 ' + code : '异常终止') + '。'
-      + '\n  · 运行 python --version 确认可用且为 3.8+'
-      + '\n  · 若装有多个 Python，可设环境变量 TUTTI_PYTHON 切换（cmd：set TUTTI_PYTHON=python）');
-  }
-  process.exit(signal ? 1 : (code == null ? 0 : code));
-});
-child.on('error', (e) => {
-  console.error('[CodeBee] 无法启动 Python：' + e.message);
-  process.exit(1);
-});
+#!/usr/bin/env node
+'use strict';
+/*
+ * CodeBee 启动垫片：在本机找 Python 3.8+，以子进程方式运行包内 app/main.py。
+ * npm 只负责分发与版本管理，不携带解释器——所以运行时才探测 python，
+ * 找不到就报错并给出安装指引（不写 postinstall，避免在别人机器上制造环境事故）。
+ *
+ * 安全边界：
+ *  - 子进程可执行文件全部是本文件内的字面量（py / python / python3）——包括
+ *    TUTTI_PYTHON 覆盖时：它只允许在这三个字面量里选一个，绝不拼接任意路径；
+ *  - 参数数组全由字面量常量拼成，不启用 shell；
+ *  - 探测只传 `--version`（不向解释器传递任何代码）；Windows 商店的 python.exe
+ *    假占位会非零退出，被 catch 后自然跳过；
+ *  - 用户参数逐个过白名单校验（仅字母数字与 _ - . : = / @ % 空格），
+ *    含 shell 元字符/控制字符的参数直接拒绝。
+ */
+const { execFileSync, spawn } = require('child_process');
+const path = require('path');
+
+const MIN_MAJOR = 3;
+const MIN_MINOR = 8;
+const MAIN = path.join(__dirname, '..', 'app', 'main.py');
+const SAFE_ARG = /^[A-Za-z0-9_\-.:=/@% ]+$/;
+
+// 解析 `--version` 输出：形如 "Python 3.12.4"，返回 {ver, major, minor} 或 null。
+// 纯字符串切分，不用正则匹配执行路径。
+function parseVersion(text) {
+  const at = String(text).indexOf('Python ');
+  if (at === -1) return null;
+  const parts = String(text).slice(at + 7).trim().split(' ')[0].split('.');
+  const major = Number(parts[0]);
+  const minor = Number(parts[1]);
+  if (!Number.isFinite(major) || !Number.isFinite(minor)) return null;
+  return { ver: major + '.' + minor, major: major, minor: minor };
+}
+
+function probePy() {
+  try {
+    return parseVersion(execFileSync('py', ['-3', '--version'],
+      { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }));
+  } catch (e) { return null; }
+}
+function probePython() {
+  try {
+    return parseVersion(execFileSync('python', ['--version'],
+      { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }));
+  } catch (e) { return null; }
+}
+function probePython3() {
+  try {
+    return parseVersion(execFileSync('python3', ['--version'],
+      { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }));
+  } catch (e) { return null; }
+}
+
+// 探测顺序：win32 优先 py 启动器（跨版本选真 3.x），其余按 python3 → python。
+function resolvePython() {
+  const order = process.platform === 'win32'
+    ? [['py', probePy], ['python', probePython], ['python3', probePython3]]
+    : [['python3', probePython3], ['python', probePython]];
+  for (const [name, probe] of order) {
+    const hit = probe();
+    if (!hit) continue;
+    if (hit.major > MIN_MAJOR || (hit.major === MIN_MAJOR && hit.minor >= MIN_MINOR)) {
+      return { name: name };
+    }
+    return { tooOld: true, name: name, ver: hit.ver };
+  }
+  return null;
+}
+
+function guide() {
+  const url = { win32: 'https://www.python.org/downloads/windows/',
+    darwin: 'https://www.python.org/downloads/macos/',
+    linux: 'https://docs.python.org/3/using/unix.html' }[process.platform]
+    || 'https://www.python.org/downloads/';
+  return 'CodeBee 需要本机安装 Python 3.8+（npm 包不含解释器）。\n'
+    + '  · 安装：' + url + '\n'
+    + '  · Windows 安装时勾选 “Add python.exe to PATH”（自带 py 启动器）\n'
+    + '装好后重新运行：codebee';
+}
+
+const py = resolvePython();
+if (!py) {
+  console.error('[CodeBee] 未找到可用的 Python。\n' + guide());
+  process.exit(1);
+}
+if (py.tooOld) {
+  console.error('[CodeBee] 找到 ' + py.name + '（' + py.ver + '），但版本过低。\n' + guide());
+  process.exit(1);
+}
+
+const userArgs = [];
+for (const a of process.argv.slice(2)) {
+  if (typeof a === 'string' && SAFE_ARG.test(a)) {
+    userArgs.push(a);
+  } else {
+    console.error('[CodeBee] 参数含非法字符，已拒绝：' + String(a).slice(0, 80));
+    process.exit(2);
+  }
+}
+
+// CLI 转发契约：codebee 之后的用户参数（已过白名单）原样作为 main.py 的 argv。
+// 控制台日志即见：GBK 控制台下强制 UTF-8 输出（否则中文 print 触发 UnicodeEncodeError 静默卡死）。
+const childEnv = Object.assign({}, process.env, { PYTHONIOENCODING: 'utf-8', PYTHONUTF8: '1', PYTHONUNBUFFERED: '1' });
+// TUTTI_PYTHON 覆盖解释器：只允许在三个字面量里选（py/python/python3，.exe
+// 后缀可选、大小写不限）——环境变量永远只做「选择题」，不做「填空题」；
+// 机器上有多个解释器且探测选错时，用它切换。
+let exe = py.name;
+const ovRaw = String(process.env.TUTTI_PYTHON || '').trim().toLowerCase();
+const ov = ovRaw.endsWith('.exe') ? ovRaw.slice(0, -4) : ovRaw;
+if (ov === 'python') {
+  exe = 'python';
+} else if (ov === 'python3') {
+  exe = 'python3';
+} else if (ov === 'py') {
+  exe = 'py';
+}
+
+let child;
+if (exe === 'py') {
+  child = spawn('py', ['-3', MAIN, ...userArgs], { stdio: 'inherit', env: childEnv });
+} else if (exe === 'python') {
+  child = spawn('python', [MAIN, ...userArgs], { stdio: 'inherit', env: childEnv });
+} else {
+  child = spawn('python3', [MAIN, ...userArgs], { stdio: 'inherit', env: childEnv });
+}
+console.log('[CodeBee] 正在启动（Python: ' + exe + '）… 浏览器将自动打开 http://127.0.0.1:8765；'
+  + '本窗口保持开着就是服务，Ctrl+C 退出。');
+
+for (const sig of ['SIGINT', 'SIGTERM']) {
+  process.on(sig, () => { try { child.kill(sig); } catch (e) { /* 已退出 */ } });
+}
+const t0 = Date.now();
+child.on('exit', (code, signal) => {
+  if (!signal && code != null && code !== 0 && Date.now() - t0 < 4000) {
+    // 秒退：多半是 py 启动器指到了坏解释器（如损坏的 Anaconda）。给排障出口。
+    console.error('[CodeBee] 启动失败：Python 进程 ' + (code ? '退出码 ' + code : '异常终止') + '。'
+      + '\n  · 运行 python --version 确认可用且为 3.8+'
+      + '\n  · 若装有多个 Python，可设环境变量 TUTTI_PYTHON 切换（cmd：set TUTTI_PYTHON=python）');
+  }
+  process.exit(signal ? 1 : (code == null ? 0 : code));
+});
+child.on('error', (e) => {
+  console.error('[CodeBee] 无法启动 Python：' + e.message);
+  process.exit(1);
+});

package/package.json

@@ -1,46 +1,46 @@
-{
-  "name": "codebee",
-  "version": "0.1.66",
-  "description": "CodeBee · 多智能体编排台 — 统一编排本机 AI 编码 CLI（Codex / Claude Code / QwenCode / OpenCode / Aider…）：目标→拆解→路由→执行→验证→跨厂商评审→修复→报告。纯 Python 标准库实现，本地 Web UI。",
-  "license": "MIT",
-  "bin": {
-    "codebee": "bin/tutti.js"
-  },
-  "files": [
-    "app",
-    "bin",
-    "tools/wx_reader.py",
-    "CHANGELOG.md",
-    "README.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=14"
-  },
-  "os": [
-    "win32",
-    "darwin",
-    "linux"
-  ],
-  "keywords": [
-    "agent",
-    "orchestration",
-    "codex",
-    "claude",
-    "llm",
-    "cli",
-    "multi-agent"
-  ],
-  "scripts": {
-    "release:gate": "python scripts/release_gate.py",
-    "release": "python scripts/release_gate.py --publish",
-    "prepublishOnly": "python scripts/release_gate.py"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Vercel-By-WXP/CodeBee.git"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "codebee",
+  "version": "0.1.68",
+  "description": "CodeBee · 多智能体编排台 — 统一编排本机 AI 编码 CLI（Codex / Claude Code / QwenCode / OpenCode / Aider…）：目标→拆解→路由→执行→验证→跨厂商评审→修复→报告。纯 Python 标准库实现，本地 Web UI。",
+  "license": "MIT",
+  "bin": {
+    "codebee": "bin/tutti.js"
+  },
+  "files": [
+    "app",
+    "bin",
+    "tools/wx_reader.py",
+    "CHANGELOG.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=14"
+  },
+  "os": [
+    "win32",
+    "darwin",
+    "linux"
+  ],
+  "keywords": [
+    "agent",
+    "orchestration",
+    "codex",
+    "claude",
+    "llm",
+    "cli",
+    "multi-agent"
+  ],
+  "scripts": {
+    "release:gate": "python scripts/release_gate.py",
+    "release": "python scripts/release_gate.py --publish",
+    "prepublishOnly": "python scripts/release_gate.py"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vercel-By-WXP/CodeBee.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}