codebee 0.1.68 → 0.1.70

package/app/mcp_server.py

@@ -0,0 +1,175 @@
+# -*- coding: utf-8 -*-
+"""CodeBee 的 MCP 服务器形态：其他 AI 客户端（Claude Code / ZCode / Cursor）
+把这里当工具服务器挂载，即可直接创建任务、查状态、看用量与评测榜单——
+CodeBee 从编排工具变成可以被别的智能体调度的生态节点。
+
+stdio JSON-RPC 2.0（按行分帧，与 core/mcp_client 同一传输约定）。启动：
+  python -X utf8 <CodeBee目录>/app/mcp_server.py
+客户端配置示例（Claude Code / 兼容客户端）：
+  {"mcpServers": {"codebee": {"command": "python",
+                              "args": ["-X", "utf8", "<CodeBee目录>/app/mcp_server.py"]}}}
+仅本机 stdio，无网络监听，凭据不经过此通道；create_task 会真实调度智能体
+执行（与界面上建任务同一条链）。
+"""
+from __future__ import annotations
+
+import json
+import sys
+
+PROTOCOL_VERSION = "2024-11-05"
+SERVER_INFO = {"name": "codebee", "version": "1.0"}
+
+TOOLS = [
+    {"name": "create_task", "description": "创建并启动一个 CodeBee 编排任务（真实调度智能体执行，与界面建任务同链）。返回 task_id 与 run_id。",
+     "inputSchema": {"type": "object", "properties": {
+         "goal": {"type": "string", "description": "任务目标（一句话说清要做什么）"},
+         "type": {"type": "string", "description": "任务类型 id（如 code/novel/doc/direct），默认 doc"},
+         "workdir": {"type": "string", "description": "工作目录绝对路径；留空用 CodeBee 默认保存路径"},
+         "title": {"type": "string", "description": "任务标题；留空取目标前 30 字"}},
+         "required": ["goal"]}},
+    {"name": "get_status", "description": "查任务与最近一次运行的状态：进度、当前步骤、评分、错误。",
+     "inputSchema": {"type": "object", "properties": {
+         "task_id": {"type": "string", "description": "任务 ID"}}, "required": ["task_id"]}},
+    {"name": "list_recent", "description": "列出最近的运行（id/标题/状态/时间）。",
+     "inputSchema": {"type": "object", "properties": {
+         "limit": {"type": "integer", "description": "条数，默认 10，最大 30"}}}},
+    {"name": "usage_summary", "description": "用量台账汇总：今日/本月花费（¥）与 token 总量。",
+     "inputSchema": {"type": "object", "properties": {}}},
+    {"name": "bench_leaderboard", "description": "模型评测基准台能力榜（综合分 Top N）。",
+     "inputSchema": {"type": "object", "properties": {
+         "top": {"type": "integer", "description": "取前 N，默认 5"}}}},
+]
+
+
+def _enqueue(job):
+    """thin wrapper：便于单测 mock（真链会拉起 worker 执行）。"""
+    from core import jobs
+    jobs.enqueue(job)
+
+
+def _tool_create_task(args):
+    from core import settings as settings_mod, store
+    goal = str(args.get("goal") or "").strip()
+    if not goal:
+        return {"isError": True, "content": "goal 不能为空"}
+    payload = {"type": str(args.get("type") or "doc").strip()[:40] or "doc",
+               "title": (str(args.get("title") or "").strip() or goal[:30])[:40],
+               "goal": goal[:4000],
+               "workdir": str(args.get("workdir") or "").strip()
+               or settings_mod.default_workdir()}
+    task = store.create_task(payload)
+    run = store.create_run("orchestration", task["title"], task_id=task["id"])
+    store.update_task_status(task["id"], "queued")
+    _enqueue({"kind": "orchestration", "run_id": run["id"], "task_id": task["id"]})
+    return {"content": "已创建并排队：task_id=%s run_id=%s（可用 get_status 查进度）"
+            % (task["id"], run["id"])}
+
+
+def _tool_get_status(args):
+    from core import store
+    task = store.get_task(str(args.get("task_id") or "").strip())
+    if not task:
+        return {"isError": True, "content": "任务不存在"}
+    lines = ["任务：%s（%s）" % (task.get("title"), task.get("status"))]
+    run = store.latest_run_by_task().get(task["id"])
+    if run:
+        lines.append("最近运行：%s（%s）" % (run.get("id"), run.get("status")))
+        steps = [s for s in (run.get("steps") or []) if isinstance(s, dict)]
+        if steps:
+            cur = steps[-1]
+            lines.append("步骤 %d/%d：%s（%s）" % (len(steps), run.get("total_steps") or len(steps),
+                                                  cur.get("title"), cur.get("status")))
+        v = run.get("verdict") or {}
+        if v.get("overall") is not None:
+            lines.append("评分 %.1f（%s）" % (float(v["overall"]),
+                                             "达标" if v.get("publishable") else "未达标"))
+        if run.get("error"):
+            lines.append("错误：%s" % str(run["error"])[:200])
+    if task.get("git_state") == "isolated":
+        lines.append("⚠ 任务分支待裁决（合并/丢弃）")
+    return {"content": "\n".join(lines)}
+
+
+def _tool_list_recent(args):
+    from core import store
+    try:
+        limit = max(1, min(30, int(args.get("limit") or 10)))
+    except (TypeError, ValueError):
+        limit = 10
+    rows = [{"id": r.get("id"), "title": r.get("title"), "status": r.get("status"),
+             "ts": r.get("started_at") or ""} for r in store.list_runs(limit=limit)]
+    return {"content": json.dumps(rows, ensure_ascii=False, indent=1)}
+
+
+def _tool_usage_summary(args):
+    from core import usage
+    today, month = usage.cost_snapshot()
+    tokens = sum(int(r.get("total") or 0) for r in usage._iter_records(31))
+    return {"content": "今日花费 ¥%.2f\n本月花费 ¥%.2f\n近 31 天 tokens：%d（未标定单价的调用不计钱）"
+            % (today, month, tokens)}
+
+
+def _tool_bench(args):
+    from core import evalbench
+    try:
+        top = max(1, min(10, int(args.get("top") or 5)))
+    except (TypeError, ValueError):
+        top = 5
+    board = evalbench.state().get("leaderboard") or []
+    rows = [{"rank": r["rank"], "model": r["model"], "overall": r["overall"],
+             "provider": r.get("provider_name")} for r in board[:top]]
+    return {"content": json.dumps(rows, ensure_ascii=False, indent=1)}
+
+
+_TOOL_IMPL = {"create_task": _tool_create_task, "get_status": _tool_get_status,
+              "list_recent": _tool_list_recent, "usage_summary": _tool_usage_summary,
+              "bench_leaderboard": _tool_bench}
+
+
+def handle_request(msg):
+    """处理一条客户端请求，返回响应 dict（通知返回 None）。"""
+    if not isinstance(msg, dict) or msg.get("method") is None:
+        return None
+    rid = msg.get("id")
+    method = str(msg["method"])
+    if method == "initialize":
+        return {"jsonrpc": "2.0", "id": rid, "result": {
+            "protocolVersion": PROTOCOL_VERSION, "capabilities": {"tools": {}},
+            "serverInfo": SERVER_INFO}}
+    if method.startswith("notifications/"):
+        return None
+    if method == "tools/list":
+        return {"jsonrpc": "2.0", "id": rid, "result": {"tools": TOOLS}}
+    if method == "tools/call":
+        params = msg.get("params") or {}
+        name = str(params.get("name") or "")
+        fn = _TOOL_IMPL.get(name)
+        if fn is None:
+            return {"jsonrpc": "2.0", "id": rid, "result": {
+                "isError": True, "content": "未知工具: %s" % name}}
+        try:
+            out = fn(params.get("arguments") or {})
+        except Exception as e:
+            out = {"isError": True, "content": "工具执行失败: %s" % e}
+        return {"jsonrpc": "2.0", "id": rid, "result": out}
+    return {"jsonrpc": "2.0", "id": rid,
+            "error": {"code": -32601, "message": "no such method: %s" % method}}
+
+
+def main():
+    for raw in sys.stdin:
+        line = raw.strip()
+        if not line.startswith("{"):
+            continue
+        try:
+            msg = json.loads(line)
+        except Exception:
+            continue
+        resp = handle_request(msg)
+        if resp is not None:
+            sys.stdout.write(json.dumps(resp, ensure_ascii=False) + "\n")
+            sys.stdout.flush()
+
+
+if __name__ == "__main__":
+    main()

