openxiangda 2.60.1 → 2.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/dist/browser/application.d.ts +4 -2
  2. package/dist/browser/application.d.ts.map +1 -1
  3. package/dist/browser/application.js +2 -2
  4. package/dist/browser/application.js.map +1 -1
  5. package/dist/browser/components/platform-fields/MobileFieldLayout.d.ts +1 -1
  6. package/dist/browser/components/platform-fields/MobileFieldLayout.d.ts.map +1 -1
  7. package/dist/browser/components/platform-fields/MobileFieldLayout.js +3 -1
  8. package/dist/browser/components/platform-fields/MobileFieldLayout.js.map +1 -1
  9. package/dist/browser/components/platform-fields/RichTextField.d.ts +9 -2
  10. package/dist/browser/components/platform-fields/RichTextField.d.ts.map +1 -1
  11. package/dist/browser/components/platform-fields/RichTextField.js +119 -153
  12. package/dist/browser/components/platform-fields/RichTextField.js.map +1 -1
  13. package/dist/browser/components/platform-fields/rich-text-extensions.d.ts +5 -0
  14. package/dist/browser/components/platform-fields/rich-text-extensions.d.ts.map +1 -0
  15. package/dist/browser/components/platform-fields/rich-text-extensions.js +82 -0
  16. package/dist/browser/components/platform-fields/rich-text-extensions.js.map +1 -0
  17. package/dist/browser/components/platform-fields/rich-text-value.d.ts +5 -7
  18. package/dist/browser/components/platform-fields/rich-text-value.d.ts.map +1 -1
  19. package/dist/browser/components/platform-fields/rich-text-value.js +17 -79
  20. package/dist/browser/components/platform-fields/rich-text-value.js.map +1 -1
  21. package/dist/browser/components/resource/SurfaceFields.d.ts.map +1 -1
  22. package/dist/browser/components/resource/SurfaceFields.js +2 -2
  23. package/dist/browser/components/resource/SurfaceFields.js.map +1 -1
  24. package/dist/browser/components/workflow/StandardWorkflowPages.d.ts.map +1 -1
  25. package/dist/browser/components/workflow/StandardWorkflowPages.js +6 -17
  26. package/dist/browser/components/workflow/StandardWorkflowPages.js.map +1 -1
  27. package/dist/browser/components/workflow/workflow-detail-fields.d.ts +12 -0
  28. package/dist/browser/components/workflow/workflow-detail-fields.d.ts.map +1 -0
  29. package/dist/browser/components/workflow/workflow-detail-fields.js +25 -0
  30. package/dist/browser/components/workflow/workflow-detail-fields.js.map +1 -0
  31. package/dist/browser/styles.css +38 -0
  32. package/dist/browser/workflow-definitions.d.ts +17 -1
  33. package/dist/browser/workflow-definitions.d.ts.map +1 -1
  34. package/dist/browser/workflow-definitions.js +6 -2
  35. package/dist/browser/workflow-definitions.js.map +1 -1
  36. package/dist/field-kit.d.ts +1 -0
  37. package/dist/field-kit.d.ts.map +1 -1
  38. package/dist/field-kit.js +1 -0
  39. package/dist/field-kit.js.map +1 -1
  40. package/dist/rich-text.d.ts +3 -0
  41. package/dist/rich-text.d.ts.map +1 -0
  42. package/dist/rich-text.js +3 -0
  43. package/dist/rich-text.js.map +1 -0
  44. package/documentation/application-foundation.md +1 -1
  45. package/documentation/backend.md +14 -0
  46. package/documentation/field-components.md +37 -2
  47. package/documentation/getting-started.md +7 -7
  48. package/documentation/manifest.json +6 -6
  49. package/documentation/workflow-events.md +22 -1
  50. package/package.json +43 -24
  51. package/releases/2.20.1.json +30 -0
  52. package/releases/2.20.2.json +30 -0
  53. package/releases/2.20.3.json +29 -0
  54. package/releases/2.20.4.json +30 -0
  55. package/releases/2.31.5.json +33 -0
  56. package/releases/2.59.3.json +36 -0
  57. package/releases/2.61.0.json +39 -0
  58. package/skills/manifest.json +1 -1
  59. package/skills/openxiangda-v2/SKILL.md +4 -4
  60. package/skills/openxiangda-v2/references/application-foundation.md +1 -1
  61. package/skills/openxiangda-v2/references/backend.md +14 -0
  62. package/skills/openxiangda-v2/references/field-components.md +37 -2
  63. package/skills/openxiangda-v2/references/getting-started.md +7 -7
  64. package/skills/openxiangda-v2/references/workflow-events.md +22 -1
  65. package/releases/2.60.1.json +0 -35
