用途：帮助在 TypeScript 中调用 @onkernel/sdk（由 Kernel OpenAPI 规范经 Stainless 生成）及 React 辅助库 @onkernel/managed-auth-react，构建浏览器自动化智能体或应用。Kernel 以 unikernel 隔离 VM 运行每个浏览器，并将代码与浏览器就近部署以降低 CDP 延迟。
主要能力：创建与控制浏览器（kernel.browsers.create、cdp_ws_url、kernel.browsers.playwright.execute、kernel.browsers.computer.）；部署 Kernel App 并通过 kernel.invocations.create 调用（同步或 async + invocations.follow）；接入 Playwright、Stagehand 等框架；使用 profiles、browserPools、credentials、browsers.fs. 与 replays；实现 Managed Auth（auth.connections.* 与 <KernelManagedAuth />）。
两种模式：A 嵌入，在自己的服务中驱动 Kernel；B 部署，将长时间浏览器任务注册为 action，经 kernel deploy 部署后再调用。
关键规则：KERNEL_API_KEY 从环境变量读取，不硬编码；固定 SDK 小版本；browser.close() 不等于清理，必须调用 kernel.browsers.deleteByID(session_id)；同步调用约 100 秒上限，超时须用 async；浏览器只有一个默认上下文和页面，使用 browser.contexts()[0]；项目范围通过 defaultHeaders 传 X-Kernel-Project-Id；要求 TypeScript ≥ 4.9，Node 20+ 等运行时，不支持 React Native。
快速开始： bash scripts/scaffold-kernel-app.sh --mode embed --dir ./kernel-embed-demo cd ./kernel-embed-demo npm install export KERNEL_API_KEY=... npm run check npm run start 已有仓库可：npm install @onkernel/sdk@^$(npm view @onkernel/sdk version) playwright
限制：不适用于 agent-browser CLI、Python Kernel SDK，也不适用于非 Kernel 专属的 LangChain.js/LangGraph；payload 大小文档存在冲突，大文件建议走 browsers.fs.*；价格、计费与最新文档需查阅官方页面，此处暂未提供。