remote-claude 0.1.4 → 0.1.6

package/README.md

@@ -23,7 +23,19 @@ Claude Code 只能在启动它的那个终端窗口里操作。一旦离开电
 
 ## 快速开始
 
-### 1. 克隆并初始化
+### 1. 安装
+
+以下安装方式2选1, 安装后重启shell生效
+
+#### 1.1 npm安装
+
+```bash
+npm install remote-claude
+```
+
+需要安装uv、tmux等依赖，第一次可能有点慢.
+
+#### 1.2 或 源码安装
 
 ```bash
 git clone https://github.com/yyzybb537/remote_claude.git
@@ -39,8 +51,9 @@ cd remote_claude
 |------|------|
 | `cla` | 启动 Claude (以当前目录路径为会话名) |
 | `cl` | 同 `cla`，但跳过权限确认 |
+| `remote-claude` | 管理工具（一般不用）|
 
-### 3. 从其他终端连接(一般不需要)
+### 3. 从其他终端连接(比较少用)
 
 ```bash
 remote-claude list
@@ -52,9 +65,9 @@ remote-claude attach <会话名>
 #### 4.1 配置飞书机器人
 
 1. 登录[飞书开放平台](https://open.feishu.cn/)，创建企业自建应用
-2. 执行命令`cp .env.example .env`, 获取 **App ID** 和 **App Secret**，填入 `.env` 文件
-3. 用`cla`或`cl`启动一次claude（会附带启动飞书客户端，如果之前已经启动过，需要重启飞书客户端: "remote-claude lark restart" ） 
-4. 企业自建应用页面`添加应用能力`（机器人能力）
+2. 获取 **App ID** 和 **App Secret**
+3. 用`cla`或`cl`启动一次claude, 按照交互提示填入**App ID** 和 **App Secret**
+4. [飞书开放平台]的企业自建应用页面`添加应用能力`（机器人能力）
 5. 企业自建应用页面配置事件回调（如果第3步没启动成功这里配置不了）：
   - `事件与回调` -> `事件配置` -> `订阅方式`右边的笔图标 -> `选择：使用长连接接收事件` -> `点击保存` -> `下面添加事件: 接收消息 v2.0 (im.message.receive_v1)`
   - `事件与回调` -> `回调配置` -> `订阅方式`右边的笔图标 -> `选择：使用长连接接收回调` -> `点击保存` -> `下面添加回调: 卡片回传交互 (card.action.trigger)`
@@ -187,7 +200,6 @@ remote-claude attach <会话名>
 
 1. 从飞书搜素刚刚创建的飞书机器人（第一次搜比较慢，如果搜不到可能是忘记发布了）
 2. 飞书中与机器人对话，可用命令: 
-  - `/help` 展示可用命令
   - `/menu` 展示菜单卡片，后续操作都操作这个卡片上的按钮即可
 
 ## 使用指南
@@ -199,7 +211,7 @@ remote-claude attach <会话名>
 | `cla` | 启动飞书客户端 + 以当前目录路径为会话名启动 Claude |
 | `cl` | 同 `cla`，但跳过权限确认 |
 
-### 终端命令
+### 管理命令 (一般不需要)
 
 ```bash
 remote-claude start <会话名>     # 启动新会话

package/bin/remote-claude

@@ -13,6 +13,31 @@ if ! command -v uv &>/dev/null; then
     [ -f "$HOME/.local/bin/uv" ] && export PATH="$HOME/.local/bin:$PATH"
 fi
 
+# log 子命令：查看最后启动的 session 日志
+if [ "$1" = "log" ]; then
+    LOG_DIR="/tmp/remote-claude"
+    if [ -n "$2" ]; then
+        # 指定 session 名，/ 和 . 替换为 _（与 _safe_filename 一致）
+        SESSION_SAFE=$(echo "$2" | tr '/.' '__')
+        LOG_FILE="$LOG_DIR/${SESSION_SAFE}_messages.log"
+    else
+        # 找最后启动的 session（最新的 session .pid 文件，排除 lark.pid）
+        LATEST_PID=$(ls -t "$LOG_DIR"/_*.pid 2>/dev/null | head -1)
+        if [ -n "$LATEST_PID" ]; then
+            SESSION_SAFE=$(basename "$LATEST_PID" .pid)
+            LOG_FILE="$LOG_DIR/${SESSION_SAFE}_messages.log"
+        fi
+    fi
+
+    if [ -z "$LOG_FILE" ] || [ ! -f "$LOG_FILE" ]; then
+        echo "没有找到日志文件（请先启动一个会话）" >&2
+        exit 1
+    fi
+
+    echo "📄 $LOG_FILE"
+    exec tail -50f "$LOG_FILE"
+fi
+
 # lark 子命令：检查 .env 配置
 if [ "$1" = "lark" ]; then
     source "$INSTALL_DIR/scripts/check-env.sh" "$INSTALL_DIR"

package/lark_client/card_builder.py

@@ -522,6 +522,22 @@ def _render_block_colored(block_dict: dict) -> Optional[str]:
     return None
 
 
+def _render_plan_block(block_dict: dict) -> Optional[Dict[str, Any]]:
+    """将 PlanBlock 渲染为飞书 collapsible_panel element"""
+    content = block_dict.get("content", "")
+    if not content:
+        return None
+    title = block_dict.get("title", "计划")
+    ansi_content = block_dict.get("ansi_content", "")
+    content_md = _ansi_to_lark_md(ansi_content) if ansi_content else _escape_md(content)
+    return {
+        "tag": "collapsible_panel",
+        "expanded": True,
+        "header": {"title": {"tag": "plain_text", "content": f"📋 {title}"}},
+        "elements": [{"tag": "markdown", "content": content_md}],
+    }
+
+
 def _determine_header(
     blocks: List[dict],
     status_line: Optional[dict],
@@ -609,6 +625,13 @@ def build_stream_card(
     has_content = False
 
     for block_dict in blocks:
+        typ = block_dict.get("_type", "")
+        if typ == "PlanBlock":
+            plan_el = _render_plan_block(block_dict)
+            if plan_el:
+                has_content = True
+                elements.append(plan_el)
+            continue
         rendered = _render_block_colored(block_dict)
         if rendered:
             has_content = True

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remote-claude",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "双端共享 Claude CLI 工具",
   "bin": {
     "remote-claude": "bin/remote-claude",

package/remote_claude.py

@@ -30,7 +30,8 @@ from utils.session import (
     list_active_sessions, is_session_active, cleanup_session,
     is_lark_running, get_lark_pid, get_lark_status, get_lark_pid_file,
     save_lark_status, cleanup_lark,
-    USER_DATA_DIR, ensure_user_data_dir, get_lark_log_file
+    USER_DATA_DIR, ensure_user_data_dir, get_lark_log_file,
+    get_env_snapshot_path
 )
 
 
@@ -56,6 +57,15 @@ def cmd_start(args):
 
     ensure_socket_dir()
 
+    # 将当前 shell 的完整环境变量保存到快照文件（权限 0600 防止密钥泄露）
+    # tmux new-session 继承的是 tmux 服务器的全局环境，而非调用方 shell 的环境，
+    # 通过快照文件将完整环境传递给 server.py 的 _start_pty()
+    import json
+    env_snapshot_path = get_env_snapshot_path(session_name)
+    env_fd = os.open(str(env_snapshot_path), os.O_WRONLY | os.O_CREAT | os.O_TRUNC, 0o600)
+    with os.fdopen(env_fd, 'w') as f:
+        json.dump(dict(os.environ), f)
+
     # 构建 server 命令
     server_script = SCRIPT_DIR / "server" / "server.py"
     claude_args = args.claude_args if args.claude_args else []

package/scripts/check-env.sh

@@ -21,6 +21,8 @@ if [ "$ENV_OK" = false ]; then
     echo "飞书客户端尚未配置，需要填写应用凭证。"
     echo "（在飞书开发者后台创建应用获取: https://open.feishu.cn/app）"
     echo ""
+    echo -e "\033[33m飞书机器人配置文档参考：https://github.com/yyzybb537/remote_claude\033[0m"
+    echo ""
     read -p "FEISHU_APP_ID: " INPUT_APP_ID
     read -p "FEISHU_APP_SECRET: " INPUT_APP_SECRET
 
@@ -36,6 +38,6 @@ if [ "$ENV_OK" = false ]; then
 
     echo ""
     echo "配置已保存到 $ENV_FILE"
-    echo "（可选配置如 BOT_NAME、白名单等可稍后编辑该文件）"
+    echo "（可选配置, 如"白名单"等可稍后编辑该文件）"
     echo ""
 fi

package/server/component_parser.py

@@ -40,6 +40,65 @@ BOX_CORNER_TOP: Set[str] = {'╭', '┌'}
 BOX_CORNER_BOTTOM: Set[str] = {'╰', '└'}
 BOX_VERTICAL: Set[str] = {'│', '┃', '║'}
 
+# OutputBlock 内嵌框线清理（纯文本版，用于 content 检测）
+_INLINE_BOX_TOP_RE = re.compile(r'^\s*[╭┌][─━═╌]+[╮┐]\s*$')
+_INLINE_BOX_BOTTOM_RE = re.compile(r'^\s*[╰└][─━═╌]+[╯┘]\s*$')
+_INLINE_BOX_LEFT_RE = re.compile(r'^(\s*)[│┃║] ?')
+_INLINE_BOX_RIGHT_RE = re.compile(r'\s*[│┃║]\s*$')
+
+# ANSI 版（用于 ansi_content 清理）
+_A = r'(?:\x1b\[[\d;]*m)*'
+_ANSI_BOX_LEFT_RE = re.compile(rf'^({_A}\s*){_A}[│┃║]{_A} ?')
+_ANSI_BOX_RIGHT_RE = re.compile(rf'\s*{_A}[│┃║]{_A}\s*$')
+
+
+def _strip_inline_boxes_pair(content: str, ansi_content: str) -> tuple:
+    """去除 OutputBlock 内嵌的 box-drawing 框线，同步清理 content 和 ansi_content。
+
+    仅在检测到完整 box（顶边框 + 底边框配对）时才去除，防止误伤普通 │ 内容。
+    返回 (cleaned_content, cleaned_ansi_content)。
+    """
+    lines = content.split('\n')
+    top_stack: list = []
+    box_ranges: list = []
+    for i, line in enumerate(lines):
+        if _INLINE_BOX_TOP_RE.match(line):
+            top_stack.append(i)
+        elif _INLINE_BOX_BOTTOM_RE.match(line) and top_stack:
+            top_idx = top_stack.pop()
+            box_ranges.append((top_idx, i))
+
+    if not box_ranges:
+        return content, ansi_content
+
+    ansi_lines = ansi_content.split('\n')
+    if len(ansi_lines) != len(lines):
+        return content, ansi_content
+
+    remove_lines: set = set()
+    side_lines: set = set()
+    for top_idx, bottom_idx in box_ranges:
+        remove_lines.add(top_idx)
+        remove_lines.add(bottom_idx)
+        for j in range(top_idx + 1, bottom_idx):
+            side_lines.add(j)
+
+    result_content = []
+    result_ansi = []
+    for i, (line, aline) in enumerate(zip(lines, ansi_lines)):
+        if i in remove_lines:
+            continue
+        if i in side_lines:
+            line = _INLINE_BOX_LEFT_RE.sub(r'\1', line)
+            line = _INLINE_BOX_RIGHT_RE.sub('', line)
+            aline = _ANSI_BOX_LEFT_RE.sub(r'\1', aline)
+            aline = _ANSI_BOX_RIGHT_RE.sub('', aline)
+        result_content.append(line)
+        result_ansi.append(aline)
+
+    return '\n'.join(result_content), '\n'.join(result_ansi)
+
+
 # 编号选项行正则（权限确认对话框特征：❯ 1. Yes / 2. No 等）
 _NUMBERED_OPTION_RE = re.compile(r'^(?:❯\s*)?\d+[.)]\s+.+')
 # 带 ❯ 光标的编号选项行正则（锚点）
@@ -454,10 +513,27 @@ class ScreenParser:
         return output_rows, input_rows, bottom_rows
 
     def _trim_welcome(self, screen: pyte.Screen, rows: List[int]) -> List[int]:
-        """去掉欢迎区域：跳过首列为空的前缀行，从第一个首列有内容的行开始"""
-        for i, row in enumerate(rows):
-            if _get_col0(screen, row).strip():
-                return rows[i:]
+        """去掉欢迎区域：跳过首列为空的前缀行和欢迎框（Claude Code box）"""
+        i = 0
+        while i < len(rows):
+            col0 = _get_col0(screen, rows[i])
+            if not col0.strip():
+                i += 1
+                continue
+            # 首个非空 col0 是 box 顶角 → 检查是否为欢迎框
+            if col0 in BOX_CORNER_TOP:
+                first_line = _get_row_text(screen, rows[i])
+                if 'Claude Code' in first_line:
+                    # 跳过整个欢迎框（到 ╰/└ 行为止）
+                    i += 1
+                    while i < len(rows):
+                        if _get_col0(screen, rows[i]) in BOX_CORNER_BOTTOM:
+                            i += 1
+                            break
+                        i += 1
+                    continue  # 继续跳过后续空行
+            # 非欢迎框，返回剩余行
+            return rows[i:]
         return []
 
     # ─── Step 2+3+4：输出区解析 ────────────────────────────────────────────
@@ -552,6 +628,7 @@ class ScreenParser:
             content = '\n'.join([first_content] + body_lines).rstrip()
             ansi_body_lines = [_get_row_ansi_text(screen, r) for r in block_rows[1:]]
             ansi_content = '\n'.join([cached_ansi_first] + ansi_body_lines).rstrip()
+            content, ansi_content = _strip_inline_boxes_pair(content, ansi_content)
             return OutputBlock(
                 content=content, is_streaming=cached_blink, start_row=first_row,
                 ansi_content=ansi_content, indicator=cached_ind, ansi_indicator=cached_ansi_ind,
@@ -602,6 +679,7 @@ class ScreenParser:
             body_lines = lines[1:]
             content = '\n'.join([first_content] + body_lines).rstrip()
             ansi_content = '\n'.join([ansi_first] + ansi_body).rstrip()
+            content, ansi_content = _strip_inline_boxes_pair(content, ansi_content)
             return OutputBlock(
                 content=content, is_streaming=is_blink, start_row=first_row,
                 ansi_content=ansi_content, indicator=ind, ansi_indicator=ansi_ind,
@@ -629,6 +707,8 @@ class ScreenParser:
                     inner = stripped[:-1]
                 content_lines.append(inner.rstrip())
                 ansi_line = _get_row_ansi_text(screen, row, start_col=1)
+                # 去掉右侧 │（可能包裹 ANSI 码，如 │\x1b[0m 或 \x1b[...m│\x1b[0m）
+                ansi_line = re.sub(r'(\x1b\[[0-9;]*m)*[│┃║](\x1b\[0m)?\s*$', '', ansi_line)
                 ansi_lines.append(ansi_line.rstrip())
 
         content = '\n'.join(content_lines).strip()

package/server/server.py

@@ -119,6 +119,17 @@ class OutputWatcher:
         self.last_window: Optional[ClaudeWindow] = None
         # PTY 静止后延迟重刷：消除窗口平滑的延迟效应
         self._reflush_handle: Optional[asyncio.TimerHandle] = None
+        # 调试日志截断长度（可通过 ~/.remote-claude/.debug_config 配置）
+        self._debug_truncate_len = 80
+        try:
+            cfg_path = os.path.expanduser("~/.remote-claude/.debug_config")
+            if os.path.exists(cfg_path):
+                import json as _json
+                with open(cfg_path) as _f:
+                    _cfg = _json.load(_f)
+                self._debug_truncate_len = int(_cfg.get("debug_truncate_len", 80))
+        except Exception:
+            pass
 
     def resize(self, cols: int, rows: int):
         """重建 renderer 以适应新尺寸，历史随之丢失（可接受）。
@@ -403,7 +414,7 @@ class OutputWatcher:
                         else:
                             lines.append(f"[{i}] UserInput: {block.text[:80]}")
                 else:
-                    lines.append(f"[{i}] {type(block).__name__}: {str(block)[:80]}")
+                    lines.append(f"[{i}] {type(block).__name__}: {str(block)[:self._debug_truncate_len]}")
             lines.append("")
             lines.append("-----")
             with open(self._debug_file, "w", encoding="utf-8") as f:
@@ -595,9 +606,32 @@ class ProxyServer:
 
     def _start_pty(self):
         """启动 PTY 并运行 Claude"""
-        pid, fd = pty.fork()
+        # 加载环境变量快照（从 cmd_start 保存的快照文件恢复调用方 shell 的完整环境）
+        from utils.session import get_env_snapshot_path
+        import json as _json
+        env_snapshot_path = get_env_snapshot_path(self.session_name)
+        _extra_env = {}
+        try:
+            with open(env_snapshot_path) as _f:
+                _extra_env = _json.load(_f)
+        except Exception:
+            pass
+
+        try:
+            pid, fd = pty.fork()
+        except OSError:
+            env_snapshot_path.unlink(missing_ok=True)
+            raise
 
         if pid == 0:
+            # 子进程：恢复调用方 shell 的完整环境变量
+            for k, v in _extra_env.items():
+                os.environ[k] = v
+            # 环境已加载到内存，立即删除快照文件（execvp 前销毁）
+            try:
+                env_snapshot_path.unlink()
+            except Exception:
+                pass
             # 恢复 TERM 以支持 kitty keyboard protocol（Shift+Enter 等扩展键）
             # tmux 会将 TERM 改为 tmux-256color，导致 Claude CLI 不启用 kitty protocol
             os.environ['TERM'] = 'xterm-256color'
@@ -605,6 +639,7 @@ class ProxyServer:
             for key in ('TMUX', 'TMUX_PANE'):
                 os.environ.pop(key, None)
             os.execvp("claude", ["claude"] + self.claude_args)
+            os._exit(1)  # execvp 失败时兜底退出
         else:
             # 父进程
             self.master_fd = fd

package/utils/session.py

@@ -60,6 +60,11 @@ def get_mq_path(session_name: str) -> Path:
     return SOCKET_DIR / f"{_safe_filename(session_name)}.mq"
 
 
+def get_env_snapshot_path(session_name: str) -> Path:
+    """获取环境变量快照文件路径（cmd_start 写入，_start_pty 读取后删除）"""
+    return SOCKET_DIR / f"{_safe_filename(session_name)}_env.json"
+
+
 def ensure_socket_dir():
     """确保 socket 目录存在"""
     SOCKET_DIR.mkdir(parents=True, exist_ok=True)
@@ -248,6 +253,7 @@ def cleanup_session(session_name: str):
     sock_path.unlink(missing_ok=True)
     pid_file.unlink(missing_ok=True)
     get_mq_path(session_name).unlink(missing_ok=True)
+    get_env_snapshot_path(session_name).unlink(missing_ok=True)
 
 
 def is_session_active(session_name: str) -> bool: