vibego 0.2.52__py3-none-any.whl → 1.0.0__py3-none-any.whl

vibego_cli/main.py

@@ -1,4 +1,4 @@
-"""vibego 命令入口与子命令实现。"""
+"""Entry point and subcommand implementations for the vibego CLI."""
 
 from __future__ import annotations
 
@@ -27,32 +27,32 @@ BOTFATHER_URL = "https://core.telegram.org/bots#botfather"
 
 
 def _find_repo_root() -> Path:
-    """推导当前仓库根目录。"""
+    """Determine the current repository root."""
 
     return config.PACKAGE_ROOT
 
 
 def _prompt_token(default: Optional[str] = None) -> str:
-    """交互式获取 Telegram Bot Token。"""
+    """Interactively read the Telegram Bot token from stdin."""
 
-    prompt = "请输入 Master Bot 的 Token"
+    prompt = "Enter the Master Bot token"
     if default:
-        prompt += f"（直接回车沿用当前值）"
-    prompt += "："
+        prompt += " (press Enter to keep the existing value)"
+    prompt += ": "
     while True:
         value = input(prompt).strip()
         if not value and default:
             value = default
         if not value:
-            print("Token 不能为空。若尚未创建 Bot，请参考官方指引：", BOTFATHER_URL)
+            print("Token cannot be empty. Follow the official guide if you need to create a bot:", BOTFATHER_URL)
             continue
         if TOKEN_PATTERN.match(value):
             return value
-        print("Token 格式看起来不正确，请确认后重试。官方获取方式：", BOTFATHER_URL)
+        print("The token format looks invalid. Please verify and retry. Official instructions:", BOTFATHER_URL)
 
 
 def _ensure_projects_assets() -> None:
-    """保证 projects.json 与 master.db 均已初始化。"""
+    """Ensure ``projects.json`` and ``master.db`` exist and are initialised."""
 
     config.ensure_directories()
     if not config.PROJECTS_JSON.exists():
@@ -61,7 +61,7 @@ def _ensure_projects_assets() -> None:
 
 
 def _virtualenv_paths(venv_dir: Path) -> Tuple[Path, Path]:
-    """返回虚拟环境的 python 与 pip 路径。"""
+    """Return the Python and pip executables inside the virtual environment."""
 
     if os.name == "nt":
         bin_dir = venv_dir / "Scripts"
@@ -71,46 +71,46 @@ def _virtualenv_paths(venv_dir: Path) -> Tuple[Path, Path]:
 
 
 def _ensure_virtualenv(repo_root: Path) -> Tuple[Path, Path]:
-    """在 runtime 目录中创建/升级虚拟环境并安装依赖。"""
+    """Create or upgrade the runtime virtual environment and install dependencies."""
 
     venv_dir = config.RUNTIME_DIR / "venv"
     python_exec, pip_exec = _virtualenv_paths(venv_dir)
     if not venv_dir.exists():
-        print("正在创建虚拟环境:", venv_dir)
+        print("Creating virtual environment:", venv_dir)
         subprocess.run([sys.executable, "-m", "venv", str(venv_dir)], check=True)
     if not python_exec.exists():
-        raise RuntimeError(f"未找到虚拟环境 python: {python_exec}")
+        raise RuntimeError(f"Virtual environment Python not found: {python_exec}")
     if not pip_exec.exists():
-        raise RuntimeError(f"未找到虚拟环境 pip: {pip_exec}")
+        raise RuntimeError(f"Virtual environment pip not found: {pip_exec}")
 
     marker = venv_dir / ".requirements.timestamp"
     req_file = config.ensure_worker_requirements_copy()
     if not marker.exists() or req_file.stat().st_mtime > marker.stat().st_mtime:
-        print("正在安装 Python 依赖（该步骤可能耗时）...")
+        print("Installing Python dependencies (this may take a while)...")
         install_requirements(req_file, pip_executable=pip_exec)
         marker.touch()
     return python_exec, pip_exec
 
 
 def command_init(args: argparse.Namespace) -> None:
-    """实现 `vibego init`。"""
+    """Implementation of ``vibego init``."""
 
     config.ensure_directories()
     env_values = config.parse_env_file(config.ENV_FILE)
 
     if not python_version_ok():
-        print("警告：当前 Python 版本低于 3.11，建议升级以获得完整功能。")
+        print("Warning: running on Python earlier than 3.11; upgrade for full functionality.")
 
     missing = check_cli_dependencies()
     if missing:
