remote-claude 0.1.0 → 0.1.2

package/.env.example

@@ -10,6 +10,3 @@ FEISHU_APP_SECRET=xxxxx
 ENABLE_USER_WHITELIST=false
 ALLOWED_USERS=ou_xxxxx,ou_yyyyy
 
-# 机器人名称（用于群聊命名，默认 Claude）
-BOT_NAME=Ys-Claude
-

package/init.sh

@@ -0,0 +1,534 @@
+#!/bin/bash
+
+set -e
+
+# 颜色定义
+RED=$'\033[0;31m'
+GREEN=$'\033[0;32m'
+YELLOW=$'\033[1;33m'
+NC=$'\033[0m' # No Color
+
+# 末尾汇总警告
+WARNINGS=()
+
+# 打印函数
+print_info() {
+    echo -e "${GREEN}ℹ${NC} $1"
+}
+
+print_success() {
+    echo -e "${GREEN}✓${NC} $1"
+}
+
+print_warning() {
+    echo -e "${YELLOW}⚠${NC} $1"
+}
+
+print_error() {
+    echo -e "${RED}✗${NC} $1"
+}
+
+print_header() {
+    echo ""
+    echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${GREEN}$1${NC}"
+    echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+}
+
+# 检查操作系统
+check_os() {
+    print_header "检查系统环境"
+
+    OS=$(uname -s)
+    if [[ "$OS" != "Darwin" && "$OS" != "Linux" ]]; then
+        print_error "不支持的操作系统: $OS"
+        print_error "Remote Claude 仅支持 macOS 和 Linux"
+        exit 1
+    fi
+
+    print_success "操作系统: $OS"
+}
+
+# 检查 uv
+check_uv() {
+    print_header "检查 uv"
+
+    if command -v uv &> /dev/null; then
+        UV_VERSION=$(uv --version)
+        print_success "$UV_VERSION 已安装"
+        return
+    fi
+
+    print_warning "未找到 uv，正在安装..."
+
+    # 方式一：官方安装脚本
+    if curl -LsSf https://astral.sh/uv/install.sh | sh 2>/dev/null; then
+        export PATH="$HOME/.local/bin:$PATH"
+    fi
+
+    # 方式二：brew（macOS 备用）
+    if ! command -v uv &> /dev/null && [[ "$OS" == "Darwin" ]] && command -v brew &> /dev/null; then
+        print_warning "官方脚本安装失败，尝试 brew install uv..."
+        brew install uv
+    fi
+
+    # 方式三：pip/pip3 备用
+    if ! command -v uv &> /dev/null; then
+        print_warning "尝试 pip 安装 uv..."
+        if command -v pip3 &> /dev/null; then
+            pip3 install uv --quiet
+        elif command -v pip &> /dev/null; then
+            pip install uv --quiet
+        fi
+        export PATH="$HOME/.local/bin:$PATH"
+    fi
+
+    if command -v uv &> /dev/null; then
+        print_success "uv 安装成功"
+
+        # 确保 ~/.local/bin 写入 shell rc（uv 官方脚本可能写 .zprofile 而非 .zshrc）
+        local _RC
+        if [[ -n "$ZSH_VERSION" ]] || [[ "$(basename "$SHELL")" == "zsh" ]]; then
+            _RC="$HOME/.zshrc"
+        else
+            _RC="$HOME/.bashrc"
+        fi
+        if ! grep -qF "$HOME/.local/bin" "$_RC" 2>/dev/null; then
+            echo "" >> "$_RC"
+            echo "# uv" >> "$_RC"
+            echo 'export PATH="$HOME/.local/bin:$PATH"' >> "$_RC"
+            print_success "已将 \$HOME/.local/bin 写入 $_RC"
+        fi
+    else
+        print_error "uv 安装失败，请手动安装: https://docs.astral.sh/uv/"
+        exit 1
+    fi
+}
+
+# 检查并安装 tmux（要求 3.6+）
+check_tmux() {
+    print_header "检查 tmux"
+
+    REQUIRED_MAJOR=3
+    REQUIRED_MINOR=6
+
+    install_tmux() {
+        if [[ "$OS" == "Darwin" ]]; then
+            if ! command -v brew &> /dev/null; then
+                print_warning "未找到 Homebrew，正在自动安装..."
+                /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+                # 将 Homebrew 加入 PATH（Apple Silicon / Intel 路径不同）
+                if [[ -x "/opt/homebrew/bin/brew" ]]; then
+                    eval "$(/opt/homebrew/bin/brew shellenv)"
+                elif [[ -x "/usr/local/bin/brew" ]]; then
+                    eval "$(/usr/local/bin/brew shellenv)"
+                fi
+                if ! command -v brew &> /dev/null; then
+                    print_error "Homebrew 安装失败，请手动安装后重试: https://brew.sh"
+                    exit 1
+                fi
+                print_success "Homebrew 安装成功"
+            fi
+            brew install tmux
+        elif [[ "$OS" == "Linux" ]]; then
+            if command -v apt-get &> /dev/null; then
+                sudo apt-get update && sudo apt-get install -y tmux
+            elif command -v yum &> /dev/null; then
+                sudo yum install -y tmux
+            elif command -v pacman &> /dev/null; then
+                sudo pacman -Sy --noconfirm tmux
+            elif command -v apk &> /dev/null; then
+                sudo apk add --no-cache tmux
+            elif command -v zypper &> /dev/null; then
+                sudo zypper install -y tmux
+            else
+                print_warning "无法识别包管理器，尝试从源码编译 tmux..."
+                install_tmux_from_source
+                return
+            fi
+        fi
+        print_success "tmux 安装成功"
+    }
+
+    install_tmux_from_source() {
+        local TMUX_VERSION_TAG="3.6a"
+        local TMUX_URL="https://github.com/tmux/tmux/releases/download/${TMUX_VERSION_TAG}/tmux-${TMUX_VERSION_TAG}.tar.gz"
+
+        print_warning "包管理器版本不满足要求，尝试从源码编译 tmux ${TMUX_VERSION_TAG}..."
+
+        # 安装编译依赖
+        if [[ "$OS" == "Darwin" ]]; then
+            brew install libevent ncurses pkg-config bison 2>/dev/null || true
+        elif command -v apt-get &> /dev/null; then
+            sudo apt-get install -y build-essential libevent-dev libncurses5-dev libncursesw5-dev bison pkg-config
+        elif command -v yum &> /dev/null; then
+            sudo yum groupinstall -y "Development Tools"
+            sudo yum install -y libevent-devel ncurses-devel bison
+        fi
+
+        # 确定安装前缀
+        local PREFIX="/usr/local"
+        if ! sudo -n true 2>/dev/null; then
+            print_warning "无 sudo 权限，将安装到 \$HOME/.local"
+            PREFIX="$HOME/.local"
+        fi
+
+        # 创建临时目录，编译完成后清理
+        local TMPDIR
+        TMPDIR=$(mktemp -d)
+        trap "rm -rf '$TMPDIR'" RETURN
+
+        print_warning "下载 tmux-${TMUX_VERSION_TAG}.tar.gz..."
+        if ! curl -fsSL "$TMUX_URL" -o "$TMPDIR/tmux.tar.gz"; then
+            print_warning "下载失败，请检查网络或手动安装 tmux ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+"
+            WARNINGS+=("tmux 源码下载失败，请手动安装 tmux ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+")
+            return
+        fi
+
+        tar -xzf "$TMPDIR/tmux.tar.gz" -C "$TMPDIR"
+        local SRC_DIR
+        SRC_DIR=$(find "$TMPDIR" -maxdepth 1 -type d -name "tmux-*" | head -1)
+
+        print_warning "编译 tmux（可能需要几分钟）..."
+        if ! (cd "$SRC_DIR" && ./configure --prefix="$PREFIX" && make -j"$(nproc 2>/dev/null || echo 2)"); then
+            print_warning "编译失败，请手动安装 tmux ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+"
+            WARNINGS+=("tmux 源码编译失败，请手动安装 tmux ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+")
+            return
+        fi
+
+        if [[ "$PREFIX" == "/usr/local" ]]; then
+            sudo make -C "$SRC_DIR" install
+        else
+            make -C "$SRC_DIR" install
+            # 若 $HOME/.local/bin 不在 PATH 中，自动写入 shell 配置
+            if [[ ":$PATH:" != *":$HOME/.local/bin:"* ]]; then
+                export PATH="$HOME/.local/bin:$PATH"
+                local _RC
+                if [[ "$(basename "$SHELL")" == "zsh" ]]; then
+                    _RC="$HOME/.zshrc"
+                else
+                    _RC="$HOME/.bashrc"
+                fi
+                local _PATH_LINE='export PATH="$HOME/.local/bin:$PATH"'
+                if ! grep -qF "$HOME/.local/bin" "$_RC" 2>/dev/null; then
+                    echo "" >> "$_RC"
+                    echo "# remote-claude: tmux 路径" >> "$_RC"
+                    echo "$_PATH_LINE" >> "$_RC"
+                    print_success "已自动将 \$HOME/.local/bin 加入 PATH（写入 $_RC）"
+                fi
+            fi
+        fi
+
+        print_success "tmux ${TMUX_VERSION_TAG} 源码编译安装完成（前缀：${PREFIX}）"
+    }
+
+    check_version() {
+        # tmux -V 输出格式：tmux 3.6 或 tmux 3.4a
+        local ver_str
+        ver_str=$(tmux -V | awk '{print $2}')
+        local major minor
+        major=$(echo "$ver_str" | cut -d. -f1)
+        minor=$(echo "$ver_str" | cut -d. -f2 | tr -dc '0-9')
+        if [[ "$major" -gt "$REQUIRED_MAJOR" ]] || \
+           [[ "$major" -eq "$REQUIRED_MAJOR" && "${minor:-0}" -ge "$REQUIRED_MINOR" ]]; then
+            return 0
+        fi
+        return 1
+    }
+
+    if command -v tmux &> /dev/null; then
+        TMUX_VERSION=$(tmux -V)
+        if check_version; then
+            print_success "$TMUX_VERSION 已安装（满足 >= ${REQUIRED_MAJOR}.${REQUIRED_MINOR}）"
+            return
+        else
+            print_warning "$TMUX_VERSION 版本过低，需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR} 或更高，正在升级..."
+            install_tmux
+            # 升级后再次验证，版本仍不满足则走源码编译（跨平台）
+            if ! check_version; then
+                install_tmux_from_source
+                if check_version; then
+                    print_success "tmux 已升级至 $(tmux -V)"
+                else
+                    print_warning "源码编译后版本仍不满足要求（$(tmux -V)），需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+"
+                    WARNINGS+=("tmux 版本不满足要求（$(tmux -V)），需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+，请手动升级")
+                fi
+            else
+                print_success "tmux 已升级至 $(tmux -V)"
+            fi
+        fi
+    else
+        print_warning "未找到 tmux，正在安装..."
+        install_tmux
+        if ! check_version; then
+            install_tmux_from_source
+            if ! check_version; then
+                print_warning "源码编译后版本仍不满足要求（$(tmux -V)），需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+"
+                WARNINGS+=("tmux 版本不满足要求（$(tmux -V)），需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+，请手动升级")
+            fi
+        fi
+    fi
+}
+
+# 检查 Claude CLI
+check_claude() {
+    print_header "检查 Claude CLI"
+
+    if command -v claude &> /dev/null; then
+        print_success "Claude CLI 已安装"
+        return
+    fi
+
+    print_warning "未找到 Claude CLI"
+    print_info "请访问 https://claude.ai/code 安装 Claude CLI"
+
+    if $NPM_MODE; then
+        print_info "（npm 模式：跳过交互，请安装后重新运行）"
+        return
+    fi
+
+    read -p "$(echo -e ${YELLOW}是否已安装 Claude CLI？${NC} [y/N]: )" -n 1 -r
+    echo
+    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+        print_error "请先安装 Claude CLI 后再运行此脚本"
+        exit 1
+    fi
+
+    if ! command -v claude &> /dev/null; then
+        print_error "仍未找到 claude 命令，请检查安装或 PATH 配置"
+        exit 1
+    fi
+}
+
+# 安装 Python 依赖
+install_dependencies() {
+    print_header "安装 Python 依赖"
+
+    if [ ! -f "pyproject.toml" ]; then
+        print_error "未找到 pyproject.toml 文件"
+        exit 1
+    fi
+
+    print_info "正在通过 uv 同步依赖..."
+    if $NPM_MODE; then
+        uv sync --frozen
+    else
+        uv sync
+    fi
+
+    print_success "依赖安装完成"
+}
+
+# 配置飞书环境
+configure_lark() {
+    print_header "配置飞书客户端"
+
+    ENV_FILE="$HOME/.remote-claude/.env"
+    mkdir -p "$HOME/.remote-claude"
+
+    # 迁移旧 .env（项目根目录）到新位置
+    if [ -f ".env" ] && [ ! -f "$ENV_FILE" ]; then
+        mv ".env" "$ENV_FILE"
+        print_success "已将 .env 迁移到 $ENV_FILE"
+    fi
+
+    if [ -f "$ENV_FILE" ]; then
+        print_warning ".env 文件已存在（$ENV_FILE），跳过配置"
+        return
+    fi
+
+    if [ ! -f ".env.example" ]; then
+        print_error "未找到 .env.example 文件"
+        exit 1
+    fi
+
+    read -p "$(echo -e ${YELLOW}是否需要配置飞书客户端？${NC} [y/N]: )" -n 1 -r
+    echo
+
+    if [[ $REPLY =~ ^[Yy]$ ]]; then
+        cp .env.example "$ENV_FILE"
+        print_success ".env 文件已创建于 $ENV_FILE"
+        print_warning "请编辑 $ENV_FILE，填写以下信息："
+        print_info "  - FEISHU_APP_ID: 飞书应用的 App ID"
+        print_info "  - FEISHU_APP_SECRET: 飞书应用的 App Secret"
+        print_info ""
+        print_info "获取方式: 登录飞书开放平台 -> 创建应用 -> 凭证与基础信息"
+    else
+        print_info "跳过飞书配置（可稍后手动配置）"
+    fi
+}
+
+# 创建必要目录
+create_directories() {
+    print_header "创建运行目录"
+
+    SOCKET_DIR="/tmp/remote-claude"
+    USER_DATA_DIR="$HOME/.remote-claude"
+
+    if [ ! -d "$SOCKET_DIR" ]; then
+        mkdir -p "$SOCKET_DIR"
+        print_success "创建目录: $SOCKET_DIR"
+    else
+        print_info "目录已存在: $SOCKET_DIR"
+    fi
+
+    if [ ! -d "$USER_DATA_DIR" ]; then
+        mkdir -p "$USER_DATA_DIR"
+        print_success "创建目录: $USER_DATA_DIR"
+    else
+        print_info "目录已存在: $USER_DATA_DIR"
+    fi
+}
+
+# 设置可执行权限
+set_permissions() {
+    print_header "设置执行权限"
+
+    chmod +x remote_claude.py
+    chmod +x server/server.py
+    chmod +x client/client.py
+
+    print_success "已设置执行权限"
+}
+
+# 安装快捷命令（符号链接到 bin 目录）
+configure_shell() {
+    print_header "安装快捷命令"
+
+    SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+    chmod +x "$SCRIPT_DIR/bin/cla" "$SCRIPT_DIR/bin/cl" "$SCRIPT_DIR/bin/remote-claude"
+
+    # 优先 /usr/local/bin，权限不够则选 ~/bin 或 ~/.local/bin 中已在 PATH 里的
+    BIN_DIR="/usr/local/bin"
+    if ! ln -sf "$SCRIPT_DIR/bin/cla" "$BIN_DIR/cla" 2>/dev/null; then
+        if [[ ":$PATH:" == *":$HOME/bin:"* ]]; then
+            BIN_DIR="$HOME/bin"
+        elif [[ ":$PATH:" == *":$HOME/.local/bin:"* ]]; then
+            BIN_DIR="$HOME/.local/bin"
+        else
+            BIN_DIR="$HOME/.local/bin"
+            # 自动写入 PATH 到 shell 配置文件
+            export PATH="$BIN_DIR:$PATH"
+            local _RC
+            if [[ -n "$ZSH_VERSION" ]] || [[ "$(basename "$SHELL")" == "zsh" ]]; then
+                _RC="$HOME/.zshrc"
+            else
+                _RC="$HOME/.bashrc"
+            fi
+            local _PATH_LINE='export PATH="$HOME/.local/bin:$PATH"'
+            if ! grep -qF "$HOME/.local/bin" "$_RC" 2>/dev/null; then
+                echo "" >> "$_RC"
+                echo "# remote-claude: 快捷命令路径" >> "$_RC"
+                echo "$_PATH_LINE" >> "$_RC"
+                print_success "已自动将 \$HOME/.local/bin 加入 PATH（写入 $_RC）"
+            fi
+        fi
+        mkdir -p "$BIN_DIR"
+        ln -sf "$SCRIPT_DIR/bin/cla"          "$BIN_DIR/cla"
+        ln -sf "$SCRIPT_DIR/bin/cl"           "$BIN_DIR/cl"
+        ln -sf "$SCRIPT_DIR/bin/remote-claude" "$BIN_DIR/remote-claude"
+    else
+        ln -sf "$SCRIPT_DIR/bin/cl"           "$BIN_DIR/cl"
+        ln -sf "$SCRIPT_DIR/bin/remote-claude" "$BIN_DIR/remote-claude"
+    fi
+
+    print_success "已安装 cla、cl 和 remote-claude 到 $BIN_DIR"
+    print_info "  cla           - 启动飞书客户端 + 以当前目录路径+时间戳为会话名启动 Claude"
+    print_info "  cl            - 同 cla，但跳过权限确认"
+    print_info "  remote-claude - Remote Claude 主命令（start/attach/list/kill/lark）"
+
+    # 安装 shell 自动补全
+    local COMPLETION_LINE="source \"$SCRIPT_DIR/scripts/completion.sh\""
+    local SHELL_RC=""
+    if [[ -n "$ZSH_VERSION" ]] || [[ "$(basename "$SHELL")" == "zsh" ]]; then
+        SHELL_RC="$HOME/.zshrc"
+    else
+        SHELL_RC="$HOME/.bashrc"
+    fi
+
+    if [[ -f "$SHELL_RC" ]] && grep -qF "$SCRIPT_DIR/scripts/completion.sh" "$SHELL_RC" 2>/dev/null; then
+        print_info "自动补全已配置（$SHELL_RC）"
+    else
+        echo "" >> "$SHELL_RC"
+        echo "# remote-claude 自动补全" >> "$SHELL_RC"
+        echo "$COMPLETION_LINE" >> "$SHELL_RC"
+        print_success "已添加自动补全到 $SHELL_RC（重新打开终端后生效）"
+    fi
+}
+
+# 重启飞书客户端
+restart_lark_client() {
+    print_header "重启飞书客户端"
+
+    LARK_PID_FILE="/tmp/remote-claude/lark.pid"
+
+    if [ ! -f "$LARK_PID_FILE" ] && ! pgrep -f "lark_client/main.py" &>/dev/null; then
+        print_info "飞书客户端未运行，跳过重启"
+        return
+    fi
+
+    SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+    print_info "正在重启飞书客户端..."
+    cd "$SCRIPT_DIR"
+    uv run python3 remote_claude.py lark restart
+    print_success "飞书客户端已重启"
+}
+
+# 显示使用说明
+show_usage() {
+    print_header "安装完成！"
+
+    cat << EOF
+${YELLOW}快捷命令：${NC}
+
+  ${GREEN}cla${NC}  - 启动飞书客户端 + 以当前目录+时间戳为会话名启动 Claude
+  ${GREEN}cl${NC}   - 同 cla，但跳过权限确认
+
+详细使用说明请阅读 README.md
+
+EOF
+}
+
+# 主流程
+main() {
+    # 解析参数
+    NPM_MODE=false
+    for arg in "$@"; do
+        [[ "$arg" == "--npm" ]] && NPM_MODE=true
+    done
+
+    echo ""
+    echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${GREEN}   Remote Claude 初始化脚本${NC}"
+    echo -e "${GREEN}   双端共享 Claude CLI 工具${NC}"
+    echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+
+    check_os
+    check_uv
+    check_tmux
+    check_claude
+    install_dependencies
+    if ! $NPM_MODE; then
+        configure_lark
+    fi
+    create_directories
+    set_permissions
+    configure_shell
+    restart_lark_client
+    show_usage
+
+    if [ ${#WARNINGS[@]} -gt 0 ]; then
+        echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        echo -e "${YELLOW}⚠ 注意事项${NC}"
+        echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        for w in "${WARNINGS[@]}"; do
+            echo -e "${YELLOW}⚠${NC} $w"
+        done
+        echo ""
+    fi
+}
+
+# 运行主流程
+main "$@"

package/lark_client/config.py

@@ -6,9 +6,21 @@ import os
 from pathlib import Path
 from dotenv import load_dotenv
 
-# 加载 .env 文件
-BASE_DIR = Path(__file__).resolve().parent.parent
-load_dotenv(BASE_DIR / ".env")
+import sys
+sys.path.insert(0, str(Path(__file__).resolve().parent.parent))
+from utils.session import USER_DATA_DIR, get_env_file
+
+# 加载 .env 文件，优先从 ~/.remote-claude/.env 读取
+_env_file = get_env_file()
+_old_env_file = Path(__file__).resolve().parent.parent / ".env"
+
+if not _env_file.exists() and _old_env_file.exists():
+    import shutil
+    USER_DATA_DIR.mkdir(parents=True, exist_ok=True)
+    shutil.move(str(_old_env_file), str(_env_file))
+    print(f"[config] 已将 .env 迁移到 {_env_file}")
+
+load_dotenv(_env_file)
 
 # 飞书应用配置
 FEISHU_APP_ID = os.getenv("FEISHU_APP_ID", "")

package/lark_client/lark_handler.py

@@ -31,7 +31,7 @@ from .card_builder import (
 from .shared_memory_poller import SharedMemoryPoller, CardSlice
 
 sys.path.insert(0, str(Path(__file__).parent.parent))
-from utils.session import list_active_sessions, get_socket_path
+from utils.session import list_active_sessions, get_socket_path, get_chat_bindings_file, ensure_user_data_dir
 
 try:
     from stats import track as _track_stats
@@ -42,9 +42,18 @@ except Exception:
 class LarkHandler:
     """飞书消息处理器（群聊/私聊统一逻辑）"""
 
-    _CHAT_BINDINGS_FILE = Path("/tmp/remote-claude/lark_chat_bindings.json")
+    _CHAT_BINDINGS_FILE = get_chat_bindings_file()
+    _OLD_CHAT_BINDINGS_FILE = Path("/tmp/remote-claude/lark_chat_bindings.json")
 
     def __init__(self):
+        # 兼容迁移：旧绑定文件存在而新路径不存在时，自动迁移
+        if not self._CHAT_BINDINGS_FILE.exists() and self._OLD_CHAT_BINDINGS_FILE.exists():
+            try:
+                import shutil
+                ensure_user_data_dir()
+                shutil.move(str(self._OLD_CHAT_BINDINGS_FILE), str(self._CHAT_BINDINGS_FILE))
+            except Exception as e:
+                logger.warning(f"迁移旧绑定文件失败: {e}")
         # chat_id → SessionBridge（活跃连接）
         self._bridges: Dict[str, SessionBridge] = {}
         # chat_id → session_name（当前连接状态）
@@ -68,7 +77,7 @@ class LarkHandler:
 
     def _save_chat_bindings(self):
         try:
-            self._CHAT_BINDINGS_FILE.parent.mkdir(parents=True, exist_ok=True)
+            ensure_user_data_dir()
             self._CHAT_BINDINGS_FILE.write_text(
                 json.dumps(self._chat_bindings, ensure_ascii=False)
             )

package/lark_client/main.py

@@ -250,7 +250,7 @@ class LarkBot:
         # 检查配置
         if not config.FEISHU_APP_ID or not config.FEISHU_APP_SECRET:
             print("错误: 请配置 FEISHU_APP_ID 和 FEISHU_APP_SECRET")
-            print("在 .env 文件中添加:")
+            print("在 ~/.remote-claude/.env 文件中添加:")
             print("  FEISHU_APP_ID=your_app_id")
             print("  FEISHU_APP_SECRET=your_app_secret")
             return

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-claude",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "双端共享 Claude CLI 工具",
   "bin": {
     "remote-claude": "bin/remote-claude",
@@ -13,6 +13,7 @@
   "files": [
     "bin/",
     "scripts/",
+    "init.sh",
     "remote_claude.py",
     "server/*.py",
     "client/*.py",

package/remote_claude.py

@@ -29,7 +29,8 @@ from utils.session import (
     tmux_kill_session,
     list_active_sessions, is_session_active, cleanup_session,
     is_lark_running, get_lark_pid, get_lark_status, get_lark_pid_file,
-    save_lark_status, cleanup_lark
+    save_lark_status, cleanup_lark,
+    USER_DATA_DIR, ensure_user_data_dir, get_lark_log_file
 )
 
 
@@ -196,9 +197,10 @@ def cmd_lark_start(args):
     print("正在启动飞书客户端...")
 
     ensure_socket_dir()
+    ensure_user_data_dir()
 
     # 启动守护进程（使用 -m 模块方式运行，确保相对导入正常工作）
-    log_file = SCRIPT_DIR / "lark_client.log"
+    log_file = get_lark_log_file()
 
     try:
         # 启动进程
@@ -319,7 +321,7 @@ def cmd_lark_status(args):
     print(f"运行时长: {status['uptime']}")
 
     # 检查日志文件
-    log_file = SCRIPT_DIR / "lark_client.log"
+    log_file = get_lark_log_file()
     if log_file.exists():
         print(f"日志文件: {log_file}")
         print(f"日志大小: {log_file.stat().st_size / 1024:.1f} KB")

package/scripts/check-env.sh

@@ -3,7 +3,8 @@
 # 用法: source scripts/check-env.sh "$INSTALL_DIR"
 
 INSTALL_DIR="${1:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
-ENV_FILE="$INSTALL_DIR/.env"
+ENV_FILE="$HOME/.remote-claude/.env"
+mkdir -p "$HOME/.remote-claude"
 ENV_OK=false
 
 if [ -f "$ENV_FILE" ]; then

package/scripts/postinstall.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 set -e
 
-# 解析安装目录
+# 解析安装目录（兼容符号链接）
 SOURCE="${BASH_SOURCE[0]}"
 while [ -L "$SOURCE" ]; do
     DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)"
@@ -10,67 +10,5 @@ while [ -L "$SOURCE" ]; do
 done
 INSTALL_DIR="$(cd -P "$(dirname "$SOURCE")" && cd .. && pwd)"
 
-echo ""
-echo "=== Remote Claude 安装后初始化 ==="
-echo ""
-
-# 1. 检查/安装 uv
-if ! command -v uv &>/dev/null; then
-    if [ -f "$HOME/.local/bin/uv" ]; then
-        export PATH="$HOME/.local/bin:$PATH"
-    else
-        echo "正在安装 uv..."
-        curl -LsSf https://astral.sh/uv/install.sh | sh
-        export PATH="$HOME/.local/bin:$PATH"
-    fi
-fi
-
-if ! command -v uv &>/dev/null; then
-    echo "错误: uv 安装失败，请手动安装: https://docs.astral.sh/uv/getting-started/installation/"
-    exit 1
-fi
-
-echo "✓ uv $(uv --version)"
-
-# 2. 安装 Python 依赖
-echo "正在安装 Python 依赖..."
 cd "$INSTALL_DIR"
-uv sync --frozen
-echo "✓ Python 依赖安装完成"
-
-# 3. 设置文件可执行权限
-chmod +x "$INSTALL_DIR/bin/remote-claude"
-chmod +x "$INSTALL_DIR/bin/cla"
-chmod +x "$INSTALL_DIR/bin/cl"
-chmod +x "$INSTALL_DIR/scripts/check-env.sh"
-echo "✓ 文件权限设置完成"
-
-# 4. 检查可选依赖
-echo ""
-echo "=== 依赖检查 ==="
-
-if ! command -v tmux &>/dev/null; then
-    echo "⚠ tmux 未安装（需要 >= 3.6）"
-    echo "  macOS: brew install tmux"
-    echo "  Linux: sudo apt install tmux 或 sudo yum install tmux"
-else
-    TMUX_VER=$(tmux -V | grep -oE '[0-9]+\.[0-9]+' | head -1)
-    echo "✓ tmux $TMUX_VER"
-fi
-
-if ! command -v claude &>/dev/null; then
-    echo "⚠ claude CLI 未安装"
-    echo "  安装方法: npm install -g @anthropic-ai/claude-code"
-else
-    echo "✓ claude CLI 已安装"
-fi
-
-echo ""
-echo "=== 安装完成 ==="
-echo ""
-echo "使用方法:"
-echo "  remote-claude start <会话名>   启动 Claude 会话"
-echo "  remote-claude list             列出所有会话"
-echo "  remote-claude attach <会话名>  连接到会话"
-echo "  cla                           启动飞书 + Claude（会引导配置飞书凭证）"
-echo ""
+bash init.sh --npm

package/stats/collector.py

@@ -18,8 +18,19 @@ from typing import Optional
 from .machine import get_machine_id, get_machine_info
 
 # SQLite 数据库路径（持久化，不受 /tmp 清理影响）
-_DB_DIR = Path.home() / ".local" / "share" / "remote-claude"
+_DB_DIR = Path.home() / ".remote-claude"
 _DB_PATH = _DB_DIR / "stats.db"
+_OLD_DB_DIR = Path.home() / ".local" / "share" / "remote-claude"
+_OLD_DB_PATH = _OLD_DB_DIR / "stats.db"
+
+# 兼容迁移：旧 DB 存在而新路径不存在时，自动迁移
+if not _DB_PATH.exists() and _OLD_DB_PATH.exists():
+    try:
+        import shutil as _shutil
+        _DB_DIR.mkdir(parents=True, exist_ok=True)
+        _shutil.move(str(_OLD_DB_PATH), str(_DB_PATH))
+    except Exception:
+        pass
 
 # 批量写入阈值
 _FLUSH_INTERVAL = 10.0   # 秒

package/stats/machine.py

@@ -1,7 +1,7 @@
 """
 机器标识模块
 
-持久化 UUID（~/.remote-claude-id），用于 Mixpanel distinct_id 和跨机器去重。
+持久化 UUID（~/.remote-claude/machine-id），用于 Mixpanel distinct_id 和跨机器去重。
 """
 
 import os
@@ -10,16 +10,27 @@ import uuid
 from pathlib import Path
 
 
-_ID_FILE = Path.home() / ".remote-claude-id"
+_USER_DIR = Path.home() / ".remote-claude"
+_ID_FILE = _USER_DIR / "machine-id"
+_OLD_ID_FILE = Path.home() / ".remote-claude-id"
 _machine_id: str | None = None
 
 
 def get_machine_id() -> str:
-    """获取（或生成）机器 UUID，持久化到 ~/.remote-claude-id"""
+    """获取（或生成）机器 UUID，持久化到 ~/.remote-claude/machine-id"""
     global _machine_id
     if _machine_id:
         return _machine_id
 
+    # 兼容迁移：旧文件存在而新文件不存在时，自动迁移
+    if not _ID_FILE.exists() and _OLD_ID_FILE.exists():
+        try:
+            import shutil
+            _USER_DIR.mkdir(parents=True, exist_ok=True)
+            shutil.move(str(_OLD_ID_FILE), str(_ID_FILE))
+        except Exception:
+            pass
+
     if _ID_FILE.exists():
         try:
             _machine_id = _ID_FILE.read_text().strip()
@@ -31,6 +42,7 @@ def get_machine_id() -> str:
     # 首次生成
     _machine_id = str(uuid.uuid4())
     try:
+        _USER_DIR.mkdir(parents=True, exist_ok=True)
         _ID_FILE.write_text(_machine_id)
     except Exception:
         pass  # 写失败也继续，只是无法持久化

package/stats/query.py

@@ -7,7 +7,7 @@ import time
 from pathlib import Path
 from typing import Optional
 
-_DB_PATH = Path.home() / ".local" / "share" / "remote-claude" / "stats.db"
+_DB_PATH = Path.home() / ".remote-claude" / "stats.db"
 
 
 def _get_conn() -> Optional[sqlite3.Connection]:

package/utils/session.py

@@ -16,9 +16,30 @@ import uuid
 
 # 常量
 SOCKET_DIR = Path("/tmp/remote-claude")
+USER_DATA_DIR = Path.home() / ".remote-claude"
 TMUX_SESSION_PREFIX = "rc-"
 
 
+def get_env_file() -> Path:
+    """获取 .env 配置文件路径"""
+    return USER_DATA_DIR / ".env"
+
+
+def get_chat_bindings_file() -> Path:
+    """获取飞书聊天绑定持久化文件路径"""
+    return USER_DATA_DIR / "lark_chat_bindings.json"
+
+
+def get_lark_log_file() -> Path:
+    """获取飞书客户端日志文件路径"""
+    return USER_DATA_DIR / "lark_client.log"
+
+
+def ensure_user_data_dir():
+    """确保用户数据目录存在"""
+    USER_DATA_DIR.mkdir(parents=True, exist_ok=True)
+
+
 def _safe_filename(session_name: str) -> str:
     """将会话名转为安全文件名（/ 和 . 替换为 _）"""
     return session_name.replace('/', '_').replace('.', '_')