remote-claude 1.0.3 → 1.0.5

package/.env.example

@@ -18,6 +18,10 @@ ALLOWED_USERS=ou_xxxxx,ou_yyyyy
 # 支持多词命令，如：ccr code、/usr/local/bin/claude
 # CLAUDE_COMMAND=claude
 
+# Codex CLI 命令（可选，默认 codex）
+# 支持多词命令，如：/usr/local/bin/codex
+# CODEX_COMMAND=codex
+
 # 流式卡片配置（可选）
 # 单张卡片最多显示的 block 数量，超限自动冻结并创建新卡片（默认 50）
 # MAX_CARD_BLOCKS=50

package/README.md

@@ -66,145 +66,21 @@ remote-claude attach <会话名>
 
 #### 4.1 配置飞书机器人
 
-1. 登录[飞书开放平台](https://open.feishu.cn/)，创建企业自建应用
-2. 获取 **App ID** 和 **App Secret**
-3. 用`cla`或`cl`启动一次claude(或用cx或cdx启动一次codex), 按照交互提示填入**App ID** 和 **App Secret**
-4. [飞书开放平台]的企业自建应用页面`添加应用能力`（机器人能力）
-5. 企业自建应用页面配置事件回调（如果第3步没启动成功这里配置不了）：
-  - `事件与回调` -> `事件配置` -> `订阅方式`右边的笔图标 -> `选择：使用长连接接收事件` -> `点击保存` -> `下面添加事件: 接收消息 v2.0 (im.message.receive_v1)`
-  - `事件与回调` -> `回调配置` -> `订阅方式`右边的笔图标 -> `选择：使用长连接接收回调` -> `点击保存` -> `下面添加回调: 卡片回传交互 (card.action.trigger)`
-6. 企业自建应用页面配置权限：
-  - `权限管理` -> `批量导入/导出权限` -> 导入以下内容
-```json
-{
-  "scopes": {
-    "tenant": [
-      "base:app:read",
-      "base:field:read",
-      "base:form:read",
-      "base:record:read",
-      "base:record:retrieve",
-      "base:table:read",
-      "board:whiteboard:node:read",
-      "calendar:calendar.free_busy:read",
-      "cardkit:card:write",
-      "contact:contact.base:readonly",
-      "contact:user.employee_id:readonly",
-      "contact:user.id:readonly",
-      "docs:document.comment:read",
-      "docs:document.content:read",
-      "docs:document.media:download",
-      "docs:document.media:upload",
-      "docs:document:import",
-      "docs:permission.member:auth",
-      "docs:permission.member:create",
-      "docs:permission.member:transfer",
-      "docx:document.block:convert",
-      "docx:document:create",
-      "docx:document:readonly",
-      "docx:document:write_only",
-      "drive:drive.metadata:readonly",
-      "drive:drive.search:readonly",
-      "drive:drive:version:readonly",
-      "drive:file:download",
-      "drive:file:upload",
-      "im:chat.members:read",
-      "im:chat.members:write_only",
-      "im:chat.tabs:read",
-      "im:chat.tabs:write_only",
-      "im:chat.top_notice:write_only",
-      "im:chat:create",
-      "im:chat:delete",
-      "im:chat:operate_as_owner",
-      "im:chat:read",
-      "im:chat:update",
-      "im:message.group_at_msg:readonly",
-      "im:message.group_msg",
-      "im:message.p2p_msg:readonly",
-      "im:message.reactions:read",
-      "im:message.reactions:write_only",
-      "im:message.urgent",
-      "im:message.urgent.status:write",
-      "im:message:readonly",
-      "im:message:recall",
-      "im:message:send_as_bot",
-      "im:message:update",
-      "im:resource",
-      "sheets:spreadsheet.meta:read",
-      "sheets:spreadsheet.meta:write_only",
-      "sheets:spreadsheet:create",
-      "sheets:spreadsheet:read",
-      "sheets:spreadsheet:write_only",
-      "space:document:delete",
-      "space:document:retrieve",
-      "wiki:wiki:readonly"
-    ],
-    "user": [
-      "base:app:read",
-      "base:field:read",
-      "base:record:read",
-      "base:record:retrieve",
-      "base:table:read",
-      "calendar:calendar.event:create",
-      "calendar:calendar.event:delete",
-      "calendar:calendar.event:read",
-      "calendar:calendar.event:reply",
-      "calendar:calendar.event:update",
-      "calendar:calendar.free_busy:read",
-      "calendar:calendar:read",
-      "cardkit:card:write",
-      "contact:user.base:readonly",
-      "contact:user.employee_id:readonly",
-      "contact:user.id:readonly",
-      "docs:document.comment:read",
-      "docs:document.content:read",
-      "docs:document.media:download",
-      "docs:document.media:upload",
-      "docx:document.block:convert",
-      "docx:document:create",
-      "docx:document:readonly",
-      "docx:document:write_only",
-      "im:chat.managers:write_only",
-      "im:chat.members:read",
-      "im:chat.members:write_only",
-      "im:chat.tabs:read",
-      "im:chat.tabs:write_only",
-      "im:chat.top_notice:write_only",
-      "im:chat:delete",
-      "im:chat:read",
-      "im:chat:update",
-      "im:message.reactions:read",
-      "im:message.reactions:write_only",
-      "im:message:readonly",
-      "im:message:recall",
-      "im:message:update",
-      "search:docs:read",
-      "search:suite_dataset:readonly",
-      "sheets:spreadsheet.meta:read",
-      "sheets:spreadsheet.meta:write_only",
-      "sheets:spreadsheet:create",
-      "sheets:spreadsheet:read",
-      "sheets:spreadsheet:write_only",
-      "space:document:retrieve",
-      "task:task:read",
-      "task:task:readonly",
-      "task:task:write",
-      "task:task:writeonly",
-      "task:tasklist:read",
-      "task:tasklist:writeonly",
-      "wiki:wiki:readonly"
-    ]
-  }
-}
+运行向导，按提示操作即可（约 5 分钟）：
+
+```bash
+remote-claude lark init
 ```
-7. 企业自建应用页面: `创建版本` -> `发布到线上`
-8. 至此，完成飞书机器人配置
 
-#### 4.2 通过飞书机器人操作claude/codex
+向导会自动完成：扫码创建企业自建应用、开通所需权限、配置事件回调、写入本地配置。
+
+> **⚠ 向导最后一步会自动弹出发布页面**，按提示创建版本并发布后才能生效。
+> 未发布的应用在飞书中无法被搜索到。
+
+#### 4.2 通过飞书机器人操作 claude/codex
 
-1. 从飞书搜索刚刚创建的飞书机器人（第一次搜比较慢，如果搜不到可能是忘记发布了）
-2. 飞书中与机器人对话，可用命令: 
-  - `/menu` 展示菜单卡片，后续操作都操作这个卡片上的按钮即可
+1. 从飞书搜索刚创建的机器人（应用发布后才能搜到，发布约需 1 分钟生效）
+2. 飞书中与机器人对话，发送 `/menu` 展示菜单卡片，后续操作点卡片上的按钮即可
 
 ## 使用指南
 

package/bin/cdx

@@ -16,5 +16,13 @@ fi
 # 检查飞书配置
 source "$SCRIPT_DIR/scripts/check-env.sh" "$SCRIPT_DIR"
 
+# 会话名：第一个参数非 - 开头时作为自定义名，否则用 PWD_时间戳
+if [ -n "$1" ] && [[ "$1" != -* ]]; then
+    SESSION_NAME="$1"
+    shift
+else
+    SESSION_NAME="${PWD}_$(date +%m%d_%H%M%S)"
+fi
+
 uv run --project "$SCRIPT_DIR" python3 "$SCRIPT_DIR/remote_claude.py" lark start
-uv run --project "$SCRIPT_DIR" python3 "$SCRIPT_DIR/remote_claude.py" start "${PWD}_$(date +%m%d_%H%M%S)" --cli codex -- "$@"
+uv run --project "$SCRIPT_DIR" python3 "$SCRIPT_DIR/remote_claude.py" start "$SESSION_NAME" --cli codex -- "$@"

package/bin/cl

@@ -16,5 +16,13 @@ fi
 # 检查飞书配置
 source "$SCRIPT_DIR/scripts/check-env.sh" "$SCRIPT_DIR"
 
+# 会话名：第一个参数非 - 开头时作为自定义名，否则用 PWD_时间戳
+if [ -n "$1" ] && [[ "$1" != -* ]]; then
+    SESSION_NAME="$1"
+    shift
+else
+    SESSION_NAME="${PWD}_$(date +%m%d_%H%M%S)"
+fi
+
 uv run --project "$SCRIPT_DIR" python3 "$SCRIPT_DIR/remote_claude.py" lark start
-uv run --project "$SCRIPT_DIR" python3 "$SCRIPT_DIR/remote_claude.py" start "${PWD}_$(date +%m%d_%H%M%S)" -- --dangerously-skip-permissions --permission-mode=dontAsk "$@"
+uv run --project "$SCRIPT_DIR" python3 "$SCRIPT_DIR/remote_claude.py" start "$SESSION_NAME" -- --dangerously-skip-permissions --permission-mode=dontAsk "$@"

package/bin/cla

@@ -16,5 +16,13 @@ fi
 # 检查飞书配置
 source "$SCRIPT_DIR/scripts/check-env.sh" "$SCRIPT_DIR"
 
+# 会话名：第一个参数非 - 开头时作为自定义名，否则用 PWD_时间戳
+if [ -n "$1" ] && [[ "$1" != -* ]]; then
+    SESSION_NAME="$1"
+    shift
+else
+    SESSION_NAME="${PWD}_$(date +%m%d_%H%M%S)"
+fi
+
 uv run --project "$SCRIPT_DIR" python3 "$SCRIPT_DIR/remote_claude.py" lark start
-uv run --project "$SCRIPT_DIR" python3 "$SCRIPT_DIR/remote_claude.py" start "${PWD}_$(date +%m%d_%H%M%S)" -- "$@"
+uv run --project "$SCRIPT_DIR" python3 "$SCRIPT_DIR/remote_claude.py" start "$SESSION_NAME" -- "$@"

package/bin/cx

@@ -16,5 +16,13 @@ fi
 # 检查飞书配置
 source "$SCRIPT_DIR/scripts/check-env.sh" "$SCRIPT_DIR"
 
+# 会话名：第一个参数非 - 开头时作为自定义名，否则用 PWD_时间戳
+if [ -n "$1" ] && [[ "$1" != -* ]]; then
+    SESSION_NAME="$1"
+    shift
+else
+    SESSION_NAME="${PWD}_$(date +%m%d_%H%M%S)"
+fi
+
 uv run --project "$SCRIPT_DIR" python3 "$SCRIPT_DIR/remote_claude.py" lark start
-uv run --project "$SCRIPT_DIR" python3 "$SCRIPT_DIR/remote_claude.py" start "${PWD}_$(date +%m%d_%H%M%S)" --cli codex -- --dangerously-bypass-approvals-and-sandbox "$@"
+uv run --project "$SCRIPT_DIR" python3 "$SCRIPT_DIR/remote_claude.py" start "$SESSION_NAME" --cli codex -- --dangerously-bypass-approvals-and-sandbox "$@"

package/bin/remote-claude

@@ -17,25 +17,16 @@ fi
 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"
+        # 指定 session 名，/ . 空格替换为 _（与 _log_filename 一致）
+        SESSION_LOG=$(echo "$2" | tr '/. ' '___')
+        LOG_FILE="$LOG_DIR/${SESSION_LOG}_messages.log"
     else
-        # 找最后启动的 session（按创建时间排序，排除 lark.pid）
-        if [[ "$OSTYPE" == "darwin"* ]]; then
-            # macOS: stat -f "%B" 返回创建时间（秒）
-            LATEST_PID=$(ls "$LOG_DIR"/_*.pid 2>/dev/null | while read f; do
-                stat -f "%B:%N" "$f" 2>/dev/null
-            done | sort -rn | head -1 | cut -d: -f2)
-        else
-            # Linux: stat -c "%W" 返回创建时间（秒）
-            LATEST_PID=$(ls "$LOG_DIR"/_*.pid 2>/dev/null | while read f; do
-                stat -c "%W:%N" "$f" 2>/dev/null
-            done | sort -rn | head -1 | cut -d: -f2)
-        fi
-        if [ -n "$LATEST_PID" ]; then
-            SESSION_SAFE=$(basename "$LATEST_PID" .pid)
-            LOG_FILE="$LOG_DIR/${SESSION_SAFE}_messages.log"
+        # 找最后启动的 session（按 .name 文件修改时间排序）
+        LATEST_NAME=$(ls -t "$LOG_DIR"/*.name 2>/dev/null | head -1)
+        if [ -n "$LATEST_NAME" ]; then
+            SESSION_NAME=$(cat "$LATEST_NAME" 2>/dev/null)
+            SESSION_LOG=$(echo "$SESSION_NAME" | tr '/. ' '___')
+            LOG_FILE="$LOG_DIR/${SESSION_LOG}_messages.log"
         fi
     fi
 
@@ -48,9 +39,4 @@ if [ "$1" = "log" ]; then
     exec tail -50f "$LOG_FILE"
 fi
 
-# lark 子命令：检查 .env 配置
-if [ "$1" = "lark" ]; then
-    source "$INSTALL_DIR/scripts/check-env.sh" "$INSTALL_DIR"
-fi
-
 exec uv run --project "$INSTALL_DIR" python3 "$INSTALL_DIR/remote_claude.py" "$@"

package/client/client.py

@@ -111,7 +111,7 @@ class RemoteClient:
     async def run(self):
         """运行客户端"""
         if not await self.connect():
-            return
+            raise SystemExit(1)
 
         self.running = True
         _track_stats('terminal', 'connect', session_name=self.session_name)

package/init.sh

@@ -26,6 +26,16 @@ print_error() {
     echo -e "${RED}✗${NC} $1"
 }
 
+# 非交互 sudo：有免密 sudo 则执行（带 5 分钟超时），否则跳过
+_sudo_or_skip() {
+    if sudo -n true 2>/dev/null; then
+        timeout 300 sudo "$@"
+    else
+        print_warning "sudo 需要密码，跳过: sudo $*"
+        return 1
+    fi
+}
+
 print_header() {
     echo ""
     echo -e "${GREEN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
@@ -200,96 +210,22 @@ check_tmux() {
             brew install tmux 2>/dev/null || true
         elif [[ "$OS" == "Linux" ]]; then
             if command -v apt-get &> /dev/null; then
-                sudo apt-get update && sudo apt-get install -y tmux || true
+                _sudo_or_skip apt-get update && _sudo_or_skip apt-get install -y tmux || true
             elif command -v yum &> /dev/null; then
-                sudo yum install -y tmux || true
+                _sudo_or_skip yum install -y tmux || true
             elif command -v pacman &> /dev/null; then
-                sudo pacman -Sy --noconfirm tmux || true
+                _sudo_or_skip pacman -Sy --noconfirm tmux || true
             elif command -v apk &> /dev/null; then
-                sudo apk add --no-cache tmux || true
+                _sudo_or_skip apk add --no-cache tmux || true
             elif command -v zypper &> /dev/null; then
-                sudo zypper install -y tmux || true
+                _sudo_or_skip zypper install -y tmux || true
             else
-                print_warning "无法识别包管理器，尝试从源码编译 tmux..."
-                install_tmux_from_source
-                return
+                print_warning "无法识别包管理器，请手动安装 tmux 或运行 remote-claude deps"
             fi
         fi
         print_success "tmux 安装成功"
     }
 
-    install_tmux_from_source() {
-        local TMUX_VERSION_TAG="3.6a"
-        local TMUX_URL="https://github.com/tmux/tmux/releases/download/${TMUX_VERSION_TAG}/tmux-${TMUX_VERSION_TAG}.tar.gz"
-
-        print_warning "包管理器版本不满足要求，尝试从源码编译 tmux ${TMUX_VERSION_TAG}..."
-
-        # 安装编译依赖
-        if [[ "$OS" == "Darwin" ]]; then
-            brew install libevent ncurses pkg-config bison 2>/dev/null || true
-        elif command -v apt-get &> /dev/null; then
-            sudo apt-get install -y build-essential libevent-dev libncurses5-dev libncursesw5-dev bison pkg-config || true
-        elif command -v yum &> /dev/null; then
-            sudo yum groupinstall -y "Development Tools" || true
-            sudo yum install -y libevent-devel ncurses-devel bison || true
-        fi
-
-        # 确定安装前缀
-        local PREFIX="/usr/local"
-        if ! sudo -n true 2>/dev/null; then
-            print_warning "无 sudo 权限，将安装到 \$HOME/.local"
-            PREFIX="$HOME/.local"
-        fi
-
-        # 创建临时目录，编译完成后清理
-        local TMPDIR
-        TMPDIR=$(mktemp -d)
-        trap "rm -rf '$TMPDIR'" RETURN
-
-        print_warning "下载 tmux-${TMUX_VERSION_TAG}.tar.gz..."
-        if ! curl -fsSL "$TMUX_URL" -o "$TMPDIR/tmux.tar.gz"; then
-            print_warning "下载失败，请检查网络或手动安装 tmux ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+"
-            WARNINGS+=("tmux 源码下载失败，请手动安装 tmux ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+")
-            return
-        fi
-
-        tar -xzf "$TMPDIR/tmux.tar.gz" -C "$TMPDIR"
-        local SRC_DIR
-        SRC_DIR=$(find "$TMPDIR" -maxdepth 1 -type d -name "tmux-*" | head -1)
-
-        print_warning "编译 tmux（可能需要几分钟）..."
-        if ! (cd "$SRC_DIR" && ./configure --prefix="$PREFIX" && make -j"$(nproc 2>/dev/null || echo 2)"); then
-            print_warning "编译失败，请手动安装 tmux ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+"
-            WARNINGS+=("tmux 源码编译失败，请手动安装 tmux ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+")
-            return
-        fi
-
-        if [[ "$PREFIX" == "/usr/local" ]]; then
-            sudo make -C "$SRC_DIR" install || { WARNINGS+=("tmux make install 失败，请手动安装 tmux ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+"); return; }
-        else
-            make -C "$SRC_DIR" install || { WARNINGS+=("tmux make install 失败，请手动安装 tmux ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+"); return; }
-            # 若 $HOME/.local/bin 不在 PATH 中，自动写入 shell 配置
-            if [[ ":$PATH:" != *":$HOME/.local/bin:"* ]]; then
-                export PATH="$HOME/.local/bin:$PATH"
-                local _RC
-                if [[ "$(basename "$SHELL")" == "zsh" ]]; then
-                    _RC="$HOME/.zshrc"
-                else
-                    _RC="$HOME/.bashrc"
-                fi
-                local _PATH_LINE='export PATH="$HOME/.local/bin:$PATH"'
-                if ! grep -qF "$HOME/.local/bin" "$_RC" 2>/dev/null; then
-                    echo "" >> "$_RC"
-                    echo "# remote-claude: tmux 路径" >> "$_RC"
-                    echo "$_PATH_LINE" >> "$_RC"
-                    print_success "已自动将 \$HOME/.local/bin 加入 PATH（写入 $_RC）"
-                fi
-            fi
-        fi
-
-        print_success "tmux ${TMUX_VERSION_TAG} 源码编译安装完成（前缀：${PREFIX}）"
-    }
-
     check_version() {
         # tmux -V 输出格式：tmux 3.6 或 tmux 3.4a
         local ver_str
@@ -310,30 +246,27 @@ check_tmux() {
             print_success "$TMUX_VERSION 已安装（满足 >= ${REQUIRED_MAJOR}.${REQUIRED_MINOR}）"
             return
         else
-            print_warning "$TMUX_VERSION 版本过低，需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR} 或更高，正在升级..."
+            print_warning "$TMUX_VERSION 版本过低，需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR} 或更高，尝试通过包管理器升级..."
             install_tmux
-            # 升级后再次验证，版本仍不满足则走源码编译（跨平台）
-            if ! check_version; then
-                install_tmux_from_source
-                if check_version; then
-                    print_success "tmux 已升级至 $(tmux -V)"
-                else
-                    print_warning "源码编译后版本仍不满足要求（$(tmux -V)），需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+"
-                    WARNINGS+=("tmux 版本不满足要求（$(tmux -V)），需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+，请手动升级")
-                fi
-            else
+            if check_version; then
                 print_success "tmux 已升级至 $(tmux -V)"
+            else
+                print_warning "包管理器安装后版本仍不满足要求（$(tmux -V)），需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+"
+                print_info "请运行 'remote-claude deps' 从源码编译安装 tmux ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+"
+                WARNINGS+=("tmux 版本不满足要求（$(tmux -V)），需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+，请运行 remote-claude deps 升级")
             fi
         fi
     else
         print_warning "未找到 tmux，正在安装..."
         install_tmux
-        if ! check_version; then
-            install_tmux_from_source
-            if ! check_version; then
-                print_warning "源码编译后版本仍不满足要求（$(tmux -V)），需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+"
-                WARNINGS+=("tmux 版本不满足要求（$(tmux -V)），需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+，请手动升级")
-            fi
+        if command -v tmux &> /dev/null && check_version; then
+            print_success "tmux 已安装: $(tmux -V)"
+        else
+            local _cur_ver=""
+            command -v tmux &> /dev/null && _cur_ver="（当前: $(tmux -V)）"
+            print_warning "tmux 安装后版本仍不满足要求${_cur_ver}，需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+"
+            print_info "请运行 'remote-claude deps' 从源码编译安装 tmux ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+"
+            WARNINGS+=("tmux 版本不满足要求，需要 ${REQUIRED_MAJOR}.${REQUIRED_MINOR}+，请运行 remote-claude deps 升级")
         fi
     fi
 }

package/lark_client/card_builder.py

@@ -771,6 +771,16 @@ def build_stream_card(
 
 # === 辅助卡片（保留不变）===
 
+def _get_display_name(name: str, cwd: str = None) -> str:
+    """从会话名和 CWD 获取显示名。自定义会话名直接用，默认路径名取 CWD 末段。"""
+    is_default = bool(_re.search(r'_\d{4}_\d{6}$', name))
+    if not is_default:
+        return name
+    if cwd:
+        return cwd.rstrip("/").rsplit("/", 1)[-1] or name
+    return name
+
+
 def _build_session_list_elements(sessions: List[Dict], current_session: Optional[str], session_groups: Optional[Dict[str, str]], page: int = 0) -> List[Dict]:
     """构建会话列表元素（供 build_menu_card 复用）"""
     import os
@@ -794,10 +804,7 @@ def _build_session_list_elements(sessions: List[Dict], current_session: Optional
 
             status_icon = "🟢" if is_current else "⚪"
             current_label = "（当前）" if is_current else ""
-            if cwd:
-                short_name = cwd.rstrip("/").rsplit("/", 1)[-1] or name
-            else:
-                short_name = name
+            short_name = _get_display_name(name, cwd)
 
             # 构建4行内容：名字、cli类型、启动时间、目录
             lines = [f"{status_icon} **{short_name}**{current_label}"]
@@ -1029,22 +1036,44 @@ def build_dir_card(target, entries: List[Dict], sessions: List[Dict], tree: bool
                 for sn, cid in session_groups.items():
                     if sn == auto_session or sn.startswith(auto_session + "_"):
                         matched_group_cid = cid
-            group_btn = {
-                "tag": "button",
-                "text": {"tag": "plain_text", "content": "进入群聊" if matched_group_cid else "创建群聊"},
-                "type": "default",
-                "behaviors": [{"type": "open_url",
-                               "default_url": f"https://applink.feishu.cn/client/chat/open?openChatId={matched_group_cid}",
-                               "android_url": f"https://applink.feishu.cn/client/chat/open?openChatId={matched_group_cid}",
-                               "ios_url": f"https://applink.feishu.cn/client/chat/open?openChatId={matched_group_cid}",
-                               "pc_url": f"https://applink.feishu.cn/client/chat/open?openChatId={matched_group_cid}"}]
-                if matched_group_cid else
-                [{"type": "callback", "value": {
-                    "action": "dir_new_group",
-                    "path": full_path,
-                    "session_name": auto_session
-                }}]
-            }
+            if matched_group_cid:
+                action_btns = [
+                    {
+                        "tag": "button",
+                        "text": {"tag": "plain_text", "content": "进入群聊"},
+                        "type": "default",
+                        "behaviors": [{"type": "open_url",
+                                       "default_url": f"https://applink.feishu.cn/client/chat/open?openChatId={matched_group_cid}",
+                                       "android_url": f"https://applink.feishu.cn/client/chat/open?openChatId={matched_group_cid}",
+                                       "ios_url": f"https://applink.feishu.cn/client/chat/open?openChatId={matched_group_cid}",
+                                       "pc_url": f"https://applink.feishu.cn/client/chat/open?openChatId={matched_group_cid}"}]
+                    }
+                ]
+            else:
+                action_btns = [
+                    {
+                        "tag": "button",
+                        "text": {"tag": "plain_text", "content": "Claude群聊"},
+                        "type": "primary",
+                        "behaviors": [{"type": "callback", "value": {
+                            "action": "dir_new_group",
+                            "path": full_path,
+                            "session_name": auto_session,
+                            "cli_type": "claude"
+                        }}]
+                    },
+                    {
+                        "tag": "button",
+                        "text": {"tag": "plain_text", "content": "Codex群聊"},
+                        "type": "default",
+                        "behaviors": [{"type": "callback", "value": {
+                            "action": "dir_new_group",
+                            "path": full_path,
+                            "session_name": auto_session,
+                            "cli_type": "codex"
+                        }}]
+                    }
+                ]
             elements.append({
                 "tag": "column_set",
                 "flex_mode": "none",
@@ -1067,19 +1096,7 @@ def build_dir_card(target, entries: List[Dict], sessions: List[Dict], tree: bool
                         "tag": "column",
                         "width": "weighted",
                         "weight": 2,
-                        "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": action_btns
                     }
                 ]
             })
@@ -1152,6 +1169,9 @@ def build_help_card() -> Dict[str, Any]:
 **群聊协作**
 • `/new-group <会话名>` - 创建专属群聊，多人共用同一 Claude
 
+**按键控制**
+• `/press <按键>` - 发送按键到会话（如 `/press ctrl+c`、`/press esc`、`/press ctrl+f`）
+
 **其他**
 • `/help` - 显示此帮助
 • `/menu` - 快捷操作面板"""