这个项目能做什么

opencode-pty 是 OpenCode 的一个插件,提供交互式伪终端(PTY)管理。它允许 AI 代理运行后台进程、发送交互式输入并按需读取输出,从而克服 OpenCode 内置同步 bash 工具的限制。 主要功能包括: - 后台执行长时间运行的进程(开发服务器、监听模式、交互式程序) - 多个同时进行的 PTY 会话 - 支持转义序列的交互式输入(例如 Ctrl+C) - 带分页和正则过滤的输出缓冲 - 退出通知,无需轮询 - 遵循 OpenCode 的 bash 权限设置 - 会话生命周期管理,自动清理 - 基于 React 的 Web UI,通过 WebSocket 实时流式传输 - 用于会话管理的 REST API 设置很简单:将 "opencode-pty" 添加到你的 OpenCode 配置中。对于 V2,使用 "opencode-pty/v2",并可选择端口和主机名等选项。 该插件提供工具:pty_spawn、pty_write、pty_read、pty_list、pty_kill,以及用于打开 Web UI 的斜杠命令。Web UI 提供会话列表、实时输出、发送输入和会话管理。 配置包括用于缓冲区大小和 Web 服务器设置的环境变量。权限会根据 OpenCode 的 bash 权限配置进行检查,但对 "ask" 权限有限制。 README 包含使用示例、会话生命周期图和开发说明。