package/app/pet.py

@@ -11,6 +11,10 @@ CodeBee 蜜蜂。实现要点：
   庆祝=原地旋转、睡觉=调暗降饱和、失联=灰化）；机器没有 Pillow 或素材缺失
   时回落「手绘模式」——canvas 矢量卡通蜜蜂（零依赖兜底，npm 分发用户可能
   装不了 PIL）。
+- 底板：Windows 用 -transparentcolor 键色逐像素透明，蜜蜂真浮空；macOS 的
+  Tk 没有逐像素透明（键色是 Windows 专属），矩形底板必然整个露出来还带
+  系统边框——非 Windows 把底板画成深色卡片（「桌面小组件」形态），状态
+  滤镜只作用于蜂体、不碰底板色（2026-09-25 Mac 实拍白板翻车）。
 - 状态机：sleep（打盹）/ work（振翅）/ cheer（翻滚庆祝）/ alert（警示抖动），
   由「上一轮活跃任务集合 vs 本轮结果」的差分推出，不需要后端记事件流。
 - 悬停任务清单走指针轮询而不是 Enter/Leave：-transparentcolor 的透明像素在
@@ -310,6 +314,72 @@ def _http_json(port, path, body=None):
 # 用罕见深色，蜜蜂配色不会撞上。
 KEY = "#010203"
 KEY_RGB = (1, 2, 3)
