codex-flow 2.1.13__py3-none-any.whl

codex_flow/data/scripts/menu.py

@@ -0,0 +1,646 @@
+#!/usr/bin/env python3
+"""Interactive management console for codex-flow."""
+
+from __future__ import annotations
+
+import os
+import subprocess
+import sys
+import unicodedata
+from pathlib import Path
+from typing import Any
+
+try:
+    from . import telemetry
+except ImportError:
+    import telemetry  # type: ignore
+
+try:
+    from localization import resolve_language, tr
+except ImportError:
+    from scripts.localization import resolve_language, tr  # type: ignore
+
+try:
+    from updater import cached_status as cached_update_status, update_menu_label as updater_menu_label
+except ImportError:
+    from scripts.updater import (  # type: ignore
+        cached_status as cached_update_status,
+        update_menu_label as updater_menu_label,
+    )
+
+ROOT_DIR = Path(__file__).resolve().parents[1]
+CODEX_HOME = Path(os.environ.get("CODEX_HOME", Path.home() / ".codex"))
+STATE_DIR = CODEX_HOME / "codex-flow"
+LANG = resolve_language(CODEX_HOME / "codex-flow.toml")
+
+
+def T(en: str, zh: str) -> str:
+    return tr(en, zh, lang=LANG)
+
+
+class ConsoleStyle:
+    def __init__(self) -> None:
+        self.enabled = (
+            sys.stdout.isatty()
+            and os.environ.get("NO_COLOR") != "1"
+            and os.environ.get("TERM") != "dumb"
+        )
+        if self.enabled:
+            self.BOLD = "\033[1m"
+            self.DIM = "\033[2m"
+            self.CYAN = "\033[36m"
+            self.GREEN = "\033[32m"
+            self.YELLOW = "\033[33m"
+            self.RED = "\033[31m"
+            self.MAGENTA = "\033[35m"
+            self.RESET = "\033[0m"
+        else:
+            self.BOLD = self.DIM = self.CYAN = self.GREEN = ""
+            self.YELLOW = self.RED = self.MAGENTA = self.RESET = ""
+
+
+style = ConsoleStyle()
+
+
+def display_width(s: str) -> int:
+    return sum(2 if unicodedata.east_asian_width(ch) in ("W", "F") else 1 for ch in s)
+
+
+def truncate_display(s: str, max_width: int) -> str:
+    cur = 0
+    res: list[str] = []
+    for ch in s:
+        width = 2 if unicodedata.east_asian_width(ch) in ("W", "F") else 1
+        if cur + width > max_width:
+            break
+        res.append(ch)
+        cur += width
+    return "".join(res)
+
+
+def pad_display(s: str, target_width: int, align: str = "left") -> str:
+    pad = max(0, target_width - display_width(s))
+    return (" " * pad + s) if align == "right" else (s + " " * pad)
+
+
+def print_banner(version: str = "1.0.0") -> None:
+    print(f"\n{style.DIM}╭────────────────────────────────────────────────────────────────────╮{style.RESET}")
+    title = T(f"🚀 codex-flow Console (v{version})", f"🚀 codex-flow 控制台 (v{version})")
+    pad_len = max(0, 66 - display_width(title))
+    left_pad = pad_len // 2
+    right_pad = pad_len - left_pad
+    print(f"{style.DIM}│{style.RESET}{' ' * left_pad}{style.BOLD}{style.CYAN}{title}{style.RESET}{' ' * right_pad}{style.DIM}│{style.RESET}")
+    sub = T(
+        "FlowPilot orchestration · deterministic telemetry · local benchmark validation",
+        "FlowPilot 智能编排 · 确定性任务遥测 · 本地 Benchmark 验证",
+    )
+    sub_pad = max(0, 66 - display_width(sub))
+    sub_l = sub_pad // 2
+    sub_r = sub_pad - sub_l
+    print(f"{style.DIM}│{style.RESET}{' ' * sub_l}{style.DIM}{sub}{style.RESET}{' ' * sub_r}{style.DIM}│{style.RESET}")
+    print(f"{style.DIM}╰────────────────────────────────────────────────────────────────────╯{style.RESET}\n")
+
+
+def get_version() -> str:
+    for ver_file in (ROOT_DIR / "VERSION", STATE_DIR / "version"):
+        if ver_file.exists():
+            try:
+                return ver_file.read_text(encoding="utf-8").strip()
+            except OSError:
+                pass
+    return "1.0.0"
+
+
+def pause_prompt(prompt: str | None = None) -> None:
+    prompt = prompt or T("Press Enter to return...", "按 Enter 键返回...")
+    try:
+        input(f"\n{style.DIM}{prompt}{style.RESET}")
+    except (KeyboardInterrupt, EOFError):
+        pass
+
+
+def handle_show_last() -> None:
+    print(f"\n{style.BOLD}{T('📊 Latest task telemetry summary:', '📊 最新任务遥测摘要:')}{style.RESET}")
+    ret = telemetry.show_last(as_json=False)
+    if ret == 0:
+        pause_prompt()
+
+
+def select_project_interactive(
+    title: str | None = None,
+    allow_all: bool = True,
+    all_label: str | None = None,
+    limit: int = 10,
+) -> str | None | False:
+    title = title or T("Select a project to analyze", "请选择要统计的项目")
+    all_label = all_label or T("All projects (full statistics)", "全部项目 (全量统计)")
+    try:
+        all_stats = telemetry.aggregate_project_stats(days=30)
+    except Exception:
+        all_stats = {}
+
+    projects = all_stats.get("projects") or {}
+    total_count = len(projects)
+    sorted_projs = sorted(
+        projects.items(),
+        key=lambda item: (item[1].get("tokens", 0), item[1].get("runs", 0)),
+        reverse=True,
+    )
+    if limit and len(sorted_projs) > limit:
+        sorted_projs = sorted_projs[:limit]
+
+    if not sorted_projs:
+        print(f"\n{style.DIM}{T('📁 No project history yet', '📁 暂无历史项目记录')}{style.RESET}")
+        try:
+            prompt = T("Enter project name (Enter for all): ", "请输入项目名称 (直接回车统计全量): ")
+            p_in = input(f"{style.CYAN}{prompt}{style.RESET}").strip()
+            return p_in if p_in else None
+        except (KeyboardInterrupt, EOFError):
+            return False
+
+    title_suffix = T(f" (top {len(sorted_projs)})", f" (前 {len(sorted_projs)} 个)") if total_count > len(sorted_projs) else ""
+    print(f"\n{style.BOLD}📁 {title}{title_suffix}:{style.RESET}")
+    if allow_all:
+        default = T("(Enter by default)", "(直接回车默认)")
+        print(f"  [{style.CYAN}0{style.RESET}] 🌐 {all_label} {style.DIM}{default}{style.RESET}")
+    for idx, (p_name, p_info) in enumerate(sorted_projs, 1):
+        runs_cnt = p_info.get("runs", 0)
+        tok_cnt = telemetry.fmt_tokens(p_info.get("tokens", 0)) or "0"
+        unit = T("tasks", "个任务")
+        print(f"  [{style.CYAN}{idx}{style.RESET}] {p_name} {style.DIM}({runs_cnt} {unit} · {tok_cnt} tokens){style.RESET}")
+    if total_count > len(sorted_projs):
+        text = T(f"✍️  Enter another project name ({total_count} total)", f"✍️  手动输入其他项目名称 (共 {total_count} 个项目)")
+    else:
+        text = T("✍️  Enter project name manually", "✍️  手动输入项目名称")
+    print(f"  [{style.CYAN}m{style.RESET}] {text}")
+    print(f"  [{style.CYAN}q{style.RESET}] 🔙 {T('Back', '返回')}")
+
+    try:
+        prompt_hint = f"0-{len(sorted_projs)}/m/q" if allow_all else f"1-{len(sorted_projs)}/m/q"
+        choice = input(f"\n{style.CYAN}{T('Select', '请选择')} [{prompt_hint}]: {style.RESET}").strip()
+    except (KeyboardInterrupt, EOFError):
+        return False
+
+    if choice == "":
+        return None if allow_all else False
+    if choice.lower() in ("0", "all") and allow_all:
+        return None
+    if choice.lower() in ("q", "back", "exit"):
+        return False
+    if choice.lower() in ("m", "manual"):
+        try:
+            prompt = T("Enter project name (Enter for all): ", "请输入项目名称 (直接回车为全量): ")
+            p_in = input(f"{style.CYAN}{prompt}{style.RESET}").strip()
+            return p_in if p_in else None
+        except (KeyboardInterrupt, EOFError):
+            return False
+    if choice.isdigit():
+        idx = int(choice)
+        if idx == 0 and allow_all:
+            return None
+        if 1 <= idx <= len(sorted_projs):
+            return sorted_projs[idx - 1][0]
+        print(f"{style.RED}❌ {T(f'Index out of range [1-{len(sorted_projs)}]', f'序号超出范围 [1-{len(sorted_projs)}]')}{style.RESET}")
+        pause_prompt()
+        return False
+    return choice
+
+
+def handle_show_history() -> None:
+    limit = 10
+    project: str | None = None
+    today = False
+    while True:
+        runs = telemetry.list_runs(limit=limit, project=project, today=today)
+        print(telemetry.render_run_list(runs, project=project, today=today))
+        print(f"{style.BOLD}{T('Quick actions:', '快捷操作:')}{style.RESET}")
+        if runs:
+            print(f"  [{style.CYAN}1-{len(runs)}{style.RESET}] {T('View task card details', '查看对应序号的任务卡片详情')}")
+        current_project = project or T("All", "全部")
+        print(f"  [{style.CYAN}p{style.RESET}] {T('Filter by project', '按项目名称过滤')} ({T('current', '当前')}: {current_project})")
+        print(f"  [{style.CYAN}t{style.RESET}] {T('Toggle today only', '切换仅看今天')} ({T('current', '当前')}: {T('yes', '是') if today else T('no', '否')})")
+        print(f"  [{style.CYAN}s{style.RESET}] {T('Project aggregate stats', '查看项目聚合统计')} (Stats)")
+        print(f"  [{style.CYAN}x{style.RESET}] {T('Repair history telemetry', '回填修复历史遥测')} (Repair)")
+        print(f"  [{style.CYAN}r{style.RESET}] {T('Refresh', '刷新列表')}")
+        print(f"  [{style.CYAN}0{style.RESET}] {T('Back to main menu', '返回主菜单')}")
+        try:
+            choice = input(f"\n{style.CYAN}{T('Enter option', '请输入选项')}: {style.RESET}").strip()
+        except (KeyboardInterrupt, EOFError):
+            break
+        if choice in ("0", "q", "exit", "back"):
+            break
+        if choice == "r":
+            continue
+        if choice.lower() in ("x", "repair"):
+            handle_repair_history()
+            continue
+        if choice == "t":
+            today = not today
+            continue
+        if choice == "p":
+            selected = select_project_interactive(
+                title=T("Select a project to filter", "请选择要过滤的项目"),
+                allow_all=True,
+                all_label=T("All projects (clear filter)", "全部项目 (清除过滤)"),
+            )
+            if selected is not False:
+                project = selected
+            continue
+        if choice == "s":
+            handle_show_stats(project)
+            continue
+        if choice.isdigit():
+            idx = int(choice)
+            if 1 <= idx <= len(runs):
+                selected = runs[idx - 1]
+                telemetry.enrich_run_metadata(selected)
+                print(telemetry.render_summary(selected))
+                pause_prompt(T("Press Enter to return to history...", "按 Enter 键返回历史列表..."))
+            else:
+                print(f"{style.RED}❌ {T(f'Index out of range [1-{len(runs)}]', f'序号超出范围 [1-{len(runs)}]')}{style.RESET}")
+                pause_prompt()
+        else:
+            print(f"{style.RED}❌ {T('Invalid option', '无效选项')}: {choice}{style.RESET}")
+
+
+def handle_show_stats(default_project: str | None = None) -> None:
+    target_project = default_project
+    if target_project is None:
+        selected = select_project_interactive()
+        if selected is False:
+            return
+        target_project = selected
+    stats = telemetry.aggregate_project_stats(project=target_project, days=30)
+    print(telemetry.render_project_stats(stats))
+    pause_prompt()
+
+
+def handle_show_status() -> None:
+    print(f"\n{style.BOLD}{T('🎯 Effective FlowPilot policy:', '🎯 当前 FlowPilot 策略状态:')}{style.RESET}\n")
+    if os.name != "nt":
+        bin_script = ROOT_DIR / "bin" / "codex-flow"
+        subprocess.run(["bash", str(bin_script), "status"] if bin_script.exists() else ["codex-flow", "status"])
+    else:
+        subprocess.run(["codex-flow.cmd", "status"], shell=True)
+    pause_prompt()
+
+
+def handle_run_doctor() -> None:
+    print(f"\n{style.BOLD}{T('🩺 Running diagnostics...', '🩺 正在运行系统诊断检查...')}{style.RESET}\n")
+    if os.name != "nt":
+        doc_script = ROOT_DIR / "scripts" / "doctor"
+        subprocess.run(["bash", str(doc_script)] if doc_script.exists() else ["codex-flow", "doctor"])
+    else:
+        subprocess.run(["codex-flow.cmd", "doctor"], shell=True)
+    pause_prompt()
+
+
+def handle_run_benchmark() -> None:
+    print(f"\n{style.BOLD}{T('⚡ Local quick benchmark:', '⚡ 本地快速 Benchmark 评测:')}{style.RESET}")
+    print(style.DIM + T(
+        "Runs 6 representative tasks with the locally authenticated Codex to evaluate routing and model behavior.",
+        "将调用本地登录的 Codex 执行 6 个典型任务以测量当前模型与编排效果。",
+    ) + style.RESET)
+    try:
+        confirm = input(f"{style.YELLOW}{T('Start now? [y/N]: ', '确定开始执行吗？[y/N]: ')}{style.RESET}").strip().lower()
+    except (KeyboardInterrupt, EOFError):
+        return
+    if confirm in ("y", "yes", "是"):
+        bench_script = ROOT_DIR / "scripts" / "benchmark-local.py"
+        subprocess.run([sys.executable, str(bench_script), "quick"] if bench_script.exists() else ["codex-flow", "benchmark-local", "quick"])
+        pause_prompt()
+
+
+def handle_update() -> None:
+    print(f"\n{style.BOLD}{T('🔄 Checking for codex-flow updates...', '🔄 正在检查并更新 codex-flow...')}{style.RESET}\n")
+    if os.name != "nt":
+        bin_script = ROOT_DIR / "bin" / "codex-flow"
+        subprocess.run(["bash", str(bin_script), "update"] if bin_script.exists() else ["codex-flow", "update"])
+    else:
+        subprocess.run(["codex-flow.cmd", "update"], shell=True)
+    pause_prompt()
+
+
+def get_source_dir() -> Path:
+    source_file = STATE_DIR / "source"
+    if source_file.exists():
+        try:
+            p = Path(source_file.read_text(encoding="utf-8").strip())
+            if p.exists():
+                return p
+        except OSError:
+            pass
+    return ROOT_DIR
+
+
+def get_overlay_bin() -> Path | None:
+    src = get_source_dir()
+    candidates = [
+        STATE_DIR / "bin" / "FlowPilot",
+        STATE_DIR / "bin" / "codex-flow-overlay",
+        src / "apps" / "macos-overlay" / "bin" / "FlowPilot",
+        src / "apps" / "macos-overlay" / "bin" / "codex-flow-overlay",
+    ]
+    return next((c for c in candidates if c.exists() and os.access(str(c), os.X_OK)), None)
+
+
+def launch_overlay_daemon(overlay_bin: Path) -> None:
+    kwargs = {
+        "stdin": subprocess.DEVNULL,
+        "stdout": subprocess.DEVNULL,
+        "stderr": subprocess.DEVNULL,
+    }
+    if sys.platform != "win32":
+        kwargs["start_new_session"] = True
+    subprocess.Popen([str(overlay_bin), "start"], **kwargs)
+
+
+def run_overlay_build() -> bool:
+    src = get_source_dir()
+    build_script = src / "apps" / "macos-overlay" / "build.sh"
+    if not build_script.exists():
+        print(f"\n{style.RED}❌ {T('Build script not found', '未找到构建脚本')}: {build_script}{style.RESET}")
+        return False
+    print(f"\n{style.BOLD}{T('🔨 Building FlowPilot native macOS overlay...', '🔨 正在编译 FlowPilot macOS 原生悬浮窗...')}{style.RESET}")
+    print(f"{style.DIM}{T('(Native SwiftUI compilation, typically takes ~30-50s)', '(基于 SwiftUI 原生编译，通常耗时约 30-50 秒)')}{style.RESET}\n")
+    try:
+        res = subprocess.run(["bash", str(build_script)])
+        return res.returncode == 0
+    except Exception as exc:
+        print(f"{style.RED}❌ {T('Build execution error', '执行构建失败')}: {exc}{style.RESET}")
+        return False
+
+
+def run_showcase_generation() -> bool:
+    src = get_source_dir()
+    sources_dir = src / "apps" / "macos-overlay" / "Sources"
+    showcase_script = src / "scripts" / "generate_showcase.swift"
+    output_bin = src / "bin" / "generate_showcase"
+
+    if not sources_dir.exists():
+        print(f"\n{style.RED}❌ {T('Overlay source directory not found', '未找到浮窗源码目录')}: {sources_dir}{style.RESET}")
+        return False
+    if not showcase_script.exists():
+        print(f"\n{style.RED}❌ {T('Showcase generator not found', '未找到 Showcase 生成脚本')}: {showcase_script}{style.RESET}")
+        return False
+
+    swift_files = sorted(
+        p for p in sources_dir.rglob("*.swift")
+        if p.name != "main.swift"
+    )
+    if not swift_files:
+        print(f"\n{style.RED}❌ {T('No Swift source files found for showcase generation.', '未找到可用于生成 Showcase 的 Swift 源码。')}{style.RESET}")
+        return False
+
+    output_bin.parent.mkdir(parents=True, exist_ok=True)
+    compile_cmd = [
+        "swiftc",
+        "-framework", "Cocoa",
+        "-framework", "SwiftUI",
+        "-framework", "Combine",
+        *[str(path) for path in swift_files],
+        str(showcase_script),
+        "-o", str(output_bin),
+    ]
+
+    print(f"\n{style.BOLD}{T('🖼 Rebuilding showcase and promotional images...', '🖼 正在重新生成 Showcase / 宣传图...')}{style.RESET}")
+    print(f"{style.DIM}{T('Compiling the native SwiftUI showcase renderer first.', '先编译原生 SwiftUI Showcase 渲染器。')}{style.RESET}\n")
+    try:
+        compile_res = subprocess.run(compile_cmd, cwd=src)
+        if compile_res.returncode != 0:
+            print(f"\n{style.RED}❌ {T('Showcase renderer build failed. Please check the logs above.', 'Showcase 渲染器编译失败，请检查上方日志。')}{style.RESET}")
+            return False
+
+        generate_res = subprocess.run([str(output_bin)], cwd=src)
+        if generate_res.returncode != 0:
+            print(f"\n{style.RED}❌ {T('Showcase generation failed. Please check the logs above.', 'Showcase 图片生成失败，请检查上方日志。')}{style.RESET}")
+            return False
+    except FileNotFoundError as exc:
+        print(f"\n{style.RED}❌ {T('Required command not found', '缺少必要命令')}: {exc}{style.RESET}")
+        return False
+    except Exception as exc:
+        print(f"\n{style.RED}❌ {T('Showcase generation error', '执行 Showcase 生成失败')}: {exc}{style.RESET}")
+        return False
+
+    print(f"\n{style.GREEN}✨ {T('Showcase generation completed.', 'Showcase / 宣传图生成完成。')}{style.RESET}")
+    print(f"{style.DIM}{T('Updated:', '已更新:')} docs/assets/screenshots/ · docs/assets/promo/{style.RESET}")
+    return True
+
+
+def handle_generate_showcase() -> None:
+    run_showcase_generation()
+    pause_prompt()
+
+
+def handle_manage_overlay() -> None:
+    if sys.platform != "darwin":
+        print(f"\n{style.YELLOW}⚠️ {T('The native FlowPilot floating window is available only on macOS.', 'FlowPilot 原生悬浮窗仅支持 macOS 系统。')}{style.RESET}")
+        pause_prompt()
+        return
+
+    while True:
+        overlay_bin = get_overlay_bin()
+        has_bin = overlay_bin is not None and overlay_bin.exists() and os.access(str(overlay_bin), os.X_OK)
+
+        is_running = False
+        if has_bin:
+            try:
+                status_res = subprocess.run([str(overlay_bin), "status"], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
+                is_running = status_res.returncode == 0
+            except Exception:
+                is_running = False
+
+        print(f"\n{style.BOLD}🪟 {T('macOS Native Floating Widget:', 'macOS 原生悬浮窗管理 (Native Floating Widget):')}{style.RESET}")
+        if not has_bin:
+            print(f"  {T('Status', '当前状态')}: {style.YELLOW}⚠️ {T('Not built yet (binary not found)', '尚未编译构建 (未找到可执行文件)')}{style.RESET}")
+        elif is_running:
+            print(f"  {T('Status', '当前状态')}: {style.GREEN}● {T('running (hover 0.4s to expand Summary)', '正在运行 (Hover 0.4s 展开 Summary)')}{style.RESET}")
+        else:
+            print(f"  {T('Status', '当前状态')}: {style.DIM}○ {T('stopped (ready to start)', '未运行 (就绪)')}{style.RESET}")
+
+        print(f"\n  [{style.CYAN}1{style.RESET}] {T('⏹ Stop widget', '⏹ 停止浮窗') if is_running else T('🚀 Start widget', '🚀 启动浮窗')}")
+        if is_running:
+            print(f"  [{style.CYAN}2{style.RESET}] {T('🔨 Rebuild and restart widget', '🔨 重新编译并重启浮窗')}")
+        else:
+            print(f"  [{style.CYAN}2{style.RESET}] {T('🔨 Build and start widget', '🔨 编译并启动浮窗')}")
+        print(f"  [{style.CYAN}3{style.RESET}] {T('📦 Build widget only', '📦 编译浮窗 (仅编译构建)')}")
+
+        if is_running:
+            print(f"  [{style.CYAN}4{style.RESET}] {T('🔄 Toggle expanded / collapsed', '🔄 切换展开 / 折叠 (Toggle)')}")
+            print(f"  [{style.CYAN}5{style.RESET}] {T('⚡ Push latest data and expand', '⚡️ 发送最新数据并展开 (Push Last Summary)')}")
+
+        print(f"  [{style.CYAN}0{style.RESET}] 🔙 {T('Back to main menu', '返回主菜单')}\n")
+
+        try:
+            choice = input(f"{style.CYAN}{T('Select action', '请选择操作')}: {style.RESET}").strip()
+        except (KeyboardInterrupt, EOFError):
+            break
+
+        if choice in ("0", "q", "exit", "back"):
+            break
+
+        if choice == "1":
+            if is_running:
+                try:
+                    subprocess.run([str(overlay_bin), "stop"], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+                    subprocess.run(["pkill", "-f", "FlowPilot.*start|codex-flow-overlay.*start|bin/FlowPilot"], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+                except Exception:
+                    pass
+                print(f"{style.YELLOW}{T('Widget stopped.', '浮窗已停止。')}{style.RESET}")
+                pause_prompt()
+            else:
+                if not has_bin:
+                    print(f"\n{style.YELLOW}💡 {T('The floating window has not been built yet.', 'FlowPilot 原生悬浮窗尚未编译。')}{style.RESET}")
+                    try:
+                        ask_build = input(f"{style.CYAN}{T('Would you like to build and start it now? [Y/n]: ', '是否立即编译并启动浮窗？[Y/n]: ')}{style.RESET}").strip().lower()
+                    except (KeyboardInterrupt, EOFError):
+                        ask_build = "n"
+                    if ask_build in ("", "y", "yes", "是"):
+                        if run_overlay_build():
+                            overlay_bin = get_overlay_bin()
+                            if overlay_bin and overlay_bin.exists():
+                                launch_overlay_daemon(overlay_bin)
+                                print(f"{style.GREEN}{T('Widget started. It appears near the top-right and expands after a 0.4s hover.', '浮窗已启动！默认在屏幕右上角圆形悬浮，光标停留 0.4 秒展开。')}{style.RESET}")
+                            else:
+                                print(f"{style.RED}{T('Binary not found after build.', '编译成功但未找到可执行文件。')}{style.RESET}")
+                        else:
+                            print(f"{style.RED}{T('Build failed. Please check the logs above.', '编译失败，请检查上方构建日志。')}{style.RESET}")
+                    pause_prompt()
+                else:
+                    try:
+                        launch_overlay_daemon(overlay_bin)
+                        print(f"{style.GREEN}{T('Widget started. It appears near the top-right and expands after a 0.4s hover.', '浮窗已启动！默认在屏幕右上角圆形悬浮，光标停留 0.4 秒展开。')}{style.RESET}")
+                    except Exception as exc:
+                        print(f"{style.RED}{T('Start failed', '启动失败')}: {exc}{style.RESET}")
+                    pause_prompt()
+
+        elif choice == "2":
+            if is_running and overlay_bin:
+                try:
+                    subprocess.run([str(overlay_bin), "stop"], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+                    subprocess.run(["pkill", "-f", "FlowPilot.*start|codex-flow-overlay.*start|bin/FlowPilot"], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+                except Exception:
+                    pass
+            if run_overlay_build():
+                overlay_bin = get_overlay_bin()
+                if overlay_bin and overlay_bin.exists():
+                    try:
+                        launch_overlay_daemon(overlay_bin)
+                        print(f"\n{style.GREEN}✨ {T('Build succeeded and widget started! It appears near the top-right.', '✨ 编译完成并已成功启动浮窗！默认在屏幕右上角圆形悬浮，光标停留 0.4 秒展开。')}{style.RESET}")
+                    except Exception as exc:
+                        print(f"\n{style.RED}{T('Start failed', '启动失败')}: {exc}{style.RESET}")
+                else:
+                    print(f"\n{style.RED}{T('Binary not found after build.', '编译成功但未找到可执行文件。')}{style.RESET}")
+            else:
+                print(f"\n{style.RED}{T('Build failed. Please check the logs above.', '编译失败，请检查上方构建日志。')}{style.RESET}")
+            pause_prompt()
+
+        elif choice == "3":
+            if is_running and overlay_bin:
+                print(f"{style.DIM}{T('Stopping running widget before rebuild...', '重新编译前正在停止运行中的浮窗...')}{style.RESET}")
+                try:
+                    subprocess.run([str(overlay_bin), "stop"], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+                    subprocess.run(["pkill", "-f", "FlowPilot.*start|codex-flow-overlay.*start|bin/FlowPilot"], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+                except Exception:
+                    pass
+            if run_overlay_build():
+                print(f"\n{style.GREEN}✨ {T('Widget build succeeded! You can now select [1] to start it.', '✨ 浮窗编译构建成功！可选择 [1] 启动浮窗。')}{style.RESET}")
+            else:
+                print(f"\n{style.RED}❌ {T('Build failed. Please check the logs above.', '编译失败，请检查上方构建日志。')}{style.RESET}")
+            pause_prompt()
+
+        elif choice == "4" and is_running:
+            try:
+                subprocess.run([str(overlay_bin), "toggle"], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+            except Exception:
+                pass
+
+        elif choice == "5" and is_running:
+            try:
+                subprocess.run([str(overlay_bin), "update"], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+                print(f"{style.GREEN}{T('Latest Summary pushed and expanded.', '已向浮窗推送最新 Summary 并展开。')}{style.RESET}")
+            except Exception as exc:
+                print(f"{style.RED}{T('Push failed', '推送失败')}: {exc}{style.RESET}")
+            pause_prompt()
+
+        else:
+            print(f"{style.RED}❌ {T('Invalid option', '无效选项')}{style.RESET}")
+            pause_prompt()
+
+
+def handle_repair_history() -> None:
+    print(f"\n{style.BOLD}🛠️  {T('Telemetry History Repair & Backfill', '历史遥测数据修复与回填')}:{style.RESET}")
+    print(f"  [{style.CYAN}1{style.RESET}] 🔍 {T('Dry-Run (scan and stats without modifying files)', '演练模式 (仅扫描统计，不修改任何文件)')}")
+    print(f"  [{style.CYAN}2{style.RESET}] ✍️  {T('Repair (backfill missing fields and write atomically)', '正式回填 (补齐缺失字段并原子写入)')}")
+    print(f"  [{style.CYAN}0{style.RESET}] 🔙 {T('Back to main menu', '返回主菜单')}")
+    try:
+        choice = input(f"\n{style.CYAN}{T('Select mode [1-2/0]', '请选择模式 [1-2/0]')}: {style.RESET}").strip()
+    except (KeyboardInterrupt, EOFError):
+        return
+    if choice in ("0", "q", "exit", "back", ""):
+        return
+    if choice == "1":
+        print()
+        telemetry.repair_history(dry_run=True, verbose=True)
+        pause_prompt()
+    elif choice == "2":
+        print()
+        telemetry.repair_history(dry_run=False, verbose=True)
+        pause_prompt()
+    else:
+        print(f"{style.RED}❌ {T('Invalid option', '无效选项')}{style.RESET}")
+        pause_prompt()
+
+
+def main_menu() -> int:
+    version = get_version()
+    while True:
+        print_banner(version)
+        update_state = cached_update_status(trigger_background=True)
+        update_label = updater_menu_label(LANG, update_state)
+        items = [
+            ("1", T("🪟 macOS native floating widget", "🪟 macOS 原生悬浮窗"), "overlay widget"),
+            ("2", T("📊 Latest task card", "📊 查看最新任务卡片"), "usage last"),
+            ("3", T("📜 Task history", "📜 浏览历史任务列表"), "usage list"),
+            ("4", T("📈 Project aggregate statistics", "📈 项目聚合统计分析"), "usage stats"),
+            ("5", T("🎯 Effective policy", "🎯 查看生效策略配置"), "status"),
+            ("6", T("🩺 Diagnostics", "🩺 运行系统诊断检查"), "doctor"),
+            ("7", T("⚡ Local quick Benchmark", "⚡ 本地快速 Benchmark"), "benchmark-local quick"),
+            ("8", update_label, "update"),
+            ("9", T("🛠️ Repair telemetry history", "🛠️ 修复历史遥测数据"), "telemetry repair"),
+            ("10", T("🖼 Regenerate Showcase / promotional images", "🖼 重新生成 Showcase / 宣传图"), "showcase"),
+        ]
+        for key, label, command in items:
+            print(f"  [{style.CYAN}{key}{style.RESET}] {label} {style.DIM}({command}){style.RESET}")
+        print(f"  [{style.CYAN}0{style.RESET}] 🚪 {T('Exit', '退出')}\n")
+        try:
+            choice = input(f"{style.CYAN}{T('Enter option [0-10]', '请输入选项 [0-10]')}: {style.RESET}").strip()
+        except (KeyboardInterrupt, EOFError):
+            print("\n" + T("👋 Exited codex-flow console.", "👋 已退出 codex-flow 控制台。"))
+            return 0
+        if choice in ("0", "q", "exit"):
+            print(T("👋 Exited codex-flow console.", "👋 已退出 codex-flow 控制台。"))
+            return 0
+        handlers = {
+            "1": handle_manage_overlay,
+            "2": handle_show_last,
+            "3": handle_show_history,
+            "4": handle_show_stats,
+            "5": handle_show_status,
+            "6": handle_run_doctor,
+            "7": handle_run_benchmark,
+            "8": handle_update,
+            "9": handle_repair_history,
+            "10": handle_generate_showcase,
+        }
+        handler = handlers.get(choice)
+        if handler:
+            handler()
+        else:
+            print(f"{style.RED}❌ {T('Invalid option; enter 0-10', '无效选项，请输入 0-10')}{style.RESET}")
+            pause_prompt()
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main_menu())