remote-claude 0.2.4 → 0.2.6

package/.env.example

@@ -1,5 +1,9 @@
 # Remote Claude 飞书客户端配置
 
+# Claude CLI 命令（可选，默认 claude）
+# 支持多词命令，如：ccr code、/usr/local/bin/claude
+# CLAUDE_COMMAND=claude
+
 # 飞书应用配置（必填）
 # 在飞书开发者后台创建应用获取: https://open.feishu.cn/app
 FEISHU_APP_ID=cli_xxxxx

package/README.md

@@ -231,6 +231,32 @@ remote-claude lark status        # 查看状态
 
 飞书中与机器人对话，可用命令：`/menu`、`/attach`、`/detach`、`/list`、`/help` 等。
 
+## 高级配置
+
+在 `~/.remote-claude/.env` 中可配置以下选项：
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| `CLAUDE_COMMAND` | `claude` | 启动 Claude CLI 的命令 |
+| `FEISHU_APP_ID` | — | 飞书应用 ID |
+| `FEISHU_APP_SECRET` | — | 飞书应用密钥 |
+| `ENABLE_USER_WHITELIST` | `false` | 是否启用用户白名单 |
+| `ALLOWED_USERS` | — | 白名单用户 ID，逗号分隔 |
+
+### 自定义 Claude CLI 命令
+
+若你的 Claude CLI 安装方式不同，启动命令不是 `claude`，可通过 `CLAUDE_COMMAND` 指定：
+
+```bash
+# ~/.remote-claude/.env
+
+# 使用两段式命令（如 ccr code）
+CLAUDE_COMMAND=ccr code
+
+# 使用绝对路径
+CLAUDE_COMMAND=/usr/local/bin/claude
+```
+
 ## 系统要求
 
 - **操作系统**: macOS 或 Linux

package/init.sh

@@ -369,6 +369,9 @@ install_dependencies() {
     fi
 
     print_success "依赖安装完成"
+
+    # 上报 init_install 事件（后台执行，不阻塞，失败静默）
+    python3 scripts/report_install.py &>/dev/null &
 }
 
 # 配置飞书环境

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-claude",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "双端共享 Claude CLI 工具",
   "bin": {
     "remote-claude": "bin/remote-claude",
@@ -12,7 +12,8 @@
   },
   "files": [
     "bin/",
-    "scripts/",
+    "scripts/*.sh",
+    "scripts/*.py",
     "init.sh",
     "remote_claude.py",
     "server/*.py",

package/remote_claude.py

@@ -387,6 +387,43 @@ def cmd_stats(args):
     return 0
 
 
+def cmd_update(args):
+    """更新 remote-claude 到最新版本"""
+    import subprocess as _sp
+
+    git_dir = SCRIPT_DIR / ".git"
+    if git_dir.exists():
+        # 源码安装：git pull 更新
+        print(f"检测到源码安装（{SCRIPT_DIR}）")
+        print("正在更新...")
+        result = _sp.run(["git", "pull"], cwd=SCRIPT_DIR)
+        if result.returncode != 0:
+            print("❌ git pull 失败")
+            return 1
+        # 同步 Python 依赖
+        _sp.run(["uv", "sync"], cwd=SCRIPT_DIR)
+        print("✅ 更新完成")
+    else:
+        # npm 安装：区分本地和全局
+        install_dir_str = str(SCRIPT_DIR)
+        if "node_modules" in install_dir_str:
+            # 本地 npm 安装：找到项目根目录（node_modules 的上两级）
+            project_root = SCRIPT_DIR.parent.parent
+            print(f"检测到 npm 本地安装（{project_root}）")
+            print("正在更新...")
+            result = _sp.run(["npm", "install", "remote-claude@latest"], cwd=project_root)
+        else:
+            # 全局 npm 安装
+            print("检测到 npm 全局安装")
+            print("正在更新...")
+            result = _sp.run(["npm", "install", "-g", "remote-claude@latest"])
+        if result.returncode != 0:
+            print("❌ npm 更新失败")
+            return 1
+        print("✅ 更新完成，请重启终端使新版本生效")
+    return 0
+
+
 def cmd_lark(args):
     """飞书客户端管理（兼容旧命令）"""
     # 如果没有子命令，默认显示状态或启动
@@ -531,6 +568,10 @@ def main():
     )
     stats_parser.set_defaults(func=cmd_stats)
 
