openxiangda 2.22.2 → 2.22.3

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 (7) hide show
  1. package/documentation/getting-started.md +7 -7
  2. package/documentation/manifest.json +2 -2
  3. package/package.json +21 -24
  4. package/releases/2.22.3.json +32 -0
  5. package/skills/manifest.json +1 -1
  6. package/skills/openxiangda-v2/SKILL.md +4 -4
  7. package/skills/openxiangda-v2/references/getting-started.md +7 -7
package/documentation/getting-started.md CHANGED
@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
68
68
  以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
69
69
 
70
70
  ```bash
71
- pnpm dlx openxiangda@2.22.2 skill install --force
72
- pnpm dlx openxiangda@2.22.2 auth status --base-url <平台地址> --json
73
- pnpm dlx openxiangda@2.22.2 login --cwd my-app --base-url https://platform.example.com
74
- pnpm dlx openxiangda@2.22.2 create my-app --base-url https://platform.example.com
71
+ pnpm dlx openxiangda@2.22.3 skill install --force
72
+ pnpm dlx openxiangda@2.22.3 auth status --base-url <平台地址> --json
73
+ pnpm dlx openxiangda@2.22.3 login --cwd my-app --base-url https://platform.example.com
74
+ pnpm dlx openxiangda@2.22.3 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.22.2 auth status --base-url <平台> --json
178
- pnpm dlx openxiangda@2.22.2 source resolve <仓库URL> --base-url <平台> --json
179
- pnpm dlx openxiangda@2.22.2 source clone <仓库URL> <新目录> --base-url <平台> --json
177
+ pnpm dlx openxiangda@2.22.3 auth status --base-url <平台> --json
178
+ pnpm dlx openxiangda@2.22.3 source resolve <仓库URL> --base-url <平台> --json
179
+ pnpm dlx openxiangda@2.22.3 source clone <仓库URL> <新目录> --base-url <平台> --json
180
180
  ```
181
181
 
182
182
  登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回
