remote-claude 0.1.7 → 0.2.1

package/lark_client/card_builder.py

@@ -11,10 +11,27 @@
 
 import logging
 import re as _re
+import pathlib as _pl
+import json as _json
 from typing import Dict, Any, List, Optional
 
 _cb_logger = logging.getLogger('CardBuilder')
 
+# 版本号：从 package.json 读取，import 时只读一次
+try:
+    _pkg = _pl.Path(__file__).parent.parent / "package.json"
+    _VERSION = "v" + _json.loads(_pkg.read_text())["version"]
+except Exception:
+    _VERSION = ""
+
+
+def _build_header(title: str, template: str) -> dict:
+    """构建卡片 header，自动附加版本号副标题"""
+    h: dict = {"title": {"tag": "plain_text", "content": title}, "template": template}
+    if _VERSION:
+        h["subtitle"] = {"tag": "plain_text", "content": _VERSION}
+    return h
+
 # ANSI SGR 前景色码 → 飞书颜色
 # 飞书支持: blue, wathet, turquoise, green, yellow, orange, red, carmine, violet, purple, indigo, grey
 _SGR_FG_TO_LARK = {
@@ -261,6 +278,7 @@ def _build_menu_button_row(session_name: Optional[str] = None, disconnected: boo
                 "width": "auto",
                 "elements": [{
                     "tag": "button",
+                    "name": "enter_submit",
                     "text": {"tag": "plain_text", "content": "Enter ↵"},
                     "type": "primary",
                     "action_type": "form_submit",
@@ -290,6 +308,7 @@ def _build_menu_button_row(session_name: Optional[str] = None, disconnected: boo
                 "width": "auto",
                 "elements": [{
                     "tag": "button",
+                    "name": "enter_submit",
                     "text": {"tag": "plain_text", "content": "Enter ↵"},
                     "type": "primary",
                     "action_type": "form_submit",
@@ -312,6 +331,7 @@ def _build_menu_button_row(session_name: Optional[str] = None, disconnected: boo
         ("Ctrl+O", {"action": "send_key", "key": "ctrl_o"}),
         ("Shift+Tab", {"action": "send_key", "key": "shift_tab"}),
         ("ESC", {"action": "send_key", "key": "esc"}),
+        ("(↹)×3", {"action": "send_key", "key": "shift_tab", "times": 3}),
     ]
 
     def _make_key_column(label, value):
@@ -722,10 +742,7 @@ def build_stream_card(
     return {
         "schema": "2.0",
         "config": {"wide_screen_mode": True, "enable_forward": True},
-        "header": {
-            "title": {"tag": "plain_text", "content": title},
-            "template": template,
-        },
+        "header": _build_header(title, template),
         "body": {"elements": elements},
     }
 
@@ -851,10 +868,7 @@ def build_status_card(connected: bool, session_name: Optional[str] = None) -> Di
     return {
         "schema": "2.0",
         "config": {"wide_screen_mode": True},
-        "header": {
-            "title": {"tag": "plain_text", "content": title},
-            "template": template,
-        },
+        "header": _build_header(title, template),
         "body": {"elements": [
             {"tag": "markdown", "content": content},
             {"tag": "hr"},
@@ -871,7 +885,7 @@ def _dir_session_name(path: str) -> str:
     return name or "session"
 
 
-def build_dir_card(target, entries: List[Dict], sessions: List[Dict], tree: bool = False, session_groups: Optional[Dict[str, str]] = None) -> Dict[str, Any]:
+def build_dir_card(target, entries: List[Dict], sessions: List[Dict], tree: bool = False, session_groups: Optional[Dict[str, str]] = None, page: int = 0) -> Dict[str, Any]:
     """构建目录浏览卡片
 
     顶层目录（depth==0）带两个操作按钮：
@@ -906,9 +920,17 @@ def build_dir_card(target, entries: List[Dict], sessions: List[Dict], tree: bool
         })
         elements.append({"tag": "hr"})
 
-    cap = 20
+    PER_PAGE = 12
     total = len(entries)
-    shown = entries[:cap]
+    if tree:
+        # tree 模式不分页，直接展示全部（已有 max_items 上限）
+        shown = entries
+        page = 0
+        total_pages = 1
+    else:
+        total_pages = max(1, (total + PER_PAGE - 1) // PER_PAGE)
+        page = max(0, min(page, total_pages - 1))
+        shown = entries[page * PER_PAGE : (page + 1) * PER_PAGE]
 
     for entry in shown:
         name = entry["name"]
@@ -920,6 +942,22 @@ def build_dir_card(target, entries: List[Dict], sessions: List[Dict], tree: bool
 
         if is_dir and depth == 0:
             auto_session = _dir_session_name(full_path)
+            group_btn = {
+                "tag": "button",
+                "text": {"tag": "plain_text", "content": "进入群聊" if (session_groups and auto_session in session_groups) else "创建群聊"},
+                "type": "default",
+                "behaviors": [{"type": "open_url",
+                               "default_url": f"https://applink.feishu.cn/client/chat/open?openChatId={session_groups[auto_session]}",
+                               "android_url": f"https://applink.feishu.cn/client/chat/open?openChatId={session_groups[auto_session]}",
+                               "ios_url": f"https://applink.feishu.cn/client/chat/open?openChatId={session_groups[auto_session]}",
+                               "pc_url": f"https://applink.feishu.cn/client/chat/open?openChatId={session_groups[auto_session]}"}]
+                if (session_groups and auto_session in session_groups) else
+                [{"type": "callback", "value": {
+                    "action": "dir_new_group",
+                    "path": full_path,
+                    "session_name": auto_session
+                }}]
+            }
             elements.append({
                 "tag": "column_set",
                 "flex_mode": "none",
@@ -927,65 +965,77 @@ def build_dir_card(target, entries: List[Dict], sessions: List[Dict], tree: bool
                     {
                         "tag": "column",
                         "width": "weighted",
-                        "weight": 3,
-                        "elements": [{"tag": "markdown", "content": f"{icon} **{name}**"}]
-                    },
-                    {
-                        "tag": "column",
-                        "width": "weighted",
-                        "weight": 2,
+                        "weight": 4,
                         "elements": [{
-                            "tag": "button",
-                            "text": {"tag": "plain_text", "content": "📂 进入"},
-                            "type": "default",
+                            "tag": "interactive_container",
+                            "width": "fill",
+                            "height": "auto",
                             "behaviors": [{"type": "callback", "value": {
                                 "action": "dir_browse", "path": full_path
-                            }}]
+                            }}],
+                            "elements": [{"tag": "markdown", "content": f"📁 **{name}**"}]
                         }]
                     },
                     {
                         "tag": "column",
                         "width": "weighted",
                         "weight": 2,
-                        "elements": [{
-                            "tag": "button",
-                            "text": {"tag": "plain_text", "content": "🚀 在此启动"},
-                            "type": "primary",
-                            "behaviors": [{"type": "callback", "value": {
-                                "action": "dir_start",
-                                "path": full_path,
-                                "session_name": auto_session
-                            }}]
-                        }]
-                    },
-                    {
-                        "tag": "column",
-                        "width": "weighted",
-                        "weight": 2,
-                        "elements": [{
-                            "tag": "button",
-                            "text": {"tag": "plain_text", "content": "进入群聊" if (session_groups and auto_session in session_groups) else "创建群聊"},
-                            "type": "default",
-                            "behaviors": [{"type": "open_url",
-                                           "default_url": f"https://applink.feishu.cn/client/chat/open?openChatId={session_groups[auto_session]}",
-                                           "android_url": f"https://applink.feishu.cn/client/chat/open?openChatId={session_groups[auto_session]}",
-                                           "ios_url": f"https://applink.feishu.cn/client/chat/open?openChatId={session_groups[auto_session]}",
-                                           "pc_url": f"https://applink.feishu.cn/client/chat/open?openChatId={session_groups[auto_session]}"}]
-                            if (session_groups and auto_session in session_groups) else
-                            [{"type": "callback", "value": {
-                                "action": "dir_new_group",
-                                "path": full_path,
-                                "session_name": auto_session
-                            }}]
-                        }]
+                        "elements": [
+                            {
+                                "tag": "button",
+                                "text": {"tag": "plain_text", "content": "Claude"},
+                                "type": "primary",
+                                "behaviors": [{"type": "callback", "value": {
+                                    "action": "dir_start",
+                                    "path": full_path,
+                                    "session_name": auto_session
+                                }}]
+                            },
+                            group_btn
+                        ]
                     }
                 ]
             })
+            elements.append({"tag": "hr"})
         else:
             elements.append({"tag": "markdown", "content": f"{indent}{icon} {name}"})
 
-    if total > cap:
-        elements.append({"tag": "markdown", "content": f"*...（共 {total} 项，仅显示前 {cap} 项）*"})
+    if not tree and total > PER_PAGE:
+        page_cols = []
+        if page > 0:
+            page_cols.append({
+                "tag": "column",
+                "width": "auto",
+                "elements": [{
+                    "tag": "button",
+                    "text": {"tag": "plain_text", "content": "⬅️ 上一页"},
+                    "type": "default",
+                    "behaviors": [{"type": "callback", "value": {
+                        "action": "dir_page", "path": target_str, "page": page - 1
+                    }}]
+                }]
+            })
+        page_cols.append({
+            "tag": "column",
+            "width": "weighted",
+            "weight": 2,
+            "vertical_align": "center",
+            "elements": [{"tag": "markdown", "content": f"第 {page + 1}/{total_pages} 页"}]
+        })
+        if page < total_pages - 1:
+            page_cols.append({
+                "tag": "column",
+                "width": "auto",
+                "elements": [{
+                    "tag": "button",
+                    "text": {"tag": "plain_text", "content": "下一页 ➡️"},
+                    "type": "default",
+                    "behaviors": [{"type": "callback", "value": {
+                        "action": "dir_page", "path": target_str, "page": page + 1
+                    }}]
+                }]
+            })
+        elements.append({"tag": "column_set", "flex_mode": "none", "columns": page_cols})
 
     elements.append({"tag": "hr"})
     elements.append(_build_menu_button_only())
@@ -993,7 +1043,7 @@ def build_dir_card(target, entries: List[Dict], sessions: List[Dict], tree: bool
     return {
         "schema": "2.0",
         "config": {"wide_screen_mode": True},
-        "header": {"title": {"tag": "plain_text", "content": title}, "template": "blue"},
+        "header": _build_header(title, "blue"),
         "body": {"elements": elements}
     }
 
@@ -1025,10 +1075,7 @@ def build_help_card() -> Dict[str, Any]:
     return {
         "schema": "2.0",
         "config": {"wide_screen_mode": True},
-        "header": {
-            "title": {"tag": "plain_text", "content": "📖 Remote Claude 帮助"},
-            "template": "blue",
-        },
+        "header": _build_header("📖 Remote Claude 帮助", "blue"),
         "body": {"elements": [
             {"tag": "markdown", "content": help_content},
             {"tag": "hr"},
@@ -1042,10 +1089,7 @@ def build_session_closed_card(session_name: str) -> Dict[str, Any]:
     return {
         "schema": "2.0",
         "config": {"wide_screen_mode": True},
-        "header": {
-            "title": {"tag": "plain_text", "content": "🔴 会话已关闭"},
-            "template": "red",
-        },
+        "header": _build_header("🔴 会话已关闭", "red"),
         "body": {"elements": [
             {"tag": "markdown", "content": f"会话 **{session_name}** 已关闭，连接已自动断开。\n\n如需继续，请重新启动会话或连接到其他会话。"},
             {"tag": "hr"},
@@ -1093,17 +1137,6 @@ def build_menu_card(sessions: List[Dict], current_session: Optional[str] = None,
         "tag": "column_set",
         "flex_mode": "none",
         "columns": [
-            {
-                "tag": "column",
-                "width": "weighted",
-                "weight": 1,
-                "elements": [{
-                    "tag": "button",
-                    "text": {"tag": "plain_text", "content": "📖 帮助"},
-                    "type": "default",
-                    "behaviors": [{"type": "callback", "value": {"action": "menu_help"}}]
-                }]
-            },
             {
                 "tag": "column",
                 "width": "weighted",
@@ -1132,9 +1165,6 @@ def build_menu_card(sessions: List[Dict], current_session: Optional[str] = None,
     return {
         "schema": "2.0",
         "config": {"wide_screen_mode": True},
-        "header": {
-            "title": {"tag": "plain_text", "content": "⚡ 快捷操作"},
-            "template": "turquoise",
-        },
+        "header": _build_header("⚡ 快捷操作", "turquoise"),
         "body": {"elements": elements}
     }

package/lark_client/card_service.py

@@ -22,6 +22,23 @@ from lark_oapi.api.cardkit.v1 import (
 
 from . import config
 
+
+def _is_element_limit_error(msg: str) -> bool:
+    """判断飞书 API 返回的错误是否为元素超限"""
+    if not msg:
+        return False
+    lower = msg.lower()
+    return "element exceeds" in lower or "超限" in lower
+
+
+class _ElementLimitResult:
+    """元素超限的哨兵返回值，__bool__ 为 False 兼容现有 if not success 逻辑"""
+    is_element_limit = True
+
+    def __bool__(self):
+        return False
+
+
 import sys as _sys
 _sys.path.insert(0, str(__import__('pathlib').Path(__file__).parent.parent))
 try:
@@ -193,6 +210,10 @@ class CardService:
                     return True
                 else:
                     logger.warning(f"更新卡片失败(attempt={attempt+1}): card_id={card_id} seq={sequence} code={response.code} msg={response.msg}")
+                    if _is_element_limit_error(response.msg):
+                        # 元素超限是内容问题，重试无意义，直接返回哨兵值
+                        logger.warning(f"检测到元素超限错误，跳过重试: card_id={card_id}")
+                        return _ElementLimitResult()
             except Exception as e:
                 logger.error(f"更新卡片异常(attempt={attempt+1}): card_id={card_id} seq={sequence} error={e}")
 

package/lark_client/lark_handler.py

@@ -531,7 +531,7 @@ class LarkHandler:
         await self._send_or_update_card(chat_id, card, message_id)
 
     async def _cmd_ls(self, user_id: str, chat_id: str, args: str,
-                       tree: bool = False, message_id: Optional[str] = None):
+                       tree: bool = False, message_id: Optional[str] = None, page: int = 0):
         """查看目录文件结构"""
         all_sessions = list_active_sessions()
         sessions_info = []
@@ -571,7 +571,7 @@ class LarkHandler:
             return
 
         session_groups = {sname: cid for cid, sname in self._chat_bindings.items() if cid.startswith("oc_")}
-        card = build_dir_card(target, entries, sessions_info, tree=tree, session_groups=session_groups)
+        card = build_dir_card(target, entries, sessions_info, tree=tree, session_groups=session_groups, page=page)
         await self._send_or_update_card(chat_id, card, message_id)
 
     async def _cmd_new_group(self, user_id: str, chat_id: str, args: str,
@@ -854,7 +854,7 @@ class LarkHandler:
                 })
         except PermissionError:
             pass
-        return entries[:30]
+        return entries
 
     @staticmethod
     def _collect_tree_entries(target, max_depth: int = 2, max_items: int = 60) -> list:

package/lark_client/main.py

@@ -176,6 +176,14 @@ def handle_card_action(event: P2CardActionTrigger) -> P2CardActionTriggerRespons
             asyncio.create_task(handler._cmd_ls(user_id, chat_id, path, message_id=message_id))
             return None
 
+        # 目录卡片：翻页
+        if action_type == "dir_page":
+            path = action_value.get("path", "")
+            page = int(action_value.get("page", 0))
+            print(f"[Lark] dir_page: path={path}, page={page}")
+            asyncio.create_task(handler._cmd_ls(user_id, chat_id, path, message_id=message_id, page=page))
+            return None
+
         # 目录卡片：在该目录创建新 Claude 会话
         if action_type == "dir_start":
             path = action_value.get("path", "")
@@ -230,8 +238,13 @@ def handle_card_action(event: P2CardActionTrigger) -> P2CardActionTriggerRespons
         # 快捷键按钮（callback 模式）
         if action_type == "send_key":
             key_name = action_value.get("key", "")
-            print(f"[Lark] send_key: key={key_name}")
-            asyncio.create_task(handler.send_raw_key(user_id, chat_id, key_name))
+            times = action_value.get("times", 1)
+            print(f"[Lark] send_key: key={key_name}" + (f" ×{times}" if times > 1 else ""))
+            async def _multi_send(k=key_name, t=times):
+                for _ in range(t):
+                    await handler.send_raw_key(user_id, chat_id, k)
+                    await asyncio.sleep(0.15)
+            asyncio.create_task(_multi_send())
             return None
 
         # 各卡片底部菜单按钮：辅助卡片就地→菜单，流式卡片降级新卡

package/lark_client/shared_memory_poller.py

@@ -247,7 +247,13 @@ class SharedMemoryPoller:
                 card_content=card_dict,
             )
 
-            if not success:
+            if getattr(success, 'is_element_limit', False):
+                # 元素超限：冻结旧卡 + 推新流式卡
+                await self._handle_element_limit(
+                    tracker, blocks, status_line, bottom_bar, agent_panel, option_block
+                )
+                return
+            elif not success:
                 # 降级：创建新卡片替代
                 logger.warning(
                     f"update_card 失败 card_id={active.card_id} seq={active.sequence}，降级为新卡片"
@@ -305,6 +311,48 @@ class SharedMemoryPoller:
         else:
             logger.warning(f"create_card 失败 session={tracker.session_name}")
 
+    async def _handle_element_limit(
+        self, tracker: StreamTracker, blocks: List[dict],
+        status_line: Optional[dict], bottom_bar: Optional[dict],
+        agent_panel: Optional[dict] = None,
+        option_block: Optional[dict] = None,
+    ) -> None:
+        """元素超限：冻结旧卡片 + 推送新流式卡片"""
+        active = tracker.cards[-1]
+        logger.warning(f"元素超限，冻结卡片 {active.card_id} 并推新卡")
+
+        # 1. 冻结旧卡片（灰色 header，无状态区和按钮）
+        from .card_builder import build_stream_card
+        blocks_slice = blocks[active.start_idx:]
+        frozen_card = build_stream_card(blocks_slice, None, None, is_frozen=True)
+        active.sequence += 1
+        await self._card_service.update_card(active.card_id, active.sequence, frozen_card)
+        active.frozen = True
+        _track_stats('card', 'freeze', session_name=tracker.session_name,
+                     chat_id=tracker.chat_id)
+
+        # 2. 创建新流式卡片，从最近 INITIAL_WINDOW 个 blocks 开始（重置窗口）
+        new_start = max(0, len(blocks) - INITIAL_WINDOW)
+        new_blocks = blocks[new_start:]
+        if not new_blocks and not status_line and not bottom_bar:
+            return
+        new_card_dict = build_stream_card(
+            new_blocks, status_line, bottom_bar,
+            agent_panel=agent_panel, option_block=option_block,
+            session_name=tracker.session_name,
+        )
+        new_card_id = await self._card_service.create_card(new_card_dict)
+        if new_card_id:
+            await self._card_service.send_card(tracker.chat_id, new_card_id)
+            tracker.cards.append(CardSlice(card_id=new_card_id, start_idx=new_start))
+            tracker.content_hash = self._compute_hash(new_blocks, status_line, bottom_bar, agent_panel, option_block)
+            _track_stats('card', 'create', session_name=tracker.session_name,
+                         chat_id=tracker.chat_id)
+            logger.info(
+                f"[ELEMENT_LIMIT_SPLIT] session={tracker.session_name} "
+                f"new_start={new_start} blocks={len(new_blocks)} card_id={new_card_id}"
+            )
+
     async def _freeze_and_split(
         self, tracker: StreamTracker, blocks: List[dict],
         status_line: Optional[dict], bottom_bar: Optional[dict],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-claude",
-  "version": "0.1.7",
+  "version": "0.2.1",
   "description": "双端共享 Claude CLI 工具",
   "bin": {
     "remote-claude": "bin/remote-claude",
@@ -26,13 +26,22 @@
     "uv.lock",
     ".env.example"
   ],
-  "os": ["darwin", "linux"],
+  "os": [
+    "darwin",
+    "linux"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/yuyangzi/remote_claude.git"
   },
-  "keywords": ["claude", "cli", "terminal", "pty", "lark"],
+  "keywords": [
+    "claude",
+    "cli",
+    "terminal",
+    "pty",
+    "lark"
+  ],
   "engines": {
     "node": ">=16"
   },