+    # update 命令
+    update_parser = subparsers.add_parser("update", help="更新 remote-claude 到最新版本")
+    update_parser.set_defaults(func=cmd_update)
+
     args = parser.parse_args()
 
     if args.command is None:

package/scripts/report_install.py

@@ -0,0 +1,86 @@
+"""
+init_install 上报脚本
+
+每次 init.sh 执行时调用（npm 安装和源码安装均覆盖），发送 init_install 事件到 Mixpanel。
+仅依赖标准库，不需要 mixpanel 包，失败静默。
+"""
+
+import base64
+import json
+import platform
+import urllib.request
+import uuid
+from pathlib import Path
+
+_TOKEN = 'c4d804fc1fe4337132e4da90fdb690c9'
+_USER_DIR = Path.home() / '.remote-claude'
+_ID_FILE = _USER_DIR / 'machine-id'
+_REPORTED_VERSION_FILE = _USER_DIR / 'init_install_version'
+
+
+def _get_machine_id() -> str:
+    if _ID_FILE.exists():
+        try:
+            mid = _ID_FILE.read_text().strip()
+            if mid:
+                return mid
+        except Exception:
+            pass
+    mid = str(uuid.uuid4())
+    try:
+        _USER_DIR.mkdir(parents=True, exist_ok=True)
+        _ID_FILE.write_text(mid)
+    except Exception:
+        pass
+    return mid
+
+
+def _get_version() -> str:
+    try:
+        pkg = Path(__file__).parent.parent / 'package.json'
+        return json.loads(pkg.read_text()).get('version', 'unknown')
+    except Exception:
+        return 'unknown'
+
+
+def main() -> None:
+    machine_id = _get_machine_id()
+    version = _get_version()
+
+    # 每个版本只上报一次
+    try:
+        if _REPORTED_VERSION_FILE.exists() and _REPORTED_VERSION_FILE.read_text().strip() == version:
+            return
+    except Exception:
+        pass
+    props = {
+        'token': _TOKEN,
+        'distinct_id': machine_id,
+        'version': version,
+        'hostname': platform.node(),
+        'os': f'{platform.system()} {platform.release()}',
+        'python': platform.python_version(),
+    }
+    data = base64.b64encode(json.dumps([{
+        'event': 'init_install',
+        'properties': props,
+    }]).encode()).decode()
+    req = urllib.request.Request(
+        'https://api.mixpanel.com/track',
+        data=f'data={data}'.encode(),
+        method='POST',
+    )
+    urllib.request.urlopen(req, timeout=10)
+
+    # 记录已上报版本
+    try:
+        _REPORTED_VERSION_FILE.write_text(version)
+    except Exception:
+        pass
+
+
+if __name__ == '__main__':
+    try:
+        main()
+    except Exception:
+        pass

package/server/server.py

@@ -35,9 +35,16 @@ from utils.protocol import (
 )
 from utils.session import (
     get_socket_path, get_pid_file, ensure_socket_dir,
-    generate_client_id, cleanup_session, _safe_filename
+    generate_client_id, cleanup_session, _safe_filename, get_env_file
 )
 
+# 加载用户 .env 配置（支持 CLAUDE_COMMAND 等）
+try:
+    from dotenv import load_dotenv
+    load_dotenv(get_env_file())
+except Exception:
+    pass
+
 try:
     from stats import track as _track_stats
 except Exception:
@@ -533,9 +540,11 @@ class ProxyServer:
     """Proxy Server"""
 
     def __init__(self, session_name: str, claude_args: list = None,
+                 claude_cmd: str = "claude",
                  debug_screen: bool = False, debug_verbose: bool = False):
         self.session_name = session_name
         self.claude_args = claude_args or []
+        self.claude_cmd = claude_cmd
         self.debug_screen = debug_screen
         self.debug_verbose = debug_verbose
         self.socket_path = get_socket_path(session_name)
@@ -638,7 +647,9 @@ class ProxyServer:
             # 清除 tmux 标识变量（PTY 数据不经过 tmux，不应让 Claude CLI 误判终端环境）
             child_env.pop('TMUX', None)
             child_env.pop('TMUX_PANE', None)
