openxiangda 2.62.1 → 2.65.0

package/documentation/manifest.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": "openxiangda.documentation/v1",
-  "version": "2.62.1",
+  "version": "2.65.0",
   "topics": [
     {
       "id": "getting-started",
       "title": "安装与开始开发",
       "file": "getting-started.md",
-      "sha256": "c78c9ff8458fb24f261b81c164db499c40b190abd71005898f187e96f4f01429"
+      "sha256": "3ee403a88011c8b554e22326aaea7d7ee754f49e0fb3b3fa2cdb4e1e2c5c9b29"
     },
     {
       "id": "product-design",
@@ -56,17 +56,23 @@
       "file": "concepts.md",
       "sha256": "2c1445e9c86baa864087da585c7d613fff61745cdd9ebb9c83dcd2c3579c3c4a"
     },
+    {
+      "id": "application-templates",
+      "title": "源码模板与业务场景",
+      "file": "application-templates.md",
+      "sha256": "87fe39a04418d7225de53e8c0ab61ea457ba243e230019fe881676e3079cf34f"
+    },
     {
       "id": "frontend",
       "title": "页面与标准组件扩展",
       "file": "frontend.md",
-      "sha256": "0d122e3f9096a549f355ba88a4800b6473180a19b926e3748c84d51bb44f02b6"
+      "sha256": "838ead2993a05103a9bc30c8164d0b43448f62ef36d10d3e7d677f63a022c370"
     },
     {
       "id": "field-components",
       "title": "字段、表单与移动控件",
       "file": "field-components.md",
-      "sha256": "5d76266c583e43bdeaa6af055c2c02df221e539e4578fbedbc71b5fdee1e9eb0"
+      "sha256": "9b8e7f431186289c7c56489a647ad948a6a2d40f817a6ce1ab3bf5b85c2c83f7"
     },
     {
       "id": "data-authz",
@@ -84,7 +90,7 @@
       "id": "workflow-events",
       "title": "审批、事件与通知",
       "file": "workflow-events.md",
-      "sha256": "b395f2b17d5c1f4ecc4768fe06bc7dcf95436a29a61d50688fdacba01b5d07a1"
+      "sha256": "62e6ad70feb4a74e66b7b2fc0ab591fab244998044efa79340dd096dd53e92f2"
     },
     {
       "id": "backend",
@@ -150,13 +156,13 @@
       "id": "cli",
       "title": "CLI 命令参考",
       "file": "reference/cli.md",
-      "sha256": "f3f912eb9b151e460ce610b5ba7f67a4b30f56d62b8817871ec47b44622c07c7"
+      "sha256": "13821850bc6387d4c49605f8b5a3e795ee3f6a72780aa6ebe66ce54a8002bfbb"
     },
     {
       "id": "mcp",
       "title": "MCP 配置与工具参考",
       "file": "reference/mcp.md",
-      "sha256": "22ef30028c7d1f5a970508fcc0df5243dbfeaaa90235ab0172c31eba3f0eaf19"
+      "sha256": "0cf65d3b1e47399360222c5bfa1732fe9e1c1e99eb79072574b5ce533999bb2a"
     }
   ]
 }

package/documentation/reference/cli.md

@@ -8,7 +8,9 @@
 | `pnpm openxiangda context` | 只读 | 只读查看工作区、版本与平台绑定 |
 | `pnpm openxiangda docs` | 只读 | 按主题和章节读取当前版本中文资料 |
 | `pnpm openxiangda admin` | 远端变更 | 查看管理能力、自助操作契约，或按明确环境执行事件、密钥及通知操作 |
+| `pnpm openxiangda template` | 只读 | 列出场景、模块、布局和风格模板 |
 | `pnpm openxiangda create` | 远端变更 | 创建、绑定并初始化应用 |
