openxiangda 2.18.4 → 2.18.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 (10) hide show
  1. package/documentation/declarations-cheatsheet.md +1 -0
  2. package/documentation/getting-started.md +7 -7
  3. package/documentation/manifest.json +3 -3
  4. package/package.json +14 -18
  5. package/releases/2.18.6.json +30 -0
  6. package/skills/manifest.json +1 -1
  7. package/skills/openxiangda-v2/SKILL.md +4 -4
  8. package/skills/openxiangda-v2/references/declarations-cheatsheet.md +1 -0
  9. package/skills/openxiangda-v2/references/getting-started.md +7 -7
  10. package/releases/2.18.4.json +0 -34
package/documentation/declarations-cheatsheet.md CHANGED
@@ -12,6 +12,7 @@
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])` |
15
16
 
16
17
  ## 字段声明
17
18
 
package/documentation/getting-started.md CHANGED
@@ -66,10 +66,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
66
66
  以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
67
67
 
68
68
  ```bash
69
- pnpm dlx openxiangda@2.18.4 skill install --force
70
- pnpm dlx openxiangda@2.18.4 auth status --base-url <平台地址> --json
71
- pnpm dlx openxiangda@2.18.4 login --cwd my-app --base-url https://platform.example.com
72
- pnpm dlx openxiangda@2.18.4 create my-app --base-url https://platform.example.com
69
+ pnpm dlx openxiangda@2.18.6 skill install --force
70
+ pnpm dlx openxiangda@2.18.6 auth status --base-url <平台地址> --json
71
+ pnpm dlx openxiangda@2.18.6 login --cwd my-app --base-url https://platform.example.com
72
+ pnpm dlx openxiangda@2.18.6 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.4 auth status --base-url <平台> --json
175
- pnpm dlx openxiangda@2.18.4 source resolve <仓库URL> --base-url <平台> --json
176
- pnpm dlx openxiangda@2.18.4 source clone <仓库URL> <新目录> --base-url <平台> --json
174
+ pnpm dlx openxiangda@2.18.6 auth status --base-url <平台> --json
175
+ pnpm dlx openxiangda@2.18.6 source resolve <仓库URL> --base-url <平台> --json
176
+ pnpm dlx openxiangda@2.18.6 source clone <仓库URL> <新目录> --base-url <平台> --json
177
177
  ```
178
178
 
179
179
  登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回
package/documentation/manifest.json CHANGED
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "schemaVersion": "openxiangda.documentation/v1",
3
- "version": "2.18.4",
3
+ "version": "2.18.6",
4
4
  "topics": [
5
5
  {
6
6
  "id": "getting-started",
7
7
  "title": "安装与开始开发",
8
8
  "file": "getting-started.md",
9
- "sha256": "35fc11c147c5cef3343cfadf9af97eb42b6b76130694732c12da9fa73d0b08b3"
9
+ "sha256": "a9cdd446facd18069f4fb10629b758ed851124f39b8ea88e5384694c2956ca4f"
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": "82ba34ccb40e1e8f9163f22bb92c3ea2925a28020682f266921b22a88d9faaff"
51
+ "sha256": "4b3836de8b4731b0b347121a904670d59f73d3c68e1fe65424358cc249448957"
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.4",
3
+ "version": "2.18.6",
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.12",
63
+ "openxiangda-cli": "2.4.14",
64
64
  "openxiangda-contracts": "2.14.1",
65
65
  "openxiangda-devkit-core": "2.15.0",
66
66
  "openxiangda-legacy": "npm:openxiangda@1.0.269",
67
67
  "openxiangda-mcp": "2.0.24",
68
68
  "openxiangda-nest": "2.4.2",
69
- "openxiangda-skill-kit": "2.1.8",
69
+ "openxiangda-skill-kit": "2.1.9",
70
70
  "xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
71
71
  },
72
72
  "peerDependencies": {
@@ -132,27 +132,23 @@
132
132
  },
133
133
  "openxiangdaRelease": {
134
134
  "schemaVersion": "openxiangda.release-notes/v1",
135
- "version": "2.18.4",
135
+ "version": "2.18.6",
136
136
  "status": "reviewed",
137
- "title": "OpenXiangda 2.18.4：模块投影公共出口与发布火车加固",
138
- "summary": "materializeApplicationModules 从 openxiangda/config 公共再导出，模块化迁移不再引用 dist 文件路径；发布验证静默捕获文档 JSON、发布锁自动回收残留、新增 release:prepare 一键准备命令。",
139
- "newFeatures": [
140
- "openxiangda/config 新增 materializeApplicationModules 再导出：与 defineApplicationModule 等声明 API 同源，模块化迁移（GAP-MODULE 系列验收与迁移工具）直接从公共入口使用。",
141
- "新增 pnpm release:prepare：在 changeset 与发布说明已推送后，一条命令完成版本物化、提交与推送，并打印发布触发命令。"
142
- ],
137
+ "title": "OpenXiangda 2.18.6：声明速查补充模块投影出口用法",
138
+ "summary": "随包声明速查文档新增 materializeApplicationModules 条目：迁移工具与验收脚本从 openxiangda/config 公共出口做模块投影，不再引用 devkit dist 文件路径；文档内容随 skill-kit 分发，一并推进版本。",
139
+ "newFeatures": [],
143
140
  "fixes": [
144
- "打包验证对 openxiangda docs --json 类命令改为静默捕获：成功时仅输出字节数摘要，整篇文档的超长单行 JSON 不再进入发布日志。",
145
- "发布进程锁自动探活：持有者进程已死时自动回收残留锁，不再需要人工核对 pid 后手动删除。"
141
+ "声明速查（declarations-cheatsheet）模块与 CRUD 视图表新增一行：迁移/验收需要模块投影结果时使用 materializeApplicationModules 公共出口，附正确导入与调用片段。",
142
+ "openxiangda-skill-kit 2.1.9：声明速查内容随包同步。"
146
143
  ],
147
144
  "affectedUsers": [
148
- "从 data.resources 迁移到模块化声明的应用开发者（如数智工会 szgh-v2）。",
149
- "所有使用 openxiangda 发布火车的维护者。"
145
+ "从 data.resources 迁移到模块化声明的应用开发者（如数智工会 szgh-v2）与编写迁移验收脚本的维护者。"
150
146
  ],
151
147
  "upgradeSteps": [
152
- "应用精确依赖升级到 openxiangda 2.18.4 后重新运行 check 与部署。"
148
+ "应用精确依赖升级到 openxiangda 2.18.5 后重新运行 check 与部署。"
153
149
  ],
154
150
  "knownLimitations": [
155
- "npm trusted publishing 仍不覆盖 dist-tag 操作：仓库配置 NPM_DISTTAG_TOKEN 后 stable-v2 全自动，否则该一步由维护者补齐（与本版内容无关，沿 2.18.3 记录）。"
151
+ "无（本版仅随包文档变更）。"
156
152
  ],
157
153
  "issues": [],
158
154
  "compatibility": {
@@ -161,8 +157,8 @@
161
157
  "platform": "无平台配合要求。",
162
158
  "v1": "不改变 V1 运行时或应用。"
163
159
  },
164
- "sha256": "8ee0abfece53013bf931133053604d882d2c1434d1ab9ae169838fa42f118793",
165
- "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.4"
160
+ "sha256": "2ce270e25c679fd9cbcfc90c04ca56db386119792ffee651ac39b001ea68a39a",
161
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.6"
166
162
  },
167
163
  "scripts": {
168
164
  "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",
package/releases/2.18.6.json ADDED
@@ -0,0 +1,30 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.18.6",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.18.6：声明速查补充模块投影出口用法",
6
+ "summary": "随包声明速查文档新增 materializeApplicationModules 条目：迁移工具与验收脚本从 openxiangda/config 公共出口做模块投影，不再引用 devkit dist 文件路径；文档内容随 skill-kit 分发，一并推进版本。",
7
+ "newFeatures": [],
8
+ "fixes": [
9
+ "声明速查（declarations-cheatsheet）模块与 CRUD 视图表新增一行：迁移/验收需要模块投影结果时使用 materializeApplicationModules 公共出口，附正确导入与调用片段。",
10
+ "openxiangda-skill-kit 2.1.9：声明速查内容随包同步。"
11
+ ],
12
+ "affectedUsers": [
13
+ "从 data.resources 迁移到模块化声明的应用开发者（如数智工会 szgh-v2）与编写迁移验收脚本的维护者。"
14
+ ],
15
+ "upgradeSteps": [
16
+ "应用精确依赖升级到 openxiangda 2.18.5 后重新运行 check 与部署。"
17
+ ],
18
+ "knownLimitations": [
19
+ "无（本版仅随包文档变更）。"
20
+ ],
21
+ "issues": [],
22
+ "compatibility": {
23
+ "node": ">=24",
24
+ "workspaceGenerations": "v2",
25
+ "platform": "无平台配合要求。",
26
+ "v1": "不改变 V1 运行时或应用。"
27
+ },
28
+ "sha256": "2ce270e25c679fd9cbcfc90c04ca56db386119792ffee651ac39b001ea68a39a",
29
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.6"
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": "c3e112c6193ce7beab6d1474a0513416b79547ee6e14c17f6bab8e2b8314dbb0"
7
+ "sha256": "507cd574c09c8a4f61282923fcc3311a4abd766e8e8967a114c9ef8355efef3f"
8
8
  }
9
9
  ]
10
10
  }
package/skills/openxiangda-v2/SKILL.md CHANGED
@@ -40,10 +40,10 @@ AI 接到新应用、页面或改版任务时，在同一个 OpenXiangda 工作
40
40
  未创建工作区时使用本 Skill 随根包发布的精确版本：
41
41
 
42
42
  ```bash
