codebee 0.1.0 → 0.1.2

package/README.md

@@ -12,7 +12,7 @@
 
 - **跨厂商对抗式评审**：评审者强制来自与作者不同的模型族——同族自评有同款盲区，
   换一双"眼睛"才挑得出陈词滥调（无跨厂商可用时如实备注，绝不伪装）。
-- **产物隔离在任务分支**：指定代码版本的任务，产物提交在 `tutti/<task-id>` 分支上，
+- **产物隔离在任务分支**：指定代码版本的任务，产物提交在 `codebee/<task-id>` 分支上，
   你的工作区始终干净；UI 或 `tools/bee.py` 里过目变更，一键「合并回原分支」或「丢弃」。
 - **多任务并发互不打扰**（1-6 可配）、**六种内置任务类型 + 自定义流程**；
   「编排设置」可指定任意厂商的 API 模型作为**编排者**；CLI 可绑定**跨厂商模型链**。
@@ -34,13 +34,34 @@ python toolsee.py discard <task>    :: 否决——删除任务分支（需输
 
 ## 快速开始
 
+**方式一：npm 安装（推荐，普通用户）**
+
+需要本机装有 [Node.js](https://nodejs.org) 与 [Python 3.8+](https://www.python.org/downloads/windows/)
+（Windows 装 Python 时勾选 “Add python.exe to PATH”）。然后：
+
+```bat
+npm install -g codebee
+codebee
+```
+
+`codebee` 命令会启动服务并自动打开浏览器（默认 `http://127.0.0.1:8765`）。
+**启动后那个命令行窗口就是服务本身**——保持开着别关，Ctrl+C 即退出。
+升级：`npm update -g codebee`，或在界面「设置 → 关于与更新」里一键升级。
+
+数据存放在用户目录（Windows `%APPDATA%\CodeBee`，macOS/Linux `~/.codebee`），
+升级/重装不影响；老版本 Tutti 目录（`%APPDATA%\Tutti`）会被自动沿用，无需迁移。
+
+**方式二：源码运行（开发者）**
+
 ```bat
+git clone https://github.com/Vercel-By-WXP/CodeBee.git
+cd CodeBee
 start.bat
 :: 或
 python app\main.py --port 8765
 ```
 
-自动打开 `http://127.0.0.1:8765`。首次运行会在 `data/` 下生成默认目录。
+自动打开 `http://127.0.0.1:8765`。源码模式数据落仓库 `data/` 目录。
 
 ## 手机 / 远程访问
 
@@ -68,8 +89,8 @@ python app\main.py --port 8765
 ```bat
 :: 一次性配置：cloudflared 登录后创建隧道并绑定子域名
 cloudflared tunnel login
-cloudflared tunnel create tutti
-cloudflared tunnel route dns --overwrite-dns <隧道UUID> tutti.你的域名.com
+cloudflared tunnel create codebee
+cloudflared tunnel route dns --overwrite-dns <隧道UUID> codebee.你的域名.com
 
 :: 之后日常启动（服务 + 隧道一键起）：
 start-public.bat

package/app/core/catalog.py

@@ -84,31 +84,40 @@ DEFAULT_CATALOG = [
     },
     {
         "id": "openclaw", "name": "OpenClaw", "cli_group": "installable",
-        "note": "网关型个人 AI 智能体（原 Clawdbot）；编排模板装好后需验证",
+        "note": "网关型个人 AI 智能体（原 Clawdbot）；编排模板装好后需验证；"
+                "默认模型在 openclaw.json 的 agents.defaults.model.primary"
+                "（顶层 model 键会被 schema 校验拒绝启动，绝不写顶层）",
         "detect": {"cli": "openclaw"},
         "orch": {"kind": "generic", "command": "openclaw", "argv_template": ["{prompt}"]},
-        "config": {"path": "~/.openclaw/openclaw.json", "format": "json", "model_key": None},
+        "config": {"path": "~/.openclaw/openclaw.json", "format": "json-path",
+                   "model_key": "agents.defaults.model.primary"},
         "install": "npm install -g openclaw",
         "upgrade": "npm install -g openclaw@latest",
         "default_enabled": False,
     },
     {
         "id": "kimi-code", "name": "Kimi Code", "cli_group": "installable",
-        "note": "月之暗面 Kimi 编码 CLI（TypeScript 版，需 Node ≥22.19）；旧 Python 版 kimi-cli 正在下线",
+        "note": "月之暗面 Kimi 编码 CLI（TypeScript 版，需 Node ≥22.19）；旧 Python 版 "
+                "kimi-cli 正在下线；默认模型在 ~/.kimi-code/config.toml 的顶层 "
+                "default_model（值须是 [models] 表里定义的别名），首启自动建文件",
         "detect": {"cli": "kimi"},
         "orch": {"kind": "generic", "command": "kimi", "argv_template": ["-p", "{prompt}"]},
-        "config": {"path": "~/.kimi/config.json", "format": "json", "model_key": None},
+        "config": {"path": "~/.kimi-code/config.toml", "format": "toml-section",
+                   "model_key": "default_model"},
         "install": "npm install -g @moonshot-ai/kimi-code",
         "upgrade": "npm install -g @moonshot-ai/kimi-code@latest",
         "default_enabled": False,
     },
     {
         "id": "mimo-code", "name": "MiMo Code", "cli_group": "installable",
-        "note": "小米 MiMo Code（opencode 衍生）；无头调用是子命令 mimo run \"提示词\"，-p 在该 CLI 是 --password",
+        "note": "小米 MiMo Code（opencode 衍生）；无头调用是子命令 mimo run \"提示词\"，"
+                "-p 在该 CLI 是 --password；默认模型在 ~/.config/mimocode/mimocode.jsonc "
+                "顶层 model（provider/model 格式），onboarding 自动建文件",
         "detect": {"cli": "mimo"},
         "orch": {"kind": "generic", "command": "mimo", "argv_template": ["run", "{prompt}"],
                  "resume_argv_template": ["run", "-s", "{session}"]},
-        "config": {"path": "~/.mimo/config.json", "format": "json", "model_key": None},
+        "config": {"path": "~/.config/mimocode/mimocode.jsonc", "format": "jsonc",
+                   "model_key": "model"},
         "install": "npm install -g @mimo-ai/cli",
         "upgrade": "npm install -g @mimo-ai/cli@latest",
         "default_enabled": False,
@@ -127,10 +136,13 @@ DEFAULT_CATALOG = [
     },
     {
         "id": "pi", "name": "Pi", "cli_group": "installable",
-        "note": "Earendil Works 的 Pi 编码 CLI（需 Node ≥22.19）；包名必须带 @earendil-works/ 前缀",
+        "note": "Earendil Works 的 Pi 编码 CLI（需 Node ≥22.19）；包名必须带 @earendil-works/ 前缀；"
+                "默认模型在 ~/.pi/agent/settings.json 的 defaultModel（须配 defaultProvider 才能解析）",
         "detect": {"cli": "pi"},
         "orch": {"kind": "generic", "command": "pi", "argv_template": ["-p", "{prompt}"]},
-        "config": {"path": "~/.pi/config.json", "format": "json", "model_key": None},
+        "config": {"path": "~/.pi/agent/settings.json", "format": "json-path",
+                   "model_key": "defaultModel",
+                   "model_extra_keys": {"defaultProvider": ""}},
         "install": "npm install -g --ignore-scripts @earendil-works/pi-coding-agent",
         "upgrade": "npm install -g --ignore-scripts @earendil-works/pi-coding-agent@latest",
         "default_enabled": False,
@@ -185,13 +197,22 @@ LAUNCH_PATCH = {    "codex-cli": {"kind": "console", "command": "codex"},
 # config.format 修正（{id: config 字段}）：load() 幂等覆盖。qwen 的 settings.json
 # 顶层 "model" 是 legacy（被忽略并告警）——老用户的 catalog.json 里 qwencode 还是
 # format=json，不修正的话每次打开都会写无效字段；覆盖无风险（写了也不生效）。
+# grok/kimi/mimo/pi/openclaw 同理：真实落点均经官方文档/源码查证（详见各条目 note
+# 与 tests/test_grok_build.py），早期错标（不存在的文件/错误键名）导致保存默认模型
+# 必然失败或写进无效键，覆盖无风险。
 CONFIG_PATCH = {
     "qwencode": {"path": "~/.qwen/settings.json", "format": None, "model_key": None},
-    # grok 实测配置是 TOML（config.toml 的 [models] default）；早期版本错标成
-    # config.json + format=json，文件永远不存在导致「保存默认模型」必然失败——
-    # 必须覆盖修正（写 config.json 无任何效果，覆盖无风险）。
     "grok-build": {"path": "~/.grok/config.toml", "format": "toml-section",
                    "model_key": "models.default"},
+    "kimi-code": {"path": "~/.kimi-code/config.toml", "format": "toml-section",
+                  "model_key": "default_model"},
+    "mimo-code": {"path": "~/.config/mimocode/mimocode.jsonc", "format": "jsonc",
+                  "model_key": "model"},
+    "pi": {"path": "~/.pi/agent/settings.json", "format": "json-path",
+           "model_key": "defaultModel",
+           "model_extra_keys": {"defaultProvider": ""}},
+    "openclaw": {"path": "~/.openclaw/openclaw.json", "format": "json-path",
+                 "model_key": "agents.defaults.model.primary"},
 }
 
 

package/app/core/flows.py

@@ -31,7 +31,7 @@ ENGINE_DEFAULTS = {
 # icon 约定："i-*" = 前端精灵表单色线性图标（随日/夜主题黑白）；其他值（emoji）原样显示，
 # 供自定义流程兜底。预置图标不进 overrides（见 _EDITABLE），保证升级后老数据也拿到新图标。
 BUILTIN_FLOWS = [
-    {"id": "direct", "name": "直接执行", "icon": "i-gauge", "engine": "direct", "builtin": True,
+    {"id": "direct", "name": "直接执行", "icon": "i-chat", "engine": "direct", "builtin": True,
      "goal_hint": "让 AI 直接做什么（一句话，可带附件）",
      "note": "单智能体直达：目标+附件交给一个 CLI 跑完即止，无拆解/评审（快）"},
     {"id": "code", "name": "代码", "icon": "i-code", "engine": "code", "builtin": True,

package/app/core/gitmod.py

@@ -4,10 +4,10 @@
 设计约束（对齐质量闸门原则：显式意图不容静默降级）：
 - 探测只读：/api/git/info 只跑 rev-parse / status / log，不改仓库任何东西。
 - 检出不破坏用户现场：不直接在所选版本上 detached checkout，而是从它创建
-  任务分支 tutti/<task-id> 再检出——原分支指针不动，任务产物落在任务分支上。
+  任务分支 codebee/<task-id> 再检出（老 tutti/<id> 分支仍可合并/丢弃）——原分支指针不动，任务产物落在任务分支上。
 - 工作区不必干净也能检出：未提交改动先 git stash 原样收起（_attachments/
   的附件除外，那是同一任务刚上传的素材），收尾切回后 apply 还原——开发仓库
-  永远有并行改动，硬拒绝等于代码版本隔离不可用。stash 条目按 tutti-stash-*
+  永远有并行改动，硬拒绝等于代码版本隔离不可用。stash 条目按 codebee-stash-*
   标记，还原失败时保留在 stash 列表里可手工找回，绝不静默丢弃。
 """
 from __future__ import annotations
@@ -78,8 +78,12 @@ def repo_info(workdir):
     }
 
 
+BRANCH_PREFIX = "codebee/"   # 任务分支前缀；老分支 tutti/<id> 在列表里仍被识别（下方 _TASK_BRANCH_RE）
+_TASK_BRANCH_RES = ("codebee/", "tutti/")   # 老版本发布的任务分支前缀，只读兼容
+
+
 def branch_name(task_id):
-    return "tutti/" + str(task_id)
+    return BRANCH_PREFIX + str(task_id)
 
 
 def _stash_dirty(workdir, label):
@@ -88,7 +92,7 @@ def _stash_dirty(workdir, label):
     _attachments/ 除外：那是本任务刚上传的附件，必须留在工作目录供注入。
     pathspec 排除走 argv，不经过 shell。失败返回错误——绝不静默带着脏改动切分支。
     """
-    m = "tutti-stash-%s" % label
+    m = "codebee-stash-%s" % label
     r = _git(workdir, "stash", "push", "-u", "-m", m,
              "--", ".", ":(exclude)_attachments", timeout=60)
     if not r["ok"]:
@@ -359,7 +363,7 @@ def finalize_run(workdir, gitinfo, message):
     语义（对齐 Baton/Codeband 的隔离模型；本轮只做「保存现场」，任务分支
     的合并/丢弃留给后续的人工裁决）：
     - 产物必须可找回：哪怕 run 失败/取消，已写盘的半成品也提交到
-      tutti/<task-id>（WIP 语义），绝不留在用户工作区里污染原分支；
+      codebee/<task-id>（WIP 语义），绝不留在用户工作区里污染原分支；
     - _attachments/ 不提交也不丢：用户上传的共享附件保持未跟踪，
       切分支后仍留在工作目录（未跟踪文件随分支切换保留）；
     - 任何收尾失败都不抛出：run 终态已定，问题记入 restore_error
@@ -394,7 +398,7 @@ def finalize_run(workdir, gitinfo, message):
         staged = _git(workdir, "diff", "--cached", "--name-only")
         if staged["ok"] and (staged["stdout"] or "").strip():
             # 一次性身份配置：用户仓库可能没配 user.name/email，缺身份不应让提交失败
-            c = _git(workdir, "-c", "user.name=Tutti", "-c", "user.email=tutti@orchestra.local",
+            c = _git(workdir, "-c", "user.name=CodeBee", "-c", "user.email=codebee@orchestra.local",
                      "commit", "-m", str(message)[:200], "--quiet")
             if not c["ok"]:
                 out["restore_error"] = "提交任务分支失败：%s" % (c["stderr"] or "")[-160:]
@@ -481,9 +485,9 @@ def merge_task_branch(workdir, task):
             out = {"restore_error": ""}
             _restore_stash(wd, stash_sha, out)
         return refuse("任务分支没有领先基线的提交（产物为空），无需合并；可直接丢弃")
-    m = _git(wd, "-c", "user.name=Tutti", "-c", "user.email=tutti@orchestra.local",
+    m = _git(wd, "-c", "user.name=CodeBee", "-c", "user.email=codebee@orchestra.local",
              "merge", "--no-ff", br, "-m",
-             "tutti: 合并任务分支 %s（%s）" % (tid, (task or {}).get("title") or "")[:200])
+             "codebee: 合并任务分支 %s（%s）" % (tid, (task or {}).get("title") or "")[:200])
     if not m["ok"]:
         ab = _git(wd, "merge", "--abort")
         tail = (m["stderr"] or m["stdout"] or "")[-200:]
@@ -775,7 +779,7 @@ def workbench_op(workdir, action, params=None):
 
     守卫：action 白名单；path 走 _safe_relpath；分支/提交信息限长。
     丢弃（discard）与删除未跟踪文件（delete）不可恢复，必须 confirm=true。
-    stash 系列只认 tutti-stash-* 标记条目——用户自己的 stash 不在工作台露出，
+    stash 系列只认 codebee-stash-* 标记条目（老 tutti-stash-* 也认）——用户自己的 stash 不在工作台露出，
     避免误 pop 撞掉检出链收起的现场。
     """
     params = params or {}
@@ -915,7 +919,7 @@ def workbench_op(workdir, action, params=None):
 
     if action == "stash_push":
         msg = str(params.get("message") or "").strip()[:120]
-        m = "tutti-stash-%s" % (msg or "workbench")
+        m = "codebee-stash-%s" % (msg or "workbench")
         r = _git(wd, "stash", "push", "-u", "-m", m, "--", ".", ":(exclude)_attachments",
                  timeout=90)
         ok, err, data = _res(r)
@@ -938,8 +942,8 @@ def workbench_op(workdir, action, params=None):
         if found is None:
             return False, "stash 条目不存在", {}
         # %s 的形态是 "On master: <message>"/"WIP on ..."，认标记用包含判断
-        if "tutti-stash-" not in found:
-            return False, "工作台只处理编排台自己收起的 stash（tutti-stash-*），你自己的条目请手工处理", {}
+        if "codebee-stash-" not in found:
+            return False, "工作台只处理编排台自己收起的 stash（codebee-stash-*），你自己的条目请手工处理", {}
         if action == "stash_pop":
             return _res(_git(wd, "stash", "pop", ref, timeout=90))
         if not params.get("confirm"):