remote-claude 0.2.11 → 0.2.12

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-claude",
-  "version": "0.2.11",
+  "version": "0.2.12",
   "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）负责按类型分拣。
+        """
+        ...