openxiangda 2.60.0 → 2.61.0

package/dist/field-kit.d.ts

@@ -26,4 +26,5 @@ export * from './browser/components/resource/ResourceFormFrame';
 export * from './browser/components/resource/resource-import';
 export { uploadOperationManagedFile } from './browser/platform-client';
 export * from './browser/components/platform-fields/MobileFieldControls';
+export { createRichTextExtensions } from './browser/components/platform-fields/rich-text-extensions';
 //# sourceMappingURL=field-kit.d.ts.map

package/dist/field-kit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-kit.d.ts","sourceRoot":"","sources":["../src/field-kit.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,mDAAmD,CAAC;AAClE,cAAc,yDAAyD,CAAC;AACxE,OAAO,EAAC,kBAAkB,EAAC,MAAM,yDAAyD,CAAC;AAC3F,cAAc,mDAAmD,CAAC;AAClE,cAAc,oDAAoD,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sDAAsD,CAAC;AAChG,cAAc,gDAAgD,CAAC;AAC/D,cAAc,oDAAoD,CAAC;AACnE,cAAc,8DAA8D,CAAC;AAC7E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,6DAA6D,CAAC;AAC5E,cAAc,6DAA6D,CAAC;AAC5E,cAAc,oDAAoD,CAAC;AACnE,cAAc,qDAAqD,CAAC;AACpE,cAAc,oDAAoD,CAAC;AACnE,cAAc,oDAAoD,CAAC;AACnE,cAAc,oDAAoD,CAAC;AACnE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AACtE,cAAc,qDAAqD,CAAC;AACpE,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,iDAAiD,CAAC;AAChE,cAAc,+CAA+C,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,cAAc,0DAA0D,CAAC"}
+{"version":3,"file":"field-kit.d.ts","sourceRoot":"","sources":["../src/field-kit.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,mDAAmD,CAAC;AAClE,cAAc,yDAAyD,CAAC;AACxE,OAAO,EAAC,kBAAkB,EAAC,MAAM,yDAAyD,CAAC;AAC3F,cAAc,mDAAmD,CAAC;AAClE,cAAc,oDAAoD,CAAC;AACnE,YAAY,EAAE,mBAAmB,EAAE,MAAM,sDAAsD,CAAC;AAChG,cAAc,gDAAgD,CAAC;AAC/D,cAAc,oDAAoD,CAAC;AACnE,cAAc,8DAA8D,CAAC;AAC7E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,6DAA6D,CAAC;AAC5E,cAAc,6DAA6D,CAAC;AAC5E,cAAc,oDAAoD,CAAC;AACnE,cAAc,qDAAqD,CAAC;AACpE,cAAc,oDAAoD,CAAC;AACnE,cAAc,oDAAoD,CAAC;AACnE,cAAc,oDAAoD,CAAC;AACnE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AACtE,cAAc,qDAAqD,CAAC;AACpE,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,iDAAiD,CAAC;AAChE,cAAc,+CAA+C,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,cAAc,0DAA0D,CAAC;AAEzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2DAA2D,CAAC"}

package/dist/field-kit.js

@@ -25,4 +25,5 @@ export * from './browser/components/resource/ResourceFormFrame';
 export * from './browser/components/resource/resource-import';
 export { uploadOperationManagedFile } from './browser/platform-client';
 export * from './browser/components/platform-fields/MobileFieldControls';
+export { createRichTextExtensions } from './browser/components/platform-fields/rich-text-extensions';
 //# sourceMappingURL=field-kit.js.map

package/dist/field-kit.js.map

@@ -1 +1 @@
-{"version":3,"file":"field-kit.js","sourceRoot":"","sources":["../src/field-kit.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,mDAAmD,CAAC;AAClE,cAAc,yDAAyD,CAAC;AACxE,OAAO,EAAC,kBAAkB,EAAC,MAAM,yDAAyD,CAAC;AAC3F,cAAc,mDAAmD,CAAC;AAClE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,oDAAoD,CAAC;AACnE,cAAc,8DAA8D,CAAC;AAC7E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,6DAA6D,CAAC;AAC5E,cAAc,6DAA6D,CAAC;AAC5E,cAAc,oDAAoD,CAAC;AACnE,cAAc,qDAAqD,CAAC;AACpE,cAAc,oDAAoD,CAAC;AACnE,cAAc,oDAAoD,CAAC;AACnE,cAAc,oDAAoD,CAAC;AACnE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AACtE,cAAc,qDAAqD,CAAC;AACpE,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,iDAAiD,CAAC;AAChE,cAAc,+CAA+C,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,cAAc,0DAA0D,CAAC"}
+{"version":3,"file":"field-kit.js","sourceRoot":"","sources":["../src/field-kit.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,mDAAmD,CAAC;AAClE,cAAc,yDAAyD,CAAC;AACxE,OAAO,EAAC,kBAAkB,EAAC,MAAM,yDAAyD,CAAC;AAC3F,cAAc,mDAAmD,CAAC;AAClE,cAAc,oDAAoD,CAAC;AAEnE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,oDAAoD,CAAC;AACnE,cAAc,8DAA8D,CAAC;AAC7E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,6DAA6D,CAAC;AAC5E,cAAc,6DAA6D,CAAC;AAC5E,cAAc,oDAAoD,CAAC;AACnE,cAAc,qDAAqD,CAAC;AACpE,cAAc,oDAAoD,CAAC;AACnE,cAAc,oDAAoD,CAAC;AACnE,cAAc,oDAAoD,CAAC;AACnE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AACtE,cAAc,qDAAqD,CAAC;AACpE,cAAc,sDAAsD,CAAC;AACrE,cAAc,qDAAqD,CAAC;AACpE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,iDAAiD,CAAC;AAChE,cAAc,+CAA+C,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,cAAc,0DAA0D,CAAC;AAEzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2DAA2D,CAAC"}

package/dist/rich-text.d.ts

@@ -0,0 +1,3 @@
+/** DOM-independent policy shared by browser editors and Nest publication actions. */
+export * from 'openxiangda-contracts/rich-text';
+//# sourceMappingURL=rich-text.d.ts.map

package/dist/rich-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-text.d.ts","sourceRoot":"","sources":["../src/rich-text.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,cAAc,iCAAiC,CAAC"}

package/dist/rich-text.js

@@ -0,0 +1,3 @@
+/** DOM-independent policy shared by browser editors and Nest publication actions. */
+export * from 'openxiangda-contracts/rich-text';
+//# sourceMappingURL=rich-text.js.map

package/dist/rich-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rich-text.js","sourceRoot":"","sources":["../src/rich-text.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,cAAc,iCAAiC,CAAC"}

package/documentation/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/documentation/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/documentation/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/documentation/getting-started.md

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

package/documentation/manifest.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": "openxiangda.documentation/v1",
-  "version": "2.60.0",
+  "version": "2.61.0",
   "topics": [
     {
       "id": "getting-started",
       "title": "安装与开始开发",
       "file": "getting-started.md",
-      "sha256": "c34f0485ea0136f2d57c56bf8d71e8cde1d87d440d0c9d3c191ee943dc02bdca"
+      "sha256": "58cda8012f4e570512ac4128a1208d0ff9a92a4f76993f48d4578dc9e86d8611"
     },
     {
       "id": "product-design",
@@ -42,7 +42,7 @@
       "id": "application-foundation",
       "title": "业务模型与标准 CRUD",
       "file": "application-foundation.md",
-      "sha256": "de924d29286bea2fdb2f3f7bef4eeb8c56a9b5e8e9f87ffdcda57e5127063f5c"
+      "sha256": "fed292882cae449f0fed3fdcbd2878499a9a59f7a412d4776fd1c3a829203fa1"
     },
     {
       "id": "appspec",
@@ -66,7 +66,7 @@
       "id": "field-components",
       "title": "字段、表单与移动控件",
       "file": "field-components.md",
-      "sha256": "492cace0b00a0c43f5c3098616c3441e25ffdb825c7531b207ac7e46b755ac36"
+      "sha256": "5d76266c583e43bdeaa6af055c2c02df221e539e4578fbedbc71b5fdee1e9eb0"
     },
     {
       "id": "data-authz",
@@ -84,13 +84,13 @@
       "id": "workflow-events",
       "title": "审批、事件与通知",
       "file": "workflow-events.md",
-      "sha256": "8ba415778a40ea79ad90714bc8cebc4173929565628d61a85287915d003c2e4d"
+      "sha256": "8e53cd8f7931346a8de2c34eed2421cbd9f5bf80e8470c8e0aa0e07f72283e5d"
     },
     {
       "id": "backend",
       "title": "按需后端与业务动作",
       "file": "backend.md",
-      "sha256": "51a329e8b30df0f2e164a1e311e1798b9e76912f8f6f2c554a61e95b29479dd7"
+      "sha256": "e3ac14a8ba787947f6253792d0574c3a580b94c848cfca16c9a6cfb4d5d2382f"
     },
     {
       "id": "agent-cards",

package/documentation/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda",
-  "version": "2.60.0",
+  "version": "2.61.0",
   "description": "OpenXiangda 2.0 的统一命令、应用 SDK、MCP 与中文 AI 技能资料。",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,6 +26,10 @@
       "types": "./dist/field-kit.d.ts",
       "import": "./dist/field-kit.js"
     },
+    "./rich-text": {
+      "types": "./dist/rich-text.d.ts",
+      "import": "./dist/rich-text.js"
+    },
     "./react": {
       "types": "./dist/react.d.ts",
       "import": "./dist/react.js"
@@ -67,18 +71,29 @@
     "@noble/hashes": "2.0.1",
     "@rc-component/async-validator": "6.0.0",
     "@rc-component/picker": "1.10.0",
+    "@tiptap/core": "3.31.4",
+    "@tiptap/extension-image": "3.31.4",
+    "@tiptap/extension-list": "3.31.4",
+    "@tiptap/extension-subscript": "3.31.4",
+    "@tiptap/extension-superscript": "3.31.4",
+    "@tiptap/extension-table": "3.31.4",
+    "@tiptap/extension-text-align": "3.31.4",
+    "@tiptap/extension-text-style": "3.31.4",
+    "@tiptap/pm": "3.31.4",
+    "@tiptap/react": "3.31.4",
+    "@tiptap/starter-kit": "3.31.4",
     "@xyflow/react": "12.12.0",
     "antd-mobile": "5.42.3",
     "dayjs": "1.11.18",
     "docx-preview": "0.3.7",
     "elkjs": "0.12.0",
-    "openxiangda-cli": "2.8.5",
-    "openxiangda-contracts": "2.73.0",
-    "openxiangda-devkit-core": "2.55.0",
+    "openxiangda-cli": "2.8.8",
+    "openxiangda-contracts": "2.76.0",
+    "openxiangda-devkit-core": "2.57.1",
     "openxiangda-legacy": "npm:openxiangda@1.0.269",
-    "openxiangda-mcp": "2.1.4",
-    "openxiangda-nest": "2.16.5",
-    "openxiangda-skill-kit": "2.3.95",
+    "openxiangda-mcp": "2.1.7",
+    "openxiangda-nest": "2.17.1",
+    "openxiangda-skill-kit": "2.3.98",
     "xlsx": "https://github.com/1377385356/openxiangda/releases/download/vendor-mirror/xlsx-0.20.3.tgz"
   },
   "peerDependencies": {
@@ -144,41 +159,42 @@
   },
   "openxiangdaRelease": {
     "schemaVersion": "openxiangda.release-notes/v1",
-    "version": "2.60.0",
+    "version": "2.61.0",
     "status": "reviewed",
-    "title": "OpenXiangda 2.60.0：OSS 应用制品直传",
-    "summary": "开发工具可使用平台已配置的阿里云 OSS 直接上传应用构建包及镜像分块，服务器校验后按原摘要和进度导入，减轻客户 VPN 的大文件传输压力。",
+    "title": "OpenXiangda 2.61.0：完整富文本与受管视频",
+    "summary": "PC 与移动富文本改用免费 MIT Tiptap 引擎，统一编辑、Native 写入和公开投影的 HTML5 安全规则，保留丰富排版并支持受管视频。本次同时物化既有主线待发布维护。",
     "newFeatures": [
-      "新增独立 artifact-transfer/v1 能力协商，平台启用后自动使用限时、精确对象范围的签名直传。",
-      "镜像沿用原 OCI 摘要、预算、断点及受管仓库，已有 Registry 层在直传前复用。",
-      "平台存储设置支持前端 OSS/CDN 静态分发；登录、HTML 及 API 入口保持平台地址。"
+      "支持字体、字号、行高、颜色、背景色、对齐、缩进、上下标、表格、待办列表、分割线、表情选择与全屏编辑。",
+      "受管 MP4/WebM 视频每个最高100MiB，每字段最多4个；图片最多20张、每张10MiB。配套平台以授权 Range 流式读取，复用现有跨资源复制回执。",
+      "应用可使用外部编辑器，但须消费同一安全协议；text.rich 自动要求 data.rich-text:1.0.0。",
+      "收录主线已有的独立角色容量512与标准工作流详情条件显示。"
     ],
     "fixes": [
-      "同时收录本次物化前主线已有 Changeset：按真实构建输入复用后端镜像、HTTP 环境浏览器 SHA-256、较大声明的有界容量协商。",
-      "收录主线已有标准流程页面整理、补正派生事实、补填值联动、日期辅助、提交后导航及子表展示修正。"
+      "避免前端、服务端与发布展示清洗白名单不同造成保存后格式丢失。",
+      "收录主线已有的移动已选值可访问描述与 selected-department 精确配套版本。"
     ],
     "affectedUsers": [
-      "使用 OpenXiangda V2 发布应用且平台已配置 OSS 的开发者与管理员。"
+      "使用 V2 text.rich 的所有应用，以及需要视频、复杂排版和外部编辑器的开发者。"
     ],
     "upgradeSteps": [
-      "按平台正式升级入口部署配套服务器和管理界面。",
-      "将项目 openxiangda 升至 2.60.0，按锁文件安装依赖并刷新项目同版本资料。",
-      "管理员按需启用存储设置中的开发工具直传及静态分发，核验 GET/HEAD CORS 和目录权限。"
+      "先部署配套服务器并核验 data.rich-text 与 validatorDigest，再安装 openxiangda2.61.0/contracts2.76.0/devkit2.57.1/CLI2.8.8。",
+      "使用标准 RichTextField 与 RichTextValueDisplay；外部编辑器先统一清洗，上传与跨资源发布使用官方受管文件接口。",
+      "刷新同版本技能，验证保存、回填及立即/定时发布后晋级原成功测试制品。"
     ],
     "knownLimitations": [
-      "首轮仅支持阿里云 OSS；COS、MinIO、旧平台及关闭开关的站点保留原通道。",
-      "OSS 分发不等于 CDN 加速；CDN 域名需要独立配置，实际性能以部署样本为准。",
-      "暂存目录建议由管理员配置 1 天生命周期，平台不会覆盖整桶生命周期或 ACL。",
-      "本次以官方 Changeset 物化主线待发包内容，未新实现上述既有流程改动；所有版本与共享编译器需按平台组合配对。"
+      "不支持外部视频、iframe、自动播放、转码或任意 CSS；容器支持不保证所有客户端编解码器可播放。",
+      "HTML 限1MiB，解析树限制25000节点与128层；上传还受平台原存储限额约束。",
+      "新格式保存后回退旧服务端可能在下次写入丢格式；回滚编辑器时保留新版清洗与读取规则。",
+      "本地真实浏览器与受控服务测试不替代学校业务角色及发布链路验收。"
     ],
     "compatibility": {
       "node": ">=24",
-      "platform": "配套平台 artifact-transfer/v1 可选接口；应用/编译器契约不变",
-      "v1": "V1不消费新增 OSS 制品传输协议。"
+      "platform": "配套 rich-text-html/1、data.rich-text:1.0.0 与相同 contracts validatorDigest；无新增 SQL。",
+      "v1": "V1 运行时和编辑器保持独立，不消费新增 V2 规则。"
     },
     "issues": [],
-    "sha256": "1becf5ff798495bf650c87783f0714ccaa1f5dd2d1edab1b93eccfdfbea6edde",
-    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.60.0"
+    "sha256": "aece510083f6d6b04ae4c62410631e99824718072c64cfb1ab605970889d065d",
+    "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.61.0"
   },
   "scripts": {
     "build": "node ../../scripts/prune-package-dist.mjs && tsc -p tsconfig.json && node scripts/copy-assets.mjs",

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/skills/manifest.json

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

package/skills/openxiangda-v2/SKILL.md

@@ -40,10 +40,10 @@ AI 接到新应用、页面或改版任务时，在同一个 OpenXiangda 工作
 未创建工作区时使用本 Skill 随根包发布的精确版本：
 
 ```bash
-pnpm dlx openxiangda@2.60.0 auth status --cwd <应用目录> --base-url <平台地址> --json
-pnpm dlx openxiangda@2.60.0 login --cwd <应用目录> --base-url <平台地址>
-pnpm dlx openxiangda@2.60.0 create <应用目录> --base-url <同一平台地址>
-pnpm dlx openxiangda@2.60.0 skill install --force
+pnpm dlx openxiangda@2.61.0 auth status --cwd <应用目录> --base-url <平台地址> --json
+pnpm dlx openxiangda@2.61.0 login --cwd <应用目录> --base-url <平台地址>
+pnpm dlx openxiangda@2.61.0 create <应用目录> --base-url <同一平台地址>
+pnpm dlx openxiangda@2.61.0 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.0 skill install --force
-pnpm dlx openxiangda@2.60.0 auth status --base-url <平台地址> --json
-pnpm dlx openxiangda@2.60.0 login --cwd my-app --base-url https://platform.example.com
-pnpm dlx openxiangda@2.60.0 create my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.61.0 skill install --force
+pnpm dlx openxiangda@2.61.0 auth status --base-url <平台地址> --json
+pnpm dlx openxiangda@2.61.0 login --cwd my-app --base-url https://platform.example.com
+pnpm dlx openxiangda@2.61.0 create my-app --base-url https://platform.example.com
 cd my-app
 pnpm openxiangda context --json
 pnpm openxiangda dev
@@ -204,9 +204,9 @@ MCP 的 `docs_read` 可以读取本说明，当前没有独立的源码操作 MC
 无需本地工作区，使用本 Skill 随包精确版本或已安装的对应 CLI：
 
 ```bash
-pnpm dlx openxiangda@2.60.0 auth status --base-url <平台> --json
-pnpm dlx openxiangda@2.60.0 source resolve <仓库URL> --base-url <平台> --json
-pnpm dlx openxiangda@2.60.0 source clone <仓库URL> <新目录> --base-url <平台> --json
+pnpm dlx openxiangda@2.61.0 auth status --base-url <平台> --json
+pnpm dlx openxiangda@2.61.0 source resolve <仓库URL> --base-url <平台> --json
+pnpm dlx openxiangda@2.61.0 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/手机共用这一规则，
+最后一个字段被省略后对应空分组也消失。这是同步展示扩展，不发请求、不写数据，
+不改变字段授权、审批参数或流程版本；不提供该选项的应用保持既有行为。