43
- pnpm dlx openxiangda@2.18.4 auth status --cwd <应用目录> --base-url <平台地址> --json
44
- pnpm dlx openxiangda@2.18.4 login --cwd <应用目录> --base-url <平台地址>
45
- pnpm dlx openxiangda@2.18.4 create <应用目录> --base-url <同一平台地址>
46
- pnpm dlx openxiangda@2.18.4 skill install --force
43
+ pnpm dlx openxiangda@2.18.6 auth status --cwd <应用目录> --base-url <平台地址> --json
44
+ pnpm dlx openxiangda@2.18.6 login --cwd <应用目录> --base-url <平台地址>
45
+ pnpm dlx openxiangda@2.18.6 create <应用目录> --base-url <同一平台地址>
46
+ pnpm dlx openxiangda@2.18.6 skill install --force
47
47
  ```
48
48
 
49
49
  创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。
package/skills/openxiangda-v2/references/declarations-cheatsheet.md CHANGED
@@ -12,6 +12,7 @@
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])` |
15
16
 
16
17
  ## 字段声明
17
18
 
package/skills/openxiangda-v2/references/getting-started.md CHANGED
@@ -66,10 +66,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
66
66
  以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
67
67
 
68
68
  ```bash
69
- pnpm dlx openxiangda@2.18.4 skill install --force
70
- pnpm dlx openxiangda@2.18.4 auth status --base-url <平台地址> --json
71
- pnpm dlx openxiangda@2.18.4 login --cwd my-app --base-url https://platform.example.com
72
- pnpm dlx openxiangda@2.18.4 create my-app --base-url https://platform.example.com
69
+ pnpm dlx openxiangda@2.18.6 skill install --force
70
+ pnpm dlx openxiangda@2.18.6 auth status --base-url <平台地址> --json
71
+ pnpm dlx openxiangda@2.18.6 login --cwd my-app --base-url https://platform.example.com
72
+ pnpm dlx openxiangda@2.18.6 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.4 auth status --base-url <平台> --json
175
- pnpm dlx openxiangda@2.18.4 source resolve <仓库URL> --base-url <平台> --json
176
- pnpm dlx openxiangda@2.18.4 source clone <仓库URL> <新目录> --base-url <平台> --json
174
+ pnpm dlx openxiangda@2.18.6 auth status --base-url <平台> --json
175
+ pnpm dlx openxiangda@2.18.6 source resolve <仓库URL> --base-url <平台> --json
176
+ pnpm dlx openxiangda@2.18.6 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
- }