openxiangda 2.7.0 → 2.7.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.
@@ -11,10 +11,10 @@ OpenXiangda 2.0 默认生成 React 应用和共享契约。普通 CRUD、标准
11
11
  以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
12
12
 
13
13
  ```bash
14
- pnpm dlx openxiangda@2.7.0 skill install --force
15
- pnpm dlx openxiangda@2.7.0 auth status --base-url <平台地址> --json
16
- pnpm dlx openxiangda@2.7.0 login --base-url https://platform.example.com
17
- pnpm dlx openxiangda@2.7.0 create my-app --base-url https://platform.example.com
14
+ pnpm dlx openxiangda@2.7.1 skill install --force
15
+ pnpm dlx openxiangda@2.7.1 auth status --base-url <平台地址> --json
16
+ pnpm dlx openxiangda@2.7.1 login --base-url https://platform.example.com
17
+ pnpm dlx openxiangda@2.7.1 create my-app --base-url https://platform.example.com
18
18
  cd my-app
19
19
  pnpm openxiangda context --json
20
20
  pnpm openxiangda dev
@@ -62,6 +62,8 @@ AppSpec 随开发持续维护:测试发布前补齐总纲、关联变更与验
62
62
 
63
63
  `dev` 监听本机回环地址,页面通过同源代理访问平台测试数据。浏览器不持久化平台凭据。终端和页面显示当前环境;只有生产环境时会持续提示生产数据风险。开发数据写入仍是远端真实写入,按任务范围操作。
64
64
 
65
+ 前端启动使用根目录 `dev:web`。声明了后端的应用同时运行配置的 `backend.root` 包内的 `dev`,无需增加根目录 `dev:server`;纯前端应用只启动 Web 和代理。已有前端测试版本后,可以启用本地 Nest 联调,不必先构建或发布后端镜像。平台返回的活动应用版本和开发会话绑定本次联调,环境版本变化导致会话不一致时,停止后重新运行 `dev`。
66
+
65
67
  纯 CRUD 修改优先使用标准模型、字段和页面;跨模型事务或外部副作用再选择后端。角色、行和字段权限在平台执行。详见[开发流程](./development.md)、[模型与标准 CRUD](./application-foundation.md)和[按需后端](./backend.md)。
66
68
 
67
69
  ## 应用源码
@@ -114,9 +116,9 @@ MCP 的 `docs_read` 可以读取本说明,当前没有独立的源码操作 MC
114
116
  无需本地工作区,使用本 Skill 随包精确版本或已安装的对应 CLI:
115
117
 
116
118
  ```bash
