openxiangda 2.22.3 → 2.22.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 (9) hide show
  1. package/documentation/getting-started.md +7 -7
  2. package/documentation/manifest.json +2 -2
  3. package/package.json +17 -20
  4. package/releases/2.22.4.json +33 -0
  5. package/releases/2.22.5.json +31 -0
  6. package/releases/2.22.6.json +29 -0
  7. package/skills/manifest.json +1 -1
  8. package/skills/openxiangda-v2/SKILL.md +4 -4
  9. 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.6 skill install --force
72
+ pnpm dlx openxiangda@2.22.6 auth status --base-url <平台地址> --json
73
+ pnpm dlx openxiangda@2.22.6 login --cwd my-app --base-url https://platform.example.com
74
+ pnpm dlx openxiangda@2.22.6 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.6 auth status --base-url <平台> --json
178
+ pnpm dlx openxiangda@2.22.6 source resolve <仓库URL> --base-url <平台> --json
179
+ pnpm dlx openxiangda@2.22.6 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.6",
4
4
  "topics": [
5
5
  {
6
6
  "id": "getting-started",
7
7
  "title": "安装与开始开发",
8
8
  "file": "getting-started.md",
9
- "sha256": "0735e28295269ab840c89468d5f3da85d41f032489369b73b71a9ebc0615030f"
9
+ "sha256": "beb5965822e209261c5cccf4ba06e206911b11aa3b3c84e9db009a74c780c744"
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.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.5.7",
63
+ "openxiangda-cli": "2.5.9",
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",
68
- "openxiangda-nest": "2.4.10",
69
- "openxiangda-skill-kit": "2.3.10",
67
+ "openxiangda-mcp": "2.0.38",
68
+ "openxiangda-nest": "2.4.11",
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,32 @@
132
132
  },
133
133
  "openxiangdaRelease": {
134
134
  "schemaVersion": "openxiangda.release-notes/v1",
135
- "version": "2.22.3",
135
+ "version": "2.22.6",
136
136
  "status": "reviewed",
137
- "title": "OpenXiangda 2.22.3：草稿状态保持表单专属",
138
- "summary": "修复 Native 编译器对 draftState 的执行校验边界，使默认与具名详情布局和公开 JSON Schema 一致地拒绝草稿工作区状态。",
137
+ "title": "OpenXiangda 2.22.6：cli 分发模板与 2.22.5 工具链对齐",
138
+ "summary": "openxiangda-cli 分发模板的锁文件随 openxiangda 2.22.5 / openxiangda-nest 2.4.11 重新生成，使新建应用直接落到断言 TTL 双端一致的 SDK 组合。",
139
139
  "newFeatures": [],
140
140
  "fixes": [
141
- "默认详情布局和具名视图详情布局不再接受 draftState；该声明继续只允许出现在默认表单和具名表单上。",
142
- "公开 Surface 键清单新增表单与详情的独立白名单，服务端消费者不再需要把同一 layout 白名单错误地复用于两个不同 Surface。"
141
+ "修复 cli 2.5.8 制品与本地模板内容不一致导致 release-immutability 门禁拒绝的问题：模板锁文件现随同发布单元递增（openxiangda-cli 2.5.9）。"
143
142
  ],
144
143
  "affectedUsers": [
145
- "使用 OpenXiangda 2.0 认证草稿工作区状态的应用开发者，以及复用 Native Surface 纯校验器或键清单的平台维护人员。"
144
+ "通过 openxiangda create / cli 模板新建 2.x 应用的开发者。"
146
145
  ],
147
146
  "upgradeSteps": [
148
- "将应用对 openxiangda 的精确依赖升级到 2.22.3，按锁文件重新安装依赖，并执行 pnpm openxiangda skill install --force 刷新本地 Skill。",
149
- "平台维护者应同步升级 openxiangda-contracts，并使用独立的 form/detail 键清单校验 Surface；已把 draftState 错误声明在 detail 下的配置需移回 form。"
147
+ "无需手动操作；新模板自动携带 openxiangda-nest 2.4.11（应用侧断言 TTL 上限跟随平台配置）。"
150
148
  ],
151
149
  "knownLimitations": [
152
- "本补丁只收紧编译期与服务端 Surface 校验边界，不会自行升级平台服务、执行数据库迁移或修改已部署应用。",
153
- "draftState 仍只保存受声明约束的临时工作区状态，不是业务 Data API 字段、工作流事实或永久文档存储。"
150
+ "模板锁文件对齐为随版次发布的机械变更；存量应用仍按各自锁文件升级，不受本版影响。"
154
151
  ],
155
152
  "issues": [],
156
153
  "compatibility": {
157
154
  "node": ">=24",
158
155
  "workspaceGenerations": "v2",
159
- "platform": "完整草稿工作区能力仍要求升级到支持认证草稿原子消费和 draftState Schema 的平台服务，并应用对应的 expand-only SQL migration。",
160
- "v1": "V1 工作区与维护引擎不受影响。"
156
+ "platform": "无平台服务依赖。",
157
+ "v1": "V1 工作区不受影响。"
161
158
  },
162
- "sha256": "f0b7c256057a3366b4e4e85823f0447382f51c75e15ce11a7e4a04f15a3c8069",
163
- "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.22.3"
159
+ "sha256": "7124b2bf86fd5d3c1043fe6c27d73227403e117f72b3fe18336792d22ce36f9c",
160
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.22.6"
164
161
  },
165
162
  "scripts": {
166
163
  "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/releases/2.22.5.json ADDED
@@ -0,0 +1,31 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.22.5",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.22.5：应用侧网关断言校验跟随平台可配 TTL",
6
+ "summary": "应用后端 SDK 的网关断言验签器把硬编码的 30 秒寿命上限放宽到平台可配置上限（300 秒），平台网关提升断言 TTL 不再导致应用侧全量 401；防伪造上界保持。",
7
+ "newFeatures": [],
8
+ "fixes": [
9
+ "修复平台网关调整断言 TTL（OPENXIANGDA_GATEWAY_ASSERTION_TTL_SECONDS，30..300s）后应用侧一律返回 OPENXIANGDA_GATEWAY_ASSERTION_CONTEXT_INVALID 的问题：此前 openxiangda-nest 的 gateway-transport 验签器硬编码 exp-iat≤30s，与平台配置解耦后双端不一致（协同清单 PL-16）。"
10
+ ],
11
+ "affectedUsers": [
12
+ "使用 openxiangda-nest 标准启动器且平台网关配置了非默认断言 TTL 的应用后端。"
13
+ ],
14
+ "upgradeSteps": [
15
+ "应用升级 openxiangda-nest 到 2.4.11（或经 openxiangda 统一包 2.22.5 组合）并重新部署后端。",
16
+ "平台网关可在应用升级完成后安全地把断言 TTL 配置为 30..300 秒内的任意值；默认 30 秒不变。"
17
+ ],
18
+ "knownLimitations": [
19
+ "自签寿命超过 300 秒的断言仍被应用侧拒绝；该上限为平台配置硬界。",
20
+ "断言真实有效期仍由签名、exp/nbf 与一次性 jti 保证，放宽仅针对签发窗口长度。"
21
+ ],
22
+ "issues": [],
23
+ "compatibility": {
24
+ "node": ">=24",
25
+ "workspaceGenerations": "v2",
26
+ "platform": "需平台网关断言签名密钥跨重启稳定（固定 SEED）；TTL 放宽只在平台同时提升 TTL 时生效。",
27
+ "v1": "V1 工作区不受影响。"
28
+ },
29
+ "sha256": "df1f5f4ba9e8c45bfdea6e93306d8fc89c7b3c831031989181c93d69c0c8d6b1",
30
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.22.5"
31
+ }
package/releases/2.22.6.json ADDED
@@ -0,0 +1,29 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.22.6",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.22.6：cli 分发模板与 2.22.5 工具链对齐",
6
+ "summary": "openxiangda-cli 分发模板的锁文件随 openxiangda 2.22.5 / openxiangda-nest 2.4.11 重新生成，使新建应用直接落到断言 TTL 双端一致的 SDK 组合。",
7
+ "newFeatures": [],
8
+ "fixes": [
9
+ "修复 cli 2.5.8 制品与本地模板内容不一致导致 release-immutability 门禁拒绝的问题：模板锁文件现随同发布单元递增（openxiangda-cli 2.5.9）。"
10
+ ],
11
+ "affectedUsers": [
12
+ "通过 openxiangda create / cli 模板新建 2.x 应用的开发者。"
13
+ ],
14
+ "upgradeSteps": [
15
+ "无需手动操作；新模板自动携带 openxiangda-nest 2.4.11（应用侧断言 TTL 上限跟随平台配置）。"
16
+ ],
17
+ "knownLimitations": [
18
+ "模板锁文件对齐为随版次发布的机械变更；存量应用仍按各自锁文件升级，不受本版影响。"
19
+ ],
20
+ "issues": [],
21
+ "compatibility": {
22
+ "node": ">=24",
23
+ "workspaceGenerations": "v2",
24
+ "platform": "无平台服务依赖。",
25
+ "v1": "V1 工作区不受影响。"
26
+ },
27
+ "sha256": "7124b2bf86fd5d3c1043fe6c27d73227403e117f72b3fe18336792d22ce36f9c",
28
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.22.6"
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": "9f2876c82aa2d6924ee71bea133a4e09f3129c1f6d2cc792e9826e7b0e89c351"
7
+ "sha256": "61107afd856772c81520c2e021fdceb6e17b35eb6596bf550113c682c3f8cbe5"
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.6 auth status --cwd <应用目录> --base-url <平台地址> --json
44
+ pnpm dlx openxiangda@2.22.6 login --cwd <应用目录> --base-url <平台地址>
45
+ pnpm dlx openxiangda@2.22.6 create <应用目录> --base-url <同一平台地址>
46
+ pnpm dlx openxiangda@2.22.6 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.6 skill install --force
72
+ pnpm dlx openxiangda@2.22.6 auth status --base-url <平台地址> --json
73
+ pnpm dlx openxiangda@2.22.6 login --cwd my-app --base-url https://platform.example.com
74
+ pnpm dlx openxiangda@2.22.6 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.6 auth status --base-url <平台> --json
178
+ pnpm dlx openxiangda@2.22.6 source resolve <仓库URL> --base-url <平台> --json
179
+ pnpm dlx openxiangda@2.22.6 source clone <仓库URL> <新目录> --base-url <平台> --json
180
180
  ```
181
181
 
182
182
  登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回