openxiangda 2.60.1 → 2.61.1

package/releases/2.20.1.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.20.1",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.20.1：contracts 资源级审计列排序修复",
+  "summary": "openxiangda-contracts 修复资源级 surface list defaultSort 对平台审计列（created_at/updated_at 等）的 fail-closed 误拒：与命名视图 defaultSort、Data API order 的系统列规则对齐。devkit 与 openxiangda 2.20.0 已含的行为不变。",
+  "newFeatures": [
+    "资源级 surface list defaultSort 支持平台审计列（created_at/updated_at/created_by/updated_by/id/revision），不再按未知字段 fail-closed；补回归测试。"
+  ],
+  "fixes": [],
+  "affectedUsers": [
+    "所有使用数据策略、行级权限、匿名公开访问的 OpenXiangda 2.0 应用开发者与 AI 开发会话。"
+  ],
+  "upgradeSteps": [
+    "应用把 openxiangda 精确钉扎到 2.20.0 并重跑 pnpm openxiangda check；出现新告警/报错时按提示调整策略声明。",
+    "使用 created_by 行规则需平台服务端配套版本；升级前请确认平台列车已包含该修复。"
+  ],
+  "knownLimitations": [
+    "created_by 行规则的运行时 WITH CHECK 正向匹配修复仍随平台列车交付。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "无强制平台配合要求；created_by 行规则的运行时生效需平台列车跟进。",
+    "v1": "V1 工作区不受影响。"
+  },
+  "sha256": "043a0bdb2615be80b4efff4a9f2e58107965e261e9294050a1decee22a6b7e6c",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.20.1"
+}

package/releases/2.20.2.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.20.2",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.20.2：应用制品断线去重修复",
+  "summary": "Devkit 按平台制品收据的规范分类复用已验证的 Application v2 制品。修复 frontend/config/contracts/manifest 在平台已有相同摘要时仍重复完整上传的问题，保持 AppPackage 字节、权限和部署状态的原有权威边界。",
+  "newFeatures": [],
+  "fixes": [
+    "断线恢复时，仅在摘要、平台规范分类、Content-Type 和字节大小都匹配时复用已存制品；已存的大前端制品不再重复上传。"
+  ],
+  "affectedUsers": [
+    "经慢速或易断网络向支持 Application v2 制品收据的私有平台部署应用的 OpenXiangda 2.0 开发者。"
+  ],
+  "upgradeSteps": [
+    "将应用钉扎的 openxiangda-devkit-core 更新到 2.18.2，并按锁文件安装；如统一入口也被钉扎则升级到 openxiangda 2.20.2。",
+    "先回读原 DeploymentRun 和环境 Head；若此前失败仅发生在制品上传且无新运行，按 CLI 的可重试指针从原候选执行 deploy。"
+  ],
+  "knownLimitations": [
+    "平台尚未存储的制品仍需完整上传；本修复不能改善首次传输的链路速度或替代真实角色、CAS、人事与通知业务验收。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "复用需要平台 Application v2 GET 制品收据返回规范分类、摘要、媒体类型和字节大小；无新数据库迁移。",
+    "v1": "V1 工作区与维护引擎不受影响。"
+  },
+  "sha256": "f5a6101d822234b7f1bf093c878692b94144f64dd829e99e72dc241780d5909e",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.20.2"
+}

package/releases/2.20.3.json

@@ -0,0 +1,29 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.20.3",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.20.3：标准日期时间选择修复",
+  "summary": "修复指定时区的 PC 标准日期时间控件缺少小时和分钟列的问题，普通字段、生成表单、筛选与范围共用修复，不改变 UTC 存储和移动端协议。",
+  "newFeatures": [],
+  "fixes": [
+    "分钟精度显式显示时、分列，秒精度显式显示时、分、秒列。CLI 新应用模板同步钉扎修复后的根包。"
+  ],
+  "affectedUsers": [
+    "使用 Field Kit 指定时区日期时间输入的 OpenXiangda 2.0 应用。"
+  ],
+  "upgradeSteps": [
+    "将应用精确依赖升级到 openxiangda 2.20.3，按锁文件安装并验证日期选择后发布预发布版本。"
+  ],
+  "knownLimitations": [
+    "服务端业务时间窗、权限、DST 不存在和重复墙上时间校验保持原约束。本修复不替代应用真实角色验收。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "无需服务端或数据库迁移。",
+    "v1": "V1 工作区与维护引擎不受影响。"
+  },
+  "sha256": "bd5d7d513df7ccc123d949842a5a987e585002848e98d52569190a687b212464",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.20.3"
+}

