openxiangda 2.20.4 → 2.21.0

package/releases/2.9.0.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.9.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.9.0：声明标准列表导入导出入口",
+  "summary": "应用可按默认或命名视图配置标准列表的导入、导出任务，PC 与移动端使用相同声明。",
+  "newFeatures": [
+    "crud[].list.actions 支持 import 与 export 布尔开关，直接资源声明同样支持。",
+    "关闭导入适用于原生与流程列表；关闭导出同时覆盖 PC 和移动列表。"
+  ],
+  "fixes": [
+    "应用可通过公开配置移除首发范围之外的列表任务，无需修改共享组件或使用 CSS 隐藏。"
+  ],
+  "affectedUsers": [
+    "使用标准 CRUD 默认或命名视图，需要控制导入导出入口的 V2 应用开发者。"
+  ],
+  "upgradeSteps": [
+    "平台采用 openxiangda-contracts 2.7.0，应用采用 openxiangda 2.9.0 后重新生成和检查。",
+    "在目标视图的 list.actions 中将不需要的入口设为 false，再部署测试候选并验证 PC/移动页面。"
+  ],
+  "knownLimitations": [
+    "省略开关保持既有行为；true 不授予权限，也不改变原生、流程或只读写入归属。",
+    "这是页面入口配置，Data API 和敏感字段仍按原有授权规则执行。",
+    "命名视图各自声明开关，不继承默认视图的任务选择；无需新增数据库迁移。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "openxiangda-contracts 2.7.0"
+  },
+  "issues": [],
+  "sha256": "c9d413f52c85a7ca1ee5e113ca72d9284efd303b3a99dc8ba71ae35cf7526783",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.9.0"
+}

package/releases/2.9.1.json

@@ -0,0 +1,31 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.9.1",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.9.1：保留显式查询操作数与路径",
+  "summary": "修复标准客户端将成员包含查询的单值改成数组，导致合法查询返回400的问题。",
+  "newFeatures": [],
+  "fixes": [
+    "has操作保持单个稳定标识；in、between、hasAny、hasAll保留数组全部值，不再复用快捷筛选推断操作数形状。",
+    "显式查询path保持原值路径；单项快照和级联控件选择仍转为稳定查询值。",
+    "列表、批量列表和导出使用相同修正，应用无需修改正确的DataWhere条件。"
+  ],
+  "affectedUsers": [
+    "使用openxiangda/core显式where成员筛选、数组操作或子值路径查询的V2应用。"
+  ],
+  "upgradeSteps": [
+    "将应用的公开openxiangda依赖升级到2.9.1，重新检查并发布测试候选。",
+    "复测参与人归属、数组区间筛选及导出；生产晋级复用验收通过的原测试制品。"
+  ],
+  "knownLimitations": [
+    "快捷filters的既有界面语义不变；字段类型、行权限与查询边界仍由平台Data API验证。",
+    "本补丁不改变业务数据、权限或数据库结构；新增CRUD列表开关仍需平台采用contracts2.7.0。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "openxiangda-contracts 2.7.0"
+  },
+  "issues": [],
+  "sha256": "2cfb20fed9921fc7281f36970f9ba534192fe0eacafb55223e3031587b27f6c7",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.9.1"
+}

package/releases/2.9.2.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.9.2",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.9.2：查询操作数修正与模板版本联动",
+  "summary": "修复标准客户端将成员包含查询的单值改成数组导致400的问题，并补齐根包和CLI模板的发布版本联动。",
+  "newFeatures": [],
+  "fixes": [
+    "has操作保持单个稳定标识；in、between、hasAny、hasAll保留数组全部值，不再复用快捷筛选推断操作数形状。",
+    "显式查询path保持原值路径；单项快照和级联控件选择仍转为稳定查询值。",
+    "列表、批量列表和导出使用相同修正，应用无需修改正确的DataWhere条件。",
+    "发布版本规划在写入版本前拒绝缺少CLI配套Changeset的根包升级，避免模板变更到不可变包检查阶段才被发现。"
+  ],
+  "affectedUsers": [
+    "使用openxiangda/core显式where成员筛选、数组操作或子值路径查询的V2应用。"
+  ],
+  "upgradeSteps": [
+    "将应用的公开openxiangda依赖升级到2.9.2，重新检查并发布测试候选。",
+    "复测参与人归属、数组区间筛选及导出；生产晋级复用验收通过的原测试制品。"
+  ],
+  "knownLimitations": [
+    "快捷filters的既有界面语义不变；字段类型、行权限与查询边界仍由平台Data API验证。",
+    "本补丁不改变业务数据、权限或数据库结构；新增CRUD列表开关仍需平台采用contracts2.7.0。",
+    "2.9.1仅为被发布门禁拦截的未发布候选；其查询修正随2.9.2正式交付。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "openxiangda-contracts 2.7.0"
+  },
+  "issues": [],
+  "sha256": "9989af7b2e2b9e5eaf81bf19b1307366a35b07522082b384918882f8db05d61c",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.9.2"
+}

package/releases/2.9.3.json

