openxiangda 2.74.1 → 2.75.2

package/skills/openxiangda-v2/SKILL.md

@@ -40,10 +40,10 @@ AI 接到新应用、页面或改版任务时，在同一个 OpenXiangda 工作
 未创建工作区时使用本 Skill 随根包发布的精确版本：
 
 ```bash
-pnpm dlx openxiangda@2.74.1 auth status --cwd <应用目录> --base-url <平台地址> --json
-pnpm dlx openxiangda@2.74.1 login --cwd <应用目录> --base-url <平台地址>
-pnpm dlx openxiangda@2.74.1 create <应用目录> --base-url <同一平台地址>
-pnpm dlx openxiangda@2.74.1 skill install --force
+pnpm dlx openxiangda@2.75.2 auth status --cwd <应用目录> --base-url <平台地址> --json
+pnpm dlx openxiangda@2.75.2 login --cwd <应用目录> --base-url <平台地址>
+pnpm dlx openxiangda@2.75.2 create <应用目录> --base-url <同一平台地址>
+pnpm dlx openxiangda@2.75.2 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/getting-started.md

@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.74.1 skill install --force
-pnpm dlx openxiangda@2.74.1 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.74.1 login --cwd my-app --base-url https://platform.example.com
-pnpm dlx openxiangda@2.74.1 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.75.2 skill install --force
+pnpm dlx openxiangda@2.75.2 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.75.2 login --cwd my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.75.2 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.74.1 auth status --base-url <平台> --json
-pnpm dlx openxiangda@2.74.1 source resolve <仓库URL> --base-url <平台> --json
-pnpm dlx openxiangda@2.74.1 source clone <仓库URL> <新目录> --base-url <平台> --json
+pnpm dlx openxiangda@2.75.2 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.75.2 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.75.2 source clone <仓库URL> <新目录> --base-url <平台> --json
 ```
 
 登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回

package/skills/openxiangda-v2/references/public-access.md

@@ -254,3 +254,28 @@ const publicDetail = await client.getPublic(publicPage.items[0].data.id as strin
 8. 生产入口为 HTTPS，没有新增公开存储桶或匿名上传白名单。
 
 开发与交付时按[检查与验收](testing.md)保留跨浏览器正反证据。
+
+
+## 匿名具名查询的有界批量读取
+
+需要多个独立公开查询时，使用官方 `createAnonymousPublicClient({ routeCode }).queryBatch(operations)`。先按正常公开入口完成 `bootstrap()`，使用同一浏览器匿名凭证；每项显式给出 `key`、`policyCode`、`queryCode`，可带原查询的 `parameters`、`limit`、`cursor`。批次固定当前应用、环境和一个已声明route，不接受浏览器传入SQL、字段、排序、角色或授权上下文。
+
+```ts
+const client = createAnonymousPublicClient({ routeCode: 'public-home', policyCode: 'catalogue' });
+await client.bootstrap();
+const batch = await client.queryBatch([
+  { key: 'summary', policyCode: 'catalogue', queryCode: 'summary', limit: 1 },
+  { key: 'cards', policyCode: 'catalogue', queryCode: 'cards', limit: 9 },
+]);
+for (const item of batch.items) {
+  if (!item.ok) throw new Error(`${item.error.code} (${item.error.status})`);
+  if (item.result.kind === 'records') {
+    // 记录行使用 record.data；聚合行是直接含指标/维度的对象。
+    console.log(item.result.items.map(record => record.data));
+  }
+}
+```
+
+服务端每批最多10项、合计最多500条请求上限、输入最多64KiB，最多3项并发；每项继续执行原不可变策略、固定条件、字段白名单、限流和真实RLS。批量结果按key/策略/查询精确对应，单项403/404/429/503保留为error；不能把整批HTTP成功当作每项成功，也不能把拒绝变成空表/零。SDK对缺失、重复、错位、超量及错误形状的回执明确拒绝，不自动改走普通Data API或逐项重放。
+
+此能力需要正式平台提供 `POST .../anonymous-public/public/query-batch`；旧平台的404应明确报告并先升级平台。批次是独立只读查询组合，不是同一数据库快照，不承载写入或通知。原单查询API继续可用，`AnonymousPublicQueryResult`、`AnonymousPublicQueryBatchOperation`、`AnonymousPublicQueryBatchResult`等类型从`openxiangda/react`导出。

package/releases/2.68.1.json

@@ -1,33 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.68.1",
-  "status": "reviewed",
-  "title": "原部署运行的流程例外只读预览",
-  "summary": "按平台能力读取失败 DeploymentRun 的冻结候选、当前 Head 和真实流程例外，支持在独立诊断目录使用公开 SDK 读取旧工作区会话。",
-  "newFeatures": [
-    "`status <deployment-id> --workflow-exceptions` 只读展示原运行的例外及完整集合摘要，不确认或重试。",
-    "独立精确版本 devkit 客户端可读取旧工作区 link/session，无需更改应用 package、lock 或冻结包。"
-  ],
-  "fixes": [],
-  "affectedUsers": [
-    "发布包含工作流的 V2 应用的开发者和管理员。"
-  ],
-  "upgradeSteps": [
-    "平台需先提供 deployment.workflow-adoption-preview 1.0.0 能力；无能力时明确停止。",
-    "使用本版根包或独立 openxiangda-devkit-core 2.67.0 诊断目录；旧应用不必为了查看例外升级依赖。",
-    "保留原 DeploymentRun ID，先核对完整例外；生产仍只晋级已验收 TEST 原版本。"
-  ],
-  "knownLimitations": [
-    "本批仅提供预览，不提供例外确认、事实转换或原 Run 恢复通道。",
-    "truncated=true 不代表已观察完整明细；预览不授予激活许可。",
-    "包发行不等于平台部署或真实业务验收；source/status 的独立500故障不在此修复中。"
-  ],
-  "compatibility": {
-    "node": "Node.js 24 or newer for maintained toolchain",
-    "generation": "OpenXiangda V2; no V1 migration",
-    "platform": "New read-only preview requires deployment.workflow-adoption-preview 1.0.0; contracts remains 2.88.0"
-  },
-  "issues": [],
-  "sha256": "859687bd04474e031528a651304916e7535919419aa697ec1892ff5b17cdf666",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.68.1"
-}

