厌倦了在终端中手动与AI交互？OpenCode SDK为JavaScript和TypeScript开发者提供了一套完整的解决方案，能够通过编程方式深度控制AI会话、文件操作和界面交互。这套工具将开发者从命令执行者转变为自动化构建者，解锁了集成应用开发与AI编程生态扩展的全新可能，为构建高效的AI驱动应用奠定了坚实基础。
智能速览
通过 npm 即可快速安装 OpenCode SDK。
提供两种客户端初始化方式以适应不同环境。
核心功能在于程序化管理AI会话与消息交互。
支持文件搜索、TUI控制和实时事件监听。
最终目标是实现AI编程任务的全面自动化。
精华内容
告别手动敲命令，迈向编程自动化控制新阶段。OpenCode SDK正是这座桥梁，它将如何连接你的代码与AI，赋予应用真正的智能呢？
快速上手
安装过程极为简单，通过终端执行 `npm install @opencode/ai-sdk` 命令即可完成。初始化客户端时，SDK提供了两种灵活的方式。`createOpenCode` 函数能一步到位，同时启动服务器和客户端实例，非常适合新项目或独立脚本。若环境中已存在运行的服务器，则应使用 `createOpenCodeClient` 函数，只需传入包含 `baseURL` 的对象（如 `http://localhost:4096`），即可创建客户端并精准连接，实现了极高的灵活性和环境适应性。
会话管理
与AI的所有程序化互动均始于会话管理。Session API提供了核心功能，包括 `create` 创建新会话、`list` 列出所有已有会话、`messages` 查看聊天记录。其中最常用的是 `prompt` 方法，用于向AI发送消息。调用时需指定会话ID（`pass`参数），并在 `body` 中包含 `model` 和 `parts`（消息内容数组）。一个特别实用的参数是 `noReply`，将其设为 `true` 可向会话中注入上下文信息而不触发AI立即回复，这在构建复杂应用逻辑时至关重要。
强大API
除了会话管理，SDK还扩展了多个强大的API。`Files API` 允许代码直接在项目中执行搜索，无论是文本、文件名还是特定函数名，并能读取任何文件内容，为代码库自动化分析和重构提供了可能。`TUI API` 则打通了前后端，让代码能直接控制终端用户界面，实现自动填入文本、点击按钮等操作。`Events API` 提供了实时事件监听能力，让应用能对服务器端的状态变化做出毫秒级响应，是构建实时交互应用的关键。
OpenCode SDK将AI编程的控制权真正交还到开发者手中，从手动操作迈向了程序化、自动化集成的全新高度。它不仅是一个工具包，更是构建下一代AI驱动应用的基石。有了这套强大的API，你是否已经开始构思第一个属于自己的自动化项目或AI集成工具了呢？
