openxiangda-skill-kit 2.0.20 → 2.1.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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openxiangda-skill-kit",
3
- "version": "2.0.20",
3
+ "version": "2.1.0",
4
4
  "description": "OpenXiangda 2.0 中文 AI 技能的校验、分发与安装。",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -17,7 +17,7 @@
17
17
  "README.md"
18
18
  ],
19
19
  "dependencies": {
20
- "openxiangda-devkit-core": "2.8.0"
20
+ "openxiangda-devkit-core": "2.9.0"
21
21
  },
22
22
  "devDependencies": {
23
23
  "tsx": "4.23.12",
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: openxiangda-v2
3
- description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发,通过对话发现模块、完成详细产品设计,再开发、检查和交付应用。维护 1.x 应用时使用对应的 1.x 技能。
3
+ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发,通过对话发现模块、完成详细产品设计,使用原版 OpenDesign 桌面和 CLI形成整体视觉与可运行原型,再开发、检查和交付应用。维护 1.x 应用时使用对应的 1.x 技能。
4
4
  ---
5
5
 
6
6
  # OpenXiangda 2.0
@@ -13,6 +13,8 @@ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具
13
13
 
14
14
  遇到已有 V1 项目时,先核实 V2 能力覆盖、项目是否仍在测试阶段和迁移成本;能力满足、仍在测试阶段且代价可控时,优先建议转用 V2。先做只读评估,再按项目确认详细设计、数据/流程映射、测试和回滚;迁移实施前的原项目维护仍使用匹配的 V1 引擎。
15
15
 
16
+ 有界面影响的开发和改版默认读[OpenDesign 工作流](references/design-workflow.md),使用 `openxiangda design open` 和 `design cli` 直接调用原版,随包方法仅作离线参考,形成设计包、可运行原型、浏览器修正和实现交接。保留字段与权限行为,旧默认皮肤或设备偏好可按任务重新设计。设计与原型资源使用 AppSpec assets 固定;不把结构检查或示例数据当成实际验收。
17
+
16
18
  ## 定位当前版本
17
19
 
18
20
  未创建工作区时使用本 Skill 随根包发布的精确版本:
@@ -39,6 +41,7 @@ pnpm dlx openxiangda@__OPENXIANGDA_VERSION__ skill install --force
39
41
  | 安装、登录、创建、连接开发 | [开始开发](references/getting-started.md) |
40
42
  | 源码仓库、换电脑、旧项目导入、提交推送与重试 | [应用源码](references/getting-started.md#应用源码);先用 `source status` 读取实际绑定 |
41
43
  | 模糊想法、模块发现、PRD、权限与架构设计 | [产品设计](references/product-design.md)、[交互模式](references/interaction-patterns.md) |
44
+ | 界面设计、改版、原型和视觉修正 | 先读[设计工作流](references/design-workflow.md),使用 `openxiangda design open` 和 `design cli` 调用原版;[离线方法](references/opendesign-methods.md)与[设计 Craft](references/design-craft.md)仅作补充 |
42
45
  | 理解需求与选择能力 | [开发流程](references/development.md)、[架构](references/concepts.md) |
43
46
  | 模型、CRUD、字段与移动表单 | [业务模块](references/application-foundation.md)、[字段](references/field-components.md) |
44
47
  | 图片压缩、缩略图、附件和缓存 | [图片与附件读取](references/field-components.md#图片缩略图和附件读取):卡片优先缩略图,原图按需,使用平台权限与缓存规则 |
@@ -56,7 +59,7 @@ pnpm dlx openxiangda@__OPENXIANGDA_VERSION__ skill install --force
56
59
 
57
60
  ## 引导开发并持续记录
58
61
 
59
- 先选择页面归属:管理后台默认只面向 PC,普通管理/录入复用标准 CRUD Shell,自定义报表和工具使用 admin React 页面及显式菜单;不因“自定义”就复制导航或改成 user 页面,也不为后台自动补移动适配。独立用户页与手机用户任务按实际需求设计,模板 `/home` 仅是占位。报表等专业交互主动检查已有依赖、评估成熟组件和开源库,图表优先评估 ECharts,记录选型理由及加载/销毁边界;细节见[前端](references/frontend.md)。交付需验证平台实际点击入口、根路径、后台菜单和登录返回,不能只验收直达业务链接。
62
+ 先选择页面归属:按真实任务选择设备;普通管理/录入复用标准 CRUD 的字段行为与 Shell 的导航事实,自定义报表和工具使用 admin React 页面及显式菜单。通过本应用设计和受支持视觉输入完善布局外观,不复制权限或导航状态。独立用户页与手机用户任务按实际需求设计,模板 `/home` 仅是占位。报表等专业交互主动检查已有依赖、评估成熟组件和开源库,图表优先评估 ECharts,记录选型理由及加载/销毁边界;细节见[前端](references/frontend.md)。交付需验证平台实际点击入口、根路径、后台菜单和登录返回,不能只验收直达业务链接。
60
63
 
61
64
  每轮先读取当前 AppSpec 总纲、设计索引、相关能力、活动变更与契约,按稳定 ID 恢复已知事实、候选建议和未决项。设计文件相互引用而不重复定义规则;角色、权限、页面或入口范围改变时,同步受影响 PRD、旅程、交互、架构和 AC。具体工作法按需读取[产品设计](references/product-design.md)。
62
65
 
@@ -138,7 +138,7 @@ import 'openxiangda/mobile/styles.css';
138
138
  </MobileSurface>
139
139
  ```
140
140
 
141
- 平台按需加载移动组件,并在构建时限定上游基础样式的作用范围。此入口的 `Popup`、`Picker`、`DatePicker` 默认保留在当前页面中,保留组件样式作用范围。已有 `openxiangda/react/styles.css` 包含移动字段样式,不必重复导入。不要直接引入 `antd-mobile` 根入口,它会重置全页字体和链接。平台统一使用组件库默认外观,不再提供配色配置或外观偏好。
141
+ 平台按需加载移动组件,并在构建时限定上游基础样式的作用范围。此入口的 `Popup`、`Picker`、`DatePicker` 默认保留在当前页面中,保留组件样式作用范围。已有 `openxiangda/react/styles.css` 包含移动字段样式,不必重复导入。不要直接引入 `antd-mobile` 根入口,它会重置全页字体和链接。应用通过设计包、ui 视觉参数和 MobileSurface 内变量应用已确认视觉;平台不维护第二套配色偏好状态,详见[设计工作流](design-workflow.md)。
142
142
 
143
143
  `openxiangda check` 检查应用前端 `src/` 中的原生录入元素。移动入口使用 `src/mobile/`、`Mobile*.tsx` 或 `*.mobile.tsx`,并检查其本地静态依赖;这是明确的源码约定,不是运行时授权或对动态代码的安全证明。平台组件内部的原生 DOM 不受应用规则限制。
144
144
 
@@ -7,6 +7,7 @@
7
7
  | `pnpm openxiangda auth` | 只读 | 只读核验指定平台授权,不登录或刷新会话 |
8
8
  | `pnpm openxiangda context` | 只读 | 只读查看工作区、版本与平台绑定 |
9
9
  | `pnpm openxiangda docs` | 只读 | 按主题和章节读取当前版本中文资料 |
10
+ | `pnpm openxiangda design` | 远端变更 | 打开 OpenDesign 原版并透传完整原生 CLI;写入范围由原生命令决定 |
10
11
  | `pnpm openxiangda admin` | 只读 | 只读查看应用管理能力和流程节点运行配置 |
11
12
  | `pnpm openxiangda create` | 远端变更 | 创建、绑定并初始化应用 |
12
13
  | `pnpm openxiangda source` | 远端变更 | 配置应用源码仓库、查看状态或提交推送 |