+| `pnpm openxiangda workflow` | 远端变更 | 导出流程、导入到源码、规划版本登记、查看状态并显式同步到目标环境 |
 | `pnpm openxiangda source` | 远端变更 | 配置应用源码仓库、查看状态或提交推送 |
 | `pnpm openxiangda dev` | 本地写入 | 连接平台测试数据启动本地 Web，按需启动 Nest |
 | `pnpm openxiangda check` | 本地写入 | 生成契约并在目标平台预检后执行检查、测试和构建 |

package/documentation/reference/mcp.md

@@ -59,6 +59,25 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
 }
 ```
 
+## template_list
+
+发现源码模板。列出业务场景、模块依赖、四类源码外壳和主题；创建使用 CLI，不执行远端操作。
+
+- 只读：是
+- 可替换文件或改变远端状态：否
+- 幂等：否
+
+输入参数：
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {},
+  "additionalProperties": false
+}
+```
+
 ## workspace_context
 
 查看工作区。首先读取当前项目、工具链版本和绑定，不运行构建或创建远端对象。
@@ -1356,6 +1375,225 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
 }
 ```
 
+## workflow_sync
+
+同步流程到目标环境。按目标流程修订号显式同步，默认同时更新在途和新申请；复用发布及版本适用规则。保留指定人员边界。
+
+- 只读：否
+- 可替换文件或改变远端状态：是
+- 幂等：是
+
+输入参数：
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "workflowCode": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "fromEnvironment": {
+      "type": "string",
+      "enum": [
+        "test",
+        "production"
+      ]
+    },
+    "toEnvironment": {
+      "type": "string",
+      "enum": [
+        "test",
+        "production"
+      ]
+    },
+    "expectedSourceHeadRevision": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "expectedTargetHeadRevision": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 9007199254740991
+    },
+    "operationId": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "reason": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 1000
+    },
+    "scope": {
+      "type": "string",
+      "enum": [
+        "running_and_new",
+        "new_only"
+      ]
+    },
+    "acknowledgeExceptions": {
+      "type": "boolean"
+    },
+    "copyHandlingDefaults": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "workflowCode",
+    "fromEnvironment",
+    "toEnvironment",
+    "expectedSourceHeadRevision",
+    "expectedTargetHeadRevision",
+    "operationId",
+    "reason"
+  ],
+  "additionalProperties": false
+}
+```
+
+## workflow_export
+
+导出流程到工作区。只读导出环境中的规范定义、绑定和办理设置摘要；不包含运行记录或环境内部标识。
+
+- 只读：否
+- 可替换文件或改变远端状态：否
+- 幂等：否
+
+输入参数：
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "environment": {
+      "default": "test",
+      "description": "目标环境；默认 test，production 必须明确选择",
+      "type": "string",
+      "enum": [
+        "test",
+        "production"
+      ]
+    },
+    "workflowCode": {
+      "type": "string",
+      "minLength": 1
+    },
+    "out": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "required": [
+    "workflowCode",
+    "out"
+  ],
+  "additionalProperties": false
+}
+```
+
+## workflow_import
+
+把流程导入源码。验证代码能力和摘要后修改工作区显式流程声明，保留人员配置边界。
+
+- 只读：否
+- 可替换文件或改变远端状态：是
+- 幂等：否
+
+输入参数：
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "path": {
+      "type": "string",
+      "minLength": 1
+    },
+    "adoptHandlingDefaults": {
+      "default": false,
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "path"
+  ],
+  "additionalProperties": false
+}
+```
+
+## workflow_plan_registration
+
+规划流程版本登记。服务器只读查询已有摘要和下一版本数字；write 只写源码版本数字，不写环境观察。
+
+- 只读：否
+- 可替换文件或改变远端状态：否
+- 幂等：否
+
+输入参数：
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "environment": {
+      "default": "test",
+      "description": "目标环境；默认 test，production 必须明确选择",
+      "type": "string",
+      "enum": [
+        "test",
+        "production"
+      ]
+    },
+    "write": {
+      "default": false,
+      "type": "boolean"
+    }
+  },
+  "additionalProperties": false
+}
+```
+
+## workflow_status
+
+查看流程源码同步状态。比较源声明、导入基线和环境摘要，显示待导回源码、待部署或冲突及未启用版本数量。
+
+- 只读：是
+- 可替换文件或改变远端状态：否
+- 幂等：否
+
+输入参数：
+
+```json
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "environment": {
+      "default": "test",
+      "description": "目标环境；默认 test，production 必须明确选择",
+      "type": "string",
+      "enum": [
+        "test",
+        "production"
+      ]
+    },
+    "workflowCode": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "additionalProperties": false
+}
+```
+
 ## workflow_node_configurations
 
 查看流程有效参数。修改已部署流程前，读取管理员维护的节点配置。已有任务和后续节点进入使用各自适用版本。

package/documentation/workflow-events.md

@@ -1212,3 +1212,36 @@ subject update和来源guards提交实际改变的派生字段；普通补填仍
 不改变字段授权、审批参数或流程版本；不提供该选项的应用保持既有行为。
 
 `commandHandlers.resubmit` 仅绑定固定 correction 节点的业务重校验。普通 `return_review` 任务继续由 Kernel 标准 `resubmit` 办理：Surface 不返回 correction operationCode，审批人不需要起草提交 capability。无需增加 `taskKinds` 字段、改动已有定义版本或重建在途实例；直接对普通退回任务调用 correction 业务动作仍被拒绝。
+
+## 画布、源码与测试环境同步
+
+管理员可以在画布修改节点和条件并直接发布。发布默认更新在途申请与新申请，当前已经进入的任务继续保留其人员、操作按钮、页面与字段权限；后续流转使用新版本。只让新申请生效、保留个别在途申请属于显式例外。
+
+应用源码与画布共同引用同一份不可变定义和绑定登记。画布修改后，后续仅改页面或后端的应用部署会保留兼容的画布版本。两边都改了流程而基线不一致时，部署返回 `WORKFLOW_SOURCE_DIVERGED`，需要先把正式环境流程导回源码：
+
+```sh
+pnpm openxiangda workflow export request-review --environment production --out platform/workflows/request-review.bundle.json
+pnpm openxiangda workflow import platform/workflows/request-review.bundle.json --to source
+pnpm openxiangda workflow plan-registration --environment test --write
+pnpm openxiangda workflow status --environment test
+```
+
+`export` 包含规范定义、绑定、任务页面与代码步骤契约、办理设置摘要；不含申请、待办、审批日志、密钥或环境内部标识。源码本来声明的固定用户标识会保留；管理员实际指定人员的覆盖只导出数量。`import` 只改 `openxiangda.config.ts` 中显式的 `workflows` 声明及 `platform/workflows/<code>.lock.json`，保留其他代码。新增或变化的代码步骤、页面契约需要先由开发者补齐；缺少这些契约的导入会在写文件前拒绝。
+
+可加 `--adopt-handling-defaults` 把办理模式与按钮开关、文案作为源码默认值。它保留原有必需动作，不把管理员指定人员复制成源码默认值。导入的摘要基线写在源码 activation 的 `sourceBase`；来源环境与修订号只保留在审计锁文件，不进入密封应用制品。锁文件与导出的规范文档可能包含合法源码用户引用，应按项目访问权限管理。
+
+`plan-registration` 是服务器只读查询，返回相同内容已有的版本号或下一整数；`--write` 只把数字写入本机源码。最终准备仍检查编号冲突、内容冲突和跳号。准备成功但后续部署失败的版本保留为未启用的不可变登记，相同制品可复用这些数字；不会删除或重排。`status` 显示 `in_sync`、`behind`、`ahead`、`diverged`、`not_active` 和未启用登记数量。它没有远端写入。首次导入之前，状态比较使用目标环境当前应用版本的源码声明作为基线；跨环境导入的来源修订不会冒充目标环境基线。
+
+如果只希望把正式环境的流程规则同步到已有测试环境，可先读取两边的 `status`，记录实际流程 Head 修订号，再显式执行同步：
+
+```sh
+pnpm openxiangda workflow sync request-review --from production --to test \
+  --expected-source-head 14 --expected-target-head 3 \
+  --operation-id workflow-sync-20261012-01 --reason '同步正式环境流程到测试'
+```
+
+示例修订号必须替换成实际读取值。源和目标必须属于同一应用且均有已启用流程。同步检查目标现有页面、代码步骤、角色与固定人员引用，复用源版本，并通过正常发布与在途适用规则生效。默认同时更新在途和新申请；`--new-only` 只更新新申请。存在不兼容在途申请时，在确认预览结果后加 `--acknowledge-exceptions`，这些申请继续保留原版本。
+
+`--copy-handling-defaults` 可复制办理模式、按钮和角色覆盖；两边的指定人员覆盖都保持环境所有。源环境不被修改。同步后的目标画布草稿若基线已经过时，需要重读或合并，不能覆盖新的 Head。请求不确定时，保留相同操作标识、两个修订号和完整参数重试；不要换标识重做。CLI 与 MCP 共用这些权限、校验、幂等和发布入口。
+
+部署前记录目标流程修订号，激活前再次核对。期间若有人发布了画布，激活返回 `WORKFLOW_SOURCE_HEAD_CHANGED`，应用 Head 与流程 Head 在同一事务回滚；已准备的不可变登记保留。同步成功、源码检查成功、包发布与真实审批验收分别核对。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "2.62.1",
+  "version": "2.65.0",
   "description": "OpenXiangda 2.0 的统一命令、应用 SDK、MCP 与中文 AI 技能资料。",
   "type": "module",
   "main": "./dist/index.js",
@@ -52,7 +52,11 @@
       "types": "./dist/testing.d.ts",
       "import": "./dist/testing.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./resource": {
+      "types": "./dist/resource.d.ts",
+      "import": "./dist/resource.js"
+    }
   },
   "bin": {
     "openxiangda": "./bin/run.js"
@@ -87,13 +91,13 @@
     "dayjs": "1.11.18",
     "docx-preview": "0.3.7",
     "elkjs": "0.12.0",
-    "openxiangda-cli": "2.8.13",
-    "openxiangda-contracts": "2.78.0",
-    "openxiangda-devkit-core": "2.59.0",
+    "openxiangda-cli": "2.9.3",
+    "openxiangda-contracts": "2.81.0",
+    "openxiangda-devkit-core": "2.62.0",
     "openxiangda-legacy": "npm:openxiangda@1.0.269",
-    "openxiangda-mcp": "2.1.9",
-    "openxiangda-nest": "2.18.0",
-    "openxiangda-skill-kit": "2.3.100",
+    "openxiangda-mcp": "2.2.3",
+    "openxiangda-nest": "2.18.4",
+    "openxiangda-skill-kit": "2.3.104",
     "xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
   },
   "peerDependencies": {
@@ -159,37 +163,33 @@
   },
   "openxiangdaRelease": {
     "schemaVersion": "openxiangda.release-notes/v1",
-    "version": "2.62.1",
+    "version": "2.65.0",
     "status": "reviewed",
-    "title": "兼容非 HTTPS 私有入口的浏览器幂等操作",
-    "summary": "修复私有 HTTP 入口缺少 crypto.randomUUID 时工作流节点配置、路由和其他浏览器操作无法生成幂等标识的问题，统一使用 Web Crypto getRandomValues 回退生成 UUID。",
-    "newFeatures": [],
+    "title": "原生助手命令与工作流布局更新",
+    "summary": "发布已审阅的原生助手部分更新命令契约和工作流条件分支布局修复。",
+    "newFeatures": [
+      "原生助手更新使用有界 id、expectedRevision 和 data 命令结构。",
+      "保留字段声明必填属性并支持部分更新。"
+    ],
     "fixes": [
-      "工作流节点配置保存不再依赖安全上下文专属的 crypto.randomUUID，HTTP 预发入口可以正常提交并保留原操作 ID 重试。",
-      "统一修复浏览器端管理、工作流、资源批量、文件和草稿操作的 UUID 生成，避免同类私有 HTTP 部署故障。"
+      "修复 PC 工作流条件分支、默认分支和汇聚节点的对称布局。"
     ],
     "affectedUsers": [
-      "通过 HTTP 私有地址访问 OpenXiangda 管理后台或应用内工作流管理页面的用户。",
-      "使用工作流节点配置、路由、委托、恢复、资源批量和文件草稿等浏览器幂等操作的应用。"
+      "使用 OpenXiangda V2 原生助手或工作流画布的应用开发者"
     ],
     "upgradeSteps": [
-      "平台管理后台和应用统一升级到 openxiangda 2.62.1 与配套 CLI 2.8.13，重新生成封存七包。",
-      "部署后用 HTTP 预发入口保存一个工作流节点描述，确认后台 configuration.revision/history 有一次写入。",
-      "继续保留原请求 ID 语义，若结果未知只重试相同请求，不新建幂等键。"
+      "按同一候选版本更新 openxiangda、openxiangda-cli 与共享 contracts 包。"
     ],
     "knownLimitations": [
-      "浏览器仍需要 Web Crypto getRandomValues；极旧浏览器完全没有 Web Crypto 时会明确报错，不回退到可预测的 Math.random。",
-      "包版本升级和平台部署不替代真实角色权限、CAS 冲突和业务配置验收。"
+      "不改变既有业务数据、报销审批或财务提交副作用策略。"
     ],
     "compatibility": {
-      "generation": "v2",
       "node": ">=24",
-      "platform": "browser Web Crypto getRandomValues",
-      "v1": "独立1.x维护包不变"
+      "pnpm": "10.15.1"
     },
     "issues": [],
-    "sha256": "e818f70adf8c607af8a45465bfc67fee0fcb082102f4e973435b18b51525dd5b",
-    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.62.1"
+    "sha256": "02a56d082f6749c7949b47b8f7b03fd87b0a43475aead7f471eeb1b9a8533f6c",
+    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.65.0"
   },
   "scripts": {
     "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",

package/releases/2.64.0.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.64.0",
+  "status": "reviewed",
+  "title": "工作流与原生任务能力更新",
+  "summary": "汇总已审阅的工作流画布、并行流程、源码助手契约和应用代理选择能力更新。",
+  "newFeatures": [
+    "增强工作流画布节点、并行流程和能力目录配置。",
+    "增加应用源码助手契约及代理选择能力。"
+  ],
+  "fixes": [
+    "保持流程节点配置、提醒控制和发布后业务步骤的一致性。"
+  ],
+  "affectedUsers": [
+    "使用 OpenXiangda V2 工作流或源码助手能力的应用开发者"
+  ],
+  "upgradeSteps": [
+    "按同一候选版本更新 openxiangda、openxiangda-cli 与共享 contracts 包。"
+  ],
+  "knownLimitations": [
+    "不改变既有应用的业务数据和财务副作用策略。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "pnpm": "10.15.1"
+  },
+  "issues": [],
+  "sha256": "3b23d18a5381652b20281527402e8cd406a8666a4c9c392f93131104660705bc",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.64.0"
+}

package/releases/2.65.0.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.65.0",
+  "status": "reviewed",
+  "title": "原生助手命令与工作流布局更新",
+  "summary": "发布已审阅的原生助手部分更新命令契约和工作流条件分支布局修复。",
+  "newFeatures": [
+    "原生助手更新使用有界 id、expectedRevision 和 data 命令结构。",
+    "保留字段声明必填属性并支持部分更新。"
+  ],
+  "fixes": [
+    "修复 PC 工作流条件分支、默认分支和汇聚节点的对称布局。"
+  ],
+  "affectedUsers": [
+    "使用 OpenXiangda V2 原生助手或工作流画布的应用开发者"
+  ],
+  "upgradeSteps": [
+    "按同一候选版本更新 openxiangda、openxiangda-cli 与共享 contracts 包。"
+  ],
+  "knownLimitations": [
+    "不改变既有业务数据、报销审批或财务提交副作用策略。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "pnpm": "10.15.1"
+  },
+  "issues": [],
+  "sha256": "02a56d082f6749c7949b47b8f7b03fd87b0a43475aead7f471eeb1b9a8533f6c",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.65.0"
+}

package/skills/manifest.json

@@ -4,7 +4,7 @@
     {
       "name": "openxiangda-v2",
       "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发，通过对话发现模块、完成详细产品设计，由当前 AI Agent 按需用 Image 2.5 等图片能力形成视觉参考，直接实现真实页面并在浏览器修正，再检查和交付应用；维护 1.x 应用时使用对应的 1.x 技能。",
-      "sha256": "8f4e119b269e737dcae990bf348d0cbc7628323cf5c2dd35ec04a6e386fada69"
+      "sha256": "2d8f4a56a4e2996b573a81f6a3921abc921de976a0cc0c18e3e859fba67e0274"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

@@ -7,11 +7,11 @@ description: 使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具
 
 ## 应用结构基线（必须遵守）
 
-每个业务应用默认先建立并保留标准管理后台。管理后台是应用骨架，承载资源模型、表单、数据列表、详情/编辑、权限和流程入口；AI 必须先从后台完成数据与契约，再实现用户端体验。默认提供标准 Shell；需要定制后台外观时使用 `ui.admin.shell` 或局部插槽，保留平台后台路由、授权和显式业务菜单。
+有管理任务时选择后台源码模板；PC 用户端、移动用户端和登录外观分别选择布局与风格。先读取 [源码模板与业务场景](references/application-templates.md) 或 template list / MCP template_list，结合已确认业务选择初始化模块。已获开发与创建授权时直接执行，模板选择不增加确认步骤。
 
-Agent 按页面归属优化布局、视觉和交互：后台通过默认 Shell 或 `ui.admin` 扩展复用平台导航事实、字段行为和权限；用户端 PC 与移动端按真实任务分别设计，并通过平台 runtime/Data API 读取后台数据。图片参考不定义交互、权限或验收。不得用图片、单页 HTML、iframe 或独立假后台冒充管理后台，也不得在用户端复制后台权限和导航状态。
+应用拥有外壳与页面源码，可修改、替换或重构。通过 ui.admin.shell 保持唯一后台，通过 resourcePages 贡献替换资源页面，从 openxiangda/resource 组合列表块与控制器。平台继续拥有路由、身份、授权、数据和登录行为；不复制这些权威。既有应用保留 SDK fallback，不强制换模板；没有管理任务的应用可不添加后台。
 
-设计、实现和发布验收必须分别核验管理后台入口、表单、数据列表、流程入口，以及用户端 PC/移动端入口。缺少标准管理后台的应用结构不完整，不能发布。
+分别验证实际使用的后台、表单、列表及用户 PC/移动入口。图片只作为视觉参考，不代表运行或业务验收。
 
 ## 先理解任务
 
@@ -40,10 +40,10 @@ AI 接到新应用、页面或改版任务时，在同一个 OpenXiangda 工作
 未创建工作区时使用本 Skill 随根包发布的精确版本：
 
 ```bash
