codebee 0.1.71 → 0.1.73

package/app/ui/style.css

@@ -356,6 +356,9 @@ body {
 *::-webkit-scrollbar-track { background: transparent; }
 
 /* ---------------- 布局骨架 ---------------- */
+/* ---------------- 布局骨架 ---------------- */
+/* ⚠️ 此层列宽已被后发皮肤层（「46px rail + 216px project column」）整体覆盖，
+   侧栏宽度真源在那一层的 --side-w；此处保留原始骨架注释性记录 */
 #app { display: grid; grid-template-columns: 264px 1fr; height: 100vh; }
 body.side-collapsed #app { grid-template-columns: 0 1fr; }
 #mainwrap { display: flex; flex-direction: column; min-width: 0; height: 100vh; }
@@ -366,8 +369,24 @@ body.side-collapsed #app { grid-template-columns: 0 1fr; }
   background: var(--sidebar); border-right: 1px solid var(--border);
   padding: 14px 12px 12px; min-width: 0; overflow: hidden;
   transition: opacity .15s;
+}  padding: 14px 12px 12px; min-width: 0; overflow: hidden;
+  transition: opacity .15s;
+  position: relative;
 }
 body.side-collapsed #sidebar { border-right: none; padding-left: 0; padding-right: 0; opacity: 0; pointer-events: none; }
+body.side-collapsed #sidebar { border-right: none; padding-left: 0; padding-right: 0; opacity: 0; pointer-events: none; }
+/* 右缘拖拽手柄：贴右缘 7px 热区，hover/拖动中亮竖条；手柄属 sidebar 内，不受内容滚动影响 */
+#side-resizer {
+  position: absolute; top: 0; bottom: 0; right: 0; width: 7px;
+  cursor: col-resize; z-index: 20; touch-action: none;
+}
+#side-resizer::after {
+  content: ""; position: absolute; top: 0; bottom: 0; right: 0; width: 3px;
+  background: transparent; transition: background .15s;
+}
+#side-resizer:hover::after, body.side-resizing #side-resizer::after { background: var(--accent); opacity: .5; }
+body.side-resizing { cursor: col-resize; user-select: none; }
+body.side-resizing iframe { pointer-events: none; }
 /* 品牌：方形字母标磁贴 + 字标，单行位于侧栏最顶上 */
 .brand { display: flex; align-items: center; gap: 10px; font-size: 15.5px; font-weight: 700; padding: 6px 8px 12px; white-space: nowrap; overflow: hidden; }
 /* 品牌：Codex 式低调字标——纯正文色小字，无磁贴无渐变（2026-09-15 参考 Codex 桌面端定版） */
@@ -683,12 +702,15 @@ main { flex: 1; overflow-y: auto; padding: 28px 32px 96px; }
  * 统一无框化：内容直接落在背景上，靠 panel-head 分隔线分节；
  * 内部小卡片（.mgmt-panel/.opanel/.cards 卡片等）不受影响，仍保留边框 */
 main .panel.wide { background: transparent; border: none; box-shadow: none; }
+/* space-between 会把标题后的 ? 帮助钮当成独立一项推去行尾/行中——
+ * 改成起排 + .actions 自推右侧：标题旁的元素（? 问号、计数徽标）贴文字走 */
 .panel-head {
-  display: flex; justify-content: space-between; align-items: center; gap: 12px; flex-wrap: wrap;
+  display: flex; align-items: center; gap: 12px; flex-wrap: wrap;
   margin: 0 0 16px; padding-bottom: 12px; border-bottom: 1px solid var(--border);
 }
 .panel-head h2 { margin: 0; }
-.panel-head .actions { display: flex; gap: 8px; flex-wrap: wrap; align-items: center; }
+.panel-head .actions { display: flex; gap: 8px; flex-wrap: wrap; align-items: center; margin-left: auto; }
+.panel-head > .spacer { flex: 1; }
 h2 { font-size: 15.5px; margin: 0 0 12px; font-weight: 700; }
 h3 { font-size: 13px; margin: 18px 0 8px; color: var(--muted); }
 /* 面板内分节标题：小号大写字距 + 贯穿分隔线 */
@@ -868,23 +890,24 @@ button.small { padding: 4px 10px; font-size: 12px; }
 .route b { color: var(--text); }
 
 .steps { display: flex; flex-direction: column; gap: 8px; margin-bottom: 16px; }