-        print("依赖检查发现缺失项：")
+        print("Missing dependencies detected:")
         for item in missing:
             print("-", item)
-        print("请先安装上述依赖后再执行初始化。")
+        print("Install the listed dependencies and rerun the command.")
         return
 
     if config.ENV_FILE.exists() and not args.force:
-        print("检测到已存在的 .env。若需覆盖请使用 --force。")
+        print(".env already exists. Use --force to overwrite.")
     default_token = env_values.get("MASTER_BOT_TOKEN")
     token = args.token or _prompt_token(default_token)
     env_values["MASTER_BOT_TOKEN"] = token
@@ -122,25 +122,25 @@ def command_init(args: argparse.Namespace) -> None:
     config.dump_env_file(config.ENV_FILE, env_values)
     _ensure_projects_assets()
 
-    print("初始化完成，配置目录：", config.CONFIG_ROOT)
-    print("可执行步骤：")
-    print(f"  1. 如需代理，请编辑 {config.ENV_FILE} 调整相关变量。")
-    print("  2. 运行 `vibego start` 启动 master 服务。")
+    print("Initialisation complete. Configuration directory:", config.CONFIG_ROOT)
+    print("Next steps:")
+    print(f"  1. Edit {config.ENV_FILE} to configure proxy settings if needed.")
+    print("  2. Run `vibego start` to launch the master service.")
 
 
 def _load_env_or_fail() -> Dict[str, str]:
-    """读取 .env，若不存在则提示用户执行 init。"""
+    """Read ``.env`` and raise when initialisation has not been performed."""
 
     if not config.ENV_FILE.exists():
-        raise RuntimeError(f"未检测到 {config.ENV_FILE}，请先执行 `vibego init`。")
+        raise RuntimeError(f"{config.ENV_FILE} not found. Please run `vibego init` first.")
     values = config.parse_env_file(config.ENV_FILE)
     if "MASTER_BOT_TOKEN" not in values or not values["MASTER_BOT_TOKEN"].strip():
-        raise RuntimeError("MASTER_BOT_TOKEN 未定义，请重新执行 `vibego init`。")
+        raise RuntimeError("MASTER_BOT_TOKEN is missing. Rerun `vibego init`.")
     return values
 
 
 def _build_master_env(base_env: Dict[str, str]) -> Dict[str, str]:
-    """组装 master.py 所需的环境变量。"""
+    """Construct the environment variables required by ``master.py``."""
 
     env = os.environ.copy()
     env.update(base_env)
@@ -164,13 +164,13 @@ def _build_master_env(base_env: Dict[str, str]) -> Dict[str, str]:
 
 
 def _write_pid(pid: int) -> None:
-    """记录 master 进程 PID。"""
+    """Persist the master process PID."""
 
     config.MASTER_PID_FILE.write_text(str(pid), encoding="utf-8")
 
 
 def _read_pid() -> Optional[int]:
-    """读取 master 进程 PID。"""
+    """Return the persisted master PID if present."""
 
     if not config.MASTER_PID_FILE.exists():
         return None
@@ -179,40 +179,40 @@ def _read_pid() -> Optional[int]:
 
 
 def command_start(args: argparse.Namespace) -> None:
-    """实现 `vibego start`。"""
+    """Implementation of ``vibego start``."""
 
     env_values = _load_env_or_fail()
     _ensure_projects_assets()
 
     if not python_version_ok():
         raise RuntimeError(
-            "当前 Python 版本为 3.11 以下，无法运行 master。"
-            "请通过 `brew install python@3.11` 或其他方式升级后重试。"
+            "Python earlier than 3.11 cannot run the master. "
+            "Upgrade via `brew install python@3.11` or another method."
         )
 
     missing = check_cli_dependencies()
     if missing:
-        print("依赖检查发现缺失项：")
+        print("Missing dependencies detected:")
         for item in missing:
             print("-", item)
-        print("请补充依赖后重新执行。")
+        print("Install the listed dependencies before retrying.")
         return
 
     repo_root = _find_repo_root()
     try:
         python_exec, _ = _ensure_virtualenv(repo_root)
     except subprocess.CalledProcessError as exc:
-        raise RuntimeError(f"虚拟环境初始化失败：{exc}") from exc
+        raise RuntimeError(f"Virtual environment initialisation failed: {exc}") from exc
 
     master_env = _build_master_env(env_values)
     log_file = config.LOG_FILE
     log_file.parent.mkdir(parents=True, exist_ok=True)
 
     if _read_pid():
