openxiangda 2.28.1 → 2.29.0

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/decimal-reservations.md +46 -2
  2. package/documentation/getting-started.md +7 -7
  3. package/documentation/manifest.json +3 -3
  4. package/package.json +27 -24
  5. package/releases/2.29.0.json +37 -0
  6. package/skills/manifest.json +1 -1
  7. package/skills/openxiangda-v2/SKILL.md +4 -4
  8. package/skills/openxiangda-v2/references/decimal-reservations.md +46 -2
  9. package/skills/openxiangda-v2/references/getting-started.md +7 -7
package/documentation/decimal-reservations.md CHANGED
@@ -105,7 +105,51 @@ workflow command/instance/subject revision 和台账验证，SDK自动继承已
105
105
  普通应用凭据或自填事件头不构成授权。精确同键、同payload重放返回原完整事务结果；
106
106
  旧轮次不能释放重提后的新占用。重放仍受当前权限、有效事件租约和父记录可读性约束。
107
107
 
108
- 首批只覆盖主子额度和三个真实审批结果。作废/终止释放 committed 必须另有受管
109
- 真实业务动作；状态枚举不代表已实现该能力，签后金额变更仍拒绝。锁等待最多2秒、
108
+ 作废/终止释放 committed 必须另有受管真实业务动作；状态枚举不代表已实现该能力，
109
+ 签后金额变更仍拒绝。锁等待最多2秒、
110
110
  单条SQL最多5秒，较严格的已有约束优先；retryable 409
111
111
  `OPENXIANGDA_NATIVE_DECIMAL_CONTENTION` 不允许换键掩盖未知结果。