+# 非 Windows 底板：macOS 的 Tk 没有逐像素透明（-transparentcolor 是
+# Windows 专属），矩形底板必然整个露出来还带系统边框——索性把底板画成
+# 深色卡片（对齐悬停清单面板色），桌宠呈「桌面小组件」形态，而不是
+# 一块突兀的白板（2026-09-25 Mac 实拍翻车）。
+CARD_BG = "#1B2430"
+CARD_RGB = (27, 36, 48)
+
+
+def plate_for(os_name):
+    """底板色：Windows=键色（配 -transparentcolor 逐像素透明）；其余=卡片色。"""
+    return KEY if os_name == "nt" else CARD_BG
+
+
+def plate_rgb_for(os_name):
+    """底板色的 RGB 元组（精灵帧合成/噪点归底用），与 plate_for 同源。"""
+    return KEY_RGB if os_name == "nt" else CARD_RGB
+
+
+PLATE = plate_for(os.name)
+PLATE_RGB = plate_rgb_for(os.name)
+
+
+def composite_plate(img, plate_rgb):
+    """RGBA 精灵合成到不透明底色（纯像素逻辑，不碰 Tk，可测试）。"""
+    from PIL import Image
+    bg = Image.new("RGBA", img.size, tuple(plate_rgb) + (255,))
+    bg.alpha_composite(img)
+    return bg.convert("RGB")
+
+
+def knock_to_plate(img, plate_rgb):
+    """近底色噪点（旋转/缩放的 AA 碎点）归底色，原地修改并返回。"""
+    pr, pg, pb = plate_rgb
+    px = img.load()
+    w, h = img.size
+    for yy in range(h):
+        for xx in range(w):
+            r, g, b = px[xx, yy]
+            if abs(r - pr) + abs(g - pg) + abs(b - pb) < 12:
+                px[xx, yy] = plate_rgb
+    return img
+
+
+def mood_rgba(img, color=1.0, bright=1.0):
+    """状态滤镜（降饱和/调暗/灰化）只作用于有内容的像素，底板色不动。
+
+    ImageEnhance 系列对整图混色，会把透明洞当黑色往里掺；而本文件的做法
+    是先合成到底板再出帧，底板跟着变暗后卡片上就浮出一块更暗的小框
+    （Windows 靠近键噪点归键兜回来，Mac 卡片底兜不回来）——故按 alpha
+    手做：透明像素原样，蜂体像素做 luma 降饱和 + 调暗。不修改入参图。
+    """
+    img = img.copy()
+    px = img.load()
+    w, h = img.size
+    for yy in range(h):
+        for xx in range(w):
+            r, g, b, a = px[xx, yy]
+            if not a:
+                continue
+            lum = int(r * 0.299 + g * 0.587 + b * 0.114)
+            px[xx, yy] = (
+                min(255, max(0, int((lum * (1 - color) + r * color) * bright))),
+                min(255, max(0, int((lum * (1 - color) + g * color) * bright))),
+                min(255, max(0, int((lum * (1 - color) + b * color) * bright))),
+                a)
+    return img
 WIN_W, WIN_H = 170, 150          # 手绘回落模式的窗口尺寸
 SPRITE_DIR = Path(__file__).resolve().parent
 SPRITE_DISP_H = 112              # 精灵显示高度（宽等比）
