remote-claude 0.2.11 → 0.2.13

package/.env.example

@@ -26,3 +26,7 @@ ALLOWED_USERS=ou_xxxxx,ou_yyyyy
 # 支持: DEBUG / INFO / WARNING / ERROR
 # LARK_LOG_LEVEL=INFO
 
+# server 日志级别（可选，默认 INFO）
+# 支持: DEBUG / INFO / WARNING / ERROR
+# SERVER_LOG_LEVEL=INFO
+

package/README.md

@@ -272,3 +272,4 @@ CLAUDE_COMMAND=/usr/local/bin/claude
 
 - [CLAUDE.md](./CLAUDE.md) — 项目架构和开发说明
 - [LARK_CLIENT_GUIDE.md](./LARK_CLIENT_GUIDE.md) — 飞书客户端完整指南
+- [docker/README.md](./docker/README.md) — Docker 测试（npm 包发布前验证）

package/client/client.py

@@ -57,16 +57,55 @@ class RemoteClient:
     async def connect(self) -> bool:
         """连接到服务器"""
         if not self.socket_path.exists():
-            print(f"错误: 会话 '{self.session_name}' 不存在")
+            print(
+                f"❌ 错误: Socket 文件不存在\n"
+                f"   会话名: {self.session_name}\n"
+                f"   Socket 路径: {self.socket_path}\n"
+                f"\n"
+                f"   请使用 `python3 remote_claude.py list` 查看可用会话"
+            )
             return False
 
         try:
             self.reader, self.writer = await asyncio.open_unix_connection(
                 path=str(self.socket_path)
             )
+            print(f"✅ 已连接到会话: {self.session_name}")
             return True
+        except ConnectionRefusedError as e:
+            # 检查进程状态
+            from utils.session import list_active_sessions
+            sessions = list_active_sessions()
+            session_exists = any(s["name"] == self.session_name for s in sessions)
+
+            print(
+                f"❌ 连接失败: Connection refused\n"
+                f"   会话名: {self.session_name}\n"
+                f"   Socket 路径: {self.socket_path}\n"
+                f"   文件存在: {self.socket_path.exists()}\n"
+                f"   会话在列表中: {session_exists}\n"
+                f"\n"
+                f"   当前活跃会话:"
+            )
+            for s in sessions:
+                print(f"     - {s['name']} (PID: {s.get('pid', 'N/A')})")
+            print(
+                f"\n"
+                f"   可能原因:\n"
+                f"     1. Server 进程已终止但 Socket 文件残留\n"
+                f"     2. Socket 文件权限错误\n"
+                f"\n"
+                f"   建议操作:\n"
+                f"     python3 remote_claude.py kill {self.session_name}\n"
+                f"     python3 remote_claude.py start {self.session_name}"
+            )
+            return False
         except Exception as e:
-            print(f"连接失败: {e}")
+            print(
+                f"❌ 连接失败: {type(e).__name__}: {e}\n"
+                f"   会话名: {self.session_name}\n"
+                f"   Socket 路径: {self.socket_path}"
+            )
             return False
 
     async def run(self):

package/init.sh

