openxiangda 2.27.0 → 2.28.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.
- package/documentation/delivery.md +24 -0
- package/documentation/getting-started.md +7 -7
- package/documentation/manifest.json +5 -5
- package/documentation/reference/cli.md +1 -1
- package/documentation/reference/mcp.md +53 -0
- package/package.json +24 -25
- package/releases/2.28.0.json +37 -0
- package/skills/manifest.json +1 -1
- package/skills/openxiangda-v2/SKILL.md +4 -4
- package/skills/openxiangda-v2/references/cli.md +1 -1
- package/skills/openxiangda-v2/references/delivery.md +24 -0
- package/skills/openxiangda-v2/references/getting-started.md +7 -7
- package/skills/openxiangda-v2/references/mcp.md +53 -0
|
@@ -2,6 +2,30 @@
|
|
|
2
2
|
|
|
3
3
|
应用开发者从工作区执行 `pnpm openxiangda`。平台负责应用版本、运行状态和恢复决定。工具链自身的 npm 发布由平台维护者负责，应用项目无需复制发包脚本或平台验证矩阵。
|
|
4
4
|
|
|
5
|
+
## 按原操作自助诊断
|
|
6
|
+
|
|
7
|
+
保留原 requestId、commandId、DeploymentRun ID 或 fileId；应用管理员可在已有
|
|
8
|
+
登录工作区查询，不需要服务器账号。目标平台需提供 `application.scoped-diagnostics@1`。
|
|
9
|
+
|
|
10
|
+
```bash
|
|
11
|
+
pnpm openxiangda logs --request-id <原请求ID> --json
|
|
12
|
+
pnpm openxiangda logs --command-id <原命令UUID> --json
|
|
13
|
+
pnpm openxiangda logs --file-id <受管文件UUID> --environment test --json
|
|
14
|
+
pnpm openxiangda logs --deployment-run-id <原RunUUID> --environment production --json
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
requestId 默认最近一小时，结果会显示实际 from/to；跨日排查可传一对 UTC ISO
|
|
18
|
+
时间 `--from` / `--to`（最多 24 小时）。其余定位器按原 ID 查，不接受时间窗口。
|
|
19
|
+
默认环境是 test；production 必须显式选择。结果包含实际站点、应用、环境、观测时间、
|
|
20
|
+
持久状态和是否截断，只投影允许的元数据，不返回业务正文、文件名或密钥。
|
|
21
|
+
|
|
22
|
+
`observed` 仅表示查到事实，仍需看每条状态；`not_observed` 不表示原写入没有发生；
|
|
23
|
+
`unavailable` 表示本次诊断暂不可用。三者都不会重放原操作。保留原 ID、输入和幂等键，
|
|
24
|
+
按返回的下一步查询原回执，不创建新运行代替未知结果。文件存在不等于当前用户可下载。
|
|
25
|
+
|
|
26
|
+
原有 `pnpm openxiangda logs [deploymentId]` 保持部署日志行为。MCP 的
|
|
27
|
+
`application_diagnostics` 使用同一范围和状态约定；requestId 的 from/to 必须明确提供。
|
|
28
|
+
|
|
5
29
|
## 测试部署
|
|
6
30
|
|
|
7
31
|
源码托管仍可通过 `pnpm openxiangda source push` 提交和推送，但不是测试发布的前置步骤。
|
|
@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
|
|
|
68
68
|
以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
|
|
69
69
|
|
|
70
70
|
```bash
|
|
71
|
-
pnpm dlx openxiangda@2.
|
|
72
|
-
pnpm dlx openxiangda@2.
|
|
73
|
-
pnpm dlx openxiangda@2.
|
|
74
|
-
pnpm dlx openxiangda@2.
|
|
71
|
+
pnpm dlx openxiangda@2.28.0 skill install --force
|
|
72
|
+
pnpm dlx openxiangda@2.28.0 auth status --base-url <平台地址> --json
|
|
73
|
+
pnpm dlx openxiangda@2.28.0 login --cwd my-app --base-url https://platform.example.com
|
|
74
|
+
pnpm dlx openxiangda@2.28.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.
|
|
178
|
-
pnpm dlx openxiangda@2.
|
|
179
|
-
pnpm dlx openxiangda@2.
|
|
177
|
+
pnpm dlx openxiangda@2.28.0 auth status --base-url <平台> --json
|
|
178
|
+
pnpm dlx openxiangda@2.28.0 source resolve <仓库URL> --base-url <平台> --json
|
|
179
|
+
pnpm dlx openxiangda@2.28.0 source clone <仓库URL> <新目录> --base-url <平台> --json
|
|
180
180
|
```
|
|
181
181
|
|
|
182
182
|
登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": "openxiangda.documentation/v1",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.28.0",
|
|
4
4
|
"topics": [
|
|
5
5
|
{
|
|
6
6
|
"id": "getting-started",
|
|
7
7
|
"title": "安装与开始开发",
|
|
8
8
|
"file": "getting-started.md",
|
|
9
|
-
"sha256": "
|
|
9
|
+
"sha256": "e8be6499d3a6493926f5cd71243562a267325a0b800a511ebc31cf841ddfa08e"
|
|
10
10
|
},
|
|
11
11
|
{
|
|
12
12
|
"id": "product-design",
|
|
@@ -114,7 +114,7 @@
|
|
|
114
114
|
"id": "delivery",
|
|
115
115
|
"title": "部署、生产晋级与恢复",
|
|
116
116
|
"file": "delivery.md",
|
|
117
|
-
"sha256": "
|
|
117
|
+
"sha256": "fe26351024801784640c876efd3e9816294fc41b4a41fd719856e17425adc106"
|
|
118
118
|
},
|
|
119
119
|
{
|
|
120
120
|
"id": "upgrading",
|
|
@@ -126,13 +126,13 @@
|
|
|
126
126
|
"id": "cli",
|
|
127
127
|
"title": "CLI 命令参考",
|
|
128
128
|
"file": "reference/cli.md",
|
|
129
|
-
"sha256": "
|
|
129
|
+
"sha256": "c3803d06724b6879788d695fc3a9a5a9894299dc50fde5bad58d8320ea4ba32e"
|
|
130
130
|
},
|
|
131
131
|
{
|
|
132
132
|
"id": "mcp",
|
|
133
133
|
"title": "MCP 配置与工具参考",
|
|
134
134
|
"file": "reference/mcp.md",
|
|
135
|
-
"sha256": "
|
|
135
|
+
"sha256": "23a4da755e482f96e520d98f7527052c60bfb9727b48827a661e0f0eaf8ea838"
|
|
136
136
|
}
|
|
137
137
|
]
|
|
138
138
|
}
|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
| `pnpm openxiangda accept` | 远端变更 | 按计划准备可选的真实预发验收身份 |
|
|
16
16
|
| `pnpm openxiangda deploy` | 远端变更 | 部署测试环境或显式复用测试版本部署生产 |
|
|
17
17
|
| `pnpm openxiangda status` | 只读 | 查询最近或指定部署状态 |
|
|
18
|
-
| `pnpm openxiangda logs` | 只读 |
|
|
18
|
+
| `pnpm openxiangda logs` | 只读 | 查询部署日志或应用原操作事实 |
|
|
19
19
|
| `pnpm openxiangda cancel` | 远端变更 | 幂等取消尚未提交激活的部署 |
|
|
20
20
|
| `pnpm openxiangda retry` | 远端变更 | 显式重试可恢复的失败部署 |
|
|
21
21
|
| `pnpm openxiangda start` | 远端变更 | 从当前不可变版本启动应用环境 |
|
|
@@ -561,6 +561,59 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
|
|
|
561
561
|
}
|
|
562
562
|
```
|
|
563
563
|
|
|
564
|
+
## application_diagnostics
|
|
565
|
+
|
|
566
|
+
查询应用原操作事实。在当前应用和明确环境内只读查询 requestId、commandId、deploymentRunId 或 fileId。requestId 必须传成对 UTC from/to，最多 24 小时；其余类型不传窗口。未观测到不表示未执行，禁止据此换键重放。
|
|
567
|
+
|
|
568
|
+
- 只读：是
|
|
569
|
+
- 可替换文件或改变远端状态：否
|
|
570
|
+
- 幂等：否
|
|
571
|
+
|
|
572
|
+
输入参数：
|
|
573
|
+
|
|
574
|
+
```json
|
|
575
|
+
{
|
|
576
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
577
|
+
"type": "object",
|
|
578
|
+
"properties": {
|
|
579
|
+
"environment": {
|
|
580
|
+
"default": "test",
|
|
581
|
+
"description": "目标环境；默认 test，production 必须明确选择",
|
|
582
|
+
"type": "string",
|
|
583
|
+
"enum": [
|
|
584
|
+
"test",
|
|
585
|
+
"production"
|
|
586
|
+
]
|
|
587
|
+
},
|
|
588
|
+
"kind": {
|
|
589
|
+
"type": "string",
|
|
590
|
+
"enum": [
|
|
591
|
+
"requestId",
|
|
592
|
+
"commandId",
|
|
593
|
+
"deploymentRunId",
|
|
594
|
+
"fileId"
|
|
595
|
+
]
|
|
596
|
+
},
|
|
597
|
+
"id": {
|
|
598
|
+
"type": "string",
|
|
599
|
+
"minLength": 1,
|
|
600
|
+
"maxLength": 128
|
|
601
|
+
},
|
|
602
|
+
"from": {
|
|
603
|
+
"type": "string"
|
|
604
|
+
},
|
|
605
|
+
"to": {
|
|
606
|
+
"type": "string"
|
|
607
|
+
}
|
|
608
|
+
},
|
|
609
|
+
"required": [
|
|
610
|
+
"kind",
|
|
611
|
+
"id"
|
|
612
|
+
],
|
|
613
|
+
"additionalProperties": false
|
|
614
|
+
}
|
|
615
|
+
```
|
|
616
|
+
|
|
564
617
|
## cancel_deployment
|
|
565
618
|
|
|
566
619
|
取消未激活部署。仅在用户授权且平台 recovery.cancelAllowed 为真时取消；激活后的运行不能取消。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "openxiangda",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.28.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.
|
|
64
|
-
"openxiangda-contracts": "2.
|
|
65
|
-
"openxiangda-devkit-core": "2.
|
|
63
|
+
"openxiangda-cli": "2.5.22",
|
|
64
|
+
"openxiangda-contracts": "2.24.0",
|
|
65
|
+
"openxiangda-devkit-core": "2.26.0",
|
|
66
66
|
"openxiangda-legacy": "npm:openxiangda@1.0.269",
|
|
67
|
-
"openxiangda-mcp": "2.0.
|
|
68
|
-
"openxiangda-nest": "2.7.
|
|
69
|
-
"openxiangda-skill-kit": "2.3.
|
|
67
|
+
"openxiangda-mcp": "2.0.46",
|
|
68
|
+
"openxiangda-nest": "2.7.1",
|
|
69
|
+
"openxiangda-skill-kit": "2.3.20",
|
|
70
70
|
"xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
|
|
71
71
|
},
|
|
72
72
|
"peerDependencies": {
|
|
@@ -132,41 +132,40 @@
|
|
|
132
132
|
},
|
|
133
133
|
"openxiangdaRelease": {
|
|
134
134
|
"schemaVersion": "openxiangda.release-notes/v1",
|
|
135
|
-
"version": "2.
|
|
135
|
+
"version": "2.28.0",
|
|
136
136
|
"status": "reviewed",
|
|
137
|
-
"title": "OpenXiangda 2.
|
|
138
|
-
"summary": "
|
|
137
|
+
"title": "OpenXiangda 2.28.0：应用原操作自助诊断",
|
|
138
|
+
"summary": "应用管理员通过现有工作区查询原请求、持久命令、部署和受管文件的脱敏事实，减少依赖平台人员登录服务器定位问题的情况。",
|
|
139
139
|
"newFeatures": [
|
|
140
|
-
"
|
|
141
|
-
"
|
|
142
|
-
"提供本人 FormDraft 与 BusinessProcess update 重提组合示例，将修改正式金额、重新占额、消费草稿和生成审批命令放在同一平台事务。"
|
|
140
|
+
"logs 增加 request-id、command-id、deployment-run-id、file-id 四种互斥定位器，MCP 提供相同范围的 application_diagnostics 只读工具。",
|
|
141
|
+
"结果显示实际站点、应用、环境、时间窗口及观测时间；SDK 校验查询与响应关联，只保留受支持的元数据。"
|
|
143
142
|
],
|
|
144
143
|
"fixes": [
|
|
145
|
-
"
|
|
144
|
+
"明确区分已观测、未观测和诊断暂不可用；未知结果不再被解释成原操作未执行，也不会触发换键重放。"
|
|
146
145
|
],
|
|
147
146
|
"affectedUsers": [
|
|
148
|
-
"
|
|
147
|
+
"需要按原操作 ID 自助排查发布、工作流和文件状态的 OpenXiangda 2.0 应用管理员及开发者。"
|
|
149
148
|
],
|
|
150
149
|
"upgradeSteps": [
|
|
151
|
-
"
|
|
152
|
-
"
|
|
153
|
-
"
|
|
150
|
+
"应用消费 openxiangda@2.28.0 并更新锁文件；使用已有工作区开发者登录，不需要服务器账号。",
|
|
151
|
+
"平台应提供 application.scoped-diagnostics@1；查询默认使用 test，生产环境需显式传 --environment production。",
|
|
152
|
+
"保留原操作 ID。request-id 默认查询最近一小时，也可传一对 UTC from/to，窗口最多 24 小时；其他定位器不接受时间窗口。"
|
|
154
153
|
],
|
|
155
154
|
"knownLimitations": [
|
|
156
|
-
"
|
|
157
|
-
"
|
|
158
|
-
"
|
|
159
|
-
"
|
|
155
|
+
"诊断受应用管理权限和当前租户、环境约束；普通应用服务凭据不因此获得管理权限。",
|
|
156
|
+
"每次最多返回 50 条事实，可能标记截断；不返回业务正文、文件名、原始日志或密钥。",
|
|
157
|
+
"未观测不表示原写入未发生，已观测不表示业务验收完成。暂不可用时保留原键与输入，按提示继续查询。",
|
|
158
|
+
"此次新增能力不改变共享 Native 编译器摘要；公开包发行与实际站点部署分别验证。"
|
|
160
159
|
],
|
|
161
160
|
"issues": [],
|
|
162
161
|
"compatibility": {
|
|
163
162
|
"node": ">=24",
|
|
164
163
|
"workspaceGenerations": "v2",
|
|
165
|
-
"platform": "
|
|
164
|
+
"platform": "新诊断入口要求 application.scoped-diagnostics@1.0.0 或兼容 1.x；原 logs [deploymentId] 和未使用此能力的应用保持原行为。",
|
|
166
165
|
"v1": "独立 V1 引擎和工作区不受影响。"
|
|
167
166
|
},
|
|
168
|
-
"sha256": "
|
|
169
|
-
"url": "https://github.com/1377385356/openxiangda/releases/tag/v2.
|
|
167
|
+
"sha256": "80c18512f5cb76850e738b9e802261af68e27f6582b3f686781da7c9d4367c2a",
|
|
168
|
+
"url": "https://github.com/1377385356/openxiangda/releases/tag/v2.28.0"
|
|
170
169
|
},
|
|
171
170
|
"scripts": {
|
|
172
171
|
"build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": "openxiangda.release-notes/v1",
|
|
3
|
+
"version": "2.28.0",
|
|
4
|
+
"status": "reviewed",
|
|
5
|
+
"title": "OpenXiangda 2.28.0：应用原操作自助诊断",
|
|
6
|
+
"summary": "应用管理员通过现有工作区查询原请求、持久命令、部署和受管文件的脱敏事实，减少依赖平台人员登录服务器定位问题的情况。",
|
|
7
|
+
"newFeatures": [
|
|
8
|
+
"logs 增加 request-id、command-id、deployment-run-id、file-id 四种互斥定位器，MCP 提供相同范围的 application_diagnostics 只读工具。",
|
|
9
|
+
"结果显示实际站点、应用、环境、时间窗口及观测时间；SDK 校验查询与响应关联，只保留受支持的元数据。"
|
|
10
|
+
],
|
|
11
|
+
"fixes": [
|
|
12
|
+
"明确区分已观测、未观测和诊断暂不可用；未知结果不再被解释成原操作未执行，也不会触发换键重放。"
|
|
13
|
+
],
|
|
14
|
+
"affectedUsers": [
|
|
15
|
+
"需要按原操作 ID 自助排查发布、工作流和文件状态的 OpenXiangda 2.0 应用管理员及开发者。"
|
|
16
|
+
],
|
|
17
|
+
"upgradeSteps": [
|
|
18
|
+
"应用消费 openxiangda@2.28.0 并更新锁文件；使用已有工作区开发者登录，不需要服务器账号。",
|
|
19
|
+
"平台应提供 application.scoped-diagnostics@1；查询默认使用 test，生产环境需显式传 --environment production。",
|
|
20
|
+
"保留原操作 ID。request-id 默认查询最近一小时，也可传一对 UTC from/to，窗口最多 24 小时；其他定位器不接受时间窗口。"
|
|
21
|
+
],
|
|
22
|
+
"knownLimitations": [
|
|
23
|
+
"诊断受应用管理权限和当前租户、环境约束；普通应用服务凭据不因此获得管理权限。",
|
|
24
|
+
"每次最多返回 50 条事实，可能标记截断；不返回业务正文、文件名、原始日志或密钥。",
|
|
25
|
+
"未观测不表示原写入未发生，已观测不表示业务验收完成。暂不可用时保留原键与输入，按提示继续查询。",
|
|
26
|
+
"此次新增能力不改变共享 Native 编译器摘要；公开包发行与实际站点部署分别验证。"
|
|
27
|
+
],
|
|
28
|
+
"issues": [],
|
|
29
|
+
"compatibility": {
|
|
30
|
+
"node": ">=24",
|
|
31
|
+
"workspaceGenerations": "v2",
|
|
32
|
+
"platform": "新诊断入口要求 application.scoped-diagnostics@1.0.0 或兼容 1.x；原 logs [deploymentId] 和未使用此能力的应用保持原行为。",
|
|
33
|
+
"v1": "独立 V1 引擎和工作区不受影响。"
|
|
34
|
+
},
|
|
35
|
+
"sha256": "80c18512f5cb76850e738b9e802261af68e27f6582b3f686781da7c9d4367c2a",
|
|
36
|
+
"url": "https://github.com/1377385356/openxiangda/releases/tag/v2.28.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": "
|
|
7
|
+
"sha256": "87568d43231b261b889782237c8bbe6f2d6237190c4f7ce74cd754e83f9336fd"
|
|
8
8
|
}
|
|
9
9
|
]
|
|
10
10
|
}
|
|
@@ -40,10 +40,10 @@ AI 接到新应用、页面或改版任务时，在同一个 OpenXiangda 工作
|
|
|
40
40
|
未创建工作区时使用本 Skill 随根包发布的精确版本：
|
|
41
41
|
|
|
42
42
|
```bash
|
|
43
|
-
pnpm dlx openxiangda@2.
|
|
44
|
-
pnpm dlx openxiangda@2.
|
|
45
|
-
pnpm dlx openxiangda@2.
|
|
46
|
-
pnpm dlx openxiangda@2.
|
|
43
|
+
pnpm dlx openxiangda@2.28.0 auth status --cwd <应用目录> --base-url <平台地址> --json
|
|
44
|
+
pnpm dlx openxiangda@2.28.0 login --cwd <应用目录> --base-url <平台地址>
|
|
45
|
+
pnpm dlx openxiangda@2.28.0 create <应用目录> --base-url <同一平台地址>
|
|
46
|
+
pnpm dlx openxiangda@2.28.0 skill install --force
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。
|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
| `pnpm openxiangda accept` | 远端变更 | 按计划准备可选的真实预发验收身份 |
|
|
16
16
|
| `pnpm openxiangda deploy` | 远端变更 | 部署测试环境或显式复用测试版本部署生产 |
|
|
17
17
|
| `pnpm openxiangda status` | 只读 | 查询最近或指定部署状态 |
|
|
18
|
-
| `pnpm openxiangda logs` | 只读 |
|
|
18
|
+
| `pnpm openxiangda logs` | 只读 | 查询部署日志或应用原操作事实 |
|
|
19
19
|
| `pnpm openxiangda cancel` | 远端变更 | 幂等取消尚未提交激活的部署 |
|
|
20
20
|
| `pnpm openxiangda retry` | 远端变更 | 显式重试可恢复的失败部署 |
|
|
21
21
|
| `pnpm openxiangda start` | 远端变更 | 从当前不可变版本启动应用环境 |
|
|
@@ -2,6 +2,30 @@
|
|
|
2
2
|
|
|
3
3
|
应用开发者从工作区执行 `pnpm openxiangda`。平台负责应用版本、运行状态和恢复决定。工具链自身的 npm 发布由平台维护者负责，应用项目无需复制发包脚本或平台验证矩阵。
|
|
4
4
|
|
|
5
|
+
## 按原操作自助诊断
|
|
6
|
+
|
|
7
|
+
保留原 requestId、commandId、DeploymentRun ID 或 fileId；应用管理员可在已有
|
|
8
|
+
登录工作区查询，不需要服务器账号。目标平台需提供 `application.scoped-diagnostics@1`。
|
|
9
|
+
|
|
10
|
+
```bash
|
|
11
|
+
pnpm openxiangda logs --request-id <原请求ID> --json
|
|
12
|
+
pnpm openxiangda logs --command-id <原命令UUID> --json
|
|
13
|
+
pnpm openxiangda logs --file-id <受管文件UUID> --environment test --json
|
|
14
|
+
pnpm openxiangda logs --deployment-run-id <原RunUUID> --environment production --json
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
requestId 默认最近一小时，结果会显示实际 from/to；跨日排查可传一对 UTC ISO
|
|
18
|
+
时间 `--from` / `--to`（最多 24 小时）。其余定位器按原 ID 查，不接受时间窗口。
|
|
19
|
+
默认环境是 test；production 必须显式选择。结果包含实际站点、应用、环境、观测时间、
|
|
20
|
+
持久状态和是否截断，只投影允许的元数据，不返回业务正文、文件名或密钥。
|
|
21
|
+
|
|
22
|
+
`observed` 仅表示查到事实，仍需看每条状态；`not_observed` 不表示原写入没有发生；
|
|
23
|
+
`unavailable` 表示本次诊断暂不可用。三者都不会重放原操作。保留原 ID、输入和幂等键，
|
|
24
|
+
按返回的下一步查询原回执，不创建新运行代替未知结果。文件存在不等于当前用户可下载。
|
|
25
|
+
|
|
26
|
+
原有 `pnpm openxiangda logs [deploymentId]` 保持部署日志行为。MCP 的
|
|
27
|
+
`application_diagnostics` 使用同一范围和状态约定；requestId 的 from/to 必须明确提供。
|
|
28
|
+
|
|
5
29
|
## 测试部署
|
|
6
30
|
|
|
7
31
|
源码托管仍可通过 `pnpm openxiangda source push` 提交和推送，但不是测试发布的前置步骤。
|
|
@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
|
|
|
68
68
|
以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
|
|
69
69
|
|
|
70
70
|
```bash
|
|
71
|
-
pnpm dlx openxiangda@2.
|
|
72
|
-
pnpm dlx openxiangda@2.
|
|
73
|
-
pnpm dlx openxiangda@2.
|
|
74
|
-
pnpm dlx openxiangda@2.
|
|
71
|
+
pnpm dlx openxiangda@2.28.0 skill install --force
|
|
72
|
+
pnpm dlx openxiangda@2.28.0 auth status --base-url <平台地址> --json
|
|
73
|
+
pnpm dlx openxiangda@2.28.0 login --cwd my-app --base-url https://platform.example.com
|
|
74
|
+
pnpm dlx openxiangda@2.28.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.
|
|
178
|
-
pnpm dlx openxiangda@2.
|
|
179
|
-
pnpm dlx openxiangda@2.
|
|
177
|
+
pnpm dlx openxiangda@2.28.0 auth status --base-url <平台> --json
|
|
178
|
+
pnpm dlx openxiangda@2.28.0 source resolve <仓库URL> --base-url <平台> --json
|
|
179
|
+
pnpm dlx openxiangda@2.28.0 source clone <仓库URL> <新目录> --base-url <平台> --json
|
|
180
180
|
```
|
|
181
181
|
|
|
182
182
|
登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回
|
|
@@ -561,6 +561,59 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
|
|
|
561
561
|
}
|
|
562
562
|
```
|
|
563
563
|
|
|
564
|
+
## application_diagnostics
|
|
565
|
+
|
|
566
|
+
查询应用原操作事实。在当前应用和明确环境内只读查询 requestId、commandId、deploymentRunId 或 fileId。requestId 必须传成对 UTC from/to，最多 24 小时；其余类型不传窗口。未观测到不表示未执行，禁止据此换键重放。
|
|
567
|
+
|
|
568
|
+
- 只读：是
|
|
569
|
+
- 可替换文件或改变远端状态：否
|
|
570
|
+
- 幂等：否
|
|
571
|
+
|
|
572
|
+
输入参数：
|
|
573
|
+
|
|
574
|
+
```json
|
|
575
|
+
{
|
|
576
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
577
|
+
"type": "object",
|
|
578
|
+
"properties": {
|
|
579
|
+
"environment": {
|
|
580
|
+
"default": "test",
|
|
581
|
+
"description": "目标环境；默认 test，production 必须明确选择",
|
|
582
|
+
"type": "string",
|
|
583
|
+
"enum": [
|
|
584
|
+
"test",
|
|
585
|
+
"production"
|
|
586
|
+
]
|
|
587
|
+
},
|
|
588
|
+
"kind": {
|
|
589
|
+
"type": "string",
|
|
590
|
+
"enum": [
|
|
591
|
+
"requestId",
|
|
592
|
+
"commandId",
|
|
593
|
+
"deploymentRunId",
|
|
594
|
+
"fileId"
|
|
595
|
+
]
|
|
596
|
+
},
|
|
597
|
+
"id": {
|
|
598
|
+
"type": "string",
|
|
599
|
+
"minLength": 1,
|
|
600
|
+
"maxLength": 128
|
|
601
|
+
},
|
|
602
|
+
"from": {
|
|
603
|
+
"type": "string"
|
|
604
|
+
},
|
|
605
|
+
"to": {
|
|
606
|
+
"type": "string"
|
|
607
|
+
}
|
|
608
|
+
},
|
|
609
|
+
"required": [
|
|
610
|
+
"kind",
|
|
611
|
+
"id"
|
|
612
|
+
],
|
|
613
|
+
"additionalProperties": false
|
|
614
|
+
}
|
|
615
|
+
```
|
|
616
|
+
|
|
564
617
|
## cancel_deployment
|
|
565
618
|
|
|
566
619
|
取消未激活部署。仅在用户授权且平台 recovery.cancelAllowed 为真时取消；激活后的运行不能取消。
|