remote-claude 0.2.5 → 0.2.7

package/.env.example

@@ -1,9 +1,5 @@
 # Remote Claude 飞书客户端配置
 
-# Claude CLI 命令（可选，默认 claude）
-# 支持多词命令，如：ccr code、/usr/local/bin/claude
-# CLAUDE_COMMAND=claude
-
 # 飞书应用配置（必填）
 # 在飞书开发者后台创建应用获取: https://open.feishu.cn/app
 FEISHU_APP_ID=cli_xxxxx
@@ -14,3 +10,11 @@ FEISHU_APP_SECRET=xxxxx
 ENABLE_USER_WHITELIST=false
 ALLOWED_USERS=ou_xxxxx,ou_yyyyy
 
+# 群聊名称前缀（可选，默认「Remote-Claude」）
+# 群名格式：{GROUP_NAME_PREFIX}{目录名}-{HH-MM}，如：【Remote-Claude】myapp-14-30
+# GROUP_NAME_PREFIX=【Remote-Claude】
+
+# Claude CLI 命令（可选，默认 claude）
+# 支持多词命令，如：ccr code、/usr/local/bin/claude
+# CLAUDE_COMMAND=claude
+

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/lark_client/config.py

@@ -32,3 +32,6 @@ ENABLE_USER_WHITELIST = os.getenv("ENABLE_USER_WHITELIST", "false").lower() == "
 
 # 机器人名称（用于群聊命名）
 BOT_NAME = os.getenv("BOT_NAME", "Claude")
+
+# 群聊名称前缀（格式：{GROUP_NAME_PREFIX}{dir}-{HH-MM}）
+GROUP_NAME_PREFIX = os.getenv("GROUP_NAME_PREFIX", "【Remote-Claude】")

package/lark_client/lark_handler.py

@@ -620,13 +620,15 @@ class LarkHandler:
         cwd = self._get_pid_cwd(pid) if pid else None
         dir_label = cwd.rstrip("/").rsplit("/", 1)[-1] if cwd else session_name
 
-        import lark_oapi as lark
         from . import config
         try:
             import json as _json
             import urllib.request
+            import datetime
+            _time_str = datetime.datetime.now().strftime("%H-%M")
+            group_name = f"{config.GROUP_NAME_PREFIX}{dir_label}-{_time_str}"
             req_body = {
-                "name": f"【{dir_label}】{config.BOT_NAME}",
+                "name": group_name,
                 "description": f"Remote Claude 专属群 - 会话 {session_name}",
                 "user_id_list": [user_id],
             }
@@ -665,7 +667,7 @@ class LarkHandler:
 
             await card_service.send_text(
                 chat_id,
-                f"✅ 已创建专属群「【{dir_label}】{config.BOT_NAME}」并已连接\n"
+                f"✅ 已创建专属群「{group_name}」并已连接\n"
                 f"在群内直接发消息即可与 Claude 交互"
             )
             # 刷新会话列表卡片，使"创建群聊"按钮变为"进入群聊"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-claude",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "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/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()