@@ -159,6 +159,19 @@ check_uv() {
 check_tmux() {
     print_header "检查 tmux"
 
+    # CI 模式：跳过 tmux 版本检查（Docker 环境可能没有 sudo）
+    if [ "$CI_MODE" = "true" ]; then
+        if command -v tmux &> /dev/null; then
+            TMUX_VERSION=$(tmux -V)
+            print_success "$TMUX_VERSION 已安装（CI 模式跳过版本检查）"
+            return
+        else
+            print_error "未找到 tmux"
+            WARNINGS+=("tmux 未安装，CI 模式跳过版本检查")
+            return
+        fi
+    fi
+
     REQUIRED_MAJOR=3
     REQUIRED_MINOR=6
 
@@ -581,6 +594,11 @@ main() {
         [[ "$arg" == "--npm" ]] && NPM_MODE=true
     done
 
+    # CI 模式：跳过 tmux 版本检查（CI 环境可能没有 sudo）
+    if [ -n "$CI" ]; then
+        export CI_MODE=true
+    fi
+
     echo ""
     echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
     echo -e "${GREEN}   Remote Claude 初始化脚本${NC}"

package/lark_client/session_bridge.py

@@ -47,6 +47,14 @@ class SessionBridge:
     async def connect(self) -> bool:
         """连接到会话"""
         if not self.socket_path.exists():
+            logger.error(
+                f"连接失败: Socket 文件不存在\n"
+                f"  会话名: {self.session_name}\n"
+                f"  Socket 路径: {self.socket_path}\n"
+                f"  请确认:\n"
+                f"    1. 会话已启动 (使用 /list 查看)\n"
+                f"    2. 会话名拼写正确"
+            )
             return False
         try:
             self.reader, self.writer = await asyncio.open_unix_connection(
@@ -54,9 +62,40 @@ class SessionBridge:
             )
             self.running = True
             self._read_task = asyncio.create_task(self._read_loop())
+            logger.info(f"连接成功: {self.session_name}")
             return True
+        except FileNotFoundError:
+            logger.error(
+                f"连接失败: Socket 文件不存在\n"
+                f"  会话名: {self.session_name}\n"
+                f"  Socket 路径: {self.socket_path}\n"
+                f"  可能原因: Socket 文件在连接前被删除"
+            )
+            return False
+        except ConnectionRefusedError as e:
+            # 检查进程状态
+            sessions = list_active_sessions()
+            session_exists = any(s["name"] == self.session_name for s in sessions)
+
+            logger.error(
+                f"连接失败: Connection refused\n"
+                f"  会话名: {self.session_name}\n"
+                f"  Socket 路径: {self.socket_path}\n"
+                f"  文件存在: {self.socket_path.exists()}\n"
+                f"  会话在列表中: {session_exists}\n"
+                f"  当前活跃会话: {[s['name'] for s in sessions]}\n"
+                f"  可能原因:\n"
+                f"    1. Server 进程已终止但 Socket 文件残留\n"
+                f"    2. Socket 文件权限错误\n"
+                f"    建议: 使用 /kill {self.session_name} 清理后重新启动"
+            )
+            return False
         except Exception as e:
-            logger.error(f"连接失败: {e}")
+            logger.error(
+                f"连接失败: {type(e).__name__}: {e}\n"
+                f"  会话名: {self.session_name}\n"
+                f"  Socket 路径: {self.socket_path}"
+            )
             return False
 
     async def disconnect(self):

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-claude",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "双端共享 Claude CLI 工具",
   "bin": {
     "remote-claude": "bin/remote-claude",
@@ -17,6 +17,7 @@
     "init.sh",
     "remote_claude.py",
     "server/*.py",
+    "server/parsers/*.py",
     "client/*.py",
     "utils/*.py",
     "lark_client/__init__.py",

package/server/parsers/__init__.py

@@ -0,0 +1,13 @@
+"""终端屏幕解析器包
+
+提供可插拔的解析器架构，支持 Claude CLI 和 Codex CLI（及未来其他 CLI 工具）。
+
+使用方法：
+    from parsers import ClaudeParser, CodexParser, BaseParser
+"""
+
+from .base_parser import BaseParser
+from .claude_parser import ClaudeParser, ScreenParser  # ScreenParser 为向后兼容别名
+from .codex_parser import CodexParser
+
+__all__ = ['BaseParser', 'ClaudeParser', 'CodexParser', 'ScreenParser']

package/server/parsers/base_parser.py

@@ -0,0 +1,44 @@
+"""终端屏幕解析器基类
+
+定义统一接口：parse(screen) -> List[Component]
+ClaudeParser 和 CodexParser 均继承此类。
+"""
+
+from abc import ABC, abstractmethod
+from typing import List
+
+import pyte
+
+
+class BaseParser(ABC):
+    """终端屏幕解析器基类。
+
+    具体实现（ClaudeParser、CodexParser 等）继承此类，
+    负责将 pyte.Screen 快照解析为 Component 列表。
+
+    Component 列表包含两类组件：
+    - 累积型 Block：OutputBlock, UserInput, PlanBlock, SystemBlock
+    - 状态型组件：StatusLine, BottomBar, AgentPanelBlock, OptionBlock
+
+    OutputWatcher 读取 last_input_text / last_input_ansi_text / last_layout_mode
+    等属性来辅助生成 ClaudeWindow 快照。
+    """
+
+    # 最近一次解析结果的辅助属性（由子类在 parse() 中更新）
+    last_input_text: str = ''
+    last_input_ansi_text: str = ''
+    last_parse_timing: str = ''
+    last_layout_mode: str = 'normal'
+
+    @abstractmethod
+    def parse(self, screen: pyte.Screen) -> List:
+        """解析 pyte 屏幕，返回 Component 列表。
+
+        Args:
+            screen: pyte.Screen 快照（持久化渲染器的当前状态）
+
+        Returns:
+            Component 列表，包含累积型 Block 和状态型组件的混合。
+            调用方（OutputWatcher）负责按类型分拣。
+        """
+        ...