package/releases/2.20.4.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.20.4",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.20.4：Native 事件审计来源契约修复",
+  "summary": "严格接收平台已有的 Native 数据事件操作来源审计信息，避免具名业务动作和封存数据修复事件在处理器执行前被错误拒绝。",
+  "newFeatures": [],
+  "fixes": [
+    "Native 事件 actor 显式支持有界 initiatedBy、businessAction 和 platformMaintenance；未知字段、凭据形字段和错误签名仍严格拒绝。"
+  ],
+  "affectedUsers": [
+    "使用 Nest 订阅具名业务动作或封存数据修复所产生 Native 数据事件的 OpenXiangda 2.0 应用。"
+  ],
+  "upgradeSteps": [
+    "将应用精确依赖升级到 openxiangda 2.20.4，按锁文件安装并刷新工作区技能，验证后部署测试环境。",
+    "需要恢复的既有失败事件应核对原投递后使用正式 replay API，不重复提交业务动作。"
+  ],
+  "knownLimitations": [
+    "本修复不自动重放历史死信，也不替代应用真实角色、通知幂等和业务结果验收。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "匹配现有平台 Native 事件生产者，无需服务端或数据库迁移。",
+    "v1": "V1 工作区与维护引擎不受影响。"
+  },
+  "sha256": "b797b6e42ef1b54c312f40b14ecaea7064be9799d98bc9b200ed7dd88936e821",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.20.4"
+}

package/releases/2.31.5.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.31.5",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.31.5：应用 Agent 自定义卡片",
+  "summary": "应用可以把填写卡和结果卡的自定义脚本随同一发布版本交付，由平台在隔离卡片 Host 中展示。",
+  "newFeatures": [
+    "ai.agent.inputCard 和 resultCard 可声明受限的 agent-cards/*.js 资源；发布时核验脚本进入同一前端制品。",
+    "openxiangda/agent-card SDK 提供状态接收、只读选项查询、固定任务提交和尺寸同步；中文开发资料与 Skill 给出构建和验收示例。"
+  ],
+  "fixes": [],
+  "affectedUsers": [
+    "需要在平台业务 Agent 中展示应用自有填写或结果布局的 OpenXiangda 2.0 应用开发者。"
+  ],
+  "upgradeSteps": [
+    "升级 openxiangda 并更新锁文件；保留标准 inputCard/resultCard 字段声明作为资源失败时的回退。",
+    "将使用 SDK 的卡片构建为单文件 IIFE 放入前端 dist/agent-cards/，配置对应 resource，然后运行 check 与预发 deploy。",
+    "确认平台已发布配套 Agent 卡片资源端点与隔离 Host；在预发验证歧义选择、刷新、重复提交、权限拒绝与业务回读。"
+  ],
+  "knownLimitations": [
+    "首版消息桥是平台限定协议，不宣称与官方 MCP Apps 线级兼容；卡片只支持已声明的选项查询和固定提交。",
+    "结果卡只收到已声明的标量字段；复杂列表、附件和额外工具调用仍需后续独立契约。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "workspaceGenerations": "v2",
+    "platform": "自定义卡片需要配套 Agent Center 资源解析服务和无同源 iframe Host。",
+    "v1": "独立 V1 引擎和工作区不受影响。"
+  },
+  "sha256": "b674dd23dcb5fc9e00a7af758f01291295c78b8b6756b43d5f678ba79e4df345",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.5"
+}

package/releases/2.59.3.json