117
- pnpm dlx openxiangda@2.7.0 auth status --base-url <平台> --json
118
- pnpm dlx openxiangda@2.7.0 source resolve <仓库URL> --base-url <平台> --json
119
- pnpm dlx openxiangda@2.7.0 source clone <仓库URL> <新目录> --base-url <平台> --json
119
+ pnpm dlx openxiangda@2.7.1 auth status --base-url <平台> --json
120
+ pnpm dlx openxiangda@2.7.1 source resolve <仓库URL> --base-url <平台> --json
121
+ pnpm dlx openxiangda@2.7.1 source clone <仓库URL> <新目录> --base-url <平台> --json
120
122
  ```
121
123
 
122
124
  登录缺失或站点不匹配时,先按该平台执行 login。resolve 根据平台已经登记的绑定返回
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "schemaVersion": "openxiangda.documentation/v1",
3
- "version": "2.7.0",
3
+ "version": "2.7.1",
4
4
  "topics": [
5
5
  {
6
6
  "id": "getting-started",
7
7
  "title": "安装与开始开发",
8
8
  "file": "getting-started.md",
9
- "sha256": "86d4364e8778ae34285164c13ea19a9f290017398565aa186506283f026206cc"
9
+ "sha256": "8668f949027ccd891db011c8473d912264c53d767a3b1724aeeaffd85e21236e"
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.7.0",
3
+ "version": "2.7.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.2.9",
63
+ "openxiangda-cli": "2.2.10",
64
64
  "openxiangda-contracts": "2.5.0",
65
- "openxiangda-devkit-core": "2.4.1",
65
+ "openxiangda-devkit-core": "2.4.2",
66
66
  "openxiangda-legacy": "npm:openxiangda@1.0.268",
67
- "openxiangda-mcp": "2.0.7",
67
+ "openxiangda-mcp": "2.0.8",
68
68
  "openxiangda-nest": "2.1.0",
69
- "openxiangda-skill-kit": "2.0.11",
69
+ "openxiangda-skill-kit": "2.0.12",
70
70
  "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
71
71
  },
72
72
  "peerDependencies": {
@@ -132,40 +132,34 @@
132
132
  },
133
133
  "openxiangdaRelease": {
134
134
  "schemaVersion": "openxiangda.release-notes/v1",
135
- "version": "2.7.0",
136
- "title": "应用统一保护未保存内容",
135
+ "version": "2.7.1",
137
136
  "status": "reviewed",
138
- "summary": "自定义表单可注册未保存状态,应用统一处理站内跳转、浏览器历史和刷新关闭提示。",
139
- "newFeatures": [
140
- "增加 useUnsavedChangesGuard,聚合多个表单的未保存状态,取消导航保留输入和原位置,提交成功后解除保护。"
141
- ],
137
+ "title": "OpenXiangda 2.7.1:修复可选后端连接开发",
138
+ "summary": "连接开发按应用配置启动本地 Nest,绑定平台活动应用版本与开发会话,支持已激活前端应用首次启用本地后端。",
139
+ "newFeatures": [],
142
140
  "fixes": [
143
- "补齐原 BrowserRouter 无法使用标准 useBlocker 导致自定义表单浏览器前进后退未受保护的问题。"
141
+ "不再要求应用手动补根目录 dev:server;使用 backend.root 包内 dev 入口。纯前端应用不启动 Nest。",
142
+ "补齐本地 Nest 所需活动应用版本描述;本地修改的后端使用开发会话标签,不冒充已部署镜像。",
143
+ "开发会话目标发生变化时停止子进程并撤销原会话,防止环境与运行时身份不一致。"
144
144
  ],
145
145
  "affectedUsers": [
146
- "有自定义录入页面、异步提交或未知结果恢复的 V2 应用开发者。"
146
+ "使用 dev 连接平台测试环境的纯前端和按需 Nest 应用开发者。"
147
147
  ],
148
- "compatibility": {
149
- "node": ">=24",
150
- "workspaceGenerations": [
151
- "v1",
152
- "v2"
153
- ],
154
- "v1Policy": "V1 引擎和已有应用不变。",
155
- "platformPolicy": "公共 React 路由生命周期调整,无服务端契约或数据库变更;应用仍使用既有 Routes、Link 和 navigate。"
156
- },
157
148
  "upgradeSteps": [
158
- "精确升级到 openxiangda 2.7.0 并刷新技能资料。",
159
- "在应用入口内使用 useUnsavedChangesGuard,涵盖未保存内容和结果未知状态,验证成功后解除以及取消后的输入保留。"
149
+ "通过项目正式升级流程采用 openxiangda 2.7.1,刷新项目资料并重启旧 MCP 与 dev 进程。",
150
+ "保留根目录 dev:web,确认配置的后端包具有 dev 启动脚本。"
160
151
  ],
161
152
  "knownLimitations": [
162
- "原生刷新/关闭提示受浏览器限制,不能自定义提示文字。",
163
- "该能力不持久化草稿或代替原提交回执恢复;应用不得直接操作 history.pushState。",
164
- "包发布、应用部署与真实业务验收分别验证。"
153
+ "需要平台已有激活应用版本;联调数据写入仍发生在选定远端环境。",
154
+ "本次修复不改变线上应用制品或生产部署。"
165
155
  ],
156
+ "compatibility": {
157
+ "node": ">=24",
158
+ "platform": "支持 Application v2 开发会话及活动 AppVersion 的平台"
159
+ },
166
160
  "issues": [],
167
- "sha256": "e8af0fc7c484cad1dc59ce982432e6a2fd4451d7f455141edc2d6128a057542e",
168
- "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.7.0"
161
+ "sha256": "102d3bdfb8c717e3629dac9eac67eb37f9b50588fda3bf28c9c1930512f4bb75",
162
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.7.1"
169
163
  },
170
164
  "scripts": {
171
165
  "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",
@@ -0,0 +1,31 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.7.1",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.7.1:修复可选后端连接开发",
6
+ "summary": "连接开发按应用配置启动本地 Nest,绑定平台活动应用版本与开发会话,支持已激活前端应用首次启用本地后端。",
7
+ "newFeatures": [],
8
+ "fixes": [
9
+ "不再要求应用手动补根目录 dev:server;使用 backend.root 包内 dev 入口。纯前端应用不启动 Nest。",
10
+ "补齐本地 Nest 所需活动应用版本描述;本地修改的后端使用开发会话标签,不冒充已部署镜像。",
11
+ "开发会话目标发生变化时停止子进程并撤销原会话,防止环境与运行时身份不一致。"
12
+ ],
13
+ "affectedUsers": [
14
+ "使用 dev 连接平台测试环境的纯前端和按需 Nest 应用开发者。"
15
+ ],
16
+ "upgradeSteps": [
17
+ "通过项目正式升级流程采用 openxiangda 2.7.1,刷新项目资料并重启旧 MCP 与 dev 进程。",
18
+ "保留根目录 dev:web,确认配置的后端包具有 dev 启动脚本。"
19
+ ],
20
+ "knownLimitations": [
21
+ "需要平台已有激活应用版本;联调数据写入仍发生在选定远端环境。",
22
+ "本次修复不改变线上应用制品或生产部署。"
23
+ ],
24
+ "compatibility": {
25
+ "node": ">=24",
26
+ "platform": "支持 Application v2 开发会话及活动 AppVersion 的平台"
27
+ },
28
+ "issues": [],
29
+ "sha256": "102d3bdfb8c717e3629dac9eac67eb37f9b50588fda3bf28c9c1930512f4bb75",
30
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.7.1"
31
+ }
@@ -4,7 +4,7 @@
4
4
  {
5
5
  "name": "openxiangda-v2",
6
6
  "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发,通过对话发现模块、完成详细产品设计,再开发、检查和交付应用。维护 1.x 应用时使用对应的 1.x 技能。",
7
- "sha256": "76c31169ed695c8af811b9a7d42b10345cf3e4ea31c7cdce5986bbf20b1608df"
7
+ "sha256": "c0cfdaf454f9d737eb2f1c7e31887e868a976d2802e5f76ec5976858edb39df7"
8
8
  }
9
9
  ]
10
10
  }
@@ -18,10 +18,10 @@ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具
18
18
  未创建工作区时使用本 Skill 随根包发布的精确版本:
19
19
 
20
20
  ```bash