-        print("检测到 master 已启动，如需重启请先执行 `vibego stop`。")
+        print("Master already running. Execute `vibego stop` before restarting.")
         return
 
-    print("正在启动 master 服务...")
+    print("Starting master service...")
     with open(log_file, "a", encoding="utf-8") as log_fp:
         process = subprocess.Popen(
             [str(python_exec), "master.py"],
@@ -226,26 +226,26 @@ def command_start(args: argparse.Namespace) -> None:
 
     time.sleep(2)
     if process.poll() is not None:
-        raise RuntimeError("master 进程启动失败，请检查日志。")
+        raise RuntimeError("Master process failed to start. Check the logs.")
 
-    print("master 已启动，PID:", process.pid)
-    print("日志文件：", log_file)
-    print("请在 Telegram 中向 Bot 发送 /start 以完成授权流程。")
+    print("Master started. PID:", process.pid)
+    print("Log file:", log_file)
+    print("Send /start to the bot in Telegram to complete authorisation.")
 
 
 def command_stop(args: argparse.Namespace) -> None:
-    """实现 `vibego stop`。"""
+    """Implementation of ``vibego stop``."""
 
     pid = _read_pid()
     if not pid:
-        print("未检测到正在运行的 master。")
+        print("Master process not detected.")
         return
 
-    print("正在停止 master（PID =", pid, ")...")
+    print("Stopping master (PID =", pid, ")...")
     try:
         os.kill(pid, signal.SIGTERM)
     except ProcessLookupError:
-        print("进程不存在，视为已停止。")
+        print("Process not found; treating as already stopped.")
     else:
         for _ in range(20):
             time.sleep(0.5)
@@ -254,13 +254,13 @@ def command_stop(args: argparse.Namespace) -> None:
             except ProcessLookupError:
                 break
         else:
-            print("master 未在预期时间内退出，如仍存在请手动检查。")
+            print("Master did not exit within the expected time. Please investigate manually.")
     config.MASTER_PID_FILE.unlink(missing_ok=True)
-    print("停止完成。")
+    print("Stop completed.")
 
 
 def command_status(args: argparse.Namespace) -> None:
-    """实现 `vibego status`。"""
+    """Implementation of ``vibego status``."""
 
     env_values = config.parse_env_file(config.ENV_FILE)
     pid = _read_pid()
@@ -289,7 +289,7 @@ def command_status(args: argparse.Namespace) -> None:
 
 
 def command_doctor(args: argparse.Namespace) -> None:
-    """实现 `vibego doctor`，输出自检结果。"""
+    """Implementation of ``vibego doctor``. Outputs a diagnostic report."""
 
     report = {
         "python_version": sys.version,
@@ -305,44 +305,44 @@ def command_doctor(args: argparse.Namespace) -> None:
 
 
 def build_parser() -> argparse.ArgumentParser:
-    """构建最外层 argparse 解析器。"""
+    """Build the top-level argparse parser."""
 
-    parser = argparse.ArgumentParser(prog="vibego", description="vibego CLI 工具")
+    parser = argparse.ArgumentParser(prog="vibego", description="vibego CLI utilities")
     parser.add_argument(
         "--config-dir",
         dest="config_dir",
-        help="自定义配置目录（默认 ~/.config/vibego）",
+        help="Custom configuration directory (default ~/.config/vibego)",
     )
     subparsers = parser.add_subparsers(dest="command", required=True)
 
-    init_parser = subparsers.add_parser("init", help="初始化配置目录与 master token")
-    init_parser.add_argument("--token", help="直接传入 master bot token，避免交互输入")
-    init_parser.add_argument("--force", action="store_true", help="覆盖已有 .env 配置")
+    init_parser = subparsers.add_parser("init", help="Initialise the configuration directory and master token")
+    init_parser.add_argument("--token", help="Provide the master bot token directly to avoid interactive input")
+    init_parser.add_argument("--force", action="store_true", help="Overwrite the existing .env file")
     init_parser.set_defaults(func=command_init)
 
-    start_parser = subparsers.add_parser("start", help="启动 master 服务")
+    start_parser = subparsers.add_parser("start", help="Start the master service")
     start_parser.set_defaults(func=command_start)
 
-    stop_parser = subparsers.add_parser("stop", help="停止 master 服务")
+    stop_parser = subparsers.add_parser("stop", help="Stop the master service")
     stop_parser.set_defaults(func=command_stop)
 
-    status_parser = subparsers.add_parser("status", help="查看当前运行状态")
+    status_parser = subparsers.add_parser("status", help="Display the current running status")
     status_parser.set_defaults(func=command_status)
 
-    doctor_parser = subparsers.add_parser("doctor", help="运行依赖与配置自检")
+    doctor_parser = subparsers.add_parser("doctor", help="Run dependency and configuration diagnostics")
     doctor_parser.set_defaults(func=command_doctor)
 
     return parser
 
 
 def main(argv: Optional[Sequence[str]] = None) -> None:
-    """CLI 主入口。"""
+    """CLI main entrypoint."""
 
     parser = build_parser()
     args = parser.parse_args(argv)
     if args.config_dir:
         os.environ["VIBEGO_CONFIG_DIR"] = args.config_dir
-        # 重新加载路径设置
+        # Reload path configuration after overriding the config directory.
         from importlib import reload
 
         reload(config)
@@ -350,7 +350,7 @@ def main(argv: Optional[Sequence[str]] = None) -> None:
     try:
         args.func(args)
     except Exception as exc:  # pylint: disable=broad-except
-        print("执行失败：", exc)
+        print("Execution failed:", exc)
         sys.exit(1)
 
 

vibego-0.2.52.dist-info/METADATA

@@ -1,197 +0,0 @@
-Metadata-Version: 2.4
-Name: vibego
-Version: 0.2.52
-Summary: vibego CLI：用于初始化与管理 Telegram Master Bot 的工具
-Author: Hypha
-License-Expression: LicenseRef-Proprietary
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Operating System :: MacOS
-Classifier: Intended Audience :: Developers
-Classifier: Topic :: Software Development :: Build Tools
-Classifier: Environment :: Console
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-Requires-Dist: aiogram<4.0.0,>=3.0.0
-Requires-Dist: aiohttp-socks>=0.10.0
-Requires-Dist: aiosqlite>=0.19.0
-Requires-Dist: markdown-it-py<4.0.0,>=3.0.0
-
-# vibe-bot（Telegram → Mac CLI → Telegram 回推）
-
-## 环境依赖
-
-- 建议使用 Homebrew 安装核心命令行工具，保证脚本依赖一致：
-  ```bash
-  brew install python3 tmux codex
-  ```
-  Homebrew 官方文档说明可以通过 `brew install` 安装 Python 及 tmux，Codex CLI 官方文档同样推荐使用 Homebrew。安装完成后可执行
-  `python3 --version`、`tmux -V` 和 `codex --version` 验证环境。
-- 首次使用 Codex CLI 需通过 ChatGPT 登录：
-  ```bash
-  codex login
-  ```
-  登录成功后会在本地写入凭据（默认为 `~/.codex/auth.json`）。若需使用 API Key，可执行 `codex login --api-key <key>`。
-- 项目脚本默认调用 Homebrew 提供的 `python3`。若需要隔离依赖，建议提前创建虚拟环境：
-  ```bash
-  python3 -m venv .venv
-  source .venv/bin/activate
-  ```
-
-## 目录结构
-
-- `bot.py`：aiogram 3 worker，支持多模型会话解析（Codex / ClaudeCode / 预留 Gemini）。
-- `scripts/run_bot.sh`：一键启动脚本（自动建 venv、启动 tmux + 模型 CLI + bot）。
-- `scripts/stop_bot.sh`：终止当前项目 worker（tmux + bot 进程）。
-- `scripts/start_tmux_codex.sh`：底层 tmux/CLI 启动器，被 `run_bot.sh` 调用，默认以 `tmux -u` 强制启用 UTF-8。
-- `scripts/models/`：模型配置模块（`common.sh`/`codex.sh`/`claudecode.sh`/`gemini.sh`）。
-- `logs/<model>/<project>/`：运行日志（`run_bot.log`、`model.log`、`bot.pid`、`current_session.txt`）。
-    - `model.log` 由 `scripts/log_writer.py` 控制，单文件上限 20MB，仅保留最近 24 小时的归档（可通过 `MODEL_LOG_MAX_BYTES`、
-      `MODEL_LOG_RETENTION_SECONDS` 覆盖）。
-- `.env.example`：环境配置模板（复制为 `.env` 后按需修改）。
-
-## 快速开始
-
-建议通过 PyPI 安装的 `vibego` 命令完成初始化与启动，示例：
-
-```bash
-pipx install vibego  # 或者 pip install --user vibego
-vibego init          # 初始化配置目录并写入 Master Bot Token
-vibego start         # 启动 master 服务
-```
-
-若在本仓库内调试，可执行：
-
-1. 安装依赖：`brew install python tmux`（若需要代理，请提前配置）。
-2. 初始化配置：`python -m vibego_cli init` 或 `./scripts/vibego init`，按提示输入 Telegram Master Bot Token。
-  - 初始化会在 `~/.config/vibego/` 下创建 `.env`、`config/projects.json`、`config/master.db` 等文件。
-3. 启动 master：`python -m vibego_cli start`。启动后请在 Telegram 中向 Bot 发送 `/start` 完成授权。
-4. 查看状态或停止服务：运行 `python -m vibego_cli status`、`python -m vibego_cli stop`。
-
-> CLI 会自动安装 Python 依赖并在 `~/.config/vibego/` 下准备 `logs/`、`state/` 等运行期目录，避免污染仓库工作区。
-
-## 日志 & 目录
-
-```
-logs/
-  └─ codex/
-      └─ mall-backend/
-           ├─ run_bot.log     # run_bot.sh 输出
-           ├─ model.log       # tmux pipe-pane 捕获的模型 CLI 输出
-           ├─ bot.pid         # 当前 bot 进程 PID（stop_bot.sh 使用）
-           └─ current_session.txt  # 最近一次 JSONL 会话指针
-```
-
-## 模型切换
-
-- 支持参数：`codex`、`claudecode`、`gemini`（占位）。
-- 切换流程：`stop_bot.sh --model <旧>` → `run_bot.sh --model <新>`。
-- 每个模型在 `scripts/models/<model>.sh` 中维护独立配置，互不依赖；公共逻辑位于 `scripts/models/common.sh`。
-- `ACTIVE_MODEL` 会在 `/start` 回复及日志中显示，并写入环境变量供 `bot.py` 使用。
-
-### Codex
-
-| 变量                   | 说明                                            |
-|----------------------|-----------------------------------------------|
-| `CODEX_WORKDIR`      | Codex CLI 工作目录（默认 `.env` 中自定义或 fallback ROOT） |
-| `CODEX_CMD`          | 启动命令，默认 `codex --dangerously-bypass-...`      |
-| `CODEX_SESSION_ROOT` | JSONL 根目录（默认 `~/.codex/sessions`）             |
-| `CODEX_SESSION_GLOB` | JSONL 文件匹配（默认 `rollout-*.jsonl`）              |
-
-### ClaudeCode
-
-| 变量                    | 说明                                    |
-|-----------------------|---------------------------------------|
-| `CLAUDE_WORKDIR`      | 工程目录（默认与 Codex 相同）                    |
-| `CLAUDE_CMD`          | CLI 启动命令，示例 `claude --project <path>` |
-| `CLAUDE_PROJECT_ROOT` | JSONL 根目录（默认 `~/.claude/projects`）    |
-| `CLAUDE_SESSION_GLOB` | JSONL 文件匹配（默认 `*.jsonl`）              |
-| `CLAUDE_PROJECT_KEY`  | 可选：显式指定 `~/.claude/projects/<key>` 路径 |
-
-### Gemini（预留）
-
-- `scripts/models/gemini.sh` 暂使用占位命令，可在后续接入官方 CLI 时扩展。
-
-## aiogram Worker 行为
-
-- `/start`：返回 `chat_id`、`MODE`、`ACTIVE_MODEL`；日志打印 `chat_id` 与 `user_id`。
-- 文本消息：
-    1. 依据 `ACTIVE_MODEL` 选择 `SessionAdapter`，读取 `current_session.txt` 中记录的 JSONL 文件，必要时搜索
-       `MODEL_SESSION_ROOT` 以回填。
-    2. 将 prompt 注入 tmux（发送 `Esc` 清空模式、`C-j` 换行、`Enter` 提交）。
-    3. 首次读取 `SESSION_OFFSETS` 初始化偏移；随后通过 `_deliver_pending_messages()` 补发当前尾部内容并持续轮询 JSONL。
-    4. watcher 阶段提示 `ACTIVE_MODEL` 正在处理中，完成后自动推送结果（保留 Markdown）。
-- MODE=A 下仍支持 `AGENT_CMD` 直接执行 CLI。
-
-## 新增脚本
-
-- `run_bot.sh`
-    - `--model <name>`：codex / claudecode / gemini。
-    - `--project <slug>`：日志/会话目录名称；未提供时依据工作目录推导。
-    - `--foreground`：前台运行（默认后台 + `nohup`）。
-    - `--no-stop`：启动前跳过 stop（默认先执行 `stop_bot.sh` 保证幂等）。
-- `stop_bot.sh`
-    - 幂等终止：`tmux kill-session`、关闭 `bot.pid` 指向的进程、移除缓存。
-    - 示例：`./scripts/stop_bot.sh --model codex --project mall-backend`。
-
-## 配置要点
-
-### `.env`（Master 全局配置）
-
-- 文件位置：`~/.config/vibego/.env`（可通过环境变量 `VIBEGO_CONFIG_DIR` 自定义）。
-- `MASTER_BOT_TOKEN`：master bot 的 Token，由 `vibego init` 引导输入，启动时必须存在。
-- `MASTER_CHAT_ID` / `MASTER_USER_ID`：首次在 Telegram 与 master 交互时自动写入，表示已授权的管理员账号。
-- `MASTER_WHITELIST`：逗号分隔的 chat_id 列表，留空表示不限制；若与自动写入冲突以最新值为准。
-- 其他可选变量（代理、日志级别、默认模型等）可按需新增，未设置时脚本使用默认值。
-
-- 项目配置持久化在 `~/.config/vibego/config/master.db`（SQLite），对应的 JSON 镜像为
-  `~/.config/vibego/config/projects.json`。如需离线编辑，可参考仓库内的 `config/projects.json.example` 模板。
-- Master「⚙️ 项目管理」可新增/编辑/删除项目；仍可离线编辑 JSON，启动时会自动导入并同步至数据库。
-- 必填字段：`bot_name`、`bot_token`、`project_slug`、`default_model`。
-- 可选字段：`workdir`（项目路径）、`allowed_chat_id`（用于预设授权）。留空时，worker 首次收到消息会自动记录 chat_id 并写回
-  `~/.config/vibego/state/master_state.json`。
-- 其他自定义字段暂不读取。
-
-### 自动授权 & 状态
-
-- worker 启动时若 `allowed_chat_id` 为空，首次合法消息会写入 `state/state.json` 并立即生效。
-- master 重启：先调用 `stop_bot.sh` 清理，再依据 state 还原正在运行的项目。
-
-## 后续规划
-
-- Master bot（8031153139:AAF83jNsfzLTk428HAOVo0pJgHadisxkhCo）将统一轮询多个项目 bot，并调用 run/stop 脚本管理
-  worker；当前版本先提供 worker 端结构与日志规范。
-- Gemini CLI 接入待官方方案确定后补充。
-
-## 注意
-
-- `~/.config/vibego/.env` 内包含敏感 Token 与管理员信息，请勿提交至版本库。
-- 若需减少日志体积，可按需清理 `logs/<model>/<project>/` 或调整脚本输出阈值。
-
-## Master 控制
-
-- 管理员 Bot 使用 `MASTER_BOT_TOKEN` 启动（运行 `python master.py`）。
-- 项目列表由 Master 仓库（`~/.config/vibego/config/master.db`）维护，可通过项目管理按钮或
-  `~/.config/vibego/config/projects.json` 同步文件更新。示例字段：
-    - `bot_name`：对应 Telegram 机器人的用户名（可带或不带 `@`，展示与交互时自动加 `@`）
-    - `bot_token`：对应 worker 的 Telegram Token
-    - `default_model`：默认模型（codex / claudecode / gemini）
-    - `project_slug`：日志/目录名称
-    - `workdir`：项目工作目录（可选）
-    - `allowed_chat_id`：项目 worker 的授权 chat（用于 run_bot 时注入环境）
-- 状态持久化：`~/.config/vibego/state/master_state.json` 自动记录各项目当前模型与运行状态，master 重启时会先 `stop_bot.sh`
-  清理现场，再根据状态恢复。
-
-### 管理命令
-
-| 命令                          | 说明                             |
-|-----------------------------|--------------------------------|
-| `/projects`                 | 列出所有项目当前状态与模型                  |
-| `/run <project> [model]`    | 启动指定项目 worker，模型可选（默认使用当前/配置值） |
-| `/stop <project>`           | 停止项目 worker                    |
-| `/switch <project> <model>` | 停止后以新模型重新启动                    |
-| `/start`                    | 显示帮助与项目数量                      |
-
-- `<project>` 参数可填写 `project_slug` 或对应 `@bot_name`，命令回复将自动展示可点击的 `@` 链接。
-
-> master 仅与管理员 bot 交互；项目 bot 仍由 worker（run_bot.sh 启动的 `bot.py`）负责处理业务消息。