create-zleap-app 0.10.4 → 0.10.6

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 (25) hide show
  1. package/index.js +3 -0
  2. package/package.json +3 -3
  3. package/skills/zleap-cloud-app/SKILL.md +3 -3
  4. package/skills/zleap-cloud-app/references/app-runtime.md +3 -3
  5. package/skills/zleap-cloud-app/references/cloud-functions.md +25 -18
  6. package/skills/zleap-cloud-app/references/console-members.md +8 -16
  7. package/skills/zleap-cloud-app/references/limits.md +27 -36
  8. package/skills/zleap-cloud-app/references/manifest.md +26 -58
  9. package/skills/zleap-cloud-app/references/permissions.md +21 -21
  10. package/skills/zleap-cloud-app/references/sdk-database-files.md +12 -10
  11. package/skills/zleap-cloud-app/references/status-codes.md +117 -136
  12. package/skills/zleap-cloud-app/references/triggers.md +4 -4
  13. package/skills/zleap-cloud-app-release/SKILL.md +39 -82
  14. package/skills/zleap-cloud-app-release/references/app-center-install.md +22 -23
  15. package/skills/zleap-cloud-app-release/references/app-center-publish.md +56 -142
  16. package/skills/zleap-cloud-app-release/references/console-functions.md +12 -28
  17. package/skills/zleap-cloud-app-release/references/console-members.md +8 -16
  18. package/skills/zleap-cloud-app-release/references/console-release.md +18 -24
  19. package/skills/zleap-cloud-app-release/references/console-workspace.md +23 -90
  20. package/skills/zleap-cloud-app-release/references/dev-to-production.md +79 -349
  21. package/skills/zleap-cloud-app-release/references/permissions.md +21 -21
  22. package/skills/zleap-cloud-app-release/references/status-codes.md +117 -136
  23. package/templates/react-ts/scripts/zleap.mjs +14 -0
  24. package/templates/react-ts/src/cloud/client.ts +3 -3
  25. package/skills/zleap-cloud-app-release/references/console-legacy-release.md +0 -411
@@ -1,16 +1,16 @@
1
1
  ---
2
2
  name: zleap-cloud-app-release
3
- description: Ship a zleapOS 云开发 (App Cloud) app beyond the developer's own desktop — for platform-appid apps, publishing a development version as the live version (版本管理 → 发布为线上版本 / 回退到此版本); for legacy apps, release candidates and signing (验证并签发), 激活开发, enabling background capabilities / cloud functions / triggers, production environment and 生产门禁, zleap-app prepare, publishing to the enterprise catalog (market-publish), and version update / rollback. Use when the user asks to 上线, 发布, 上生产, 分享给同事, 回退, 让云函数或定时任务跑起来, 升级或回退版本 for a zleap.app/2 app. Also covers npm run release / zleap-app release for appid apps.
3
+ description: Ship a zleapOS 云开发 (App Cloud) app beyond the developer's own desktop — publishing a development version as the live version (版本管理 → 发布为线上版本 / 回退到此版本, npm run release / zleap-app release), automatic production preparation and its failure reasons, running cloud functions / background capabilities / triggers in the dev environment (自动签名、允许后台运行、invoke), sharing with colleagues, and version switching / rollback. Use when the user asks to 上线, 发布, 上生产, 分享给同事, 回退, 让云函数或定时任务跑起来, 升级或回退版本 for a zleap.app/2 app.
4
4
  ---
5
5
 
6
6
  # zleapOS 云开发应用:从开发到上线
7
7
 
8
8
  前置:应用已能用 `npm run deploy`(或 `zleap-app publish` + `install`)装到开发者自己的桌面并读写数据——那部分见 skill `zleap-cloud-app`。
9
- 下文的 `npx zleap-app` 指项目里安装的 `@zleap-ai/app-cli`;不在这样的项目里时换成 `npx @zleap-ai/app-cli`。本 skill 处理之后的事:签名激活、后台能力、生产环境、分享给同事、版本迭代。完整版流程:references/dev-to-production.md。
9
+ 下文的 `npx zleap-app` 指项目里安装的 `@zleap-ai/app-cli`;不在这样的项目里时换成 `npx @zleap-ai/app-cli`。本 skill 处理之后的事:后台能力、发布上线、分享给同事、版本迭代。完整版流程:references/dev-to-production.md。
10
10
 