-            os.execvpe("claude", ["claude"] + self.claude_args, child_env)
+            import shlex as _shlex
+            _cmd_parts = _shlex.split(self.claude_cmd)
+            os.execvpe(_cmd_parts[0], _cmd_parts + self.claude_args, child_env)
             os._exit(1)  # execvpe 失败时兜底退出
         else:
             # 父进程
@@ -801,10 +812,11 @@ class ProxyServer:
 
 
 def run_server(session_name: str, claude_args: list = None,
+               claude_cmd: str = "claude",
                debug_screen: bool = False, debug_verbose: bool = False):
     """运行服务器"""
-    server = ProxyServer(session_name, claude_args, debug_screen=debug_screen,
-                         debug_verbose=debug_verbose)
+    server = ProxyServer(session_name, claude_args, claude_cmd=claude_cmd,
+                         debug_screen=debug_screen, debug_verbose=debug_verbose)
 
     # 信号处理
     def signal_handler(signum, frame):
@@ -832,5 +844,6 @@ if __name__ == "__main__":
                         help="debug 日志输出完整诊断信息（indicator、repr 等）")
     args = parser.parse_args()
 
-    run_server(args.session_name, args.claude_args, debug_screen=args.debug_screen,
-               debug_verbose=args.debug_verbose)
+    claude_cmd = os.environ.get("CLAUDE_COMMAND", "claude")
+    run_server(args.session_name, args.claude_args, claude_cmd=claude_cmd,
+               debug_screen=args.debug_screen, debug_verbose=args.debug_verbose)

package/stats/collector.py

@@ -7,6 +7,7 @@ StatsCollector：事件收集器
 - 所有异常均被捕获，绝不影响主流程
 """
 
+import logging
 import os
 import sqlite3
 import threading
@@ -15,6 +16,8 @@ from collections import deque
 from pathlib import Path
 from typing import Optional
 
+logger = logging.getLogger(__name__)
+
 from .machine import get_machine_id, get_machine_info
 
 # SQLite 数据库路径（持久化，不受 /tmp 清理影响）
@@ -321,16 +324,49 @@ class StatsCollector:
 
     def report_install(self) -> None:
         """首次运行时上报 install 事件和 user profile"""
-        if not self._mp or not self._is_first_run:
+        if not self._is_first_run or not self._mp_token:
             return
-        try:
-            machine_info = get_machine_info()
-            import datetime
-            self._mp.people_set(self._machine_id, {
-                '$name': machine_info['hostname'],
-                **machine_info,
-                'first_seen': datetime.datetime.now().isoformat(),
-            })
-            self._mp_track('install', machine_info)
-        except Exception:
-            pass
+
+        machine_info = get_machine_info()
+        machine_id = self._machine_id
+        mp_token = self._mp_token
+        mp = self._mp  # 可能为 None（mixpanel 包未安装时）
+
+        def _send() -> None:
+            try:
+                import base64
+                import json
+                import urllib.request
+
+                props = {**machine_info, 'token': mp_token, 'distinct_id': machine_id}
+                data = base64.b64encode(json.dumps([{
+                    'event': 'install',
+                    'properties': props,
+                }]).encode()).decode()
+                req = urllib.request.Request(
+                    'https://api.mixpanel.com/track',
+                    data=f'data={data}'.encode(),
+                    method='POST',
+                )
+                urllib.request.urlopen(req, timeout=10)
+                logger.debug('install event sent via urllib (machine_id=%s)', machine_id)
+            except Exception as e:
+                logger.warning('install event failed: %s', e)
+
+            # 同时更新 user profile（仅 SDK 可用时）
+            if mp:
+                try:
+                    import datetime
+                    mp.people_set(machine_id, {
+                        '$name': machine_info['hostname'],
+                        **machine_info,
+                        'first_seen': datetime.datetime.now().isoformat(),
+                    })
+                    logger.debug('people_set sent via mixpanel SDK')
+                except Exception as e:
+                    logger.warning('people_set failed: %s', e)
+            else:
+                logger.debug('mixpanel SDK not available, skipping people_set')
+
+        t = threading.Thread(target=_send, daemon=True)
+        t.start()