@doubao-dev/cli 1.0.0-rc.1 → 1.0.0-rc.12

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.
Files changed (77) hide show
  1. package/README.md +12 -6
  2. package/dist/691.js +96 -0
  3. package/dist/build.js +1 -0
  4. package/dist/categories.js +1 -1
  5. package/dist/command.js +9 -3
  6. package/dist/command~1.js +4 -4
  7. package/dist/command~2.js +1 -1
  8. package/dist/command~3.js +2 -1
  9. package/dist/command~4.js +1 -1
  10. package/dist/command~5.js +6 -5
  11. package/dist/dist.js +1 -1
  12. package/dist/draft.js +2 -2
  13. package/dist/index.d.ts +886 -8
  14. package/dist/index.js +1 -1
  15. package/dist/main.d.ts +886 -8
  16. package/dist/main.js +1 -1
  17. package/dist/mcp-apps-inspector.js +1 -0
  18. package/dist/multipart-parser.js +1 -1
  19. package/dist/open.js +2 -0
  20. package/dist/plugin.js +2 -2
  21. package/dist/preview.js +5 -5
  22. package/dist/progress.js +1 -1
  23. package/dist/ratatui-ui.js +1 -1
  24. package/dist/session.js +1 -1
  25. package/dist/skills/doubao-plugin-cli/SKILL.md +45 -40
  26. package/dist/skills/doubao-plugin-cli/references/cli/development.md +128 -0
  27. package/dist/skills/doubao-plugin-cli/references/cli/project.md +190 -0
  28. package/dist/skills/doubao-plugin-cli/references/cli/release.md +144 -0
  29. package/dist/skills/doubao-plugin-cli/references/examples/todo-example.md +114 -0
  30. package/dist/skills/doubao-plugin-cli/references/examples/workbench-example.md +130 -0
  31. package/dist/skills/doubao-plugin-cli/references/protocols/business-skills.md +49 -0
  32. package/dist/skills/doubao-plugin-cli/references/protocols/cli-connectors.md +56 -0
  33. package/dist/skills/doubao-plugin-cli/references/protocols/managed-agents.md +46 -0
  34. package/dist/skills/doubao-plugin-cli/references/protocols/mcp-apps/integration.md +207 -0
  35. package/dist/skills/doubao-plugin-cli/references/protocols/mcp-apps/runtime.md +318 -0
  36. package/dist/skills/doubao-plugin-cli/references/protocols/mcp-apps/workbench.md +180 -0
  37. package/dist/skills/doubao-plugin-cli/references/protocols/mcp-auth.md +73 -0
  38. package/dist/skills/doubao-plugin-cli/references/protocols/mcp-config.md +145 -0
  39. package/dist/skills/doubao-plugin-cli/references/protocols/mcp-events.md +260 -0
  40. package/dist/skills/doubao-plugin-cli/references/protocols/plugin-json.md +95 -0
  41. package/dist/skills/doubao-plugin-cli/references/protocols/workbench.md +120 -0
  42. package/dist/skills/doubao-plugin-cli/references/upstream/SOURCES.md +32 -0
  43. package/dist/skills/doubao-plugin-cli/references/upstream/mcp-apps.LICENSE +216 -0
  44. package/dist/skills/doubao-plugin-cli/references/upstream/mcp-apps.mdx +1760 -0
  45. package/dist/skills/doubao-plugin-cli/references/upstream/mcp-events.LICENSE +216 -0
  46. package/dist/skills/doubao-plugin-cli/references/upstream/mcp-events.md +1231 -0
  47. package/dist/skills/doubao-plugin-cli/references/upstream/standard-webhooks.LICENSE +201 -0
  48. package/dist/skills/doubao-plugin-cli/references/upstream/standard-webhooks.md +349 -0
  49. package/dist/skills/miaoda-mcp-dev/SKILL.md +20 -0
  50. package/dist/skills/miaoda-mcp-dev/references/app-plugin-mcp.md +9 -0
  51. package/dist/skills/miaoda-mcp-dev/references/development.md +62 -0
  52. package/dist/skills/miaoda-mcp-dev/references/todo-example.md +128 -0
  53. package/dist/templates/standard/AGENTS.md +1 -1
  54. package/dist/templates/workbench/README.md.template +9 -0
  55. package/dist/templates/workbench/com.doubao/workbench/manifest.json +10 -0
  56. package/dist/uninstall.js +1 -1
  57. package/dist/versions~1.js +1 -1
  58. package/dist/web/index.html +1 -0
  59. package/dist/web/sandbox-proxy.html +101 -0
  60. package/dist/web/static/css/index.b3102f16b9.css +1 -0
  61. package/dist/web/static/js/155.747f5232dc.js +69 -0
  62. package/dist/web/static/js/async/970.86106314b5.js +1 -0
  63. package/dist/web/static/js/index.c1186260b9.js +4 -0
  64. package/dist/web/static/js/lib-react.00514652bf.js +2 -0
  65. package/dist/web/static/js/lib-react.00514652bf.js.LICENSE.txt +39 -0
  66. package/dist/workbench-search.js +1 -0
  67. package/dist/xdg-open +1267 -0
  68. package/package.json +14 -15
  69. package/dist/21.js +0 -101
  70. package/dist/schema.js +0 -1
  71. package/dist/skills/doubao-plugin-cli/references/cli-connectors.md +0 -29
  72. package/dist/skills/doubao-plugin-cli/references/development.md +0 -29
  73. package/dist/skills/doubao-plugin-cli/references/mcp-apps.md +0 -40
  74. package/dist/skills/doubao-plugin-cli/references/mcp-auth.md +0 -23
  75. package/dist/skills/doubao-plugin-cli/references/project-config.md +0 -139
  76. package/dist/skills/doubao-plugin-cli/references/upload.md +0 -77
  77. /package/dist/{21.js.LICENSE.txt → 691.js.LICENSE.txt} +0 -0
