openxiangda 2.75.1 → 2.75.3

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": "d58e57c18421d0ebd54cd2222919249f8641b7142bbd45cb203b630899de0a64"
+      "sha256": "b46d8ad957e62af3e48d68d76e8eb0c052258883e9f193b288e10403ce6d7971"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

@@ -40,10 +40,10 @@ AI 接到新应用、页面或改版任务时，在同一个 OpenXiangda 工作
 未创建工作区时使用本 Skill 随根包发布的精确版本：
 
 ```bash
-pnpm dlx openxiangda@2.75.1 auth status --cwd <应用目录> --base-url <平台地址> --json
-pnpm dlx openxiangda@2.75.1 login --cwd <应用目录> --base-url <平台地址>
-pnpm dlx openxiangda@2.75.1 create <应用目录> --base-url <同一平台地址>
-pnpm dlx openxiangda@2.75.1 skill install --force
+pnpm dlx openxiangda@2.75.3 auth status --cwd <应用目录> --base-url <平台地址> --json
+pnpm dlx openxiangda@2.75.3 login --cwd <应用目录> --base-url <平台地址>
+pnpm dlx openxiangda@2.75.3 create <应用目录> --base-url <同一平台地址>
+pnpm dlx openxiangda@2.75.3 skill install --force
 ```
 
 创建前把产品要求的目标平台明确带入命令，不从旧登录态推断站点。已有工作区从原绑定恢复，平台不一致时先解决登录与目标，不改 link 文件跨站创建。

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

@@ -165,15 +165,22 @@ Nest后端注入请求作用域的 `OpenXiangdaWorkflowService`，调用 `delega
 
 目录进入独立流程图地址，刷新及浏览器返回保留所查看流程/版本。共享组件按需加载 React Flow 与 ELK 正交布局：所有线段横平竖直、转角为直角；支持画布平移、滚轮缩放、适应全图、聚焦选中和缩略导航。分支标签可选中，详情保留完整条件、顺序和来源；窄屏采用同源节点列表，方向键/Home/End 定位节点。画布布局上限为 200 节点、1024 连线，不提供拖改、删除或连线编辑。
 
+`WorkflowDiagram`可传入可选`variableChoices`，格式与`WorkflowDesigner`一致：以真实事实路径为键，值为`{ label, value }`选项数组。
+从当前生成模型目录取得选项，再按实际`subject.factProjection`映射，不在页面维护第二套业务字典。
+它只提供显示名称，不能新增变量、改写条件或授予权限；每个变量最多64个选项、字典最多128项，并按原事实类型校验。
+画布分支、提示和可访问列表使用同一中文说明，自定义分支名保留；未知值或类型不兼容时保留原始值，不猜测含义。
+宿主传给设计器的同一元数据也用于AI建议预览，但预览显示正确不证明模型连接或实际调用可用。
+只读图保留显式业务条件通向拒绝结果的分支，普通审批拒绝操作的专用终点仍由办理设置/历史说明。
+
 应用自定义管理页面可复用当前用户客户端和共享图组件：
 
 ```tsx
 import { useEffect, useState } from 'react';
-import { WorkflowDiagram } from 'openxiangda/react';
+import { WorkflowDiagram, type WorkflowVariableChoices } from 'openxiangda/react';
 import { loadWorkflowDefinitionGraph, type WorkflowGraphReadResult } from 'openxiangda/core';
 