112
+
113
+ ## 提交金额后的正常生命周期
114
+
115
+ 需要在 committed 后继续签订、履行等状态操作时，在模型上声明
116
+ `decimalReservationLifecycle`。它复用同资源 reserve 动作的状态与关系字段，
117
+ 不新增接口或余额；未声明时继续原有严格保护。以下状态均须已在状态字段选项中声明：
118
+
119
+ ```ts
120
+ decimalReservationLifecycle: {
121
+ parentTransitions: [
122
+ { from: 'active', to: 'closed' },
123
+ { from: 'closed', to: 'active' },
124
+ ],
125
+ childTransitions: [
126
+ { from: 'signing', to: 'fulfilled' },
127
+ { from: 'fulfilled', to: 'signing' },
128
+ ],
129
+ fulfilledChildStatuses: ['fulfilled'],
130
+ lockedParentStatuses: ['closed'],
131
+ }
132
+ ```
133
+
134
+ 之后用既有 Data API update 或 transaction，带原记录的 expectedRevision。
135
+ 当前用户或已授权后台主体仍须具备原资源、字段和数据范围权限。金额、币种、主子关系、
136
+ parent/root 仍受保护，声明状态边不授予写权限。普通子状态更新必须属于当前 committed
137
+ 周期；reserved/released 继续走真实受管审批或重新提交，不能绕过审批。
138
+
139
+ 父记录进入 locked 状态时，所有当前占用都必须已 committed 且子状态在 fulfilled 集合；
140
+ 存在 reserved、缺失子记录、金额/关系不一致或未履行子记录时返回
141
+ `OPENXIANGDA_NATIVE_DECIMAL_PARENT_UNFULFILLED_CHILDREN`。released 历史周期已退出义务。
142
+ 终止、作废不会自动算作履行或释放金额，需按真实业务含义选择声明。
143
+ 父记录 locked 后拒绝新预留和把子记录改回未履行状态，返回
144
+ `OPENXIANGDA_NATIVE_DECIMAL_PARENT_LOCKED`；如需解锁，必须有明确的父状态边和原更新权限。
145
+
146
+ 每类最多 64 条不重复、非自身状态边，两个状态集合各 1–16 项。状态和映射不符、缺少
147
+ reserve 声明、锁定状态仍可新预留，在本地检查即拒绝并指向声明位置。
148
+ 显式启用才要求 `data.decimal-reservation-lifecycle@1.0.0`；目标环境须先升级并具备该能力。
149
+ 状态规则改变在激活新版本前会核对现有关闭父记录，冲突返回
150
+ `OPENXIANGDA_NATIVE_DECIMAL_LIFECYCLE_ACTIVATION_CONFLICT`，保留原版本和数据；不会自动改历史状态。
151
+ 移除声明将恢复严格保护。回滚到不支持本能力的服务器前，应先停用依赖此声明的入口。
152
+ Connected Dev 会保留已激活规则。新增或改变规则时，先通过 `check` 并发布到测试环境，
153
+ 使历史一致性校验完成后再连接开发；若仅改本地覆盖层，会返回
154
+ `OPENXIANGDA_CONNECTED_DEV_OVERLAY_DECIMAL_LIFECYCLE_ACTIVATION_REQUIRED` 和声明指针。
155
+ 这样不会出现本地规则被接受却在写入时悄悄忽略的情况。
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.28.1 skill install --force
72
- pnpm dlx openxiangda@2.28.1 auth status --base-url <平台地址> --json
73
- pnpm dlx openxiangda@2.28.1 login --cwd my-app --base-url https://platform.example.com
74
- pnpm dlx openxiangda@2.28.1 create my-app --base-url https://platform.example.com
71
+ pnpm dlx openxiangda@2.29.0 skill install --force
72
+ pnpm dlx openxiangda@2.29.0 auth status --base-url <平台地址> --json
73
+ pnpm dlx openxiangda@2.29.0 login --cwd my-app --base-url https://platform.example.com
74
+ pnpm dlx openxiangda@2.29.0 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.28.1 auth status --base-url <平台> --json
178
- pnpm dlx openxiangda@2.28.1 source resolve <仓库URL> --base-url <平台> --json
179
- pnpm dlx openxiangda@2.28.1 source clone <仓库URL> <新目录> --base-url <平台> --json
177
+ pnpm dlx openxiangda@2.29.0 auth status --base-url <平台> --json
178
+ pnpm dlx openxiangda@2.29.0 source resolve <仓库URL> --base-url <平台> --json
179
+ pnpm dlx openxiangda@2.29.0 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.28.1",
3
+ "version": "2.29.0",
4
4
  "topics": [
5
5
  {
6
6
  "id": "getting-started",
7
7
  "title": "安装与开始开发",
8
8
  "file": "getting-started.md",
9
- "sha256": "4c1b210bbfaf06f1fd4713178ffcc134b5464b1d14ae93bf5c859f9aef5383cc"
9
+ "sha256": "260070c834f6e441f80604b8d41a174c13bf27c166cd5aea4dd0d5c5b3dc74b7"
10
10
  },
11
11
  {
12
12
  "id": "product-design",
@@ -96,7 +96,7 @@
96
96
  "id": "decimal-reservations",
97
97
  "title": "主子记录精确金额占用",
98
98
  "file": "decimal-reservations.md",
99
- "sha256": "a40f402a297476e37aecdb1a19caa5156b772f35f637b8f7e75fb25864c46321"
99
+ "sha256": "cdbc0bfff79c9bf71b88f5f50a5b76e4de77bae92e590ce08f32662621c1ff7d"
100
100
  },
101
101
  {
102
102
  "id": "administration",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openxiangda",
3
- "version": "2.28.1",
3
+ "version": "2.29.0",
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.23",
64
- "openxiangda-contracts": "2.24.0",
65
- "openxiangda-devkit-core": "2.27.0",
63
+ "openxiangda-cli": "2.5.24",
64
+ "openxiangda-contracts": "2.25.0",
65
+ "openxiangda-devkit-core": "2.28.0",
66
66
  "openxiangda-legacy": "npm:openxiangda@1.0.269",
67
- "openxiangda-mcp": "2.0.47",
68
- "openxiangda-nest": "2.7.1",
69
- "openxiangda-skill-kit": "2.3.21",
67
+ "openxiangda-mcp": "2.0.48",
68
+ "openxiangda-nest": "2.7.2",
69
+ "openxiangda-skill-kit": "2.3.22",
70
70
  "xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
71
71
  },
72
72
  "peerDependencies": {
@@ -132,37 +132,40 @@
132
132
  },
133
133
  "openxiangdaRelease": {
134
134
  "schemaVersion": "openxiangda.release-notes/v1",
135
- "version": "2.28.1",
135
+ "version": "2.29.0",
136
136
  "status": "reviewed",
137
- "title": "OpenXiangda 2.28.1：后端镜像原制品上传恢复",
138
- "summary": "上传中断后保留原 OCI 镜像，普通 deploy 重试直接从平台已有偏移或 ready 回执恢复，减少重建和重复传输。",
139
- "newFeatures": [],
137
+ "title": "OpenXiangda 2.29.0：金额提交后的声明式生命周期",
138
+ "summary": "模型可以声明金额提交后的合法状态变化、子记录履行状态和父记录锁定状态；编译时检查规则，平台在原 Native 写入和激活边界执行一致性保护。",
139
+ "newFeatures": [
140
+ "模型与 DataResource 增加可选 decimalReservationLifecycle，复用现有额度字段映射并派生 data.decimal-reservation-lifecycle@1.0.0。",
141
+ "应用编译器、平台纯编译器和 JSON Schema 同步支持有界声明；未知状态、重复或自身状态边、缺少 reserve 动作及锁定状态可新预留在发布前拒绝。"
142
+ ],
140
143
  "fixes": [
141
- "已导出的后端镜像不会再因为上传失败或响应丢失被立即删除；相同输入重试保持原摘要，已封存候选不再依赖 Docker 重建。",
142
- "缓存绑定当前站点、租户、用户、应用环境和实际构建上下文，包含未提交源码；恢复前验证全部 blob，使用跨进程租约阻止重复上传。"
144
+ "为已 committed 子记录的正常履行更新提供受约束的原 Data API 路径，继续保护金额、币种和主子关系。"
143
145
  ],
144
146
  "affectedUsers": [
145
- "通过平台登录态分块上传后端镜像的 OpenXiangda 2.0 应用开发者。"
147
+ "使用主子记录精确金额预留，且需要在审批提交金额后继续履行、关闭或解锁的 OpenXiangda 2.0 应用。"
146
148
  ],
147
149
  "upgradeSteps": [
148
- "应用消费 openxiangda@2.28.1 并更新锁文件。上传中断时保留工作区输入，恢复网络或登录后重复原 deploy 命令。",
149
- "无需平台数据库迁移，也无需手工寻找 BuildKit 历史或镜像上传会话。"
150
+ "先确认目标平台支持 data.decimal-reservation-lifecycle@1.0.0，再安装 openxiangda@2.29.0 并更新锁文件。",
151
+ "在模型显式声明合法状态边、已履行子状态和锁定父状态；继续通过已授权 Data API update/transaction 与 expectedRevision 更新。",
152
+ "本能力不需要新增数据库迁移；新版本激活会检查现有关闭父记录，不自动改写历史状态。"
150
153
  ],
151
154
  "knownLimitations": [
152
- "最多保留 8 个候选、总预留空间 8 GiB、24 小时；平台单镜像上限超过 8 GiB 时继续原临时上传路径。缓存过期或被预算清理后需要重新构建。",
153
- "源码、身份、环境、配置或工具版本变化会形成新候选；恢复原镜像不重新求值远程 FROM/RUN 输入。",
154
- "本机上下文校验有 100000 条目、8 GiB、60 秒预算；构建期间源码变化会拒绝上传，需要保存完成后重试。",
155
- "真实 Docker 导出及故障恢复、隔离的传输协议和发行门禁分别验证，不代表任何客户应用已发布或通过业务验收。"
155
+ "状态声明不授予资源、字段或行权限；reserved/released 子记录仍须走原受管审批或重新提交。",
156
+ "终止或作废不自动代表履行，也不会释放 committed 金额。每类最多 64 条边，两个状态集合各 1–16 项。",
157
+ "未声明的资源保留严格保护；回滚到不支持本能力的服务器前须停用依赖新声明的入口。",
158
+ "公开包发行与目标平台部署、应用适配及业务验收分别记录；包安装成功不代表目标环境具备运行能力。"
156
159
  ],
157
160
  "issues": [],
158
161
  "compatibility": {
159
162
  "node": ">=24",
160
163
  "workspaceGenerations": "v2",
161
- "platform": "复用既有 backendImageUpload 协议和 auth/whoami，不新增远端上传状态或服务器账号要求。",
162
- "v1": "独立 V1 引擎和工作区不受影响。"
164
+ "platform": "显式声明才要求 data.decimal-reservation-lifecycle@1.0.0；共享 Native validator 随新契约更新，按目标预检结果配套升级平台。",
165
+ "v1": "独立 V1 引擎和未声明生命周期的资源不受运行行为变更影响。"
163
166
  },
164
- "sha256": "762fa08d9c2818264ed9b65383f1ec60ad6bc4236978ee07cf0c19cdce45ad16",
165
- "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.28.1"
167
+ "sha256": "967c751ef6dd40ae7e593bebef5ac48e94ad366272b6622702e05a89338fb021",
168
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.29.0"
166
169
  },
167
170
  "scripts": {
168
171
  "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",
package/releases/2.29.0.json ADDED
@@ -0,0 +1,37 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.29.0",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.29.0：金额提交后的声明式生命周期",
6
+ "summary": "模型可以声明金额提交后的合法状态变化、子记录履行状态和父记录锁定状态；编译时检查规则，平台在原 Native 写入和激活边界执行一致性保护。",
7
+ "newFeatures": [
8
+ "模型与 DataResource 增加可选 decimalReservationLifecycle，复用现有额度字段映射并派生 data.decimal-reservation-lifecycle@1.0.0。",
9
+ "应用编译器、平台纯编译器和 JSON Schema 同步支持有界声明；未知状态、重复或自身状态边、缺少 reserve 动作及锁定状态可新预留在发布前拒绝。"
10
+ ],
11
+ "fixes": [
12
+ "为已 committed 子记录的正常履行更新提供受约束的原 Data API 路径，继续保护金额、币种和主子关系。"
13
+ ],
14
+ "affectedUsers": [
15
+ "使用主子记录精确金额预留，且需要在审批提交金额后继续履行、关闭或解锁的 OpenXiangda 2.0 应用。"
16
+ ],
17
+ "upgradeSteps": [
18
+ "先确认目标平台支持 data.decimal-reservation-lifecycle@1.0.0，再安装 openxiangda@2.29.0 并更新锁文件。",
19
+ "在模型显式声明合法状态边、已履行子状态和锁定父状态；继续通过已授权 Data API update/transaction 与 expectedRevision 更新。",
20
+ "本能力不需要新增数据库迁移；新版本激活会检查现有关闭父记录，不自动改写历史状态。"
21
+ ],
22
+ "knownLimitations": [
23
+ "状态声明不授予资源、字段或行权限；reserved/released 子记录仍须走原受管审批或重新提交。",
24
+ "终止或作废不自动代表履行，也不会释放 committed 金额。每类最多 64 条边，两个状态集合各 1–16 项。",
25
+ "未声明的资源保留严格保护；回滚到不支持本能力的服务器前须停用依赖新声明的入口。",
26
+ "公开包发行与目标平台部署、应用适配及业务验收分别记录；包安装成功不代表目标环境具备运行能力。"
27
+ ],
28
+ "issues": [],
29
+ "compatibility": {
30
+ "node": ">=24",
31
+ "workspaceGenerations": "v2",
32
+ "platform": "显式声明才要求 data.decimal-reservation-lifecycle@1.0.0；共享 Native validator 随新契约更新，按目标预检结果配套升级平台。",
33
+ "v1": "独立 V1 引擎和未声明生命周期的资源不受运行行为变更影响。"
34
+ },
35
+ "sha256": "967c751ef6dd40ae7e593bebef5ac48e94ad366272b6622702e05a89338fb021",
36
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.29.0"
37
+ }
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": "d292d7381a0128d1ee2b0d73a2714eb32fbe6efba6e89f9a80ff8ec32ef3492f"
7
+ "sha256": "a0a31ebfc680b50a00143a94f76f815a73628a0b6ca74ca612d6f2ac87ebfe39"
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.28.1 auth status --cwd <应用目录> --base-url <平台地址> --json
44
- pnpm dlx openxiangda@2.28.1 login --cwd <应用目录> --base-url <平台地址>
45
- pnpm dlx openxiangda@2.28.1 create <应用目录> --base-url <同一平台地址>
46
- pnpm dlx openxiangda@2.28.1 skill install --force
43
+ pnpm dlx openxiangda@2.29.0 auth status --cwd <应用目录> --base-url <平台地址> --json
44
+ pnpm dlx openxiangda@2.29.0 login --cwd <应用目录> --base-url <平台地址>
45
+ pnpm dlx openxiangda@2.29.0 create <应用目录> --base-url <同一平台地址>
46
+ pnpm dlx openxiangda@2.29.0 skill install --force
47
47
  ```
48
48
 
49
49
  创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。
package/skills/openxiangda-v2/references/decimal-reservations.md CHANGED
@@ -105,7 +105,51 @@ workflow command/instance/subject revision 和台账验证，SDK自动继承已
105
105
  普通应用凭据或自填事件头不构成授权。精确同键、同payload重放返回原完整事务结果；
106
106
  旧轮次不能释放重提后的新占用。重放仍受当前权限、有效事件租约和父记录可读性约束。
107
107
 
108
- 首批只覆盖主子额度和三个真实审批结果。作废/终止释放 committed 必须另有受管
109
- 真实业务动作；状态枚举不代表已实现该能力，签后金额变更仍拒绝。锁等待最多2秒、
108
+ 作废/终止释放 committed 必须另有受管真实业务动作；状态枚举不代表已实现该能力，
109
+ 签后金额变更仍拒绝。锁等待最多2秒、
110
110
  单条SQL最多5秒，较严格的已有约束优先；retryable 409
111
111
  `OPENXIANGDA_NATIVE_DECIMAL_CONTENTION` 不允许换键掩盖未知结果。
112
+
113
+ ## 提交金额后的正常生命周期
114
+
115
+ 需要在 committed 后继续签订、履行等状态操作时，在模型上声明
116
+ `decimalReservationLifecycle`。它复用同资源 reserve 动作的状态与关系字段，
117
+ 不新增接口或余额；未声明时继续原有严格保护。以下状态均须已在状态字段选项中声明：
118
+
119
+ ```ts
120
+ decimalReservationLifecycle: {
121
+ parentTransitions: [
122
+ { from: 'active', to: 'closed' },
123
+ { from: 'closed', to: 'active' },
124
+ ],
125
+ childTransitions: [
126
+ { from: 'signing', to: 'fulfilled' },
127
+ { from: 'fulfilled', to: 'signing' },
128
+ ],
129
+ fulfilledChildStatuses: ['fulfilled'],
130
+ lockedParentStatuses: ['closed'],
131
+ }
132
+ ```
133
+
134
+ 之后用既有 Data API update 或 transaction，带原记录的 expectedRevision。
135
+ 当前用户或已授权后台主体仍须具备原资源、字段和数据范围权限。金额、币种、主子关系、
136
+ parent/root 仍受保护，声明状态边不授予写权限。普通子状态更新必须属于当前 committed
137
+ 周期；reserved/released 继续走真实受管审批或重新提交，不能绕过审批。
138
+
139
+ 父记录进入 locked 状态时，所有当前占用都必须已 committed 且子状态在 fulfilled 集合；
140
+ 存在 reserved、缺失子记录、金额/关系不一致或未履行子记录时返回
141
+ `OPENXIANGDA_NATIVE_DECIMAL_PARENT_UNFULFILLED_CHILDREN`。released 历史周期已退出义务。
142
+ 终止、作废不会自动算作履行或释放金额，需按真实业务含义选择声明。
143
+ 父记录 locked 后拒绝新预留和把子记录改回未履行状态，返回
144
+ `OPENXIANGDA_NATIVE_DECIMAL_PARENT_LOCKED`；如需解锁，必须有明确的父状态边和原更新权限。
145
+
146
+ 每类最多 64 条不重复、非自身状态边，两个状态集合各 1–16 项。状态和映射不符、缺少
147
+ reserve 声明、锁定状态仍可新预留，在本地检查即拒绝并指向声明位置。
148
+ 显式启用才要求 `data.decimal-reservation-lifecycle@1.0.0`；目标环境须先升级并具备该能力。
149
+ 状态规则改变在激活新版本前会核对现有关闭父记录，冲突返回
150
+ `OPENXIANGDA_NATIVE_DECIMAL_LIFECYCLE_ACTIVATION_CONFLICT`，保留原版本和数据；不会自动改历史状态。
151
+ 移除声明将恢复严格保护。回滚到不支持本能力的服务器前，应先停用依赖此声明的入口。
152
+ Connected Dev 会保留已激活规则。新增或改变规则时，先通过 `check` 并发布到测试环境，
153
+ 使历史一致性校验完成后再连接开发；若仅改本地覆盖层，会返回
154
+ `OPENXIANGDA_CONNECTED_DEV_OVERLAY_DECIMAL_LIFECYCLE_ACTIVATION_REQUIRED` 和声明指针。
155
+ 这样不会出现本地规则被接受却在写入时悄悄忽略的情况。
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.28.1 skill install --force
72
- pnpm dlx openxiangda@2.28.1 auth status --base-url <平台地址> --json
73
- pnpm dlx openxiangda@2.28.1 login --cwd my-app --base-url https://platform.example.com
74
- pnpm dlx openxiangda@2.28.1 create my-app --base-url https://platform.example.com
71
+ pnpm dlx openxiangda@2.29.0 skill install --force
72
+ pnpm dlx openxiangda@2.29.0 auth status --base-url <平台地址> --json
73
+ pnpm dlx openxiangda@2.29.0 login --cwd my-app --base-url https://platform.example.com
74
+ pnpm dlx openxiangda@2.29.0 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.28.1 auth status --base-url <平台> --json
178
- pnpm dlx openxiangda@2.28.1 source resolve <仓库URL> --base-url <平台> --json
179
- pnpm dlx openxiangda@2.28.1 source clone <仓库URL> <新目录> --base-url <平台> --json
177
+ pnpm dlx openxiangda@2.29.0 auth status --base-url <平台> --json
178
+ pnpm dlx openxiangda@2.29.0 source resolve <仓库URL> --base-url <平台> --json
179
+ pnpm dlx openxiangda@2.29.0 source clone <仓库URL> <新目录> --base-url <平台> --json
180
180
  ```
181
181
 
182
182
  登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回