@@ -0,0 +1,114 @@
1
+ # TODO 插件与 MCP Apps 示例
2
+
3
+ 本例统一待办服务的业务契约、MCP Apps 交互与插件接入。已有服务按真实 schema 调整配置,不将平台 SDK 写法当作 MCP 协议。
4
+
5
+ 使用妙搭时,读取 `miaoda-mcp-dev` Skill 的 `references/todo-example.md`。
6
+
7
+ ## 业务契约
8
+
9
+ 个人待办包含 `id`、`title`、`completed`;ID 由服务生成,标题去空白后长度为 1–200 个字符。持久化记录另存所属用户,身份由已验证的请求上下文提供,不从工具入参接受用户 ID。查询和写入都限制当前用户,业务结果不返回内部身份或审计字段。
10
+
11
+ | 工具 | 输入 | structuredContent | 行为 |
12
+ | --- | --- | --- | --- |
13
+ | `todo_list` | 可选 `completed`;`offset=0`、`limit=20`,上限 50 | `{ items: [{ id, title, completed }], nextOffset }` | 按稳定顺序分页,末页 `nextOffset=null` |
14
+ | `todo_create` | `title` | `{ todo: { id, title, completed } }` | 新建未完成待办;重复调用会新增 |
15
+ | `todo_complete` | `id`、可选 `completed=true` | `{ todo: { id, title, completed } }` | 设置目标状态,重复设置不改变结果;不可访问返回 `TODO_NOT_FOUND` |
16
+ | `todo_delete` | `id` | `{ deleted: boolean }` | 删除本人待办,未找到可删除项时返回 false |
17
+
18
+ 每个工具声明对应的输入、输出 schema,并提供独立可读的 `content`。查询工具标注只读;创建工具非幂等,设置状态和删除工具幂等;删除工具标注破坏性。业务失败使用 `isError: true` 及解释性结果,协议字段按 [MCP 配置](../protocols/mcp-config.md) 与上游标准维护。
19
+
20
+ ## 可选 MCP Apps 界面
21
+
22
+ 通过 `todo_list` 的 `_meta.ui.resourceUri` 关联 `ui://todo/list`,资源返回已构建的 HTML。具体字段、资源媒体类型、权限与生命周期见 [MCP Apps 接入](../protocols/mcp-apps/integration.md#接通工具与界面)。
23
+
24
+ 界面接收工具结果中的 `items` 并渲染列表;新增、勾选和删除分别调用上表工具,成功后调用 `todo_list` 刷新列表。分页沿用返回的 `nextOffset`。初次工具结果可能早于 UI 就绪,按 SDK 生命周期先注册处理器再连接;从静态入口打开且尚无结果时主动查询。空列表、未授权及业务失败在界面中给出对应反馈。
25
+
26
+ 平台 SDK 可封装注册与连接,工具契约和验收目标保持相同。
27
+
28
+ ## 目录与完整配置
29
+
30
+ ```text
31
+ todo-demo/
32
+ ├── plugin.json
33
+ ├── mcp.json
34
+ └── skills/
35
+ └── todo-list/
36
+ └── SKILL.md
37
+ ```
38
+
39
+ 新项目可用 `dbx init <项目名>` 创建骨架,再按字段合并以下配置;已有项目保留身份和其他能力配置。命名、必填字段及路径约束分别见 [根清单](../protocols/plugin-json.md)、[MCP 配置](../protocols/mcp-config.md)、[业务 Skill](../protocols/business-skills.md)。
40
+
41
+ ### plugin.json
42
+
43
+ 按项目实际名称、发布类型和展示信息填写;下例以公开类型为例:
44
+
45
+ ```json
46
+ {
47
+ "name": "todo-demo",
48
+ "publicationType": "PUBLIC",
49
+ "description": "查看、新增、完成和删除待办",
50
+ "extensions": {
51
+ "com.doubao": {
52
+ "displayName": { "zh": "待办清单" },
53
+ "mcpServers": {
54
+ "todo": {
55
+ "displayName": { "zh": "待办服务" },
56
+ "displayDescription": { "zh": "查看、新增、完成和删除待办" }
57
+ }
58
+ }
59
+ }
60
+ }
61
+ }
62
+ ```
63
+
64
+ ### mcp.json
65
+
66
+ 将占位地址替换为已验证的实际 HTTPS MCP endpoint:
67
+
68
+ ```json
69
+ {
70
+ "mcpServers": {
71
+ "todo": {
72
+ "type": "streamable-http",
73
+ "url": "https://example.com/mcp"
74
+ }
75
+ }
76
+ }
77
+ ```
78
+
79
+ 两个 JSON 文件中的服务键统一为 `todo`:连接配置使用 `mcpServers.todo`,展示配置使用 `extensions["com.doubao"].mcpServers.todo`。Skill 正文中的工具名须与服务实际返回的 `tools/list` 一致。
80
+
81
+ ### skills/todo-list/SKILL.md
82
+
83
+ 按实际工具 schema 调整正文,并补充服务的数据保存与可见范围说明。正式发布前使用唯一的 Skill 名称,保持 `name` 与目录一致:
84
+
85
+ ```markdown
86
+ ---
87
+ name: todo-list
88
+ description: 当用户需要查看、新增、完成或删除待办时使用。
89
+ metadata:
90
+ display_name: 待办清单
91
+ display_description: 查看、新增待办,并将已完成的任务标记为完成。
92
+ ---
93
+
94
+ # 待办清单
95
+
96
+ - 查看待办:调用 `todo_list({})`,空列表为 `items: []`。
97
+ - 新增待办:调用 `todo_create({ "title": "用户提供的标题" })`,标题去除首尾空白后不能为空,ID 由服务生成。
98
+ - 完成待办:从 `todo_list` 的真实结果取得 ID,再调用 `todo_complete({ "id": "实际 ID" })`;同名多项且目标不明时先澄清,重复完成不改变状态。
99
+ - 删除待办:用户要求删除时,从实际列表确认目标 ID,再调用 `todo_delete({ "id": "实际 ID" })`。
100
+
101
+ 成功结果包含可读 `content` 和 `structuredContent`:查询返回 `items` 和 `nextOffset`,创建或设置状态返回 `todo`,删除返回 `deleted`。待办记录包含 `id`、`title`、`completed`。只按真实结果报告操作状态,不虚构待办或 ID。
102
+
103
+ 工具业务失败返回 `isError: true` 和原因;连接、协议或授权失败按实际报错处理。未知 ID 时重新读取列表;新增请求超时或断线时先读取并核对结果,不能直接重试造成重复。
104
+ ```
105
+
106
+ ## 调试与验证
107
+
108
+ 1. 替换占位地址,按实际服务配置 [鉴权](../protocols/mcp-auth.md)。Streamable HTTP 服务可用 `dbx inspect --mcp-server <实际地址>` 检查工具、输入 schema 和结果,并直接调用验证空标题、未知 ID 等错误边界。
109
+ 2. 按 [开发调试](../cli/development.md) 登录并运行 `dbx dev --plugin --once`,确认同步和当前账号安装成功。
110
+ 3. 在目标宿主依次请求“新增待办:整理本周计划”“查看待办”“完成整理本周计划”,核对同一 ID 的状态变化;新会话查询仍保持状态。
111
+ 4. 已选 MCP Apps 时,按 [CSP 域名清单](../protocols/mcp-apps/integration.md#csp-域名清单)核对构建产物和声明;实际打开列表,在界面新增并勾选待办,再通过工具查询确认相同变更。读取到 HTML 或独立网页可访问不能代替宿主界面验收。
112
+ 5. 验证空列表、未知 ID 和缺少授权的反馈;有多用户隔离要求时以另一身份确认无法读取或修改前一用户的待办。按本次授权删除测试数据并读回确认。
113
+
114
+ 保存版本时按 [版本交付与审核](../cli/release.md) 执行。
@@ -0,0 +1,130 @@
1
+ # 合同工作台示例
2
+
3
+ 本例保留宿主首页,增加欢迎语、查询待签合同的推荐、合同管理导航和帮助菜单。推荐指向已有的商店插件,导航打开本工作台接入的 MCP 页面。试用前准备实际的推荐资源、MCP 服务和帮助地址。
4
+
5
+ ## 创建工作台
6
+
7
+ ```sh
8
+ dbx init contract-workbench --type public --workbench
9
+ cd contract-workbench
10
+ ```
11
+
12
+ 在生成的 `plugin.json` 中填写 `description`,将 `extensions["com.doubao"].displayName.zh` 设为「合同工作台」,保留骨架的其他字段。已有工作台沿用原来的 `id` 和 `publicationType`。目录见 [工作台目录结构](../cli/project.md#定制工作台)。
13
+
14
+ ## 接入合同 MCP 服务
15
+
16
+ 在项目根目录创建 `mcp.json`。将 URL 替换为本项目实际使用的 Streamable HTTP MCP endpoint,按服务要求配置 [鉴权](../protocols/mcp-auth.md)。
17
+
18
+ ```json
19
+ {
20
+ "mcpServers": {
21
+ "legal": {
22
+ "type": "streamable-http",
23
+ "url": "https://example.com/mcp"
24
+ }
25
+ }
26
+ }
27
+ ```
28
+
29
+ 本例假设服务提供 `open_dashboard` 工具,接受 `{}`,并按 [MCP Apps 静态入口](../protocols/mcp-apps/integration.md#静态入口与-ui-来源) 声明 `global` 入口和支持 `fullscreen` 的 UI Resource。下文导航的 `tool.server` 对应服务键 `legal`,`tool.name` 对应实际工具名。
30
+
31
+ ## 声明预装资源
32
+
33
+ 按 [资源搜索与回执映射](../cli/project.md#配置工作台预装资源) 找到已有的合同插件,并填写 `com.doubao/workbench/preinstall-resources.json`。下例的 `example-resource-id` 是占位值。
34
+
35
+ ```json
36
+ {
37
+ "preinstallResources": [
38
+ {
39
+ "type": "plugin",
40
+ "id": "example-resource-id",
41
+ "source": "store"
42
+ }
43
+ ]
44
+ }
45
+ ```
46
+
47
+ ## 工作台 Manifest
48
+
49
+ 将以下配置写入 `com.doubao/workbench/manifest.json`,替换本项目的资源和地址:
50
+
51
+ - 首页推荐:使用上一节选中的 `type` 和 `id`。
52
+ - 欢迎区和导航图标:文件放在 `com.doubao/workbench/assets/`,没有图片时省略相应 `icon`。
53
+ - 帮助菜单:将 `https://example.com/help` 换成实际 HTTPS 地址。
54
+
55
+ ```json
56
+ {
57
+ "schemaVersion": "1.0",
58
+ "additionalContext": "当前为合同工作台。回答合同问题时说明依据。",
59
+ "reconfig": {
60
+ "home": {
61
+ "mode": "overlay",
62
+ "welcome": {
63
+ "title": "今天需要处理什么合同?",
64
+ "icon": "assets/welcome.png"
65
+ },
66
+ "suggestions": [
67
+ {
68
+ "target": {
69
+ "type": "plugin",
70
+ "id": "example-resource-id"
71
+ },
72
+ "items": [
73
+ {
74
+ "text": "查询待签合同",
75
+ "prompt": "列出我当前待签署的合同。"
76
+ }
77
+ ]
78
+ }
79
+ ]
80
+ },
81
+ "nav.rail": {
82
+ "mode": "overlay",
83
+ "items": [
84
+ {
85
+ "text": "合同管理",
86
+ "icon": "assets/contracts.png",
87
+ "entrypoint": {
88
+ "type": "global",
89
+ "target": {
90
+ "type": "mcp-tool",
91
+ "tool": {
92
+ "server": "legal",
93
+ "name": "open_dashboard"
94
+ }
95
+ }
96
+ }
97
+ }
98
+ ]
99
+ },
100
+ "settings.more-menu": {
101
+ "mode": "overlay",
102
+ "items": [
103
+ {
104
+ "id": "help",
105
+ "text": "帮助",
106
+ "action": {
107
+ "type": "open-link",
108
+ "target": {
109
+ "type": "link",
110
+ "url": "https://example.com/help"
111
+ }
112
+ }
113
+ }
114
+ ]
115
+ }
116
+ }
117
+ }
118
+ ```
119
+
120
+ 如果要把帮助链接换成 MCP 页面,使用上例导航的 `entrypoint` 结构替换 `action`。区域与字段规则见 [工作台作者配置](../protocols/workbench.md#工作台作者配置)。
121
+
122
+ ## 同步与试用
123
+
124
+ 按 [开发调试](../cli/development.md#启动调试) 运行 `dbx dev --workbench --once`,同步并切换到本次工作台开发版,然后逐项验证:
125
+
126
+ 1. 首页显示欢迎语。点「查询待签合同」后,输入框预填请求并选中对应的推荐插件。发送后核对结果依赖的是本次选择的插件和授权。
127
+ 2. 点左侧「合同管理」打开 MCP 页面。若页面需要访问合同数据,用当前账号验证一条只读查询。
128
+ 3. 点头像菜单的「帮助」,核对打开的是刚才配置的 HTTPS 地址。
129
+
130
+ 要将整个首页换成随包网页时,使用 [Takeover Manifest 示例](../protocols/workbench.md#takeover-随包-html-首页)。要保存版本或提审时,按 [版本交付与审核](../cli/release.md) 执行。
@@ -0,0 +1,49 @@
1
+ # 业务 Skill
2
+
3
+ 声明应用插件的业务能力与工具使用方法;开发 Agent 自身的指引放在 `.agents/skills/`。
4
+
5
+ ## 文件位置与最小示例
6
+
7
+ 固定为 `skills/<name>/SKILL.md`,必须是 `skills/` 的直接子目录。以下内容保存为 `skills/product-search/SKILL.md`:
8
+
9
+ ```markdown
10
+ ---
11
+ name: product-search
12
+ description: 用户希望按关键词搜索商品、查看规格或价格时,调用 shopping 服务的 search_products 工具。
13
+ metadata:
14
+ display_name: 商品搜索
15
+ display_description: 根据关键词搜索商品,查看名称、规格和价格。
16
+ ---
17
+
18
+ # 商品搜索
19
+
20
+ 按 search_products 的实际 inputSchema 组织参数并调用;依据工具结果展示商品,无结果或失败时说明原因。
21
+ ```
22
+
23
+ 示例服务和工具名须替换为实际值;添加远程服务时同时维护 [MCP 配置](mcp-config.md) 和 [展示信息](plugin-json.md#展示字段)。
24
+
25
+ ## Frontmatter 字段
26
+
27
+ | 字段 | 类型 | 必填 | 约束与取值来源 |
28
+ | --- | --- | --- | --- |
29
+ | `name` | string | 是 | 1~64 字符,小写字母、数字和连字符;首尾不为连字符、不含 `--`,与目录名一致 |
30
+ | `description` | string | 是 | 非空,最多 300 字符;说明适用任务,供 Agent 选择能力 |
31
+ | `metadata` | 字符串映射 | 是 | 所有值均为字符串 |
32
+ | `metadata.display_name` | string | 是 | 非空,最多 128 字符,面向用户的名称 |
33
+ | `metadata.display_description` | string | 是 | 非空,最多 1024 字符,面向用户的简介 |
34
+ | `metadata.icon` | string | 否 | 以 `./` 开头,相对当前 Skill 目录;格式见 [图标要求](../cli/release.md#上传物料与图标) |
35
+
36
+ 运行时图标缺失或不可用时,依次使用 Plugin 图标、客户端默认图标。导入包缺少展示文案时,名称和简介分别回退到标准 `name`、`description`;回退不改变任务识别、执行说明或发布必填要求。
37
+
38
+ ## 文件级与关联约束
39
+
40
+ - YAML 同一映射内不允许重复键,包括 `metadata`。
41
+ - 正式发布时 Skill 名称须全平台唯一;个人调试由服务端派生隔离名称,源包名称保持不变。Plugin 名称可含点号,Skill 名称不可。
42
+ - 正文只补充完成任务需要的输入、工具或命令、结果解释与失败处理;MCP 参数以实际 `tools/list.inputSchema` 为准。
43
+ - 资料、脚本和模板按需放入 `references/`、`scripts/`、`assets/`,从正文链接并说明何时读取;引用和交付规则见 [路径与打包](../cli/project.md#路径与打包)。
44
+
45
+ ## 修改与验证
46
+
47
+ 在目标宿主实际加载业务 Skill 和所需资料,用本项目业务样例核对规则应用与输出。包内脚本从自身目录引用资料,使用演示数据或临时目录自测,不预设用户真实数据目录。
48
+
49
+ App Web 模拟器只读取 `SKILL.md` 正文,不加载附件;需要附件或脚本的完整任务应在支持它们的目标宿主验证。
@@ -0,0 +1,56 @@
1
+ # 业务 CLI 连接器配置
2
+
3
+ 声明业务命令行工具的安装、授权和状态检查。业务 CLI 自行管理登录态,其授权与 `dbx auth` 开发者登录独立。只有插件运行时需要调用业务命令才声明连接器;开发使用的 `dbx` 或托管平台 CLI 不属于交付组件。
4
+
5
+ 这是豆包插件包的 CLI 声明扩展,不继承 MCP 的连接、工具调用或 OAuth 消息格式。下文定义宿主如何选择并执行配置的命令;业务命令的参数、输出和退出码由所接入的 CLI 自身定义。
6
+
7
+ ## 文件位置与最小示例
8
+
9
+ 固定为 `com.doubao/cli.json`,无需在 `plugin.json` 重复登记。将以下包名、命令及状态正则替换为实际工具配置:
10
+
11
+ ```json
12
+ {
13
+ "connectors": {
14
+ "route-helper": {
15
+ "install": { "default": ["npm install -g @example/route-helper"] },
16
+ "versionCheck": { "default": ["route-helper version"] },
17
+ "auth": { "default": ["route-helper login"] },
18
+ "unAuth": { "default": ["route-helper logout"] },
19
+ "status": { "default": ["route-helper status"] },
20
+ "statusMatchRegex": "^logged in as .+$"
21
+ }
22
+ }
23
+ }
24
+ ```
25
+
26
+ ## 字段定义
27
+
28
+ 以下连接器子字段位于 `connectors.<名称>`。命令映射使用 `darwin`、`linux`、`win32`、`default` 为键,值为非空字符串数组。
29
+
30
+ | 字段 | 类型 | 必填 | 约束与取值来源 |
31
+ | --- | --- | --- | --- |
32
+ | `connectors` | object | 是 | 非空,每包最多 1 个连接器;名称非空、无首尾空白,且不与 MCP 服务同名 |
33
+ | `install` | 命令映射 | 是 | 使用目标宿主支持且可访问的包源安装业务工具 |
34
+ | `versionCheck` | 命令映射 | 否 | 工具提供的版本查询命令 |
35
+ | `auth` | 命令映射 | 按鉴权需要 | 工具的登录或授权入口 |
36
+ | `unAuth` | 命令映射 | 否 | 退出登录或撤销授权;具体清理由业务 CLI 实现 |
37
+ | `status` | 命令映射 | 按鉴权需要 | 查询授权状态的命令 |
38
+ | `statusMatchRegex` | string | 配置授权时提供 | 合法正则,匹配 `status` 标准输出表示已授权;按实际输出编写 |
39
+
40
+ ## 命令选择与执行语义
41
+
42
+ - 每个已提供的命令映射须含 `linux` 或 `default`,每条命令非空。优先当前系统项,缺少时回退 `default`。
43
+ - Linux 选中的安装项只支持 npm 安装,推荐 `npm install -g <包名>`;多条命令分项顺序执行,任一失败即安装失败。不支持随包二进制文件或 Package 型连接器。
44
+ - 需要授权时同时配置 `auth`、`status` 和 `statusMatchRegex`。退出码、标准错误用于诊断,不能用正则结果代替执行错误。
45
+ - 配套 [业务 Skill](business-skills.md) 说明适用请求、业务命令参数、输出和退出码,以及未安装、未授权、无网络和执行失败时的处理。真实凭据不写入 `cli.json`。
46
+ - 单项安装、授权或状态检查失败只停用对应 CLI;JSON 或根结构无效、无法定位错误项时停用 CLI 模块,其他能力不受影响。
47
+
48
+ 以上述配置在 Linux 执行为例:没有 `linux` 项时选择 `default` 安装命令;授权后执行 `route-helper status`,只有命令执行成功且标准输出匹配 `statusMatchRegex` 才判定已授权。安装成功、版本可读和已授权是三个不同状态;业务调用仍可因资源权限或网络错误失败。
49
+
50
+ ## 修改与验证
51
+
52
+ 在目标宿主分别验证安装、授权和业务调用。`cli.json` 修改的同步方式见 [开发调试](../cli/development.md#配置变更的同步边界)。
53
+
54
+ ### 支持与兼容边界
55
+
56
+ `versionCheck`、`unAuth` 的声明不保证目标客户端已实现相应操作,使用前核对其支持范围。命令的平台键仅决定执行环境中的命令选择,不替代根清单中的商店平台可见性声明。
@@ -0,0 +1,46 @@
1
+ # 工作伙伴声明
2
+
3
+ 在应用插件中引用已接入豆包的 Managed Agent,并声明其业务职责;不在插件包中创建或复制远端伙伴配置。
4
+
5
+ 需要获取伙伴 ID 时,请在豆包会话中 @目标工作伙伴,让豆包提取伙伴 ID,再将结果粘贴到当前会话。配置要求下方定义的完整 AgentUID;取得短 ID 时先确认转换关系,不自行补前缀。
6
+
7
+ ## 文件位置与最小示例
8
+
9
+ 每个 `com.doubao/agents/<name>.json` 引用一个伙伴。平台只读取该目录的直接子文件,以 `id` 识别伙伴,文件名用于组织声明。目录可省略,无需在 `plugin.json` 重复登记。
10
+
11
+ 以下内容可保存为 `com.doubao/agents/contract-review.json`;`id` 必须替换为实际伙伴的完整 AgentUID:
12
+
13
+ ```json
14
+ {
15
+ "description": "审阅合同条款,识别风险并提出修改建议。",
16
+ "type": "managed",
17
+ "id": "agent_example"
18
+ }
19
+ ```
20
+
21
+ ## 字段定义
22
+
23
+ | 字段 | 类型 | 必填 | 约束与取值来源 |
24
+ | --- | --- | --- | --- |
25
+ | `description` | string | 是 | 1~1024 字符;由开发者描述伙伴在当前插件中的职责和适用任务 |
26
+ | `type` | string | 是 | 见下方类型枚举;区分大小写,无默认值 |
27
+ | `id` | string | 是 | 已有伙伴的完整 AgentUID,以 `agent_` 开头且后缀非空;不接受短 ID,不自行生成 |
28
+
29
+ `type` 的枚举:
30
+
31
+ | 值 | 含义 |
32
+ | --- | --- |
33
+ | `managed` | 引用已接入豆包的工作伙伴 |
34
+
35
+ ## 文件级与关联约束
36
+
37
+ - 每包最多引用 5 个伙伴,AgentUID 在包内唯一,与 Skill、MCP 数量分别计数。
38
+ - 三个字段均须包含非空白字符;`type`、`id` 不得含首尾空白。
39
+ - 文件为 UTF-8 JSON 对象,各层同一对象内不得重复键;未定义字段忽略。
40
+ - 名称、头像和可用范围由工作伙伴服务提供。平台只返回当前用户可用的伙伴;无可用伙伴时隐藏分组,不影响其他有效能力。
41
+
42
+ ## 修改与验证
43
+
44
+ 引用和职责描述随插件版本保存;远端伙伴名称、头像或运行配置变化无需重新发布插件。
45
+
46
+ CLI 通用打包会保留声明,但没有工作伙伴专用本地校验或预览。按 [开发调试](../cli/development.md#配置变更的同步边界) 同步后,验证实际账号下的伙伴可见性与调用。
@@ -0,0 +1,207 @@
1
+ # MCP Apps 接入与验证
2
+
3
+ 用于工具结果 HTML、静态入口和显示控制。消息、上下文与身份权限见 [运行时](runtime.md),导航、多服务启动和 Home 见 [Workbench](workbench.md)。
4
+
5
+ ## 基础协议与豆包增量
6
+
7
+ 基础采用 [MCP Apps 2026-01-26](../../upstream/mcp-apps.mdx),固定提交与许可证见[来源记录](../../upstream/SOURCES.md)。标准规定工具关联、UI 资源及通信生命周期;下文补充豆包的入口、URL source、容器策略和动态结果 UI。
8
+
9
+ | 类别 | 定义位置 |
10
+ | --- | --- |
11
+ | 沿用 | `ui://` 资源、`_meta.ui.resourceUri`、资源 CSP、标准消息及生命周期,见上游对应章节 |
12
+ | 新增 | global/thread/file 入口、URL source、容器展开偏好和 `com.doubao/ui` 动态覆盖,见本页对应章节 |
13
+ | 实现限制 | 当前显示模式、浏览器权限及尺寸/内容限额,见[资源、安全与显示模式](#资源安全与显示模式) |
14
+
15
+ MCP Server 的能力协商与 HTML App 的 `ui/initialize` 是两条链路;静态元数据 `doubao/ui` 与动态结果 `com.doubao/ui` 也不能互换。
16
+
17
+ ## 按任务读取
18
+
19
+ | 任务 | 指引 |
20
+ | --- | --- |
21
+ | 工具结果显示 HTML、连接工具与界面 | [最小声明](#最小声明与字段)、[接通流程](#接通工具与界面) |
22
+ | 全局、会话、文件入口或 URL 页面 | [静态入口与 UI 来源](#静态入口与-ui-来源) |
23
+ | CSP、浏览器权限、展开模式、宽度和高度 | [资源、安全与显示模式](#资源安全与显示模式) |
24
+ | 按一次工具结果替换或关闭 UI | [豆包动态 UI](#豆包动态-ui) |
25
+
26
+ ## 声明位置
27
+
28
+ 连接、展示和授权分别沿用 [MCP 配置](../mcp-config.md)、[根清单](../plugin-json.md#展示字段)和 [MCP 鉴权](../mcp-auth.md)。工具与入口声明放在 MCP 服务端的工具元数据;HTML 及安全属性由资源响应或声明的 URL 提供。
29
+
30
+ 普通 MCP Apps 不新增包内 UI 清单,无需 App Manifest 或 Kit。只将 HTML 放入插件包不能替代工具关联或资源声明;Home 包入口另见 [工作台包协议](../workbench.md)。
31
+
32
+ ## 最小声明与字段
33
+
34
+ 以下是 `tools/list` 中的工具定义片段,输入 schema 按实际业务补充;服务须同时提供所引用的资源:
35
+
36
+ ```json
37
+ {
38
+ "name": "search_products",
39
+ "inputSchema": { "type": "object" },
40
+ "_meta": {
41
+ "ui": { "resourceUri": "ui://shopping/results" }
42
+ }
43
+ }
44
+ ```
45
+
46
+ | 位置 | 字段 | 约束 |
47
+ | --- | --- | --- |
48
+ | 工具定义 `_meta.ui` | `resourceUri` | 默认界面的 `ui://` 资源 URI,由同一 Server 的 `resources/read` 返回 UI;与 `doubao/ui.url` 互斥 |
49
+ | `resources/read.contents[]` | `uri`、`mimeType`、`text` 或 `blob` | 对应 URI、`text/html;profile=mcp-app`;text 为非空 HTML,blob 为 Base64 编码的 UTF-8 HTML |
50
+ | 资源内容 `_meta.ui` | `csp`、`permissions` | 安全策略与浏览器权限申请,见[资源、安全与显示模式](#资源安全与显示模式) |
51
+ | 工具结果 | `content`,按业务提供 `structuredContent` | 无界面时也可独立理解的数据与状态 |
52
+
53
+ 三处元数据分别判断:`tools/list` 的 `_meta.ui.resourceUri` 关联默认 UI;`tools/call` 的 `result._meta` 是本次结果的附加元数据,标准 MCP Apps 不要求在这里重复 UI URI;`resources/read` 的 `contents[i]._meta.ui` 配置该资源的安全与显示属性,不能代替 HTML。只有双方协商了下文的 `com.doubao/ui`,才按本次结果中的豆包扩展判断动态覆盖。
54
+
55
+ `registerAppTool` 处理工具注册元数据,不保证给 handler 的返回结果注入 UI URI;`registerAppResource` 的默认媒体类型也不能代替对实际资源响应的检查。已有低层 handler 按相同协议核对。
56
+
57
+ ## 静态入口与 UI 来源
58
+
59
+ 声明位于 MCP Server 的工具元数据。默认工具结果 UI、静态应用入口和 URL 页面分别判断;身份 scope 的授权规则见 [App 身份资料权限](runtime.md#app-身份资料权限)。
60
+
61
+ | 位置 | 契约 |
62
+ | --- | --- |
63
+ | `Tool._meta.ui.visibility` | `model` / `app` 可见性;静态入口发现独立于 model visibility |
64
+ | `Tool._meta["openai/ui"].entrypoints` | 静态入口数组;接受 `doubao/ui.entrypoints` 同义字段 |
65
+ | global / thread 入口 | 启动工具参数为 `{}`;分别绑定全局或目标会话 |
66
+ | file 入口 | 声明 `extensions`,元素以 `.` 开头;可信文件授权校验后传入 `{file:{filename,resourceUri}}`。声明不会授予文件权限,也不承诺产品自动文件关联 |
67
+ | `preferredModelDisplayMode` | 位于 `openai/ui` 或其豆包别名,值为 `inline` / `fullscreen`;它是模型调用的展示偏好 |
68
+ | `Tool._meta["doubao/ui"].url` | 不含凭据的 HTTP(S) URL;旧 `ui.url` 仅作为兼容输入 |
69
+ | `doubao/ui.csp` / `permissions` | URL source 的安全申请,结构采用 MCP Apps 标准;不写入 `openai/ui` |
70
+ | 入口标题和图标 | 标题按 `Tool.title` → `annotations.title` → `name`;保留 `Tool.icons` |
71
+
72
+ 资源入口示例,业务工具的输入与结果 schema 另行定义:
73
+
74
+ ```json
75
+ {
76
+ "name": "open_workspace",
77
+ "title": "工作区",
78
+ "inputSchema": { "type": "object", "properties": {} },
79
+ "_meta": {
80
+ "ui": { "resourceUri": "ui://workspace/main", "visibility": ["model", "app"] },
81
+ "openai/ui": { "entrypoints": [{ "type": "global" }, { "type": "thread" }] },
82
+ "doubao/permissions": ["identity.user.read"]
83
+ }
84
+ }
85
+ ```
86
+
87
+ URL source 除 URL 外,还需要 Host 的可信 Proxy、origin、session 和实际 View origin 校验。网页可访问并不证明可以嵌入或进行 SDK 通信。
88
+
89
+ ## 资源、安全与显示模式
90
+
91
+ UI HTML 非空,豆包扩展的总上限为 10 MiB,inline 上限为 5 MiB。
92
+
93
+ | 资源元数据位置 | 契约 |
94
+ | --- | --- |
95
+ | `contents[i]._meta.ui.csp` | 按下文 [CSP 域名清单](#csp-域名清单)声明完整依赖;豆包每组最多 32 项,网络连接允许 HTTPS/WSS,其余三组限 HTTPS |
96
+ | `contents[i]._meta.ui.permissions` | `camera`、`microphone`、`geolocation`、`clipboardWrite` 以 `{}` 申请;当前默认策略只允许 clipboardWrite,实际权限取申请与 Host 策略的交集 |
97
+ | `contents[i]._meta.ui.domain` / `prefersBorder` | 专用来源标识和边框偏好;最终按容器策略渲染 |
98
+ | `contents[i]._meta["openai/ui"]` 或 `doubao/ui` | `availableDisplayModes`、`preferredDisplayMode`;支持的模式为 `inline` / `fullscreen`,最终取 App、资源与 Host 支持的交集 |
99
+ | `contents[i]._meta["doubao/ui"].inlineExpansion` | `sidebar` / `fullscreen`,决定 Host 展开控件的容器;两者 wire displayMode 都是 `fullscreen` |
100
+ | `contents[i]._meta["doubao/ui"].preferredSidebarWidth` | 正安全整数,CSS px;Host 布局和用户尺寸记忆优先 |
101
+
102
+ inline 高度使用官方 `ui/notifications/size-changed` 或 SDK 默认 autoResize。豆包初始内容高度 497px,有效高度向上取整并限制为 100~1600px,最大内容宽度 1000px;标题栏和边框另计。sidebar/fullscreen 按 Host 布局,不随 App 内容高度拉伸。App 使用实际 `containerDimensions`,不依赖 Host 内部附带的非标准 `minHeight`。
103
+
104
+ 显示模式请求以返回的 `mode` 为准。豆包扩展不提供 PiP;sidebar、page、rightSidebar 是其他层次的容器概念,不新增对应 wire displayMode。
105
+
106
+ ### CSP 域名清单
107
+
108
+ CSP 的四组字段来自 [MCP Apps 标准](../../upstream/mcp-apps.mdx#ui-resource-format)。开发或修改 UI 时,必须从**实际构建并托管的 HTML 及其依赖**收集来源,按用途填写;不能只填 MCP 服务地址或 HTML 入口域名。
109
+
110
+ | 字段 | 需要覆盖的来源 | 示例 |
111
+ | --- | --- | --- |
112
+ | `connectDomains` | 页面直接发起的 fetch、XHR、WebSocket 等网络连接 | `https://api.example.com`、`wss://events.example.com` |
113
+ | `resourceDomains` | 外链 JS、CSS、图片、字体、音视频,以及模块加载、CSS `@import` / `url()` 等间接加载的静态资源 | `https://cdn.example.com` |
114
+ | `frameDomains` | 页面内 iframe 加载的目标来源 | `https://embed.example.com` |
115
+ | `baseUriDomains` | `<base href>` 指定的来源;资源和请求仍按用途声明到上述字段 | `https://cdn.example.com` |
116
+
117
+ 填写 origin(协议、域名和必要的端口),同一 origin 用于多种用途时分别填入对应字段。检查相对路径最终解析的地址、重定向后的来源及交互时才加载的依赖。托管 HTML 与 JS/CSS 在同一域名,也不能假定该域名已被沙箱允许;打包后的外链仍需声明。通过 `app.callServerTool` 由宿主访问 MCP 不属于页面直接联网,无需因此添加服务域名。
118
+
119
+ **建议直接在 MCP Apps 资源中实现界面,避免再用 iframe 嵌套业务网页,尤其是多层嵌套。** 确需嵌套时,逐层检查子页面及其潜在嵌套页面的网络、静态资源和 iframe 来源,并配置到各层适用的 CSP。顶层 `frameDomains` 只允许加载子页面,不会自动放行子页面的所有依赖;跨源子页面还受自身 CSP 和嵌入策略约束。
120
+
121
+ 资源模式将 CSP 写入 `resources/read` 返回的 `contents[i]._meta.ui.csp`,不能只写在工具元数据或 `registerAppResource` 注册配置上。URL source 使用上文的 `doubao/ui.csp`,工作台 HTML 使用[包协议](../workbench.md)中的 `html.csp`。平台 SDK 封装了声明时,检查最终响应是否带上这些字段。
122
+
123
+ 交付前核对构建产物和实际响应,并在目标宿主打开页面、触发主要交互,结合 Console 的 CSP 错误与 Network 中被拦截的 URL 补齐相应来源;每次新增外部依赖都更新清单并复验。未使用的字段可省略或为空,不能复制空数组来代替依赖检查,也不要用宽泛通配符消除报错。CSP 放行后仍须满足 CORS 和目标页面的嵌入策略;若无法执行宿主验证,明确记录未验证项。
124
+
125
+ 官方实践:[CSP 字段说明](https://apps.extensions.modelcontextprotocol.io/api/interfaces/app.McpUiResourceCsp.html)、[CSP 与 CORS 配置](https://apps.extensions.modelcontextprotocol.io/api/documents/Patterns.html#configuring-csp-and-cors)。
126
+
127
+ ## 接通工具与界面
128
+
129
+ 普通接入先按本页步骤实施;需要核对标准字段或报文时,按[协议章节索引](#按需核对标准协议)读取对应章节。SDK 用法以工程已安装的 `@modelcontextprotocol/ext-apps` 导出与类型为准,保留已有 MCP 和 Web 工程。
130
+
131
+ 1. 确认真正使用的工具、输入及结果 schema、样例数据和前端入口。工具须返回独立可读的文字或结构化结果,包含核心数据和状态,不能只返回“请看卡片”、空结果或 UI URI。
132
+ 2. 用 `registerAppTool` 注册工具;资源模式通过 `_meta.ui.resourceUri` 绑定 `ui://` 资源,URL 模式按[静态入口与 UI 来源](#静态入口与-ui-来源)声明,两者互斥。
133
+ 3. 资源模式用 `registerAppResource` 注册同一 URI,contents 返回实际 HTML 和 `text/html;profile=mcp-app`;URL 模式验证实际页面与 Host Proxy 通信。两种模式均按 [CSP 域名清单](#csp-域名清单)覆盖实际依赖,并申请所需权限。
134
+ 4. 前端创建 SDK `App`,先注册处理器再 `app.connect()`;用 `app.ontoolresult` 接收数据,交互通过 `app.callServerTool({ name, arguments })` 调用工具。服务端保留参数校验、授权和业务错误处理。
135
+ 5. 按工程实际命令构建,在目标宿主验证 `io.modelcontextprotocol/ui` 扩展协商、资源加载与交互。读取 `hostContext.availableDisplayModes` 后,按[显示模式约束](#资源安全与显示模式)请求支持的模式。
136
+
137
+ 根清单、MCP 连接与业务 Skill 的对应关系见 [TODO 配置示例](../../examples/todo-example.md)。普通 MCP Apps 数据按业务 schema 返回,不因界面呈现卡片而添加豆包实体包装。
138
+
139
+ 可选联网资料:[官方 Quickstart](https://apps.extensions.modelcontextprotocol.io/api/documents/quickstart.html)、[server helpers](https://apps.extensions.modelcontextprotocol.io/api/modules/server-helpers.html)、[官方示例](https://apps.extensions.modelcontextprotocol.io/api/#running-the-examples) 和 [MCP Authorization](https://modelcontextprotocol.io/specification/2025-11-25/basic/authorization)。仅在需要补充 SDK 用法且网络可用时查阅,不作为接入前置步骤。
140
+
141
+ ### 按需核对标准协议
142
+
143
+ 标准部分使用 MCP Apps 2026-01-26 [固定快照](../../upstream/SOURCES.md)。需要报文细节时按下表读取相关章节。
144
+
145
+ | 待核对内容 | 协议章节 |
146
+ | --- | --- |
147
+ | HTML 资源、媒体类型、CSP 与权限 | [UI Resource Format](../../upstream/mcp-apps.mdx#ui-resource-format) |
148
+ | 工具与 UI URI 的关联、工具可见性 | [Resource Discovery](../../upstream/mcp-apps.mdx#resource-discovery) |
149
+ | MCP Server 与 Host 的扩展协商 | [Client<>Server Capability Negotiation](../../upstream/mcp-apps.mdx#clientserver-capability-negotiation) |
150
+ | HTML App 初始化、能力与初始上下文 | [App Capabilities](../../upstream/mcp-apps.mdx#app-capabilities-in-uiinitialize)、[Host Context](../../upstream/mcp-apps.mdx#host-context-in-mcpuiinitializeresult)、[Host Capabilities](../../upstream/mcp-apps.mdx#host-capabilities) |
151
+ | 输入与工具结果传入 UI、交互更新 | [Data Passing](../../upstream/mcp-apps.mdx#data-passing) |
152
+ | 显示模式、尺寸与销毁 | [Display Modes](../../upstream/mcp-apps.mdx#display-modes)、[Container Dimensions](../../upstream/mcp-apps.mdx#container-dimensions)、[Cleanup](../../upstream/mcp-apps.mdx#4-cleanup) |
153
+
154
+ ## 豆包动态 UI
155
+
156
+ 需要按单次调用结果切换或关闭界面时,使用 `com.doubao/ui` 扩展。客户端和 MCP 服务端在 MCP `initialize` 请求与响应的 `capabilities.experimental` 中均声明 `"com.doubao/ui": { "version": 1 }`,且客户端支持 MCP Apps 时启用;这不是 HTML 页面的 `ui/initialize`。
157
+
158
+ ### 结果声明
159
+
160
+ 服务端在 `tools/call` 的 `result._meta["com.doubao/ui"]` 中返回本次展示配置。以下为完整工具调用响应示例,业务 content 与工具自身的输出契约保持一致:
161
+
162
+ ```json
163
+ {
164
+ "jsonrpc": "2.0",
165
+ "id": 20,
166
+ "result": {
167
+ "content": [{ "type": "text", "text": "找到 12 条结果。" }],
168
+ "_meta": { "com.doubao/ui": { "resourceUri": "ui://shopping/results" } }
169
+ }
170
+ }
171
+ ```
172
+
173
+ ### 覆盖与失败语义
174
+
175
+ | 本次结果中的扩展值 | 行为 |
176
+ | --- | --- |
177
+ | 字段缺失 | 沿用调用开始时工具定义的默认 UI;无默认 UI 则不展示 |
178
+ | 有效 UI 对象 | 整体替换默认 UI,不合并字段 |
179
+ | `null` 或 `{}` | 关闭本次界面,不回退默认 UI;优先用 `null` 表达关闭 |
180
+ | 非法值或选中资源加载失败 | 降级为普通工具结果并记录诊断,不回退默认 UI |
181
+
182
+ 收到工具结果并解析覆盖后再挂载 UI。资源从同一 MCP 服务读取,继续遵循资源 CSP 和沙箱要求。覆盖只影响本次调用,不修改工具可见性或调用权限,也不影响并发调用与已有界面。中间层须完整透传 `result._meta`。
183
+
184
+ ### 兼容行为
185
+
186
+ 未协商成功时沿用标准 MCP Apps,不依赖动态覆盖生效。此扩展与 `doubao/ui` 的页面入口、工作台扩展分别定义,不能混用命名空间。
187
+
188
+ ## 调试与验收
189
+
190
+ 按 MCP / Web 工程自身命令启动服务。使用 [Inspector](../../cli/development.md#单独调试-mcp-server) 单独检查工具、资源和 HTML 界面。需要验收插件在目标宿主中的整体效果时,通过 `dbx dev --plugin --once` 将开发包安装到当前账号,再在支持 MCP Apps 的目标宿主验证。
191
+
192
+ - 工具:真实调用成功,文字或结构化结果独立可读;业务 Skill 中的参数与 tools/list schema 一致。
193
+ - 界面:读取到关联 URI 的 HTML,工具结果进入 UI;筛选、详情或修改操作调用真实工具并更新界面。
194
+ - 失败:资源不可用、未授权、无数据和业务错误有明确反馈,不伪造成功。
195
+ - 宿主不支持 UI:基础工具结果仍可读,交互能力记录为待验。
196
+ - 动态 UI:在支持 `com.doubao/ui` 且完成能力协商的目标宿主验证缺省、替换、关闭和资源失败。`dbx inspect` 不支持该扩展的验收。
197
+
198
+ ## 按首次失败环节排查
199
+
200
+ | 首次失败环节 | 优先核对 |
201
+ | --- | --- |
202
+ | 连接或工具枚举 | 地址、传输、运行态服务、授权;见 [MCP 鉴权](../mcp-auth.md#按失败环节排查) |
203
+ | 工具调用 | 输入 schema、业务权限、`isError` 与原始结果;有数据再查 UI |
204
+ | 工具成功但没有界面 | 宿主支持及扩展协商、工具定义中的默认 URI;不把结果缺少重复 URI 当作故障 |
205
+ | 资源加载失败或白屏 | 同一服务的 `resources/read`、URI、媒体类型、实际 HTML;按 [CSP 域名清单](#csp-域名清单)核对被拦截的请求与资源 |
206
+ | HTML 已加载但一直等待 | `App` 处理器是否先于 `connect()` 注册,宿主是否送达结果,字段是否符合 UI 读取逻辑 |
207
+ | 首屏正常但操作失败 | `callServerTool` 的工具名、参数、授权及真实返回;错误后是否保留数据并给出恢复入口 |