package/releases/2.69.1.json

@@ -1,32 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.69.1",
-  "status": "reviewed",
-  "title": "流程画布按需面板与连续分支保存修复",
-  "summary": "修复流程设计器的常驻面板、连续条件路由断线及带可读名称的草稿无法保存。",
-  "newFeatures": [],
-  "fixes": [
-    "流程大纲默认隐藏，节点设置默认关闭；选择节点后按需打开配置，浮层不挤压编辑画布。",
-    "相邻条件区域只拥有各自分支，汇合目标保持单一位置；连续条件和嵌套并行的连线接回实际目标节点。",
-    "正式流程文档schema接受已有readability元数据，保留闭集字段、长度与数量上限及原业务权限校验。"
-  ],
-  "affectedUsers": [
-    "使用V2流程设计器编辑或维护审批流程的应用。"
-  ],
-  "upgradeSteps": [
-    "安装精确openxiangda 2.69.1官方组合并重新检查、构建应用。",
-    "平台后端同步正式contracts包及同源回执后，才具备草稿保存schema修复；应用自行维护流程列表和独立画布路由。"
-  ],
-  "knownLimitations": [
-    "不修改历史实例、审批边界或业务拓扑；此版本不包含原DeploymentRun例外ack接口。",
-    "包发行不等于平台部署或现场草稿保存验收，已有未保存输入需保留。"
-  ],
-  "compatibility": {
-    "node": "Node.js 24 or newer for maintained toolchain",
-    "generation": "OpenXiangda V2; V1 unchanged",
-    "platform": "平台后端须消费本轮正式contracts及配套组合；原权限、revision和operationId守卫保持"
-  },
-  "issues": [],
-  "sha256": "529eee3d6d426c149635e6143310ff6a4a01da6c7243e203ff959f9d3b34a4b5",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.69.1"
-}

package/releases/2.70.2.json

@@ -1,32 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.70.2",
-  "status": "reviewed",
-  "title": "首部节点插入与补正回放修复",
-  "summary": "首部插入人工、条件、业务或并行节点时，原子更新流程入口和补正重提交入口，保留新首审批与严格校验。",
-  "newFeatures": [],
-  "fixes": [
-    "首部插入同步补正回放目标，多补正和连续插入删除保留完整路径。",
-    "补正可达性遍历并行和汇合后继，保留禁止正向进入补正与退回源必须可达的规则。"
-  ],
-  "affectedUsers": [
-    "使用流程画布首部插入、补正重提交或并行结构的V2应用。"
-  ],
-  "upgradeSteps": [
-    "安装同源完整七包并配套后端共享校验器，核对纯校验器摘要。",
-    "从合同现场2.69.1升级继承组织授权、业务待办与旧审批接续合同；两份正式SQL须通过完整门禁和目标预检。完整配套已获授权。",
-    "应用更新前通过官方源码导出和注册保护保留现场流程第13版；不以旧源码覆盖或重放未保存草稿。"
-  ],
-  "knownLimitations": [
-    "鼠标消失未复现，本地拖动及失焦恢复正常不代表现场问题已修复。",
-    "包发行不代表部署或真实角色验收；安装接续能力不授权调用旧审批接续、重放通知或晋级生产。"
-  ],
-  "compatibility": {
-    "node": "Node.js 24 or newer for maintained toolchain",
-    "generation": "OpenXiangda V2; V1 unchanged",
-    "platform": "同源contracts纯校验器；从171017升级包含AddNativeOrganizationAuthorizationV2和AddWorkflowLegacyAdoptionsV2 SQL，目标预检不可省略。"
-  },
-  "issues": [],
-  "sha256": "d4cd6182b5f50770489b6615a5207dc0590e6a88f1d3fb635a8cf0defc0e8dd8",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.70.2"
-}

