openxiangda 2.18.4 → 2.18.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/declarations-cheatsheet.md +2 -0
- package/documentation/getting-started.md +7 -7
- package/documentation/manifest.json +3 -3
- package/package.json +17 -21
- package/releases/2.18.7.json +30 -0
- package/skills/manifest.json +1 -1
- package/skills/openxiangda-v2/SKILL.md +4 -4
- package/skills/openxiangda-v2/references/declarations-cheatsheet.md +2 -0
- package/skills/openxiangda-v2/references/getting-started.md +7 -7
- package/releases/2.18.4.json +0 -34
|
@@ -12,6 +12,8 @@
|
|
|
12
12
|
| 每个模型最多 20 个命名视图；命名视图需要稳定 `code` + `name` | `crud: [{ model: 'x', code: 'x-active', name: '进行中', ... }]` |
|
|
13
13
|
| 新建视图的 `form.fields` 必须覆盖全部无默认必填字段，或显式 `generated.create: false` | 检查器会列出缺失字段 |
|
|
14
14
|
| Workflow 详情接管的资源路由用模型级 `detailRouteCode` 表达（desktop/mobile 各引用一条 user surface 路由） | `defineDataModel({ code: 'x', detailRouteCode: { desktop: 'x-detail', mobile: 'x-detail-mobile' }, ... })` |
|
|
15
|
+
| 迁移工具/验收脚本需要看模块投影结果时，用公共出口的 `materializeApplicationModules`，不要引用 devkit 的 dist 文件路径 | `import { defineApplicationModule, materializeApplicationModules } from 'openxiangda/config';` → `const { resources } = materializeApplicationModules([module])` |
|
|
16
|
+
| system 字段（服务端赋值）可以进入查询与分组类选择（filterFields/searchableFields/sortableFields/defaultSort/sections.fields），不可进入展示与可写选择（list/form/detail.fields） | `filterFields: ['campaignId']`（system 外键筛选合法）；hidden 字段任何选择都拒绝 |
|
|
15
17
|
|
|
16
18
|
## 字段声明
|
|
17
19
|
|
|
@@ -66,10 +66,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
|
|
|
66
66
|
以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
|
|
67
67
|
|
|
68
68
|
```bash
|
|
69
|
-
pnpm dlx openxiangda@2.18.
|
|
70
|
-
pnpm dlx openxiangda@2.18.
|
|
71
|
-
pnpm dlx openxiangda@2.18.
|
|
72
|
-
pnpm dlx openxiangda@2.18.
|
|
69
|
+
pnpm dlx openxiangda@2.18.7 skill install --force
|
|
70
|
+
pnpm dlx openxiangda@2.18.7 auth status --base-url <平台地址> --json
|
|
71
|
+
pnpm dlx openxiangda@2.18.7 login --cwd my-app --base-url https://platform.example.com
|
|
72
|
+
pnpm dlx openxiangda@2.18.7 create my-app --base-url https://platform.example.com
|
|
73
73
|
cd my-app
|
|
74
74
|
pnpm openxiangda context --json
|
|
75
75
|
pnpm openxiangda dev
|
|
@@ -171,9 +171,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
|
|
|
171
171
|
无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
|
|
172
172
|
|
|
173
173
|
```bash
|
|
174
|
-
pnpm dlx openxiangda@2.18.
|
|
175
|
-
pnpm dlx openxiangda@2.18.
|
|
176
|
-
pnpm dlx openxiangda@2.18.
|
|
174
|
+
pnpm dlx openxiangda@2.18.7 auth status --base-url <平台> --json
|
|
175
|
+
pnpm dlx openxiangda@2.18.7 source resolve <仓库URL> --base-url <平台> --json
|
|
176
|
+
pnpm dlx openxiangda@2.18.7 source clone <仓库URL> <新目录> --base-url <平台> --json
|
|
177
177
|
```
|
|
178
178
|
|
|
179
179
|
登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": "openxiangda.documentation/v1",
|
|
3
|
-
"version": "2.18.
|
|
3
|
+
"version": "2.18.7",
|
|
4
4
|
"topics": [
|
|
5
5
|
{
|
|
6
6
|
"id": "getting-started",
|
|
7
7
|
"title": "安装与开始开发",
|
|
8
8
|
"file": "getting-started.md",
|
|
9
|
-
"sha256": "
|
|
9
|
+
"sha256": "af7caaa995b99a255d5c7e3256f5db2970266eba7dad2580c691b30ff121380a"
|
|
10
10
|
},
|
|
11
11
|
{
|
|
12
12
|
"id": "product-design",
|
|
@@ -48,7 +48,7 @@
|
|
|
48
48
|
"id": "declarations-cheatsheet",
|
|
49
49
|
"title": "声明速查：一次写对 config",
|
|
50
50
|
"file": "declarations-cheatsheet.md",
|
|
51
|
-
"sha256": "
|
|
51
|
+
"sha256": "5b4327eeead055b9d1f46a4122c6c2ac7052ca86e9ca2d586c8ce1b3df4d2bd2"
|
|
52
52
|
},
|
|
53
53
|
{
|
|
54
54
|
"id": "application-foundation",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "openxiangda",
|
|
3
|
-
"version": "2.18.
|
|
3
|
+
"version": "2.18.7",
|
|
4
4
|
"description": "OpenXiangda 2.0 的统一命令、应用 SDK、MCP 与中文 AI 技能资料。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -60,13 +60,13 @@
|
|
|
60
60
|
"antd-mobile": "5.42.3",
|
|
61
61
|
"dayjs": "1.11.18",
|
|
62
62
|
"docx-preview": "0.3.7",
|
|
63
|
-
"openxiangda-cli": "2.4.
|
|
63
|
+
"openxiangda-cli": "2.4.15",
|
|
64
64
|
"openxiangda-contracts": "2.14.1",
|
|
65
|
-
"openxiangda-devkit-core": "2.
|
|
65
|
+
"openxiangda-devkit-core": "2.16.0",
|
|
66
66
|
"openxiangda-legacy": "npm:openxiangda@1.0.269",
|
|
67
|
-
"openxiangda-mcp": "2.0.
|
|
67
|
+
"openxiangda-mcp": "2.0.25",
|
|
68
68
|
"openxiangda-nest": "2.4.2",
|
|
69
|
-
"openxiangda-skill-kit": "2.1.
|
|
69
|
+
"openxiangda-skill-kit": "2.1.10",
|
|
70
70
|
"xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
|
|
71
71
|
},
|
|
72
72
|
"peerDependencies": {
|
|
@@ -132,37 +132,33 @@
|
|
|
132
132
|
},
|
|
133
133
|
"openxiangdaRelease": {
|
|
134
134
|
"schemaVersion": "openxiangda.release-notes/v1",
|
|
135
|
-
"version": "2.18.
|
|
135
|
+
"version": "2.18.7",
|
|
136
136
|
"status": "reviewed",
|
|
137
|
-
"title": "OpenXiangda 2.18.
|
|
138
|
-
"summary": "
|
|
137
|
+
"title": "OpenXiangda 2.18.7：模块视图查询选择放行 system 字段（GAP-MODULE-003）",
|
|
138
|
+
"summary": "模块视图的筛选/搜索/排序/分组选择可以引用 system 字段，与低层 data.resources 的 system+filter 语义对齐；展示与可写选择维持拒绝。devkit-core 2.16.0 携带实现。",
|
|
139
139
|
"newFeatures": [
|
|
140
|
-
"
|
|
141
|
-
"
|
|
142
|
-
],
|
|
143
|
-
"fixes": [
|
|
144
|
-
"打包验证对 openxiangda docs --json 类命令改为静默捕获：成功时仅输出字节数摘要，整篇文档的超长单行 JSON 不再进入发布日志。",
|
|
145
|
-
"发布进程锁自动探活：持有者进程已死时自动回收残留锁，不再需要人工核对 pid 后手动删除。"
|
|
140
|
+
"crud[].list 的 filterFields/searchableFields/sortableFields/defaultSort 与 sections.fields 允许引用 system: true 字段：外键标识（activityId/routeId/campaignId 等）与归属快照（memberUser 等）不再阻塞模块化迁移。",
|
|
141
|
+
"声明速查新增对应规则条目。"
|
|
146
142
|
],
|
|
143
|
+
"fixes": [],
|
|
147
144
|
"affectedUsers": [
|
|
148
|
-
"从 data.resources
|
|
149
|
-
"所有使用 openxiangda 发布火车的维护者。"
|
|
145
|
+
"从 data.resources 迁移到模块化声明、存在大量 system+filter 字段的应用（如数智工会 szgh-v2 的 40/74 资源）。"
|
|
150
146
|
],
|
|
151
147
|
"upgradeSteps": [
|
|
152
|
-
"应用精确依赖升级到 openxiangda 2.18.
|
|
148
|
+
"应用精确依赖升级到 openxiangda 2.18.7（openxiangda-devkit-core 2.16.0）后重新运行 check 与部署。"
|
|
153
149
|
],
|
|
154
150
|
"knownLimitations": [
|
|
155
|
-
"
|
|
151
|
+
"展示与可写选择（list/form/detail.fields）仍不接受 system 字段——按 GAP 文档期望保留现行限制。"
|
|
156
152
|
],
|
|
157
153
|
"issues": [],
|
|
158
154
|
"compatibility": {
|
|
159
155
|
"node": ">=24",
|
|
160
156
|
"workspaceGenerations": "v2",
|
|
161
|
-
"platform": "
|
|
157
|
+
"platform": "无平台配合要求；共享校验器字节不变。",
|
|
162
158
|
"v1": "不改变 V1 运行时或应用。"
|
|
163
159
|
},
|
|
164
|
-
"sha256": "
|
|
165
|
-
"url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.
|
|
160
|
+
"sha256": "2d0be4180cfbb743f5340d93dbcb133c493b666d58dc00e380968514dd32d682",
|
|
161
|
+
"url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.7"
|
|
166
162
|
},
|
|
167
163
|
"scripts": {
|
|
168
164
|
"build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": "openxiangda.release-notes/v1",
|
|
3
|
+
"version": "2.18.7",
|
|
4
|
+
"status": "reviewed",
|
|
5
|
+
"title": "OpenXiangda 2.18.7：模块视图查询选择放行 system 字段（GAP-MODULE-003）",
|
|
6
|
+
"summary": "模块视图的筛选/搜索/排序/分组选择可以引用 system 字段，与低层 data.resources 的 system+filter 语义对齐；展示与可写选择维持拒绝。devkit-core 2.16.0 携带实现。",
|
|
7
|
+
"newFeatures": [
|
|
8
|
+
"crud[].list 的 filterFields/searchableFields/sortableFields/defaultSort 与 sections.fields 允许引用 system: true 字段：外键标识（activityId/routeId/campaignId 等）与归属快照（memberUser 等）不再阻塞模块化迁移。",
|
|
9
|
+
"声明速查新增对应规则条目。"
|
|
10
|
+
],
|
|
11
|
+
"fixes": [],
|
|
12
|
+
"affectedUsers": [
|
|
13
|
+
"从 data.resources 迁移到模块化声明、存在大量 system+filter 字段的应用（如数智工会 szgh-v2 的 40/74 资源）。"
|
|
14
|
+
],
|
|
15
|
+
"upgradeSteps": [
|
|
16
|
+
"应用精确依赖升级到 openxiangda 2.18.7（openxiangda-devkit-core 2.16.0）后重新运行 check 与部署。"
|
|
17
|
+
],
|
|
18
|
+
"knownLimitations": [
|
|
19
|
+
"展示与可写选择（list/form/detail.fields）仍不接受 system 字段——按 GAP 文档期望保留现行限制。"
|
|
20
|
+
],
|
|
21
|
+
"issues": [],
|
|
22
|
+
"compatibility": {
|
|
23
|
+
"node": ">=24",
|
|
24
|
+
"workspaceGenerations": "v2",
|
|
25
|
+
"platform": "无平台配合要求；共享校验器字节不变。",
|
|
26
|
+
"v1": "不改变 V1 运行时或应用。"
|
|
27
|
+
},
|
|
28
|
+
"sha256": "2d0be4180cfbb743f5340d93dbcb133c493b666d58dc00e380968514dd32d682",
|
|
29
|
+
"url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.7"
|
|
30
|
+
}
|
package/skills/manifest.json
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
{
|
|
5
5
|
"name": "openxiangda-v2",
|
|
6
6
|
"description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，由 AI 在工作区内调用 OpenDesign 原版 CLI/Skill/MCP 形成整体视觉与可运行原型，再开发、检查和交付应用。OpenDesign 客户端只作为可选预览器；维护 1.x 应用时使用对应的 1.x 技能。",
|
|
7
|
-
"sha256": "
|
|
7
|
+
"sha256": "b4ef2fef5feb372553acd720afde521ab800807fe252130417f45d0a6e11fcaa"
|
|
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.18.
|
|
44
|
-
pnpm dlx openxiangda@2.18.
|
|
45
|
-
pnpm dlx openxiangda@2.18.
|
|
46
|
-
pnpm dlx openxiangda@2.18.
|
|
43
|
+
pnpm dlx openxiangda@2.18.7 auth status --cwd <应用目录> --base-url <平台地址> --json
|
|
44
|
+
pnpm dlx openxiangda@2.18.7 login --cwd <应用目录> --base-url <平台地址>
|
|
45
|
+
pnpm dlx openxiangda@2.18.7 create <应用目录> --base-url <同一平台地址>
|
|
46
|
+
pnpm dlx openxiangda@2.18.7 skill install --force
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。
|
|
@@ -12,6 +12,8 @@
|
|
|
12
12
|
| 每个模型最多 20 个命名视图；命名视图需要稳定 `code` + `name` | `crud: [{ model: 'x', code: 'x-active', name: '进行中', ... }]` |
|
|
13
13
|
| 新建视图的 `form.fields` 必须覆盖全部无默认必填字段，或显式 `generated.create: false` | 检查器会列出缺失字段 |
|
|
14
14
|
| Workflow 详情接管的资源路由用模型级 `detailRouteCode` 表达（desktop/mobile 各引用一条 user surface 路由） | `defineDataModel({ code: 'x', detailRouteCode: { desktop: 'x-detail', mobile: 'x-detail-mobile' }, ... })` |
|
|
15
|
+
| 迁移工具/验收脚本需要看模块投影结果时，用公共出口的 `materializeApplicationModules`，不要引用 devkit 的 dist 文件路径 | `import { defineApplicationModule, materializeApplicationModules } from 'openxiangda/config';` → `const { resources } = materializeApplicationModules([module])` |
|
|
16
|
+
| system 字段（服务端赋值）可以进入查询与分组类选择（filterFields/searchableFields/sortableFields/defaultSort/sections.fields），不可进入展示与可写选择（list/form/detail.fields） | `filterFields: ['campaignId']`（system 外键筛选合法）；hidden 字段任何选择都拒绝 |
|
|
15
17
|
|
|
16
18
|
## 字段声明
|
|
17
19
|
|
|
@@ -66,10 +66,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
|
|
|
66
66
|
以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
|
|
67
67
|
|
|
68
68
|
```bash
|
|
69
|
-
pnpm dlx openxiangda@2.18.
|
|
70
|
-
pnpm dlx openxiangda@2.18.
|
|
71
|
-
pnpm dlx openxiangda@2.18.
|
|
72
|
-
pnpm dlx openxiangda@2.18.
|
|
69
|
+
pnpm dlx openxiangda@2.18.7 skill install --force
|
|
70
|
+
pnpm dlx openxiangda@2.18.7 auth status --base-url <平台地址> --json
|
|
71
|
+
pnpm dlx openxiangda@2.18.7 login --cwd my-app --base-url https://platform.example.com
|
|
72
|
+
pnpm dlx openxiangda@2.18.7 create my-app --base-url https://platform.example.com
|
|
73
73
|
cd my-app
|
|
74
74
|
pnpm openxiangda context --json
|
|
75
75
|
pnpm openxiangda dev
|
|
@@ -171,9 +171,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
|
|
|
171
171
|
无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
|
|
172
172
|
|
|
173
173
|
```bash
|
|
174
|
-
pnpm dlx openxiangda@2.18.
|
|
175
|
-
pnpm dlx openxiangda@2.18.
|
|
176
|
-
pnpm dlx openxiangda@2.18.
|
|
174
|
+
pnpm dlx openxiangda@2.18.7 auth status --base-url <平台> --json
|
|
175
|
+
pnpm dlx openxiangda@2.18.7 source resolve <仓库URL> --base-url <平台> --json
|
|
176
|
+
pnpm dlx openxiangda@2.18.7 source clone <仓库URL> <新目录> --base-url <平台> --json
|
|
177
177
|
```
|
|
178
178
|
|
|
179
179
|
登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回
|
package/releases/2.18.4.json
DELETED
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"schemaVersion": "openxiangda.release-notes/v1",
|
|
3
|
-
"version": "2.18.4",
|
|
4
|
-
"status": "reviewed",
|
|
5
|
-
"title": "OpenXiangda 2.18.4：模块投影公共出口与发布火车加固",
|
|
6
|
-
"summary": "materializeApplicationModules 从 openxiangda/config 公共再导出，模块化迁移不再引用 dist 文件路径；发布验证静默捕获文档 JSON、发布锁自动回收残留、新增 release:prepare 一键准备命令。",
|
|
7
|
-
"newFeatures": [
|
|
8
|
-
"openxiangda/config 新增 materializeApplicationModules 再导出：与 defineApplicationModule 等声明 API 同源，模块化迁移（GAP-MODULE 系列验收与迁移工具）直接从公共入口使用。",
|
|
9
|
-
"新增 pnpm release:prepare：在 changeset 与发布说明已推送后，一条命令完成版本物化、提交与推送，并打印发布触发命令。"
|
|
10
|
-
],
|
|
11
|
-
"fixes": [
|
|
12
|
-
"打包验证对 openxiangda docs --json 类命令改为静默捕获：成功时仅输出字节数摘要，整篇文档的超长单行 JSON 不再进入发布日志。",
|
|
13
|
-
"发布进程锁自动探活：持有者进程已死时自动回收残留锁，不再需要人工核对 pid 后手动删除。"
|
|
14
|
-
],
|
|
15
|
-
"affectedUsers": [
|
|
16
|
-
"从 data.resources 迁移到模块化声明的应用开发者（如数智工会 szgh-v2）。",
|
|
17
|
-
"所有使用 openxiangda 发布火车的维护者。"
|
|
18
|
-
],
|
|
19
|
-
"upgradeSteps": [
|
|
20
|
-
"应用精确依赖升级到 openxiangda 2.18.4 后重新运行 check 与部署。"
|
|
21
|
-
],
|
|
22
|
-
"knownLimitations": [
|
|
23
|
-
"npm trusted publishing 仍不覆盖 dist-tag 操作：仓库配置 NPM_DISTTAG_TOKEN 后 stable-v2 全自动，否则该一步由维护者补齐（与本版内容无关，沿 2.18.3 记录）。"
|
|
24
|
-
],
|
|
25
|
-
"issues": [],
|
|
26
|
-
"compatibility": {
|
|
27
|
-
"node": ">=24",
|
|
28
|
-
"workspaceGenerations": "v2",
|
|
29
|
-
"platform": "无平台配合要求。",
|
|
30
|
-
"v1": "不改变 V1 运行时或应用。"
|
|
31
|
-
},
|
|
32
|
-
"sha256": "8ee0abfece53013bf931133053604d882d2c1434d1ab9ae169838fa42f118793",
|
|
33
|
-
"url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.4"
|
|
34
|
-
}
|