package/documentation/manifest.json CHANGED
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "schemaVersion": "openxiangda.documentation/v1",
3
- "version": "2.22.2",
3
+ "version": "2.22.3",
4
4
  "topics": [
5
5
  {
6
6
  "id": "getting-started",
7
7
  "title": "安装与开始开发",
8
8
  "file": "getting-started.md",
9
- "sha256": "1f1fd76fc9afb0f1c508edc3f11ff51a925795d9dbafa09bc7f49b0487115142"
9
+ "sha256": "0735e28295269ab840c89468d5f3da85d41f032489369b73b71a9ebc0615030f"
10
10
  },
11
11
  {
12
12
  "id": "product-design",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openxiangda",
3
- "version": "2.22.2",
3
+ "version": "2.22.3",
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.5.6",
64
- "openxiangda-contracts": "2.17.1",
65
- "openxiangda-devkit-core": "2.20.2",
63
+ "openxiangda-cli": "2.5.7",
64
+ "openxiangda-contracts": "2.17.2",
65
+ "openxiangda-devkit-core": "2.20.3",
66
66
  "openxiangda-legacy": "npm:openxiangda@1.0.269",
67
- "openxiangda-mcp": "2.0.36",
68
- "openxiangda-nest": "2.4.9",
69
- "openxiangda-skill-kit": "2.3.9",
67
+ "openxiangda-mcp": "2.0.37",
68
+ "openxiangda-nest": "2.4.10",
69
+ "openxiangda-skill-kit": "2.3.10",
70
70
  "xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
71
71
  },
72
72
  "peerDependencies": {
@@ -132,38 +132,35 @@
132
132
  },
133
133
  "openxiangdaRelease": {
134
134
  "schemaVersion": "openxiangda.release-notes/v1",
135
- "version": "2.22.2",
135
+ "version": "2.22.3",
136
136
  "status": "reviewed",
137
- "title": "OpenXiangda 2.22.2：认证表单草稿原子提交与工作区状态",
138
- "summary": "为认证表单草稿补充具名业务流程原子消费，以及独立、版本化的草稿工作区状态合同，使正文编辑模式、范本选择和变量快照等临时状态可以在不放宽业务字段的前提下安全暂存。",
139
- "newFeatures": [
140
- "具名业务流程提交可以绑定一份认证表单草稿及其精确 revision，在同一平台事务内完成业务写入、流程命令和草稿消费；原幂等键可恢复既有结果，不重复创建业务记录或启动流程。",
141
- "默认表单和具名视图可分别声明有界 draftState Schema；浏览器 SDK 将 state 与业务 values 分离保存，并回读 Schema 版本、canonical digest 和已保存状态。"
142
- ],
137
+ "title": "OpenXiangda 2.22.3：草稿状态保持表单专属",
138
+ "summary": "修复 Native 编译器对 draftState 的执行校验边界，使默认与具名详情布局和公开 JSON Schema 一致地拒绝草稿工作区状态。",
139
+ "newFeatures": [],
143
140
  "fixes": [
144
- "草稿状态在声明撤销、范围收窄或版本和 digest 不一致时稳定失败，不会静默丢字段、误解释旧状态或把草稿字段加入 Data API 业务模型。",
145
- "公开合同、编译器、浏览器 SDK 和 Nest 业务流程客户端使用同一版本化合同，并继续保持 Node-only 校验代码不进入浏览器产物。"
141
+ "默认详情布局和具名视图详情布局不再接受 draftState；该声明继续只允许出现在默认表单和具名表单上。",
142
+ "公开 Surface 键清单新增表单与详情的独立白名单，服务端消费者不再需要把同一 layout 白名单错误地复用于两个不同 Surface。"
146
143
  ],
147
144
  "affectedUsers": [
148
- "使用 OpenXiangda 2.0 自定义表单、具名视图、认证草稿或具名业务流程提交的应用开发者，以及负责升级对应平台服务的维护人员。"
145
+ "使用 OpenXiangda 2.0 认证草稿工作区状态的应用开发者，以及复用 Native Surface 纯校验器或键清单的平台维护人员。"
149
146
  ],
150
147
  "upgradeSteps": [
151
- "将应用对 openxiangda 的精确依赖升级到 2.22.2，按锁文件重新安装依赖，并执行 pnpm openxiangda skill install --force 刷新本地 Skill。",
152
- "平台维护者需先升级到包含认证草稿原子消费和 draftState 支持的服务端版本，并按正式迁移流程应用新增的草稿状态列；应用应在目标环境回读有效 Schema 后再启用完整工作区草稿。"
148
+ "将应用对 openxiangda 的精确依赖升级到 2.22.3，按锁文件重新安装依赖，并执行 pnpm openxiangda skill install --force 刷新本地 Skill。",
149
+ "平台维护者应同步升级 openxiangda-contracts，并使用独立的 form/detail 键清单校验 Surface；已把 draftState 错误声明在 detail 下的配置需移回 form。"
153
150
  ],
154
151
  "knownLimitations": [
155
- "draftState 只保存受声明约束的临时工作区状态，不是业务 Data API 字段、工作流事实或永久文档存储；单份 state 上限为 192 KiB，values 与 state 合计上限为 256 KiB。",
156
- "仅升级 npm 包不会升级平台服务或执行数据库迁移；在平台尚未升级时，应用必须保留本地输入并显示失败，不得回退到 localStorage 冒充服务端草稿。"
152
+ "本补丁只收紧编译期与服务端 Surface 校验边界，不会自行升级平台服务、执行数据库迁移或修改已部署应用。",
153
+ "draftState 仍只保存受声明约束的临时工作区状态，不是业务 Data API 字段、工作流事实或永久文档存储。"
157
154
  ],
158
155
  "issues": [],
159
156
  "compatibility": {
160
157
  "node": ">=24",
161
158
  "workspaceGenerations": "v2",
162
- "platform": "完整能力要求升级到支持认证草稿原子消费和 draftState Schema 的平台服务，并应用对应的 expand-only SQL migration；旧平台不会自动获得该能力。",
159
+ "platform": "完整草稿工作区能力仍要求升级到支持认证草稿原子消费和 draftState Schema 的平台服务，并应用对应的 expand-only SQL migration。",
163
160
  "v1": "V1 工作区与维护引擎不受影响。"
164
161
  },
165
- "sha256": "5859a8c6ef4f6342f270d4d595df1ea7ef77e8421f4042646e4308eba41c2fbe",
166
- "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.22.2"
162
+ "sha256": "f0b7c256057a3366b4e4e85823f0447382f51c75e15ce11a7e4a04f15a3c8069",
163
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.22.3"
167
164
  },
168
165
  "scripts": {
169
166
  "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",
package/releases/2.22.3.json ADDED
@@ -0,0 +1,32 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.22.3",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.22.3：草稿状态保持表单专属",
6
+ "summary": "修复 Native 编译器对 draftState 的执行校验边界，使默认与具名详情布局和公开 JSON Schema 一致地拒绝草稿工作区状态。",
7
+ "newFeatures": [],
8
+ "fixes": [
9
+ "默认详情布局和具名视图详情布局不再接受 draftState；该声明继续只允许出现在默认表单和具名表单上。",
10
+ "公开 Surface 键清单新增表单与详情的独立白名单，服务端消费者不再需要把同一 layout 白名单错误地复用于两个不同 Surface。"
11
+ ],
12
+ "affectedUsers": [
13
+ "使用 OpenXiangda 2.0 认证草稿工作区状态的应用开发者，以及复用 Native Surface 纯校验器或键清单的平台维护人员。"
14
+ ],
15
+ "upgradeSteps": [
16
+ "将应用对 openxiangda 的精确依赖升级到 2.22.3，按锁文件重新安装依赖，并执行 pnpm openxiangda skill install --force 刷新本地 Skill。",
17
+ "平台维护者应同步升级 openxiangda-contracts，并使用独立的 form/detail 键清单校验 Surface；已把 draftState 错误声明在 detail 下的配置需移回 form。"
18
+ ],
19
+ "knownLimitations": [
20
+ "本补丁只收紧编译期与服务端 Surface 校验边界，不会自行升级平台服务、执行数据库迁移或修改已部署应用。",
21
+ "draftState 仍只保存受声明约束的临时工作区状态，不是业务 Data API 字段、工作流事实或永久文档存储。"
22
+ ],
23
+ "issues": [],
24
+ "compatibility": {
25
+ "node": ">=24",
26
+ "workspaceGenerations": "v2",
27
+ "platform": "完整草稿工作区能力仍要求升级到支持认证草稿原子消费和 draftState Schema 的平台服务，并应用对应的 expand-only SQL migration。",
28
+ "v1": "V1 工作区与维护引擎不受影响。"
29
+ },
30
+ "sha256": "f0b7c256057a3366b4e4e85823f0447382f51c75e15ce11a7e4a04f15a3c8069",
31
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.22.3"
32
+ }
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": "fc12d949fa2630a5de5525cd50d40b2496fbcb734582bc63c9a0ca7673b81e30"
7
+ "sha256": "9f2876c82aa2d6924ee71bea133a4e09f3129c1f6d2cc792e9826e7b0e89c351"
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.22.2 auth status --cwd <应用目录> --base-url <平台地址> --json
44
- pnpm dlx openxiangda@2.22.2 login --cwd <应用目录> --base-url <平台地址>
45
- pnpm dlx openxiangda@2.22.2 create <应用目录> --base-url <同一平台地址>
46
- pnpm dlx openxiangda@2.22.2 skill install --force
43
+ pnpm dlx openxiangda@2.22.3 auth status --cwd <应用目录> --base-url <平台地址> --json
44
+ pnpm dlx openxiangda@2.22.3 login --cwd <应用目录> --base-url <平台地址>
45
+ pnpm dlx openxiangda@2.22.3 create <应用目录> --base-url <同一平台地址>
46
+ pnpm dlx openxiangda@2.22.3 skill install --force
47
47
  ```
48
48
 
49
49
  创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。
package/skills/openxiangda-v2/references/getting-started.md CHANGED
@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
68
68
  以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
69
69
 
70
70
  ```bash
71
- pnpm dlx openxiangda@2.22.2 skill install --force
72
- pnpm dlx openxiangda@2.22.2 auth status --base-url <平台地址> --json
73
- pnpm dlx openxiangda@2.22.2 login --cwd my-app --base-url https://platform.example.com
74
- pnpm dlx openxiangda@2.22.2 create my-app --base-url https://platform.example.com
71
+ pnpm dlx openxiangda@2.22.3 skill install --force
72
+ pnpm dlx openxiangda@2.22.3 auth status --base-url <平台地址> --json
73
+ pnpm dlx openxiangda@2.22.3 login --cwd my-app --base-url https://platform.example.com
74
+ pnpm dlx openxiangda@2.22.3 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.22.2 auth status --base-url <平台> --json
178
- pnpm dlx openxiangda@2.22.2 source resolve <仓库URL> --base-url <平台> --json
179
- pnpm dlx openxiangda@2.22.2 source clone <仓库URL> <新目录> --base-url <平台> --json
177
+ pnpm dlx openxiangda@2.22.3 auth status --base-url <平台> --json
178
+ pnpm dlx openxiangda@2.22.3 source resolve <仓库URL> --base-url <平台> --json
179
+ pnpm dlx openxiangda@2.22.3 source clone <仓库URL> <新目录> --base-url <平台> --json
180
180
  ```
181
181
 
182
182
  登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回