openxiangda 1.0.268 → 1.0.270
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.
- package/README.md +20 -1
- package/lib/cli.js +417 -24
- package/lib/config.js +60 -56
- package/lib/design-gates.js +18 -0
- package/lib/migration-advice.js +19 -0
- package/lib/release-plan.js +2 -0
- package/lib/workspace-init.js +11 -4
- package/openxiangda-skills/SKILL.md +8 -0
- package/openxiangda-skills/references/architecture-patterns.md +218 -218
- package/openxiangda-skills/references/component-guide.md +122 -122
- package/openxiangda-skills/references/openxiangda-api.md +12 -0
- package/openxiangda-skills/references/platform-data-model.md +285 -285
- package/openxiangda-skills/references/resource-manifest-cheatsheet.md +32 -2
- package/openxiangda-skills/references/troubleshooting.md +224 -224
- package/openxiangda-skills/references/webhooks.md +213 -0
- package/openxiangda-skills/references/workspace-state.md +1 -1
- package/openxiangda-skills/skills/openxiangda-core/SKILL.md +1 -1
- package/openxiangda-skills/skills/openxiangda-workflow-automation/SKILL.md +3 -0
- package/package.json +26 -23
- package/packages/sdk/dist/{ProcessPreview-Cyk6uv-w.d.mts → ProcessPreview-DSUIJi5V.d.mts} +2 -3
- package/packages/sdk/dist/{ProcessPreview-Cyk6uv-w.d.ts → ProcessPreview-DSUIJi5V.d.ts} +2 -3
- package/packages/sdk/dist/components/index.d.mts +41 -42
- package/packages/sdk/dist/components/index.d.ts +41 -42
- package/packages/sdk/dist/{dataManagementApi-CE8Zyj3a.d.ts → dataManagementApi-Ro9itwm8.d.ts} +2 -2
- package/packages/sdk/dist/{dataManagementApi-4fSaCA5t.d.mts → dataManagementApi-p_HOhQnA.d.mts} +2 -2
- package/packages/sdk/dist/runtime/index.d.mts +3 -4
- package/packages/sdk/dist/runtime/index.d.ts +3 -4
- package/packages/sdk/dist/runtime/react.d.mts +5 -5
- package/packages/sdk/dist/runtime/react.d.ts +5 -5
- package/packages/sdk/src/build-source/scripts/utils/mime-types.mjs +70 -70
- package/packages/sdk/src/build-source/scripts/utils/oss-client.mjs +128 -128
- package/packages/sdk/src/build-source/scripts/utils/progress.mjs +57 -57
- package/templates/openxiangda-react-spa/.cursor/rules/openxiangda-resources.mdc +1 -0
- package/templates/openxiangda-react-spa/.cursor/rules/openxiangda.mdc +6 -0
- package/templates/openxiangda-react-spa/.qoder/rules/openxiangda-resources.md +1 -0
- package/templates/openxiangda-react-spa/.qoder/rules/openxiangda.md +6 -0
- package/templates/openxiangda-react-spa/AGENTS.md +8 -0
- package/templates/sy-lowcode-app-workspace/.cursor/rules/openxiangda-resources.mdc +2 -0
- package/templates/sy-lowcode-app-workspace/.cursor/rules/openxiangda.mdc +7 -1
- package/templates/sy-lowcode-app-workspace/.qoder/rules/openxiangda-resources.md +1 -0
- package/templates/sy-lowcode-app-workspace/.qoder/rules/openxiangda.md +7 -1
- package/templates/sy-lowcode-app-workspace/AGENTS.md +9 -1
|
@@ -4,6 +4,10 @@
|
|
|
4
4
|
|
|
5
5
|
本工作区是标准 React 18 + Vite + React Router 应用。默认模板只提供应用壳、账号菜单和一个首页,不是开发验证控制台。
|
|
6
6
|
|
|
7
|
+
## 工具升级与代际选择
|
|
8
|
+
|
|
9
|
+
建议评估升级到 OpenXiangda 2.0;新应用优先使用 V2,已有项目先确认能力覆盖、迁移成本及验收。工具更新不转换应用。Node.js 24+ 可安装 `npm install -g openxiangda@latest`,再使用新版全局入口执行 `openxiangda migrate assess --to v2`。本项目依赖继续按 `legacy-v1` 维护。CLI、Skill、MCP 说明见 https://github.com/1377385356/openxiangda/blob/master/docs/getting-started.md#upgrade 。
|
|
10
|
+
|
|
7
11
|
## Delivery V2(发布唯一入口)
|
|
8
12
|
|
|
9
13
|
本工作区声明 `deliveryVersion: 2`,正常发布只使用 `openxiangda check`、`openxiangda deploy`、`openxiangda status`、`openxiangda retry`、`openxiangda rollback`,完整约定见 [DELIVERY.md](DELIVERY.md)。V2 按资源指纹计算精确范围,使用不依赖工作区 `node_modules` 的 CLI 密封工具链,并在服务端持久化 ReleaseRun、attempt 和检查点;跨机器重试只重放本地 Form 绑定。Runtime buildId 同时包含 Runtime layer 与密封包摘要,避免相同 Runtime 字节在不同包之间发生来源碰撞;同包重试仅在历史 Release 为 `uploaded` 且内容、源码、父版本完全一致时复用,不覆盖不可变存储对象。删除和未密封构建依赖在写入前失败关闭。`status`/`retry` 未指定环境时会自动定位预发或生产。V2 不要求 SDD、Git clean、主线 ancestry、`--change`、`--only` 或生产确认参数。本文后续出现的 `resource publish`、`runtime deploy`、`release publish/ship`、candidate、SDD/mainline 发布门禁均为 V1 底层兼容说明,不得用于 V2 正常发布。
|
|
@@ -100,6 +104,8 @@ openxiangda release ship --change <release-change> --profile <name> --confirm-pr
|
|
|
100
104
|
|
|
101
105
|
App Function 第三方凭据只能在 Function manifest 顶层声明 `secretRefs: [{name, required}]`,并使用 `function_v2` + `runtimeContractVersion: "trusted_node_v2"`;源码通过 `await ctx.secrets.get(name)` 获取。值只能经 `openxiangda secret create|rotate --value-stdin --change <id> --profile <name>` 或隐藏 TTY 配置,禁止进入 Git、`.env`、manifest、源码、构建产物、plan、日志和异常。本地测试只使用 `openxiangda function test --secret-from-env logical=ENV` 的隔离子进程注入。
|
|
102
106
|
|
|
107
|
+
外部系统主动回调使用 `src/resources/webhooks/<code>.json`,只声明固定的 `targetFunctionCode`、幂等 Query 参数、Body 上限和启停状态。Secret 仍由目标 Function 顶层 `secretRefs` 声明;Function 必须先基于 `input.rawBody` 验签,再调用任何表单、数据视图、连接器、通知或 HTTP helper,并用 `input.idempotencyKey` 保护业务写入。完整输入和返回契约见 `$openxiangda-workflow-automation` 的 `references/webhooks.md`。
|
|
108
|
+
|
|
103
109
|
App Function 查询应用角色及维护角色成员必须使用正式的 `ctx.platform.roles`:`findByCode(roleCode)`、`list()`、`get(roleId)`、`listUsers(roleId)`、`addUsers(roleId, userIds)`、`removeUser(roleId, userId)`。该 API 固定到 `ctx.app.appType`,按真实 operator 校验 `app:role:manage` 并保留调用审计;不要依赖自定义的 `ctx.platform.roles` 声明,也不要用泛型 `ctx.platform.api` 绕过角色契约。
|
|
104
110
|
|
|
105
111
|
`openxiangda runtime deploy --no-activate` 会构建并上传不可变预览版本;发布前先提交所有可能进入构建的源码/配置。所有 Runtime deploy(包括 `--no-activate`)都会先获取应用发布 lease,并在任何构建和上传前冻结 clean `HEAD` 与当前 active Runtime 父血缘;旧分支返回 `RUNTIME_SOURCE_BASE_DIVERGED`,不能先上传旧 preview 再激活。`openspec/` SDD 证据和生成/状态目录不算源码 dirty。仅审批的回退可使用 `--allow-runtime-rollback --reason "至少 8 个字符"`;`--no-build` 不会跳过守卫。不要手工修改 `dist/index.html`。
|
|
@@ -197,3 +203,5 @@ import {
|
|
|
197
203
|
- candidate 创建后允许主线继续合入不相干任务;晋级时要求 candidate commit 仍是已推送主线祖先,且 sealed 输入文件哈希全部不变。任一输入变化都必须重建 candidate。
|
|
198
204
|
- 同一目标环境一次只允许一个 running / evidence-pending deployment;CLI 会先等待应用 lease 和部署槽位。`--wait-seconds 0` 只用于快速发现占用,不能绕过 CAS。
|
|
199
205
|
- 紧急修复使用精确 L1 scope,仍按 candidate → preproduction → production 发布;不得跳过应用/环境资源映射校验、预发证据或生产确认。应用内逐函数 `resources` 仅作映射和审计,不是权限白名单。
|
|
206
|
+
|
|
207
|
+
平台登录态只使用当前工作区的 `.openxiangda/profiles.json`,不再读取或合并用户主目录的全局 profiles。升级后请进入每个项目运行 `openxiangda login <platform-url>`;子目录沿最近应用根目录定位,不跨嵌套应用或 Git 边界。登录文件及临时文件会自动加入忽略规则,请勿提交或打包。新项目先用 `openxiangda login <platform-url> --cwd <directory>` 在目标目录登录,再在该目录运行 `openxiangda workspace init`。
|
|
@@ -31,6 +31,8 @@ Exact `--only/--code` selectors apply before manifest/source analysis and JS_COD
|
|
|
31
31
|
|
|
32
32
|
App Function manifests may contain only logical names in top-level `secretRefs`; use `function_v2` / `trusted_node_v2`, resolve values with `ctx.secrets.get(name)`, and manage values only with `openxiangda secret ... --value-stdin --change ... --profile ...`. Values never belong in Git, `.env`, manifests, source, builds, plans, logs, or errors.
|
|
33
33
|
|
|
34
|
+
Inbound callbacks use `src/resources/webhooks/*.json` with one fixed `targetFunctionCode`. Keep Secret/signature rules out of that manifest; verify `input.rawBody` before any helper call and make business writes idempotent with `input.idempotencyKey`.
|
|
35
|
+
|
|
34
36
|
When a Function/Automation enters scope only through source changes, publishing uses a server-side source-field PATCH and preserves online bindings, contracts, metadata, trigger/view configuration, and enabled/published state. A new source-free Automation with a complete `definitionJson.version="v3"` automatically uses manifest create; replacing an existing whole manifest requires `--replace-manifest --reason "..."`. Formal promotion freezes the clean publish HEAD separately from the change/remote baseline and preflights the whole set; `SOURCE_BASE_DIVERGED`, `RELEASE_SOURCE_BEHIND_MAIN`, and `RESOURCE_FIELD_CONFLICT` require reconciliation. After activation, merge/push the frozen SHA, verify `release integration-status`, then run normal `release end`.
|
|
35
37
|
|
|
36
38
|
Before editing `roles`, `permissions/page-groups`, or `permissions/form-groups` for account/role/data-scope/RBAC/query-param authorization work, run `openxiangda design gates --topic permissions --json`, choose the permission mode, and write the permission matrix.
|
|
@@ -7,6 +7,10 @@ alwaysApply: true
|
|
|
7
7
|
|
|
8
8
|
This is a `sy-lowcode-app-workspace` managed by the `openxiangda` CLI. See [AGENTS.md](mdc:AGENTS.md) for full guidance.
|
|
9
9
|
|
|
10
|
+
## 工具升级与代际选择
|
|
11
|
+
|
|
12
|
+
建议评估升级到 OpenXiangda 2.0;新应用优先使用 V2,已有项目先确认能力覆盖、迁移成本及验收。工具更新不转换应用。Node.js 24+ 可安装 `npm install -g openxiangda@latest`,再使用新版全局入口执行 `openxiangda migrate assess --to v2`。本项目依赖继续按 `legacy-v1` 维护。CLI、Skill、MCP 说明见 https://github.com/1377385356/openxiangda/blob/master/docs/getting-started.md#upgrade 。
|
|
13
|
+
|
|
10
14
|
## Hard route — user intent → skill / command
|
|
11
15
|
|
|
12
16
|
| User says | Skill | Command |
|
|
@@ -49,7 +53,7 @@ This is a `sy-lowcode-app-workspace` managed by the `openxiangda` CLI. See [AGEN
|
|
|
49
53
|
- Confirm current profile before any write: `openxiangda env --profile <name>`.
|
|
50
54
|
- `.openxiangda/state.json` is the authoritative durable profile → appType → resource-ID map; volatile release/deployment progress stays in the private `.openxiangda/releases/` journal. CLI maintains both; do not hand-edit.
|
|
51
55
|
- In a managed workspace with multiple targets, pass `--environment <target>` to `function invoke` and verify the resolved target printed on stderr.
|
|
52
|
-
- User tokens live in
|
|
56
|
+
- User tokens live in `.openxiangda/profiles.json`; shared env in `~/.openxiangda/.env`.
|
|
53
57
|
- Form fields need user-facing `placeholder`; use `SelectField` / `RadioField` for enums, `linkedForm` SelectField for cross-form sources.
|
|
54
58
|
- Form-entry component priority: OpenXiangda platform components → `antd` / `antd-mobile` wrappers → custom business component only when neither fits.
|
|
55
59
|
- Proactively run `openxiangda feedback submit --yes` for platform defects, missing capabilities, unclear rules, repeated workarounds, AI uncertainty, and user-visible UX gaps; tell the user what was reported and the fingerprint.
|
|
@@ -79,3 +83,5 @@ Read [AGENTS.md](mdc:AGENTS.md) and the global skill: `~/.qoder/skills/openxiang
|
|
|
79
83
|
## Parallel candidates
|
|
80
84
|
|
|
81
85
|
A candidate may cross unrelated later mainline commits only when its commit remains an ancestor of clean pushed mainline and all sealed input hashes remain unchanged. The later HEAD is only a safety gate; Backend, Runtime, and Root keep the candidate sourceRevision. Each target allows one running or evidence-pending deployment; wait for the lease/slot, and keep emergency fixes on the narrow candidate → preproduction → production path.
|
|
86
|
+
|
|
87
|
+
平台登录态只使用当前工作区的 `.openxiangda/profiles.json`,不再读取或合并用户主目录的全局 profiles。升级后请进入每个项目运行 `openxiangda login <platform-url>`;子目录沿最近应用根目录定位,不跨嵌套应用或 Git 边界。登录文件及临时文件会自动加入忽略规则,请勿提交或打包。新项目先用 `openxiangda login <platform-url> --cwd <directory>` 在目标目录登录,再在该目录运行 `openxiangda workspace init`。
|
|
@@ -52,6 +52,7 @@ Function/Automation 仅因源码变化进入 scope 时,默认通过服务端
|
|
|
52
52
|
- ❌ 把 `formUuid` / `pageId` / `workflowId` 等平台 ID 直接写进 manifest(CLI 解析逻辑 code)。
|
|
53
53
|
- ❌ 把 API key / token / secret / password / authorization / headers / credential 写进 manifest(平台后台配置)。
|
|
54
54
|
- ✅ App Function 只在 manifest 顶层写逻辑名 `secretRefs`,使用 `function_v2` / `trusted_node_v2` 和 `ctx.secrets.get(name)`;值仅由 `openxiangda secret ... --value-stdin --change ... --profile ...` 管理。
|
|
55
|
+
- ✅ 外部回调在 `src/resources/webhooks/*.json` 只绑定固定 `targetFunctionCode`;验签必须先使用 `input.rawBody`,业务写入必须使用 `input.idempotencyKey` 幂等,Secret/签名规则不写进 Webhook manifest。
|
|
55
56
|
- ❌ data view 用作单表 CRUD、`linkedForm` 下拉、写回、强实时数据源。
|
|
56
57
|
- ❌ 只靠 query 参数、前端隐藏按钮、硬编码角色、mock 权限或 `PermissionBoundary` 作为敏感授权。
|
|
57
58
|
- ❌ 管理型角色缺少 `app:role:manage`、`app:page-permission-group:manage`、`app:form-permission-group:manage` 或 `app:organization:manage`。
|
|
@@ -7,6 +7,10 @@ alwaysApply: true
|
|
|
7
7
|
|
|
8
8
|
This is a `sy-lowcode-app-workspace` managed by the `openxiangda` CLI. Read [AGENTS.md](AGENTS.md) for the full guidance. The summary below is auto-injected into every Qoder turn.
|
|
9
9
|
|
|
10
|
+
## 工具升级与代际选择
|
|
11
|
+
|
|
12
|
+
建议评估升级到 OpenXiangda 2.0;新应用优先使用 V2,已有项目先确认能力覆盖、迁移成本及验收。工具更新不转换应用。Node.js 24+ 可安装 `npm install -g openxiangda@latest`,再使用新版全局入口执行 `openxiangda migrate assess --to v2`。本项目依赖继续按 `legacy-v1` 维护。CLI、Skill、MCP 说明见 https://github.com/1377385356/openxiangda/blob/master/docs/getting-started.md#upgrade 。
|
|
13
|
+
|
|
10
14
|
## Hard route — 用户意图 → skill / 命令
|
|
11
15
|
|
|
12
16
|
| 用户说 | 必用 skill | 必用命令 |
|
|
@@ -50,7 +54,7 @@ This is a `sy-lowcode-app-workspace` managed by the `openxiangda` CLI. Read [AGE
|
|
|
50
54
|
- 任何写操作前确认当前 profile:`openxiangda env --profile <name>`。
|
|
51
55
|
- `.openxiangda/state.json` 是 profile 到 appType / 资源 ID 的持久权威映射;临时 release/deployment 进度只写私有 `.openxiangda/releases/` journal。两者均由 CLI 维护,不要手改。
|
|
52
56
|
- 多 target 的托管工作区执行 `function invoke` 必须显式传 `--environment <target>`,并核对 stderr 回显的最终 target。
|
|
53
|
-
- 用户 token 在
|
|
57
|
+
- 用户 token 在 `.openxiangda/profiles.json`;共享 env 在 `~/.openxiangda/.env`。
|
|
54
58
|
- 表单字段必须有 user-facing `placeholder`;选项使用 `SelectField` / `RadioField`,跨表用 `linkedForm` SelectField。
|
|
55
59
|
- 表单录入组件顺序:OpenXiangda 平台组件 → `antd` / `antd-mobile` 包装 → 必要时自定义业务组件。
|
|
56
60
|
- 发现平台缺陷、能力缺口、规则不清、反复 workaround、AI 不确定点、用户可见体验问题时,主动 `openxiangda feedback submit --yes`;提交后告诉用户反馈内容和 fingerprint。
|
|
@@ -80,3 +84,5 @@ This is a `sy-lowcode-app-workspace` managed by the `openxiangda` CLI. Read [AGE
|
|
|
80
84
|
## 并行 candidate
|
|
81
85
|
|
|
82
86
|
candidate 只可跨越不相干的后续主线提交:其 commit 必须仍是干净、已推送主线的祖先,且 sealed 输入哈希全部不变。同一目标一次只允许一个 running / evidence-pending deployment;等待 lease/槽位,紧急修复也走精确 candidate → preproduction → production。
|
|
87
|
+
|
|
88
|
+
平台登录态只使用当前工作区的 `.openxiangda/profiles.json`,不再读取或合并用户主目录的全局 profiles。升级后请进入每个项目运行 `openxiangda login <platform-url>`;子目录沿最近应用根目录定位,不跨嵌套应用或 Git 边界。登录文件及临时文件会自动加入忽略规则,请勿提交或打包。新项目先用 `openxiangda login <platform-url> --cwd <directory>` 在目标目录登录,再在该目录运行 `openxiangda workspace init`。
|
|
@@ -5,6 +5,10 @@
|
|
|
5
5
|
> 任何 AI(Qoder / Claude / Codex / Cursor / Copilot 等)在本工作区操作前 **必须先读完本文件**。
|
|
6
6
|
> 这是 `sy-lowcode-app-workspace`,由 `openxiangda` CLI 统一管理;普通 npm 习惯不适用于此工作区的发布与生命周期操作。
|
|
7
7
|
|
|
8
|
+
## 工具升级与代际选择
|
|
9
|
+
|
|
10
|
+
建议评估升级到 OpenXiangda 2.0;新应用优先使用 V2,已有项目先确认能力覆盖、迁移成本及验收。工具更新不转换应用。Node.js 24+ 可安装 `npm install -g openxiangda@latest`,再使用新版全局入口执行 `openxiangda migrate assess --to v2`。本项目依赖继续按 `legacy-v1` 维护。CLI、Skill、MCP 说明见 https://github.com/1377385356/openxiangda/blob/master/docs/getting-started.md#upgrade 。
|
|
11
|
+
|
|
8
12
|
## 一句话原则
|
|
9
13
|
|
|
10
14
|
**本工作区声明 `deliveryVersion: 2`。所有“发布 / 上线 / 部署 / publish / deploy / ship / release”请求只使用 `openxiangda check`、`openxiangda deploy`、`openxiangda status`、`openxiangda retry`、`openxiangda rollback`,完整约定见 [DELIVERY.md](DELIVERY.md)。**
|
|
@@ -54,7 +58,7 @@ Delivery V2 自动从期望状态按资源指纹计算精确范围,使用 CLI
|
|
|
54
58
|
- ✅ 某个应用角色如果要查询组织账号,声明 `app:organization:read`;如需创建、修改账号/部门或重置密码,再声明 `app:organization:manage`。角色设置、页面/表单权限组等能力同样通过 `src/resources/roles/<code>.json` 的 `apiPermissionCodes` 显式授权,例如 `app:role:manage`、`app:page-permission-group:manage`、`app:form-permission-group:manage`。
|
|
55
59
|
- ✅ 查询家校通讯录的家长、学生、教师、班主任身份和班级/监护关系时使用 `sdk.organization.schoolContact.*` / `ctx.organization.schoolContact.*`。`SCHOOL_HEAD_TEACHER` 只判断全局身份,具体班级必须读取 `teachers.list` 的 `isHeadTeacher`、`teacher.managedClasses` 和 `class.headTeachers`。已登录非游客用户无需绑定应用角色权限,默认查询当前租户全部关系;只有明确要求时才声明 `:self:read` 或 `:class:read` 收紧。
|
|
56
60
|
- ✅ 单文件改动默认按 change 和逻辑资源增量发布:`workspace plan --profile <name> --change <change> --changed`,再 `workspace publish --profile <name> --change <change> --only pages/a,forms/b --dry-run` → 正式发布。
|
|
57
|
-
- ✅ 用户 token 在
|
|
61
|
+
- ✅ 用户 token 在 `.openxiangda/profiles.json`;项目 state 在 `.openxiangda/state.json`(只存 ID)。
|
|
58
62
|
- ✅ 共享环境(`APP_OSS_*`、反馈机器人等)在 `~/.openxiangda/.env`,项目 `.env` 仅做 per-workspace override。
|
|
59
63
|
- ✅ 多 profile(dev / prod / ...)资源 ID 互不复用;每个 profile 的 `appType` / `formUuid` / `pageId` / `workflowId` / `automationId` 独立维护。
|
|
60
64
|
- ✅ 改已有应用前先 `openxiangda app snapshot APP_XXX --profile <name> --json`。
|
|
@@ -114,6 +118,8 @@ Delivery V2 自动从期望状态按资源指纹计算精确范围,使用 CLI
|
|
|
114
118
|
|
|
115
119
|
App Function 第三方凭据只能在 Function manifest 顶层声明 `secretRefs: [{name, required}]`,并使用 `function_v2` + `runtimeContractVersion: "trusted_node_v2"`;源码通过 `await ctx.secrets.get(name)` 获取。值只能用 `openxiangda secret create|rotate --value-stdin --change <id> --profile <name>` 或隐藏 TTY 配置,禁止写入 Git、`.env`、manifest、源码、构建产物、plan、日志和异常。本地联调只允许 `openxiangda function test --secret-from-env logical=ENV`,它不会把值写入 workspace/cache/state。
|
|
116
120
|
|
|
121
|
+
外部系统主动回调使用 `src/resources/webhooks/<code>.json`,只声明固定的 `targetFunctionCode`、幂等 Query 参数、Body 上限和启停状态。Secret 仍由目标 Function 顶层 `secretRefs` 声明;Function 必须先基于 `input.rawBody` 验签,再调用任何表单、数据视图、连接器、通知或 HTTP helper,并用 `input.idempotencyKey` 保护业务写入。完整输入和返回契约见 `$openxiangda-workflow-automation` 的 `references/webhooks.md`。
|
|
122
|
+
|
|
117
123
|
App Function 查询应用角色及维护角色成员必须使用正式的 `ctx.platform.roles`:`findByCode(roleCode)`、`list()`、`get(roleId)`、`listUsers(roleId)`、`addUsers(roleId, userIds)`、`removeUser(roleId, userId)`。该 API 固定到 `ctx.app.appType`,按真实 operator 校验 `app:role:manage` 并保留调用审计;不要依赖自定义的 `ctx.platform.roles` 声明,也不要用泛型 `ctx.platform.api` 绕过角色契约。
|
|
118
124
|
|
|
119
125
|
## 工作区结构速查
|
|
@@ -157,3 +163,5 @@ sy-lowcode-app-workspace/
|
|
|
157
163
|
- candidate 创建后允许主线继续合入不相干任务;晋级时要求 candidate commit 仍是已推送主线祖先,且 sealed 输入文件哈希全部不变。任一输入变化都必须重建 candidate。
|
|
158
164
|
- 同一目标环境一次只允许一个 running / evidence-pending deployment;CLI 会先等待应用 lease 和部署槽位。`--wait-seconds 0` 只用于快速发现占用,不能绕过 CAS。
|
|
159
165
|
- 紧急修复使用精确 L1 scope,仍按 candidate → preproduction → production 发布;不得跳过应用/环境资源映射校验、预发证据或生产确认。应用内逐函数 `resources` 仅作映射和审计,不是权限白名单。
|
|
166
|
+
|
|
167
|
+
平台登录态只使用当前工作区的 `.openxiangda/profiles.json`,不再读取或合并用户主目录的全局 profiles。升级后请进入每个项目运行 `openxiangda login <platform-url>`;子目录沿最近应用根目录定位,不跨嵌套应用或 Git 边界。登录文件及临时文件会自动加入忽略规则,请勿提交或打包。新项目先用 `openxiangda login <platform-url> --cwd <directory>` 在目标目录登录,再在该目录运行 `openxiangda workspace init`。
|