openxiangda 2.22.3 → 2.22.4

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 -20
  4. package/releases/2.22.4.json +33 -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.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
71
+ pnpm dlx openxiangda@2.22.4 skill install --force
72
+ pnpm dlx openxiangda@2.22.4 auth status --base-url <平台地址> --json
73
+ pnpm dlx openxiangda@2.22.4 login --cwd my-app --base-url https://platform.example.com
74
+ pnpm dlx openxiangda@2.22.4 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.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
177
+ pnpm dlx openxiangda@2.22.4 auth status --base-url <平台> --json
178
+ pnpm dlx openxiangda@2.22.4 source resolve <仓库URL> --base-url <平台> --json
179
+ pnpm dlx openxiangda@2.22.4 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.3",
3
+ "version": "2.22.4",
4
4
  "topics": [
5
5
  {
6
6
  "id": "getting-started",
7
7
  "title": "安装与开始开发",
8
8
  "file": "getting-started.md",
9
- "sha256": "0735e28295269ab840c89468d5f3da85d41f032489369b73b71a9ebc0615030f"
9
+ "sha256": "33a38c95b314f8d9f1515bfe0ee49ab15abeeaa42d3dc283571a1e0d1dcec3b8"
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.3",
3
+ "version": "2.22.4",
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.7",
63
+ "openxiangda-cli": "2.5.8",
64
64
  "openxiangda-contracts": "2.17.2",
65
- "openxiangda-devkit-core": "2.20.3",
65
+ "openxiangda-devkit-core": "2.21.0",
66
66
  "openxiangda-legacy": "npm:openxiangda@1.0.269",
67
- "openxiangda-mcp": "2.0.37",
67
+ "openxiangda-mcp": "2.0.38",
68
68
  "openxiangda-nest": "2.4.10",
69
- "openxiangda-skill-kit": "2.3.10",
69
+ "openxiangda-skill-kit": "2.3.11",
70
70
  "xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
71
71
  },
72
72
  "peerDependencies": {
@@ -132,35 +132,36 @@
132
132
  },
133
133
  "openxiangdaRelease": {
134
134
  "schemaVersion": "openxiangda.release-notes/v1",
135
- "version": "2.22.3",
135
+ "version": "2.22.4",
136
136
  "status": "reviewed",
137
- "title": "OpenXiangda 2.22.3：草稿状态保持表单专属",
138
- "summary": "修复 Native 编译器对 draftState 的执行校验边界，使默认与具名详情布局和公开 JSON Schema 一致地拒绝草稿工作区状态。",
139
- "newFeatures": [],
137
+ "title": "OpenXiangda 2.22.4：connected dev 代理转发声明式应用操作路径",
138
+ "summary": "连接式开发代理新增按应用声明的 backend.operations 静态路径精确转发裸请求，浏览器端 applicationApiPath() 在无运行挂载元数据时也能直连本地后端，消除本地联调 404。",
139
+ "newFeatures": [
140
+ "openxiangda dev 代理将与应用 backend.operations[] 声明完全一致的裸路径请求转发到本地 Nest 后端（配置驱动、精确匹配，无前缀通配、不注入 authz 挂载元数据）。"
141
+ ],
140
142
  "fixes": [
141
- "默认详情布局和具名视图详情布局不再接受 draftState；该声明继续只允许出现在默认表单和具名表单上。",
142
- "公开 Surface 键清单新增表单与详情的独立白名单，服务端消费者不再需要把同一 layout 白名单错误地复用于两个不同 Surface。"
143
+ "修复本地联调应用操作端点（如 /ai/console/*、/ai/risk-review-session*）404 的问题：此前代理只服务 /service 与 /api，裸 applicationApiPath 请求无法到达本地后端（协同清单 PL-09）。"
143
144
  ],
144
145
  "affectedUsers": [
145
- "使用 OpenXiangda 2.0 认证草稿工作区状态的应用开发者，以及复用 Native Surface 纯校验器或键清单的平台维护人员。"
146
+ "使用 openxiangda dev 连接式开发且应用声明了 backend operations 的应用开发者。"
146
147
  ],
147
148
  "upgradeSteps": [
148
- "将应用对 openxiangda 的精确依赖升级到 2.22.3，按锁文件重新安装依赖，并执行 pnpm openxiangda skill install --force 刷新本地 Skill。",
149
- "平台维护者应同步升级 openxiangda-contracts，并使用独立的 form/detail 键清单校验 Surface；已把 draftState 错误声明在 detail 下的配置需移回 form。"
149
+ "将应用对 openxiangda 的精确依赖升级到 2.22.4 并按锁文件重新安装依赖。",
150
+ "重跑 openxiangda dev 后，浏览器发起的裸应用操作路径（如 /ai/console/sessions）将由本地代理直达本地后端，无需改应用代码或注入挂载元数据。"
150
151
  ],
151
152
  "knownLimitations": [
152
- "本补丁只收紧编译期与服务端 Surface 校验边界，不会自行升级平台服务、执行数据库迁移或修改已部署应用。",
153
- "draftState 仍只保存受声明约束的临时工作区状态，不是业务 Data API 字段、工作流事实或永久文档存储。"
153
+ "仅转发与应用声明完全一致（去尾斜杠归一）的静态操作路径；未声明的裸路径仍返回 404。",
154
+ "未声明本地后端的前端-only 应用，命中操作路径时返回 OPENXIANGDA_CONNECTED_BACKEND_DISABLED，与既有行为一致。"
154
155
  ],
155
156
  "issues": [],
156
157
  "compatibility": {
157
158
  "node": ">=24",
158
159
  "workspaceGenerations": "v2",
159
- "platform": "完整草稿工作区能力仍要求升级到支持认证草稿原子消费和 draftState Schema 的平台服务，并应用对应的 expand-only SQL migration。",
160
- "v1": "V1 工作区与维护引擎不受影响。"
160
+ "platform": "无平台服务依赖；代理行为变更仅影响本地开发链路。",
161
+ "v1": "V1 工作区不受影响。"
161
162
  },
162
- "sha256": "f0b7c256057a3366b4e4e85823f0447382f51c75e15ce11a7e4a04f15a3c8069",
163
- "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.22.3"
163
+ "sha256": "082690f330ed05eb91ca9dc7393eef8867c4d3c8958c701288a8bda4aaf4beef",
164
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.22.4"
164
165
  },
165
166
  "scripts": {
166
167
  "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",
package/releases/2.22.4.json ADDED
@@ -0,0 +1,33 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.22.4",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.22.4：connected dev 代理转发声明式应用操作路径",
6
+ "summary": "连接式开发代理新增按应用声明的 backend.operations 静态路径精确转发裸请求，浏览器端 applicationApiPath() 在无运行挂载元数据时也能直连本地后端，消除本地联调 404。",
7
+ "newFeatures": [
8
+ "openxiangda dev 代理将与应用 backend.operations[] 声明完全一致的裸路径请求转发到本地 Nest 后端（配置驱动、精确匹配，无前缀通配、不注入 authz 挂载元数据）。"
9
+ ],
10
+ "fixes": [
11
+ "修复本地联调应用操作端点（如 /ai/console/*、/ai/risk-review-session*）404 的问题：此前代理只服务 /service 与 /api，裸 applicationApiPath 请求无法到达本地后端（协同清单 PL-09）。"
12
+ ],
13
+ "affectedUsers": [
14
+ "使用 openxiangda dev 连接式开发且应用声明了 backend operations 的应用开发者。"
15
+ ],
16
+ "upgradeSteps": [
17
+ "将应用对 openxiangda 的精确依赖升级到 2.22.4 并按锁文件重新安装依赖。",
18
+ "重跑 openxiangda dev 后，浏览器发起的裸应用操作路径（如 /ai/console/sessions）将由本地代理直达本地后端，无需改应用代码或注入挂载元数据。"
19
+ ],
20
+ "knownLimitations": [
21
+ "仅转发与应用声明完全一致（去尾斜杠归一）的静态操作路径；未声明的裸路径仍返回 404。",
22
+ "未声明本地后端的前端-only 应用，命中操作路径时返回 OPENXIANGDA_CONNECTED_BACKEND_DISABLED，与既有行为一致。"
23
+ ],
24
+ "issues": [],
25
+ "compatibility": {
26
+ "node": ">=24",
27
+ "workspaceGenerations": "v2",
28
+ "platform": "无平台服务依赖；代理行为变更仅影响本地开发链路。",
29
+ "v1": "V1 工作区不受影响。"
30
+ },
31
+ "sha256": "082690f330ed05eb91ca9dc7393eef8867c4d3c8958c701288a8bda4aaf4beef",
32
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.22.4"
33
+ }
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": "9f2876c82aa2d6924ee71bea133a4e09f3129c1f6d2cc792e9826e7b0e89c351"
7
+ "sha256": "88988448286608a222fa3f417a4f8bb4331707b5ef7d7bc2c375b4b28b00dd5f"
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.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
43
+ pnpm dlx openxiangda@2.22.4 auth status --cwd <应用目录> --base-url <平台地址> --json
44
+ pnpm dlx openxiangda@2.22.4 login --cwd <应用目录> --base-url <平台地址>
45
+ pnpm dlx openxiangda@2.22.4 create <应用目录> --base-url <同一平台地址>
46
+ pnpm dlx openxiangda@2.22.4 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.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
71
+ pnpm dlx openxiangda@2.22.4 skill install --force
72
+ pnpm dlx openxiangda@2.22.4 auth status --base-url <平台地址> --json
73
+ pnpm dlx openxiangda@2.22.4 login --cwd my-app --base-url https://platform.example.com
74
+ pnpm dlx openxiangda@2.22.4 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.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
177
+ pnpm dlx openxiangda@2.22.4 auth status --base-url <平台> --json
178
+ pnpm dlx openxiangda@2.22.4 source resolve <仓库URL> --base-url <平台> --json
179
+ pnpm dlx openxiangda@2.22.4 source clone <仓库URL> <新目录> --base-url <平台> --json
180
180
  ```
181
181
 
182
182
  登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回