nonebot-plugin-codex 0.1.2__tar.gz → 0.1.4__tar.gz

{nonebot_plugin_codex-0.1.2 → nonebot_plugin_codex-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: nonebot-plugin-codex
-Version: 0.1.2
+Version: 0.1.4
 Summary: Telegram bridge plugin for driving Codex from NoneBot
 Author-Email: ttiee <469784630@qq.com>
 License: GPL-3.0-or-later
@@ -121,19 +121,38 @@ codex_workdir = "/home/yourname"
 一个典型工作流通常是这样的：
 
 ```text
-/codex 帮我检查当前仓库为什么测试失败
+/codex
+/panel
 /cd /home/yourname/projects/demo
-/permission danger
 /mode resume
 然后继续直接发送普通文本消息续聊
 ```
 
+`/codex` 不带参数时会打开一个 Telegram 内的使用引导面板，方便你直接查看当前模式、工作目录、设置摘要，并进入目录浏览、设置面板或历史会话。
+
+`/panel` 和 `/status` 会打开统一的“当前工作台”面板，把模式、模型、推理强度、权限、工作目录、当前会话状态和最近历史摘要放在同一屏里，并提供进入设置、目录、历史、新会话和停止会话的快捷操作。
+
+你也可以直接把首条任务跟在 `/codex` 后面：
+
+```text
+/codex 帮我检查当前仓库为什么测试失败
+/permission danger
+```
+
 你也可以把一次性任务交给 `exec` 模式：
 
 ```text
 /exec 用三点总结这个仓库 README 还缺什么
 ```
 
+如果你希望显式打开引导入口，也可以使用：
+
+```text
+/help
+/start
+/panel
+```
+
 ## 配置说明
 
 完整配置如下，配置名与当前实现保持一致：
@@ -178,17 +197,21 @@ codex_stream_read_limit = 1048576
 
 | 命令 | 说明 |
 | --- | --- |
-| `/codex [prompt]` | 连接 Codex，会附带发送首条 prompt |
+| `/codex [prompt]` | 打开引导面板，或直接附带首条任务连接 Codex |
+| `/help` | 打开使用引导面板 |
+| `/start` | 打开使用引导面板 |
+| `/panel` | 打开统一工作台面板 |
+| `/status` | 打开统一工作台面板 |
 | `/mode [resume\|exec]` | 查看或切换默认模式 |
 | `/exec <prompt>` | 以一次性 `exec` 模式执行任务 |
-| `/new` | 清空当前聊天绑定的会话 |
-| `/stop` | 断开当前聊天的 Codex 会话 |
-| `/models` | 查看可用模型 |
-| `/model [slug]` | 查看或切换模型 |
+| `/new` | 新建当前聊天会话 |
+| `/stop` | 停止当前聊天中的 Codex |
+| `/models` | 查看可用模型列表 |
+| `/model [slug]` | 查看或切换当前模型 |
 | `/effort [high\|xhigh]` | 查看或切换推理强度 |
 | `/permission [safe\|danger]` | 查看或切换权限模式 |
-| `/pwd` | 查看当前工作目录与当前设置 |
-| `/cd [path]` | 直接切换目录；不带参数时打开目录浏览器 |
+| `/pwd` | 查看当前工作目录和设置 |
+| `/cd [path]` | 切换目录或打开目录浏览器 |
 | `/home` | 将工作目录重置到 Home |
 | `/sessions` | 打开历史会话浏览器 |
 
@@ -212,6 +235,7 @@ codex_stream_read_limit = 1048576
 
 ## 目录与历史会话
 
+- `/panel` 或 `/status` 会打开统一工作台，一屏查看当前设置、工作目录、会话状态和最近历史，并跳转到常用控制面板。
 - `/cd` 可打开目录浏览器，逐级进入目录、切换 Home、显示隐藏目录，并把当前浏览目录设置为工作目录。
 - `/sessions` 会列出 native 与 exec 历史会话，便于恢复此前任务。
 - 历史会话恢复时会尝试切回原始工作目录；如果原目录不存在，会保留当前目录并给出提示。

{nonebot_plugin_codex-0.1.2 → nonebot_plugin_codex-0.1.4}/README.md

@@ -108,19 +108,38 @@ codex_workdir = "/home/yourname"
 一个典型工作流通常是这样的：
 
 ```text
-/codex 帮我检查当前仓库为什么测试失败
+/codex
+/panel
 /cd /home/yourname/projects/demo
-/permission danger
 /mode resume
 然后继续直接发送普通文本消息续聊
 ```
 
+`/codex` 不带参数时会打开一个 Telegram 内的使用引导面板，方便你直接查看当前模式、工作目录、设置摘要，并进入目录浏览、设置面板或历史会话。
+
+`/panel` 和 `/status` 会打开统一的“当前工作台”面板，把模式、模型、推理强度、权限、工作目录、当前会话状态和最近历史摘要放在同一屏里，并提供进入设置、目录、历史、新会话和停止会话的快捷操作。
+
+你也可以直接把首条任务跟在 `/codex` 后面：
+
+```text
+/codex 帮我检查当前仓库为什么测试失败
+/permission danger
+```
+
 你也可以把一次性任务交给 `exec` 模式：
 
 ```text
 /exec 用三点总结这个仓库 README 还缺什么
 ```
 
+如果你希望显式打开引导入口，也可以使用：
+
+```text
+/help
+/start
+/panel
+```
+
 ## 配置说明
 
 完整配置如下，配置名与当前实现保持一致：
@@ -165,17 +184,21 @@ codex_stream_read_limit = 1048576
 
 | 命令 | 说明 |
 | --- | --- |
-| `/codex [prompt]` | 连接 Codex，会附带发送首条 prompt |
+| `/codex [prompt]` | 打开引导面板，或直接附带首条任务连接 Codex |
+| `/help` | 打开使用引导面板 |
+| `/start` | 打开使用引导面板 |
+| `/panel` | 打开统一工作台面板 |
+| `/status` | 打开统一工作台面板 |
 | `/mode [resume\|exec]` | 查看或切换默认模式 |
 | `/exec <prompt>` | 以一次性 `exec` 模式执行任务 |
-| `/new` | 清空当前聊天绑定的会话 |
-| `/stop` | 断开当前聊天的 Codex 会话 |
-| `/models` | 查看可用模型 |
-| `/model [slug]` | 查看或切换模型 |
+| `/new` | 新建当前聊天会话 |
+| `/stop` | 停止当前聊天中的 Codex |
+| `/models` | 查看可用模型列表 |
+| `/model [slug]` | 查看或切换当前模型 |
 | `/effort [high\|xhigh]` | 查看或切换推理强度 |
 | `/permission [safe\|danger]` | 查看或切换权限模式 |
-| `/pwd` | 查看当前工作目录与当前设置 |
-| `/cd [path]` | 直接切换目录；不带参数时打开目录浏览器 |
+| `/pwd` | 查看当前工作目录和设置 |
+| `/cd [path]` | 切换目录或打开目录浏览器 |
 | `/home` | 将工作目录重置到 Home |
 | `/sessions` | 打开历史会话浏览器 |
 
@@ -199,6 +222,7 @@ codex_stream_read_limit = 1048576
 
 ## 目录与历史会话
 
+- `/panel` 或 `/status` 会打开统一工作台，一屏查看当前设置、工作目录、会话状态和最近历史，并跳转到常用控制面板。
 - `/cd` 可打开目录浏览器，逐级进入目录、切换 Home、显示隐藏目录，并把当前浏览目录设置为工作目录。
 - `/sessions` 会列出 native 与 exec 历史会话，便于恢复此前任务。
 - 历史会话恢复时会尝试切回原始工作目录；如果原目录不存在，会保留当前目录并给出提示。

{nonebot_plugin_codex-0.1.2 → nonebot_plugin_codex-0.1.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nonebot-plugin-codex"
-version = "0.1.2"
+version = "0.1.4"
 description = "Telegram bridge plugin for driving Codex from NoneBot"
 authors = [
     { name = "ttiee", email = "469784630@qq.com" },

{nonebot_plugin_codex-0.1.2 → nonebot_plugin_codex-0.1.4}/src/nonebot_plugin_codex/__init__.py

@@ -3,14 +3,21 @@ from __future__ import annotations
 from pathlib import Path
 
 from nonebot import get_plugin_config, on_command, on_message, on_type, require
+from nonebot.drivers import Driver
+from nonebot.log import logger
 from nonebot.plugin import PluginMetadata
 from nonebot.params import CommandArg
 from nonebot.adapters.telegram import Bot
 from nonebot.adapters.telegram.message import Message
 from nonebot.adapters.telegram.event import MessageEvent, CallbackQueryEvent
+from nonebot.adapters.telegram.model import (
+    BotCommandScopeAllGroupChats,
+    BotCommandScopeAllPrivateChats,
+)
 
 from .config import Config
 from .telegram import TelegramHandlers
+from .telegram_commands import build_plugin_usage, build_telegram_commands
 from .native_client import NativeCodexClient
 from .runtime import build_service_settings
 from .service import CodexBridgeService
@@ -18,10 +25,7 @@ from .service import CodexBridgeService
 __plugin_meta__ = PluginMetadata(
     name="Codex",
     description="Telegram bridge plugin for driving Codex from NoneBot",
-    usage=(
-        "/codex [prompt], /mode, /exec, /new, /stop, /models, /model, /effort, "
-        "/permission, /pwd, /cd, /home, /sessions"
-    ),
+    usage=build_plugin_usage(),
     homepage="https://github.com/ttiee/nonebot-plugin-codex",
     type="application",
     config=Config,
@@ -58,8 +62,34 @@ service = CodexBridgeService(
 )
 handlers = TelegramHandlers(service)
 
+
+async def sync_telegram_commands(bot: Bot) -> bool:
+    synced = True
+    scopes = (
+        BotCommandScopeAllPrivateChats(),
+        BotCommandScopeAllGroupChats(),
+    )
+    commands = build_telegram_commands()
+    for scope in scopes:
+        try:
+            await bot.set_my_commands(commands, scope=scope)
+        except Exception as exc:
+            logger.warning(f"Telegram 命令菜单同步失败（{scope.type}）：{exc}")
+            synced = False
+    return synced
+
 if _runtime_ready:
+    @Driver.on_bot_connect
+    async def _sync_telegram_commands(bot: Bot) -> None:
+        if not isinstance(bot, Bot):
+            return
+        await sync_telegram_commands(bot)
+
     codex_cmd = on_command("codex", priority=10, block=True)
+    help_cmd = on_command("help", priority=10, block=True)
+    start_cmd = on_command("start", priority=10, block=True)
+    panel_cmd = on_command("panel", priority=10, block=True)
+    status_cmd = on_command("status", priority=10, block=True)
     mode_cmd = on_command("mode", priority=10, block=True)
     exec_cmd = on_command("exec", priority=10, block=True)
     new_cmd = on_command("new", priority=10, block=True)
@@ -91,6 +121,18 @@ if _runtime_ready:
         block=True,
         rule=handlers.is_setting_callback,
     )
+    onboarding_callback = on_type(
+        CallbackQueryEvent,
+        priority=10,
+        block=True,
+        rule=handlers.is_onboarding_callback,
+    )
+    workspace_callback = on_type(
+        CallbackQueryEvent,
+        priority=10,
+        block=True,
+        rule=handlers.is_workspace_callback,
+    )
 
     @codex_cmd.handle()
     async def _handle_codex(
@@ -98,6 +140,22 @@ if _runtime_ready:
     ) -> None:
         await handlers.handle_codex(bot, event, args)
 
+    @help_cmd.handle()
+    async def _handle_help(bot: Bot, event: MessageEvent) -> None:
+        await handlers.handle_help(bot, event)
+
+    @start_cmd.handle()
+    async def _handle_start(bot: Bot, event: MessageEvent) -> None:
+        await handlers.handle_start(bot, event)
+
+    @panel_cmd.handle()
+    async def _handle_panel(bot: Bot, event: MessageEvent) -> None:
+        await handlers.handle_panel(bot, event)
+
+    @status_cmd.handle()
+    async def _handle_status(bot: Bot, event: MessageEvent) -> None:
+        await handlers.handle_status(bot, event)
+
     @mode_cmd.handle()
     async def _handle_mode(
         bot: Bot, event: MessageEvent, args: Message = CommandArg()
@@ -172,6 +230,18 @@ if _runtime_ready:
     async def _handle_setting_callback(bot: Bot, event: CallbackQueryEvent) -> None:
         await handlers.handle_setting_callback(bot, event)
 
+    @onboarding_callback.handle()
+    async def _handle_onboarding_callback(
+        bot: Bot, event: CallbackQueryEvent
+    ) -> None:
+        await handlers.handle_onboarding_callback(bot, event)
+
+    @workspace_callback.handle()
+    async def _handle_workspace_callback(
+        bot: Bot, event: CallbackQueryEvent
+    ) -> None:
+        await handlers.handle_workspace_callback(bot, event)
+
     @follow_up.handle()
     async def _handle_follow_up(bot: Bot, event: MessageEvent) -> None:
         await handlers.handle_follow_up(bot, event)

{nonebot_plugin_codex-0.1.2 → nonebot_plugin_codex-0.1.4}/src/nonebot_plugin_codex/service.py

@@ -38,6 +38,10 @@ HISTORY_STALE_MESSAGE = "历史会话面板已失效，请重新执行 /sessions
 SETTING_CALLBACK_PREFIX = "csp"
 SETTING_STALE_MESSAGE = "设置面板已失效，请重新执行对应命令"
 SUPPORTED_SETTING_PANELS = {"mode", "model", "effort", "permission"}
+ONBOARDING_CALLBACK_PREFIX = "cop"
+ONBOARDING_STALE_MESSAGE = "引导面板已失效，请重新执行 /codex"
+WORKSPACE_CALLBACK_PREFIX = "cwp"
+WORKSPACE_STALE_MESSAGE = "工作台面板已失效，请重新执行 /panel"
 
 
 @dataclass(slots=True)
@@ -195,6 +199,22 @@ class SettingPanelState:
     message_id: int | None = None
 
 
+@dataclass(slots=True)
+class OnboardingPanelState:
+    chat_key: str
+    token: str
+    version: int
+    message_id: int | None = None
+
+
+@dataclass(slots=True)
+class WorkspacePanelState:
+    chat_key: str
+    token: str
+    version: int
+    message_id: int | None = None
+
+
 def build_chat_key(chat_type: str, chat_id: int) -> str:
     if chat_type == "private":
         return f"private_{chat_id}"
@@ -330,6 +350,38 @@ def decode_setting_callback(payload: str) -> tuple[str, int, str, str | None]:
     return token, version, action, value
 
 
+def encode_onboarding_callback(token: str, version: int, action: str) -> str:
+    return f"{ONBOARDING_CALLBACK_PREFIX}:{token}:{version}:{action}"
+
+
+def decode_onboarding_callback(payload: str) -> tuple[str, int, str]:
+    parts = payload.split(":")
+    if len(parts) != 4 or parts[0] != ONBOARDING_CALLBACK_PREFIX:
+        raise ValueError("无效的引导回调。")
+    token = parts[1]
+    try:
+        version = int(parts[2])
+    except ValueError as exc:
+        raise ValueError("无效的引导回调。") from exc
+    return token, version, parts[3]
+
+
+def encode_workspace_callback(token: str, version: int, action: str) -> str:
+    return f"{WORKSPACE_CALLBACK_PREFIX}:{token}:{version}:{action}"
+
+
+def decode_workspace_callback(payload: str) -> tuple[str, int, str]:
+    parts = payload.split(":")
+    if len(parts) != 4 or parts[0] != WORKSPACE_CALLBACK_PREFIX:
+        raise ValueError("无效的工作台回调。")
+    token = parts[1]
+    try:
+        version = int(parts[2])
+    except ValueError as exc:
+        raise ValueError("无效的工作台回调。") from exc
+    return token, version, parts[3]
+
+
 def parse_event_line(line: str) -> dict[str, Any] | None:
     try:
         payload = json.loads(line)
@@ -501,6 +553,8 @@ class CodexBridgeService:
         self.directory_browsers: dict[str, DirectoryBrowserState] = {}
         self.history_browsers: dict[str, HistoryBrowserState] = {}
         self.setting_panels: dict[str, SettingPanelState] = {}
+        self.onboarding_panels: dict[str, OnboardingPanelState] = {}
+        self.workspace_panels: dict[str, WorkspacePanelState] = {}
         self._native_history_entries: list[HistoricalSessionSummary] = []
         self._native_history_loaded = False
         self._history_log_cache: dict[str, HistoryLogCacheEntry] = {}
@@ -1639,6 +1693,314 @@ class CodexBridgeService:
         self.get_setting_panel(chat_key, token=token, version=version)
         self.setting_panels.pop(chat_key, None)
 
+    def _replace_onboarding_panel_state(
+        self,
+        chat_key: str,
+        *,
+        previous: OnboardingPanelState | None = None,
+    ) -> OnboardingPanelState:
+        state = OnboardingPanelState(
+            chat_key=chat_key,
+            token=previous.token if previous else self._make_browser_token(),
+            version=(previous.version + 1) if previous else 1,
+            message_id=previous.message_id if previous else None,
+        )
+        self.onboarding_panels[chat_key] = state
+        return state
+
+    def open_onboarding_panel(self, chat_key: str) -> OnboardingPanelState:
+        self.get_preferences(chat_key)
+        return self._replace_onboarding_panel_state(chat_key)
+
+    def get_onboarding_panel(
+        self,
+        chat_key: str,
+        token: str | None = None,
+        version: int | None = None,
+    ) -> OnboardingPanelState:
+        state = self.onboarding_panels.get(chat_key)
+        if state is None:
+            raise ValueError(ONBOARDING_STALE_MESSAGE)
+        if token is not None and state.token != token:
+            raise ValueError(ONBOARDING_STALE_MESSAGE)
+        if version is not None and state.version != version:
+            raise ValueError(ONBOARDING_STALE_MESSAGE)
+        return state
+
+    def remember_onboarding_panel_message(
+        self,
+        chat_key: str,
+        token: str,
+        message_id: int | None,
+    ) -> None:
+        if message_id is None:
+            return
+        panel = self.get_onboarding_panel(chat_key, token=token)
+        panel.message_id = message_id
+
+    def close_onboarding_panel(self, chat_key: str, token: str, version: int) -> None:
+        self.get_onboarding_panel(chat_key, token=token, version=version)
+        self.onboarding_panels.pop(chat_key, None)
+
+    def _replace_workspace_panel_state(
+        self,
+        chat_key: str,
+        *,
+        previous: WorkspacePanelState | None = None,
+    ) -> WorkspacePanelState:
+        state = WorkspacePanelState(
+            chat_key=chat_key,
+            token=previous.token if previous else self._make_browser_token(),
+            version=(previous.version + 1) if previous else 1,
+            message_id=previous.message_id if previous else None,
+        )
+        self.workspace_panels[chat_key] = state
+        return state
+
+    def open_workspace_panel(self, chat_key: str) -> WorkspacePanelState:
+        self.get_preferences(chat_key)
+        return self._replace_workspace_panel_state(chat_key)
+
+    def get_workspace_panel(
+        self,
+        chat_key: str,
+        token: str | None = None,
+        version: int | None = None,
+    ) -> WorkspacePanelState:
+        state = self.workspace_panels.get(chat_key)
+        if state is None:
+            raise ValueError(WORKSPACE_STALE_MESSAGE)
+        if token is not None and state.token != token:
+            raise ValueError(WORKSPACE_STALE_MESSAGE)
+        if version is not None and state.version != version:
+            raise ValueError(WORKSPACE_STALE_MESSAGE)
+        return state
+
+    def remember_workspace_panel_message(
+        self,
+        chat_key: str,
+        token: str,
+        message_id: int | None,
+    ) -> None:
+        if message_id is None:
+            return
+        panel = self.get_workspace_panel(chat_key, token=token)
+        panel.message_id = message_id
+
+    def close_workspace_panel(self, chat_key: str, token: str, version: int) -> None:
+        self.get_workspace_panel(chat_key, token=token, version=version)
+        self.workspace_panels.pop(chat_key, None)
+
+    def _workspace_active_mode(self, chat_key: str, preferences: ChatPreferences) -> str:
+        session = self.sessions.get(chat_key)
+        if session is not None and session.active_mode in {"resume", "exec"}:
+            return session.active_mode
+        return preferences.default_mode
+
+    def _workspace_session_summary(self, chat_key: str) -> str:
+        session = self.sessions.get(chat_key)
+        if session is None:
+            return "未开始"
+        active_mode = (
+            session.active_mode
+            if session.active_mode in {"resume", "exec"}
+            else "resume"
+        )
+        thread_id = (
+            self._current_exec_thread_id(session)
+            if active_mode == "exec"
+            else session.native_thread_id or session.thread_id
+        )
+        if not thread_id and not session.active:
+            return "未开始"
+        if not thread_id:
+            return f"{active_mode} | 未绑定"
+        return f"{active_mode} | {thread_id}"
+
+    def _workspace_recent_history_lines(self) -> list[str]:
+        try:
+            entries = self.list_history_sessions()[:2]
+        except ValueError:
+            return ["最近历史：不可用"]
+        if not entries:
+            return ["最近历史：无"]
+        lines = ["最近历史："]
+        for entry in entries:
+            lines.append(
+                "- "
+                f"{entry.thread_name} | "
+                f"{self._format_history_relative_time(entry.updated_at)}"
+            )
+        return lines
+
+    def navigate_workspace_panel(
+        self,
+        chat_key: str,
+        token: str,
+        version: int,
+        action: str,
+    ) -> WorkspacePanelState:
+        panel = self.get_workspace_panel(chat_key, token=token, version=version)
+        if action != "refresh":
+            raise ValueError("未知工作台操作。")
+        return self._replace_workspace_panel_state(chat_key, previous=panel)
+
+    def render_workspace_panel(
+        self, chat_key: str
+    ) -> tuple[str, InlineKeyboardMarkup]:
+        panel = self.get_workspace_panel(chat_key)
+        preferences = self.get_preferences(chat_key)
+        lines = [
+            "当前工作台",
+            f"当前模式：{self._workspace_active_mode(chat_key, preferences)}",
+            f"当前设置：{format_preferences_summary(preferences)}",
+            f"当前工作目录：{preferences.workdir}",
+            f"当前会话：{self._workspace_session_summary(chat_key)}",
+            *self._workspace_recent_history_lines(),
+        ]
+        keyboard = [
+            [
+                InlineKeyboardButton(
+                    text="模式",
+                    callback_data=encode_workspace_callback(
+                        panel.token, panel.version, "mode"
+                    ),
+                ),
+                InlineKeyboardButton(
+                    text="模型",
+                    callback_data=encode_workspace_callback(
+                        panel.token, panel.version, "model"
+                    ),
+                ),
+                InlineKeyboardButton(
+                    text="强度",
+                    callback_data=encode_workspace_callback(
+                        panel.token, panel.version, "effort"
+                    ),
+                ),
+                InlineKeyboardButton(
+                    text="权限",
+                    callback_data=encode_workspace_callback(
+                        panel.token, panel.version, "permission"
+                    ),
+                ),
+            ],
+            [
+                InlineKeyboardButton(
+                    text="目录",
+                    callback_data=encode_workspace_callback(
+                        panel.token, panel.version, "browse"
+                    ),
+                ),
+                InlineKeyboardButton(
+                    text="历史",
+                    callback_data=encode_workspace_callback(
+                        panel.token, panel.version, "history"
+                    ),
+                ),
+            ],
+            [
+                InlineKeyboardButton(
+                    text="新会话",
+                    callback_data=encode_workspace_callback(
+                        panel.token, panel.version, "new"
+                    ),
+                ),
+                InlineKeyboardButton(
+                    text="停止",
+                    callback_data=encode_workspace_callback(
+                        panel.token, panel.version, "stop"
+                    ),
+                ),
+            ],
+            [
+                InlineKeyboardButton(
+                    text="刷新",
+                    callback_data=encode_workspace_callback(
+                        panel.token, panel.version, "refresh"
+                    ),
+                ),
+                InlineKeyboardButton(
+                    text="关闭",
+                    callback_data=encode_workspace_callback(
+                        panel.token, panel.version, "close"
+                    ),
+                ),
+            ],
+        ]
+        return "\n".join(lines), InlineKeyboardMarkup(inline_keyboard=keyboard)
+
+    def render_onboarding_panel(
+        self, chat_key: str
+    ) -> tuple[str, InlineKeyboardMarkup]:
+        panel = self.get_onboarding_panel(chat_key)
+        preferences = self.get_preferences(chat_key)
+        session = self.sessions.get(chat_key)
+        active_mode = (
+            session.active_mode
+            if session is not None and session.active_mode in {"resume", "exec"}
+            else preferences.default_mode
+        )
+        has_bound_session = bool(
+            session
+            and (
+                session.active
+                or session.thread_id
+                or session.native_thread_id
+                or session.exec_thread_id
+            )
+        )
+        lines = [
+            "开始使用 Codex",
+            f"当前模式：{active_mode}",
+            f"当前工作目录：{preferences.workdir}",
+            f"当前设置：{format_preferences_summary(preferences)}",
+            f"当前会话：{'可继续' if has_bound_session else '未开始'}",
+            (
+                "推荐：直接发送任务，或先切换目录；"
+                "一次性任务用 /exec；恢复上下文看历史会话。"
+            ),
+        ]
+        keyboard = [
+            [
+                InlineKeyboardButton(
+                    text="切换目录",
+                    callback_data=encode_onboarding_callback(
+                        panel.token, panel.version, "browse"
+                    ),
+                ),
+                InlineKeyboardButton(
+                    text="当前设置",
+                    callback_data=encode_onboarding_callback(
+                        panel.token, panel.version, "settings"
+                    ),
+                ),
+            ],
+            [
+                InlineKeyboardButton(
+                    text="历史会话",
+                    callback_data=encode_onboarding_callback(
+                        panel.token, panel.version, "history"
+                    ),
+                ),
+                InlineKeyboardButton(
+                    text="新开会话",
+                    callback_data=encode_onboarding_callback(
+                        panel.token, panel.version, "new"
+                    ),
+                ),
+            ],
+            [
+                InlineKeyboardButton(
+                    text="关闭",
+                    callback_data=encode_onboarding_callback(
+                        panel.token, panel.version, "close"
+                    ),
+                )
+            ],
+        ]
+        return "\n".join(lines), InlineKeyboardMarkup(inline_keyboard=keyboard)
+
     def navigate_setting_panel(
         self,
         chat_key: str,