@@ -0,0 +1,31 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.9.3",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.9.3：明确记录用户授权的性能延期",
+  "summary": "修复功能验收完成但用户已延期性能时无法正式晋级的问题，保留原测量并明确区分性能通过与延期。",
+  "newFeatures": [],
+  "fixes": [
+    "AppSpec验收报告支持有授权人、实际时间、来源、证据及后续安排的performanceDeferral。",
+    "延期时保留真实超标测量，返回deferred与overBudget统计，生产阶段明确显示性能未通过。",
+    "没有授权延期时仍要求性能测量达标；延期不豁免功能AC、证据、原测试版本和制品绑定。"
+  ],
+  "affectedUsers": [
+    "已由用户明确延期性能验收、需要按实际范围完成V2功能交付的应用开发者。"
+  ],
+  "upgradeSteps": [
+    "更新项目的openxiangda依赖至2.9.3并刷新项目技能；已有测试制品可以沿用，不因验收工具升级而重建。",
+    "依据实际用户决定填写延期记录，保留成功与失败测量；正式spec verify后提交推送报告，用原TEST运行晋级。"
+  ],
+  "knownLimitations": [
+    "结构验证不证明授权或证据内容真实；不得制造用户确认、提高阈值或仅保留成功样本。",
+    "本次仅修复开发交付记录契约，不修复性能，也不修改平台后端、业务数据或运行时权限。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "沿用openxiangda-contracts 2.7.0，无新增平台能力要求"
+  },
+  "issues": [],
+  "sha256": "aea11cf79206afaae7d6a98eb72506bd71f13752ca6178e459d5395cde4b10a8",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.9.3"
+}

package/releases/2.9.4.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.9.4",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.9.4：DingTalk OA 工作通知 SDK",
+  "summary": "应用通过平台托管的 Notification Hub 发送文本或 Markdown 钉钉 OA 工作通知，并查询投递结果。",
+  "newFeatures": [
+    "Nest SDK 增加 sendDingTalkWorkNotice 和 getDingTalkWorkNoticeResult。",
+    "工作通知支持按 Native 用户、部门或全员发送，平台负责渠道凭据、Native 标识映射、幂等、投递和审计。"
+  ],
+  "fixes": [],
+  "affectedUsers": [
+    "需要从 OpenXiangda 2.0 应用发送钉钉文本或 Markdown 工作通知的开发者。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": [
+      "v1",
+      "v2"
+    ],
+    "v1Policy": "V1 引擎和已有应用不变。",
+    "platformPolicy": "需要部署包含 Notification Hub DingTalk OA 工作通知接口的匹配平台组合，并配置已启用的 OA 渠道。",
+    "releaseChannels": "latest / stable-v2：V2 正式版；legacy-v1：V1 维护版；alpha：预发布。"
+  },
+  "upgradeSteps": [
+    "平台先部署匹配的 Notification Hub 服务并确认 DingTalk OA 渠道和 Secret 引用可用。",
+    "将应用的 openxiangda 依赖升级到 2.9.4，更新锁文件并通过标准检查。",
+    "在测试环境验证用户、部门和全员目标的发送回执，再使用同一候选晋级生产。"
+  ],
+  "knownLimitations": [
+    "首版内容类型为 text 和 markdown；钉钉最终接收结果仍以平台投递记录和钉钉响应为准。",
+    "发布包、平台部署和真实业务角色验收分别验证；本版本不自动配置渠道 Secret。"
+  ],
+  "issues": [],
+  "sha256": "6383173f0e6bd4596286e95453fd651d07eb8d91948e829dcd1fe3dfbab1f485",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.9.4"
+}

package/skills/manifest.json