@@ -0,0 +1,36 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.59.3",
+  "status": "reviewed",
+  "title": "开发者AI应用自助操作与主线工具组合",
+  "summary": "让AI沿用当前应用权限直接诊断事件、复用加密环境凭据、配置通知和恢复指定投递；发行同源主线已评审的流程及编译契约。",
+  "newFeatures": [
+    "admin operations和MCP application_operations发现20项有界操作；admin execute及application_operation直接执行，必须明确环境，密钥仅返回元信息。",
+    "角色审批可按固定代码步骤或事实的选人结果取当前有效角色候选；平台必须提供workflow.role-input-selection能力，缺失时拒绝新声明。",
+    "流程表单支持已加载固定子表行及按原Native资源授权读取材料；流程图支持展开已声明代码逻辑说明。"
+  ],
+  "fixes": [
+    "当前能力目录完整合法闭包不再受旧64项上限误拒绝；未知代码、重复项及制品绑定仍拒绝。",
+    "补正可编辑未参与流转事实投影的一层owned子表；固定子表条件隐藏采用当前表单值。",
+    "流程画布就绪后才开放导航，用户导航不再被迟到初始化覆盖；大型AppSpec支持512文件并保留原字节界限。"
+  ],
+  "affectedUsers": [
+    "使用V2开发者CLI/MCP进行应用运维，或使用本批流程/编译增强的应用。稳定V1独立维护。"
+  ],
+  "upgradeSteps": [
+    "精确更新完整工具组合，刷新工作区Skill和AGENTS平台区块并重启MCP。先读docs application-operations及admin operations --json。",
+    "共享校验器须与平台安装的openxiangda-contracts 2.71.0配对；已有生产应用保持原不可变版本，升级工具不代表重新部署业务。"
+  ],
+  "knownLimitations": [
+    "沿用当前应用管理授权；首次账号授权、权限委托和外部身份目录维护仍由原owner处理。旧平台缺少接口时明确拒绝，不使用SQL或保护绕过。",
+    "通道健康成功不证明实际老师收件或已读。恢复只处理指定原投递，不自动导入、重建业务、批量重发历史通知或读取密钥明文。"
+  ],
+  "issues": [],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "共享纯校验器同源配对；新增角色选人声明要求workflow.role-input-selection@1.0.0",
+    "v1": "V1不消费本批V2契约或运行时"
+  },
+  "sha256": "b09fb5780d5ceea6c72a61c174952039396debc774d9b4249aef79794308bb72",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.59.3"
+}

package/releases/2.61.0.json

@@ -0,0 +1,39 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.61.0",
+  "status": "reviewed",
+  "title": "OpenXiangda 2.61.0：完整富文本与受管视频",
+  "summary": "PC 与移动富文本改用免费 MIT Tiptap 引擎，统一编辑、Native 写入和公开投影的 HTML5 安全规则，保留丰富排版并支持受管视频。本次同时物化既有主线待发布维护。",
+  "newFeatures": [
+    "支持字体、字号、行高、颜色、背景色、对齐、缩进、上下标、表格、待办列表、分割线、表情选择与全屏编辑。",
+    "受管 MP4/WebM 视频每个最高100MiB，每字段最多4个；图片最多20张、每张10MiB。配套平台以授权 Range 流式读取，复用现有跨资源复制回执。",
+    "应用可使用外部编辑器，但须消费同一安全协议；text.rich 自动要求 data.rich-text:1.0.0。",
+    "收录主线已有的独立角色容量512与标准工作流详情条件显示。"
+  ],
+  "fixes": [
+    "避免前端、服务端与发布展示清洗白名单不同造成保存后格式丢失。",
+    "收录主线已有的移动已选值可访问描述与 selected-department 精确配套版本。"
+  ],
+  "affectedUsers": [
+    "使用 V2 text.rich 的所有应用，以及需要视频、复杂排版和外部编辑器的开发者。"
+  ],
+  "upgradeSteps": [
+    "先部署配套服务器并核验 data.rich-text 与 validatorDigest，再安装 openxiangda2.61.0/contracts2.76.0/devkit2.57.1/CLI2.8.8。",
+    "使用标准 RichTextField 与 RichTextValueDisplay；外部编辑器先统一清洗，上传与跨资源发布使用官方受管文件接口。",
+    "刷新同版本技能，验证保存、回填及立即/定时发布后晋级原成功测试制品。"
+  ],
+  "knownLimitations": [
+    "不支持外部视频、iframe、自动播放、转码或任意 CSS；容器支持不保证所有客户端编解码器可播放。",
+    "HTML 限1MiB，解析树限制25000节点与128层；上传还受平台原存储限额约束。",
+    "新格式保存后回退旧服务端可能在下次写入丢格式；回滚编辑器时保留新版清洗与读取规则。",
+    "本地真实浏览器与受控服务测试不替代学校业务角色及发布链路验收。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "配套 rich-text-html/1、data.rich-text:1.0.0 与相同 contracts validatorDigest；无新增 SQL。",
+    "v1": "V1 运行时和编辑器保持独立，不消费新增 V2 规则。"
+  },
+  "issues": [],
+  "sha256": "aece510083f6d6b04ae4c62410631e99824718072c64cfb1ab605970889d065d",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.61.0"
+}