@@ -0,0 +1,29 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.20.3",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.20.3:标准日期时间选择修复",
6
+ "summary": "修复指定时区的 PC 标准日期时间控件缺少小时和分钟列的问题,普通字段、生成表单、筛选与范围共用修复,不改变 UTC 存储和移动端协议。",
7
+ "newFeatures": [],
8
+ "fixes": [
9
+ "分钟精度显式显示时、分列,秒精度显式显示时、分、秒列。CLI 新应用模板同步钉扎修复后的根包。"
10
+ ],
11
+ "affectedUsers": [
12
+ "使用 Field Kit 指定时区日期时间输入的 OpenXiangda 2.0 应用。"
13
+ ],
14
+ "upgradeSteps": [
15
+ "将应用精确依赖升级到 openxiangda 2.20.3,按锁文件安装并验证日期选择后发布预发布版本。"
16
+ ],
17
+ "knownLimitations": [
18
+ "服务端业务时间窗、权限、DST 不存在和重复墙上时间校验保持原约束。本修复不替代应用真实角色验收。"
19
+ ],
20
+ "issues": [],
21
+ "compatibility": {
22
+ "node": ">=24",
23
+ "workspaceGenerations": "v2",
24
+ "platform": "无需服务端或数据库迁移。",
25
+ "v1": "V1 工作区与维护引擎不受影响。"
26
+ },
27
+ "sha256": "bd5d7d513df7ccc123d949842a5a987e585002848e98d52569190a687b212464",
28
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.20.3"
29
+ }
@@ -0,0 +1,30 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.20.4",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.20.4:Native 事件审计来源契约修复",
6
+ "summary": "严格接收平台已有的 Native 数据事件操作来源审计信息,避免具名业务动作和封存数据修复事件在处理器执行前被错误拒绝。",
7
+ "newFeatures": [],
8
+ "fixes": [
9
+ "Native 事件 actor 显式支持有界 initiatedBy、businessAction 和 platformMaintenance;未知字段、凭据形字段和错误签名仍严格拒绝。"
10
+ ],
11
+ "affectedUsers": [
12
+ "使用 Nest 订阅具名业务动作或封存数据修复所产生 Native 数据事件的 OpenXiangda 2.0 应用。"
13
+ ],
14
+ "upgradeSteps": [
15
+ "将应用精确依赖升级到 openxiangda 2.20.4,按锁文件安装并刷新工作区技能,验证后部署测试环境。",
16
+ "需要恢复的既有失败事件应核对原投递后使用正式 replay API,不重复提交业务动作。"
17
+ ],
18
+ "knownLimitations": [
19
+ "本修复不自动重放历史死信,也不替代应用真实角色、通知幂等和业务结果验收。"
20
+ ],
21
+ "issues": [],
22
+ "compatibility": {
23
+ "node": ">=24",
24
+ "workspaceGenerations": "v2",
25
+ "platform": "匹配现有平台 Native 事件生产者,无需服务端或数据库迁移。",
26
+ "v1": "V1 工作区与维护引擎不受影响。"
27
+ },
28
+ "sha256": "b797b6e42ef1b54c312f40b14ecaea7064be9799d98bc9b200ed7dd88936e821",
29
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.20.4"
30
+ }
@@ -0,0 +1,33 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.31.5",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.31.5:应用 Agent 自定义卡片",
6
+ "summary": "应用可以把填写卡和结果卡的自定义脚本随同一发布版本交付,由平台在隔离卡片 Host 中展示。",
7
+ "newFeatures": [
8
+ "ai.agent.inputCard 和 resultCard 可声明受限的 agent-cards/*.js 资源;发布时核验脚本进入同一前端制品。",
9
+ "openxiangda/agent-card SDK 提供状态接收、只读选项查询、固定任务提交和尺寸同步;中文开发资料与 Skill 给出构建和验收示例。"
10
+ ],
11
+ "fixes": [],
12
+ "affectedUsers": [
13
+ "需要在平台业务 Agent 中展示应用自有填写或结果布局的 OpenXiangda 2.0 应用开发者。"
14
+ ],
15
+ "upgradeSteps": [
16
+ "升级 openxiangda 并更新锁文件;保留标准 inputCard/resultCard 字段声明作为资源失败时的回退。",
17
+ "将使用 SDK 的卡片构建为单文件 IIFE 放入前端 dist/agent-cards/,配置对应 resource,然后运行 check 与预发 deploy。",
18
+ "确认平台已发布配套 Agent 卡片资源端点与隔离 Host;在预发验证歧义选择、刷新、重复提交、权限拒绝与业务回读。"
19
+ ],
20
+ "knownLimitations": [
21
+ "首版消息桥是平台限定协议,不宣称与官方 MCP Apps 线级兼容;卡片只支持已声明的选项查询和固定提交。",
22
+ "结果卡只收到已声明的标量字段;复杂列表、附件和额外工具调用仍需后续独立契约。"
23
+ ],
24
+ "issues": [],
25
+ "compatibility": {
26
+ "node": ">=24",
27
+ "workspaceGenerations": "v2",
28
+ "platform": "自定义卡片需要配套 Agent Center 资源解析服务和无同源 iframe Host。",
29
+ "v1": "独立 V1 引擎和工作区不受影响。"
30
+ },
31
+ "sha256": "b674dd23dcb5fc9e00a7af758f01291295c78b8b6756b43d5f678ba79e4df345",
32
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.31.5"
33
+ }
@@ -0,0 +1,36 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.59.3",
4
+ "status": "reviewed",
5
+ "title": "开发者AI应用自助操作与主线工具组合",
6
+ "summary": "让AI沿用当前应用权限直接诊断事件、复用加密环境凭据、配置通知和恢复指定投递;发行同源主线已评审的流程及编译契约。",
7
+ "newFeatures": [
8
+ "admin operations和MCP application_operations发现20项有界操作;admin execute及application_operation直接执行,必须明确环境,密钥仅返回元信息。",
9
+ "角色审批可按固定代码步骤或事实的选人结果取当前有效角色候选;平台必须提供workflow.role-input-selection能力,缺失时拒绝新声明。",
10
+ "流程表单支持已加载固定子表行及按原Native资源授权读取材料;流程图支持展开已声明代码逻辑说明。"
11
+ ],
12
+ "fixes": [
13
+ "当前能力目录完整合法闭包不再受旧64项上限误拒绝;未知代码、重复项及制品绑定仍拒绝。",
14
+ "补正可编辑未参与流转事实投影的一层owned子表;固定子表条件隐藏采用当前表单值。",
15
+ "流程画布就绪后才开放导航,用户导航不再被迟到初始化覆盖;大型AppSpec支持512文件并保留原字节界限。"
16
+ ],
17
+ "affectedUsers": [
18
+ "使用V2开发者CLI/MCP进行应用运维,或使用本批流程/编译增强的应用。稳定V1独立维护。"
19
+ ],
20
+ "upgradeSteps": [
21
+ "精确更新完整工具组合,刷新工作区Skill和AGENTS平台区块并重启MCP。先读docs application-operations及admin operations --json。",
22
+ "共享校验器须与平台安装的openxiangda-contracts 2.71.0配对;已有生产应用保持原不可变版本,升级工具不代表重新部署业务。"
23
+ ],
24
+ "knownLimitations": [
25
+ "沿用当前应用管理授权;首次账号授权、权限委托和外部身份目录维护仍由原owner处理。旧平台缺少接口时明确拒绝,不使用SQL或保护绕过。",
26
+ "通道健康成功不证明实际老师收件或已读。恢复只处理指定原投递,不自动导入、重建业务、批量重发历史通知或读取密钥明文。"
27
+ ],
28
+ "issues": [],
29
+ "compatibility": {
30
+ "node": ">=24",
31
+ "platform": "共享纯校验器同源配对;新增角色选人声明要求workflow.role-input-selection@1.0.0",
32
+ "v1": "V1不消费本批V2契约或运行时"
33
+ },
34
+ "sha256": "b09fb5780d5ceea6c72a61c174952039396debc774d9b4249aef79794308bb72",
35
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.59.3"
36
+ }
@@ -0,0 +1,39 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.61.0",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.61.0:完整富文本与受管视频",
6
+ "summary": "PC 与移动富文本改用免费 MIT Tiptap 引擎,统一编辑、Native 写入和公开投影的 HTML5 安全规则,保留丰富排版并支持受管视频。本次同时物化既有主线待发布维护。",
7
+ "newFeatures": [
8
+ "支持字体、字号、行高、颜色、背景色、对齐、缩进、上下标、表格、待办列表、分割线、表情选择与全屏编辑。",
9
+ "受管 MP4/WebM 视频每个最高100MiB,每字段最多4个;图片最多20张、每张10MiB。配套平台以授权 Range 流式读取,复用现有跨资源复制回执。",
10
+ "应用可使用外部编辑器,但须消费同一安全协议;text.rich 自动要求 data.rich-text:1.0.0。",
11
+ "收录主线已有的独立角色容量512与标准工作流详情条件显示。"
12
+ ],
13
+ "fixes": [
14
+ "避免前端、服务端与发布展示清洗白名单不同造成保存后格式丢失。",
15
+ "收录主线已有的移动已选值可访问描述与 selected-department 精确配套版本。"
16
+ ],
17
+ "affectedUsers": [
18
+ "使用 V2 text.rich 的所有应用,以及需要视频、复杂排版和外部编辑器的开发者。"
19
+ ],
20
+ "upgradeSteps": [
21
+ "先部署配套服务器并核验 data.rich-text 与 validatorDigest,再安装 openxiangda2.61.0/contracts2.76.0/devkit2.57.1/CLI2.8.8。",
22
+ "使用标准 RichTextField 与 RichTextValueDisplay;外部编辑器先统一清洗,上传与跨资源发布使用官方受管文件接口。",
23
+ "刷新同版本技能,验证保存、回填及立即/定时发布后晋级原成功测试制品。"
24
+ ],
25
+ "knownLimitations": [
26
+ "不支持外部视频、iframe、自动播放、转码或任意 CSS;容器支持不保证所有客户端编解码器可播放。",
27
+ "HTML 限1MiB,解析树限制25000节点与128层;上传还受平台原存储限额约束。",
28
+ "新格式保存后回退旧服务端可能在下次写入丢格式;回滚编辑器时保留新版清洗与读取规则。",
29
+ "本地真实浏览器与受控服务测试不替代学校业务角色及发布链路验收。"
30
+ ],
31
+ "compatibility": {
32
+ "node": ">=24",
33
+ "platform": "配套 rich-text-html/1、data.rich-text:1.0.0 与相同 contracts validatorDigest;无新增 SQL。",
34
+ "v1": "V1 运行时和编辑器保持独立,不消费新增 V2 规则。"
35
+ },
36
+ "issues": [],
37
+ "sha256": "aece510083f6d6b04ae4c62410631e99824718072c64cfb1ab605970889d065d",
38
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.61.0"
39
+ }
@@ -4,7 +4,7 @@
4
4
  {
5
5
  "name": "openxiangda-v2",
6
6
  "description": "使用 OpenXiangda 2.0 从模糊业务想法、已有资料或具体变更出发,通过对话发现模块、完成详细产品设计,由当前 AI Agent 按需用 Image 2.5 等图片能力形成视觉参考,直接实现真实页面并在浏览器修正,再检查和交付应用;维护 1.x 应用时使用对应的 1.x 技能。",
7
- "sha256": "f659e47693d5a4541ed63a65b32951c6b094d2706e97a935bc10c65db605f8cb"
7
+ "sha256": "a2a567f98060fc740101c34aa46b40017ff51ec0dd581c3beb8a3bc3acebec37"
8
8
  }