@@ -3,8 +3,8 @@
   "skills": [
     {
       "name": "openxiangda-v2",
-      "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，由 AI 在工作区内调用 OpenDesign 原版 CLI/Skill/MCP 形成整体视觉与可运行原型，再开发、检查和交付应用。OpenDesign 客户端只作为可选预览器；维护 1.x 应用时使用对应的 1.x 技能。",
-      "sha256": "01cad9ea9d2ffff598fc6f213a180dfea95b790e577df6ba6b131d87d0076434"
+      "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，由当前 AI Agent 按需用 Image 2.5 等图片能力形成视觉参考，直接实现真实页面并在浏览器修正，再检查和交付应用；维护 1.x 应用时使用对应的 1.x 技能。",
+      "sha256": "5b13a19363ecefe2417d9b6e730db7c7d8eaa12bbab253fffe9bef6fb5820886"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: openxiangda-v2
-description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，由 AI 在工作区内调用 OpenDesign 原版 CLI/Skill/MCP 形成整体视觉与可运行原型，再开发、检查和交付应用。OpenDesign 客户端只作为可选预览器；维护 1.x 应用时使用对应的 1.x 技能。
+description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，由当前 AI Agent 按需用 Image 2.5 等图片能力形成视觉参考，直接实现真实页面并在浏览器修正，再检查和交付应用；维护 1.x 应用时使用对应的 1.x 技能。
 ---
 
 # OpenXiangda 2.0
@@ -9,7 +9,7 @@ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具
 
 每个业务应用默认先建立并保留标准管理后台。管理后台是应用骨架，承载资源模型、表单、数据列表、详情/编辑、权限和流程入口；AI 必须先从后台完成数据与契约，再实现用户端体验。不得因为制作用户端首页而删除、隐藏或替换后台 Shell、后台路由或显式菜单。
 
-OpenDesign 按页面归属使用：后台页面可以用 OpenDesign 优化布局、视觉和交互，但必须复用平台后台 Shell、导航、字段行为和权限；用户端 PC 与移动端可以分别使用 OpenDesign 的完整视觉和交互，并通过平台 runtime/Data API 读取后台数据。不得用单页 HTML、iframe 或独立假后台冒充管理后台，也不得在用户端复制后台权限和导航状态。
+Agent 按页面归属优化布局、视觉和交互：后台必须复用平台 Shell、导航、字段行为和权限；用户端 PC 与移动端按真实任务分别设计，并通过平台 runtime/Data API 读取后台数据。图片参考不定义交互、权限或验收。不得用图片、单页 HTML、iframe 或独立假后台冒充管理后台，也不得在用户端复制后台权限和导航状态。
 
 设计、实现和发布验收必须分别核验管理后台入口、表单、数据列表、流程入口，以及用户端 PC/移动端入口。缺少标准管理后台的应用结构不完整，不能发布。
 
@@ -21,29 +21,29 @@ OpenDesign 按页面归属使用：后台页面可以用 OpenDesign 优化布局
 
 遇到已有 V1 项目时，先核实 V2 能力覆盖、项目是否仍在测试阶段和迁移成本；能力满足、仍在测试阶段且代价可控时，优先建议转用 V2。先做只读评估，再按项目确认详细设计、数据/流程映射、测试和回滚；迁移实施前的原项目维护仍使用匹配的 V1 引擎。
 
-有界面影响的开发和改版默认读[OpenDesign 工作流](references/design-workflow.md)，由 AI 在当前 OpenXiangda 工作区读取相关 Skill，并通过 `openxiangda design cli` 或原版 stdio MCP 自动完成设计方向、原型、lint、修正和产物交接；不要求用户打开或操作 OpenDesign 客户端。客户端只用于用户主动查看或人工预览。随包方法仅作离线参考，保留字段与权限行为，旧默认皮肤或设备偏好可按任务重新设计。设计与原型资源使用 AppSpec assets 固定；不把结构检查或示例数据当成实际验收。
+有界面影响的开发和改版默认读[Agent 原生设计工作流](references/design-workflow.md)，由当前 AI 在同一个 OpenXiangda 工作区确定视觉方向、直接实现真实页面并在浏览器修正。需要建立新方向时，按需使用用户指定或当前可用的图片生成能力（例如 Image 2.5）形成少量参考；图片不可用或质量不足时直接使用设计约束、成熟组件和浏览器迭代继续开发。保留字段与权限行为，旧默认皮肤或设备偏好可按任务重新设计。实际采用的参考图、token 和必要原型使用 AppSpec assets 固定；不把图片、结构检查或示例数据当成实际验收。
 
 ## AI 自动设计与开发
 
-AI 接到新应用、页面或改版任务时，在同一个 OpenXiangda 工作区内执行以下闭环，不把设计任务转交给用户操作客户端：
+AI 接到新应用、页面或改版任务时，在同一个 OpenXiangda 工作区内执行以下闭环，不建立第二个设计项目或把实现转交给用户：
 
-1. 读取本 Skill、`references/design-workflow.md` 和任务相关的 OpenDesign Skill；从当前 AppSpec、平台契约和用户材料确定页面、角色、设备与验收目标。
-2. 用 `openxiangda design cli` 查询原版方向、模板、设计系统和插件；需要持续会话时启动 `openxiangda design cli mcp`，把原版设计工具接入当前 AI Agent。所有 CLI 参数、JSON、标准输入输出和取消都由原版处理。
-3. 在任务工作区创建或复用原版项目，向原版 Agent 提交任务上下文，生成可运行原型；AI 自己读取文件、运行 lint/预览检查并按结果修正。
-4. 将本轮实际采用的设计文件、token、原型和来源版本复制或导出到 `appspec/design`，然后继续生成 OpenXiangda 页面、字段和业务实现。设计产物与应用源码属于同一变更链，不要求用户在客户端中搬运文件。
-5. 运行本项目的 check、浏览器和真实角色验收；只有实际证据通过后才进入部署流程。原型、示例数据或客户端截图不能替代业务验收。
+1. 读取本 Skill 和 `references/design-workflow.md`，从当前 AppSpec、平台契约和用户材料确定页面、角色、设备、状态与验收目标。
+2. 已有设计足够时直接沿用；需要新视觉方向时，用 Image 2.5 等当前图片能力生成一至三个关键视图，筛选后只固定实际采用的参考。图片中不得包含秘密、真实个人数据或未授权素材。
+3. 从参考和产品约束提取布局、排版、颜色、间距与组件关系，直接使用真实 React、平台 Shell、Field Kit 和受支持组件实现；不逐像素照抄伪文字、虚构控件或图片中的错误交互。
+4. 在目标视口打开真实页面，操作空、加载、失败、拒绝、校验、提交、恢复、未保存输入、键盘与响应式路径，依据截图和交互发现修正代码。图片和 Agent 自评不能替代浏览器断言。
+5. 将本轮实际采用的参考图、设计说明、token 和必要原型记录到 `appspec/design`，运行本项目的 check、浏览器和真实角色验收；只有实际证据通过后才进入部署流程。
 
-如果原版 CLI 或 MCP 不可用，保留真实错误并停止依赖原版的设计步骤；可以继续不依赖设计运行时的只读分析，但不能伪造设计产物或把离线参考当成原版执行结果。
+图片能力不可用、失败或结果不合格时，记录事实并继续直接实现和浏览器迭代；不能伪造设计产物或通过结果。静态图不拥有应用结构、交互、权限、数据或验收事实。
 
 ## 定位当前版本
 
 未创建工作区时使用本 Skill 随根包发布的精确版本：
 
 ```bash
-pnpm dlx openxiangda@2.20.4 auth status --cwd <应用目录> --base-url <平台地址> --json
-pnpm dlx openxiangda@2.20.4 login --cwd <应用目录> --base-url <平台地址>
-pnpm dlx openxiangda@2.20.4 create <应用目录> --base-url <同一平台地址>
-pnpm dlx openxiangda@2.20.4 skill install --force
+pnpm dlx openxiangda@2.21.0 auth status --cwd <应用目录> --base-url <平台地址> --json
+pnpm dlx openxiangda@2.21.0 login --cwd <应用目录> --base-url <平台地址>
+pnpm dlx openxiangda@2.21.0 create <应用目录> --base-url <同一平台地址>
+pnpm dlx openxiangda@2.21.0 skill install --force
 ```
 
 创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。
@@ -61,7 +61,7 @@ pnpm dlx openxiangda@2.20.4 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)仅作补充 |
+| 界面设计、改版、原型和视觉修正 | 先读[Agent 原生设计工作流](references/design-workflow.md)，按需用 Image 2.5 等当前图片能力生成参考，直接实现真实页面并完成浏览器闭环 |
 | 理解需求与选择能力 | [开发流程](references/development.md)、[架构](references/concepts.md) |
 | 写 openxiangda.config.ts 声明、避免首轮校验返工 | [声明速查](references/declarations-cheatsheet.md)；先扫规则表再动手 |
 | 模型、CRUD、字段与移动表单 | [业务模块](references/application-foundation.md)、[字段](references/field-components.md) |

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

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

package/skills/openxiangda-v2/references/design-workflow.md

@@ -1,119 +1,135 @@
-# OpenDesign 设计、原型与实现
+# Agent 原生视觉设计与实现
 
-有界面影响的新应用、页面或改版，默认由 **OpenXiangda 2.0 的 AI 工作流调用原版 OpenDesign CLI、Skill 和 MCP** 完成设计、原型、预览和修正，再在同一工作区交接到享搭实现业务。OpenDesign 客户端是可选预览器，不是用户必须操作的开发入口。享搭只提供安装发现、原生 CLI 透传和 Agent 接入边界；项目、模板、设计系统、插件、导出及更新都由 OpenDesign 管理。纯后端、文字校正等按影响沿用已有设计。
+有界面影响的新应用、页面或改版，由当前 AI Agent 在同一个 OpenXiangda 工作区内完成
+视觉方向、真实页面实现、浏览器走查和修正。按需使用用户指定或当前可用的图片生成能力
+（例如 Image 2.5）输出少量设计参考；不安装或调用独立设计运行时，也不在图片与实现之间
+建立第二个项目状态。纯后端或无视觉影响的文字修正沿用已有设计。
 
-## 原版安装与完整 CLI {#native}
+图片只回答构图、层次、色彩、材质和氛围等视觉问题。AppSpec 继续定义用户、任务、页面、
+字段、权限、状态和验收；真实 React 页面才是最终界面事实。静态图不能证明加载、失败、
+拒绝、校验、提交、未保存输入、键盘、响应式或业务权限已经实现。
 
-从[官方发行页](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 验证；其他平台使用显式入口，不声称已完成桌面验证。
+## 先固定设计输入 {#inputs}
 
-```bash
-pnpm openxiangda design open
-pnpm openxiangda design status --json
-pnpm openxiangda design cli --help
-pnpm openxiangda design cli project list
-pnpm openxiangda design cli templates list
-pnpm openxiangda design cli design-systems list
-pnpm openxiangda design cli tools directions --json
-pnpm openxiangda design cli plugin --help
-pnpm openxiangda design cli mcp
-```
-
-`cli` 后面的参数、标准输入、输出、JSON、错误码和取消交给原版；享搭不维护上游命令白名单。查看每条原生命令的 `--help` 再执行当前需要的操作。原版 MCP 可直接接到支持 stdio 的 Agent，启动命令为 `openxiangda design cli mcp`；它与享搭平台 MCP 分别拥有设计项目和平台契约，不合并权限。
-
-AI 通过 CLI/MCP 工作时使用原生 `OD_DAEMON_URL` 或原版自动发现的本地运行时；不需要先执行 `design open`。桌面版 sidecar 只在用户主动预览时使用。原版桌面文件导入等操作可能要求桌面授权上下文；AI 应保留原版错误并停止该步骤，不伪造 token 或改数据库。享搭不会在 npm 安装时下载桌面应用、自动修改 Agent 凭据或开启云付费功能。
+开始界面工作前，从当前 AppSpec、平台契约和用户材料形成一个短设计输入，至少明确：
 
-AI Agent 通过原版 CLI/MCP 使用设计能力；模型和登录由原版及所选提供商管理。用户需要人工查看时才打开客户端。需要原版图像、视频、音频或云服务时按原版配置相应提供商。原生功能按其实际依赖可用，不把所有功能都描述为无需配置。
+- 目标用户、主任务、页面归属以及 PC/移动设备范围；
+- 必须保留的平台 Shell、导航、字段协议、权限和数据来源；
+- 页面信息层次、关键操作，以及空、加载、失败、拒绝、校验、提交中和成功状态；
+- 用户提供的品牌、参考图和素材授权；没有品牌事实时标记为 Agent 推断；
+- 目标视口、可访问性、内容长度、数据量和性能边界；
+- 本轮可以改变、必须保留和明确不做的内容。
 
-## 随包离线参考 {#resources}
+已有有效设计继续沿用。只有视觉方向存在真实取舍时才比较候选；已经确认的意图不重复
+提问。不得凭空补充 KPI、品牌故事、业务统计、角色能力或示例数据来源。
 
-通过 `pnpm openxiangda docs <主题> --section <章节>` 或 MCP `docs_read` 的 topic/section 读取。Skill references 与这些正文同源；以当前项目安装版本为准。以下是携带完整正文的精选方法及依赖，作为离线参考。原版运行时提供完整且可能更新的资源；不要把这张精选表当作原版能力边界。
+## 图片参考 {#image-reference}
 
-| 工作 | opendesign-methods 章节 | 同时读取 design-craft 章节 |
-| --- | --- | --- |
-| 从任务、参考到整体视觉方向 | reference-design-contract、reference-design-contract-2（附属 checklist） | typography、color、anti-ai-slop |
-| 生成可运行页面和交互 | frontend-design | typography、color、anti-ai-slop；有状态 UI 再读 state-coverage、accessibility-baseline |
-| 浏览器走查、修正已有原型及实现 | impeccable-design-polish | typography、color、anti-ai-slop、animation-discipline、accessibility-baseline |
-| 信息层次、密集工作台、表单 | 按当前阶段选择上述方法 | typography-hierarchy、laws-of-ux、form-validation，按实际问题选读 |
+图片生成是可选步骤。需要建立新视觉方向、比较布局或统一多页面风格时，可用 Image 2.5
+等当前 Agent 图片能力生成一至三个关键视图；普通 CRUD、小范围样式修正或已有明确设计时
+直接实现。生成提示应包含真实页面类型、主要内容、设备、密度、组件约束和不应出现的元素，
+不得包含生产秘密、真实个人数据或未经授权的品牌和人物素材。
 
-原文来源、上游提交、适配版本和能力摘要见[原文方法](opendesign-methods.md)；每个 Craft 都保留完整正文，见[设计 Craft](design-craft.md)。引用它们时记录实际读取的章节，不能只读本页摘要就宣称用了完整方法。
+只保留实际采用的参考图，并记录实际模型、日期、提示摘要、目标视口和采用/拒绝理由。
+不要逐像素照抄图片中的伪文字、虚构控件或不可能交互。Agent 应从参考图提取可实现的布局、
+排版、颜色、间距和组件关系，再对照真实内容与平台组件修正。图片生成失败、不可用或结果
+不合格时，记录事实并使用现有设计约束、成熟组件和浏览器迭代继续开发，不伪造产物。
 
-## 享搭适配规则 {#adapter}
+## 页面归属与平台边界 {#adapter}
 
-按用户任务、业务材料和实际设备选择整体方向，包括导航形态、布局、层次、密度、字体、色彩、间距、组件与交互状态。已有“标准后台必须默认外观”“后台一律不设计移动”等审美和设备约定不再是限制。设备适用性由真实任务决定；不要机械增加没有用户任务的页面。
+应用结构先于视觉：标准管理后台是默认骨架，必须保留平台 Shell、后台路由、显式菜单、
+资源表单、数据列表、详情/编辑、权限和流程入口。Agent 可以在这些边界内优化布局、视觉和
+交互，但不能用设计图、独立原型、单页 HTML 或 iframe 替代后台。
 
-应用结构先于视觉改版：标准管理后台是默认骨架，必须保留平台 Shell、后台路由、显式菜单、资源表单、数据列表、权限和流程入口。OpenDesign 对后台只做布局、视觉和交互优化，不能用独立原型、单页 HTML 或 iframe 替换后台。用户端 PC 与移动端按真实旅程分别设计，可以完整采用 OpenDesign 的视觉与交互，但通过平台 runtime/Data API 连接后台数据，并保持与后台分离的权限和导航状态。设计交接时分别标记后台、用户端 PC、用户端移动端的页面归属和验收入口。
+用户端 PC 与移动端按真实旅程分别实现，通过平台 runtime/Data API 使用后台数据，并与
+后台保持独立的导航状态。Shell 的路由、当前用户、授权菜单和拒绝事实仍来自平台，不在
+用户端复制。先复用 PC/移动 Field Kit 的输入、校验、上传、只读和权限行为；替换外观或
+专业控件时，证明字段值、未保存输入、拒绝和恢复行为仍正确。
 
-先复用 PC/移动 Field Kit 的输入、校验、上传、只读和权限行为。组件外观、布局及专业控件可据设计优化；换组件时证明字段值、未保存输入、拒绝和恢复行为仍正确。Shell 的路由、当前用户、授权菜单事实继续来自平台；`ui` 提供视觉参数，局部 CSS 可以编排布局，结构扩展应走平台支持的组件接口，不能复制导航状态。
+普通管理与录入保持工作型界面的扫描效率和信息密度。专业交互先评估项目已有依赖与成熟
+组件，图表优先评估 ECharts。营销式大标题、装饰性卡片堆叠、无任务依据的插画、纯氛围
+背景和重复导航不能因为参考图中出现就进入业务应用。
 
-上游模板的桌面/手机预览框、固定侧栏、虚构指标、限定图表库和示例品牌仅服务其示例。原文中的字体/颜色数量、渐变等规则用于评审设计理由，不能压过实际品牌、中文阅读或已确认任务。借鉴参考的可描述特征，不复制品牌素材或凭空声称业务事实。
+## 从参考到真实实现 {#loop}
 
-离线快照中的目录入口不被冒充为完整实现；原版中实际可用的插件、技能及资源通过原生命令和界面发现。遵循原版工作流，不把享搭自己的审美限制强加给它。执行插件、连接器和分享等功能仍需要与用户当前任务相符的授权。
+1. 读取设计输入和相关契约，确定本轮页面、状态、视口与验收动作。
+2. 需要时生成并筛选图片参考，提取可实现的视觉规则；不需要时直接沿用现有设计系统。
+3. 在 `tokens.css` 或应用现有 token 源中定义实际采用的数值，派生 AntD theme 与移动 CSS
+   变量；不要在图片说明、组件和全局偏好中维护多份数值事实。
+4. 直接使用真实 React、平台 Shell、Field Kit 和受支持组件实现页面。原型只有在能降低
+   高风险交互的不确定性时创建，且不得成为另一套长期业务代码。
+5. 在目标尺寸打开真实页面，操作完整关键任务；检查布局、滚动、弹层、键盘、长文本、
+   空、加载、失败、拒绝、校验、提交、恢复和离开保护。浏览器控制台错误必须处理。
+6. 获取实际截图与交互发现，修正代码并重复检查。截图用于比较视觉，不替代操作断言。
+7. 连接平台后，从真实入口按实际角色验证后台与用户端、允许与拒绝路径；只有业务证据
+   通过后才进入部署。组件样例、本地数组和图片参考不能冒充远端业务验收。
 
-## 从设计到真实页面 {#loop}
+现有交互模式作为任务检查依据，见[交互模式](interaction-patterns.md)；它们允许按当前设计
+改进，不是固定页面皮肤。
 
-1. 从当前 AppSpec 和实际界面识别主任务、目标用户、设备、约束与已有证据。新方向给出有理由的推荐；实际有取舍时最多比较两个方向，已确认意图不重复问。
-2. AI 通过原版 CLI/MCP 创建或复用项目、选择模板/设计系统，提供任务与必要参考；工作目录由当前 OpenXiangda 工作区确定。使用原版工作流形成设计方向，保留上游的项目和资源结构；用户可选打开客户端查看。
-3. 通过原版 Agent、项目和预览做可运行原型，关键任务能从入口走到完成。标明示例数据；覆盖适用的空、加载、失败、拒绝、校验、提交中和成功状态。真实业务请求尚未接入时明确说明。
-4. 使用原版预览、lint、导出和修正能力；在目标尺寸实际打开、点击和键盘操作。证据记录实际 URL/文件、尺寸、操作与发现，没有浏览器证据就写未验证。不能用 AI 评分或勾选表代替画面和操作结果。
-5. 依据已有授权和实际答复记录确认范围，固定设计文档和 assets 摘要。工具检查只证明资料与资源一致，不代表审美通过。
-6. 消费同一设计包接入真实组件、平台数据和权限。对照原型检查布局、字段、弹层、未保存输入、拒绝/返回、键盘与移动任务。验收证据关联本次真实实现；原型成功不能冒充业务验收。
+## AppSpec 设计资源 {#artifacts}
 
-现有交互模式作为任务检查依据，见[交互模式](interaction-patterns.md)；它们允许按设计改进，不是固定页面皮肤。
-
-## 原版产物交接到 AppSpec {#artifacts}
-
-OpenDesign 项目保留自己的设计文件、清单和数值 token。交接时用原版文件/导出功能复制本轮实际采用的文件及依赖到以下目录，记录原版版本、项目 ID 和导出来源；不要求为了享搭改写上游 manifest 或重复制作原型。大型媒体和完整上游工作目录留在原项目，AppSpec 引用本轮可审阅、自包含的产物。
+只固定本轮实际采用、可审阅且自包含的资源。目录可以按任务裁剪：
 
 ```text
-appspec/design/visual.md              # AppSpec 索引与受影响范围
-appspec/design/system/manifest.json   # 能力来源和应用使用的精确版本
-appspec/design/system/DESIGN.md       # 视觉语义、设计取舍与实现交接
-appspec/design/system/tokens.css      # 数值 token 的唯一可编辑来源
-appspec/design/prototypes/<task>/     # 完整、自包含的原型和依赖
+appspec/design/visual.md                 # 范围、来源、取舍与受影响页面
+appspec/design/references/<task>/        # 实际采用的图片参考及来源说明
+appspec/design/system/DESIGN.md          # 视觉语义与实现交接
+appspec/design/system/tokens.css         # 数值 token 的唯一可编辑来源
+appspec/design/prototypes/<task>/        # 仅在必要时保留的可运行交互原型
 ```
 
-原版已有设计系统清单优先原样保留。没有清单时可以使用下面的享搭来源索引，业务规则引用 AppSpec ID；它是可选交接记录，不是 OpenDesign 要求的格式：
+图片来源可以用工具无关的清单记录；字段只描述实际事实，不要求特定模型或提供商：
 
 ```json
 {
   "schema": "openxiangda.design-system/v1",
-  "capability": { "runtime": "OpenDesign", "version": "实际使用的原版版本", "projectId": "原版项目 ID" },
-  "methods": ["reference-design-contract", "frontend-design", "impeccable-design-polish"],
-  "runtimeVersion": "项目锁定的 openxiangda 精确版本",
+  "sources": [
+    {
+      "kind": "generated-image",
+      "model": "Image 2.5",
+      "path": "../references/request/desktop.png",
+      "viewport": "1440x1024",
+      "promptSummary": "内部事项办理台，紧凑主从布局"
+    }
+  ],
   "tokens": "tokens.css",
-  "design": "DESIGN.md"
+  "design": "DESIGN.md",
+  "status": "reviewed-reference"
 }
 ```
 
-运行时代码按构建步骤从 tokens.css 派生 AntD theme 与移动 CSS 变量，不另写数值表或全局偏好存储。标准应用用 `OpenXiangdaApplication` 的 `ui`；独立组件预览用 `OpenXiangdaUiProvider` 的同名参数。例：
+没有图片参考时省略 `sources` 和 `references`，不要创建占位文件。历史设计包已有其他来源
+字段时仍可读取，不要求为了新流程重写。业务规则引用 AppSpec ID，图片清单不复制权限、
+字段或页面协议。
+
+运行时代码从 `tokens.css` 派生 AntD theme 与移动 CSS 变量。标准应用使用
+`OpenXiangdaApplication` 的 `ui`，独立组件预览使用 `OpenXiangdaUiProvider` 的同名参数：
 
 ```tsx
 const ui = { theme: derivedAntdTheme, className: 'project-design' };
 <OpenXiangdaApplication {...applicationProps} ui={ui} />
 ```
 
-`.project-design` 下的样式只覆盖本应用。移动端使用可继承的 `--oxa-mobile-*` 输入，例如 `--oxa-mobile-color-primary: var(--accent)`；名称对应上游 `--adm-*`，可以放在应用根或 MobileSurface 上。嵌套字段会继承这些设计输入，未配置时保留组件默认值。直接在父级改 --adm-* 会被字段基础样式重新声明，应使用 --oxa-mobile-*。平台 Provider 将 PC 下拉、对话框、消息与通知留在当前应用作用域；移动封装沿用原有本地弹层。使用上下文反馈 API，避免 AntD 静态 API 脱离应用上下文。不要通过 theme 变化给整个应用换 key。若显式设置 AntD cssVar.key，使用与页面 className 不同的名字，避免把根容器布局施加到每个控件上。
+`.project-design` 下的样式只覆盖本应用。移动端使用可继承的 `--oxa-mobile-*` 输入；平台
+Provider 让 PC 下拉、对话框、消息与通知留在当前应用作用域。使用上下文反馈 API，避免
+AntD 静态 API 脱离作用域；不要通过 theme 变化给整个应用换 key，以免清空正在编辑的值。
 
-自定义任务表单可以从 `openxiangda/field-kit` 复用 `ResourceFormContent` 和 `ResourceFormDrawer`，传入受支持的字段定义、当前值、错误与提交回调；Drawer 可用 `title` 表达任务名称。它们只负责呈现，加载、保存和授权仍归现有业务所有者。不要为了改变外观重写字段值协议。
-
-维护仓库包含[可运行事项工作台样例](https://github.com/1377385356/openxiangda/tree/master/scripts/fixtures/design-workbench)，演示同一设计包、PC/移动字段、错误恢复与主题作用域。它是示例，具体设计未获得用户确认，也不代表生产数据或业务验收。复制时固定所用工具版本并更换为实际平台契约。浏览器检查还覆盖 reduced-motion：保留组件所需的动画完成事件，不能简单用全局 animation:none 让弹层停在初始隐藏态。
-
-在 `visual.md` 的 front matter 加入实际资源引用（路径从工作区根开始）：
+在 `visual.md` 的 front matter 中引用实际资源：
 
 ```yaml
 assets:
+  - appspec/design/references/request
   - appspec/design/system
-  - appspec/design/prototypes/request
 ```
 
-目录引用包含所有后代文件；新增、修改、删除任何依赖都会改变评审摘要，嵌套 DESIGN.md 是资源而非第二份 AppSpec 文档。原型自包含，外部参考链接不等于被固定的资源。只引用实际受评任务目录，避免无关原型让局部评审失效。原型使用的本地依赖要一起放在引用目录内；不能依赖临时缓存或目录外文件。
-
-引用拒绝越界、符号链接、空目录和超预算。每次检查最多 128 文件、单文件 2 MiB、总计 8 MiB、16 层目录。大媒体用可控的小型评审产物与来源说明；不要靠删资产声明绕过检查。资源只做摘要，`spec context` 不执行原型。修改后重新检查实际变化和受影响确认，不能只改摘要让旧确认复活。生产晋级核对测试提交中的相同资源。既有纯文字设计仍可读取，采用新原型时补全 assets。
-
-## 上游更新与项目升级 {#updates}
-
-原版运行时使用官方更新器或官方发行版升级；CLI 每次从当前安装读取入口和版本。进行中的设计在 AppSpec 记录实际版本与导出摘要。不要把 npm 包里的离线资料版本当成原版安装版本。下面的每日检查只维护随包离线资料，不替代原版更新器。
+目录引用包含所有后代文件；新增、修改或删除依赖都会改变评审摘要。引用拒绝越界、符号
+链接、空目录和超预算；每次检查最多 128 文件、单文件 2 MiB、总计 8 MiB、16 层目录。
+参考图应压缩为足以评审的尺寸，大型媒体放在受控来源并记录摘要，不靠删除 assets 声明
+绕过检查。`spec context` 只读取资源字节，不执行原型或图片内容。
 
-维护仓库的日常检查比较当前上游提交、选中文件和新增候选方法/模板，输出更新报告；它不改已安装能力或应用设计。固定原文的 hash、craft.requires、本地 checklist/许可和生成专题在仓库检查中一起核对，缺项明确失败。候选更新须评审真实差异，补充依赖与来源，更新适配后用可运行样例验证，再走 Changeset/主线/正式发布流程。
+## 完成标准 {#acceptance}
 
-项目只消费验证过的精确工具版本。升级时按[版本升级](upgrading.md)刷新 Skill 与 AGENTS，查看设计能力差异；进行中的已确认设计继续使用冻结版本，需要升级时重新评审受影响部分。网络失败或候选不合格保留原版本并报告原因。不要每次生成都临时下载上游 main。
+视觉完成至少同时具备：当前 AppSpec 设计范围、真实实现、目标视口截图、关键交互断言、
+无不可解释的浏览器错误，以及适用的真实角色允许/拒绝证据。图片模型的输出、Agent 自评、
+结构检查或组件样例只能是过程证据，不能单独宣称设计或业务验收通过。

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

@@ -20,7 +20,7 @@
 ## 选择平台能力 {#capabilities}
 
 - 普通数据管理：通过 `defineDataModel`、`defineApplicationModule` 和显式 CRUD 视图声明；模型不自动生成菜单或写权限。
-- 界面工作先按[OpenDesign 工作流](design-workflow.md)形成具体设计；设备范围按真实任务选择。复用平台导航和字段行为，自定义报表/工具使用 admin 页面与显式导航。详见[页面归属](frontend.md#surface-selection)。
+- 界面工作先按[Agent 原生设计工作流](design-workflow.md)形成具体视觉并直接实现真实页面；设备范围按真实任务选择。复用平台导航和字段行为，自定义报表/工具使用 admin 页面与显式导航。详见[页面归属](frontend.md#surface-selection)。
 - 用户页面按实际旅程选择独立 PC/移动布局，手机端只覆盖已确认的用户任务。
 - 图表等专业交互先检查已有依赖，再评估成熟组件或开源库；报表优先评估 ECharts，记录选型理由和加载/销毁边界。详见[组件选型](frontend.md#component-selection)。
 - 无平台账号的外部表单：使用[匿名公开访问](public-access.md)，不用普通 RBAC 角色冒充匿名主体。

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

@@ -14,13 +14,13 @@
 
 ## 先选页面归属，再写布局 {#surface-selection}
 
-管理后台的设备范围按实际办理任务确定。数据管理、录入和报表复用平台 Shell 的路由与菜单事实，视觉依据[OpenDesign 工作流](design-workflow.md)设计；存在手机办理任务时同步设计与验证。
+管理后台的设备范围按实际办理任务确定。数据管理、录入和报表复用平台 Shell 的路由与菜单事实，视觉依据[Agent 原生设计工作流](design-workflow.md)实现并在浏览器修正；存在手机办理任务时同步设计与验证。
 
-### 应用骨架优先与 OpenDesign 页面边界
+### 应用骨架优先与视觉页面边界
 
 标准管理后台是每个业务应用的默认开发骨架，必须保留后台 Shell、显式菜单、资源表单、数据列表、详情/编辑、权限和流程入口。开发顺序先完成后台资源与契约，再实现用户端 PC/移动端；不能以用户端首页或设计原型替代后台。
 
-OpenDesign 可以在标准后台内部优化布局、视觉和交互，但后台仍复用平台 Shell、导航、字段行为和权限。用户端 PC 与移动端可以分别采用 OpenDesign 的完整视觉和交互，通过平台 runtime/Data API 使用后台数据。禁止用单页 HTML、iframe 或自定义假后台替换标准后台，也不能把后台权限、导航状态复制到用户端。
+Agent 可以在标准后台内部优化布局、视觉和交互，但后台仍复用平台 Shell、导航、字段行为和权限。用户端 PC 与移动端按真实旅程分别设计，通过平台 runtime/Data API 使用后台数据。图片参考和原型不拥有业务事实；禁止用图片、单页 HTML、iframe 或自定义假后台替换标准后台，也不能把后台权限、导航状态复制到用户端。
 
 发布前分别验证后台入口、表单、数据列表、流程入口和用户端 PC/移动端入口；没有完成后台骨架的应用不得发布。
 

package/skills/openxiangda-v2/references/getting-started.md

@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.20.4 skill install --force
-pnpm dlx openxiangda@2.20.4 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.20.4 login --cwd my-app --base-url https://platform.example.com
-pnpm dlx openxiangda@2.20.4 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.21.0 skill install --force
+pnpm dlx openxiangda@2.21.0 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.21.0 login --cwd my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.21.0 create my-app --base-url https://platform.example.com
 cd my-app
 pnpm openxiangda context --json
 pnpm openxiangda dev
@@ -173,9 +173,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
 无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
 
 ```bash
-pnpm dlx openxiangda@2.20.4 auth status --base-url <平台> --json
-pnpm dlx openxiangda@2.20.4 source resolve <仓库URL> --base-url <平台> --json
-pnpm dlx openxiangda@2.20.4 source clone <仓库URL> <新目录> --base-url <平台> --json
+pnpm dlx openxiangda@2.21.0 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.21.0 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.21.0 source clone <仓库URL> <新目录> --base-url <平台> --json
 ```
 
 登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回

package/skills/openxiangda-v2/references/product-design.md

@@ -141,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）。
 
-有界面影响的工作默认由 AI 通过 design cli / 原版 MCP 使用 OpenDesign，完成可运行原型、浏览器修正及实现交接，见[设计工作流](design-workflow.md)。客户端仅用于用户主动预览；原版运行时拥有完整设计资源和工作流，随包方法与 Craft 仅作离线参考。
+有界面影响的工作默认由当前 AI Agent 完成视觉方向、真实页面实现和浏览器修正，见[设计工作流](design-workflow.md)。需要建立新方向时可按需使用 Image 2.5 等当前图片能力生成少量参考；图片不定义交互、权限或验收，采用的资源以 AppSpec assets 固定。