package/releases/2.74.0.json

@@ -1,37 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.74.0",
-  "status": "reviewed",
-  "title": "原生审批人来源与中文参数编辑",
-  "summary": "流程源码可以开放有界的部门主管、逐级主管和表单成员参数；配套平台支持在普通来源、条件规则与新节点中使用同一份已发布目录。",
-  "newFeatures": [
-    "Workflow authoring.peopleSources 声明当前AppVersion拥有的来源模板、中文标题及参数枚举或整数范围，浏览器不能扩大源码授权上限。",
-    "部门主管成为标准条件人员来源；配套平台显式返回 nativePeopleAuthoring 后，已发布审批或办理节点也能编辑完整原生人员来源。",
-    "部门字段、主管级别、审批终点、连续办理和无人策略以中文说明呈现，保存仍使用原始类型值。"
-  ],
-  "fixes": [
-    "完整人员来源投影保留主管及部门参数，不把另一旧角色来源的scope、routing或人数约束混入新来源；旧principal-only编辑保持原限制。",
-    "普通来源与条件规则切换时正确注册并观察表单人员类型，保留整份来源，避免空配置或丢失原生条件叶。",
-    "模板目录不使后续步骤事实提前可用；非法参数、缺少组织上下文、未知值和不安全JSON结构失败关闭，连续主管必须使用允许的依次审批模式。"
-  ],
-  "affectedUsers": [
-    "在PC流程画布配置部门主管、逐级主管、表单成员或条件审批人的OpenXiangda V2应用管理员和开发者。"
-  ],
-  "upgradeSteps": [
-    "使用本次正式工具组合，并升级采用配套contracts与目录/投影服务的后端；核对真实 nativePeopleAuthoring 标志，不从SDK版本推断平台已支持。",
-    "应用在源码声明真实输入事实和明确的参数上限，再按正规流程版本规划、应用TEST部署和实际角色验证接入；保留原节点、默认人员、在途冻结快照及source-base。"
-  ],
-  "knownLimitations": [
-    "本地合成HTTP、门禁或npm发行不代表客户平台已部署，也不代表真实组织主管解析、AI模型或OCR验收已通过。",
-    "未开放的provider、routing、委托和范围维度仍由源码拥有；抄送、发起自选及应用provider不通过通用参数控件扩权。",
-    "旧平台没有显式原生作者能力时保留旧编辑路径；源码采用新authoring字段后，不能直接回退到不认识该声明的旧内核。"
-  ],
-  "compatibility": {
-    "node": "Node.js 24 or newer for maintained toolchain",
-    "generation": "OpenXiangda V2; V1 unchanged",
-    "platform": "Paired workflow released-catalog/node-configuration services and contracts; nativePeopleAuthoring must be explicitly advertised"
-  },
-  "issues": [],
-  "sha256": "72e5e3e9b12305bf729a5ec117b7320389e66459478ac8656e2e1627a770c298",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.74.0"
-}

package/releases/2.74.1.json

@@ -1,31 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.74.1",
-  "status": "reviewed",
-  "title": "隔离共用人员来源的节点级主管校验",
-  "summary": "修复给单个节点配置逐级主管时，错误要求其他共用同一源码绑定的节点也改变审批模式的问题。",
-  "newFeatures": [],
-  "fixes": [
-    "普通来源与条件规则的主管叶校验只检查当前被编辑节点，不将节点覆盖误当作共享源码绑定的全局修改。",
-    "保留完整原图、步骤输出及事实支配关系校验；全局源码绑定变更仍对全部真实引用执行严格主管规则。"
-  ],
-  "affectedUsers": [
-    "多个审批或办理节点共用角色来源，并为其中一个节点选择逐级主管的OpenXiangda V2应用。"
-  ],
-  "upgradeSteps": [
-    "消费同批正式工具组合与共享contracts，更新配套平台后在TEST验证普通及条件来源、节点模式和真实角色。",
-    "无需修改另一节点、复制业务绑定、改历史任务或重放审批来绕过旧误报。"
-  ],
-  "knownLimitations": [
-    "本修复不配置真实组织主管，也不代表AI模型、OCR、真实角色或客户部署已验收。",
-    "沿用原生人员来源的已发布参数上限、组织上下文、逐级连续办理必须sequence及在途冻结边界。"
-  ],
-  "compatibility": {
-    "node": "Node.js 24 or newer for maintained toolchain",
-    "generation": "OpenXiangda V2; V1 unchanged",
-    "platform": "Paired workflow source catalogue and node-configuration services; shared native validator must match this release"
-  },
-  "issues": [],
-  "sha256": "9a8e5febf8450b1fe748c1131fc9cdbaa8ad577f07879ff9f3de81e06ca94263",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.74.1"
-}