-export function ReadableWorkflow({ workflowCode, version }: {
-  workflowCode: string; version: number;
+export function ReadableWorkflow({ workflowCode, version, variableChoices }: {
+  workflowCode: string; version: number; variableChoices?: WorkflowVariableChoices;
 }) {
   const [result, setResult] = useState<WorkflowGraphReadResult>();
   const [selected, setSelected] = useState('');
@@ -188,7 +195,7 @@ export function ReadableWorkflow({ workflowCode, version }: {
   }, [workflowCode, version]);
   if (error) return <p role="alert">{error}</p>;
   if (!result) return <p>正在读取流程</p>;
-  return <WorkflowDiagram graph={result.graph} selectedNodeId={selected} onSelectNode={setSelected} />;
+  return <WorkflowDiagram graph={result.graph} variableChoices={variableChoices} selectedNodeId={selected} onSelectNode={setSelected} />;
 }
 ```
 

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

@@ -298,11 +298,31 @@ await businessData.transaction({
 ```
 
 引用约束：引用对象只含 `operationIndex`（0..99 的整数）与 `field: 'id'` 两个键；
-只能指向索引更小的 create 操作；引用不得嵌套在数组或对象里。违反形状报
+只能指向索引更小的 create 操作；普通字段引用不得嵌套在数组或对象里，关联资源字段的快照见下节。违反形状报
 `OPENXIANGDA_NATIVE_DATA_TRANSACTION_REFERENCE_INVALID`，嵌套报
 `..._NESTED`，目标不可解析报 `..._UNRESOLVED`。任一操作失败时整个事务回滚，
 不会留下无成员的 club。
 
+### 关联资源字段保留快照
+
+`resource-ref.single` 字段仍需要资源代码、显示标签和 `value`。用 Nest 的
+`resourceSnapshot` 将前序 create 引用放在唯一受支持的快照 `value` 位置；
+裸 UUID 引用不能代替资源字段快照：
+
+```ts
+import { resourceSnapshot } from 'openxiangda/nest';
+const operations = [
+  { operation: 'create' as const, resourceCode: 'orders', data: { name: '订单' } },
+  { operation: 'create' as const, resourceCode: 'order-lines', data: {
+    order: resourceSnapshot('orders', { operationIndex: 0, field: 'id' }, '订单'),
+  } },
+];
+```
+
+快照的 `resourceCode` 必须与前序 create 的资源一致。只允许既有快照元数据，
+`value` 之外的对象、数组和 `snapshot` 中仍不接受事务引用；平台继续验证目标字段、
+引用和实际授权。字符串 ID 的 `resourceSnapshot` 调用保持原行为，助手不提交或重试请求。
+
 ## 业务动作与普通查询 {#business-action}
 
 `OpenXiangdaDataApiService` 按当前用户的普通资源、行和字段权限执行。具名业务动作使用 `OpenXiangdaBusinessDataApiService`：入口先检查该动作 capability，平台在精确应用和环境内以受信任后端执行，并保留发起人与动作审计。业务动作不能接受任意模型/字段/用户 ID 后不做业务校验；应用负责该动作的输入约束和业务不变量。

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

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

package/releases/2.72.0.json

@@ -1,36 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.72.0",
-  "status": "reviewed",
-  "title": "有界匿名具名查询",
-  "summary": "为匿名公开门户提供固定字段、排序、参数和签名游标的服务端具名查询，减少首页、搜索和排行的全量分页读取。",
-  "newFeatures": [
-    "frontend.publicAccess 支持 publicQueries 与 public.query，固定资源、字段投影、排序、limit 和参数绑定。",
-    "匿名浏览器 SDK 提供具名查询客户端；平台服务端复用公开字段、固定 publicFilters、RLS 和托管文件投影。",
-    "记录查询游标绑定查询、参数、签名和有界偏移，未知字段、参数、游标和超限请求直接拒绝。"
-  ],
-  "fixes": [
-    "公开目录页面可在具名查询声明存在时使用有界首屏查询，旧 public.list/public.read 策略保持兼容。",
-    "compiler、bundle、JSON Schema 和 server execution 统一校验 publicQueries，避免仅更新页面而绕过平台匿名访问合同。"
-  ],
-  "affectedUsers": [
-    "需要匿名首页、公开目录、搜索、排行或统计的 OpenXiangda V2 应用。"
-  ],
-  "upgradeSteps": [
-    "升级同一正式发行的 openxiangda、contracts、devkit-core 和 CLI 组合。",
-    "在匿名策略中声明 public.query 与 publicQueries，并按本应用字段配置固定排序和参数。",
-    "先在 TEST/preproduction 完成请求量、权限、游标失效和真实浏览器 PC/mobile 验收，再发布生产。"
-  ],
-  "knownLimitations": [
-    "本地构建和单元测试不代表学校站点已安装该平台组合。",
-    "现版本服务端 aggregate 查询返回固定 count；复杂维度和度量仍需单独声明与验证。"
-  ],
-  "compatibility": {
-    "node": "Node.js 24 or newer for maintained toolchain",
-    "generation": "OpenXiangda V2; V1 unchanged",
-    "platform": "anonymous-public named queries 1.0.0; existing anonymous public list/read policies remain compatible"
-  },
-  "issues": [],
-  "sha256": "cc2aaebd52707a5e6acf65319407411baa61aff689a2f5ea91294effd5f0ed31",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.72.0"
-}

package/releases/2.73.0.json

@@ -1,31 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.73.0",
-  "status": "reviewed",
-  "title": "匿名聚合查询与工作流作者体验",
-  "summary": "为匿名公开门户提供固定维度、度量和排序的有界聚合查询，并包含已评审的工作流作者体验改进。",
-  "newFeatures": [
-    "匿名 public.query 支持固定 aggregate dimensions、measures 和 order，并复用 publicFilters、Native RLS 与有界分页。",
-    "工作流作者体验改进随同一正式七包组合发布。"
-  ],
-  "fixes": [
-    "compiler、bundle、JSON Schema 和 server execution 对匿名聚合查询保持同一闭合合同。"
-  ],
-  "affectedUsers": [
-    "需要匿名首页统计、分类、学院分布或排行的 OpenXiangda V2 应用。"
-  ],
-  "upgradeSteps": [
-    "升级同一正式发行组合；在 TEST/preproduction 验证匿名聚合、游标、权限和浏览器性能。"
-  ],
-  "knownLimitations": [
-    "本地门禁不代表学校站点已安装该平台组合。"
-  ],
-  "compatibility": {
-    "node": "Node.js 24 or newer for maintained toolchain",
-    "generation": "OpenXiangda V2; V1 unchanged",
-    "platform": "anonymous-public named and aggregate queries 1.1.0; existing public list/read policies remain compatible"
-  },
-  "issues": [],
-  "sha256": "76468650e5afabd8c49c1b11655a8261044d2e6bc5e2916ae07225b073ee968c",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.73.0"
-}

