fix: 修复启动器共享 quant venv 探测

Author: Astro-Han

QuantClass Sync.command

@@ -134,7 +134,7 @@ _try_activate_project_venv() {
     local venv_python="$PROJECT_DIR/.venv/bin/python"
 
     if [ ! -x "$venv_python" ]; then
-        _log_fallback "未找到项目 .venv，尝试系统 python3..."
+        _log_fallback "未找到项目 .venv，尝试共享 quant .venv..."
         return 1
     fi
 
@@ -148,6 +148,26 @@ _try_activate_project_venv() {
     return 0
 }
 
+# 兼容当前仓库约定的共享 quant 工作区 .venv。
+_try_activate_workspace_venv() {
+    local workspace_venv_python="$HOME/workspace/quant/.venv/bin/python"
+    local workspace_venv_activate="$HOME/workspace/quant/.venv/bin/activate"
+
+    if [ ! -x "$workspace_venv_python" ]; then
+        _log_fallback "未找到共享 quant .venv，尝试系统 python3..."
+        return 1
+    fi
+
+    if [ -f "$workspace_venv_activate" ]; then
+        # shellcheck disable=SC1090
+        source "$workspace_venv_activate"
+    fi
+
+    PYTHON="$workspace_venv_python"
+    ENV_TYPE="workspace_venv"
+    return 0
+}
+
 # 最后兜底系统 python3。
 _try_use_system_python() {
     if ! command -v python3 >/dev/null 2>&1; then
@@ -180,15 +200,15 @@ _print_dependency_help() {
             echo "错误：依赖安装失败，请手动执行："
             echo "  $PYTHON -m pip install -r requirements.txt"
             ;;
-        venv)
+        venv|workspace_venv)
             if "$PYTHON" -m pip --version >/dev/null 2>&1; then
                 echo "错误：依赖安装失败，请手动执行："
                 echo "  $PYTHON -m pip install -r requirements.txt"
             elif command -v uv >/dev/null 2>&1; then
-                echo "错误：当前 .venv 没有 pip，请手动执行："
+                echo "错误：当前虚拟环境没有 pip，请手动执行："
                 echo "  uv pip install --python \"$PYTHON\" -r requirements.txt"
             else
-                echo "错误：当前 .venv 没有 pip，且系统未找到 uv。"
+                echo "错误：当前虚拟环境没有 pip，且系统未找到 uv。"
                 echo "请先安装 pip 或 uv 后重试。"
             fi
             ;;
@@ -219,8 +239,8 @@ _install_requirements_if_needed() {
             echo "检测到 conda 环境缺少依赖，正在安装..."
             "$PYTHON" -m pip install -r requirements.txt
             ;;
-        venv)
-            echo "检测到项目 .venv 缺少依赖，正在安装..."
+        venv|workspace_venv)
+            echo "检测到虚拟环境缺少依赖，正在安装..."
             if "$PYTHON" -m pip --version >/dev/null 2>&1; then
                 "$PYTHON" -m pip install -r requirements.txt
             elif command -v uv >/dev/null 2>&1; then
@@ -242,12 +262,13 @@ _install_requirements_if_needed() {
     fi
 }
 
-if ! _try_activate_conda && ! _try_activate_project_venv && ! _try_use_system_python; then
+if ! _try_activate_conda && ! _try_activate_project_venv && ! _try_activate_workspace_venv && ! _try_use_system_python; then
     echo "错误：未找到可用 Python 环境。"
     echo "建议安装以下任一环境："
     echo "  1. conda，并在 user_config.json 中填写 conda_env"
     echo "  2. 项目根目录 .venv，可用 uv 创建：uv venv .venv"
-    echo "  3. 系统 python3，并确保命令行可访问"
+    echo "  3. 共享 quant .venv，路径为 ~/workspace/quant/.venv"
+    echo "  4. 系统 python3，并确保命令行可访问"
     _pause_and_exit 1
 fi
 

tests/test_install.sh