-pnpm dlx openxiangda@2.62.1 auth status --cwd <应用目录> --base-url <平台地址> --json
-pnpm dlx openxiangda@2.62.1 login --cwd <应用目录> --base-url <平台地址>
-pnpm dlx openxiangda@2.62.1 create <应用目录> --base-url <同一平台地址>
-pnpm dlx openxiangda@2.62.1 skill install --force
+pnpm dlx openxiangda@2.65.0 auth status --cwd <应用目录> --base-url <平台地址> --json
+pnpm dlx openxiangda@2.65.0 login --cwd <应用目录> --base-url <平台地址>
+pnpm dlx openxiangda@2.65.0 create <应用目录> --base-url <同一平台地址>
+pnpm dlx openxiangda@2.65.0 skill install --force
 ```
 
 创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。

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

@@ -0,0 +1,37 @@
+# 源码模板与业务场景
+
+## 选择与创建 {#create}
+
+模板是应用源码的初始化，不是不可编辑的 SDK 页面。后台、PC 用户端、移动用户端和登录外观分别选择布局；公共登录行为继续由 SDK 提供。既有 builtin:application 保持基础空应用。
+
+先运行 `openxiangda template list --json`，或读取 MCP template_list。已确定业务和授权创建时直接初始化，无需为模板选择增加确认。
+
+```bash
+openxiangda create ./visitor-app --base-url <测试平台> --scenario visitor
+openxiangda create ./records-app --base-url <测试平台> --scenario crud --style graphite-blue
+openxiangda create ./visitor-app --base-url <测试平台> --scenario visitor --admin topbar --pc workbench --mobile task-list --login centered
+```
+
+with/without 接受逗号分隔模块。未知场景、布局、风格、模块及缺失依赖在物化前报错。访客默认包含 time-slot、pass-and-checkin、party-directory、my-records；没有应用后端或工作流。移除依赖模块时必须同时移除依赖它的模块。创建到已有工作区只恢复原来源；不能换一套模板覆盖应用源码。
+
+## 源码所有权 {#ownership}
+
+后台外壳位于 apps/web/src/frames/admin/AdminShell.tsx；PC/移动 frame 位于同目录；登录布局位于 apps/web/src/login；样式位于 apps/web/src/theme；后台资源页位于 apps/web/src/admin。开发者可复制、修改、替换、重构，平台不会自动覆盖这些文件。通用模板修复由各应用选择采用。
+
+唯一后台通过 ui.admin.shell 挂载，菜单和路径来自平台已授权模型。保留 SDK 的路由及权限边界。应用页面通过 resourcePages 的 resource/view/list/detail/form contribution 挂载；未声明的页面沿用 SDK fallback。用户端通过 standardUserSurfaces 和普通页面贡献使用同一个应用路由。
+
+## 修改列表 {#resource-list}
+
+从 openxiangda/resource 导入 useResourceListController 和 ResourceListActions、ResourceListQueryBar、ResourceListAdvancedFilter、ResourceListAppliedFilters、ResourceListTable、ResourceListBatchBar、ResourceListOverlays 等块。控制器拥有数据、查询、列偏好、选择和获准动作；页面决定布局。columnRenderers 可替换可读列展示。移动端使用 useMobileResourceListController 与对应块。SDK 默认页使用相同边界。
+
+resourcePages: { visits: { default: { list: VisitListPage } } } 按资源和视图注册。应用组件获得 definition、paths、mode 和 variant；路由先核验生成声明、读取/动作能力，再渲染贡献页。隐藏列不授予权限，新增视觉动作仍由服务器校验。
+
+模板带 check:imports，解析真实 TypeScript 导入并核验包 exports；不允许私有 dist/src 深导入。资源 detail/form 先提供已有块，独立控制器继续扩展。
+
+## 登录与验收 {#login}
+
+登录模板消费 SDK 提供的 methods、state、error、passwordLogin、startSso、startDingTalk。支持账号密码、组织配置的 SSO/钉钉、验证码挑战、恢复身份和错误反馈；不建立第二个登录态，不显示未配置的入口。
+
+访客角色起点：host 可邀请且读取自己创建的记录；front_desk 可进入唯一后台并登记到访，数据范围由平台策略约束。区域及角色为示例，接入实际组织前按业务修改。简单 CRUD 场景提供表单、我的记录和后台数据管理。
+
+验收分别记录本地编译、浏览器、测试平台、实际角色和业务回读。模板初始化和设计图不是已部署业务。先 check，再按已授权环境验证邀请→接待→状态回读，桌面及 390px 均覆盖。参考[页面与标准组件](frontend.md)、[无账号访问](public-access.md)和[校验](testing.md)。

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

@@ -8,7 +8,9 @@
 | `pnpm openxiangda context` | 只读 | 只读查看工作区、版本与平台绑定 |
 | `pnpm openxiangda docs` | 只读 | 按主题和章节读取当前版本中文资料 |
 | `pnpm openxiangda admin` | 远端变更 | 查看管理能力、自助操作契约，或按明确环境执行事件、密钥及通知操作 |
+| `pnpm openxiangda template` | 只读 | 列出场景、模块、布局和风格模板 |
 | `pnpm openxiangda create` | 远端变更 | 创建、绑定并初始化应用 |
+| `pnpm openxiangda workflow` | 远端变更 | 导出流程、导入到源码、规划版本登记、查看状态并显式同步到目标环境 |
 | `pnpm openxiangda source` | 远端变更 | 配置应用源码仓库、查看状态或提交推送 |
 | `pnpm openxiangda dev` | 本地写入 | 连接平台测试数据启动本地 Web，按需启动 Nest |
 | `pnpm openxiangda check` | 本地写入 | 生成契约并在目标平台预检后执行检查、测试和构建 |

package/skills/openxiangda-v2/references/field-components.md

@@ -121,7 +121,16 @@ import { AttachmentFileList } from 'openxiangda/field-kit';
 }
 ```
 