+/* 弹性行而非网格：行内子元素数量可变（st-model/st-prov 徽章有无），网格定死
+ * 7 列会把 chip+日志按钮挤到隐含第二行，「运行中」掉进 30px 窄列一字一行竖排 */
 .step {
-  display: grid; grid-template-columns: 30px 92px 118px minmax(0, 1fr) auto auto auto;
-  align-items: center; gap: 12px;
+  display: flex; align-items: center; gap: 12px;
   background: var(--panel2); border: 1px solid transparent; border-radius: var(--r-md);
   padding: 10px 14px; cursor: pointer; font-size: 13px;
   transition: border-color .15s;
 }
 .step:hover { border-color: var(--border-strong); }
 .step .n {
-  width: 26px; height: 26px; border-radius: 8px; display: grid; place-items: center;
+  flex: none; width: 26px; height: 26px; border-radius: 8px; display: grid; place-items: center;
   background: var(--panel); border: 1px solid var(--border);
   font-family: var(--mono); font-size: 11px; color: var(--muted);
 }
-.step .role { font-weight: 600; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-.step .who { color: var(--muted); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-.step .sum { color: var(--muted); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-.step .dur { color: var(--muted); font-size: 12px; font-family: var(--mono); }
+.step .role { flex: 0 0 92px; font-weight: 600; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.step .who { flex: 0 0 118px; color: var(--muted); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.step .sum { flex: 1 1 auto; min-width: 0; color: var(--muted); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.step .dur { flex: none; color: var(--muted); font-size: 12px; font-family: var(--mono); }
 .step-log-btn {
   border: 1px solid var(--border); border-radius: 999px; background: transparent;
   color: var(--muted); padding: 3px 8px; font-size: 11px; line-height: 1.2;
@@ -1214,6 +1237,8 @@ body.inspector-open #inspector { display: flex; }
 @media (max-width: 900px) {
   #app { grid-template-columns: 1fr; }
   body.side-collapsed #app { grid-template-columns: 1fr; }
+  body.side-collapsed #app { grid-template-columns: 1fr; }
+  #side-resizer { display: none; }
   #sidebar {
     position: fixed; z-index: 60; top: 0; left: 0; bottom: 0;
     width: min(300px, 84vw);
@@ -2768,6 +2793,9 @@ details.sf-dir > summary i, a.sf-file i { font-style: normal; color: var(--muted
 .bm-head .ico { color: var(--accent); width: 16px; height: 16px; }
 .bm-head .hint { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-size: 12px; }
 .bm-warn { color: var(--warn); font-size: 12px; flex: none; }
+.bm-inherit { flex: none; font-size: 12px; color: var(--muted);
+  border: 1px solid var(--border-strong); border-radius: 999px; padding: 1px 9px;
+  max-width: 260px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .bm-guide { display: flex; gap: 12px; align-items: flex-start; padding: 14px 18px; margin: 12px 0 16px;
   border: 1px dashed var(--border-strong); border-radius: var(--r-md); background: none; }
 .bm-guide .ico { flex: none; margin-top: 2px; width: 18px; height: 18px; color: var(--accent); }
@@ -4641,8 +4669,8 @@ main:has(> #page-settings > #sub-runs:not(.hidden)) { padding-bottom: 28px; }
 }
 #sub-tasks #att-chips:empty { display: none; }
 #sub-tasks .att-chip.att-image {
-  position: relative; width: 88px; height: 88px; max-width: none; padding: 0;
-  overflow: visible; border-radius: 12px; background: var(--panel2);
+  position: relative; width: 56px; height: 56px; max-width: none; padding: 0;
+  overflow: visible; border-radius: 10px; background: var(--panel2);
   border-color: var(--border); box-shadow: 0 2px 10px color-mix(in srgb, #000 10%, transparent);
 }
 #sub-tasks .att-chip.att-image img {
@@ -4654,13 +4682,13 @@ main:has(> #page-settings > #sub-runs:not(.hidden)) { padding-bottom: 28px; }
   overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border: 0;
 }
 #sub-tasks .att-chip.att-image .ax {
-  position: absolute; z-index: 2; top: -6px; right: -6px;
+  position: absolute; z-index: 2; top: -5px; right: -5px;
   display: inline-flex; align-items: center; justify-content: center;
-  width: 20px; height: 20px; padding: 0; border: 1px solid var(--panel);
+  width: 18px; height: 18px; padding: 0; border: 1px solid var(--panel);
   border-radius: 50%; background: var(--text); color: var(--panel);
   box-shadow: 0 2px 6px color-mix(in srgb, #000 18%, transparent);
 }
-#sub-tasks .att-chip.att-image .ax .ico { width: 11px; height: 11px; }
+#sub-tasks .att-chip.att-image .ax .ico { width: 10px; height: 10px; }
 #sub-tasks .att-chip.att-image .ax:hover,
 #sub-tasks .att-chip.att-image .ax:focus-visible { background: var(--bad); color: #fff; outline: none; }
 #sub-tasks .cmp-box > .att-chips + textarea { padding-top: 8px; }
@@ -4670,7 +4698,7 @@ main:has(> #page-settings > #sub-runs:not(.hidden)) { padding-bottom: 28px; }
     left: 8px; right: 8px; width: auto; top: calc(100% + 2px);
   }
   #run-detail .rd-meta-popover #rd-overview { grid-template-columns: minmax(0, 1fr) auto; }
-  #sub-tasks .att-chip.att-image { width: 82px; height: 82px; }
+  #sub-tasks .att-chip.att-image { width: 56px; height: 56px; }
 }
 
 /* ================= 详情页侧边栏重构 =================
@@ -5034,9 +5062,15 @@ main.chat-fill #run-detail.chat-mode > .rd-main { overflow: hidden; }
     background: var(--panel);  /* 浮卡实底，不透出底下时间线 */
     box-shadow: 0 18px 44px rgba(6, 18, 35, .16), 0 2px 10px rgba(6, 18, 35, .08);
   }
+  /* 对话柱向左加宽（用户 2026-09-29）：给浮卡让位的空白不再两侧对称预留，
+     只在右缘留一份（版心右距 = 卡宽 + 2×间隙）——柱体在「版心左缘↔浮卡」
+     之间自动居中，吃满原先空旷的左半边；宽帽 960→1120 */
+  #run-detail.chat-mode .rd-pane[data-pane="chat"] {
+    padding-right: calc(var(--rd-card-w) + 2 * var(--rd-card-gap));
+  }
   #run-detail.chat-mode .rd-chat-flow,
   #run-detail.chat-mode .rd-chat-bar {
-    max-width: min(960px, calc(100% - 2 * (var(--rd-card-w) + var(--rd-card-gap))));
+    max-width: min(1120px, 100%);
   }
   /* 对话模式里按需打开的其它分区（步骤/蜂巢…）：右侧整体给浮卡让位 */
   #run-detail.chat-mode .rd-pane:not([data-pane="chat"]) {
@@ -5963,23 +5997,24 @@ button.request-busy > * { opacity: .18; }
   grid-template-columns: repeat(auto-fill, minmax(280px, 1fr)); }
 #mk-grid.mk-grouped .sec-title { margin: 16px 0 8px; }
 
-/* 首页 composer 图片附件缩略图：与任务页同款 88×88 卡（此前样式只写在
+/* 首页 composer 图片附件缩略图：与任务页同款 56×56 紧凑缩略卡（此前样式只写在
  * #sub-tasks 作用域，首页 img 按原始尺寸渲染直接压住输入文字——2026-09-21
- * 用户实测「有遮挡」）。删除钮右上角悬浮。 */
-.att-chip.att-image { position: relative; width: 88px; height: 88px; max-width: none;
-  padding: 0; overflow: visible; border-radius: 12px; background: var(--panel2);
+ * 用户实测「有遮挡」；2026-09-29 88×88 仍嫌太大挡视野，收紧到 56）。
+ * 删除钮右上角悬浮。 */
+.att-chip.att-image { position: relative; width: 56px; height: 56px; max-width: none;
+  padding: 0; overflow: visible; border-radius: 10px; background: var(--panel2);
   border-color: var(--border); box-shadow: 0 2px 10px color-mix(in srgb, #000 10%, transparent); }
 .att-chip.att-image img { display: block; width: 100%; height: 100%; object-fit: cover;
   border-radius: inherit; background: var(--panel2); }
 .att-chip.att-image .att-image-name { position: absolute; width: 1px; height: 1px;
   padding: 0; margin: -1px; overflow: hidden; clip: rect(0, 0, 0, 0);
   white-space: nowrap; border: 0; }
-.att-chip.att-image .ax { position: absolute; z-index: 2; top: -6px; right: -6px;
-  display: inline-flex; align-items: center; justify-content: center; width: 20px;
-  height: 20px; padding: 0; border: 1px solid var(--panel); border-radius: 50%;
+.att-chip.att-image .ax { position: absolute; z-index: 2; top: -5px; right: -5px;
+  display: inline-flex; align-items: center; justify-content: center; width: 18px;
+  height: 18px; padding: 0; border: 1px solid var(--panel); border-radius: 50%;
   background: var(--panel); color: var(--muted); }
 .att-chip.att-image .ax:hover { background: var(--bad); color: #fff; }
-.att-chip.att-image .ax .ico { width: 11px; height: 11px; }
+.att-chip.att-image .ax .ico { width: 10px; height: 10px; }
 
 /* 对话气泡图片附件缩略图（2026-09-21 用户反馈：图片只显示文件名要点开才见）：
  * 96×96 圆角卡，点击仍走 att-open 弹大图 */
@@ -6623,7 +6658,9 @@ main { font-size: 14px; }
 #f-goal::placeholder { color: color-mix(in srgb, var(--muted) 78%, #fff); }
 
 /* Match the reference proportions: 46px rail + 216px project column. */
-#app { grid-template-columns: 46px 216px minmax(0, 1fr); }
+#app { grid-template-columns: 46px 216px minmax(0, 1fr); }/* Match the reference proportions: 46px rail + 216px project column.
+   侧栏列宽走 --side-w（#side-resizer 拖动实时改，localStorage 记忆）。 */
+#app { grid-template-columns: 46px var(--side-w, 216px) minmax(0, 1fr); }
 body.side-collapsed #app { grid-template-columns: 46px 0 minmax(0, 1fr); }
 #sidebar { padding: 13px 0 10px; }
 .brand { width: 100%; padding: 4px 12px 12px; justify-content: flex-start; text-align: left; }
@@ -6687,7 +6724,7 @@ body.side-collapsed #app { grid-template-columns: 46px 0 minmax(0, 1fr); }
    Keep the rail and project column in the grid when the right detail panel opens;
    the older three-column rule put the inspector on a new row and squeezed the main area. */
 body.inspector-open #app {
-  grid-template-columns: 46px 216px minmax(0, 1fr) minmax(280px, 340px);
+  grid-template-columns: 46px 216px minmax(0, 1fr) minmax(280px, 340px);  grid-template-columns: 46px var(--side-w, 216px) minmax(0, 1fr) minmax(280px, 340px);
 }
 body.side-collapsed.inspector-open #app {
   grid-template-columns: 46px 0 minmax(0, 1fr) minmax(280px, 340px);
@@ -7010,3 +7047,14 @@ main.browser-page-active #page-settings > #sub-browser .browser-shell {
   .browser-home-workflows { grid-template-columns: 1fr; }
   .browser-home-action { min-height: 72px; }
 }
+
+/* 步骤行 flex 化后的防压缩补充（追加于文件尾防并行重排）：徽章/按钮不许被
+ * 挤压收缩，摘要列吸收余量——运行中行（无摘要/耗时）状态 chip 与 CLI 日志
+ * 按钮才能稳定贴右单行，与完成行同构 */
+.step .st-model, .step .st-prov, .step .step-log-btn { flex: none; }
+
+/* 供应商/模型状态过滤 chips（追加于文件尾防并行重排）：默认只看启用，
+ * 停用的点「已停用/全部」才现身；复用 .cat-chip 药丸，窄侧栏收紧行距 */
+.prov-status { margin: 2px 0 8px; }
+.prov-status .cat-chip { padding: 3px 9px; font-size: 12px; }
+.pm-status { margin: 10px 0 2px; }

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,47 +1,48 @@
-{
-  "name": "codebee",
-  "version": "0.1.71",
-  "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"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Vercel-By-WXP/CodeBee.git"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "codebee",
+  "version": "0.1.73",
+  "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"
+  }
+}