@doubao-dev/cli 1.0.0-rc.2 → 1.0.0-rc.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -12,7 +12,7 @@ metadata:
12
12
 
13
13
  使用 `@doubao-dev/cli` 提供的 `dbx`。需要安装时执行 `npm install -g @doubao-dev/cli`,参数以对应命令的 `--help` 为准。
14
14
 
15
- - 以 `plugin.json` 识别项目,保留已有 `id`;身份字段见 [项目配置](references/project-config.md#pluginjson身份与展示信息)。
15
+ - 以 `plugin.json` 识别项目,保留已有 `id` 和 `publicationType`;身份与发布类型字段见 [项目配置](references/project-config.md#pluginjson身份与展示信息)。
16
16
  - `dev`、`uninstall`、`upload`、`audit`、`versions`、`cancel-audit` 和 `skills` 向上查找最近的 `plugin.json`,也支持 `--cwd <项目内目录>`;执行前确认目标项目。
17
17
  - Agent 使用非 TTY 模式和完整参数;常驻进程按 [开发调试](references/development.md) 管理。
18
18
 
@@ -28,7 +28,7 @@ metadata:
28
28
  | 接入业务命令行工具 | [CLI 连接器](references/cli-connectors.md) |
29
29
  | 豆包 App 的页面、卡片、Manifest 和设备调试 | 项目内 `.agents/skills/doubao-plugin-app/SKILL.md` |
30
30
 
31
- 仅用户选择豆包 App 或项目已有 App 时使用 App Skill 并维护 Manifest;普通 MCP、MCP Apps 不需要 App Manifest。MCP Apps 与 App 可共存,不能仅凭页面或卡片需求替用户选择 App。
31
+ 企业专属插件暂不支持 App。仅用户选择豆包 App 或项目已有 App 时使用 App Skill 并维护 Manifest;普通 MCP、MCP Apps 不需要 App Manifest。MCP Apps 与 App 可共存,不能仅凭页面或卡片需求替用户选择 App。
32
32
 
33
33
  ## 登录
34
34
 
@@ -39,9 +39,11 @@ metadata:
39
39
 
40
40
  ## 操作影响
41
41
 
42
- - `dev` 会上传开发包并安装到当前用户;首次调试会按需保存平台草稿。
42
+ - Skill / MCP(含 MCP Apps)用 `dbx dev --plugin`。CLI 上传开发包,用 `package_id` 安装到当前账号,无需先创建草稿或获取插件 ID。
43
+ - App 用 `dbx dev --app` 启动本地编译和 Web 模拟器。只有缺少插件 ID 时才先保存草稿并写回 ID,用于查询 App 信息。
44
+ - 直接运行 `dbx dev` 默认调试 Skill / MCP。含 App 的项目在交互终端可切换到 App 调试。
43
45
  - `upload` 保存草稿和版本,输出实际版本号;含 App 时还会等待云构建并生成预览。
44
- - `audit` 读取当前草稿并显示本次提审版本,补齐草稿材料、保存对应版本并提交审核,不选择历史版本;非 TTY 可复用有效材料或通过 `--input` 补充。审核中不能修改草稿或再次上传,须等待审核结束;仅在用户要求时撤回审核。只执行用户要求的上传、提审或发布操作。
46
+ - `audit` 读取当前草稿并显示本次提审版本,补齐草稿材料和企业专属插件申请范围、保存对应版本并提交审核,不选择历史版本;企业专属插件范围交互和非 TTY 参数见 [上传与审核](references/upload.md)。审核中不能修改草稿或再次上传,须等待审核结束;仅在用户要求时撤回审核。只执行用户要求的上传、提审或发布操作。
45
47
  - 开发指引 `.agents/`、根目录 `AGENTS.md`、`.env` 和 `.env.*` 不进入上传包。
46
48
 
47
49
  ## 本地调试 MCP Server
@@ -4,9 +4,9 @@
4
4
 
5
5
  | 命令 | 行为 |
6
6
  | --- | --- |
7
- | `dbx dev` | 始终调试 Skill / MCP;含 App 时在交互终端询问是否同时调试 App,默认不启动;非 TTY 只调试 Skill / MCP |
7
+ | `dbx dev` | 默认调试 Skill / MCP。含 App 时在交互终端询问是否切换到 App 调试;非 TTY 沿用默认目标 |
8
8
  | `dbx dev --plugin` | 只调试 Skill / MCP |
9
- | `dbx dev --app` | 同时启动平台同步和 App 本地编译、Web 模拟器 |
9
+ | `dbx dev --app` | 启动 App 本地编译和 Web 模拟器 |
10
10
 
11
11
  `--plugin` 与 `--app` 互斥。App 编译、模拟器和设备操作见项目内 `.agents/skills/doubao-plugin-app/references/app-development.md`。
12
12
 
@@ -14,9 +14,9 @@
14
14
 
15
15
  需要有效登录态;交互终端未登录时会发起授权,非 TTY 环境应先按 CLI Skill 的登录说明完成授权。
16
16
 
17
- 缺少 `plugin.json.id` 时,启动前先上传项目、校验物料并保存平台草稿,将返回的 AbilityID 写回本地;失败则停止启动。这一步不保存版本、不生成预览、不提审,已有 ID 时跳过。
17
+ 启动 App 调试且缺少 `plugin.json.id` 时,CLI 先上传项目、校验物料并保存平台草稿,将返回的 AbilityID 写回本地。失败则停止启动。Skill / MCP 调试直接上传并安装开发包。已有插件 ID 时,CLI 会先核对平台发布类型。
18
18
 
19
- 平台同步监听业务 `skills/`、MCP 和插件配置,打包上传并安装到当前登录用户,后续变更重新同步安装,不提审、不发布。个人开发包不包含 App 目录;完整 App 包通过 `dbx upload` 上传,上传不执行个人安装。App 本地编译与平台同步并行,分别判断状态。
19
+ 平台同步监听业务 `skills/`、MCP 和插件配置,打包上传并安装到当前登录用户,后续变更重新同步安装,不提审、不发布。个人开发包不包含 App 目录;完整 App 包通过 `dbx upload` 上传,上传不执行个人安装。
20
20
 
21
21
  新增或移除 App 后重启并选择调试目标。
22
22
 
@@ -15,9 +15,10 @@
15
15
  | 命令 | 创建内容 |
16
16
  | --- | --- |
17
17
  | `dbx init <name>` | 空插件骨架:根配置与开发指引,需补充实际业务能力 |
18
+ | `dbx init <name> --type enterprise` | 企业专属插件骨架,保存 ENTERPRISE 发布类型 |
18
19
  | `dbx init <name> --app` | 增加 App、本地商品搜索端工具、业务 Skill、页面和卡片 |
19
20
 
20
- 目标目录须不存在或为空,初始化无需登录。非 TTY 环境传入项目名,以 `--app` 选择 App;交互终端可按提示选择。
21
+ 目标目录须不存在或为空。`--type public|enterprise` 指定发布类型。未指定类型时,`--app` 或非 TTY 默认使用 PUBLIC。其他交互场景会登录并查询企业插件发布权限,有权限时询问类型,否则直接使用 PUBLIC。显式指定 `--type enterprise` 时会校验发布权限。公开插件可用 `--app` 或交互提示选择 App。企业专属插件暂不支持 App。
21
22
 
22
23
  App 模式准备 Kit 和前端依赖;`--no-install-deps` 跳过依赖安装。安装失败保留项目,在 `com.doubao/app/` 重试 `pnpm install`。
23
24
 
@@ -29,7 +30,7 @@ App 模式准备 Kit 和前端依赖;`--no-install-deps` 跳过依赖安装。
29
30
  | `skills/<name>/SKILL.md` | 上传的业务能力与工具使用指引 |
30
31
  | `.agents/skills/` | 给开发 Agent 的指引,不上传为业务能力 |
31
32
 
32
- MCP 连接和展示信息放在插件根目录;`extensions["com.doubao"]` 适用于整个插件。平台扩展放在该命名空间,`id` 按下文处理,不自行增加顶层字段或改写模块位置。
33
+ MCP 连接和展示信息放在插件根目录;`extensions["com.doubao"]` 适用于整个插件。平台扩展放在该命名空间,`id` 和 `publicationType` 按下文处理,不自行增加其他顶层字段或改写模块位置。
33
34
 
34
35
  图标字段以 `./` 开头:Plugin、MCP 图标相对插件根目录,Skill 图标相对当前 Skill 目录。Skill 正文中的资源引用也相对当前 Skill 目录,解析后不得越出各自目录。引用文件须随包交付;CLI 不打包软链接,应保留实际文件。
35
36
 
@@ -41,6 +42,7 @@ MCP 连接和展示信息放在插件根目录;`extensions["com.doubao"]` 适
41
42
  {
42
43
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
43
44
  "name": "my-plugin",
45
+ "publicationType": "PUBLIC",
44
46
  "version": "0.0.1",
45
47
  "description": "根据关键词搜索商品",
46
48
  "extensions": {
@@ -60,7 +62,8 @@ MCP 连接和展示信息放在插件根目录;`extensions["com.doubao"]` 适
60
62
 
61
63
  - `name` 必填,是稳定包标识:1~64 字符,仅小写英文字母、数字、点号或连字符,首尾为字母或数字,不含连续 `--` 或 `..`;修改展示名称时保留它。
62
64
  - `description` 可选,为字符串,最多 1024 字符。
63
- - `id` 是开放平台 AbilityID,字符串类型,由 CLI 保存草稿后回填;有值时优先按它定位,否则按 `name`。保留已有值,不自行生成,不与 ActionHub PluginID 或 App 的 `app_key` 混用;该平台字段不在通用 schema 中。
65
+ - `id` 是开放平台 AbilityID,字符串类型,由 CLI 保存草稿后回填;有值时优先按它定位,首次上传没有 ID 时按 `name` 和发布类型定位。保留已有值,不自行生成,不与 ActionHub PluginID 或 App 的 `app_key` 混用;该平台字段不在通用 schema 中。
66
+ - `publicationType` 是 CLI 发布类型配置,只接受 `PUBLIC` 或 `ENTERPRISE`。`init --type` 保存该字段,`dev` 和 `upload` 共用;可见范围保存在平台草稿,按 [上传与审核](upload.md) 修改。没有 ID 时可修改本地类型;`dev`、`upload` 和 `audit` 在已有 ID 时核对平台主体类型,本地类型必须一致。缺少 ID 和类型字段的旧项目使用 PUBLIC;已有 ID 而缺少类型时从平台补回,查询失败或平台未返回有效类型时停止,不默认 PUBLIC。保留企业项目的类型字段,首次创建前删掉它会按 PUBLIC 处理。
64
67
  - 协议中的 `version` 可选,为字符串,提供时须与发布提交的版本一致。CLI 的 `dbx upload --version x.y.z` 仅接受无前导零的三段数字,覆盖上传包中的版本,不修改本地清单。
65
68
  - `mcpServers.shopping` 是服务展示信息;键集合须与 `mcp.json.mcpServers` 逐一对应,不能缺少或多出服务键。这里的 `shopping` 不是工具名 `search_products`。
66
69
 
@@ -15,6 +15,22 @@
15
15
 
16
16
  审核中服务端禁止修改当前草稿,`upload --version` 也不能绕过。须等待审核结束,或仅在用户要求时撤回当前审核后再操作;后续草稿版本以服务端返回为准。
17
17
 
18
+ 上传或 App 调试首次创建草稿时,使用 `plugin.json.publicationType`,类型配置规则见 [项目配置](project-config.md#pluginjson身份与展示信息)。`upload` 不提供类型或范围参数;企业专属插件首次创建草稿时默认仅本人,后续上传保留草稿范围。已有 ID 的审核与版本操作按 ID 定位;审核缺少本地 ID 时,按名称和项目发布类型查询已上传草稿并恢复 ID。确实没有草稿时先执行用户授权的上传,不通过审核命令隐式上传。
19
+
20
+ ## 企业专属插件可见范围
21
+
22
+ 企业专属插件交互式审核提供“仅本人”和“全租户”选项,草稿查询返回仅自己或全租户时,对应项标注“(当前范围)”并默认选中:
23
+
24
+ ```text
25
+ 请选择本次申请的可见范围
26
+ › 仅本人(当前范围)
27
+ 全租户
28
+ ```
29
+
30
+ 当前为指定对象时,额外显示默认选项“指定对象(当前)”;选择该项不传范围,保留平台配置,不根据对象列表推测是否仅本人。指定对象由平台管理,CLI 仍可选择改为仅本人或全租户,无额外确认。
31
+
32
+ `dbx audit --visibility self|tenant` 显式指定范围,跳过范围询问。选择结果随分类和审核材料保存到草稿,再保存版本、提交审核。公开插件不显示范围选择,也不能指定范围。
33
+
18
34
  审核材料包括一项意向分类、按鉴权要求提供的 MCP 测试账号或 Key、每个 Skill 和应用插件的 HTTP 或 HTTPS 评测报告地址和 5–10 条示例提示词,以及每个 CLI 的使用说明文档链接。OAuth 测试凭据必填;其他鉴权方式由服务端校验。已有材料会预填,脱敏凭据不修改则保留。
19
35
 
20
36
  图标声明位置与路径见 [项目配置](project-config.md),图片要求如下:
@@ -28,12 +44,23 @@
28
44
 
29
45
  校验失败按返回的文件和字段修复;提审失败保留版本号和错误信息,重试前确认当前草稿及 CLI 显示的提审版本,不为重试刻意上传新版本。
30
46
 
47
+ ### 公开上架合规声明
48
+
49
+ 声明随插件包上传,写在 `plugin.json` 的 `extensions["com.doubao"]` 中:
50
+
51
+ - `privacyPolicyUrl` 是插件的隐私政策页面链接,公开上架提审必填,使用 HTTPS 绝对 URL。
52
+ - `isMinorIncluded` 表示服务用户是否包含未成年人,使用字符串 `"true"` 或 `"false"`,缺失或为空时按 `"false"` 处理。填 `"true"` 时,隐私政策需说明未成年人个人信息处理规则。
53
+ - `specialLicenseUrl` 是特殊行业资质证明链接,选填,填写时使用 HTTPS 绝对 URL。
54
+
55
+ `dbx audit` 检查已上传草稿。交互模式首次配置时逐项引导填写,修正已有声明时只询问缺少的必填项或格式有误的字段。输入有误时在当前题重试。声明保存到本地 `plugin.json` 后,经开发者确认,CLI 重新上传整个项目(包括其他尚未上传的本地改动),更新平台草稿并继续提审。如果保存声明后退出,再次运行 `dbx audit` 可直接确认上传。非交互模式下,向开发者索取实际声明和链接,修正 `plugin.json` 后先运行 `dbx upload`,再运行 `dbx audit`。
56
+
31
57
  ### 非交互审核
32
58
 
33
59
  非 TTY 默认复用当前草稿的分类和有效材料,并显示本次提审版本;补充或修改时使用 `--input`。指定 `--input` 后不显示交互提示,无需提供版本号:
34
60
 
35
61
  ```sh
36
62
  dbx audit --cwd ./my-plugin --input ../audit-input.json
63
+ dbx audit --visibility tenant
37
64
  ```
38
65
 
39
66
  `--input` 的相对路径以项目根目录为基准。文件示例:
@@ -70,7 +97,9 @@ dbx audit --cwd ./my-plugin --input ../audit-input.json
70
97
 
71
98
  MCP Apps 兼容使用 `mcp_app.mcp.test_credential`。
72
99
 
73
- 分类 ID 通过 `dbx categories` 查询;`module_id` 使用服务端草稿返回值,不根据模块名称自行生成。当前 CLI 不提供草稿详情查询;拿不到模块 ID 时,在开放平台控制台完善草稿材料,再运行 `dbx audit` 复用。
100
+ 企业输入文件可增加 `"visibility_config": { "type": 1 }`(仅本人)或 `{ "type": 2 }`(全租户)。Devtool 写入使用独立范围类型,只接受 `type`,不接受 `entities`;`--visibility self` 对应 1,`tenant` 对应 2。草稿查询仍返回通用范围类型:2 为全租户、3 为指定对象、4 为仅自己,与写入类型分别处理。`--visibility` 与输入文件的 `visibility_config` 不能同时提供。省略范围时沿用草稿。
101
+
102
+ 分类 ID 通过 `dbx categories` 查询公开插件分类,企业专属插件分类使用 `dbx categories --type enterprise`;`module_id` 使用服务端草稿返回值,不根据模块名称自行生成。当前 CLI 不提供草稿详情查询;拿不到模块 ID 时,在开放平台控制台完善草稿材料,再运行 `dbx audit` 复用。
74
103
 
75
104
  未指定的材料沿用有效旧值,脱敏凭据不会作为新凭据上传;材料无效时在保存版本和提审前退出。
76
105
 
@@ -1 +1 @@
1
- import{listPluginVersions as e}from"./691.js";async function*i(i){let t,n=i.plugin.id?{ability_id:i.plugin.id}:{name:i.plugin.name},a=new Set;do{let{items:i=[],page:o}=await e({...n,page_size:20,page_token:t}),_=o?.next_page_token;if(_&&a.has(_))throw Error("版本列表返回了重复的分页标记,请稍后重试");_&&a.add(_),yield{items:i},t=_}while(t)}export{i as listProjectVersionPages};
1
+ import{listPluginVersions as e,pluginIdentity as t}from"./691.js";async function*o(o){let i,a=t(o.plugin),n=new Set;do{let{items:t=[],page:o}=await e({...a,page_size:20,page_token:i}),r=o?.next_page_token;if(r&&n.has(r))throw Error("版本列表返回了重复的分页标记,请稍后重试");r&&n.add(r),yield{items:t},i=r}while(i)}export{o as listProjectVersionPages};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@doubao-dev/cli",
3
- "version": "1.0.0-rc.2",
3
+ "version": "1.0.0-rc.4",
4
4
  "description": "Doubao Plugins CLI",
5
5
  "type": "module",
6
6
  "types": "./dist/index.d.ts",
@@ -20,28 +20,31 @@
20
20
  "README.md",
21
21
  "!dist/**/*.map"
22
22
  ],
23
+ "dependencies": {
24
+ "commander": "15.0.0",
25
+ "zod": "4.2.0"
26
+ },
23
27
  "devDependencies": {
28
+ "@byted-doubao-apps/build-shared": "0.9.0",
24
29
  "@clack/prompts": "0.11.0",
30
+ "@net-fe/cdn-upload-server": "0.1.8",
25
31
  "chalk": "5.6.2",
26
32
  "chokidar": "5.0.0",
27
- "commander": "15.0.0",
28
33
  "execa": "9.6.0",
29
34
  "fs-extra": "11.3.5",
30
35
  "mcp-apps-inspector": "0.1.0",
31
36
  "ofetch": "1.5.1",
32
37
  "open": "10.1.0",
33
38
  "ora": "8.1.0",
34
- "zod": "4.2.0",
39
+ "@byted-doubao-apps/cli": "1.0.0-rc.4",
40
+ "@doubao-dev/kit": "0.9.0",
41
+ "@doubao-dev/plugin-app-dev": "1.0.0-rc.4",
35
42
  "@rslib/core": "1.0.0-beta.1",
36
43
  "@types/node": "22.20.4",
37
44
  "@types/qrcode": "1.5.6",
38
45
  "qrcode": "1.5.4",
39
46
  "rimraf": "3.0.2",
40
47
  "typescript": "6.0.3",
41
- "@byted-doubao-apps/build-shared": "0.9.0",
42
- "@doubao-dev/kit": "0.9.0",
43
- "@byted-doubao-apps/cli": "1.0.0-rc.2",
44
- "@doubao-dev/plugin-app-dev": "1.0.0-rc.2",
45
48
  "@byted-doubao-apps/cli-ratatui": "0.4.0"
46
49
  },
47
50
  "engines": {
@@ -54,11 +57,6 @@
54
57
  ],
55
58
  "registry": "https://registry.npmjs.org"
56
59
  },
57
- "optionalDependencies": {
58
- "@doubao-dev/cli-tui-darwin-arm64": "1.0.0-rc.2",
59
- "@doubao-dev/cli-tui-darwin-x64": "1.0.0-rc.2",
60
- "@doubao-dev/cli-tui-win32-x64": "1.0.0-rc.2"
61
- },
62
60
  "scripts": {
63
61
  "build": "rimraf dist && rslib build",
64
62
  "clean": "rimraf dist"
package/dist/schema.js DELETED
@@ -1 +0,0 @@
1
- import{schemas_string as e,schemas_record as a,looseObject as o,schemas_unknown as i}from"./691.js";let m="项目名称须为 1 至 64 个小写字母、数字、连字符或点号,以字母或数字开头结尾,且不能包含连续连字符或连续点号。",n=e().max(64,m).regex(/^(?!.*(?:--|\.\.))[a-z0-9](?:[a-z0-9.-]*[a-z0-9])?$/,m),p=e().regex(/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/,"版本号须为 x.y.z 格式,不能包含前导零"),t=a(e(),i()),r=o({$schema:e().optional(),name:n,id:e().optional(),displayName:e().optional(),description:e().optional(),extensions:t.optional()}),c=o({mcpServers:a(e(),t)});export{c as mcpConfigSchema,r as pluginManifestSchema,n as projectNameSchema,p as versionSchema};