@@ -496,7 +566,7 @@ class PetApp:
                 self.root.attributes("-transparentcolor", KEY)
             except Exception:
                 pass
-        self.root.configure(bg=KEY)
+        self.root.configure(bg=PLATE)
 
         # 形象：本地 cfg 优先（换形象要立刻见效，不等服务端轮询），缺省 plush
         self.skin = str(cfg.get("skin") or DEFAULT_SKIN)
@@ -515,7 +585,7 @@ class PetApp:
             self.win_w, self.win_h = WIN_W, WIN_H
 
         self.cv = tk.Canvas(self.root, width=self.win_w, height=self.win_h,
-                            bg=KEY, highlightthickness=0, bd=0)
+                            bg=PLATE, highlightthickness=0, bd=0)
         self.cv.pack()
         self.spr = None
 
@@ -628,7 +698,7 @@ class PetApp:
         expand 放画布，窗口会比蜂体大一圈，点缀画件全悬空（真机截图翻车）。
         """
         try:
-            from PIL import Image, ImageEnhance, ImageTk
+            from PIL import Image, ImageTk
         except Exception:
             # 无 Pillow：用 Tk 原生 PhotoImage 直接贴 PNG（Tk 8.6+ 原生解码，
             # 零依赖）——此前直接回落手绘蜂，普通用户 npm 装完没有 Pillow，
@@ -659,30 +729,21 @@ class PetApp:
             base = base0.resize((disp_w, disp_h), Image.LANCZOS)
 
             def flat(img):
-                """合成到键色底：羽化边缘自然过渡，键色即透明，无需真 alpha。"""
-                bg = Image.new("RGBA", img.size, KEY_RGB + (255,))
-                bg.alpha_composite(img)
-                return bg.convert("RGB")
+                """合成到底板色：Windows 键色待逐像素透明，Mac 卡片底；
+                羽化边缘自然过渡，无需真 alpha。"""
+                return composite_plate(img, PLATE_RGB)
 
             def bake(img):
-                """RGB → PhotoImage；近键色噪点（旋转/缩放的 AA 碎点）归键。"""
-                px = img.load()
-                w, h = img.size
-                for yy in range(h):
-                    for xx in range(w):
-                        r, g, b = px[xx, yy]
-                        if abs(r - 1) + abs(g - 2) + abs(b - 3) < 12:
-                            px[xx, yy] = KEY_RGB
-                return ImageTk.PhotoImage(img)
+                """RGB → PhotoImage；近底色噪点（旋转/缩放的 AA 碎点）归底。"""
+                return ImageTk.PhotoImage(knock_to_plate(img, PLATE_RGB))
 
             rot = lambda a: flat(base.rotate(a, resample=Image.BICUBIC))
             frames = {
                 "alert": [bake(flat(base))],
-                "sleep": [bake(ImageEnhance.Brightness(
-                    ImageEnhance.Color(flat(base)).enhance(0.7)
-                ).enhance(0.55))],
-                "dead": [bake(ImageEnhance.Brightness(
-                    flat(base).convert("L").convert("RGB")).enhance(0.6))],
+                # 睡觉降饱和调暗 / 失联灰化：滤镜只碰蜂体不碰底板
+                # （mood_rgba 按 alpha 手做，底板色恒定，卡片不浮暗框）
+                "sleep": [bake(flat(mood_rgba(base, color=0.7, bright=0.55)))],
+                "dead": [bake(flat(mood_rgba(base, color=0.0, bright=0.6)))],
                 "work": [bake(rot(a)) for a in (-8, -4, 0, 4, 8)],
                 # 欢腾摇摆：左倾-回正-右倾-回正，像跳舞不像旋转木马
                 "cheer": [bake(rot(a)) for a in (0, 10, 20, 10, 0, -10,

package/app/pick_dialog.py

@@ -1,110 +1,110 @@
-#!/usr/bin/env python3
-"""原生「选择文件夹」对话框（main.py 的 /api/pick_folder 用）。
-
-Tk 必须活在自家进程的主线程里：HTTP 请求线程里建 root 在 macOS 上会崩，
-Windows 上反复建/销毁也不稳，所以隔离成独立进程。ask_directory() 是父端
-入口，把本文件拉起为子进程，请求参数（JSON：initial 起始目录 / title 标题）
-走 stdin，选中目录以 JSON（{"path": ...}）走 stdout，用户取消回空串；
-对话框部分是文件尾的 main()。任何一步失败都以非零码退出，父端据此回
-fallback=true 让前端回落网页目录弹框。"""
-import json
-import os
-import subprocess
-import sys
-from pathlib import Path
-
-# 非 Windows 置 0：POSIX 的 Popen 对非零 creationflags 抛 ValueError（manager 同款守卫）
-CREATE_NO_WINDOW = 0x08000000 if os.name == "nt" else 0
-_SELF = str(Path(__file__).resolve())
-
-
-def ask_directory(initial="", title="选择文件夹"):
-    """父端入口：拉起子进程弹原生对话框，返回 (path, error, fallback)。
-
-    用户取消时 path 为空串；子进程起不来（机器无 tkinter 等）时 error
-    非空且 fallback=True，调用方原样转给前端回落网页目录弹框。"""
-    if not Path(__file__).exists():
-        return "", "pick_dialog.py 缺失", True
-    req = json.dumps({"initial": initial, "title": title}).encode("utf-8")
-    env = dict(os.environ, PYTHONIOENCODING="utf-8")
-    try:
-        if os.name == "nt":
-            cp = subprocess.run([sys.executable, _SELF], input=req,
-                                capture_output=True, timeout=600, env=env,
-                                creationflags=CREATE_NO_WINDOW)
-        else:
-            cp = subprocess.run([sys.executable, _SELF], input=req,
-                                capture_output=True, timeout=600, env=env)
-    except Exception as e:
-        return "", str(e), True
-    if cp.returncode != 0:
-        err = (cp.stderr or b"").decode("utf-8", "replace").strip().splitlines()
-        return "", (err[-1] if err else "native picker unavailable"), True
-    try:
-        data = json.loads((cp.stdout or b"").decode("utf-8", "replace") or "{}")
-    except Exception:
-        return "", "对话框输出无法解析", True
-    return str(data.get("path") or ""), "", False
-
-
-def ask_file(initial="", title="选择文件"):
-    """父端入口：拉起子进程弹原生「选择文件」对话框（导入备份包用）。
-    返回 (path, error, fallback)，语义与 ask_directory 一致。"""
-    if not Path(__file__).exists():
-        return "", "pick_dialog.py 缺失", True
-    req = json.dumps({"mode": "file", "initial": initial, "title": title}).encode("utf-8")
-    env = dict(os.environ, PYTHONIOENCODING="utf-8")
-    try:
-        if os.name == "nt":
-            cp = subprocess.run([sys.executable, _SELF], input=req,
-                                capture_output=True, timeout=600, env=env,
-                                creationflags=CREATE_NO_WINDOW)
-        else:
-            cp = subprocess.run([sys.executable, _SELF], input=req,
-                                capture_output=True, timeout=600, env=env)
-    except Exception as e:
-        return "", str(e), True
-    if cp.returncode != 0:
-        err = (cp.stderr or b"").decode("utf-8", "replace").strip().splitlines()
-        return "", (err[-1] if err else "native picker unavailable"), True
-    try:
-        data = json.loads((cp.stdout or b"").decode("utf-8", "replace") or "{}")
-    except Exception:
-        return "", "对话框输出无法解析", True
-    return str(data.get("path") or ""), "", False
-
-
-def main():
-    req = {}
-    try:
-        req = json.loads(sys.stdin.read() or "{}")
-    except Exception:
-        pass
-    import tkinter as tk
-    from tkinter import filedialog
-
-    root = tk.Tk()
-    root.withdraw()
-    try:
-        root.attributes("-topmost", True)   # 别被全屏浏览器盖住
-    except Exception:
-        pass
-    is_file = req.get("mode") == "file"
-    kw = {"title": req.get("title") or ("选择文件" if is_file else "选择文件夹")}
-    init = req.get("initial") or ""
-    if init and os.path.isdir(init):
-        kw["initialdir"] = init
-    try:
-        if is_file:
-            kw["filetypes"] = [("备份包", "*.zip"), ("全部文件", "*.*")]
-            path = filedialog.askopenfilename(**kw) or ""
-        else:
-            path = filedialog.askdirectory(**kw) or ""
-    except Exception:
-        sys.exit(1)
-    sys.stdout.write(json.dumps({"path": path}))
-    root.destroy()
-
-
-if __name__ == "__main__":
-    main()
+#!/usr/bin/env python3
+"""原生「选择文件夹」对话框（main.py 的 /api/pick_folder 用）。
+
+Tk 必须活在自家进程的主线程里：HTTP 请求线程里建 root 在 macOS 上会崩，
+Windows 上反复建/销毁也不稳，所以隔离成独立进程。ask_directory() 是父端
+入口，把本文件拉起为子进程，请求参数（JSON：initial 起始目录 / title 标题）
+走 stdin，选中目录以 JSON（{"path": ...}）走 stdout，用户取消回空串；
+对话框部分是文件尾的 main()。任何一步失败都以非零码退出，父端据此回
+fallback=true 让前端回落网页目录弹框。"""
+import json
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+# 非 Windows 置 0：POSIX 的 Popen 对非零 creationflags 抛 ValueError（manager 同款守卫）
+CREATE_NO_WINDOW = 0x08000000 if os.name == "nt" else 0
+_SELF = str(Path(__file__).resolve())
+
+
+def ask_directory(initial="", title="选择文件夹"):
+    """父端入口：拉起子进程弹原生对话框，返回 (path, error, fallback)。
+
+    用户取消时 path 为空串；子进程起不来（机器无 tkinter 等）时 error
+    非空且 fallback=True，调用方原样转给前端回落网页目录弹框。"""
+    if not Path(__file__).exists():
+        return "", "pick_dialog.py 缺失", True
+    req = json.dumps({"initial": initial, "title": title}).encode("utf-8")
+    env = dict(os.environ, PYTHONIOENCODING="utf-8")
+    try:
+        if os.name == "nt":
+            cp = subprocess.run([sys.executable, _SELF], input=req,
+                                capture_output=True, timeout=600, env=env,
+                                creationflags=CREATE_NO_WINDOW)
+        else:
+            cp = subprocess.run([sys.executable, _SELF], input=req,
+                                capture_output=True, timeout=600, env=env)
+    except Exception as e:
+        return "", str(e), True
+    if cp.returncode != 0:
+        err = (cp.stderr or b"").decode("utf-8", "replace").strip().splitlines()
+        return "", (err[-1] if err else "native picker unavailable"), True
+    try:
+        data = json.loads((cp.stdout or b"").decode("utf-8", "replace") or "{}")
+    except Exception:
+        return "", "对话框输出无法解析", True
+    return str(data.get("path") or ""), "", False
+
+
+def ask_file(initial="", title="选择文件"):
+    """父端入口：拉起子进程弹原生「选择文件」对话框（导入备份包用）。
+    返回 (path, error, fallback)，语义与 ask_directory 一致。"""
+    if not Path(__file__).exists():
+        return "", "pick_dialog.py 缺失", True
+    req = json.dumps({"mode": "file", "initial": initial, "title": title}).encode("utf-8")
+    env = dict(os.environ, PYTHONIOENCODING="utf-8")
+    try:
+        if os.name == "nt":
+            cp = subprocess.run([sys.executable, _SELF], input=req,
+                                capture_output=True, timeout=600, env=env,
+                                creationflags=CREATE_NO_WINDOW)
+        else:
+            cp = subprocess.run([sys.executable, _SELF], input=req,
+                                capture_output=True, timeout=600, env=env)
+    except Exception as e:
+        return "", str(e), True
+    if cp.returncode != 0:
+        err = (cp.stderr or b"").decode("utf-8", "replace").strip().splitlines()
+        return "", (err[-1] if err else "native picker unavailable"), True
+    try:
+        data = json.loads((cp.stdout or b"").decode("utf-8", "replace") or "{}")
+    except Exception:
+        return "", "对话框输出无法解析", True
+    return str(data.get("path") or ""), "", False
+
+
+def main():
+    req = {}
+    try:
+        req = json.loads(sys.stdin.read() or "{}")
+    except Exception:
+        pass
+    import tkinter as tk
+    from tkinter import filedialog
+
+    root = tk.Tk()
+    root.withdraw()
+    try:
+        root.attributes("-topmost", True)   # 别被全屏浏览器盖住
+    except Exception:
+        pass
+    is_file = req.get("mode") == "file"
+    kw = {"title": req.get("title") or ("选择文件" if is_file else "选择文件夹")}
+    init = req.get("initial") or ""
+    if init and os.path.isdir(init):
+        kw["initialdir"] = init
+    try:
+        if is_file:
+            kw["filetypes"] = [("备份包", "*.zip"), ("全部文件", "*.*")]
+            path = filedialog.askopenfilename(**kw) or ""
+        else:
+            path = filedialog.askdirectory(**kw) or ""
+    except Exception:
+        sys.exit(1)
+    sys.stdout.write(json.dumps({"path": path}))
+    root.destroy()
+
+
+if __name__ == "__main__":
+    main()

package/app/plugins/code-review-helper/.codex-plugin/plugin.json

@@ -0,0 +1,18 @@
+{
+  "name": "code-review-helper",
+  "version": "0.1.0",
+  "description": "把代码评审前的风险检查接入 CodeBee。",
+  "author": {
+    "name": "CodeBee"
+  },
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "代码评审助手",
+    "shortDescription": "提测前快速检查边界、异常、并发与安全风险。",
+    "longDescription": "一个轻量的代码评审守则插件，安装后会在 code 类型任务中自动注入检查清单。",
+    "developerName": "CodeBee",
+    "category": "代码开发",
+    "capabilities": ["Review", "Write"],
+    "defaultPrompt": ["请按评审清单检查这段代码。"]
+  }
+}

package/app/plugins/code-review-helper/skills/review.md

@@ -0,0 +1,16 @@
+---
+name: 代码评审助手
+scopes:
+  - code
+note: 提测前检查边界、异常、并发与安全风险
+---
+
+# 代码评审助手
+
+在提交评审前，按下面顺序检查并给出证据：
+
+1. 输入边界：空值、超长值、非法状态和权限边界是否有明确行为。
+2. 异常路径：失败是否可观察、可重试，是否会吞掉错误或留下半成品。
+3. 并发与资源：共享状态、锁、超时、子进程和临时文件是否能收敛。
+4. 安全：路径穿越、命令注入、凭据泄漏和不可信内容注入是否被阻断。
+5. 回归：为每个修复点补一个最小测试，并说明没有覆盖的风险。