@doubao-dev/kit

中文文档
0.10.0发布于 2026/11/16TypeScriptESM + CJS近 30 天下载 2629
中文使用文档
文档目录3 节
  1. Node.js SDK
  2. 独立命令
  3. 仓库内构建

@doubao-dev/kit

豆包应用插件的公开构建与调试工具,发布到公网 npm,版本跟随 SDK 发布组。 提供本地编译、开发服务器、Web 模拟器和 Node.js SDK,运行时不需要安装内部 Kit 包。

Node.js SDK

工具集成方安装 @doubao-dev/kit 后,从 /sdk 入口调用:

import { DoubaoAppsSDK } from '@doubao-dev/kit/sdk';

const sdk = new DoubaoAppsSDK('/absolute/path/to/app');
await sdk.build();

公开 SDK 提供 dev() 和 build(),参数见随包提供的 dist/exports/sdk.d.ts。 dev({ simulator: true }) 同时启动 Web 模拟器,返回的 closeServer() 用于关闭开发会话。 调用方可以通过 simulator.skillsReader 提供实时 Skill 内容,通过 output 接收编译日志和进度。 App 源清单使用 manifest.yaml;项目创建、部署、设备操作和自动化调试方法保留在内部 SDK。

独立命令

doubao 命令保留原有开发、构建、分析和部署能力:

corepack pnpm exec doubao dev
corepack pnpm exec doubao build
corepack pnpm exec doubao --help

独立命令通过调试插件提供 ADB、DevTools 和终端操作,不包含内部 HDT 能力。 doubao dev --web 或开发服务中的 web 命令可打开 Web 模拟器;在 Codex、Claude Code 等 agent 环境中, 预览和打开地址自动带上 ?embed=agent,使用适合内置面板的精简全页布局。 公开 SDK 的基础开发流程不会自动探测设备。 doubao deploy --token 供云构建编译并上传产物,参数见 Kit。

仓库内构建

corepack pnpm --filter @doubao-dev/kit... build
corepack pnpm --filter @doubao-dev/kit test

版本与发布记录

@doubao-dev/kit 共发布 24 个版本,首次发布于 2026/10/24;过去 12 个月发布了 24 个版本。

版本发布日期距今
0.10.0latest2026/11/16今天
0.9.0-canary-d8c42c341-20261116065912canary2026/11/16今天
0.9.0-canary-b615bb20c-202611151228102026/11/15今天
0.9.0-canary-925bd0dad-202611141212122026/11/141 天前
0.9.0-canary-39d9ef1e7-202611131214382026/11/132 天前
0.9.0-canary-942cf82c7-202611130826482026/11/132 天前

其他发布通道:rc → 0.8.0-rc.12,release-fix-0.9.1 → 0.9.1,canary → 0.9.0-canary-d8c42c341-20261116065912。

关于 @doubao-dev/kit 的常见问题

如何安装 @doubao-dev/kit?

在项目目录运行 npm install @doubao-dev/kit,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 doubao、doubao-apps,可以用 npx doubao 直接运行。

@doubao-dev/kit 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@doubao-dev/kit 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@doubao-dev/kit 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.13.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@doubao-dev/kit 可以商用吗?

@doubao-dev/kit 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@doubao-dev/kit 的下载量有多少?

根据 npm 官方下载统计,@doubao-dev/kit 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,629 次,日均约 88 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@doubao-dev/kit 还在维护吗?

最新版本 0.10.0 发布于 2026/11/16(今天);至今共发布 24 个版本,其中过去 12 个月发布了 24 个;首次发布于 2026/10/24。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。