openxiangda 2.13.0 → 2.13.2
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/AGENTS.md +1 -0
- package/documentation/design-workflow.md +7 -5
- package/documentation/frontend.md +8 -0
- package/documentation/getting-started.md +7 -7
- package/documentation/manifest.json +5 -5
- package/documentation/product-design.md +1 -1
- package/package.json +14 -24
- package/releases/2.13.1.json +33 -0
- package/releases/2.13.2.json +31 -0
- package/skills/manifest.json +2 -2
- package/skills/openxiangda-v2/SKILL.md +26 -6
- package/skills/openxiangda-v2/references/design-workflow.md +7 -5
- package/skills/openxiangda-v2/references/frontend.md +8 -0
- package/skills/openxiangda-v2/references/getting-started.md +7 -7
- package/skills/openxiangda-v2/references/product-design.md +1 -1
package/documentation/AGENTS.md
CHANGED
|
@@ -9,6 +9,7 @@
|
|
|
9
9
|
- 当前用户、角色并集、数据授权和部署状态归平台；应用不保存凭据或授权快照。普通 CRUD 走 Data API，真实业务动作才按需启用 Nest。
|
|
10
10
|
- 标准业务字段使用 `openxiangda/field-kit`；PC 补充控件使用 antd，移动使用有作用域的 `openxiangda/mobile` 和 MobileSurface，不引入上游全局重置。
|
|
11
11
|
- 界面开发默认按 docs design-workflow 使用原版 OpenDesign 桌面和 design cli先设计整体视觉、可运行原型并实际走查，再实现。设备由真实任务决定；复用 Shell 导航事实、标准字段行为，通过 ui 和局部样式应用设计，不复制权限或导航状态。原型和 tokens 以 AppSpec assets 固定。模板 /home 不替代页面选型。
|
|
12
|
+
- 应用默认先建立并保留标准管理后台：后台 Shell、显式菜单、资源表单、数据列表、详情/编辑、权限和流程入口是应用骨架。OpenDesign 可优化后台外观但不能替换后台；用户端 PC 与移动端可分别使用 OpenDesign 的完整视觉和交互，通过 runtime/Data API 读取后台数据。禁止用单页 HTML、iframe 或独立假后台替代后台，发布前分别验收后台与用户端入口。
|
|
12
13
|
- 图表等专业交互先检查现有依赖并评估成熟组件/开源库，报表优先评估 ECharts，按需加载并释放实例；平台数据、权限与聚合仍通过官方能力。详见 docs frontend。
|
|
13
14
|
- 入口与导航验收从平台应用列表开始，检查应用根路径、后台首个有权菜单、登录返回及刷新深链接；不能只验证开发者给出的业务链接。
|
|
14
15
|
- 无账号表单读取 `docs public-access`，使用 frontend.publicAccess 和专用客户端；标准审批、通知和后端均按需启用。
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# OpenDesign 设计、原型与实现
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
有界面影响的新应用、页面或改版，默认由 **OpenXiangda 2.0 的 AI 工作流调用原版 OpenDesign CLI、Skill 和 MCP** 完成设计、原型、预览和修正，再在同一工作区交接到享搭实现业务。OpenDesign 客户端是可选预览器，不是用户必须操作的开发入口。享搭只提供安装发现、原生 CLI 透传和 Agent 接入边界；项目、模板、设计系统、插件、导出及更新都由 OpenDesign 管理。纯后端、文字校正等按影响沿用已有设计。
|
|
4
4
|
|
|
5
5
|
## 原版安装与完整 CLI {#native}
|
|
6
6
|
|
|
7
|
-
从[官方发行页](https://github.com/nexu-io/open-design/releases/latest)
|
|
7
|
+
从[官方发行页](https://github.com/nexu-io/open-design/releases/latest)安装原版运行时或 CLI。AI 工作流优先通过绝对路径 `OPENXIANGDA_OPENDESIGN_CLI`（也支持 `OD_BIN` 与 `OD_NODE_BIN`）调用原生 CLI；macOS 桌面自动发现 `/Applications/Open Design.app` 或 `~/Applications/Open Design.app` 仅用于可选预览。不要要求用户打开客户端，也不搜索 PATH 中的 `od`，避免调用操作系统的同名命令。当前桌面自动发现已在官方 macOS arm64 0.22.2 验证；其他平台使用显式入口，不声称已完成桌面验证。
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
10
|
pnpm openxiangda design open
|
|
@@ -20,9 +20,9 @@ pnpm openxiangda design cli mcp
|
|
|
20
20
|
|
|
21
21
|
`cli` 后面的参数、标准输入、输出、JSON、错误码和取消交给原版；享搭不维护上游命令白名单。查看每条原生命令的 `--help` 再执行当前需要的操作。原版 MCP 可直接接到支持 stdio 的 Agent，启动命令为 `openxiangda design cli mcp`；它与享搭平台 MCP 分别拥有设计项目和平台契约，不合并权限。
|
|
22
22
|
|
|
23
|
-
|
|
23
|
+
AI 通过 CLI/MCP 工作时使用原生 `OD_DAEMON_URL` 或原版自动发现的本地运行时；不需要先执行 `design open`。桌面版 sidecar 只在用户主动预览时使用。原版桌面文件导入等操作可能要求桌面授权上下文；AI 应保留原版错误并停止该步骤，不伪造 token 或改数据库。享搭不会在 npm 安装时下载桌面应用、自动修改 Agent 凭据或开启云付费功能。
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
AI Agent 通过原版 CLI/MCP 使用设计能力；模型和登录由原版及所选提供商管理。用户需要人工查看时才打开客户端。需要原版图像、视频、音频或云服务时按原版配置相应提供商。原生功能按其实际依赖可用，不把所有功能都描述为无需配置。
|
|
26
26
|
|
|
27
27
|
## 随包离线参考 {#resources}
|
|
28
28
|
|
|
@@ -41,6 +41,8 @@ pnpm openxiangda design cli mcp
|
|
|
41
41
|
|
|
42
42
|
按用户任务、业务材料和实际设备选择整体方向，包括导航形态、布局、层次、密度、字体、色彩、间距、组件与交互状态。已有“标准后台必须默认外观”“后台一律不设计移动”等审美和设备约定不再是限制。设备适用性由真实任务决定；不要机械增加没有用户任务的页面。
|
|
43
43
|
|
|
44
|
+
应用结构先于视觉改版：标准管理后台是默认骨架，必须保留平台 Shell、后台路由、显式菜单、资源表单、数据列表、权限和流程入口。OpenDesign 对后台只做布局、视觉和交互优化，不能用独立原型、单页 HTML 或 iframe 替换后台。用户端 PC 与移动端按真实旅程分别设计，可以完整采用 OpenDesign 的视觉与交互，但通过平台 runtime/Data API 连接后台数据，并保持与后台分离的权限和导航状态。设计交接时分别标记后台、用户端 PC、用户端移动端的页面归属和验收入口。
|
|
45
|
+
|
|
44
46
|
先复用 PC/移动 Field Kit 的输入、校验、上传、只读和权限行为。组件外观、布局及专业控件可据设计优化；换组件时证明字段值、未保存输入、拒绝和恢复行为仍正确。Shell 的路由、当前用户、授权菜单事实继续来自平台；`ui` 提供视觉参数，局部 CSS 可以编排布局，结构扩展应走平台支持的组件接口，不能复制导航状态。
|
|
45
47
|
|
|
46
48
|
上游模板的桌面/手机预览框、固定侧栏、虚构指标、限定图表库和示例品牌仅服务其示例。原文中的字体/颜色数量、渐变等规则用于评审设计理由，不能压过实际品牌、中文阅读或已确认任务。借鉴参考的可描述特征，不复制品牌素材或凭空声称业务事实。
|
|
@@ -50,7 +52,7 @@ pnpm openxiangda design cli mcp
|
|
|
50
52
|
## 从设计到真实页面 {#loop}
|
|
51
53
|
|
|
52
54
|
1. 从当前 AppSpec 和实际界面识别主任务、目标用户、设备、约束与已有证据。新方向给出有理由的推荐；实际有取舍时最多比较两个方向，已确认意图不重复问。
|
|
53
|
-
2.
|
|
55
|
+
2. AI 通过原版 CLI/MCP 创建或复用项目、选择模板/设计系统，提供任务与必要参考；工作目录由当前 OpenXiangda 工作区确定。使用原版工作流形成设计方向，保留上游的项目和资源结构；用户可选打开客户端查看。
|
|
54
56
|
3. 通过原版 Agent、项目和预览做可运行原型，关键任务能从入口走到完成。标明示例数据；覆盖适用的空、加载、失败、拒绝、校验、提交中和成功状态。真实业务请求尚未接入时明确说明。
|
|
55
57
|
4. 使用原版预览、lint、导出和修正能力；在目标尺寸实际打开、点击和键盘操作。证据记录实际 URL/文件、尺寸、操作与发现，没有浏览器证据就写未验证。不能用 AI 评分或勾选表代替画面和操作结果。
|
|
56
58
|
5. 依据已有授权和实际答复记录确认范围，固定设计文档和 assets 摘要。工具检查只证明资料与资源一致，不代表审美通过。
|
|
@@ -16,6 +16,14 @@
|
|
|
16
16
|
|
|
17
17
|
管理后台的设备范围按实际办理任务确定。数据管理、录入和报表复用平台 Shell 的路由与菜单事实，视觉依据[OpenDesign 工作流](./design-workflow.md)设计；存在手机办理任务时同步设计与验证。
|
|
18
18
|
|
|
19
|
+
### 应用骨架优先与 OpenDesign 页面边界
|
|
20
|
+
|
|
21
|
+
标准管理后台是每个业务应用的默认开发骨架，必须保留后台 Shell、显式菜单、资源表单、数据列表、详情/编辑、权限和流程入口。开发顺序先完成后台资源与契约，再实现用户端 PC/移动端；不能以用户端首页或设计原型替代后台。
|
|
22
|
+
|
|
23
|
+
OpenDesign 可以在标准后台内部优化布局、视觉和交互，但后台仍复用平台 Shell、导航、字段行为和权限。用户端 PC 与移动端可以分别采用 OpenDesign 的完整视觉和交互，通过平台 runtime/Data API 使用后台数据。禁止用单页 HTML、iframe 或自定义假后台替换标准后台，也不能把后台权限、导航状态复制到用户端。
|
|
24
|
+
|
|
25
|
+
发布前分别验证后台入口、表单、数据列表、流程入口和用户端 PC/移动端入口；没有完成后台骨架的应用不得发布。
|
|
26
|
+
|
|
19
27
|
| 任务 | 页面与组件起点 |
|
|
20
28
|
| --- | --- |
|
|
21
29
|
| 简单管理列表、表单、详情 | 显式标准 CRUD，复用平台字段行为并应用本应用设计 |
|
|
@@ -66,10 +66,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
|
|
|
66
66
|
以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
|
|
67
67
|
|
|
68
68
|
```bash
|
|
69
|
-
pnpm dlx openxiangda@2.13.
|
|
70
|
-
pnpm dlx openxiangda@2.13.
|
|
71
|
-
pnpm dlx openxiangda@2.13.
|
|
72
|
-
pnpm dlx openxiangda@2.13.
|
|
69
|
+
pnpm dlx openxiangda@2.13.2 skill install --force
|
|
70
|
+
pnpm dlx openxiangda@2.13.2 auth status --base-url <平台地址> --json
|
|
71
|
+
pnpm dlx openxiangda@2.13.2 login --cwd my-app --base-url https://platform.example.com
|
|
72
|
+
pnpm dlx openxiangda@2.13.2 create my-app --base-url https://platform.example.com
|
|
73
73
|
cd my-app
|
|
74
74
|
pnpm openxiangda context --json
|
|
75
75
|
pnpm openxiangda dev
|
|
@@ -171,9 +171,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
|
|
|
171
171
|
无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
|
|
172
172
|
|
|
173
173
|
```bash
|
|
174
|
-
pnpm dlx openxiangda@2.13.
|
|
175
|
-
pnpm dlx openxiangda@2.13.
|
|
176
|
-
pnpm dlx openxiangda@2.13.
|
|
174
|
+
pnpm dlx openxiangda@2.13.2 auth status --base-url <平台> --json
|
|
175
|
+
pnpm dlx openxiangda@2.13.2 source resolve <仓库URL> --base-url <平台> --json
|
|
176
|
+
pnpm dlx openxiangda@2.13.2 source clone <仓库URL> <新目录> --base-url <平台> --json
|
|
177
177
|
```
|
|
178
178
|
|
|
179
179
|
登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回
|
|
@@ -1,24 +1,24 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": "openxiangda.documentation/v1",
|
|
3
|
-
"version": "2.13.
|
|
3
|
+
"version": "2.13.2",
|
|
4
4
|
"topics": [
|
|
5
5
|
{
|
|
6
6
|
"id": "getting-started",
|
|
7
7
|
"title": "安装与开始开发",
|
|
8
8
|
"file": "getting-started.md",
|
|
9
|
-
"sha256": "
|
|
9
|
+
"sha256": "4e629c31807355c3adb20db19c8c18fb8a75c476ca497e29bef088d2d224f75e"
|
|
10
10
|
},
|
|
11
11
|
{
|
|
12
12
|
"id": "product-design",
|
|
13
13
|
"title": "对话发现与详细产品设计",
|
|
14
14
|
"file": "product-design.md",
|
|
15
|
-
"sha256": "
|
|
15
|
+
"sha256": "33ae57c972d5125687227063700db8a4bcf9792ab29f2df8934cb975dc13360d"
|
|
16
16
|
},
|
|
17
17
|
{
|
|
18
18
|
"id": "design-workflow",
|
|
19
19
|
"title": "OpenDesign 设计、原型与实现",
|
|
20
20
|
"file": "design-workflow.md",
|
|
21
|
-
"sha256": "
|
|
21
|
+
"sha256": "690a738df3c74eda573dd886994f2d3dfe3f534d31f37e50f788cf434c41ce2f"
|
|
22
22
|
},
|
|
23
23
|
{
|
|
24
24
|
"id": "opendesign-methods",
|
|
@@ -66,7 +66,7 @@
|
|
|
66
66
|
"id": "frontend",
|
|
67
67
|
"title": "页面与标准组件扩展",
|
|
68
68
|
"file": "frontend.md",
|
|
69
|
-
"sha256": "
|
|
69
|
+
"sha256": "30897a79272e979767ac16c0814f5eea79a67341797ee05287e56f93c31ecc0b"
|
|
70
70
|
},
|
|
71
71
|
{
|
|
72
72
|
"id": "field-components",
|
|
@@ -141,4 +141,4 @@ context 的 `readyForImplementation` 为真时才制定具体实现任务，把
|
|
|
141
141
|
- [Design OS，固定提交](https://github.com/buildermethods/design-os/tree/529dedb43bfec24b2cbb128f26dd8cbc6143f754)（MIT）。
|
|
142
142
|
- [Spec Kit，固定提交](https://github.com/github/spec-kit/tree/4a7341a93d944d6efe153b71da4a1adb9c2b578c)（MIT）。
|
|
143
143
|
|
|
144
|
-
|
|
144
|
+
有界面影响的工作默认由 AI 通过 design cli / 原版 MCP 使用 OpenDesign，完成可运行原型、浏览器修正及实现交接，见[设计工作流](./design-workflow.md)。客户端仅用于用户主动预览；原版运行时拥有完整设计资源和工作流，随包方法与 Craft 仅作离线参考。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "openxiangda",
|
|
3
|
-
"version": "2.13.
|
|
3
|
+
"version": "2.13.2",
|
|
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.4.
|
|
63
|
+
"openxiangda-cli": "2.4.2",
|
|
64
64
|
"openxiangda-contracts": "2.11.0",
|
|
65
65
|
"openxiangda-devkit-core": "2.9.0",
|
|
66
66
|
"openxiangda-legacy": "npm:openxiangda@1.0.269",
|
|
67
67
|
"openxiangda-mcp": "2.0.17",
|
|
68
68
|
"openxiangda-nest": "2.3.2",
|
|
69
|
-
"openxiangda-skill-kit": "2.1.
|
|
69
|
+
"openxiangda-skill-kit": "2.1.1",
|
|
70
70
|
"xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
|
|
71
71
|
},
|
|
72
72
|
"peerDependencies": {
|
|
@@ -132,35 +132,25 @@
|
|
|
132
132
|
},
|
|
133
133
|
"openxiangdaRelease": {
|
|
134
134
|
"schemaVersion": "openxiangda.release-notes/v1",
|
|
135
|
-
"version": "2.13.
|
|
135
|
+
"version": "2.13.2",
|
|
136
136
|
"status": "reviewed",
|
|
137
|
-
"title": "OpenXiangda 2.13.
|
|
138
|
-
"summary": "
|
|
137
|
+
"title": "OpenXiangda 2.13.2：管理后台优先规范同步",
|
|
138
|
+
"summary": "将标准管理后台优先和 OpenDesign 页面归属规则同步到统一包、CLI 与 Skill 包，确保新应用开发遵循同一应用结构。",
|
|
139
139
|
"newFeatures": [
|
|
140
|
-
"
|
|
141
|
-
"AppSpec assets 固定设计系统和原型依赖，评审与原测试提交的资源摘要可复核。",
|
|
142
|
-
"PC Provider 接收应用主题，弹层、消息及移动字段继承应用设计作用域。",
|
|
143
|
-
"同版 Skill、CLI docs 和平台 MCP 提供原版开发流程及精选 OpenDesign 离线参考。"
|
|
140
|
+
"统一包、CLI 和 Skill 包同步应用骨架与 OpenDesign 页面边界规范。"
|
|
144
141
|
],
|
|
145
142
|
"fixes": [
|
|
146
|
-
"
|
|
147
|
-
"防止原生 --cwd、--json 和 MCP 参数被享搭分发层截获，避免误运行系统同名 od。"
|
|
143
|
+
"防止用户端原型、单页 HTML 或 iframe 被误当作管理后台。"
|
|
148
144
|
],
|
|
149
145
|
"affectedUsers": [
|
|
150
|
-
"使用 OpenXiangda
|
|
151
|
-
"采用 AppSpec 原型资源评审或应用主题的 V2 工作区。"
|
|
146
|
+
"使用 OpenXiangda 2.0 创建应用和执行 AI 辅助开发的开发者。"
|
|
152
147
|
],
|
|
153
148
|
"upgradeSteps": [
|
|
154
|
-
"
|
|
155
|
-
"
|
|
156
|
-
"使用 design cli --help 查看完整原生命令；将实际采用的原型及依赖交接到 AppSpec assets 后验证业务实现。"
|
|
149
|
+
"升级 openxiangda、openxiangda-cli 和 openxiangda-skill-kit 到本版本。",
|
|
150
|
+
"刷新项目 Skill 后重新执行应用结构和入口验收。"
|
|
157
151
|
],
|
|
158
152
|
"knownLimitations": [
|
|
159
|
-
"
|
|
160
|
-
"npm 包不包含 OpenDesign 桌面二进制；原版更新、模型登录、云媒体和连接器按原版配置与权限使用。",
|
|
161
|
-
"原版桌面导入等受授权上下文保护的操作可能需要桌面选择目录；桥接不伪造 token。",
|
|
162
|
-
"设计资源检查最多 128 文件、单文件 2 MiB、总计 8 MiB；大媒体留在原版项目并导出有界审阅产物。",
|
|
163
|
-
"原型与包验证不代表生产应用已经部署或完成实际业务验收。"
|
|
153
|
+
"本版本更新规范和模板，不自动改造已有应用。"
|
|
164
154
|
],
|
|
165
155
|
"compatibility": {
|
|
166
156
|
"node": ">=24",
|
|
@@ -168,8 +158,8 @@
|
|
|
168
158
|
"v1": "保持独立 legacy-v1 引擎"
|
|
169
159
|
},
|
|
170
160
|
"issues": [],
|
|
171
|
-
"sha256": "
|
|
172
|
-
"url": "https://github.com/1377385356/openxiangda/releases/tag/v2.13.
|
|
161
|
+
"sha256": "8925c3252c55e2bec1d1cdf755151777650b3ac6f8b7c82576760761dca6a786",
|
|
162
|
+
"url": "https://github.com/1377385356/openxiangda/releases/tag/v2.13.2"
|
|
173
163
|
},
|
|
174
164
|
"scripts": {
|
|
175
165
|
"build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": "openxiangda.release-notes/v1",
|
|
3
|
+
"version": "2.13.1",
|
|
4
|
+
"status": "reviewed",
|
|
5
|
+
"title": "OpenXiangda 2.13.1：管理后台优先的应用结构规范",
|
|
6
|
+
"summary": "明确标准管理后台是 OpenXiangda 2.0 应用骨架，并规定 OpenDesign 在后台与用户端 PC/移动端的页面归属和交接边界。",
|
|
7
|
+
"newFeatures": [
|
|
8
|
+
"Skill、中文前端资料和 OpenDesign 工作流新增后台骨架优先规则。",
|
|
9
|
+
"新应用模板 AGENTS 明确后台、用户端 PC 和移动端的分层开发与验收入口。"
|
|
10
|
+
],
|
|
11
|
+
"fixes": [
|
|
12
|
+
"禁止使用单页 HTML、iframe 或独立假后台替代标准管理后台。"
|
|
13
|
+
],
|
|
14
|
+
"affectedUsers": [
|
|
15
|
+
"使用 OpenXiangda 2.0 创建应用、设计页面或维护应用模板的 AI 和开发者。"
|
|
16
|
+
],
|
|
17
|
+
"upgradeSteps": [
|
|
18
|
+
"升级 openxiangda 与 openxiangda-cli 到 2.13.1。",
|
|
19
|
+
"刷新项目 Skill，并按后台骨架优先规则重新检查页面归属和发布验收。"
|
|
20
|
+
],
|
|
21
|
+
"knownLimitations": [
|
|
22
|
+
"本版本只更新规范、模板和发布资料，不自动改造已有应用页面。",
|
|
23
|
+
"标准审批、通知和具体业务流程仍需按应用需求声明和验收。"
|
|
24
|
+
],
|
|
25
|
+
"compatibility": {
|
|
26
|
+
"node": ">=24",
|
|
27
|
+
"platform": "本轮不增加平台后端接口或数据库迁移要求",
|
|
28
|
+
"v1": "保持独立 legacy-v1 引擎"
|
|
29
|
+
},
|
|
30
|
+
"issues": [],
|
|
31
|
+
"sha256": "3be803becc123e1cfafd76b7e217c660a78d2e62f9d3cc7092c33872a1bf07b6",
|
|
32
|
+
"url": "https://github.com/1377385356/openxiangda/releases/tag/v2.13.1"
|
|
33
|
+
}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": "openxiangda.release-notes/v1",
|
|
3
|
+
"version": "2.13.2",
|
|
4
|
+
"status": "reviewed",
|
|
5
|
+
"title": "OpenXiangda 2.13.2：管理后台优先规范同步",
|
|
6
|
+
"summary": "将标准管理后台优先和 OpenDesign 页面归属规则同步到统一包、CLI 与 Skill 包，确保新应用开发遵循同一应用结构。",
|
|
7
|
+
"newFeatures": [
|
|
8
|
+
"统一包、CLI 和 Skill 包同步应用骨架与 OpenDesign 页面边界规范。"
|
|
9
|
+
],
|
|
10
|
+
"fixes": [
|
|
11
|
+
"防止用户端原型、单页 HTML 或 iframe 被误当作管理后台。"
|
|
12
|
+
],
|
|
13
|
+
"affectedUsers": [
|
|
14
|
+
"使用 OpenXiangda 2.0 创建应用和执行 AI 辅助开发的开发者。"
|
|
15
|
+
],
|
|
16
|
+
"upgradeSteps": [
|
|
17
|
+
"升级 openxiangda、openxiangda-cli 和 openxiangda-skill-kit 到本版本。",
|
|
18
|
+
"刷新项目 Skill 后重新执行应用结构和入口验收。"
|
|
19
|
+
],
|
|
20
|
+
"knownLimitations": [
|
|
21
|
+
"本版本更新规范和模板，不自动改造已有应用。"
|
|
22
|
+
],
|
|
23
|
+
"compatibility": {
|
|
24
|
+
"node": ">=24",
|
|
25
|
+
"platform": "本轮不增加平台后端接口或数据库迁移要求",
|
|
26
|
+
"v1": "保持独立 legacy-v1 引擎"
|
|
27
|
+
},
|
|
28
|
+
"issues": [],
|
|
29
|
+
"sha256": "8925c3252c55e2bec1d1cdf755151777650b3ac6f8b7c82576760761dca6a786",
|
|
30
|
+
"url": "https://github.com/1377385356/openxiangda/releases/tag/v2.13.2"
|
|
31
|
+
}
|
package/skills/manifest.json
CHANGED
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
"skills": [
|
|
4
4
|
{
|
|
5
5
|
"name": "openxiangda-v2",
|
|
6
|
-
"description": "使用 OpenXiangda 2.0
|
|
7
|
-
"sha256": "
|
|
6
|
+
"description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，由 AI 在工作区内调用 OpenDesign 原版 CLI/Skill/MCP 形成整体视觉与可运行原型，再开发、检查和交付应用。OpenDesign 客户端只作为可选预览器；维护 1.x 应用时使用对应的 1.x 技能。",
|
|
7
|
+
"sha256": "4f507df9b83bb721d7a21a53717cd732948bdf04de2e4ae190eff649961d1176"
|
|
8
8
|
}
|
|
9
9
|
]
|
|
10
10
|
}
|
|
@@ -1,10 +1,18 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: openxiangda-v2
|
|
3
|
-
description: 使用 OpenXiangda 2.0
|
|
3
|
+
description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，由 AI 在工作区内调用 OpenDesign 原版 CLI/Skill/MCP 形成整体视觉与可运行原型，再开发、检查和交付应用。OpenDesign 客户端只作为可选预览器；维护 1.x 应用时使用对应的 1.x 技能。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# OpenXiangda 2.0
|
|
7
7
|
|
|
8
|
+
## 应用结构基线（必须遵守）
|
|
9
|
+
|
|
10
|
+
每个业务应用默认先建立并保留标准管理后台。管理后台是应用骨架，承载资源模型、表单、数据列表、详情/编辑、权限和流程入口；AI 必须先从后台完成数据与契约，再实现用户端体验。不得因为制作用户端首页而删除、隐藏或替换后台 Shell、后台路由或显式菜单。
|
|
11
|
+
|
|
12
|
+
OpenDesign 按页面归属使用：后台页面可以用 OpenDesign 优化布局、视觉和交互，但必须复用平台后台 Shell、导航、字段行为和权限；用户端 PC 与移动端可以分别使用 OpenDesign 的完整视觉和交互，并通过平台 runtime/Data API 读取后台数据。不得用单页 HTML、iframe 或独立假后台冒充管理后台，也不得在用户端复制后台权限和导航状态。
|
|
13
|
+
|
|
14
|
+
设计、实现和发布验收必须分别核验管理后台入口、表单、数据列表、流程入口，以及用户端 PC/移动端入口。缺少标准管理后台的应用结构不完整，不能发布。
|
|
15
|
+
|
|
8
16
|
## 先理解任务
|
|
9
17
|
|
|
10
18
|
新应用或模糊业务想法先读[对话发现与产品设计](references/product-design.md)，从资料和真实流程主动提出模块建议，逐轮少量提问、复述确认并更新 AppSpec。完整首发的 PRD、旅程、逐页交互、视觉/原型、权限与架构形成权威基线后，才制定实施计划和编写业务实现。用户不知道模块时给出有理由的推荐和代价，不能把整套设计问题丢回用户。
|
|
@@ -13,17 +21,29 @@ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具
|
|
|
13
21
|
|
|
14
22
|
遇到已有 V1 项目时，先核实 V2 能力覆盖、项目是否仍在测试阶段和迁移成本；能力满足、仍在测试阶段且代价可控时，优先建议转用 V2。先做只读评估，再按项目确认详细设计、数据/流程映射、测试和回滚；迁移实施前的原项目维护仍使用匹配的 V1 引擎。
|
|
15
23
|
|
|
16
|
-
有界面影响的开发和改版默认读[OpenDesign 工作流](references/design-workflow.md)
|
|
24
|
+
有界面影响的开发和改版默认读[OpenDesign 工作流](references/design-workflow.md)，由 AI 在当前 OpenXiangda 工作区读取相关 Skill，并通过 `openxiangda design cli` 或原版 stdio MCP 自动完成设计方向、原型、lint、修正和产物交接；不要求用户打开或操作 OpenDesign 客户端。客户端只用于用户主动查看或人工预览。随包方法仅作离线参考，保留字段与权限行为，旧默认皮肤或设备偏好可按任务重新设计。设计与原型资源使用 AppSpec assets 固定；不把结构检查或示例数据当成实际验收。
|
|
25
|
+
|
|
26
|
+
## AI 自动设计与开发
|
|
27
|
+
|
|
28
|
+
AI 接到新应用、页面或改版任务时，在同一个 OpenXiangda 工作区内执行以下闭环，不把设计任务转交给用户操作客户端：
|
|
29
|
+
|
|
30
|
+
1. 读取本 Skill、`references/design-workflow.md` 和任务相关的 OpenDesign Skill；从当前 AppSpec、平台契约和用户材料确定页面、角色、设备与验收目标。
|
|
31
|
+
2. 用 `openxiangda design cli` 查询原版方向、模板、设计系统和插件；需要持续会话时启动 `openxiangda design cli mcp`，把原版设计工具接入当前 AI Agent。所有 CLI 参数、JSON、标准输入输出和取消都由原版处理。
|
|
32
|
+
3. 在任务工作区创建或复用原版项目，向原版 Agent 提交任务上下文，生成可运行原型；AI 自己读取文件、运行 lint/预览检查并按结果修正。
|
|
33
|
+
4. 将本轮实际采用的设计文件、token、原型和来源版本复制或导出到 `appspec/design`，然后继续生成 OpenXiangda 页面、字段和业务实现。设计产物与应用源码属于同一变更链，不要求用户在客户端中搬运文件。
|
|
34
|
+
5. 运行本项目的 check、浏览器和真实角色验收；只有实际证据通过后才进入部署流程。原型、示例数据或客户端截图不能替代业务验收。
|
|
35
|
+
|
|
36
|
+
如果原版 CLI 或 MCP 不可用，保留真实错误并停止依赖原版的设计步骤；可以继续不依赖设计运行时的只读分析，但不能伪造设计产物或把离线参考当成原版执行结果。
|
|
17
37
|
|
|
18
38
|
## 定位当前版本
|
|
19
39
|
|
|
20
40
|
未创建工作区时使用本 Skill 随根包发布的精确版本：
|
|
21
41
|
|
|
22
42
|
```bash
|
|
23
|
-
pnpm dlx openxiangda@2.13.
|
|
24
|
-
pnpm dlx openxiangda@2.13.
|
|
25
|
-
pnpm dlx openxiangda@2.13.
|
|
26
|
-
pnpm dlx openxiangda@2.13.
|
|
43
|
+
pnpm dlx openxiangda@2.13.2 auth status --cwd <应用目录> --base-url <平台地址> --json
|
|
44
|
+
pnpm dlx openxiangda@2.13.2 login --cwd <应用目录> --base-url <平台地址>
|
|
45
|
+
pnpm dlx openxiangda@2.13.2 create <应用目录> --base-url <同一平台地址>
|
|
46
|
+
pnpm dlx openxiangda@2.13.2 skill install --force
|
|
27
47
|
```
|
|
28
48
|
|
|
29
49
|
创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# OpenDesign 设计、原型与实现
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
有界面影响的新应用、页面或改版，默认由 **OpenXiangda 2.0 的 AI 工作流调用原版 OpenDesign CLI、Skill 和 MCP** 完成设计、原型、预览和修正，再在同一工作区交接到享搭实现业务。OpenDesign 客户端是可选预览器，不是用户必须操作的开发入口。享搭只提供安装发现、原生 CLI 透传和 Agent 接入边界；项目、模板、设计系统、插件、导出及更新都由 OpenDesign 管理。纯后端、文字校正等按影响沿用已有设计。
|
|
4
4
|
|
|
5
5
|
## 原版安装与完整 CLI {#native}
|
|
6
6
|
|
|
7
|
-
从[官方发行页](https://github.com/nexu-io/open-design/releases/latest)
|
|
7
|
+
从[官方发行页](https://github.com/nexu-io/open-design/releases/latest)安装原版运行时或 CLI。AI 工作流优先通过绝对路径 `OPENXIANGDA_OPENDESIGN_CLI`（也支持 `OD_BIN` 与 `OD_NODE_BIN`）调用原生 CLI；macOS 桌面自动发现 `/Applications/Open Design.app` 或 `~/Applications/Open Design.app` 仅用于可选预览。不要要求用户打开客户端，也不搜索 PATH 中的 `od`，避免调用操作系统的同名命令。当前桌面自动发现已在官方 macOS arm64 0.22.2 验证；其他平台使用显式入口，不声称已完成桌面验证。
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
10
|
pnpm openxiangda design open
|
|
@@ -20,9 +20,9 @@ pnpm openxiangda design cli mcp
|
|
|
20
20
|
|
|
21
21
|
`cli` 后面的参数、标准输入、输出、JSON、错误码和取消交给原版；享搭不维护上游命令白名单。查看每条原生命令的 `--help` 再执行当前需要的操作。原版 MCP 可直接接到支持 stdio 的 Agent，启动命令为 `openxiangda design cli mcp`；它与享搭平台 MCP 分别拥有设计项目和平台契约，不合并权限。
|
|
22
22
|
|
|
23
|
-
|
|
23
|
+
AI 通过 CLI/MCP 工作时使用原生 `OD_DAEMON_URL` 或原版自动发现的本地运行时；不需要先执行 `design open`。桌面版 sidecar 只在用户主动预览时使用。原版桌面文件导入等操作可能要求桌面授权上下文；AI 应保留原版错误并停止该步骤，不伪造 token 或改数据库。享搭不会在 npm 安装时下载桌面应用、自动修改 Agent 凭据或开启云付费功能。
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
AI Agent 通过原版 CLI/MCP 使用设计能力；模型和登录由原版及所选提供商管理。用户需要人工查看时才打开客户端。需要原版图像、视频、音频或云服务时按原版配置相应提供商。原生功能按其实际依赖可用，不把所有功能都描述为无需配置。
|
|
26
26
|
|
|
27
27
|
## 随包离线参考 {#resources}
|
|
28
28
|
|
|
@@ -41,6 +41,8 @@ pnpm openxiangda design cli mcp
|
|
|
41
41
|
|
|
42
42
|
按用户任务、业务材料和实际设备选择整体方向，包括导航形态、布局、层次、密度、字体、色彩、间距、组件与交互状态。已有“标准后台必须默认外观”“后台一律不设计移动”等审美和设备约定不再是限制。设备适用性由真实任务决定；不要机械增加没有用户任务的页面。
|
|
43
43
|
|
|
44
|
+
应用结构先于视觉改版：标准管理后台是默认骨架，必须保留平台 Shell、后台路由、显式菜单、资源表单、数据列表、权限和流程入口。OpenDesign 对后台只做布局、视觉和交互优化，不能用独立原型、单页 HTML 或 iframe 替换后台。用户端 PC 与移动端按真实旅程分别设计，可以完整采用 OpenDesign 的视觉与交互，但通过平台 runtime/Data API 连接后台数据，并保持与后台分离的权限和导航状态。设计交接时分别标记后台、用户端 PC、用户端移动端的页面归属和验收入口。
|
|
45
|
+
|
|
44
46
|
先复用 PC/移动 Field Kit 的输入、校验、上传、只读和权限行为。组件外观、布局及专业控件可据设计优化；换组件时证明字段值、未保存输入、拒绝和恢复行为仍正确。Shell 的路由、当前用户、授权菜单事实继续来自平台；`ui` 提供视觉参数，局部 CSS 可以编排布局，结构扩展应走平台支持的组件接口，不能复制导航状态。
|
|
45
47
|
|
|
46
48
|
上游模板的桌面/手机预览框、固定侧栏、虚构指标、限定图表库和示例品牌仅服务其示例。原文中的字体/颜色数量、渐变等规则用于评审设计理由，不能压过实际品牌、中文阅读或已确认任务。借鉴参考的可描述特征，不复制品牌素材或凭空声称业务事实。
|
|
@@ -50,7 +52,7 @@ pnpm openxiangda design cli mcp
|
|
|
50
52
|
## 从设计到真实页面 {#loop}
|
|
51
53
|
|
|
52
54
|
1. 从当前 AppSpec 和实际界面识别主任务、目标用户、设备、约束与已有证据。新方向给出有理由的推荐；实际有取舍时最多比较两个方向，已确认意图不重复问。
|
|
53
|
-
2.
|
|
55
|
+
2. AI 通过原版 CLI/MCP 创建或复用项目、选择模板/设计系统，提供任务与必要参考；工作目录由当前 OpenXiangda 工作区确定。使用原版工作流形成设计方向，保留上游的项目和资源结构；用户可选打开客户端查看。
|
|
54
56
|
3. 通过原版 Agent、项目和预览做可运行原型，关键任务能从入口走到完成。标明示例数据；覆盖适用的空、加载、失败、拒绝、校验、提交中和成功状态。真实业务请求尚未接入时明确说明。
|
|
55
57
|
4. 使用原版预览、lint、导出和修正能力；在目标尺寸实际打开、点击和键盘操作。证据记录实际 URL/文件、尺寸、操作与发现，没有浏览器证据就写未验证。不能用 AI 评分或勾选表代替画面和操作结果。
|
|
56
58
|
5. 依据已有授权和实际答复记录确认范围，固定设计文档和 assets 摘要。工具检查只证明资料与资源一致，不代表审美通过。
|
|
@@ -16,6 +16,14 @@
|
|
|
16
16
|
|
|
17
17
|
管理后台的设备范围按实际办理任务确定。数据管理、录入和报表复用平台 Shell 的路由与菜单事实，视觉依据[OpenDesign 工作流](design-workflow.md)设计；存在手机办理任务时同步设计与验证。
|
|
18
18
|
|
|
19
|
+
### 应用骨架优先与 OpenDesign 页面边界
|
|
20
|
+
|
|
21
|
+
标准管理后台是每个业务应用的默认开发骨架，必须保留后台 Shell、显式菜单、资源表单、数据列表、详情/编辑、权限和流程入口。开发顺序先完成后台资源与契约，再实现用户端 PC/移动端；不能以用户端首页或设计原型替代后台。
|
|
22
|
+
|
|
23
|
+
OpenDesign 可以在标准后台内部优化布局、视觉和交互，但后台仍复用平台 Shell、导航、字段行为和权限。用户端 PC 与移动端可以分别采用 OpenDesign 的完整视觉和交互，通过平台 runtime/Data API 使用后台数据。禁止用单页 HTML、iframe 或自定义假后台替换标准后台，也不能把后台权限、导航状态复制到用户端。
|
|
24
|
+
|
|
25
|
+
发布前分别验证后台入口、表单、数据列表、流程入口和用户端 PC/移动端入口；没有完成后台骨架的应用不得发布。
|
|
26
|
+
|
|
19
27
|
| 任务 | 页面与组件起点 |
|
|
20
28
|
| --- | --- |
|
|
21
29
|
| 简单管理列表、表单、详情 | 显式标准 CRUD，复用平台字段行为并应用本应用设计 |
|
|
@@ -66,10 +66,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
|
|
|
66
66
|
以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
|
|
67
67
|
|
|
68
68
|
```bash
|
|
69
|
-
pnpm dlx openxiangda@2.13.
|
|
70
|
-
pnpm dlx openxiangda@2.13.
|
|
71
|
-
pnpm dlx openxiangda@2.13.
|
|
72
|
-
pnpm dlx openxiangda@2.13.
|
|
69
|
+
pnpm dlx openxiangda@2.13.2 skill install --force
|
|
70
|
+
pnpm dlx openxiangda@2.13.2 auth status --base-url <平台地址> --json
|
|
71
|
+
pnpm dlx openxiangda@2.13.2 login --cwd my-app --base-url https://platform.example.com
|
|
72
|
+
pnpm dlx openxiangda@2.13.2 create my-app --base-url https://platform.example.com
|
|
73
73
|
cd my-app
|
|
74
74
|
pnpm openxiangda context --json
|
|
75
75
|
pnpm openxiangda dev
|
|
@@ -171,9 +171,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
|
|
|
171
171
|
无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
|
|
172
172
|
|
|
173
173
|
```bash
|
|
174
|
-
pnpm dlx openxiangda@2.13.
|
|
175
|
-
pnpm dlx openxiangda@2.13.
|
|
176
|
-
pnpm dlx openxiangda@2.13.
|
|
174
|
+
pnpm dlx openxiangda@2.13.2 auth status --base-url <平台> --json
|
|
175
|
+
pnpm dlx openxiangda@2.13.2 source resolve <仓库URL> --base-url <平台> --json
|
|
176
|
+
pnpm dlx openxiangda@2.13.2 source clone <仓库URL> <新目录> --base-url <平台> --json
|
|
177
177
|
```
|
|
178
178
|
|
|
179
179
|
登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回
|
|
@@ -141,4 +141,4 @@ context 的 `readyForImplementation` 为真时才制定具体实现任务，把
|
|
|
141
141
|
- [Design OS，固定提交](https://github.com/buildermethods/design-os/tree/529dedb43bfec24b2cbb128f26dd8cbc6143f754)（MIT）。
|
|
142
142
|
- [Spec Kit，固定提交](https://github.com/github/spec-kit/tree/4a7341a93d944d6efe153b71da4a1adb9c2b578c)（MIT）。
|
|
143
143
|
|
|
144
|
-
|
|
144
|
+
有界面影响的工作默认由 AI 通过 design cli / 原版 MCP 使用 OpenDesign，完成可运行原型、浏览器修正及实现交接，见[设计工作流](design-workflow.md)。客户端仅用于用户主动预览；原版运行时拥有完整设计资源和工作流，随包方法与 Craft 仅作离线参考。
|