nonebot-plugin-codex 0.1.3__tar.gz → 0.1.5__tar.gz

{nonebot_plugin_codex-0.1.3 → nonebot_plugin_codex-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: nonebot-plugin-codex
-Version: 0.1.3
+Version: 0.1.5
 Summary: Telegram bridge plugin for driving Codex from NoneBot
 Author-Email: ttiee <469784630@qq.com>
 License: GPL-3.0-or-later
@@ -40,6 +40,13 @@ _✨ 在 Telegram 里驱动 Codex CLI 的 NoneBot 插件 ✨_
 
 </div>
 
+<p align="center">
+  <img src="docs/images/readme/1.jpg" width="24%" alt="nonebot-plugin-codex screenshot 1">
+  <img src="docs/images/readme/2.jpg" width="24%" alt="nonebot-plugin-codex screenshot 2">
+  <img src="docs/images/readme/3.jpg" width="24%" alt="nonebot-plugin-codex screenshot 3">
+  <img src="docs/images/readme/4.jpg" width="24%" alt="nonebot-plugin-codex screenshot 4">
+</p>
+
 ## 项目介绍
 
 `nonebot-plugin-codex` 是一个面向 Telegram 场景的 NoneBot 插件，用来把本机 `codex` CLI 暴露为可对话、可续聊、可管理工作目录的聊天式开发助手。
@@ -122,6 +129,7 @@ codex_workdir = "/home/yourname"
 
 ```text
 /codex
+/panel
 /cd /home/yourname/projects/demo
 /mode resume
 然后继续直接发送普通文本消息续聊
@@ -129,6 +137,8 @@ codex_workdir = "/home/yourname"
 
 `/codex` 不带参数时会打开一个 Telegram 内的使用引导面板，方便你直接查看当前模式、工作目录、设置摘要，并进入目录浏览、设置面板或历史会话。
 
+`/panel` 和 `/status` 会打开统一的“当前工作台”面板，把模式、模型、推理强度、权限、工作目录、当前会话状态和最近历史摘要放在同一屏里，并提供进入设置、目录、历史、新会话和停止会话的快捷操作。
+
 你也可以直接把首条任务跟在 `/codex` 后面：
 
 ```text
@@ -147,6 +157,7 @@ codex_workdir = "/home/yourname"
 ```text
 /help
 /start
+/panel
 ```
 
 ## 配置说明
@@ -176,8 +187,8 @@ codex_diagnostic_history = 20
 # 单条 Telegram 消息的分片长度，过长回复会自动拆分
 codex_chunk_size = 3500
 
-# 读取 Codex stdout / stderr 的缓冲区大小
-codex_stream_read_limit = 1048576
+# 单条 Codex 协议消息允许的最大字节数
+codex_stream_read_limit = 8388608
 
 ```
 
@@ -185,7 +196,8 @@ codex_stream_read_limit = 1048576
 
 - `codex_binary`：如果宿主机不是直接执行 `codex`，改成实际绝对路径。
 - `codex_workdir`：默认工作目录，也是 `/cd` 相对路径解析与目录浏览器 Home 的基准。
-- 其余项分别控制停止超时、进度保留条数、诊断输出条数、Telegram 分片长度和流读取上限。
+- `codex_stream_read_limit`：限制单条 Codex 协议帧的最大字节数，不是 Telegram 消息分片长度。
+- 其余项分别控制停止超时、进度保留条数、诊断输出条数和 Telegram 分片长度。
 - 插件自己的配置数据由 `nonebot-plugin-localstore` 自动管理。
 - 模型缓存、Codex CLI 配置和历史会话目录默认读取 `~/.codex/*`，属于插件内部实现路径。
 
@@ -196,6 +208,8 @@ codex_stream_read_limit = 1048576
 | `/codex [prompt]` | 打开引导面板，或直接附带首条任务连接 Codex |
 | `/help` | 打开使用引导面板 |
 | `/start` | 打开使用引导面板 |
+| `/panel` | 打开统一工作台面板 |
+| `/status` | 打开统一工作台面板 |
 | `/mode [resume\|exec]` | 查看或切换默认模式 |
 | `/exec <prompt>` | 以一次性 `exec` 模式执行任务 |
 | `/new` | 新建当前聊天会话 |
@@ -229,6 +243,7 @@ codex_stream_read_limit = 1048576
 
 ## 目录与历史会话
 
+- `/panel` 或 `/status` 会打开统一工作台，一屏查看当前设置、工作目录、会话状态和最近历史，并跳转到常用控制面板。
 - `/cd` 可打开目录浏览器，逐级进入目录、切换 Home、显示隐藏目录，并把当前浏览目录设置为工作目录。
 - `/sessions` 会列出 native 与 exec 历史会话，便于恢复此前任务。
 - 历史会话恢复时会尝试切回原始工作目录；如果原目录不存在，会保留当前目录并给出提示。

{nonebot_plugin_codex-0.1.3 → nonebot_plugin_codex-0.1.5}/README.md

@@ -27,6 +27,13 @@ _✨ 在 Telegram 里驱动 Codex CLI 的 NoneBot 插件 ✨_
 
 </div>
 
+<p align="center">
+  <img src="docs/images/readme/1.jpg" width="24%" alt="nonebot-plugin-codex screenshot 1">
+  <img src="docs/images/readme/2.jpg" width="24%" alt="nonebot-plugin-codex screenshot 2">
+  <img src="docs/images/readme/3.jpg" width="24%" alt="nonebot-plugin-codex screenshot 3">
+  <img src="docs/images/readme/4.jpg" width="24%" alt="nonebot-plugin-codex screenshot 4">
+</p>
+
 ## 项目介绍
 
 `nonebot-plugin-codex` 是一个面向 Telegram 场景的 NoneBot 插件，用来把本机 `codex` CLI 暴露为可对话、可续聊、可管理工作目录的聊天式开发助手。
@@ -109,6 +116,7 @@ codex_workdir = "/home/yourname"
 
 ```text
 /codex
+/panel
 /cd /home/yourname/projects/demo
 /mode resume
 然后继续直接发送普通文本消息续聊
@@ -116,6 +124,8 @@ codex_workdir = "/home/yourname"
 
 `/codex` 不带参数时会打开一个 Telegram 内的使用引导面板，方便你直接查看当前模式、工作目录、设置摘要，并进入目录浏览、设置面板或历史会话。
 
+`/panel` 和 `/status` 会打开统一的“当前工作台”面板，把模式、模型、推理强度、权限、工作目录、当前会话状态和最近历史摘要放在同一屏里，并提供进入设置、目录、历史、新会话和停止会话的快捷操作。
+
 你也可以直接把首条任务跟在 `/codex` 后面：
 
 ```text
@@ -134,6 +144,7 @@ codex_workdir = "/home/yourname"
 ```text
 /help
 /start
+/panel
 ```
 
 ## 配置说明
@@ -163,8 +174,8 @@ codex_diagnostic_history = 20
 # 单条 Telegram 消息的分片长度，过长回复会自动拆分
 codex_chunk_size = 3500
 
-# 读取 Codex stdout / stderr 的缓冲区大小
-codex_stream_read_limit = 1048576
+# 单条 Codex 协议消息允许的最大字节数
+codex_stream_read_limit = 8388608
 
 ```
 
@@ -172,7 +183,8 @@ codex_stream_read_limit = 1048576
 
 - `codex_binary`：如果宿主机不是直接执行 `codex`，改成实际绝对路径。
 - `codex_workdir`：默认工作目录，也是 `/cd` 相对路径解析与目录浏览器 Home 的基准。
-- 其余项分别控制停止超时、进度保留条数、诊断输出条数、Telegram 分片长度和流读取上限。
+- `codex_stream_read_limit`：限制单条 Codex 协议帧的最大字节数，不是 Telegram 消息分片长度。
+- 其余项分别控制停止超时、进度保留条数、诊断输出条数和 Telegram 分片长度。
 - 插件自己的配置数据由 `nonebot-plugin-localstore` 自动管理。
 - 模型缓存、Codex CLI 配置和历史会话目录默认读取 `~/.codex/*`，属于插件内部实现路径。
 
@@ -183,6 +195,8 @@ codex_stream_read_limit = 1048576
 | `/codex [prompt]` | 打开引导面板，或直接附带首条任务连接 Codex |
 | `/help` | 打开使用引导面板 |
 | `/start` | 打开使用引导面板 |
+| `/panel` | 打开统一工作台面板 |
+| `/status` | 打开统一工作台面板 |
 | `/mode [resume\|exec]` | 查看或切换默认模式 |
 | `/exec <prompt>` | 以一次性 `exec` 模式执行任务 |
 | `/new` | 新建当前聊天会话 |
@@ -216,6 +230,7 @@ codex_stream_read_limit = 1048576
 
 ## 目录与历史会话
 
+- `/panel` 或 `/status` 会打开统一工作台，一屏查看当前设置、工作目录、会话状态和最近历史，并跳转到常用控制面板。
 - `/cd` 可打开目录浏览器，逐级进入目录、切换 Home、显示隐藏目录，并把当前浏览目录设置为工作目录。
 - `/sessions` 会列出 native 与 exec 历史会话，便于恢复此前任务。
 - 历史会话恢复时会尝试切回原始工作目录；如果原目录不存在，会保留当前目录并给出提示。

{nonebot_plugin_codex-0.1.3 → nonebot_plugin_codex-0.1.5}/pyproject.toml

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

{nonebot_plugin_codex-0.1.3 → nonebot_plugin_codex-0.1.5}/src/nonebot_plugin_codex/__init__.py

@@ -88,6 +88,8 @@ if _runtime_ready:
     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)
@@ -125,6 +127,12 @@ if _runtime_ready:
         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(
@@ -140,6 +148,14 @@ if _runtime_ready:
     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()
@@ -220,6 +236,12 @@ if _runtime_ready:
     ) -> 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.3 → nonebot_plugin_codex-0.1.5}/src/nonebot_plugin_codex/config.py

@@ -12,4 +12,4 @@ class Config(BaseModel):
     codex_progress_history: int = 6
     codex_diagnostic_history: int = 20
     codex_chunk_size: int = 3500
-    codex_stream_read_limit: int = 1024 * 1024
+    codex_stream_read_limit: int = 8 * 1024 * 1024

{nonebot_plugin_codex-0.1.3 → nonebot_plugin_codex-0.1.5}/src/nonebot_plugin_codex/native_client.py

@@ -7,6 +7,8 @@ from dataclasses import field, dataclass
 from typing import Any
 from collections.abc import Callable, Awaitable
 
+from .protocol_io import NdjsonProcessReader, ProtocolStreamError
+
 Callback = Callable[[str], object]
 ProcessLauncher = Callable[..., Awaitable[Any]]
 
@@ -93,7 +95,7 @@ class NativeCodexClient:
         launcher: ProcessLauncher | None = None,
         client_name: str = "tg_bot",
         client_version: str = "0",
-        stream_read_limit: int = 1024 * 1024,
+        stream_read_limit: int = 8 * 1024 * 1024,
     ) -> None:
         self.binary = binary
         self.launcher = launcher or asyncio.create_subprocess_exec
@@ -101,6 +103,7 @@ class NativeCodexClient:
         self.client_version = client_version
         self.stream_read_limit = stream_read_limit
         self._process: Any = None
+        self._reader: NdjsonProcessReader | None = None
         self._initialized = False
         self._next_request_id = 1
 
@@ -115,10 +118,14 @@ class NativeCodexClient:
 
     async def close(self, timeout: float = 5.0) -> None:
         process = self._process
+        reader = self._reader
         self._process = None
+        self._reader = None
         self._initialized = False
         self._next_request_id = 1
         await _terminate_process(process, timeout)
+        if reader is not None:
+            await reader.wait_closed()
 
     async def start_thread(
         self,
@@ -322,9 +329,13 @@ class NativeCodexClient:
             "stdio://",
             stdin=asyncio.subprocess.PIPE,
             stdout=asyncio.subprocess.PIPE,
-            stderr=asyncio.subprocess.STDOUT,
+            stderr=asyncio.subprocess.PIPE,
             limit=self.stream_read_limit,
         )
+        self._reader = NdjsonProcessReader(
+            self._process,
+            frame_limit=self.stream_read_limit,
+        )
         request_id = self._allocate_request_id()
         await self._write_message(
             {
@@ -398,12 +409,19 @@ class NativeCodexClient:
             return result
 
     async def _read_message(self, diagnostics: list[str]) -> dict[str, Any] | None:
-        if self._process is None or getattr(self._process, "stdout", None) is None:
+        if self._process is None or self._reader is None:
             raise RuntimeError("Codex app-server 尚未启动。")
-        raw_line = await self._process.stdout.readline()
-        if not raw_line:
+
+        diagnostics.extend(self._reader.drain_stderr_lines())
+        try:
+            line = await self._reader.read_stdout_line()
+        except ProtocolStreamError as exc:
+            diagnostics.extend(self._reader.drain_stderr_lines())
+            raise RuntimeError(str(exc)) from exc
+        diagnostics.extend(self._reader.drain_stderr_lines())
+
+        if line is None:
             raise RuntimeError("Codex app-server 已提前退出。")
-        line = raw_line.decode("utf-8", errors="replace").strip()
         if not line:
             return None
         try:

nonebot_plugin_codex-0.1.5/src/nonebot_plugin_codex/protocol_io.py

@@ -0,0 +1,131 @@
+from __future__ import annotations
+
+import asyncio
+from typing import Any
+
+READ_CHUNK_SIZE = 4096
+
+
+def oversized_frame_message(limit: int) -> str:
+    return (
+        "Codex 返回的单条协议消息超过 "
+        f"`codex_stream_read_limit`（当前 {limit} 字节）。"
+    )
+
+
+def incomplete_frame_message() -> str:
+    return "Codex 返回了不完整的协议消息。"
+
+
+def truncated_stderr_message(limit: int) -> str:
+    return (
+        "Codex stderr 单行输出超过 "
+        f"`codex_stream_read_limit`（当前 {limit} 字节），已截断。"
+    )
+
+
+class ProtocolStreamError(RuntimeError):
+    pass
+
+
+class NdjsonProcessReader:
+    def __init__(
+        self,
+        process: Any,
+        *,
+        frame_limit: int,
+        read_chunk_size: int = READ_CHUNK_SIZE,
+    ) -> None:
+        self._stdout = getattr(process, "stdout", None)
+        self._stderr = getattr(process, "stderr", None)
+        self._frame_limit = frame_limit
+        self._read_chunk_size = max(1, read_chunk_size)
+        self._stdout_buffer = bytearray()
+        self._stderr_buffer = bytearray()
+        self._stderr_lines: list[str] = []
+        self._stderr_skipping_line = False
+        self._stderr_task: asyncio.Task[None] | None = None
+        if self._stderr is not None:
+            self._stderr_task = asyncio.create_task(self._drain_stderr())
+
+    async def read_stdout_line(self) -> str | None:
+        if self._stdout is None:
+            raise RuntimeError("Codex 协议 stdout 不可用。")
+
+        while True:
+            newline_index = self._stdout_buffer.find(b"\n")
+            if newline_index >= 0:
+                frame = bytes(self._stdout_buffer[: newline_index + 1])
+                del self._stdout_buffer[: newline_index + 1]
+                if newline_index > self._frame_limit:
+                    raise ProtocolStreamError(oversized_frame_message(self._frame_limit))
+                return frame.decode("utf-8", errors="replace").strip()
+
+            if len(self._stdout_buffer) > self._frame_limit:
+                self._stdout_buffer.clear()
+                raise ProtocolStreamError(oversized_frame_message(self._frame_limit))
+
+            chunk = await self._stdout.read(self._read_chunk_size)
+            if not chunk:
+                if self._stdout_buffer:
+                    self._stdout_buffer.clear()
+                    raise ProtocolStreamError(incomplete_frame_message())
+                return None
+            self._stdout_buffer.extend(chunk)
+
+    def drain_stderr_lines(self) -> list[str]:
+        lines = list(self._stderr_lines)
+        self._stderr_lines.clear()
+        return lines
+
+    async def wait_closed(self) -> None:
+        if self._stderr_task is not None:
+            await self._stderr_task
+
+    async def _drain_stderr(self) -> None:
+        if self._stderr is None:
+            return
+
+        while True:
+            chunk = await self._stderr.read(self._read_chunk_size)
+            if not chunk:
+                break
+            self._stderr_buffer.extend(chunk)
+            self._consume_stderr_buffer(final=False)
+
+        self._consume_stderr_buffer(final=True)
+
+    def _consume_stderr_buffer(self, *, final: bool) -> None:
+        while True:
+            if self._stderr_skipping_line:
+                newline_index = self._stderr_buffer.find(b"\n")
+                if newline_index < 0:
+                    if final:
+                        self._stderr_buffer.clear()
+                        self._stderr_skipping_line = False
+                    return
+                del self._stderr_buffer[: newline_index + 1]
+                self._stderr_skipping_line = False
+                continue
+
+            newline_index = self._stderr_buffer.find(b"\n")
+            if newline_index >= 0:
+                frame = bytes(self._stderr_buffer[: newline_index + 1])
+                del self._stderr_buffer[: newline_index + 1]
+                line = frame.decode("utf-8", errors="replace").strip()
+                if line:
+                    self._stderr_lines.append(line)
+                continue
+
+            if len(self._stderr_buffer) > self._frame_limit:
+                self._stderr_lines.append(truncated_stderr_message(self._frame_limit))
+                self._stderr_buffer.clear()
+                self._stderr_skipping_line = True
+                return
+
+            if final:
+                line = self._stderr_buffer.decode("utf-8", errors="replace").strip()
+                self._stderr_buffer.clear()
+                if line:
+                    self._stderr_lines.append(line)
+            return