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

scripts/stop_all.sh

@@ -17,10 +17,10 @@ VERBOSE=0
 
 usage() {
   cat <<USAGE
-用法：${0##*/} [--dry-run] [--verbose]
-  --dry-run    仅打印将要执行的操作，不真正终止进程
-  --verbose    输出更详细的诊断信息
-  -h, --help   显示本帮助
+usage:${0##*/} [--dry-run] [--verbose]
+  --dry-run    Only prints what will be done, does not actually terminate the process
+  --verbose output more detailed diagnostic information
+  -h, --help   Show this help
 USAGE
 }
 
@@ -53,7 +53,7 @@ parse_args() {
       -h|--help)
         usage; exit 0 ;;
       *)
-        log_error "未知参数: $1"
+        log_error "unknown parameters: $1"
         usage
         exit 1 ;;
     esac
@@ -70,10 +70,10 @@ terminate_pattern() {
   local pids
   pids=$(list_pids "$pattern")
   if [[ -z "$pids" ]]; then
-    (( VERBOSE )) && log_info "未发现 $desc 进程"
+    (( VERBOSE )) && log_info "not found $desc process"
     return 0
   fi
-  log_info "停止 $desc: $pids"
+  log_info "stop $desc: $pids"
   if (( DRY_RUN )); then
     return 0
   fi
@@ -82,31 +82,31 @@ terminate_pattern() {
   local leftover
   leftover=$(list_pids "$pattern")
   if [[ -n "$leftover" ]]; then
-    log_warn "$desc 未完全退出，执行 kill -9 $leftover"
+    log_warn "$desc Incomplete exit, execute kill -9 $leftover"
     kill -9 $leftover >/dev/null 2>&1 || true
   fi
 }
 
 stop_workers() {
   if [[ ! -x "$STOP_BOT_SCRIPT" ]]; then
-    log_warn "未找到 stop_bot.sh，跳过 worker 清理"
+    log_warn "stop not found_bot.sh, Skip worker cleanup"
     return 0
   fi
   if (( DRY_RUN )); then
-    log_info "[dry-run] 调用 stop_bot.sh 清理所有 worker"
+    log_info "[dry-run] call stop_bot.sh Clean all workers"
     return 0
   fi
   if "$STOP_BOT_SCRIPT" >/dev/null 2>&1; then
-    log_info "worker 已停止"
+    log_info "worker alreadystop"
   else
-    log_warn "stop_bot.sh 返回非零状态，请检查日志"
+    log_warn "stop_bot.sh Returns non-zero status, please check the logs"
   fi
   return 0
 }
 
 stop_tmux_sessions() {
   if ! command -v tmux >/dev/null 2>&1; then
-    (( VERBOSE )) && log_info "未检测到 tmux，跳过会话清理"
+    (( VERBOSE )) && log_info "tmux not detected, session cleanup skipped"
     return 0
   fi
   local prefix="$DEFAULT_TMUX_PREFIX"
@@ -120,12 +120,12 @@ stop_tmux_sessions() {
   local tmux_output sessions
   tmux_output=$(tmux -u list-sessions 2>/dev/null || true)
   if [[ -z "$tmux_output" ]]; then
-    (( VERBOSE )) && log_info "未发现匹配 tmux 会话"
+    (( VERBOSE )) && log_info "not foundmatch tmux session"
     return 0
   fi
   sessions=$(printf '%s\n' "$tmux_output" | awk -F: -v prefix="$full_prefix" '$1 ~ "^" prefix {print $1}')
   if [[ -z "$sessions" ]]; then
-    (( VERBOSE )) && log_info "未发现匹配 tmux 会话"
+    (( VERBOSE )) && log_info "not foundmatch tmux session"
     return 0
   fi
   while IFS= read -r sess; do
@@ -134,7 +134,7 @@ stop_tmux_sessions() {
       log_info "[dry-run] tmux -u kill-session -t $sess"
     else
       tmux -u kill-session -t "$sess" >/dev/null 2>&1 || true
-      log_info "已终止 tmux 会话: $sess"
+      log_info "tmux session terminated: $sess"
     fi
   done <<<"$sessions"
   return 0
@@ -150,26 +150,26 @@ cleanup_state_files() {
         rm -f "$file"
       fi
       removed=1
-      log_info "已清理状态文件: $file"
+      log_info "Cleaned status file: $file"
     fi
   done
   if (( ! removed )) && (( VERBOSE )); then
-    log_info "无状态文件需要清理"
+    log_info "Stateless files need to be cleaned"
   fi
 }
 
 main() {
   parse_args "$@"
-  (( DRY_RUN )) && log_info "当前为 dry-run 模式，不会真正结束进程"
+  (( DRY_RUN )) && log_info "Dry-run mode: no processes will be terminated"
 
   stop_workers
   stop_tmux_sessions
   terminate_pattern "[Pp]ython.*master.py" "master"
   terminate_pattern "$ROOT_DIR/start.sh" "start.sh"
-  terminate_pattern "$ROOT_DIR/bot.py" "残留 worker"
+  terminate_pattern "$ROOT_DIR/bot.py" "residual worker"
   cleanup_state_files
 
-  log_info "所有相关进程与状态已处理完成"
+  log_info "All related processes and state cleaned up"
 }
 
 main "$@"

scripts/stop_bot.sh

@@ -1,17 +1,38 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+# shellcheck disable=SC2155
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+resolve_config_root() {
+  local raw=""
+  if [[ -n "${MASTER_CONFIG_ROOT:-}" ]]; then
+    raw="$MASTER_CONFIG_ROOT"
+  elif [[ -n "${VIBEGO_CONFIG_DIR:-}" ]]; then
+    raw="$VIBEGO_CONFIG_DIR"
+  elif [[ -n "${XDG_CONFIG_HOME:-}" ]]; then
+    raw="${XDG_CONFIG_HOME%/}/vibego"
+  else
+    raw="$HOME/.config/vibego"
+  fi
+  if [[ "$raw" == ~* ]]; then
+    printf '%s' "${raw/#\~/$HOME}"
+  else
+    printf '%s' "$raw"
+  fi
+}
+
+CONFIG_ROOT="$(resolve_config_root)"
+LOG_ROOT="${LOG_ROOT:-$CONFIG_ROOT/logs}"
 MODELS_DIR="$ROOT_DIR/scripts/models"
-LOG_ROOT="${LOG_ROOT:-$ROOT_DIR/logs}"
 MODEL_DEFAULT="${MODEL_DEFAULT:-codex}"
 PROJECT_DEFAULT="${PROJECT_NAME:-}"
 
 usage() {
   cat <<USAGE
-用法：${0##*/} [--model 名称] [--project 名称]
-  --model    目标模型，默认 $MODEL_DEFAULT
-  --project  项目别名；未指定时尝试使用当前目录配置
+usage:${0##*/} [--model name] [--project name]
+  --model    target model, default $MODEL_DEFAULT
+  --project  Project alias; attempts to use the current directory configuration when not specified
 USAGE
 }
 
@@ -27,7 +48,7 @@ while [[ $# -gt 0 ]]; do
     -h|--help)
       usage; exit 0 ;;
     *)
-      echo "未知参数: $1" >&2
+      echo "unknown parameters: $1" >&2
       usage
       exit 1 ;;
   esac
@@ -73,7 +94,7 @@ graceful_shutdown_claudecode() {
   done
   (( has_claude )) || return 0
 
-  printf '[stop-bot] 检测到 ClaudeCode 会话，尝试发送 /exit (session=%s)\n' "$session"
+  printf '[stop-bot] ClaudeCode session detected, trying to send /exit (session=%s)\n' "$session"
   for pane in "${pane_ids[@]}"; do
     tmux -u send-keys -t "$pane" Escape
     tmux -u send-keys -t "$pane" C-u
@@ -91,11 +112,11 @@ graceful_shutdown_claudecode() {
       fi
     done
     if (( still_running == 0 )); then
-      printf '[stop-bot] ClaudeCode 会话已响应 /exit (session=%s)\n' "$session"
+      printf '[stop-bot] ClaudeCode Session has responded /exit (session=%s)\n' "$session"
       break
     fi
     if (( $(date +%s) >= end_time )); then
-      printf '[stop-bot] ClaudeCode /exit 超时，将继续执行强制关闭 (session=%s)\n' "$session" >&2
+      printf '[stop-bot] ClaudeCode /exit Timeout, forced shutdown will continue (session=%s)\n' "$session" >&2
       break
     fi
     sleep 0.5
@@ -194,11 +215,11 @@ if [[ -n "$PROJECT_OVERRIDE" ]]; then
   stop_single_worker "$PROJECT_NAME" "$MODEL"
 else
   if ! stop_all_workers; then
-    # fallback:默认 project 名称
+    # fallback:default project name
     stop_single_worker "project" "$MODEL"
   fi
 fi
 
-# 已通过 pid 文件与 tmux 会话按项目停止进程，无需额外全局 pkill，避免误杀其它项目
+# The process has been stopped by project through the pid file and tmux session. No additional global pkill is needed to avoid accidentally killing other projects.
 
 exit 0

scripts/test_deps_check.sh

@@ -1,66 +1,70 @@
 #!/usr/bin/env bash
-# 测试依赖检查函数的逻辑
+# Test the logic of the dependency check function
 set -euo pipefail
 
 ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+MASTER_CONFIG_ROOT="${MASTER_CONFIG_ROOT:-$HOME/.config/vibego}"
+RUNTIME_DIR="${VIBEGO_RUNTIME_ROOT:-$MASTER_CONFIG_ROOT/runtime}"
+VENV_DIR="$RUNTIME_DIR/.venv"
 
-echo "=== 测试依赖检查函数 ==="
+echo "=== Test dependency check function ==="
 echo "ROOT_DIR: $ROOT_DIR"
+echo "RUNTIME_DIR: $RUNTIME_DIR"
 echo ""
 
-# 从start.sh提取check_deps_installed函数进行测试
+# from start.shExtract check_deps_installedfunction to test
 check_deps_installed() {
-  if [[ ! -d "$ROOT_DIR/.venv" ]]; then
-    echo "❌ 虚拟环境不存在"
+  if [[ ! -d "$VENV_DIR" ]]; then
+    echo "ERROR: Virtual environment does not exist"
     return 1
   fi
 
-  if [[ ! -x "$ROOT_DIR/.venv/bin/python" ]]; then
-    echo "❌ 虚拟环境Python解释器缺失"
+  if [[ ! -x "$VENV_DIR/bin/python" ]]; then
+    echo "ERROR: Python interpreter not found in virtual environment"
     return 1
   fi
 
-  if ! "$ROOT_DIR/.venv/bin/python" -c "import aiogram, aiohttp, aiosqlite" 2>/dev/null; then
-    echo "❌ 关键依赖包缺失或损坏"
+  if ! "$VENV_DIR/bin/python" -c "import aiogram, aiohttp, aiosqlite" 2>/dev/null; then
+    echo "ERROR: Required dependencies are missing or broken"
     return 1
   fi
 
-  echo "✅ 依赖检查通过"
+  echo "OK: Dependency check passed"
   return 0
 }
 
-# 测试1：检查当前环境
-echo "【测试1】检查当前虚拟环境状态："
+# Test 1: Check the current environment
+echo "[Test 1] Check the current virtual environment status:"
 if check_deps_installed; then
-  echo "结果：依赖完整，重启时将跳过pip install"
+  echo "Result: dependencies are complete, pip install will be skipped when restarting"
 else
-  echo "结果：依赖缺失，重启时将执行pip install"
+  echo "Result: Dependencies are missing, pip install will be executed when restarting"
 fi
 echo ""
 
-# 测试2：检查虚拟环境目录
-echo "【测试2】虚拟环境目录检查："
-if [[ -d "$ROOT_DIR/.venv" ]]; then
-  echo "✅ .venv 目录存在"
-  ls -lh "$ROOT_DIR/.venv/bin/python" 2>/dev/null || echo "❌ Python解释器不存在"
+# Test 2: Check the virtual environment directory
+echo "[Test 2] Virtual environment directory check:"
+if [[ -d "$VENV_DIR" ]]; then
+  echo "OK: Virtual environment directory exists: $VENV_DIR"
+  ls -lh "$VENV_DIR/bin/python" 2>/dev/null || echo "ERROR: Python interpreter does not exist"
 else
-  echo "❌ .venv 目录不存在"
+  echo "ERROR: Virtual environment directory does not exist: $VENV_DIR"
 fi
 echo ""
 
-# 测试3：检查关键依赖
-echo "【测试3】关键依赖包检查："
-if [[ -x "$ROOT_DIR/.venv/bin/python" ]]; then
+# Test 3: Check critical dependencies
+echo "[Test 3] Key dependency package check:"
+if [[ -x "$VENV_DIR/bin/python" ]]; then
   for pkg in aiogram aiohttp aiosqlite; do
-    if "$ROOT_DIR/.venv/bin/python" -c "import $pkg" 2>/dev/null; then
-      echo "✅ $pkg 已安装"
+    if "$VENV_DIR/bin/python" -c "import $pkg" 2>/dev/null; then
+      echo "OK: $pkg installed"
     else
-      echo "❌ $pkg 未安装"
+      echo "ERROR: $pkg not installed"
     fi
   done
 else
-  echo "⚠️  无法检查（Python解释器不可用）"
+  echo "WARN: Unable to check (Python interpreter unavailable)"
 fi
 echo ""
 
-echo "=== 测试完成 ==="
+echo "=== Test completed ==="

tasks/__init__.py

@@ -1,4 +1,4 @@
-"""任务管理模块，对外暴露核心服务接口。"""
+"""Task management module exposing the primary service interfaces."""
 
 from .service import TaskService
 from .models import TaskRecord, TaskNoteRecord, TaskHistoryRecord

tasks/commands.py

@@ -1,4 +1,4 @@
-"""命令行文本解析工具。"""
+"""Utilities for parsing command-style text payloads."""
 from __future__ import annotations
 
 import re
@@ -9,7 +9,7 @@ ESCAPED_PIPE_RE = re.compile(r"\\\|")
 
 
 def _split_segments(raw: str) -> list[str]:
-    """按未转义的 `|` 分割字符串，并恢复转义管道。"""
+    """Split by unescaped ``|`` characters and restore escaped pipes."""
 
     if not raw:
         return []
@@ -35,7 +35,7 @@ def _split_segments(raw: str) -> list[str]:
 
 
 def parse_structured_text(raw: str) -> Tuple[str, Dict[str, str]]:
-    """解析命令参数，返回主体文本与 key=value 字段。"""
+    """Parse command arguments and return the body together with key/value fields."""
 
     segments = _split_segments(raw)
     if not segments:
@@ -54,7 +54,7 @@ def parse_structured_text(raw: str) -> Tuple[str, Dict[str, str]]:
 
 
 def parse_simple_kv(raw: str) -> Dict[str, str]:
-    """仅解析 key=value 片段，忽略主体文本。"""
+    """Parse only ``key=value`` segments and ignore the body text."""
 
     _, extra = parse_structured_text(raw)
     return extra

tasks/constants.py

@@ -1,4 +1,4 @@
-"""任务模块常量。"""
+"""Constants shared across the task module."""
 
 TASK_STATUSES = (
     "research",

tasks/fsm.py

@@ -1,11 +1,11 @@
-"""aiogram FSM 状态定义。"""
+"""aiogram FSM state definitions."""
 from __future__ import annotations
 
 from aiogram.fsm.state import State, StatesGroup
 
 
 class TaskCreateStates(StatesGroup):
-    """任务创建引导流程的状态集。"""
+    """States for the guided task creation flow."""
 
     waiting_title = State()
     waiting_type = State()
@@ -14,7 +14,7 @@ class TaskCreateStates(StatesGroup):
 
 
 class TaskEditStates(StatesGroup):
-    """任务编辑流程的状态集。"""
+    """States for editing existing tasks."""
 
     waiting_task_id = State()
     waiting_field_choice = State()
@@ -23,7 +23,7 @@ class TaskEditStates(StatesGroup):
 
 
 class TaskNoteStates(StatesGroup):
-    """任务备注追加流程的状态集。"""
+    """States for appending notes to a task."""
 
     waiting_task_id = State()
     waiting_content = State()
@@ -31,7 +31,7 @@ class TaskNoteStates(StatesGroup):
 
 
 class TaskBugReportStates(StatesGroup):
-    """缺陷报告流程状态。"""
+    """States for the defect reporting flow."""
 
     waiting_description = State()
     waiting_reproduction = State()
@@ -40,26 +40,26 @@ class TaskBugReportStates(StatesGroup):
 
 
 class TaskDescriptionStates(StatesGroup):
-    """任务描述编辑流程状态。"""
+    """States for editing task descriptions."""
 
     waiting_content = State()
     waiting_confirm = State()
 
 
 class TaskPushStates(StatesGroup):
-    """任务推送补充信息流程的状态集。"""
+    """States for sending supplemental task updates."""
 
     waiting_choice = State()
     waiting_supplement = State()
 
 
 class TaskListSearchStates(StatesGroup):
-    """任务列表搜索流程的状态集。"""
+    """States for searching within the task list."""
 
     waiting_keyword = State()
 
 
 class ProjectDeleteStates(StatesGroup):
-    """Master 项目删除确认流程的状态定义。"""
+    """States for confirming master project deletion."""
 
     confirming = State()

tasks/models.py

@@ -1,4 +1,4 @@
-"""任务相关的数据模型定义。"""
+"""Data models used by the task subsystem."""
 from __future__ import annotations
 
 from dataclasses import dataclass, field
@@ -14,7 +14,7 @@ except ZoneInfoNotFoundError:
 
 
 def _format_shanghai(dt: datetime) -> str:
-    """格式化时间为上海时区 ISO8601 字符串（秒级，带偏移）。"""
+    """Format a datetime as an ISO8601 string in the Shanghai timezone."""
 
     if dt.tzinfo is None:
         dt = dt.replace(tzinfo=timezone.utc)
@@ -23,13 +23,13 @@ def _format_shanghai(dt: datetime) -> str:
 
 
 def shanghai_now_iso() -> str:
-    """返回当前上海时区的 ISO8601 字符串。"""
+    """Return the current time in Shanghai as an ISO8601 string."""
 
     return _format_shanghai(datetime.now(SHANGHAI_TZ))
 
 
 def ensure_shanghai_iso(value: Optional[str]) -> Optional[str]:
-    """将任意 ISO 字符串规范化为上海时区表示。"""
+    """Normalize an ISO string to the Shanghai timezone representation."""
 
     if value is None:
         return None
@@ -44,7 +44,7 @@ def ensure_shanghai_iso(value: Optional[str]) -> Optional[str]:
 
 @dataclass(slots=True)
 class TaskRecord:
-    """表示单个任务的核心字段集合。"""
+    """Core fields that describe a single task."""
 
     id: str
     project_slug: str
@@ -66,7 +66,7 @@ class TaskRecord:
 
 @dataclass(slots=True)
 class TaskNoteRecord:
-    """描述附加在任务上的备注信息。"""
+    """Note information attached to a task."""
 
     id: int
     task_id: str
@@ -77,7 +77,7 @@ class TaskNoteRecord:
 
 @dataclass(slots=True)
 class TaskHistoryRecord:
-    """记录任务字段的历史变更信息。"""
+    """Historical trace of changes to task fields."""
 
     id: int
     task_id: str