openxiangda-skill-kit 2.3.95 → 2.3.98

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda-skill-kit",
-  "version": "2.3.95",
+  "version": "2.3.98",
   "description": "OpenXiangda 2.0 中文 AI 技能的校验、分发与安装。",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
     "README.md"
   ],
   "dependencies": {
-    "openxiangda-devkit-core": "2.55.0"
+    "openxiangda-devkit-core": "2.57.1"
   },
   "devDependencies": {
     "tsx": "4.23.12",

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/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/手机共用这一规则，
+最后一个字段被省略后对应空分组也消失。这是同步展示扩展，不发请求、不写数据，
+不改变字段授权、审批参数或流程版本；不提供该选项的应用保持既有行为。