package/releases/2.75.0.json

@@ -1,35 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.75.0",
-  "status": "reviewed",
-  "title": "匿名公开具名查询批量读取",
-  "summary": "为公开门户提供保留原平台权限的有界批量查询客户端，减少多个独立查询的网络往返，并修正聚合结果类型。",
-  "newFeatures": [
-    "createAnonymousPublicClient.queryBatch固定应用、环境和声明路由，按key/policy/query精确匹配逐项记录、聚合或错误回执。",
-    "每批最多10项、500条请求上限、64KiB输入，配套平台最多3项并发；不新增普通匿名Data API、权限缓存或Nest CRUD代理。"
-  ],
-  "fixes": [
-    "聚合items正确表示为直接含维度/指标的对象，不再声明成record.data；保留原value-only计数与单查询API。",
-    "缺失、重复、错位、超量或形状错误的批量回执明确拒绝，单项403/404/429/503不会变成空表或零。"
-  ],
-  "affectedUsers": [
-    "使用匿名公开目录、仪器卡片、首页统计或其他多个具名只读查询的OpenXiangda V2应用。"
-  ],
-  "upgradeSteps": [
-    "先部署支持POST anonymous-public/public/query-batch的正式平台版本，再升级官方SDK与CLI；旧平台404应报告并完成平台更新。",
-    "使用原bootstrap获取正式浏览器凭证；批次每项显式指定策略、查询与key，调用方逐项处理成功或错误，延续原固定过滤和字段白名单。",
-    "保持真实页面请求数、P95/LCP与多角色业务验收独立进行，批量HTTP成功不代表每项成功。"
-  ],
-  "knownLimitations": [
-    "批次由独立只读查询组成，不保证同一数据库快照；不支持写入、业务动作或通知。",
-    "本发行不代表任何客户站点已部署或页面性能已达标；普通列表服务端分页与应用接入另行验收。"
-  ],
-  "compatibility": {
-    "node": "Node.js 24 or newer for maintained toolchain",
-    "generation": "OpenXiangda V2; V1 unchanged",
-    "platform": "Requires anonymous-public/public/query-batch; each item reuses existing public policy and Native authorization"
-  },
-  "issues": [],
-  "sha256": "f5c80399d75664d6b7a58ad81bc5124cd4da188cf2893347337488996b4eb4d1",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.75.0"
-}

package/releases/2.75.1.json

@@ -1,37 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.75.1",
-  "status": "reviewed",
-  "title": "公开查询批量读取与排序优先级修复",
-  "summary": "提供保留原平台权限的有界批量公开查询，修复多字段排序被重排的问题，配套同步官方技能资料。",
-  "newFeatures": [
-    "createAnonymousPublicClient.queryBatch固定应用、环境和声明路由，按key/policy/query精确匹配逐项记录、聚合或错误回执。",
-    "每批最多10项、500条请求上限、64KiB输入，配套平台最多3项并发；不新增普通匿名Data API、权限缓存或Nest CRUD代理。"
-  ],
-  "fixes": [
-    "应用打包器和共享目标编译器均保留publicQueries.sort声明顺序；修改排序优先级会正确改变配置摘要。",
-    "聚合items正确表示为直接含维度/指标的对象，不再声明成record.data；保留原value-only计数与单查询API。",
-    "缺失、重复、错位、超量或形状错误的批量回执明确拒绝，单项403/404/429/503不会变成空表或零。"
-  ],
-  "affectedUsers": [
-    "使用匿名公开目录、仪器卡片、首页统计或其他多个具名只读查询的OpenXiangda V2应用。"
-  ],
-  "upgradeSteps": [
-    "先部署支持POST anonymous-public/public/query-batch的正式平台版本，再升级官方SDK与CLI；旧平台404应报告并完成平台更新。",
-    "升级后重新编译并发布TEST应用，以新不可变策略采用正确排序；不修改历史Head，不下载全表在前端弥补错误的前N选择。",
-    "使用原bootstrap获取正式浏览器凭证；批次每项显式指定策略、查询与key，调用方逐项处理成功或错误，延续原固定过滤和字段白名单。",
-    "保持真实页面请求数、P95/LCP与多角色业务验收独立进行，批量HTTP成功不代表每项成功。"
-  ],
-  "knownLimitations": [
-    "批次由独立只读查询组成，不保证同一数据库快照；不支持写入、业务动作或通知。",
-    "本发行不代表任何客户站点已部署或页面性能已达标；普通列表服务端分页与应用接入另行验收。"
-  ],
-  "compatibility": {
-    "node": "Node.js 24 or newer for maintained toolchain",
-    "generation": "OpenXiangda V2; V1 unchanged",
-    "platform": "Requires anonymous-public/public/query-batch; each item reuses existing public policy and Native authorization"
-  },
-  "issues": [],
-  "sha256": "3abc78c05afd7f71f1559f134f30a060c233e2a851adae71023c10e091ededb2",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.75.1"
-}