SuperAPI AI 工具集

opencode-dev

编程与开发

查看项目

更新于 10-15 16:49

技能介绍

用途:在 opencode 仓库开发时,交互式运行、调试和验证其 V2 CLI/TUI 与服务端。相关命令默认在 packages/cli 下执行;测试 TUI 时用本包的 bun dev,不要用仓库根目录的 bun dev(会启动旧的 packages/opencode CLI)。

架构:V2 是客户端/服务端系统。服务端(packages/server)运行 Effect HTTP API,持有会话、数据库、插件、权限等状态,由 serve 命令启动;TUI 是独立进程,本身不含应用逻辑,通过生成的 SDK 作为 HTTP/SSE 客户端连接。CLI 通过 ~/.local/state/opencode/service.json 注册文件发现共享服务端,并由 ~/.config/opencode/service.json 提供 HTTP Basic 认证;复用前会调用 GET /health 校验存活、鉴权与版本兼容。多个调用通常汇聚到一个共享后台守护进程,没有健康兼容守护进程时则以 serve --service 分离启动。--standalone 可让单次调用使用私有的一次性服务端。

主要用法:用 bun dev service start|status|stop|restart 管理共享后台守护进程;用 termctrl 启动并驱动 TUI(termctrl start opencode-v2-dev --host opentui --cols 112 --rows 34 -- bun dev,termctrl wait、show、send、save --format png、resize、restart、stop);服务端调试用 bun dev api(支持 get /health、get /openapi.json、操作 ID 或方法加路径,--param、--data/-d、--header/-H);日志位于 ~/.local/share/opencode/log/,本地开发用 opencode-local.log,含 run= 与 role= 标签,可用 OPENCODE_LOG_LEVEL、OPENCODE_PRINT_LOGS 控制。

限制:资料未提供收费、价格、平台与效果信息。堆快照需等待日志出现完成信息后才可打开,单次快照不能证明内存泄漏;CPU 分析由 SIGPROF 启动约十秒;GUI 与命令行分析工具应安装在仓库之外(如 /tmp/opencode)。