@@ -223,13 +223,16 @@ print_e3_checklist() {
     echo "  E3.3  项目目录存在 .venv，且 conda 不可用或 conda_env 无效 -> 双击"
     echo "        验收: 启动日志显示走 .venv 分支，GUI 正常弹出"
     echo ""
-    echo "  E3.4  无 conda、无 .venv，仅系统 python3 -> 双击"
+    echo "  E3.4  无 conda、无项目 .venv，但存在 ~/workspace/quant/.venv -> 双击"
+    echo "        验收: 启动日志显示走共享 quant .venv，GUI 正常弹出"
+    echo ""
+    echo "  E3.5  无 conda、无 .venv，仅系统 python3 -> 双击"
     echo "        验收: 看到手动安装依赖提示，不是空白闪退"
     echo ""
-    echo "  E3.5  conda 已安装，但 user_config.json 中的 conda_env 指向不存在环境 -> 双击"
-    echo "        验收: 日志显示 fallback 到 .venv 或系统 python3"
+    echo "  E3.6  conda 已安装，但 user_config.json 中的 conda_env 指向不存在环境 -> 双击"
+    echo "        验收: 日志显示 fallback 到项目 .venv、共享 quant .venv 或系统 python3"
     echo ""
-    echo "  E3.6  .venv 存在但 pip 不可用，且系统装有 uv -> 双击"
+    echo "  E3.7  .venv 存在但 pip 不可用，且系统装有 uv -> 双击"
     echo "        验收: 依赖安装走 uv pip install --python ..."
     echo ""
 }

tests/test_launcher_selection.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+
+set -euo pipefail
+
+PROJECT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+TMP_ROOT="$(mktemp -d)"
+trap 'rm -rf "$TMP_ROOT"' EXIT
+
+HARNESS_DIR="$TMP_ROOT/harness"
+FAKE_HOME="$TMP_ROOT/home"
+FAKE_BIN="$TMP_ROOT/bin"
+
+mkdir -p "$HARNESS_DIR" "$FAKE_HOME/workspace/quant/.venv/bin" "$FAKE_BIN"
+
+cp "$PROJECT_DIR/QuantClass Sync.command" "$HARNESS_DIR/QuantClass Sync.command"
+cp "$PROJECT_DIR/requirements.txt" "$HARNESS_DIR/requirements.txt"
+chmod +x "$HARNESS_DIR/QuantClass Sync.command"
+
+cat > "$FAKE_HOME/workspace/quant/.venv/bin/python" <<'EOF'
+#!/bin/bash
+set -euo pipefail
+
+if [ "${1:-}" = "-c" ]; then
+    code="${2:-}"
+    if [[ "$code" == *"from quantclass_sync_internal import cli"* ]]; then
+        exit 0
+    fi
+    exit 0
+fi
+
+if [ "${1:-}" = "quantclass_sync.py" ] && [ "${2:-}" = "gui" ]; then
+    exit 0
+fi
+
+echo "unexpected shared python invocation: $*" >&2
+exit 1
+EOF
+chmod +x "$FAKE_HOME/workspace/quant/.venv/bin/python"
+
+cat > "$FAKE_BIN/python3" <<'EOF'
+#!/bin/bash
+set -euo pipefail
+
+if [ "${1:-}" = "-c" ]; then
+    exit 0
+fi
+
+echo "system python3 should not be selected" >&2
+exit 99
+EOF
+chmod +x "$FAKE_BIN/python3"
+
+OUTPUT="$(
+    HOME="$FAKE_HOME" \
+    PATH="$FAKE_BIN:/usr/bin:/bin" \
+    bash "$HARNESS_DIR/QuantClass Sync.command" </dev/null 2>&1 || true
+)"
+
+echo "$OUTPUT" | grep -q "已选择环境类型: workspace_venv"
+echo "$OUTPUT" | grep -q "Python 路径: $FAKE_HOME/workspace/quant/.venv/bin/python"