openxiangda 2.11.0 → 2.13.0

package/documentation/product-design.md

@@ -64,9 +64,11 @@ AppSpec 是唯一设计记录位置。`app.md` 是总纲与目录，详细规则
 
 页面必须记录初始加载、刷新、首次空数据、筛选无结果、错误、无权限、提交中、成功、明确失败、结果未知及并发冲突的适用性。公共状态可引用共用设计，逐页写差异；不适用时写具体理由。详细逐页检查与标准方案见[交互模式](./interaction-patterns.md)。
 
+页面规格依据真实用户任务说明设备范围；不以历史后台 PC 约定限制必要移动任务，也不为材料完整度增加没有使用场景的页面。页面设计同时选择标准 CRUD、后台自定义页或独立 user 页；报表等专业交互应主动评估成熟组件与开源库，按[前端选型](./frontend.md#component-selection)记录选择与理由。
+
 ## AppSpec 材料模板 {#templates}
 
-应用资料放在 `product/`（来源与 PRD）、`experience/`（旅程和逐页规格）、`design/`（视觉、权限和架构）、`reviews/`（评审）下。它们都是 `appspec/` 内单层 Markdown；不要使用嵌套页面目录。只为实际需要的材料建文件，不复制一批“已确认”示例。
+应用资料放在 `product/`（来源与 PRD）、`experience/`（旅程和逐页规格）、`design/`（视觉、权限和架构）、`reviews/`（评审）下。AppSpec 记录仍用这些目录内单层 Markdown；视觉设计包和自包含原型放在 `design/system`、`design/prototypes` 下，通过 assets 纳入评审，详见[设计工作流](./design-workflow.md)。只为实际需要的材料建文件，不复制一批“已确认”示例。
 
 设计文件采用下面的受限 YAML；按实际类型和稳定 ID 修改。`documents` 引用本文件依赖的其他设计、总纲、CAP 或 ADR，不能引用 ChangeSpec 形成计划与基线循环。正文保存详细设计；来源可在正文引用脱敏文件或 HTTPS 链接。
 
@@ -139,4 +141,4 @@ context 的 `readyForImplementation` 为真时才制定具体实现任务，把
 - [Design OS，固定提交](https://github.com/buildermethods/design-os/tree/529dedb43bfec24b2cbb128f26dd8cbc6143f754)（MIT）。
 - [Spec Kit，固定提交](https://github.com/github/spec-kit/tree/4a7341a93d944d6efe153b71da4a1adb9c2b578c)（MIT）。
 
-视觉收敛与体验检查可参考 [Impeccable](https://github.com/pbakaus/impeccable/tree/831cabee8b4bc1a2b66e5ae22003e9a19b57d464) 与 [DESIGN.md](https://github.com/google-labs-code/design.md/tree/9bf8eae67128b6cc55ad9bf86665767deb4c11cd) 的方法（Apache-2.0）。本专题不承诺这些项目的当前版本或排名，也不因案例要求增加平台功能。
+有界面影响的工作默认通过 design open / design cli 使用原版 OpenDesign，完成可运行原型、浏览器修正及实现交接，见[设计工作流](./design-workflow.md)。原版运行时拥有完整设计资源和工作流；随包方法与 Craft 仅作离线参考。

package/documentation/reference/cli.md

@@ -7,6 +7,7 @@
 | `pnpm openxiangda auth` | 只读 | 只读核验指定平台授权，不登录或刷新会话 |
 | `pnpm openxiangda context` | 只读 | 只读查看工作区、版本与平台绑定 |
 | `pnpm openxiangda docs` | 只读 | 按主题和章节读取当前版本中文资料 |
+| `pnpm openxiangda design` | 远端变更 | 打开 OpenDesign 原版并透传完整原生 CLI；写入范围由原生命令决定 |
 | `pnpm openxiangda admin` | 只读 | 只读查看应用管理能力和流程节点运行配置 |
 | `pnpm openxiangda create` | 远端变更 | 创建、绑定并初始化应用 |
 | `pnpm openxiangda source` | 远端变更 | 配置应用源码仓库、查看状态或提交推送 |

package/documentation/testing.md

@@ -28,7 +28,9 @@ CI、离线开发或尚未发布的候选包使用 `pnpm openxiangda check --loc
 
 Web 默认保留开发服务回环访问检查。按需 Nest 使用 `tsx --test` 发现项目中的业务测试；没有用例时只有零项测试，不能当成业务已验收。浏览器目录 `apps/web/e2e/` 起初只有编写说明，添加本应用的 `*.spec.ts` 后运行 `pnpm test:e2e`；真实角色验收绑定 AppSpec 和指定测试版本。
 
-修改资源时验证声明、PC/移动字段语义及受影响的新增、详情、修改、删除、筛选、导出和版本冲突。用允许角色验证成功，用禁止角色验证页面、操作、行和字段边界；存储值及审计应符合声明。平台内部的数据库和性能回归由平台维护者负责，应用不重复搭建平台数据库测试。
+修改资源时验证声明、实际交付端的字段语义及受影响的新增、详情、修改、删除、筛选、导出和版本冲突。按实际设计的目标设备验证交互；存在移动办理任务时验证对应移动页面，不受历史后台 PC 约定限制。用允许角色验证成功，用禁止角色验证页面、操作、行和字段边界；存储值及审计应符合声明。平台内部的数据库和性能回归由平台维护者负责，应用不重复搭建平台数据库测试。
+
+应用入口或导航变更必须从平台应用列表实际点击进入，再验证应用根路径、登录返回和刷新后的深链接。使用后台的应用检查 `/admin` 进入首个有权菜单、自定义页只出现一个 Shell、菜单切换与未保存保护、无权限拒绝；纯用户应用验证其声明首页，不强制增加后台。直达开发者给出的 `/home` 或报表链接通过，不能替代平台实际入口验收。
 
 只改文案时验证受影响页面。复杂事务、并发和值转换使用聚焦测试。浏览器验收实际操作并检查错误，不能用模拟响应或空页面加载代替真实角色验收。
 

package/documentation/workflow-events.md

@@ -18,6 +18,46 @@
 权限、记录修订约束、文件引用、日期触发和流程命令继续生效，自定义 `emitEvent`
 也不受该策略影响。策略通过正常应用版本发布、测试和生产晋级生效。
 
+## 平台原生数据自动化
+
+只涉及平台表单数据增删改的自动化，可以直接声明 `execution`，无需应用 Nest
+服务和事件 HTTP 接收器。需要平台 `events.native-data-actions` 1.0.0 能力。
+例如已声明 `items`、`copies` 模型及相应字段后：
+
+```ts
+events: {
+  capturePolicies: [
+    { resourceCode: 'items', mode: 'subscribed' },
+    { resourceCode: 'copies', mode: 'subscribed' },
+  ],
+  subscriptions: [{
+    code: 'copy-item',
+    eventTypes: ['openxiangda.data.record.created.v2'],
+    filter: { resourceCodes: ['items'] },
+    execution: {
+      kind: 'native-data', version: 1,
+      operations: [{
+        operation: 'create', resourceCode: 'copies',
+        data: {
+          name: { source: 'event', path: 'data.projection.name' },
+          sourceId: { source: 'event', path: 'data.recordId' },
+        },
+      }],
+    },
+  }],
+},
+```
+
+编译器自动收集必需的事件字段并固定目标资源摘要。动作效果与执行结果同事务
+提交，重复消息和人工重放使用同一个效果标记。更新、删除还必须映射 `id` 和
+`expectedRevision`，冲突不会覆盖新数据。常量使用 `{ source: 'literal', value }`。
+首版支持数据事件、明确的源资源、最多 16 个操作、每次最多 32 个映射字段和
+64 KiB 输入，不执行脚本、SQL、HTTP 或应用代码。目标模型发生不兼容变化时停止
+旧动作并报告错误；关闭并排空此类动作后才能回退到不支持该能力的平台镜像。
+
+外部 Webhook 和自定义代码仍使用已有签名、回执、重试及接收端幂等协议，按至少
+一次投递处理。轻量操作历史仍通过已有审计 API 查询，不依赖是否订阅了事件。
+
 ## 标准详情与当前用户入口
 
 普通记录、流程记录、任务和实例复用同一详情框架。流程详情提供申请内容、审批历史和变更记录三个标签页；管理员在当前抽屉或页面中切换到普通表单编辑，直接保存并自动留下变更记录，审批结果保持不变。PC 子表在表格内编辑，父表提交时统一校验。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "2.11.0",
+  "version": "2.13.0",
   "description": "OpenXiangda 2.0 的统一命令、应用 SDK、MCP 与中文 AI 技能资料。",
   "type": "module",
   "main": "./dist/index.js",
@@ -60,13 +60,13 @@
     "antd-mobile": "5.42.3",
     "dayjs": "1.11.18",
     "docx-preview": "0.3.7",
-    "openxiangda-cli": "2.3.0",
-    "openxiangda-contracts": "2.10.0",
-    "openxiangda-devkit-core": "2.7.0",
+    "openxiangda-cli": "2.4.0",
+    "openxiangda-contracts": "2.11.0",
+    "openxiangda-devkit-core": "2.9.0",
     "openxiangda-legacy": "npm:openxiangda@1.0.269",
-    "openxiangda-mcp": "2.0.15",
-    "openxiangda-nest": "2.3.1",
-    "openxiangda-skill-kit": "2.0.19",
+    "openxiangda-mcp": "2.0.17",
+    "openxiangda-nest": "2.3.2",
+    "openxiangda-skill-kit": "2.1.0",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
   },
   "peerDependencies": {
@@ -132,44 +132,44 @@
   },
   "openxiangdaRelease": {
     "schemaVersion": "openxiangda.release-notes/v1",
-    "version": "2.11.0",
+    "version": "2.13.0",
     "status": "reviewed",
-    "title": "工作区登录隔离与工具链升级指引",
-    "summary": "平台开发者会话按工作区隔离，CLI、MCP 与自动刷新共用本地会话；补齐 V1 采用 V2 的建议及 CLI、Skill、MCP 升级步骤。本版也包含主线已审查的数据事件捕获策略。",
+    "title": "OpenXiangda 2.13.0：原版 OpenDesign 设计体验",
+    "summary": "通过轻量入口直接使用 OpenDesign 原版桌面与完整 CLI，默认先设计和验证原型再实现应用；设计资源进入 AppSpec 评审摘要，PC 与移动字段支持应用作用域内的视觉设计。",
     "newFeatures": [
-      "login --cwd 与 auth --cwd 明确选择工作区；创建应用前可在目标目录登录，初始化保留受管会话文件。",
-      "V1 入口展示 V2 采用建议及迁移评估指引，文档说明 CLI、Skill 与 MCP 的版本刷新。",
-      "应用可用 events.capturePolicies 按资源声明 all 或 subscribed，编译为不可变的操作事件捕获计划。"
+      "design open/status/cli 发现原版安装、连接原版动态服务并透传完整 CLI 和原版 MCP；保留参数、标准输入输出、退出码与取消。",
+      "AppSpec assets 固定设计系统和原型依赖，评审与原测试提交的资源摘要可复核。",
+      "PC Provider 接收应用主题，弹层、消息及移动字段继承应用设计作用域。",
+      "同版 Skill、CLI docs 和平台 MCP 提供原版开发流程及精选 OpenDesign 离线参考。"
     ],
     "fixes": [
-      "默认登录态改为工作区 .openxiangda/session.json，停止读取旧全局会话；本地文件优先于 CI 环境凭据。",
-      "刷新、退出与 MCP 授权检查固定工作区来源，嵌套应用不会继承父应用账号，损坏或平台不符的文件不会换用其他身份。",
-      "登录文件使用原子写入、0600 权限及自动 Git 忽略，初始化不替换凭据内容。"
+      "替换与用户目标冲突的默认外观和固定设备限制，复用字段行为并允许完善整体设计。",
+      "防止原生 --cwd、--json 和 MCP 参数被享搭分发层截获，避免误运行系统同名 od。"
     ],
     "affectedUsers": [
-      "使用 CLI、MCP 或多个应用工作区的开发者。",
-      "从 V1 评估 V2 的用户，以及需要减少无消费者事件写入的 Native 应用开发者。"
+      "使用 OpenXiangda V2 开发新界面、改版和原型的应用开发者。",
+      "采用 AppSpec 原型资源评审或应用主题的 V2 工作区。"
     ],
-    "compatibility": {
-      "node": ">=24",
-      "workspacePolicy": "升级后在每个工作区重新登录；不自动复制旧全局或其他工作区的令牌。",
-      "platformPolicy": "平台登录与授权协议不变；远端检查和部署需要平台的 Native configurationCompatibility 校验器摘要与本版工具链匹配。采用 events.capturePolicies 还需要 events.capture-policy 1.0.0。"
-    },
     "upgradeSteps": [
-      "使用项目包管理器更新并锁定 OpenXiangda 依赖，刷新 Skill 并重启 MCP 客户端。",
-      "远端检查和部署前确认工具链与平台为配套版本；出现 OPENXIANGDA_CONFIGURATION_VALIDATOR_MISMATCH 时先升级不匹配的一端，保留当前源码和候选。",
-      "已有项目在根目录运行 `openxiangda login --base-url <platform>`，再运行 `openxiangda auth status` 检查授权。",
-      "新项目先运行 `openxiangda login --cwd my-app --base-url <platform>`，然后 `openxiangda create my-app --base-url <platform>`。",
-      "CI 仅在没有本地会话文件时使用成对 OPENXIANGDA_BASE_URL 与 OPENXIANGDA_TOKEN。",
-      "采用事件捕获策略前先升级支持该能力的平台，确认事件历史要求，并完成测试环境验收后晋级同一应用版本。"
+      "将应用锁定的 openxiangda 升级到 2.13.0，并刷新当前版本 Skill 和工作区指引。",
+      "从 OpenDesign 官方发行页安装原版，运行 openxiangda design open；在原版中选择已有本地 Agent 或配置所需提供商。",
+      "使用 design cli --help 查看完整原生命令；将实际采用的原型及依赖交接到 AppSpec assets 后验证业务实现。"
     ],
     "knownLimitations": [
-      "钉钉支持的 DWS 授权仍由 DWS 自己管理，不与平台会话混用。",
-      "V1 业务不会自动迁移到 V2。subscribed 不保留未声明操作的历史，恢复 all 不能补造历史事件。"
+      "macOS 桌面发现针对官方 arm64 0.22.2 验证；其他平台和源码安装使用绝对路径 OPENXIANGDA_OPENDESIGN_CLI 或 OD_BIN，未声称完成各平台桌面验收。",
+      "npm 包不包含 OpenDesign 桌面二进制；原版更新、模型登录、云媒体和连接器按原版配置与权限使用。",
+      "原版桌面导入等受授权上下文保护的操作可能需要桌面选择目录；桥接不伪造 token。",
+      "设计资源检查最多 128 文件、单文件 2 MiB、总计 8 MiB；大媒体留在原版项目并导出有界审阅产物。",
+      "原型与包验证不代表生产应用已经部署或完成实际业务验收。"
     ],
+    "compatibility": {
+      "node": ">=24",
+      "platform": "本轮不增加平台后端接口或数据库迁移要求",
+      "v1": "保持独立 legacy-v1 引擎"
+    },
     "issues": [],
-    "sha256": "a6383deacc92dc3e058909c7db537e1a1bf29fc00fbb04345225c1f4f70f23c3",
-    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.11.0"
+    "sha256": "bd50c7e044926d5d7d4f44bbe17827c2f1758f6b6e9ae258d8eb27594379ee98",
+    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.13.0"
   },
   "scripts": {
     "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",

package/releases/2.12.0.json

@@ -0,0 +1,38 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.12.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.12.0：平台原生数据自动化",
+  "summary": "数据事件可直接触发平台 Native 数据动作，省去应用 HTTP 接收链路；发布计划固定捕获字段与目标资源，业务效果与执行结果原子提交。",
+  "newFeatures": [
+    "events.subscriptions.execution 支持 native-data v1 声明式 create/update/delete，无需 Nest 应用后端。",
+    "共享编译器自动派生事件捕获字段及目标模型摘要，新增 events.native-data-actions 能力检查。"
+  ],
+  "fixes": [
+    "保留旧 Webhook 消费者与处理器契约，运维查询区分 Native 执行计划。",
+    "包含已合并的后台入口状态修复与 PC 优先开发引导，菜单缺失、无权限及未知地址分别展示。"
+  ],
+  "affectedUsers": [
+    "使用平台数据自动化和 OpenXiangda V2 事件订阅的应用。",
+    "平台维护者必须同步升级匹配的共享 Native 校验器；V1 业务引擎保持独立。"
+  ],
+  "upgradeSteps": [
+    "先部署支持 events.native-data-actions 1.0.0、同版共享 Native 校验器和 SQL 扩展迁移的平台后端。",
+    "将应用依赖升级到 openxiangda 2.12.0 并按普通测试发布、验收和生产晋级流程交付。",
+    "简单数据动作按 execution 显式启用，外部 Webhook 与自定义代码继续使用现有处理器。"
+  ],
+  "knownLimitations": [
+    "首版 Native 动作仅支持明确源资源的数据事件，最多 16 个操作、每个 32 字段及 64 KiB 输入，不执行脚本、SQL 或 HTTP。",
+    "不兼容的目标模型变化会停止旧动作并报告错误；回退平台前需停用并排空 Native 动作。",
+    "按需事件不能重放从未捕获的历史；权限过滤的轻量操作历史由配套平台提供。",
+    "发行包验证不能代替客户环境的实际部署及容量测试。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "events.native-data-actions 1.0.0，匹配共享 Native 校验器与 Native action SQL 迁移",
+    "v1": "独立 legacy-v1 引擎，不引入兼容桥"
+  },
+  "issues": [],
+  "sha256": "ae2cf493d03c916d22f093d366ac8c7f9d8cf0d0cbc71d6ab5db99fc34617738",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.12.0"
+}

package/releases/2.13.0.json

@@ -0,0 +1,41 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.13.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.13.0：原版 OpenDesign 设计体验",
+  "summary": "通过轻量入口直接使用 OpenDesign 原版桌面与完整 CLI，默认先设计和验证原型再实现应用；设计资源进入 AppSpec 评审摘要，PC 与移动字段支持应用作用域内的视觉设计。",
+  "newFeatures": [
+    "design open/status/cli 发现原版安装、连接原版动态服务并透传完整 CLI 和原版 MCP；保留参数、标准输入输出、退出码与取消。",
+    "AppSpec assets 固定设计系统和原型依赖，评审与原测试提交的资源摘要可复核。",
+    "PC Provider 接收应用主题，弹层、消息及移动字段继承应用设计作用域。",
+    "同版 Skill、CLI docs 和平台 MCP 提供原版开发流程及精选 OpenDesign 离线参考。"
+  ],
+  "fixes": [
+    "替换与用户目标冲突的默认外观和固定设备限制，复用字段行为并允许完善整体设计。",
+    "防止原生 --cwd、--json 和 MCP 参数被享搭分发层截获，避免误运行系统同名 od。"
+  ],
+  "affectedUsers": [
+    "使用 OpenXiangda V2 开发新界面、改版和原型的应用开发者。",
+    "采用 AppSpec 原型资源评审或应用主题的 V2 工作区。"
+  ],
+  "upgradeSteps": [
+    "将应用锁定的 openxiangda 升级到 2.13.0，并刷新当前版本 Skill 和工作区指引。",
+    "从 OpenDesign 官方发行页安装原版，运行 openxiangda design open；在原版中选择已有本地 Agent 或配置所需提供商。",
+    "使用 design cli --help 查看完整原生命令；将实际采用的原型及依赖交接到 AppSpec assets 后验证业务实现。"
+  ],
+  "knownLimitations": [
+    "macOS 桌面发现针对官方 arm64 0.22.2 验证；其他平台和源码安装使用绝对路径 OPENXIANGDA_OPENDESIGN_CLI 或 OD_BIN，未声称完成各平台桌面验收。",
+    "npm 包不包含 OpenDesign 桌面二进制；原版更新、模型登录、云媒体和连接器按原版配置与权限使用。",
+    "原版桌面导入等受授权上下文保护的操作可能需要桌面选择目录；桥接不伪造 token。",
+    "设计资源检查最多 128 文件、单文件 2 MiB、总计 8 MiB；大媒体留在原版项目并导出有界审阅产物。",
+    "原型与包验证不代表生产应用已经部署或完成实际业务验收。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "本轮不增加平台后端接口或数据库迁移要求",
+    "v1": "保持独立 legacy-v1 引擎"
+  },
+  "issues": [],
+  "sha256": "bd50c7e044926d5d7d4f44bbe17827c2f1758f6b6e9ae258d8eb27594379ee98",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.13.0"
+}

package/skills/manifest.json

@@ -3,8 +3,8 @@
   "skills": [
     {
       "name": "openxiangda-v2",
-      "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，再开发、检查和交付应用。维护 1.x 应用时使用对应的 1.x 技能。",
-      "sha256": "f24c14f9da6913d42dd2fe45bb12d7c74fd6f49196e44d525730025bfb392d2d"
+      "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，使用原版 OpenDesign 桌面和 CLI形成整体视觉与可运行原型，再开发、检查和交付应用。维护 1.x 应用时使用对应的 1.x 技能。",
+      "sha256": "7593f81c36fdff1559824275f580b311785085e46e130843d36f6ae09dda1ea8"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: openxiangda-v2
-description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，再开发、检查和交付应用。维护 1.x 应用时使用对应的 1.x 技能。
+description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，使用原版 OpenDesign 桌面和 CLI形成整体视觉与可运行原型，再开发、检查和交付应用。维护 1.x 应用时使用对应的 1.x 技能。
 ---
 
 # OpenXiangda 2.0
@@ -13,15 +13,17 @@ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具
 
 遇到已有 V1 项目时，先核实 V2 能力覆盖、项目是否仍在测试阶段和迁移成本；能力满足、仍在测试阶段且代价可控时，优先建议转用 V2。先做只读评估，再按项目确认详细设计、数据/流程映射、测试和回滚；迁移实施前的原项目维护仍使用匹配的 V1 引擎。
 
+有界面影响的开发和改版默认读[OpenDesign 工作流](references/design-workflow.md)，使用 `openxiangda design open` 和 `design cli` 直接调用原版，随包方法仅作离线参考，形成设计包、可运行原型、浏览器修正和实现交接。保留字段与权限行为，旧默认皮肤或设备偏好可按任务重新设计。设计与原型资源使用 AppSpec assets 固定；不把结构检查或示例数据当成实际验收。
+
 ## 定位当前版本
 
 未创建工作区时使用本 Skill 随根包发布的精确版本：
 
 ```bash
-pnpm dlx openxiangda@2.11.0 auth status --cwd <应用目录> --base-url <平台地址> --json
-pnpm dlx openxiangda@2.11.0 login --cwd <应用目录> --base-url <平台地址>
-pnpm dlx openxiangda@2.11.0 create <应用目录> --base-url <同一平台地址>
-pnpm dlx openxiangda@2.11.0 skill install --force
+pnpm dlx openxiangda@2.13.0 auth status --cwd <应用目录> --base-url <平台地址> --json
+pnpm dlx openxiangda@2.13.0 login --cwd <应用目录> --base-url <平台地址>
+pnpm dlx openxiangda@2.13.0 create <应用目录> --base-url <同一平台地址>
+pnpm dlx openxiangda@2.13.0 skill install --force
 ```
 
 创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。
@@ -39,6 +41,7 @@ pnpm dlx openxiangda@2.11.0 skill install --force
 | 安装、登录、创建、连接开发 | [开始开发](references/getting-started.md) |
 | 源码仓库、换电脑、旧项目导入、提交推送与重试 | [应用源码](references/getting-started.md#应用源码)；先用 `source status` 读取实际绑定 |
 | 模糊想法、模块发现、PRD、权限与架构设计 | [产品设计](references/product-design.md)、[交互模式](references/interaction-patterns.md) |
+| 界面设计、改版、原型和视觉修正 | 先读[设计工作流](references/design-workflow.md)，使用 `openxiangda design open` 和 `design cli` 调用原版；[离线方法](references/opendesign-methods.md)与[设计 Craft](references/design-craft.md)仅作补充 |
 | 理解需求与选择能力 | [开发流程](references/development.md)、[架构](references/concepts.md) |
 | 模型、CRUD、字段与移动表单 | [业务模块](references/application-foundation.md)、[字段](references/field-components.md) |
 | 图片压缩、缩略图、附件和缓存 | [图片与附件读取](references/field-components.md#图片缩略图和附件读取)：卡片优先缩略图，原图按需，使用平台权限与缓存规则 |
@@ -56,6 +59,8 @@ pnpm dlx openxiangda@2.11.0 skill install --force
 
 ## 引导开发并持续记录
 
+先选择页面归属：按真实任务选择设备；普通管理/录入复用标准 CRUD 的字段行为与 Shell 的导航事实，自定义报表和工具使用 admin React 页面及显式菜单。通过本应用设计和受支持视觉输入完善布局外观，不复制权限或导航状态。独立用户页与手机用户任务按实际需求设计，模板 `/home` 仅是占位。报表等专业交互主动检查已有依赖、评估成熟组件和开源库，图表优先评估 ECharts，记录选型理由及加载/销毁边界；细节见[前端](references/frontend.md)。交付需验证平台实际点击入口、根路径、后台菜单和登录返回，不能只验收直达业务链接。
+
 每轮先读取当前 AppSpec 总纲、设计索引、相关能力、活动变更与契约，按稳定 ID 恢复已知事实、候选建议和未决项。设计文件相互引用而不重复定义规则；角色、权限、页面或入口范围改变时，同步受影响 PRD、旅程、交互、架构和 AC。具体工作法按需读取[产品设计](references/product-design.md)。
 
 总纲维护领域与模型关系、PC/移动任务页面、页面/操作/行/字段权限、多角色组合和容量预算。新增功能先评估影响，普通 CRUD、流程、消息等复用平台能力。明确数据量、分页/索引、请求次数、并发/批量和延迟目标，避免无界全量读取、逐行请求与无限重试。

package/skills/openxiangda-v2/references/application-foundation.md

@@ -138,7 +138,7 @@ import 'openxiangda/mobile/styles.css';
 </MobileSurface>
 ```
 
-平台按需加载移动组件，并在构建时限定上游基础样式的作用范围。此入口的 `Popup`、`Picker`、`DatePicker` 默认保留在当前页面中，保留组件样式作用范围。已有 `openxiangda/react/styles.css` 包含移动字段样式，不必重复导入。不要直接引入 `antd-mobile` 根入口，它会重置全页字体和链接。平台统一使用组件库默认外观，不再提供配色配置或外观偏好。
+平台按需加载移动组件，并在构建时限定上游基础样式的作用范围。此入口的 `Popup`、`Picker`、`DatePicker` 默认保留在当前页面中，保留组件样式作用范围。已有 `openxiangda/react/styles.css` 包含移动字段样式，不必重复导入。不要直接引入 `antd-mobile` 根入口，它会重置全页字体和链接。应用通过设计包、ui 视觉参数和 MobileSurface 内变量应用已确认视觉；平台不维护第二套配色偏好状态，详见[设计工作流](design-workflow.md)。
 
 `openxiangda check` 检查应用前端 `src/` 中的原生录入元素。移动入口使用 `src/mobile/`、`Mobile*.tsx` 或 `*.mobile.tsx`，并检查其本地静态依赖；这是明确的源码约定，不是运行时授权或对动态代码的安全证明。平台组件内部的原生 DOM 不受应用规则限制。
 

package/skills/openxiangda-v2/references/cli.md

@@ -7,6 +7,7 @@
 | `pnpm openxiangda auth` | 只读 | 只读核验指定平台授权，不登录或刷新会话 |
 | `pnpm openxiangda context` | 只读 | 只读查看工作区、版本与平台绑定 |
 | `pnpm openxiangda docs` | 只读 | 按主题和章节读取当前版本中文资料 |
+| `pnpm openxiangda design` | 远端变更 | 打开 OpenDesign 原版并透传完整原生 CLI；写入范围由原生命令决定 |
 | `pnpm openxiangda admin` | 只读 | 只读查看应用管理能力和流程节点运行配置 |
 | `pnpm openxiangda create` | 远端变更 | 创建、绑定并初始化应用 |
 | `pnpm openxiangda source` | 远端变更 | 配置应用源码仓库、查看状态或提交推送 |