codebee 0.1.95 → 0.1.96

package/app/ui/style.css

@@ -344,6 +344,52 @@ html[data-skin="hermes"][data-theme="light"] {
   --uc-ca: #b0763f;
   --uc-out: #3d8f5f;
 }
+/* 简白（Codex 式极简）：日间=纯白画布 + 浅灰分区 + 发丝分隔 + 克制蓝，素面无装饰；
+ * 夜间=近黑画布 + 深灰分区同构。装饰性渐变/网格在下方统一压掉（与 contrast 同款规则）。 */
+html[data-skin="paper"] {
+  --bg: #0f0f0e;
+  --sidebar: #161615;
+  --panel: #1d1d1c;
+  --panel2: #272726;
+  --border: rgba(255, 255, 255, .10);
+  --border-strong: rgba(255, 255, 255, .22);
+  --text: #ecebe8;
+  --muted: #9a998f;
+  --accent: #6ea8fe;
+  --accent2: #94c1ff;
+  --ok: #3fbf8a;
+  --warn: #e2b34a;
+  --bad: #ef6a6a;
+  --chip-queued-bg: #272726;
+  --log-bg: #0b0b0a;
+  --log-text: #c9c8c2;
+  --shadow: 0 10px 30px rgba(0, 0, 0, .5);
+  --uc-in: #6ea8fe;
+  --uc-ca: #2fc6b1;
+  --uc-out: #e2b34a;
+}
+html[data-skin="paper"][data-theme="light"] {
+  --bg: #ffffff;
+  --sidebar: #f7f7f5;
+  --panel: #ffffff;
+  --panel2: #f5f5f3;
+  --border: #e8e8e4;
+  --border-strong: #d7d7d2;
+  --text: #21201e;
+  --muted: #87867f;
+  --accent: #2563eb;
+  --accent2: #1d4ed8;
+  --ok: #1a7f37;
+  --warn: #9a6700;
+  --bad: #cf222e;
+  --chip-queued-bg: #f5f5f3;
+  --log-bg: #f6f7f8;
+  --log-text: #3c3f43;
+  --shadow: 0 10px 30px rgba(0, 0, 0, .06);
+  --uc-in: #2563eb;
+  --uc-ca: #0d9488;
+  --uc-out: #d97706;
+}
 * { box-sizing: border-box; }
 html, body { height: 100%; }
 body {
@@ -3142,7 +3188,10 @@ body {
     var(--bg);
   background-attachment: fixed;
 }
-html[data-skin="contrast"] body { background-image: none; }
+html[data-skin="contrast"] body,
+html[data-skin="paper"] body { background-image: none; }
+/* 简白连角落的网格纹理一起收掉：纯白画布上任何底纹都是脏 */
+html[data-skin="paper"] body::before { content: none; }
 
 /* 2) 品牌字标：主色字 + 底部发丝分隔线（仍是纯文字品牌，无任何图片） */
 .brand-name { color: var(--accent); letter-spacing: .02em; }
@@ -6605,7 +6654,7 @@ button.primary:hover { filter:brightness(.96); }
    inherit ocean/forest/amber/violet/contrast choices instead of imposing a new
    brand color. */
 html[data-skin="ocean"][data-theme="light"] {
-  --bg: #fff; --sidebar: #eff5fd; --panel: #fff; --panel2: #f0f6fd;
+  --bg: #ffffff; --sidebar: #eff5fd; --panel: #fff; --panel2: #f0f6fd;
   --border: #d7e3f4; --border-strong: #b9cde8; --text: #0c1a2c; --muted: #526983;
   --accent: #1f6fd0; --accent2: #5b4fe0; --ok: #0d9a72; --warn: #a9761a;
   --bad: #d23c58; --chip-queued-bg: #f0f6fd; --log-bg: #f4f8fe; --log-text: #33475f;
@@ -7096,3 +7145,148 @@ main.browser-page-active #page-settings > #sub-browser .browser-shell {
   font-size: 12.5px; line-height: 1.65; white-space: pre-wrap; word-break: break-word;
   max-height: 180px; overflow: auto; color: var(--text);
 }
+
+/* 关于页「交流与支持」二维码卡（追加尾防并行重排）：白底垫卡保证暗色皮肤下
+ * 黑白二维码仍清晰，两卡并排窄屏自动换行。 */
+.qr-row { display: flex; flex-wrap: wrap; gap: 14px; margin: 8px 0 4px; }
+.qr-card {
+  margin: 0; background: #fff; border: 1px solid var(--border); border-radius: 10px;
+  padding: 8px 8px 4px; text-align: center;
+}
+.qr-card img { display: block; width: 132px; height: auto; border-radius: 6px; }
+.qr-card .hint { margin: 4px 0 2px; color: var(--muted); max-width: 140px; }
+
+/* 蜂巢流程场景：阶段平台布置在透视空间里，页面操作仍保持原生 DOM。 */
+#rd-hive .sec-title { margin-bottom: 10px; }
+.hive-scene-tools {
+  display: flex; align-items: center; gap: 7px; min-height: 38px; margin-bottom: 8px;
+  color: var(--muted); font-size: 11px;
+}
+.hive-view-switch { display: inline-flex; gap: 2px; padding: 3px; border: 1px solid var(--border); border-radius: 9px; background: var(--panel); }
+.hive-view-btn, .hive-scene-btn {
+  min-height: 28px; padding: 4px 10px; border: 1px solid transparent; border-radius: 6px;
+  background: transparent; color: var(--muted); font: inherit; cursor: pointer;
+  transition: color .16s ease, background .16s ease, border-color .16s ease;
+}
+.hive-view-btn:hover, .hive-scene-btn:hover { color: var(--text); background: color-mix(in srgb, var(--accent) 8%, transparent); }
+.hive-view-btn.active { border-color: color-mix(in srgb, var(--accent) 32%, var(--border)); background: color-mix(in srgb, var(--accent) 12%, var(--panel)); color: var(--accent); }
+.hive-scene-hint { margin-left: 8px; }
+.hive-scene-spacer { flex: 1; }
+.hive-scene-btn { min-width: 31px; padding-inline: 8px; border-color: var(--border); background: var(--panel); font-size: 13px; }
+.hive-scene-reset { padding-inline: 10px; font-size: 11px; }
+.hive-viewport {
+  position: relative; min-height: 420px; max-height: min(72vh, 820px); overflow: auto;
+  perspective: 1500px; perspective-origin: 50% 12%; transform-style: preserve-3d;
+  overscroll-behavior: contain; border: 1px solid color-mix(in srgb, var(--accent) 15%, var(--border));
+  border-radius: 16px; background:
+    radial-gradient(ellipse at 50% 0%, color-mix(in srgb, var(--accent) 10%, transparent), transparent 56%),
+    linear-gradient(145deg, color-mix(in srgb, var(--panel) 96%, var(--accent)), var(--panel) 70%);
+  box-shadow: inset 0 1px color-mix(in srgb, white 7%, transparent), 0 16px 34px color-mix(in srgb, #000 12%, transparent);
+  scrollbar-color: color-mix(in srgb, var(--accent) 32%, var(--border)) transparent;
+}
+.hive-viewport::before {
+  content: ""; position: absolute; inset: 0; pointer-events: none; opacity: .2;
+  background-image: radial-gradient(color-mix(in srgb, var(--accent) 45%, transparent) .7px, transparent .7px);
+  background-size: 18px 18px; mask-image: linear-gradient(180deg, #000, transparent 80%);
+}
+.hive-viewport.is-dragging { cursor: grabbing; user-select: none; }
+#rd-hive-cells {
+  --scene-x: 0px; --scene-y: 0px; --scene-zoom: 1;
+  position: relative;
+  isolation: isolate; display: flex; flex-direction: column; gap: 3px;
+  width: min(100%, 1040px); min-height: 100%; margin: 0 auto; padding: 22px 24px 28px;
+  transform: translate3d(var(--scene-x), var(--scene-y), 0) rotateX(18deg) rotateZ(-1deg) scale(var(--scene-zoom));
+  transform-origin: 50% 12%; transform-style: preserve-3d; cursor: grab;
+  transition: transform .14s ease-out; will-change: transform;
+}
+.hive-viewport.is-dragging #rd-hive-cells { transition: none; }
+#rd-hive-cells .hive-lane {
+  transform: translateZ(var(--lane-z, 0px));
+  transform-style: preserve-3d;
+  border: 1px solid color-mix(in srgb, var(--accent) 16%, var(--border));
+  border-radius: 13px;
+  padding: 11px 14px 12px;
+  background: linear-gradient(115deg,
+    color-mix(in srgb, var(--accent) 4%, var(--panel)),
+    color-mix(in srgb, var(--panel) 96%, transparent) 44%, var(--panel));
+  box-shadow: 0 5px 0 color-mix(in srgb, var(--border-strong) 48%, transparent),
+    0 10px 20px color-mix(in srgb, #000 10%, transparent),
+    inset 0 1px color-mix(in srgb, white 7%, transparent);
+  transition: transform .22s ease, box-shadow .22s ease, border-color .22s ease;
+}
+#rd-hive-cells .hive-lane:nth-child(4n + 1) { --lane-z: 16px; }
+#rd-hive-cells .hive-lane:nth-child(4n + 3) { --lane-z: 8px; }
+#rd-hive-cells .hive-lane.lane-active {
+  border-color: color-mix(in srgb, var(--accent) 58%, var(--border));
+  box-shadow: 0 6px 0 color-mix(in srgb, var(--accent) 22%, var(--border-strong)),
+    0 15px 28px color-mix(in srgb, var(--accent) 13%, #000),
+    inset 0 1px color-mix(in srgb, white 10%, transparent);
+}
+#rd-hive-cells .lane-flow {
+  transform: translateZ(6px);
+  filter: drop-shadow(0 2px 3px color-mix(in srgb, var(--accent) 24%, transparent));
+}
+#rd-hive-cells .lane-cells { gap: 8px 10px; }
+#rd-hive-cells .hive-cell {
+  position: relative;
+  min-height: 82px;
+  padding: 11px 12px 9px 15px;
+  border: 1px solid color-mix(in srgb, var(--accent) 14%, var(--border));
+  border-radius: 9px;
+  background: linear-gradient(145deg, color-mix(in srgb, var(--panel) 96%, var(--accent)), var(--panel) 78%);
+  box-shadow: 0 3px 0 color-mix(in srgb, var(--border-strong) 40%, transparent),
+    0 7px 13px color-mix(in srgb, #000 12%, transparent),
+    inset 0 1px color-mix(in srgb, white 6%, transparent);
+  transition: transform .18s ease, box-shadow .18s ease, border-color .18s ease, background-color .18s ease;
+}
+#rd-hive-cells .hive-cell::before {
+  top: 0; bottom: 0; left: 0; right: auto; width: 3px; height: auto;
+  border-radius: 9px 0 0 9px;
+}
+#rd-hive-cells .hive-cell:hover,
+#rd-hive-cells .hive-cell:focus-visible {
+  transform: translateY(-3px) translateZ(8px);
+  border-color: color-mix(in srgb, var(--accent) 50%, var(--border));
+  background: linear-gradient(145deg, color-mix(in srgb, var(--accent) 8%, var(--panel)), var(--panel) 78%);
+  box-shadow: 0 5px 0 color-mix(in srgb, var(--accent) 25%, var(--border-strong)),
+    0 13px 20px color-mix(in srgb, var(--accent) 12%, #000);
+}
+#rd-hive-cells .hive-cell.st-running {
+  border-color: color-mix(in srgb, var(--accent) 45%, var(--border));
+  background: linear-gradient(145deg, color-mix(in srgb, var(--accent) 9%, var(--panel)), var(--panel) 78%);
+}
+.hive-viewport.hive-2d { min-height: 0; max-height: none; overflow: visible; perspective: none; border: 0; border-radius: 0; background: transparent; box-shadow: none; }
+#rd-hive-cells.hive-2d {
+  width: 100%; padding: 0; transform: none; cursor: default; gap: 2px;
+}
+#rd-hive-cells.hive-2d .hive-lane,
+#rd-hive-cells.hive-2d .hive-lane:nth-child(n) { --lane-z: 0px; transform: none; }
+#rd-hive-cells.hive-2d .hive-cell:hover,
+#rd-hive-cells.hive-2d .hive-cell:focus-visible { transform: translateY(-1px); }
+.hive-scene-tools.hive-2d .hive-scene-hint { display: none; }
+@media (max-width: 720px) {
+  .hive-scene-tools { flex-wrap: wrap; }
+  .hive-scene-hint { order: 2; width: 100%; margin: 0 0 3px; }
+  .hive-scene-spacer { flex: 1 1 0; }
+  .hive-viewport { min-height: 340px; max-height: 64vh; }
+  #rd-hive-cells { padding: 12px 14px 18px; }
+}
+@media (prefers-reduced-motion: reduce) {
+  #rd-hive-cells { transition: none; }
+  #rd-hive-cells .hive-lane,
+  #rd-hive-cells .hive-cell { transition: none; }
+}
+
+/* ---- 发布台·批量选择（pb-pend）：待发章号 chips + 全选/清空 + 发布所选/直发所选 ---- */
+.pb-pend { width: 100%; margin-top: 6px; padding: 6px 8px; border: 1px solid var(--line);
+  border-radius: 8px; font-size: 12px; }
+.pb-pend-head { display: flex; gap: 10px; align-items: center; color: var(--muted); }
+.pb-pend-head a { color: var(--accent, #4a7dbe); text-decoration: none; }
+.pb-pend-chips { display: flex; flex-wrap: wrap; gap: 4px; margin-top: 5px;
+  max-height: 96px; overflow: auto; }
+.pb-chip { display: inline-flex; align-items: center; gap: 3px; padding: 1px 6px;
+  border: 1px solid var(--line); border-radius: 10px; cursor: pointer;
+  color: var(--muted); user-select: none; }
+.pb-chip.on { border-color: var(--accent, #4a7dbe); color: var(--text); }
+.pb-chip input { margin: 0; }
+.pb-pend-btns { display: flex; gap: 8px; margin-top: 6px; }

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,48 +1,48 @@
-{
-  "name": "codebee",
-  "version": "0.1.95",
-  "description": "CodeBee · 多智能体编排台 — 统一编排本机 AI 编码 CLI（Codex / Claude Code / QwenCode / OpenCode / Aider…）：目标→拆解→路由→执行→验证→跨厂商评审→修复→报告。纯 Python 标准库实现，本地 Web UI。",
-  "license": "MIT",
-  "bin": {
-    "codebee": "bin/tutti.js"
-  },
-  "files": [
-    "app",
-    "!app/tests",
-    "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",
-    "release:clean": "python scripts/prune_release_debris.py"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Vercel-By-WXP/CodeBee.git"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "codebee",
+  "version": "0.1.96",
+  "description": "CodeBee · 多智能体编排台 — 统一编排本机 AI 编码 CLI（Codex / Claude Code / QwenCode / OpenCode / Aider…）：目标→拆解→路由→执行→验证→跨厂商评审→修复→报告。纯 Python 标准库实现，本地 Web UI。",
+  "license": "MIT",
+  "bin": {
+    "codebee": "bin/tutti.js"
+  },
+  "files": [
+    "app",
+    "!app/tests",
+    "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",
+    "release:clean": "python scripts/prune_release_debris.py"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vercel-By-WXP/CodeBee.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}