21
- pnpm dlx openxiangda@2.7.0 auth status --base-url <平台地址> --json
22
- pnpm dlx openxiangda@2.7.0 login --base-url <平台地址>
23
- pnpm dlx openxiangda@2.7.0 create <应用目录> --base-url <同一平台地址>
24
- pnpm dlx openxiangda@2.7.0 skill install --force
21
+ pnpm dlx openxiangda@2.7.1 auth status --base-url <平台地址> --json
22
+ pnpm dlx openxiangda@2.7.1 login --base-url <平台地址>
23
+ pnpm dlx openxiangda@2.7.1 create <应用目录> --base-url <同一平台地址>
24
+ pnpm dlx openxiangda@2.7.1 skill install --force
25
25
  ```
26
26
 
27
27
  创建前把产品要求的目标平台明确带入命令,不从旧登录态推断站点。已有工作区从原绑定恢复,平台不一致时先解决登录与目标,不改 link 文件跨站创建。
@@ -11,10 +11,10 @@ OpenXiangda 2.0 默认生成 React 应用和共享契约。普通 CRUD、标准
11
11
  以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
12
12
 
13
13
  ```bash
14
- pnpm dlx openxiangda@2.7.0 skill install --force
15
- pnpm dlx openxiangda@2.7.0 auth status --base-url <平台地址> --json
16
- pnpm dlx openxiangda@2.7.0 login --base-url https://platform.example.com
17
- pnpm dlx openxiangda@2.7.0 create my-app --base-url https://platform.example.com
14
+ pnpm dlx openxiangda@2.7.1 skill install --force
15
+ pnpm dlx openxiangda@2.7.1 auth status --base-url <平台地址> --json
16
+ pnpm dlx openxiangda@2.7.1 login --base-url https://platform.example.com
17
+ pnpm dlx openxiangda@2.7.1 create my-app --base-url https://platform.example.com
18
18
  cd my-app
19
19
  pnpm openxiangda context --json
20
20
  pnpm openxiangda dev
@@ -62,6 +62,8 @@ AppSpec 随开发持续维护:测试发布前补齐总纲、关联变更与验
62
62
 
63
63
  `dev` 监听本机回环地址,页面通过同源代理访问平台测试数据。浏览器不持久化平台凭据。终端和页面显示当前环境;只有生产环境时会持续提示生产数据风险。开发数据写入仍是远端真实写入,按任务范围操作。
64
64
 
65
+ 前端启动使用根目录 `dev:web`。声明了后端的应用同时运行配置的 `backend.root` 包内的 `dev`,无需增加根目录 `dev:server`;纯前端应用只启动 Web 和代理。已有前端测试版本后,可以启用本地 Nest 联调,不必先构建或发布后端镜像。平台返回的活动应用版本和开发会话绑定本次联调,环境版本变化导致会话不一致时,停止后重新运行 `dev`。
66
+
65
67
  纯 CRUD 修改优先使用标准模型、字段和页面;跨模型事务或外部副作用再选择后端。角色、行和字段权限在平台执行。详见[开发流程](development.md)、[模型与标准 CRUD](application-foundation.md)和[按需后端](backend.md)。
66
68
 
67
69
  ## 应用源码
@@ -114,9 +116,9 @@ MCP 的 `docs_read` 可以读取本说明,当前没有独立的源码操作 MC
114
116
  无需本地工作区,使用本 Skill 随包精确版本或已安装的对应 CLI:
115
117
 
116
118
  ```bash
117
- pnpm dlx openxiangda@2.7.0 auth status --base-url <平台> --json
118
- pnpm dlx openxiangda@2.7.0 source resolve <仓库URL> --base-url <平台> --json
119
- pnpm dlx openxiangda@2.7.0 source clone <仓库URL> <新目录> --base-url <平台> --json
119
+ pnpm dlx openxiangda@2.7.1 auth status --base-url <平台> --json
120
+ pnpm dlx openxiangda@2.7.1 source resolve <仓库URL> --base-url <平台> --json
121
+ pnpm dlx openxiangda@2.7.1 source clone <仓库URL> <新目录> --base-url <平台> --json
120
122
  ```
121
123
 
122
124
  登录缺失或站点不匹配时,先按该平台执行 login。resolve 根据平台已经登记的绑定返回