用途:这是一个针对 Open Code TUI(桌面或 CLI)的通用开发技能,当用户需要构建、修改、调试或理解 Open Code 的任一功能时使用,基于 opencode v1.7.1。
主要能力:提供参考代码库与架构说明,包括 packages/tui(TUI 核心,Solid.js + @opentui)、packages/sdk/js(SDK v1 与 v2 客户端)、packages/server(Express + Effect HttpApi 服务端)、packages/opencode(CLI 与核心逻辑)。技术栈涉及 Solid.js + @opentui/solid + @opentui/core、solid-js/store、SSE 与本地 EventEmitter、@hey-api/openapi-ts 生成的 HTTP 客户端、Effect HttpApi、@opencode-ai/sdk v1 类型、Turborepo monorepo。还描述了从 ExitProvider 到 EditorContextProvider 的 Provider Tree 层级,以及初始化流程中的入口 run()、SyncProvider 引导(阻塞式调用 config.providers()、provider.list()、app.agents()、config.get()、project.sync(),以及 -c 模式下的 session.list();非阻塞后台调用 session.list()、command.list()、lsp.status()、mcp.status()、formatter.status()、session.status()、provider.auth()、vcs.get())、状态流转 loading→partial→complete、SDKProvider 使用 createOpencodeClient({ baseUrl }) 与 SSE 指数退避重连(1s→30s)、事件 16ms 批量渲染。
使用方式:内容按模块拆分按需加载,根据用户问题读取对应文件,如 SESSION.md(会话数据模型、消息类型、工具状态机等)、PERMISSION.md(权限与提问流程)、PROVIDER.md(项目、provider、模型、认证、智能体)、SYNC.md(同步存储与 SSE 事件目录)、API.md(TUI 控制 API、各 SDK 方法、OpenAPI 参考)、INDEX.md(TUI 文件索引与实现准则)。
适用场景与限制:适合参与 Open Code TUI 开发与排障的阅读参考;资料未提供完整安装命令、更细的版本兼容范围与实际运行验证结果。