这个项目能做什么
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 包含使用示例、会话生命周期图和开发说明。
评论
0 评分人数达到10人后显示
登录后参与讨论。