package/releases/2.61.1.json

@@ -0,0 +1,37 @@
+{
+  "schemaVersion": "openxiangda.release-notes/v1",
+  "version": "2.61.1",
+  "status": "reviewed",
+  "title": "连接开发与已部署预发版本隔离",
+  "summary": "修复启动本地连接开发后预发页面变为未部署的问题。开发配置通过独立会话选择，已部署前后端与权限、流程、订阅和调度保持原发布选择。",
+  "newFeatures": [
+    "开发会话引用独立配置快照，源码连接和短期工作负载凭证按会话隔离。"
+  ],
+  "fixes": [
+    "dev 不再切换共享预发 Head，不再清空已部署的前后端制品指针。",
+    "普通线上请求不会被导向开发者本地 Nest；关闭、过期和撤销只影响对应开发会话。",
+    "普通浏览器配置选择证明绑定签名会话与实际登录用户，不能借用开发者权限。"
+  ],
+  "affectedUsers": [
+    "使用 openxiangda dev 的应用开发者及同一应用的预发使用者。"
+  ],
+  "upgradeSteps": [
+    "先升级配套平台，确认 application.development-configuration 契约为 2.0.0。",
+    "更新工作区至 openxiangda 2.61.1，重新运行 dev 创建独立开发会话。",
+    "历史已被开发配置切换的预发版本，通过正常 rollback 恢复已部署版本。"
+  ],
+  "knownLimitations": [
+    "共享测试数据的业务写入仍然真实生效；本次隔离配置和运行选择，不隔离数据。",
+    "新模型、已发布角色及流程结构的变更需要独立测试环境或正式部署；已有模型的新增字段只增加可空物理列。",
+    "开发启动不激活后台订阅、定时或业务日期调度，后台链路仍通过正式部署批次验收。",
+    "浏览器文件流操作需要部署制品。"
+  ],
+  "compatibility": {
+    "node": ">=24",
+    "platform": "application.development-configuration 2.0.0",
+    "generation": "OpenXiangda Native V2"
+  },
+  "issues": [],
+  "sha256": "acfeb841fe4e2107fb13cf3e0ef92c1c35bad7b1836b61ac3e6028bf97ff589e",
+  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.61.1"
+}

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": "f659e47693d5a4541ed63a65b32951c6b094d2706e97a935bc10c65db605f8cb"
+      "sha256": "fe46adb5ae3013368f00a2f696666e4d6ce9bdeb344578e9dc053ba4c0389906"
     }
   ]
 }

package/skills/openxiangda-v2/SKILL.md

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

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