11
- ## 0. 先看应用类型:appid 应用直接用「版本管理」
11
+ ## 1. 上线:「版本管理」→ 发布为线上版本
12
12
 
13
- manifest 里是 `"appid": "zl…"`(控制台「创建应用」得到的平台 appid)时,上线只有两步,**下文 1–6 节的签名、激活、`prepare`、企业目录都不用做**:
13
+ manifest 里是 `"appid": "zl…"`(控制台「创建应用」得到的 appid)。上线只有两步,不需要手动签名、激活或上架:
14
14
 
15
15
  1. **上传开发版本**:`npm run deploy`(会把上传者本人的安装切到这个版本)。
16
16
  2. **发布**:用户明确要求上线后,在项目里 `npm run release -- --notes "本次更新说明" --yes`(发布最近一次 deploy 的版本;
@@ -31,119 +31,76 @@ manifest 里是 `"appid": "zl…"`(控制台「创建应用」得到的平台
31
31
  **发布影响全企业使用者:只有用户明确说「发布 / 上线 / 回退到 x」时才执行,执行前复述要发布的版本号。**
32
32
  - 带云函数的版本在开发环境调试**不需要签名 / 激活操作**:上传时平台自动签名,安装 / 切换版本 / 在应用窗口「权限」里允许后台运行时自动绑定
33
33
  (版本还没签名时当场补签)。用户在应用窗口「权限」里允许后台运行后,`npx zleap-app invoke <app_id> --capability <id> --environment dev` 调试。
34
- 控制台没有「开发环境:云函数激活」区块,也没有「我也用这个」(已改名「切换到此版本」)。
35
- - `npx zleap-app prepare` 对 appid 应用只是兜底:仅当 `npx zleap-app diagnose` 返回 `next_action: app_prepare` 时用,只准备开发环境、不碰生产,只能准备本人上传的版本。
36
-
37
- 旧 `app_key` 命名空间应用(`com.example.xxx`)继续按下文走「版本与激活」(references/console-legacy-release.md)。
34
+ 控制台没有单独的签名 / 激活界面。
35
+ - `npx zleap-app prepare` 只是兜底:仅当 `npx zleap-app diagnose` 返回 `next_action: app_prepare` 时用,只准备开发环境、不碰生产,只能准备本人上传的版本。
38
36
 
39
37
  完整说明:references/console-release.md。
40
38
 
41
- ## 1. 先回答两个问题,再选路线
42
-
43
- | 问题 | 怎么判断 | 影响 |
44
- | --- | --- | --- |
45
- | 应用有后台部分吗? | manifest 有 `runtime.backend`、`functions`,或 `provides` 里有 `execution:"headless"` | 有 → 必须签名并激活 |
46
- | 部署开放生产了吗? | 控制台「版本与激活」显示「生产环境已开放」,或侧栏环境出现「开发环境 / 生产环境」下拉 | 开放 → 其他使用者一律走**生产数据域**(应用没有生产环境时打不开,`ENV_FORBIDDEN`),发布者在应用有生产环境后也走生产,必须做生产激活;未开放 → 所有人走开发数据域 |
47
-
48
- 生产是否开放由部署决定(发布信任配置就绪即开放,运维自动配置),控制台没有开关。不知道就问用户,或让用户看控制台。
49
-
50
- ## 2. 只有前端的应用
51
-
52
- - **生产未开放**:开发环境就是唯一数据域,且默认**只有发布者本人**能访问(其他人 `PUBLISHER_REQUIRED`)。能自用,但同事装了也读不到数据——如实告诉用户,这是平台边界。
53
- - **生产已开放**:用一条命令准备好生产(会创建开发+生产环境、开通数据库、签名、**激活到生产**):
54
-
55
- ```bash
56
- npx zleap-app prepare <app_id> --version-id <version_id> # --request-id 不传时自动生成;重试时用回执里的同一个
57
- ```
58
-
59
- 应用没有声明任何云资源(无 `cloud.*`、无后台能力、无集合)时直接返回 `not_required`,装上就能用。
39
+ ## 2. 云函数 / 后台能力(开发环境)
60
40
 
61
- `prepare` 只接受**本人 private 且已安装的那个版本**。失败返回卡住的 `stage` 和 `completed_stages`,不自动重试;先 `npx zleap-app diagnose <app_id>`,再用**同一个** `--request-id` 继续。部署未开放生产时它会在 `prod_environment` 阶段失败。
62
- **它会直接激活到生产并启用全部 headless 能力——执行前必须得到用户明确同意。**
41
+ AI 能做的是命令与代码,界面操作要请用户完成:
63
42
 
64
- ## 3. 有后台能力 / 云函数的应用(开发环境)
65
-
66
- **appid 应用**(AI 能做的是命令与代码,界面操作要请用户完成):
67
-
68
- 1. **上传**:`npm run deploy`。带 headless 能力的版本上传时平台自动签名,deploy 把本人安装切到新版本时自动绑定。
69
- 2. **允许后台运行**(用户):应用窗口顶部「权限」→ 勾选「后台能力(定时任务 / 云函数)」下的能力 →「保存并重新加载」。版本还没签名时保存这一步会自动补签并绑定。
70
- 3. **试调**:同下文第 5 步(`invoke` / `invocation` / `runtime-logs`)。报 `FUNCTION_RELEASE_REQUIRED`:请用户在「权限」里重新保存一次或在「版本管理」切换一次版本(会自动补签);仍失败说明部署的签名服务不可用,交给平台管理员。
71
- 4. **触发器**:同下文第 6 步。控制台「云函数」页允许 / 撤销授权**不会**解除 appid 应用的发布绑定。
72
-
73
- **旧 `app_key` 应用**,顺序很重要,按此执行:
74
-
75
- 1. **上传**:`npm run deploy`(含 `cloudfunctions/` 的包也可以,校验规则与应用中心上传一致);也可由用户在应用中心「我的发布」→「上传应用包」上传,再在应用详情「安装」。
76
- 2. **签名**(用户):云开发控制台 →「版本与激活」,在该版本的草稿候选上点「验证并签发」→ 状态变「已就绪」。没有草稿就「新建发布候选」。
77
- 3. **允许后台运行**(用户):应用窗口顶部「权限」→「应用权限」对话框里勾选「后台能力(定时任务 / 云函数)」下的能力 →「保存并重新加载」。已有就绪发布时这一步会自动绑定发布。
78
- 4. **核对激活**:控制台概览第 5 步显示「已激活到开发环境」、「云函数」页状态「可调用」即完成;否则点「激活开发」,或用概览的「升级到 vX 并激活」。
79
- 5. **试调**(AI 可做):`npx zleap-app invoke <app_id> --capability <能力 ID> --environment dev --input-file in.json`,
43
+ 1. **上传**:`npm run deploy`(含 `cloudfunctions/` 的包也可以)。带 headless 能力的版本上传时平台自动签名,deploy 把本人安装切到新版本时自动绑定。
44
+ 2. **允许后台运行**(用户):应用窗口顶部「权限」→「应用权限」对话框里勾选「后台能力(定时任务 / 云函数)」下的能力 →「保存并重新加载」
45
+ (或控制台「云函数」→「后台能力」里允许)。版本还没签名时这一步会自动补签并绑定。
46
+ 3. **试调**(AI 可做):`npx zleap-app invoke <app_id> --capability <能力 ID> --environment dev --input-file in.json`,
80
47
  再 `npx zleap-app invocation <app_id> <调用编号>`;函数日志 `npx zleap-app runtime-logs <app_id> <调用编号> --environment dev`(看 `function_logs`)。
81
- 报 `CAPABILITY_NOT_ACTIVE` = 用户还没允许后台运行,开发工具不能代为允许。
82
- 6. **触发器**(用户):控制台「云函数」→ 能力 →「触发器」里启用。manifest 的 `background.modes` 要含 `scheduled`/`events`,事件名 `^[a-z][a-z0-9_.]{0,63}$`。
48
+ - `CAPABILITY_NOT_ACTIVE` = 用户还没允许后台运行,开发工具不能代为允许。
49
+ - `FUNCTION_RELEASE_REQUIRED`:请用户在「权限」里重新保存一次或在「版本管理」切换一次版本(会自动补签);仍失败说明部署的签名服务不可用,交给平台管理员。
50
+ 4. **触发器**(用户):控制台「云函数」→ 能力 →「触发器」里启用。manifest 的 `background.modes` 要含 `scheduled`/`events`,事件名 `^[a-z][a-z0-9_.]{0,63}$`。
83
51
  **线上让使用者自己开**:触发器声明加 `"user_configurable": true` 并发布;每个使用者在应用窗口「权限」里允许后台能力后,在能力下面打开开关(以本人身份运行,时间和参数用声明值)。没开放的触发器在生产环境启用报 `TRIGGER_NOT_USER_CONFIGURABLE`。
84
52
 
85
53
  坑:
86
- - 激活和允许后台运行**没有先后要求**,但两者都做了后台能力才会执行。激活到还没有的环境时平台会自动创建该环境。
87
- - 旧 `app_key` 应用:在控制台「云函数」页点「允许后台运行 / 撤销授权 / 重新授权」会**解除发布绑定**,之后要重新「激活开发」(appid 应用不会解除)。
54
+ - 控制台「云函数」页允许 / 撤销授权**不会**解除发布绑定。
88
55
  - `managed_function` 必须绑定就绪发布,否则 `FUNCTION_RELEASE_REQUIRED`;`builtin`、`logic_unit` 在开发环境不需要。
89
- - 激活新发布后旧会话失效(`RELEASE_UNAVAILABLE`),宿主会自动重开。
56
+ - 切换到新版本后旧会话失效(`RELEASE_UNAVAILABLE`),宿主会自动重开。
90
57
  - 云函数里 `zl.cloud.os.database.query` / `mutate` **都必须带 `request_id`**(非空、≤128,用 `` `${context.invocationId}:用途` ``),否则网关拒绝、未捕获时整次调用 `USER_EXCEPTION`。
91
58
  - 云函数里读操作只有 `get`(单条)和 `count`(计数,可带 `filter`);`operation: 'query'` 会被拒(`GATEWAY_QUERY_OPERATION_UNSUPPORTED`)。
92
59
  - 触发器 `id` 只能是 `^[a-z][a-z0-9_]{0,63}$`(**不能有 `-`**):上传不报错,但启用时会被拒。
93
- - 升级到新版本后,已启用的触发器会变成停用(`authorization_changed`),要在新激活上重新启用。
60
+ - 升级到新版本后,已启用的触发器会变成停用(`authorization_changed`),要在新版本上重新启用。
94
61
  - 函数里 `query` / `mutate` 失败时 `error.code` 是错误码、`error.message` 是平台给的中文说明(含具体上限);先 `try/catch` 把它放进返回值
95
62
  (`output_schema` 里声明对应字段),再排查。日志库刚开通时可能暂时查不到日志(`LOG_UNAVAILABLE`),函数照常执行。
96
63
 
97
- ## 4. 上生产(部署已开放生产时,手动路线)
98
-
99
- 1. 「版本与激活」→ 对已就绪候选「查看生产门禁」,7 项全部通过(发布就绪、签名证明、审批窗口、策略绑定、当前信任根、运行快照、生产 Provider)。
100
- 2. 「激活到生产」→ 确认后显示「已激活生产」。生产环境不存在时**激活会自动创建**,但**不建集合**。
101
- 3. **马上开通生产集合**:控制台切到「生产环境」→「数据库」开通(按声明建集合)。否则所有人(含发布者)的窗口都切到生产后报 `COLLECTION_NOT_FOUND`。
102
- 4. 有后台能力的:应用窗口「权限」此时作用于生产数据域,在那里勾选要运行的后台能力。
103
- 5. 审批窗口只有**签名后 7 天**;过期后需为同一应用包新建候选重新签名(已就绪候选不能重签)。
104
-
105
- 手动路线容易漏第 3 步,能用 `prepare` 就用 `prepare`。生产环境里控制台的数据库、文件可直接修改(影响线上用户);云函数、日志只读。
64
+ ## 3. 生产环境
106
65
 
107
- 生产数据域面向全体使用者、与开发数据域完全隔离:开发数据不会带过去。激活前确认同一版本已在开发环境验证过。
66
+ - 生产是否开放由部署决定(发布信任配置就绪即开放,运维自动配置),控制台没有开关。未开放时带云资源的版本发布会在生产准备阶段失败——如实告诉用户这是平台边界。
67
+ - 生产数据域面向全体使用者、与开发数据域完全隔离:开发数据不会带过去。发布前确认同一版本已在开发环境验证过。
68
+ - 生产环境里控制台的数据库、文件可直接修改(影响线上用户);云函数、日志只读。
69
+ - 应用窗口「权限」在生产数据域单独授权:使用者要在那里勾选要运行的后台能力。
108
70
 
109
- ## 5. 分享给同事
71
+ ## 4. 分享给同事
110
72
 
111
- - 命令行:`npx zleap-app market-publish <package_id> --app-key <appid>`(是 **package_id**,在 `.zleap/state.json` 或 publish 回执里,不是 app_id)。撤回:`market-unpublish`。无审核步骤。
112
- - 应用中心:「我的发布」→「管理版本」→ 版本行「发布到企业目录」。
113
- - 同事在「发现」里安装;后台能力仍需同事自己在应用窗口「权限」里允许。
114
- - 让同事**一起开发**(上传、在控制台管理)是另一回事:管理员在控制台「团队」→「成员」里把他加为开发者。所有成员的上传都在「版本管理」里,成员之间可以用「切换到此版本」互相使用(含未发布的版本)。
115
- - **撤回企业目录会让其他人已安装的该版本无法打开**——执行前告诉用户。
116
- - 应用中心上传的新版本,若该应用已有企业可见版本会自动继承企业可见;`zleap-app publish` 永远是 private。
117
- - 同事用「更新」升级到新版本,**新版本必须先签成「已就绪」**,否则更新被拦下。
73
+ - 给全企业用 = 「发布为线上版本」(见第 1 节)。同事在应用中心「发现」里安装;后台能力仍需同事自己在应用窗口「权限」里允许。
74
+ - 让同事**一起开发**(上传、在控制台管理)是另一回事:管理员在控制台「团队」→「成员」里把他加为开发者。所有成员的上传都在「版本管理」里。
75
+ - 开发版本只对成员可见,开发数据域也只对成员开放;非成员要等发布为线上版本后才能用。
118
76
 
119
- ## 6. 版本迭代
77
+ ## 5. 版本迭代
120
78
 
121
79
  | 场景 | 做法 |
122
80
  | --- | --- |
123
- | 自己换到新版本 | `npm run deploy`;或 `npx zleap-app update <app_id> --expected-version-id <当前> --version-id <新>` |
124
- | 回退 | `npx zleap-app rollback <app_id> --expected-version-id <当前> --version-id <旧>`(只切本人安装,**不回退数据**) |
81
+ | 自己换到新版本 | `npm run deploy`;或 `npx zleap-app update <app_id> --expected-version-id <当前> --version-id <新>`;或控制台「切换到此版本」 |
82
+ | 线上回退 | 把旧版本再发布一次:`npm run release -- --version-id <旧> --yes`,或控制台「回退到此版本」(**不回退数据**) |
83
+ | 本人安装回退 | `npx zleap-app rollback <app_id> --expected-version-id <当前> --version-id <旧>` |
125
84
  | 改了 data/storage 声明 | CLI 返回 `DATA_MIGRATION_REQUIRED` 并保持原版本;平台不做迁移。已建集合结构不会变,改结构 = 新集合 + 迁移 |
126
- | 查看可用版本 | `npx zleap-app versions <app_id>` / `diagnose <app_id>` |
85
+ | 查看版本 | `npm run versions`(`npx zleap-app releases <app_id>`);本人安装 `npx zleap-app diagnose <app_id>` |
127
86
 
128
87
  所有写操作结果未知(`COMMIT_UNKNOWN`,退出码 6)时:先 `diagnose` / `status` / `operation --request-id` 核对,**不要盲目重试**。
129
88
 
130
- ## 7. 上线前检查清单(逐项向用户确认)
89
+ ## 6. 上线前检查清单(逐项向用户确认)
131
90
 
132
91
  - [ ] 集合结构已定稿(上线后不能改)
133
92
  - [ ] `npx zleap-app check <dist 或项目> --target <OS>` 在目标部署上通过
134
- - [ ] 控制台开通清单前 3 步完成,「运行体检」通过
135
- - [ ] (有后台)后台能力已允许、函数「可调用」(旧应用另需已签名、已激活开发)
93
+ - [ ] 控制台概览开通清单完成,「运行体检」通过
94
+ - [ ] (有后台)后台能力已允许、函数「可调用」,`invoke --environment dev` 结果正确
136
95
  - [ ] 同一版本完成真实读写验证(用户手动,或 `zleap-app test` 浏览器验收)
137
- - [ ] (生产开放)生产环境已建、门禁 7 项通过、已激活生产
138
- - [ ] 已发布到企业目录,同事侧安装后能打开并读写
96
+ - [ ] 用户明确要求发布,并确认了要发布的版本号
139
97
 
140
98
  ## 参考资料
141
99
 
142
- - references/dev-to-production.md — 端到端流程(十个阶段、四种路线、常见卡点)
143
- - references/console-release.md — 「版本管理」(appid 应用:发布线上版本、回退、命令行发布)
144
- - references/console-legacy-release.md — 「版本与激活」页(旧应用:候选、签名、激活、生产门禁、使用情况)
100
+ - references/dev-to-production.md — 端到端流程与常见卡点
101
+ - references/console-release.md — 「版本管理」:发布线上版本、回退、切换版本、命令行发布
145
102
  - references/console-functions.md — 后台能力授权、试运行、触发器
146
103
  - references/console-workspace.md — 概览开通清单与运行体检
147
- - references/app-center-publish.md / app-center-install.md — 上传、企业目录、安装授权、更新回退
104
+ - references/app-center-publish.md / app-center-install.md — 上传、安装授权、更新
148
105
  - references/console-members.md — 创建应用(appid)、成员与角色
149
106
  - references/permissions.md、references/status-codes.md
@@ -16,8 +16,8 @@
16
16
  >
17
17
  > 「安装」装的是目录里该应用的**当前版本**:
18
18
  >
19
- > - **平台 `appid` 应用**:装成员在控制台 [版本管理](console-release.md#版本管理) 里发布的**线上版本**;还没发布过线上版本时,只有应用成员能使用开发版本;
20
- > - **旧 `app_key` 应用**:有企业可见版本时是最新的企业可见版本;从未发布到企业目录时,是最近上传的版本(只有上传者自己能装)。
19
+ > - 已发布过线上版本时,装的就是**线上版本**;
20
+ > - 还没发布过线上版本时,只有应用成员能安装和使用开发版本。
21
21
  >
22
22
  > 创建了但还没上传过任何版本的应用是草稿,不会出现在应用中心。
23
23
  >
@@ -63,12 +63,12 @@
63
63
 
64
64
  安装授权**不等于**一切就绪:
65
65
 
66
- | 安装之后 | 还需要什么 |
67
- | ----------------------- | --------------------------------------------------------------------------------------------------------------------- |
68
- | 云数据库 / 存储能读写 | 云环境、数据库、集合已就绪(声明了集合的应用安装时会自动创建开发环境并开通,通常一分钟内),且仍要过数据面的 ACL 检查 |
69
- | 后台任务 / 云函数会运行 | **不会自动启动**:安装时后台能力被预置为「停用」,需要在应用窗口「权限」里勾选;安装还要绑定就绪发布(`appid` 应用由平台自动签名、自动绑定,旧应用要手动签发并激活) |
70
- | 定时任务 | 开发者开放了的定时任务,在「权限」里对应后台能力下面有开关,自己决定开不开;时间和内容由开发者定 |
71
- | Agent 能调用你的应用 | 安装不授予 Agent 调用权限 |
66
+ | 安装之后 | 还需要什么 |
67
+ | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
68
+ | 云数据库 / 存储能读写 | 云环境、数据库、集合已就绪(声明了集合的应用安装时会自动创建开发环境并开通,通常一分钟内),且仍要过数据面的 ACL 检查 |
69
+ | 后台任务 / 云函数会运行 | **不会自动启动**:安装时后台能力被预置为「停用」,需要在应用窗口「权限」里允许后台运行;绑定就绪发布由平台自动完成(上传自动签名,缺签时当场补签并绑定) |
70
+ | 定时任务 | 开发者开放了的定时任务,在「权限」里对应后台能力下面有开关,自己决定开不开;时间和内容由开发者定 |
71
+ | Agent 能调用你的应用 | 安装不授予 Agent 调用权限 |
72
72
 
73
73
  所以「装上了但读不到数据」通常是云资源还没准备好,而不是没授权。排查顺序见 [从开发到上线](dev-to-production.md)。
74
74
 
@@ -85,7 +85,7 @@
85
85
  | 被拒绝 | 「操作已被拒绝」 |
86
86
  | 打开失败 | 「暂时无法打开应用,请刷新后重试。」 |
87
87
 
88
- 服务端常见拒绝原因:「该 APP 已在此空间安装」、「当前应用版本不可安装」(当前版本是别人的私有包,或已停用)、「APP id=… 不存在或已停用」。
88
+ 服务端常见拒绝原因:「该 APP 已在此空间安装」、「当前应用版本不可安装」(当前版本已停用或不可见)、「APP id=… 不存在或已停用」。
89
89
 
90
90
  链接里带了空间范围参数时,会提示:
91
91
 
@@ -130,9 +130,9 @@
130
130
 
131
131
  ## 更新与回滚
132
132
 
133
- ### appid 应用:自动跟随线上版本
133
+ ### 自动跟随线上版本
134
134
 
135
- 用平台 `appid` 创建的应用,不需要使用者手动更新:
135
+ 不需要使用者手动更新:
136
136
 
137
137
  - 成员在控制台「版本管理」里发布新版本(或回退到旧版本)后,**不是应用成员的使用者下次打开应用时**,
138
138
  宿主发现线上版本和自己装的不一样,会先把安装切到线上版本,显示「**正在更新到最新版本…**」,再加载应用;
@@ -179,8 +179,7 @@
179
179
  > **目标版本必须有「就绪」的发布**(注意)
180
180
  >
181
181
  > 应用中心前端还会检查目标版本的 `release_id`:为空时显示「该版本尚未发布(release)。切过去后云函数等后台能力无法激活,请先由发布者签发该版本。」并阻止升级——包括没有云函数的纯前端应用(服务端预检对纯前端应用其实不拦,这是前后端判定不一致)。
182
- > 所以旧 `app_key` 应用发布新版本给同事前,先在控制台「版本与激活」里把它签发到「就绪」。
183
- > 平台 `appid` 应用不需要手动签发:声明了后台能力的版本上传时平台已自动签名,使用者也会自动跟随线上版本(见上文)。
182
+ > 带云函数 / 后台能力的版本上传时平台已自动签名;切换版本、重新保存权限或允许后台运行时,平台会自动补签并绑定,正常不需要发布者手动签发。
184
183
 
185
184
  **更新时授权怎么处理**(`appversion/apply.go`):
186
185
 
@@ -277,8 +276,8 @@ CLI 走的是开发会话接口(`appinstallation/version.go` 的 `SwitchVersio
277
276
 
278
277
  > 授权后,本应用可在关窗后按你勾选的能力运行(如定时巡检),以你的身份读写你在本应用中的数据。
279
278
 
280
- 勾选了但该版本还没有可用的签名发布时,会提示:「该版本还没有可用的签名发布,暂时无法执行。重新保存一次权限会自动补签;旧应用请到云开发控制台「版本与激活」完成「激活开发」。」
281
- `appid` 应用正常不会看到这条提示:上传时平台已自动签名,保存权限时会自动绑定(必要时当场补签)。
279
+ 勾选了但该版本还没有可用的签名发布时,会提示:「该版本还没有可用的签名发布,暂时无法执行。重新保存一次权限会自动补签。」
280
+ 正常不会看到这条提示:上传时平台已自动签名,保存权限或允许后台运行时会自动绑定(必要时当场补签)。
282
281
 
283
282
  **主按钮**:**保存并重新加载**。二次确认:
284
283
 
@@ -291,15 +290,15 @@ CLI 走的是开发会话接口(`appinstallation/version.go` 的 `SwitchVersio
291
290
 
292
291
  声明了安装级权限的应用,对话框底部还有一行「设置存储、空间文件、通知等其他权限」和「**管理其他权限**」按钮,点开即下文的「数据权限」对话框。
293
292
 
294
- | 提示 | 含义 |
295
- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
296
- | 当前安装未申请此能力,或你无权访问应用云空间。 | 读取授权失败。常见原因:在 dev 数据域下你不是开发团队成员——dev 默认只对 `appid` 应用成员 / 旧应用该版本的上传者开放 |
297
- | 授权保存未确认,请重新读取后核对。 | 保存失败或结果不明,关掉重开对话框核对当前状态 |
293
+ | 提示 | 含义 |
294
+ | ---------------------------------------------- | ------------------------------------------------------------------------------- |
295
+ | 当前安装未申请此能力,或你无权访问应用云空间。 | 读取授权失败。常见原因:在 dev 数据域下你不是应用成员——dev 默认只对应用成员开放 |
296
+ | 授权保存未确认,请重新读取后核对。 | 保存失败或结果不明,关掉重开对话框核对当前状态 |
298
297
 
299
298
  > **生产未开放时,同事用不了 Cloud 数据**(注意)
300
299
  >
301
- > 部署未开放生产环境时,所有人都走 dev 数据域,而 dev 默认**只允许开发团队**(`appid` 应用成员 / 旧应用该版本的上传者)访问(部署可另行放开)。
302
- > 此时你把应用发布出去(旧应用发布到企业目录、`appid` 应用发布为线上版本),同事能安装、能打开,但云数据读写会被拒绝。这属于「平台未开放」,不是你的代码写错了。
300
+ > 部署未开放生产环境时,所有人都走 dev 数据域,而 dev 默认**只允许应用成员**访问(部署可另行放开)。
301
+ > 此时你把应用发布为线上版本后,同事能安装、能打开,但云数据读写会被拒绝。这属于「平台未开放」,不是你的代码写错了。
303
302
 
304
303
  ### 「数据权限」(安装级权限)
305
304
 
@@ -364,12 +363,12 @@ CLI 走的是开发会话接口(`appinstallation/version.go` 的 `SwitchVersio
364
363
  | **站点打开失败,请重试** | 空间站点票据获取失败 | 重试 |
365
364
  | **文件打开失败,请检查应用或文件权限后重新打开。** | 用「打开方式」启动应用失败 | 检查文件权限 |
366
365
 
367
- 应用被撤回企业目录(且你不是上传者)、被删除、或你的安装版本变化时,已打开的窗口会失效并显示「无法加载应用,请重试。」
366
+ 应用被管理员下架、被删除,或你的安装版本变化时,已打开的窗口会失效并显示「无法加载应用,请重试。」
368
367
 
369
368
  ## 相关
370
369
 
371
370
  - 应用中心界面总览(文档站 ./overview)
372
371
  - [上传与发布应用](app-center-publish.md)
373
372
  - [权限与授权](permissions.md) — 权限模型完整说明
374
- - [云开发控制台 · 版本管理 / 版本与激活](console-release.md) — 就绪发布与激活
373
+ - [云开发控制台 · 版本管理](console-release.md) — 发布线上版本、切换版本与发布记录
375
374
  - [状态与错误码](status-codes.md)