9
9
  ]
10
10
  }
@@ -40,10 +40,10 @@ AI 接到新应用、页面或改版任务时,在同一个 OpenXiangda 工作
40
40
  未创建工作区时使用本 Skill 随根包发布的精确版本:
41
41
 
42
42
  ```bash
43
- pnpm dlx openxiangda@2.60.1 auth status --cwd <应用目录> --base-url <平台地址> --json
44
- pnpm dlx openxiangda@2.60.1 login --cwd <应用目录> --base-url <平台地址>
45
- pnpm dlx openxiangda@2.60.1 create <应用目录> --base-url <同一平台地址>
46
- pnpm dlx openxiangda@2.60.1 skill install --force
43
+ pnpm dlx openxiangda@2.61.0 auth status --cwd <应用目录> --base-url <平台地址> --json
44
+ pnpm dlx openxiangda@2.61.0 login --cwd <应用目录> --base-url <平台地址>
45
+ pnpm dlx openxiangda@2.61.0 create <应用目录> --base-url <同一平台地址>
46
+ pnpm dlx openxiangda@2.61.0 skill install --force
47
47
  ```
48
48
 
49
49
  创建前把产品要求的目标平台明确带入命令,不从旧登录态推断站点。已有工作区从原绑定恢复,平台不一致时先解决登录与目标,不改 link 文件跨站创建。