@@ -125,7 +125,7 @@ crud: [{
 
 `hidden` 仅控制展示。`system` 表示由服务端维护，默认隐藏；业务需要展示的流水号、状态可显式 `hidden: false`。隐藏不会撤销 Data API 的读写授权；授权仍用现有字段 `access` 与行策略。普通必填字段不能从可新增表单中漏掉；内部必填值应有清晰的服务端赋值责任，不能靠隐藏字段绕过数据约束。
 
-业务组件优先使用 `openxiangda/field-kit`，PC 补充使用 `antd`，移动端使用 `openxiangda/mobile` 封装的 Ant Design Mobile 控件。移动控件已覆盖文本、长文本、数字、布尔、静态选项、日期时间，以及人员／部门目录、动态资源引用和级联选择。选择弹层支持逐层浏览、搜索、翻页和已选项管理，点击确定才写回表单，关闭放弃本次修改。附件、图片、地址、子表和签名已提供移动交互，富文本在手机使用纯文本编辑并保留未修改 HTML；能力边界见[字段组件](field-components.md)。共享值协议和表单控制器，不共享桌面弹层交互。
+业务组件优先使用 `openxiangda/field-kit`，PC 补充使用 `antd`，移动端使用 `openxiangda/mobile` 封装的 Ant Design Mobile 控件。移动控件已覆盖文本、长文本、数字、布尔、静态选项、日期时间，以及人员／部门目录、动态资源引用和级联选择。选择弹层支持逐层浏览、搜索、翻页和已选项管理，点击确定才写回表单，关闭放弃本次修改。附件、图片、地址、子表和签名已提供移动交互，富文本在手机使用完整格式编辑与统一安全 HTML 协议；能力边界见[字段组件](field-components.md)。共享值协议和表单控制器，不共享桌面弹层交互。
 
 ```tsx
 import { MobileSurface, Input, Button } from 'openxiangda/mobile';

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

@@ -608,3 +608,17 @@ CAS与写后范围检查同事务执行。应用仍负责业务规则和字典gu
 
 保存与核对共用同一operation，首次业务读取前先resolveOriginalCommand；not_observed只表示观察时未见回执，
 不自动重试或换键。管理员资料修改不会重写已完成意见、已走路径或已派审批人，后续任务按平台原Native修订协议处理。
+
+### 已选部门的实时解析
+
+业务动作需要将部门选择器结果保存为业务快照时，声明
+`platformAccess: { selectedDepartments: { fields: ['name', 'path', 'parent', 'fullPath'], maxIds: 8 } }`，
+调用 `businessDirectory.selectedDepartments(ids)`。仅提交不重复的部门 ID；必须声明 `name`，
+最多解析 50 个部门，返回值按输入顺序给出真实 `value`、`label` 及声明的可选路径字段。
+目标平台需要 `directory.selected-departments` 1.0.0；编译器自动派生该能力。
+
+此接口要求已验证的用户 Named Action，并复核发起人、环境 Head、租户及现有
+`app:<appCode>:directory:read` 权限。部门范围沿平台现有部门选择器的租户及未删除关系，
+没有新增独立的部门可见范围策略。任何部门不存在或已删除时，整组失败，不按姓名匹配，
+不接受客户端标签，也不回退到应用内复制的组织表。`snapshotRevision` 描述返回事实，
+`resolvedAt` 来自数据库时间；快照不能替代后续业务事务的权限检查。

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

@@ -320,8 +320,7 @@ ISO instant）与 `minuteStep`（1 到 60 且整除 60）。设置步长后只
 - 子表单使用每页十行的行内字段，手机支持折叠、添加和删除；父表提交校验所有行，包括折叠及未显示页的行。分页保留完整输入和草稿，任务完成校验会定位到错误行所在页；有待处理上传时先完成或移除文件，再翻页。
   权限、最大行数、原子事务和已存行的 revision 继续由原有资源契约约束。
 - 签名在底部画布手写并保存；图片、签名和附件仍通过托管文件接口上传与鉴权读取。
-- 手机富文本编辑降级为多行文本。未修改时保留已有 HTML；修改后将纯文本转为转义后的
-  段落 HTML，继续使用原有 `text.rich` 数据类型。
+- 手机富文本使用同一 Tiptap 引擎和安全格式协议；工具栏支持触控和滚动，保留已有排版。
 
 评分是整数的可选控件，默认五颗星，声明示例：
 
@@ -346,3 +345,39 @@ ISO instant）与 `minuteStep`（1 到 60 且整除 60）。设置步长后只
 普通新建即使省略表也检查；编辑只检查本次提交的表。任务草稿/保存允许不足，
 完成时对可见可写表检查最终行数，删除标记不算行。旧固定声明不隐式补造数据。
 标准PC/移动表单显示下限并保留字段校验；应用可提供初始空行，平台不生成可信资料。
+
+
+### 完整富文本与受管视频
+
+`RichTextField` 默认采用 Tiptap / ProseMirror，支持标题、字体/字号、对齐、首行缩进、行高、
+文字/背景色、基础强调、上下标、引用、代码、分隔线、列表/待办、表格、表情选择、撤销/重做与全屏编辑。
+PC 和手机保存同一 HTML 字符串。平台 `data.rich-text` 能力和配套服务端必须先升级。
+
+```tsx
+import { RichTextField, RichTextValueDisplay, uploadOperationManagedFile } from 'openxiangda/field-kit';
+<RichTextField resourceCode="articles" value={body} onChange={setBody}
+  onUpload={file => uploadOperationManagedFile({ operationCode: 'save-article', resourceCode: 'articles', fieldCode: 'body', intent: 'create', file })} />
+<RichTextValueDisplay resourceCode="articles" value={body} />
+```
+
+具名动作声明 `managedFiles` 对应资源/富文本字段，普通 CRUD/任务页面沿用其上传适配器。
+图片只支持 PNG/JPEG/WebP/GIF（每值20张，每张10MiB），视频只支持 MP4/WebM（每值4个，
+每个100MiB；实际仍受租户存储上传额度限制）。服务器核验真实图片/视频容器，权限路由支持
+Range 流式读取。无转码、外站视频、iframe 和自动播放；浏览器编解码器可能不同。
+
+前端、写入和公开投影统一消费 `openxiangda-contracts/rich-text`；
+应用浏览器及 Nest 通过 `openxiangda/rich-text` 使用相同无 DOM 规则，避免后端加载 UI 包。`sanitizeRichText` 用于展示，
+`sanitizeRichTextHtml` 默认只接受 Native 受管媒体，`display:true` 才接受平台匿名公共媒体路径。
+不要保存 blob、data、OSS 签名 URL，禁止关闭清洗。外部编辑器可以使用该协议，样式仍受
+版本化白名单与数值上限约束。`createRichTextExtensions` 提供同一官方免费节点集合。
+
+需要替换全部标准字段的编辑器时，使用 `RichTextEditorProvider` 注入
+`ComponentType<RichTextFieldProps>`；自定义组件接收当前资源、字段、recordId、workflowBinding
+及同一 onUpload/onChange/disabled/mobile。必须遵守统一清洗和受管文件协议。需要默认实现
+时渲染 `DefaultRichTextField`，不要在 Provider 中递归调用 `RichTextField`。上传跨记录/字段
+切换时丢弃旧完成回调，不将新文件插入另一个表单。
+
+跨资源发布声明原有 `managedFileCopies` 的同型 `text.rich` 字段对，对每个媒体调用
+`copyManagedFile`，收到 `succeeded` 回执后用 `sanitizeRichTextHtml(html, { rewriteMedia })` 重写为
+目标资源的 canonical 路径，再执行业务事务。复制后源文件不变，目标独立引用并参与清理。
+立即/定时发布共用同一服务动作；不能直接复用另一个资源的 file ID。

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

@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装，AI 客户端的 stdio 连接仍需配置
 以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
 
 ```bash
-pnpm dlx openxiangda@2.60.1 skill install --force
-pnpm dlx openxiangda@2.60.1 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.60.1 login --cwd my-app --base-url https://platform.example.com
-pnpm dlx openxiangda@2.60.1 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.61.1 skill install --force
+pnpm dlx openxiangda@2.61.1 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.61.1 login --cwd my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.61.1 create my-app --base-url https://platform.example.com
 cd my-app
 pnpm openxiangda context --json
 pnpm openxiangda dev
@@ -121,30 +121,29 @@ AppSpec 随开发持续维护：测试发布前补齐总纲、关联变更与验
 
 前端启动使用根目录 `dev:web`。声明了后端的应用同时运行配置的 `backend.root` 包内的 `dev`，无需增加根目录 `dev:server`；纯前端应用只启动 Web 和代理。已有前端测试版本后，可以启用本地 Nest 联调，不必先构建或发布后端镜像。平台返回的活动应用版本和开发会话绑定本次联调，环境版本变化导致会话不一致时，停止后重新运行 `dev`。
 
-在已有测试环境的应用中，`dev` 先将当前完整资源、权限、具名操作和固定流程配置
-提交给平台。平台使用同源编译器校验配置与契约，保存真实配置版本和同步回执，
-选择该应用 test 的配置 Head，然后 CLI 重新读取环境并创建开发会话。这个过程
-不运行应用 `build`、打包或容器部署；代码继续在本机运行。相同配置与契约再次启动
-时复用当前版本；旧 Head 的开发会话失效，需要重新启动。新增模型和流程可以在
-同一批开发中联调，不需要每次冻结 SDK 和正式部署应用。
-
-完整开发配置要求平台提供 `application.development-configuration` 1.0.0，并且
-应用已有 test Native Head；当前尚不支持无测试基线的新应用直接同步。同步会改变
-test 的配置选择，历史正式版本、数据和原运行保留。开发配置不能用于生产晋级、
-正式部署或回滚候选。
-
-声明后端的应用还要求 `application.development-backend-events` 1.0.0。CLI自动连接
-当前test开发版本，把平台已签名的后台事件和流程业务步骤投递到本机Nest源码，
-并复用平台的持久执行回执与失败恢复。应用运行凭据只进入本地Nest环境，不传入Web、
-页面或终端状态。开发连接关闭或失联时，事件保留在平台队列，不回退到旧后端制品；
-同一测试环境同时只能连接一个开发会话，环境版本变化后重新运行dev。
-临时运输故障会在20秒内恢复原连接；已执行处理器的回复只重发原响应，不重复执行业务。
-授权、环境版本或连接归属变化会立即停止；超过恢复窗口则保留平台原执行记录，重新运行dev继续。
-
-开发连接会启用当前后台事件订阅，保留手工暂停；正常关闭时暂停本连接开启的订阅。
-Timer和DateTrigger继续暂停，日期提醒仍须确认测试副作用意图并完成专门验收。
-当前投递范围是标准后台事件与流程业务步骤；自定义审批人provider、managed-command
-planner等调用仍须正式后端或后续能力。不要把本地开发者联调视为普通角色验收。
+在已有测试环境的应用中，`dev` 将当前配置与契约提交给平台。平台使用同源编译器校验，
+保存独立的开发 AppVersion 和准备回执，由开发会话引用。**开发会话不会选择或切换 test 的发布 Head**；
+线上前端、后端、权限、流程、订阅与调度仍由已部署版本拥有。代码继续在本机运行，不构建或部署应用制品。
+
+该模式要求平台提供 `application.development-configuration` 2.0.0 和一个已部署的 test Native 基线。
+旧平台需要先升级配套版本；旧 SDK 在协商失败时必须先升级，不能使用旧的 dev 同步路径。
+开发 AppVersion 不能用于生产晋级、部署或回滚候选。发布或授权基线变化时，停止并重新运行 dev，
+平台不会自动把旧会话改绑到新版本。
+
+已有模型上的新增字段使用可空物理列 overlay（必填约束仅由开发请求契约校验）；页面和具名操作读取开发会话的独立配置。
+已有字段类型、约束、数据策略、新模型以及角色或流程定义的变更须先在独立测试环境正式部署。
+不兼容声明会明确报错，不能把旧流程偷偷当作本地新流程。共享测试数据的真实写入仍会影响同一数据集，
+配置隔离不等于数据隔离。
+
+本地 Nest 使用开发会话自身的短期 OAuth 凭证，凭证只进入 Nest 环境。
+它不会读取、旋转或撤销已部署后端的凭证。普通浏览器联调保留实际登录人的身份与角色；
+loopback 代理仅注入配置选择证明，平台和 Nest 将该证明与签名调用中的 sessionId 核对。
+同一环境可以存在多个会话，源码连接、响应、关闭和撤销按 sessionId 隔离，并保留环境总并发上限。
+
+只有显式选择开发会话的请求会到本机源码。开发连接断开时，该请求报连接错误；普通线上请求、
+发布回调和后台事件继续到部署制品。启动和退出 dev 都不会启停环境订阅、Timer 或 DateTrigger。
+后台事件和业务日期调度仍通过正式部署批次验收，本次回执明确 `backendEventsAvailable=false`。
+浏览器文件流操作要求部署制品；本地联调会明确提示该能力边界。
 
 同步失败保留原配置运行 ID；相同输入重试复用原回执与版本，并由平台锁和 Head
 CAS 判断是否允许继续。并发请求返回进行中；服务重启释放锁后允许恢复原运行。
@@ -204,9 +203,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
 无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
 
 ```bash
-pnpm dlx openxiangda@2.60.1 auth status --base-url <平台> --json
-pnpm dlx openxiangda@2.60.1 source resolve <仓库URL> --base-url <平台> --json
-pnpm dlx openxiangda@2.60.1 source clone <仓库URL> <新目录> --base-url <平台> --json
+pnpm dlx openxiangda@2.61.1 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.61.1 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.61.1 source clone <仓库URL> <新目录> --base-url <平台> --json
 ```
 
 登录缺失或站点不匹配时，先按该平台执行 login。resolve 根据平台已经登记的绑定返回

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

@@ -931,7 +931,7 @@ const readyFile = await completeWorkflowTaskFileUpload(taskId, input.id);
 原 PNG 字节不改，仍受任务值1MiB限制。这些是业务采集信息，不代表平台认证的签署人、
 可信时间或法律电子签章。
 
-富文本保存清洗后的 HTML 和 Native 稳定托管图片地址，支持最多20图、单图10MiB、100MP。
+富文本保存统一清洗后的 HTML 和 Native 稳定受管图片/视频地址，支持最多20图（单图10MiB、100MP）、4个视频（MP4/WebM、单个100MiB）。视频通过同源任务文件路由流式读取，不下载完整 blob。
 PC/手机保留格式、图片和前后文字；插图未知时锁住编辑，恢复采用原插入位置并只插入一次。
 `blob:` 仅用于授权预览，不进入保存值。新任务签名/富文本图片完成时核验实际图片解码与
 声明格式。完整值经 Native 校验后，草稿和正式审批共用排序文件锁、引用验证、保留期及事务。
@@ -1189,3 +1189,24 @@ subject update和来源guards提交实际改变的派生字段；普通补填仍
 至周日7）。这只控制新选择，保留已有值，不能当成服务端提交门禁。
 `formOptions.fieldHints(values)` 返回按已匹配字段的提示内容，用于时段或业务说明，
 它不改变必填和数据；PC/手机均显示在字段旁。未知字段和无效约束阻止新表单。
+
+### 详情的条件显示
+
+`OpenXiangdaApplication` 的可选 `workflowDetails` 按流程编码提供详情展示规则：
+
+```tsx
+<OpenXiangdaApplication {...applicationProps} workflowDetails={{
+  'expense-request': { fieldVisibility: ({ fieldCode, record, definitionVersion }) => {
+    if (definitionVersion !== 1 || !Object.hasOwn(record, 'expenseType')) return undefined;
+    if (fieldCode === 'travelBudget') return record.expenseType === 'travel';
+    return undefined;
+  } },
+}} />
+```
+
+复用应用已有的字段条件，条件依赖没有包含在可读投影中时返回 `undefined`。
+回调还可读取 `workflowCode`、`bindingVersion` 和 `resourceCode`。返回 `false`
+只省略空字段；已有文本、0、false、引用值和非空子表仍显示，避免隐藏历史内容。
+缺少规则、返回 `undefined` 或回调失败均保持原显示。PC/手机共用这一规则，
+最后一个字段被省略后对应空分组也消失。这是同步展示扩展，不发请求、不写数据，
+不改变字段授权、审批参数或流程版本；不提供该选项的应用保持既有行为。

package/releases/2.60.1.json

@@ -1,35 +0,0 @@
-{
-  "schemaVersion": "openxiangda.release-notes/v1",
-  "version": "2.60.1",
-  "status": "reviewed",
-  "title": "OpenXiangda 2.60.1：显式父资源读取策略",
-  "summary": "新增原生子表父资源读取策略，保持同一有效成员关系内的完整授权链；本次同时物化完整主线中已存在的六项工作流界面与查询维护。",
-  "newFeatures": [
-    "原生子表可声明 parentRead，由平台绑定唯一父资源与子表字段，并以同一有效成员关系同时核验子、父、范围与读取视角。",
-    "公开 contracts/devkit 提供同源解析器与能力协商，根包及 CLI 模板传播精确配套版本。"
-  ],
-  "fixes": [
-    "收录主线已有工作流画布缩放、面板、受控选中和按钮点击/键盘命中整理。",
-    "收录主线已有工作中心服务端分页搜索及流程不可读取/不存在状态的中文呈现。"
-  ],
-  "affectedUsers": [
-    "需要通过父记录权限读取 owned 子表的 V2 应用开发者，以及使用标准工作流界面和工作中心的用户。"
-  ],
-  "upgradeSteps": [
-    "按正式版本组合升级平台 SQL 与服务器，再按锁文件安装精确工具包并刷新同版本资料。",
-    "启用 parentRead 前核验 data.parent-read-policy 能力，保留原业务 UUID、父子外键和 Head 回执。"
-  ],
-  "knownLimitations": [
-    "仅支持只读、唯一父资源、单层 owned 子表；禁止应用自定义外键、多跳、循环及借读取扩大写权限。",
-    "隔离 PG15 实际 kernel 与合成授权测试不替代学校真实角色、页面、文件及性能验收。",
-    "本次包含完整既有 master 维护，不是只发布 G04 源码；后续 selected-department 与 managed-file 契约仍各自独立发布。"
-  ],
-  "compatibility": {
-    "node": ">=24",
-    "platform": "启用 parentRead 需要配套 data.parent-read-policy 与正式 SQL 迁移",
-    "v1": "V1 不消费新增 V2 parentRead 契约。"
-  },
-  "issues": [],
-  "sha256": "1ac76bbd7c06e6a4aeb1613004b6a521fb44d0ad385f96fa5b81fb2f3ac60a35",
-  "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.60.1"
-}