openxiangda 2.31.6 → 2.31.7
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/documentation/backend.md +9 -0
- package/documentation/getting-started.md +7 -7
- package/documentation/manifest.json +3 -3
- package/package.json +20 -20
- package/releases/2.31.7.json +29 -0
- package/skills/manifest.json +1 -1
- package/skills/openxiangda-v2/SKILL.md +4 -4
- package/skills/openxiangda-v2/references/backend.md +9 -0
- package/skills/openxiangda-v2/references/getting-started.md +7 -7
package/documentation/backend.md
CHANGED
|
@@ -386,3 +386,12 @@ if (output.status === 'pending') {
|
|
|
386
386
|
这些方法适用于当前用户、具名业务动作和应用服务身份，沿用各自权限；业务记录绑定仍需正式数据事务。输出目前支持 OSS/MinIO，受字段上限与100MiB硬上限约束，上传凭据五分钟后过期，完成须在额外十分钟内进行。过期错误应由调用者建立新的处理意图，不能无限重试相同过期计划。下载最长五分钟，签发后到期前为短期委托，不能即时撤回。不要在日志、持久草稿或业务数据中保存签名地址、POST policy 或签名字段。
|
|
387
387
|
|
|
388
388
|
主子记录共享精确金额额度、撤回修订和审批释放，请使用[精确金额占用](decimal-reservations.md)的受管提交及终态事务。
|
|
389
|
+
|
|
390
|
+
|
|
391
|
+
## 解析管理员选定的组织人员
|
|
392
|
+
|
|
393
|
+
管理员补录或身份订正应使用平台目录，不创建第二份人员主数据。具名动作声明
|
|
394
|
+
`platformAccess: { directory: { mode: 'selected-user', fields: ['displayName', 'employeeNumber', 'primaryDepartment', 'departments'] } }`
|
|
395
|
+
后，调用 `businessDirectory.selectedUser(userId)`。仅传标准人员选择器返回的确定 ID；姓名、工号和部门均由平台返回，不能相信表单传入快照。
|
|
396
|
+
|
|
397
|
+
此动作的调用者还需要既有 `app:<appCode>:directory:read` 权限；平台复核当前租户、环境、目录范围和人员有效期，一次只解析一人。普通用户本人报名继续使用 `currentInitiator()`。身份快照不是永久授权凭据，后续业务事务仍需检查角色、状态与额度。平台能力为 `directory.selected-user` 1.0.0；失败时保留原操作，不回退姓名匹配或应用人员表。
|
|
@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
|
|
|
68
68
|
以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
|
|
69
69
|
|
|
70
70
|
```bash
|
|
71
|
-
pnpm dlx openxiangda@2.31.
|
|
72
|
-
pnpm dlx openxiangda@2.31.
|
|
73
|
-
pnpm dlx openxiangda@2.31.
|
|
74
|
-
pnpm dlx openxiangda@2.31.
|
|
71
|
+
pnpm dlx openxiangda@2.31.7 skill install --force
|
|
72
|
+
pnpm dlx openxiangda@2.31.7 auth status --base-url <平台地址> --json
|
|
73
|
+
pnpm dlx openxiangda@2.31.7 login --cwd my-app --base-url https://platform.example.com
|
|
74
|
+
pnpm dlx openxiangda@2.31.7 create my-app --base-url https://platform.example.com
|
|
75
75
|
cd my-app
|
|
76
76
|
pnpm openxiangda context --json
|
|
77
77
|
pnpm openxiangda dev
|
|
@@ -174,9 +174,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
|
|
|
174
174
|
无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
|
|
175
175
|
|
|
176
176
|
```bash
|
|
177
|
-
pnpm dlx openxiangda@2.31.
|
|
178
|
-
pnpm dlx openxiangda@2.31.
|
|
179
|
-
pnpm dlx openxiangda@2.31.
|
|
177
|
+
pnpm dlx openxiangda@2.31.7 auth status --base-url <平台> --json
|
|
178
|
+
pnpm dlx openxiangda@2.31.7 source resolve <仓库URL> --base-url <平台> --json
|
|
179
|
+
pnpm dlx openxiangda@2.31.7 source clone <仓库URL> <新目录> --base-url <平台> --json
|
|
180
180
|
```
|
|
181
181
|
|
|
182
182
|
登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": "openxiangda.documentation/v1",
|
|
3
|
-
"version": "2.31.
|
|
3
|
+
"version": "2.31.7",
|
|
4
4
|
"topics": [
|
|
5
5
|
{
|
|
6
6
|
"id": "getting-started",
|
|
7
7
|
"title": "安装与开始开发",
|
|
8
8
|
"file": "getting-started.md",
|
|
9
|
-
"sha256": "
|
|
9
|
+
"sha256": "0471435f0c0cde044b14f3de94c4aa7a0b16fbc273e2fccd500ca51ef9911a3c"
|
|
10
10
|
},
|
|
11
11
|
{
|
|
12
12
|
"id": "product-design",
|
|
@@ -90,7 +90,7 @@
|
|
|
90
90
|
"id": "backend",
|
|
91
91
|
"title": "按需后端与业务动作",
|
|
92
92
|
"file": "backend.md",
|
|
93
|
-
"sha256": "
|
|
93
|
+
"sha256": "54feea4530e28cd8602a183a27def14d5212cabd05b10f5687c5a21bceab848f"
|
|
94
94
|
},
|
|
95
95
|
{
|
|
96
96
|
"id": "agent-cards",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "openxiangda",
|
|
3
|
-
"version": "2.31.
|
|
3
|
+
"version": "2.31.7",
|
|
4
4
|
"description": "OpenXiangda 2.0 的统一命令、应用 SDK、MCP 与中文 AI 技能资料。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -64,13 +64,13 @@
|
|
|
64
64
|
"antd-mobile": "5.42.3",
|
|
65
65
|
"dayjs": "1.11.18",
|
|
66
66
|
"docx-preview": "0.3.7",
|
|
67
|
-
"openxiangda-cli": "2.6.
|
|
68
|
-
"openxiangda-contracts": "2.
|
|
69
|
-
"openxiangda-devkit-core": "2.34.
|
|
67
|
+
"openxiangda-cli": "2.6.9",
|
|
68
|
+
"openxiangda-contracts": "2.32.0",
|
|
69
|
+
"openxiangda-devkit-core": "2.34.2",
|
|
70
70
|
"openxiangda-legacy": "npm:openxiangda@1.0.269",
|
|
71
|
-
"openxiangda-mcp": "2.0.
|
|
72
|
-
"openxiangda-nest": "2.
|
|
73
|
-
"openxiangda-skill-kit": "2.3.
|
|
71
|
+
"openxiangda-mcp": "2.0.58",
|
|
72
|
+
"openxiangda-nest": "2.8.0",
|
|
73
|
+
"openxiangda-skill-kit": "2.3.33",
|
|
74
74
|
"xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
|
|
75
75
|
},
|
|
76
76
|
"peerDependencies": {
|
|
@@ -136,32 +136,32 @@
|
|
|
136
136
|
},
|
|
137
137
|
"openxiangdaRelease": {
|
|
138
138
|
"schemaVersion": "openxiangda.release-notes/v1",
|
|
139
|
-
"version": "2.31.
|
|
139
|
+
"version": "2.31.7",
|
|
140
140
|
"status": "reviewed",
|
|
141
|
-
"title": "OpenXiangda 2.31.
|
|
142
|
-
"summary": "
|
|
143
|
-
"newFeatures": [
|
|
144
|
-
|
|
145
|
-
"Vite 单文件 IIFE 示例明确替换 process.env.NODE_ENV，并要求在无同源 sandbox 与 CSP 下验证卡片握手和提交消息。"
|
|
141
|
+
"title": "OpenXiangda 2.31.7：后端受控核验所选组织人员",
|
|
142
|
+
"summary": "应用后端可在已声明的业务操作内核验所选人员，姓名、工号与部门由平台组织架构提供。",
|
|
143
|
+
"newFeatures": [
|
|
144
|
+
"增加 selected-user 目录声明和 BusinessDirectoryService.selectedUser，按声明投影组织身份字段并返回核验快照。"
|
|
146
145
|
],
|
|
146
|
+
"fixes": [],
|
|
147
147
|
"affectedUsers": [
|
|
148
|
-
"
|
|
148
|
+
"需要管理员代录、身份纠正或针对所选组织人员执行业务操作的 V2 应用。"
|
|
149
149
|
],
|
|
150
150
|
"upgradeSteps": [
|
|
151
|
-
"
|
|
151
|
+
"升级应用工具链，并先部署支持 directory.selected-user 1.0.0 的平台；在具体后端操作声明所需字段和目录读取权限。"
|
|
152
152
|
],
|
|
153
153
|
"knownLimitations": [
|
|
154
|
-
"
|
|
154
|
+
"只支持同租户有效组织人员；未声明能力、无目录权限或人员不可用时明确拒绝。"
|
|
155
155
|
],
|
|
156
156
|
"issues": [],
|
|
157
157
|
"compatibility": {
|
|
158
158
|
"node": ">=24",
|
|
159
159
|
"workspaceGenerations": "v2",
|
|
160
|
-
"platform": "
|
|
161
|
-
"v1": "独立 V1
|
|
160
|
+
"platform": "新增能力需要支持 directory.selected-user 1.0.0 的平台；既有 current-initiator 行为不变。",
|
|
161
|
+
"v1": "独立 V1 引擎不受影响。"
|
|
162
162
|
},
|
|
163
|
-
"sha256": "
|
|
164
|
-
"url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.
|
|
163
|
+
"sha256": "8843f2ad58d915c2b9158821b6640bc4453a5e0e6f6066d918fda0e9dc168ccd",
|
|
164
|
+
"url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.7"
|
|
165
165
|
},
|
|
166
166
|
"scripts": {
|
|
167
167
|
"build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": "openxiangda.release-notes/v1",
|
|
3
|
+
"version": "2.31.7",
|
|
4
|
+
"status": "reviewed",
|
|
5
|
+
"title": "OpenXiangda 2.31.7：后端受控核验所选组织人员",
|
|
6
|
+
"summary": "应用后端可在已声明的业务操作内核验所选人员，姓名、工号与部门由平台组织架构提供。",
|
|
7
|
+
"newFeatures": [
|
|
8
|
+
"增加 selected-user 目录声明和 BusinessDirectoryService.selectedUser，按声明投影组织身份字段并返回核验快照。"
|
|
9
|
+
],
|
|
10
|
+
"fixes": [],
|
|
11
|
+
"affectedUsers": [
|
|
12
|
+
"需要管理员代录、身份纠正或针对所选组织人员执行业务操作的 V2 应用。"
|
|
13
|
+
],
|
|
14
|
+
"upgradeSteps": [
|
|
15
|
+
"升级应用工具链，并先部署支持 directory.selected-user 1.0.0 的平台；在具体后端操作声明所需字段和目录读取权限。"
|
|
16
|
+
],
|
|
17
|
+
"knownLimitations": [
|
|
18
|
+
"只支持同租户有效组织人员；未声明能力、无目录权限或人员不可用时明确拒绝。"
|
|
19
|
+
],
|
|
20
|
+
"issues": [],
|
|
21
|
+
"compatibility": {
|
|
22
|
+
"node": ">=24",
|
|
23
|
+
"workspaceGenerations": "v2",
|
|
24
|
+
"platform": "新增能力需要支持 directory.selected-user 1.0.0 的平台；既有 current-initiator 行为不变。",
|
|
25
|
+
"v1": "独立 V1 引擎不受影响。"
|
|
26
|
+
},
|
|
27
|
+
"sha256": "8843f2ad58d915c2b9158821b6640bc4453a5e0e6f6066d918fda0e9dc168ccd",
|
|
28
|
+
"url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.7"
|
|
29
|
+
}
|
package/skills/manifest.json
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
{
|
|
5
5
|
"name": "openxiangda-v2",
|
|
6
6
|
"description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，由当前 AI Agent 按需用 Image 2.5 等图片能力形成视觉参考，直接实现真实页面并在浏览器修正，再检查和交付应用；维护 1.x 应用时使用对应的 1.x 技能。",
|
|
7
|
-
"sha256": "
|
|
7
|
+
"sha256": "cbe95066d7c4a3c82f07bb9b6c228e1d2e33784ddfa9fab5112ba17936e8c4ce"
|
|
8
8
|
}
|
|
9
9
|
]
|
|
10
10
|
}
|
|
@@ -40,10 +40,10 @@ AI 接到新应用、页面或改版任务时，在同一个 OpenXiangda 工作
|
|
|
40
40
|
未创建工作区时使用本 Skill 随根包发布的精确版本：
|
|
41
41
|
|
|
42
42
|
```bash
|
|
43
|
-
pnpm dlx openxiangda@2.31.
|
|
44
|
-
pnpm dlx openxiangda@2.31.
|
|
45
|
-
pnpm dlx openxiangda@2.31.
|
|
46
|
-
pnpm dlx openxiangda@2.31.
|
|
43
|
+
pnpm dlx openxiangda@2.31.7 auth status --cwd <应用目录> --base-url <平台地址> --json
|
|
44
|
+
pnpm dlx openxiangda@2.31.7 login --cwd <应用目录> --base-url <平台地址>
|
|
45
|
+
pnpm dlx openxiangda@2.31.7 create <应用目录> --base-url <同一平台地址>
|
|
46
|
+
pnpm dlx openxiangda@2.31.7 skill install --force
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。
|
|
@@ -386,3 +386,12 @@ if (output.status === 'pending') {
|
|
|
386
386
|
这些方法适用于当前用户、具名业务动作和应用服务身份，沿用各自权限；业务记录绑定仍需正式数据事务。输出目前支持 OSS/MinIO，受字段上限与100MiB硬上限约束，上传凭据五分钟后过期，完成须在额外十分钟内进行。过期错误应由调用者建立新的处理意图，不能无限重试相同过期计划。下载最长五分钟，签发后到期前为短期委托，不能即时撤回。不要在日志、持久草稿或业务数据中保存签名地址、POST policy 或签名字段。
|
|
387
387
|
|
|
388
388
|
主子记录共享精确金额额度、撤回修订和审批释放，请使用[精确金额占用](decimal-reservations.md)的受管提交及终态事务。
|
|
389
|
+
|
|
390
|
+
|
|
391
|
+
## 解析管理员选定的组织人员
|
|
392
|
+
|
|
393
|
+
管理员补录或身份订正应使用平台目录，不创建第二份人员主数据。具名动作声明
|
|
394
|
+
`platformAccess: { directory: { mode: 'selected-user', fields: ['displayName', 'employeeNumber', 'primaryDepartment', 'departments'] } }`
|
|
395
|
+
后，调用 `businessDirectory.selectedUser(userId)`。仅传标准人员选择器返回的确定 ID；姓名、工号和部门均由平台返回，不能相信表单传入快照。
|
|
396
|
+
|
|
397
|
+
此动作的调用者还需要既有 `app:<appCode>:directory:read` 权限；平台复核当前租户、环境、目录范围和人员有效期，一次只解析一人。普通用户本人报名继续使用 `currentInitiator()`。身份快照不是永久授权凭据，后续业务事务仍需检查角色、状态与额度。平台能力为 `directory.selected-user` 1.0.0；失败时保留原操作，不回退姓名匹配或应用人员表。
|
|
@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
|
|
|
68
68
|
以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
|
|
69
69
|
|
|
70
70
|
```bash
|
|
71
|
-
pnpm dlx openxiangda@2.31.
|
|
72
|
-
pnpm dlx openxiangda@2.31.
|
|
73
|
-
pnpm dlx openxiangda@2.31.
|
|
74
|
-
pnpm dlx openxiangda@2.31.
|
|
71
|
+
pnpm dlx openxiangda@2.31.7 skill install --force
|
|
72
|
+
pnpm dlx openxiangda@2.31.7 auth status --base-url <平台地址> --json
|
|
73
|
+
pnpm dlx openxiangda@2.31.7 login --cwd my-app --base-url https://platform.example.com
|
|
74
|
+
pnpm dlx openxiangda@2.31.7 create my-app --base-url https://platform.example.com
|
|
75
75
|
cd my-app
|
|
76
76
|
pnpm openxiangda context --json
|
|
77
77
|
pnpm openxiangda dev
|
|
@@ -174,9 +174,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
|
|
|
174
174
|
无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
|
|
175
175
|
|
|
176
176
|
```bash
|
|
177
|
-
pnpm dlx openxiangda@2.31.
|
|
178
|
-
pnpm dlx openxiangda@2.31.
|
|
179
|
-
pnpm dlx openxiangda@2.31.
|
|
177
|
+
pnpm dlx openxiangda@2.31.7 auth status --base-url <平台> --json
|
|
178
|
+
pnpm dlx openxiangda@2.31.7 source resolve <仓库URL> --base-url <平台> --json
|
|
179
|
+
pnpm dlx openxiangda@2.31.7 source clone <仓库URL> <新目录> --base-url <平台> --json
|
|
180
180
|
```
|
|
181
181
|
|
|
182
182
|
登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回
|