@@ -125,7 +125,7 @@ crud: [{
125
125
 
126
126
  `hidden` 仅控制展示。`system` 表示由服务端维护,默认隐藏;业务需要展示的流水号、状态可显式 `hidden: false`。隐藏不会撤销 Data API 的读写授权;授权仍用现有字段 `access` 与行策略。普通必填字段不能从可新增表单中漏掉;内部必填值应有清晰的服务端赋值责任,不能靠隐藏字段绕过数据约束。
127
127
 
128
- 业务组件优先使用 `openxiangda/field-kit`,PC 补充使用 `antd`,移动端使用 `openxiangda/mobile` 封装的 Ant Design Mobile 控件。移动控件已覆盖文本、长文本、数字、布尔、静态选项、日期时间,以及人员/部门目录、动态资源引用和级联选择。选择弹层支持逐层浏览、搜索、翻页和已选项管理,点击确定才写回表单,关闭放弃本次修改。附件、图片、地址、子表和签名已提供移动交互,富文本在手机使用纯文本编辑并保留未修改 HTML;能力边界见[字段组件](field-components.md)。共享值协议和表单控制器,不共享桌面弹层交互。
128
+ 业务组件优先使用 `openxiangda/field-kit`,PC 补充使用 `antd`,移动端使用 `openxiangda/mobile` 封装的 Ant Design Mobile 控件。移动控件已覆盖文本、长文本、数字、布尔、静态选项、日期时间,以及人员/部门目录、动态资源引用和级联选择。选择弹层支持逐层浏览、搜索、翻页和已选项管理,点击确定才写回表单,关闭放弃本次修改。附件、图片、地址、子表和签名已提供移动交互,富文本在手机使用完整格式编辑与统一安全 HTML 协议;能力边界见[字段组件](field-components.md)。共享值协议和表单控制器,不共享桌面弹层交互。
129
129
 
130
130
  ```tsx
131
131
  import { MobileSurface, Input, Button } from 'openxiangda/mobile';
@@ -608,3 +608,17 @@ CAS与写后范围检查同事务执行。应用仍负责业务规则和字典gu
608
608
 
609
609
  保存与核对共用同一operation,首次业务读取前先resolveOriginalCommand;not_observed只表示观察时未见回执,
610
610
  不自动重试或换键。管理员资料修改不会重写已完成意见、已走路径或已派审批人,后续任务按平台原Native修订协议处理。
611
+
612
+ ### 已选部门的实时解析
613
+
614
+ 业务动作需要将部门选择器结果保存为业务快照时,声明
615
+ `platformAccess: { selectedDepartments: { fields: ['name', 'path', 'parent', 'fullPath'], maxIds: 8 } }`,
616
+ 调用 `businessDirectory.selectedDepartments(ids)`。仅提交不重复的部门 ID;必须声明 `name`,
617
+ 最多解析 50 个部门,返回值按输入顺序给出真实 `value`、`label` 及声明的可选路径字段。
618
+ 目标平台需要 `directory.selected-departments` 1.0.0;编译器自动派生该能力。
619
+
620
+ 此接口要求已验证的用户 Named Action,并复核发起人、环境 Head、租户及现有
621
+ `app:<appCode>:directory:read` 权限。部门范围沿平台现有部门选择器的租户及未删除关系,
622
+ 没有新增独立的部门可见范围策略。任何部门不存在或已删除时,整组失败,不按姓名匹配,
623
+ 不接受客户端标签,也不回退到应用内复制的组织表。`snapshotRevision` 描述返回事实,
624
+ `resolvedAt` 来自数据库时间;快照不能替代后续业务事务的权限检查。
@@ -320,8 +320,7 @@ ISO instant)与 `minuteStep`(1 到 60 且整除 60)。设置步长后只
320
320
  - 子表单使用每页十行的行内字段,手机支持折叠、添加和删除;父表提交校验所有行,包括折叠及未显示页的行。分页保留完整输入和草稿,任务完成校验会定位到错误行所在页;有待处理上传时先完成或移除文件,再翻页。
321
321
  权限、最大行数、原子事务和已存行的 revision 继续由原有资源契约约束。
322
322
  - 签名在底部画布手写并保存;图片、签名和附件仍通过托管文件接口上传与鉴权读取。
323
- - 手机富文本编辑降级为多行文本。未修改时保留已有 HTML;修改后将纯文本转为转义后的
324
- 段落 HTML,继续使用原有 `text.rich` 数据类型。
323
+ - 手机富文本使用同一 Tiptap 引擎和安全格式协议;工具栏支持触控和滚动,保留已有排版。
325
324
 
326
325
  评分是整数的可选控件,默认五颗星,声明示例:
327
326
 
@@ -346,3 +345,39 @@ ISO instant)与 `minuteStep`(1 到 60 且整除 60)。设置步长后只
346
345
  普通新建即使省略表也检查;编辑只检查本次提交的表。任务草稿/保存允许不足,
347
346
  完成时对可见可写表检查最终行数,删除标记不算行。旧固定声明不隐式补造数据。
348
347
  标准PC/移动表单显示下限并保留字段校验;应用可提供初始空行,平台不生成可信资料。
348
+
349
+
350
+ ### 完整富文本与受管视频
351
+
352
+ `RichTextField` 默认采用 Tiptap / ProseMirror,支持标题、字体/字号、对齐、首行缩进、行高、
353
+ 文字/背景色、基础强调、上下标、引用、代码、分隔线、列表/待办、表格、表情选择、撤销/重做与全屏编辑。
354
+ PC 和手机保存同一 HTML 字符串。平台 `data.rich-text` 能力和配套服务端必须先升级。
355
+
356
+ ```tsx
357
+ import { RichTextField, RichTextValueDisplay, uploadOperationManagedFile } from 'openxiangda/field-kit';
358
+ <RichTextField resourceCode="articles" value={body} onChange={setBody}
359
+ onUpload={file => uploadOperationManagedFile({ operationCode: 'save-article', resourceCode: 'articles', fieldCode: 'body', intent: 'create', file })} />
360
+ <RichTextValueDisplay resourceCode="articles" value={body} />
361
+ ```
362
+
363
+ 具名动作声明 `managedFiles` 对应资源/富文本字段,普通 CRUD/任务页面沿用其上传适配器。
364
+ 图片只支持 PNG/JPEG/WebP/GIF(每值20张,每张10MiB),视频只支持 MP4/WebM(每值4个,
365
+ 每个100MiB;实际仍受租户存储上传额度限制)。服务器核验真实图片/视频容器,权限路由支持
366
+ Range 流式读取。无转码、外站视频、iframe 和自动播放;浏览器编解码器可能不同。
367
+
368
+ 前端、写入和公开投影统一消费 `openxiangda-contracts/rich-text`;
369
+ 应用浏览器及 Nest 通过 `openxiangda/rich-text` 使用相同无 DOM 规则,避免后端加载 UI 包。`sanitizeRichText` 用于展示,
370
+ `sanitizeRichTextHtml` 默认只接受 Native 受管媒体,`display:true` 才接受平台匿名公共媒体路径。
371
+ 不要保存 blob、data、OSS 签名 URL,禁止关闭清洗。外部编辑器可以使用该协议,样式仍受
372
+ 版本化白名单与数值上限约束。`createRichTextExtensions` 提供同一官方免费节点集合。
373
+
374
+ 需要替换全部标准字段的编辑器时,使用 `RichTextEditorProvider` 注入
375
+ `ComponentType<RichTextFieldProps>`;自定义组件接收当前资源、字段、recordId、workflowBinding
376
+ 及同一 onUpload/onChange/disabled/mobile。必须遵守统一清洗和受管文件协议。需要默认实现
377
+ 时渲染 `DefaultRichTextField`,不要在 Provider 中递归调用 `RichTextField`。上传跨记录/字段
378
+ 切换时丢弃旧完成回调,不将新文件插入另一个表单。
379
+
380
+ 跨资源发布声明原有 `managedFileCopies` 的同型 `text.rich` 字段对,对每个媒体调用
381
+ `copyManagedFile`,收到 `succeeded` 回执后用 `sanitizeRichTextHtml(html, { rewriteMedia })` 重写为
382
+ 目标资源的 canonical 路径,再执行业务事务。复制后源文件不变,目标独立引用并参与清理。
383
+ 立即/定时发布共用同一服务动作;不能直接复用另一个资源的 file ID。
@@ -68,10 +68,10 @@ MCP 服务随项目根包一起安装,AI 客户端的 stdio 连接仍需配置
68
68
  以下命令的版本占位符由随包资料替换为该根包的精确版本。网站源码阅读者应先确认要使用的发行版本。
69
69
 
70
70
  ```bash
71
- pnpm dlx openxiangda@2.60.1 skill install --force
72
- pnpm dlx openxiangda@2.60.1 auth status --base-url <平台地址> --json
73
- pnpm dlx openxiangda@2.60.1 login --cwd my-app --base-url https://platform.example.com
74
- pnpm dlx openxiangda@2.60.1 create my-app --base-url https://platform.example.com
71
+ pnpm dlx openxiangda@2.61.0 skill install --force
72
+ pnpm dlx openxiangda@2.61.0 auth status --base-url <平台地址> --json
73
+ pnpm dlx openxiangda@2.61.0 login --cwd my-app --base-url https://platform.example.com
74
+ pnpm dlx openxiangda@2.61.0 create my-app --base-url https://platform.example.com
75
75
  cd my-app
76
76
  pnpm openxiangda context --json
77
77
  pnpm openxiangda dev
@@ -204,9 +204,9 @@ MCP 的 `docs_read` 可以读取本说明,当前没有独立的源码操作 MC
204
204
  无需本地工作区,使用本 Skill 随包精确版本或已安装的对应 CLI:
205
205
 
206
206
  ```bash
207
- pnpm dlx openxiangda@2.60.1 auth status --base-url <平台> --json
208
- pnpm dlx openxiangda@2.60.1 source resolve <仓库URL> --base-url <平台> --json
209
- pnpm dlx openxiangda@2.60.1 source clone <仓库URL> <新目录> --base-url <平台> --json
207
+ pnpm dlx openxiangda@2.61.0 auth status --base-url <平台> --json
208
+ pnpm dlx openxiangda@2.61.0 source resolve <仓库URL> --base-url <平台> --json
209
+ pnpm dlx openxiangda@2.61.0 source clone <仓库URL> <新目录> --base-url <平台> --json
210
210
  ```
211
211
 
212
212
  登录缺失或站点不匹配时,先按该平台执行 login。resolve 根据平台已经登记的绑定返回
@@ -931,7 +931,7 @@ const readyFile = await completeWorkflowTaskFileUpload(taskId, input.id);
931
931
  原 PNG 字节不改,仍受任务值1MiB限制。这些是业务采集信息,不代表平台认证的签署人、
932
932
  可信时间或法律电子签章。
933
933
 
934
- 富文本保存清洗后的 HTML 和 Native 稳定托管图片地址,支持最多20图、单图10MiB、100MP。
934
+ 富文本保存统一清洗后的 HTML 和 Native 稳定受管图片/视频地址,支持最多20图(单图10MiB、100MP)、4个视频(MP4/WebM、单个100MiB)。视频通过同源任务文件路由流式读取,不下载完整 blob。
935
935
  PC/手机保留格式、图片和前后文字;插图未知时锁住编辑,恢复采用原插入位置并只插入一次。
936
936
  `blob:` 仅用于授权预览,不进入保存值。新任务签名/富文本图片完成时核验实际图片解码与
937
937
  声明格式。完整值经 Native 校验后,草稿和正式审批共用排序文件锁、引用验证、保留期及事务。
@@ -1189,3 +1189,24 @@ subject update和来源guards提交实际改变的派生字段;普通补填仍
1189
1189
  至周日7)。这只控制新选择,保留已有值,不能当成服务端提交门禁。
1190
1190
  `formOptions.fieldHints(values)` 返回按已匹配字段的提示内容,用于时段或业务说明,
1191
1191
  它不改变必填和数据;PC/手机均显示在字段旁。未知字段和无效约束阻止新表单。
1192
+
1193
+ ### 详情的条件显示
1194
+
1195
+ `OpenXiangdaApplication` 的可选 `workflowDetails` 按流程编码提供详情展示规则:
1196
+
1197
+ ```tsx
1198
+ <OpenXiangdaApplication {...applicationProps} workflowDetails={{
1199
+ 'expense-request': { fieldVisibility: ({ fieldCode, record, definitionVersion }) => {
1200
+ if (definitionVersion !== 1 || !Object.hasOwn(record, 'expenseType')) return undefined;
1201
+ if (fieldCode === 'travelBudget') return record.expenseType === 'travel';
1202
+ return undefined;
1203
+ } },
1204
+ }} />
1205
+ ```
1206
+
1207
+ 复用应用已有的字段条件,条件依赖没有包含在可读投影中时返回 `undefined`。
1208
+ 回调还可读取 `workflowCode`、`bindingVersion` 和 `resourceCode`。返回 `false`
1209
+ 只省略空字段;已有文本、0、false、引用值和非空子表仍显示,避免隐藏历史内容。
1210
+ 缺少规则、返回 `undefined` 或回调失败均保持原显示。PC/手机共用这一规则,
1211
+ 最后一个字段被省略后对应空分组也消失。这是同步展示扩展,不发请求、不写数据,
1212
+ 不改变字段授权、审批参数或流程版本;不提供该选项的应用保持既有行为。
@@ -1,35 +0,0 @@
1
- {
2
- "schemaVersion": "openxiangda.release-notes/v1",
3
- "version": "2.60.1",
4
- "status": "reviewed",
5
- "title": "OpenXiangda 2.60.1:显式父资源读取策略",
6
- "summary": "新增原生子表父资源读取策略,保持同一有效成员关系内的完整授权链;本次同时物化完整主线中已存在的六项工作流界面与查询维护。",
7
- "newFeatures": [
8
- "原生子表可声明 parentRead,由平台绑定唯一父资源与子表字段,并以同一有效成员关系同时核验子、父、范围与读取视角。",
9
- "公开 contracts/devkit 提供同源解析器与能力协商,根包及 CLI 模板传播精确配套版本。"
10
- ],
11
- "fixes": [
12
- "收录主线已有工作流画布缩放、面板、受控选中和按钮点击/键盘命中整理。",
13
- "收录主线已有工作中心服务端分页搜索及流程不可读取/不存在状态的中文呈现。"
14
- ],
15
- "affectedUsers": [
16
- "需要通过父记录权限读取 owned 子表的 V2 应用开发者,以及使用标准工作流界面和工作中心的用户。"
17
- ],
18
- "upgradeSteps": [
19
- "按正式版本组合升级平台 SQL 与服务器,再按锁文件安装精确工具包并刷新同版本资料。",
20
- "启用 parentRead 前核验 data.parent-read-policy 能力,保留原业务 UUID、父子外键和 Head 回执。"
21
- ],
22
- "knownLimitations": [
23
- "仅支持只读、唯一父资源、单层 owned 子表;禁止应用自定义外键、多跳、循环及借读取扩大写权限。",
24
- "隔离 PG15 实际 kernel 与合成授权测试不替代学校真实角色、页面、文件及性能验收。",
25
- "本次包含完整既有 master 维护,不是只发布 G04 源码;后续 selected-department 与 managed-file 契约仍各自独立发布。"
26
- ],
27
- "compatibility": {
28
- "node": ">=24",
29
- "platform": "启用 parentRead 需要配套 data.parent-read-policy 与正式 SQL 迁移",
30
- "v1": "V1 不消费新增 V2 parentRead 契约。"
31
- },
32
- "issues": [],
33
- "sha256": "1ac76bbd7c06e6a4aeb1613004b6a521fb44d0ad385f96fa5b81fb2f3ac60a35",
34
- "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.60.1"
35
- }