openxiangda 2.22.0 → 2.22.1

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 +20 -23
  4. package/releases/2.22.1.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.0 skill install --force
72
- pnpm dlx openxiangda@2.22.0 auth status --base-url <平台地址> --json
73
- pnpm dlx openxiangda@2.22.0 login --cwd my-app --base-url https://platform.example.com
74
- pnpm dlx openxiangda@2.22.0 create my-app --base-url https://platform.example.com
71
+ pnpm dlx openxiangda@2.22.1 skill install --force
72
+ pnpm dlx openxiangda@2.22.1 auth status --base-url <平台地址> --json
73
+ pnpm dlx openxiangda@2.22.1 login --cwd my-app --base-url https://platform.example.com
74
+ pnpm dlx openxiangda@2.22.1 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.0 auth status --base-url <平台> --json
178
- pnpm dlx openxiangda@2.22.0 source resolve <仓库URL> --base-url <平台> --json
179
- pnpm dlx openxiangda@2.22.0 source clone <仓库URL> <新目录> --base-url <平台> --json
177
+ pnpm dlx openxiangda@2.22.1 auth status --base-url <平台> --json
178
+ pnpm dlx openxiangda@2.22.1 source resolve <仓库URL> --base-url <平台> --json
179
+ pnpm dlx openxiangda@2.22.1 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.0",
3
+ "version": "2.22.1",
4
4
  "topics": [
5
5
  {
6
6
  "id": "getting-started",
7
7
  "title": "安装与开始开发",
8
8
  "file": "getting-started.md",
9
- "sha256": "a7d9fe082afa0d0d04fa0bbac01c6ae739ddb792726daf06127582cbdcced1d8"
9
+ "sha256": "ab8c502c7a351b038015d1aa9cc969bc6937c2c8c21e5fc28f1028f5ac6bf5f3"
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.0",
3
+ "version": "2.22.1",
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.4",
63
+ "openxiangda-cli": "2.5.5",
64
64
  "openxiangda-contracts": "2.17.0",
65
- "openxiangda-devkit-core": "2.20.0",
65
+ "openxiangda-devkit-core": "2.20.1",
66
66
  "openxiangda-legacy": "npm:openxiangda@1.0.269",
67
- "openxiangda-mcp": "2.0.34",
67
+ "openxiangda-mcp": "2.0.35",
68
68
  "openxiangda-nest": "2.4.8",
69
- "openxiangda-skill-kit": "2.3.7",
69
+ "openxiangda-skill-kit": "2.3.8",
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.0",
135
+ "version": "2.22.1",
136
136
  "status": "reviewed",
137
- "title": "OpenXiangda 2.22.0：受控主体读取、操作与外部文件意图",
138
- "summary": "为需要平台统一授权的业务详情页补齐三类通用能力：按父记录授权的限界关系读取、带强制幂等回执的受控后端操作，以及五分钟有效期、最大 100 MiB 的外部文件预览与下载意图；应用只声明稳定合同，身份、授权、审计与资源边界继续由平台统一拥有。",
139
- "newFeatures": [
140
- "应用可声明 subject read surface，由平台先证明当前用户对父记录的读取权，再按 AppVersion 固化的关系字段、排序与行数上限返回只读聚合；浏览器调用方不能自行扩大子记录查询范围。",
141
- "应用可声明 browser operation catalog 与类型化执行回执；controlled 操作必须绑定父 subject、携带幂等键，并按不可变请求与响应 schema 执行，只返回声明过的刷新目标。",
142
- "应用可声明 external-file intent，并通过浏览器 SDK 获取 opaque 的预览或下载 URL；意图默认五分钟过期、单文件最大 100 MiB，平台以限界流式代理隐藏上游定位信息。"
137
+ "title": "OpenXiangda 2.22.1：平台传输失败诊断",
138
+ "summary": "为 Connected Dev、检查和部署控制面请求补充稳定、脱敏的传输失败诊断，使开发者能够区分请求超时与其他网络连接失败，并定位到具体请求阶段，而不泄露平台地址、查询参数或凭据。",
139
+ "newFeatures": [],
140
+ "fixes": [
141
+ "平台请求尚未取得 HTTP 响应时，统一返回 OPENXIANGDA_PLATFORM_REQUEST_TIMEOUT 或 OPENXIANGDA_PLATFORM_TRANSPORT_FAILED，并附带客户端 requestId、HTTP method、脱敏相对路径和限长 cause code。",
142
+ "Connected Dev 顶层诊断会保留稳定错误码、可重试标记和具体失败端点；制品上传仍维持原有专用错误合同，不增加自动重试或 Dev Session 副作用。"
143
143
  ],
144
- "fixes": [],
145
144
  "affectedUsers": [
146
- "需要在 OpenXiangda 2.0 详情页中安全读取关联记录、触发有外部副作用的应用后端操作，或预览与下载外部系统文件的应用开发与平台维护会话。"
145
+ "通过 VPN、堡垒网络或其他私网连接平台，且需要排查 openxiangda dev、check 或 deploy 预检连接失败的 OpenXiangda 2.0 开发者和平台维护人员。"
147
146
  ],
148
147
  "upgradeSteps": [
149
- "将应用对 openxiangda 的精确依赖升级到 2.22.0，按锁文件重新安装依赖，并执行 pnpm openxiangda skill install --force 刷新本地 Skill。",
150
- "同步部署与本版本 openxiangda-contracts 完全一致的平台服务版本，并通过打包 SQL migration runner 应用新增合同；在平台完成 allow/deny、幂等重放、过期与会话变化拒绝、真实文件预览/下载及日志脱敏验收前，不要启用应用入口。",
151
- "在 AppSpec 和应用声明中显式列出 subject read surface、browser operation 与 external-file intent；不要由浏览器传入任意字段、排序、过滤、上游 URL 或长期下载凭据。"
148
+ "将应用对 openxiangda 的精确依赖升级到 2.22.1，按锁文件重新安装依赖，并执行 pnpm openxiangda skill install --force 刷新本地 Skill。",
149
+ "连接目标平台前先确认 VPN 和目标私网路由；若诊断显示请求尚未取得响应，应使用客户端 requestId 和脱敏端点定位本地网络阶段，不要假定平台服务端已收到请求。"
152
150
  ],
153
151
  "knownLimitations": [
154
- "这些能力需要配套平台服务和数据库 migration；仅升级 npm 包不会使远端环境自动具备运行时能力。",
155
- "外部文件 intent 只代理已声明的应用后端文件源，不提供通用 URL 抓取、对象存储直签或超过 100 MiB 的传输通道。",
156
- "受控操作的幂等回执防止同一意图被重复执行，但应用后端仍必须为每个外部副作用实现稳定的终态查询与供应商级幂等边界。"
152
+ "传输失败时的 requestId 由客户端生成，仅用于本地关联；请求未到达 nginx 或平台服务时不会产生对应服务端日志。",
153
+ "本版本只改善诊断，不会自动恢复 VPN、代理、DNS 或路由，也不会自动重建 Dev Session。"
157
154
  ],
158
155
  "issues": [],
159
156
  "compatibility": {
160
157
  "node": ">=24",
161
158
  "workspaceGenerations": "v2",
162
- "platform": "必须同步升级到声明相同 openxiangda-contracts 版本的平台服务，并通过打包 SQL migration runner 应用本版本 migration。",
159
+ "platform": "不要求平台服务或数据库升级；现有 OpenXiangda 2.0 平台 API 合同保持不变。",
163
160
  "v1": "V1 工作区与维护引擎不受影响。"
164
161
  },
165
- "sha256": "7ab72141832c8a5b5c3351f4770009a71ef17a47075718bb8abe688d87267640",
166
- "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.22.0"
162
+ "sha256": "8ef92b92e9b992bc29703c2063f26b472a873fbf4599cd52f22e7809a8b7c840",
163
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.22.1"
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.1.json ADDED
@@ -0,0 +1,32 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.22.1",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.22.1：平台传输失败诊断",
6
+ "summary": "为 Connected Dev、检查和部署控制面请求补充稳定、脱敏的传输失败诊断，使开发者能够区分请求超时与其他网络连接失败，并定位到具体请求阶段，而不泄露平台地址、查询参数或凭据。",
7
+ "newFeatures": [],
8
+ "fixes": [
9
+ "平台请求尚未取得 HTTP 响应时，统一返回 OPENXIANGDA_PLATFORM_REQUEST_TIMEOUT 或 OPENXIANGDA_PLATFORM_TRANSPORT_FAILED，并附带客户端 requestId、HTTP method、脱敏相对路径和限长 cause code。",
10
+ "Connected Dev 顶层诊断会保留稳定错误码、可重试标记和具体失败端点；制品上传仍维持原有专用错误合同，不增加自动重试或 Dev Session 副作用。"
11
+ ],
12
+ "affectedUsers": [
13
+ "通过 VPN、堡垒网络或其他私网连接平台，且需要排查 openxiangda dev、check 或 deploy 预检连接失败的 OpenXiangda 2.0 开发者和平台维护人员。"
14
+ ],
15
+ "upgradeSteps": [
16
+ "将应用对 openxiangda 的精确依赖升级到 2.22.1，按锁文件重新安装依赖，并执行 pnpm openxiangda skill install --force 刷新本地 Skill。",
17
+ "连接目标平台前先确认 VPN 和目标私网路由；若诊断显示请求尚未取得响应，应使用客户端 requestId 和脱敏端点定位本地网络阶段，不要假定平台服务端已收到请求。"
18
+ ],
19
+ "knownLimitations": [
20
+ "传输失败时的 requestId 由客户端生成，仅用于本地关联；请求未到达 nginx 或平台服务时不会产生对应服务端日志。",
21
+ "本版本只改善诊断，不会自动恢复 VPN、代理、DNS 或路由，也不会自动重建 Dev Session。"
22
+ ],
23
+ "issues": [],
24
+ "compatibility": {
25
+ "node": ">=24",
26
+ "workspaceGenerations": "v2",
27
+ "platform": "不要求平台服务或数据库升级；现有 OpenXiangda 2.0 平台 API 合同保持不变。",
28
+ "v1": "V1 工作区与维护引擎不受影响。"
29
+ },
30
+ "sha256": "8ef92b92e9b992bc29703c2063f26b472a873fbf4599cd52f22e7809a8b7c840",
31
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.22.1"
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": "aaa611a8195b398b44cafed64cd365fb40d00c467a575da32522c95f31ab2e28"
7
+ "sha256": "06dcc30efa64990050bfc2a89c21cd7f95885443afb877ac869374d8429510a0"
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.0 auth status --cwd <应用目录> --base-url <平台地址> --json
44
- pnpm dlx openxiangda@2.22.0 login --cwd <应用目录> --base-url <平台地址>
45
- pnpm dlx openxiangda@2.22.0 create <应用目录> --base-url <同一平台地址>
46
- pnpm dlx openxiangda@2.22.0 skill install --force
43
+ pnpm dlx openxiangda@2.22.1 auth status --cwd <应用目录> --base-url <平台地址> --json
44
+ pnpm dlx openxiangda@2.22.1 login --cwd <应用目录> --base-url <平台地址>
45
+ pnpm dlx openxiangda@2.22.1 create <应用目录> --base-url <同一平台地址>
46
+ pnpm dlx openxiangda@2.22.1 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.0 skill install --force
72
- pnpm dlx openxiangda@2.22.0 auth status --base-url <平台地址> --json
73
- pnpm dlx openxiangda@2.22.0 login --cwd my-app --base-url https://platform.example.com
74
- pnpm dlx openxiangda@2.22.0 create my-app --base-url https://platform.example.com
71
+ pnpm dlx openxiangda@2.22.1 skill install --force
72
+ pnpm dlx openxiangda@2.22.1 auth status --base-url <平台地址> --json
73
+ pnpm dlx openxiangda@2.22.1 login --cwd my-app --base-url https://platform.example.com
74
+ pnpm dlx openxiangda@2.22.1 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.0 auth status --base-url <平台> --json
178
- pnpm dlx openxiangda@2.22.0 source resolve <仓库URL> --base-url <平台> --json
179
- pnpm dlx openxiangda@2.22.0 source clone <仓库URL> <新目录> --base-url <平台> --json
177
+ pnpm dlx openxiangda@2.22.1 auth status --base-url <平台> --json
178
+ pnpm dlx openxiangda@2.22.1 source resolve <仓库URL> --base-url <平台> --json
179
+ pnpm dlx openxiangda@2.22.1 source clone <仓库URL> <新目录> --base-url <平台> --json
180
180
  ```
181
181
 
182
182
  登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回