-来源端点接受当前表单绑定值、关键字和游标；页大小由 `source.pageSize` 固定。
+来源端点接受关键字和游标；页大小由 `source.pageSize` 固定。创建表单使用 `operation: 'create'` 和当前绑定值。
+普通编辑表单使用 `operation: 'update', record: { id, expectedRevision }`，只传实际编辑的 `bindings`；平台以已保存记录合并这些编辑，检查行/字段更新权限及记录版本。没有编辑的绑定即使不可读，也由服务端参与查找，不返回它的原值。清空绑定传 `null`；最终提交仍由普通 Data API 验证必填和引用规则。
+
+列表筛选使用 `operation: 'filter'`：只需要宿主资源及字段的读取权限，目标保持当前用户的读取投影和行策略。写入 `source.filters` 不参与筛选，所以历史停用或已不满足写入条件的引用仍可查询；调用中不能携带 `bindings`、`record`、`launch`、`action` 或任务上下文。如需只展示某一类身份，可声明至多 20 个常量条件，例如 `filterWhere: [{ field: 'kind', operator: 'eq', value: 'building' }]`；支持 `eq`/`in`，不接受字段绑定。没有目标资源读取权限时，不会返回候选。
+
+普通生成表单自动传入保存上下文和实际编辑。自定义编辑表单通过 `SurfaceFieldRenderers.referenceBindings` 提供编辑值，`SurfaceFieldControl`/`MobileSurfaceFieldControl` 根据 `recordId` 和 `expectedRevision` 发送同样上下文。直接使用 `ResourceReferenceField` 时提供 `record` 和 `bindingEdits`。不传绑定编辑即使用保存值，不用把不可读字段填进浏览器。
+
+目录筛选通过现有目录检索的 `purpose: 'filter'` 返回可选的历史停用项，并标明停用；普通成员选择仍只接受有效项。范围来源支持 `operation: 'filter'`，使用读取范围授权，包含停用身份；自定义范围筛选控件使用 `renderScopeFilter`，与编辑态 `renderScope` 分开。
+
+含这些引用/目录字段或来源维度的编译包自动要求 `data.field-source-contexts` 版本 `1.0.0`，目标平台先升级后才能交付新包。
 标准流程的具名动作发起表单由 `WorkflowSubmissionPage` 自动传递 `launch: { workflowCode, operationCode }`。
 平台核对当前环境已部署的流程、动作、输入字段映射和当前用户动作权限；不要求额外授予宿主表单 CRUD 权限。
 普通 CRUD 表单不传此绑定，继续检查对应创建/修改权限。自定义选择器可通过 `searchResource` 的同名选项传递