openxiangda 2.20.3 → 2.21.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 (66) hide show
  1. package/bin/distribution/launcher.js +1 -2
  2. package/documentation/AGENTS.md +2 -2
  3. package/documentation/design-workflow.md +90 -74
  4. package/documentation/development.md +1 -1
  5. package/documentation/frontend.md +3 -3
  6. package/documentation/getting-started.md +7 -7
  7. package/documentation/manifest.json +8 -20
  8. package/documentation/product-design.md +1 -1
  9. package/documentation/reference/cli.md +0 -1
  10. package/package.json +24 -18
  11. package/releases/2.0.0.json +50 -0
  12. package/releases/2.0.1.json +39 -0
  13. package/releases/2.1.0.json +44 -0
  14. package/releases/2.1.1.json +48 -0
  15. package/releases/2.10.0.json +42 -0
  16. package/releases/2.11.0.json +41 -0
  17. package/releases/2.12.0.json +38 -0
  18. package/releases/2.13.0.json +41 -0
  19. package/releases/2.13.1.json +33 -0
  20. package/releases/2.13.2.json +31 -0
  21. package/releases/2.14.0.json +41 -0
  22. package/releases/2.15.0.json +40 -0
  23. package/releases/2.16.0.json +41 -0
  24. package/releases/2.17.0.json +39 -0
  25. package/releases/2.17.1.json +34 -0
  26. package/releases/2.18.0.json +37 -0
  27. package/releases/2.18.1.json +31 -0
  28. package/releases/2.18.10.json +29 -0
  29. package/releases/2.18.2.json +30 -0
  30. package/releases/2.18.3.json +30 -0
  31. package/releases/2.18.9.json +37 -0
  32. package/releases/2.19.0.json +38 -0
  33. package/releases/2.2.0.json +48 -0
  34. package/releases/2.2.1.json +35 -0
  35. package/releases/2.2.2.json +34 -0
  36. package/releases/2.20.0.json +36 -0
  37. package/releases/2.20.4.json +30 -0
  38. package/releases/2.21.0.json +35 -0
  39. package/releases/2.3.0.json +37 -0
  40. package/releases/2.4.0.json +37 -0
  41. package/releases/2.4.1.json +35 -0
  42. package/releases/2.5.0.json +37 -0
  43. package/releases/2.6.0.json +37 -0
  44. package/releases/2.7.0.json +37 -0
  45. package/releases/2.7.1.json +31 -0
  46. package/releases/2.8.0.json +32 -0
  47. package/releases/2.8.1.json +30 -0
  48. package/releases/2.9.0.json +33 -0
  49. package/releases/2.9.1.json +31 -0
  50. package/releases/2.9.2.json +33 -0
  51. package/releases/2.9.3.json +31 -0
  52. package/releases/2.9.4.json +37 -0
  53. package/skills/manifest.json +2 -2
  54. package/skills/openxiangda-v2/SKILL.md +15 -15
  55. package/skills/openxiangda-v2/references/cli.md +0 -1
  56. package/skills/openxiangda-v2/references/design-workflow.md +90 -74
  57. package/skills/openxiangda-v2/references/development.md +1 -1
  58. package/skills/openxiangda-v2/references/frontend.md +3 -3
  59. package/skills/openxiangda-v2/references/getting-started.md +7 -7
  60. package/skills/openxiangda-v2/references/product-design.md +1 -1
  61. package/documentation/design-craft.md +0 -1526
  62. package/documentation/opendesign-methods.md +0 -756
  63. package/releases/2.20.2.json +0 -30
  64. package/releases/2.20.3.json +0 -29
  65. package/skills/openxiangda-v2/references/design-craft.md +0 -1526
  66. package/skills/openxiangda-v2/references/opendesign-methods.md +0 -756
@@ -0,0 +1,30 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.18.3",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.18.3:xlsx 依赖镜像化,去除 SheetJS CDN 单点",
6
+ "summary": "openxiangda 包的 xlsx 依赖从 cdn.sheetjs.com 直链 tarball 迁移到本仓库 GitHub Release 的 vendor-mirror 镜像资产;字节与上游一致(sha256 相同)并继续由锁文件 integrity 钉住。",
7
+ "newFeatures": [],
8
+ "fixes": [
9
+ "消除 SheetJS 官方 CDN 单点:该直链曾在发布验证中造成 ECONNRESET 整轮报废;GitHub Release 资产端点对 CI runner 与一般网络更稳定。",
10
+ "依赖字节不变:镜像 tarball 与 cdn.sheetjs.com 原件 sha256 一致(8dc73fc3b00203e72d176e85b50938627c7b086e607c682e8d3c22c02bb99fe8),锁文件 integrity 保持内容可验证。"
11
+ ],
12
+ "affectedUsers": [
13
+ "所有安装 openxiangda 2.18.x 的应用(安装链路不再依赖 cdn.sheetjs.com 的可用性)。"
14
+ ],
15
+ "upgradeSteps": [
16
+ "应用精确依赖升级到 openxiangda 2.18.3 后重新安装并运行 check。"
17
+ ],
18
+ "knownLimitations": [
19
+ "镜像资产托管在本仓库 GitHub Release(vendor-mirror tag),仓库可用性成为新的安装依赖面。"
20
+ ],
21
+ "issues": [],
22
+ "compatibility": {
23
+ "node": ">=24",
24
+ "workspaceGenerations": "v2",
25
+ "platform": "无平台配合要求。",
26
+ "v1": "不改变 V1 运行时或应用。"
27
+ },
28
+ "sha256": "331ccad039c2fcfcca561364592d869f0cdeb749874b8ab77396b548b1984baf",
29
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.3"
30
+ }
@@ -0,0 +1,37 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.18.9",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.18.9:标准待办/消息中心视觉重构与自建中心合同收尾",
6
+ "summary": "修复运行时缺失基础字体导致的裸元素衬线渲染;待办中心与消息中心按统一页型重构(PC + 移动端);nest 客户端补齐 work-center view 参数并新增应用自建待办/消息 UI 指南。",
7
+ "newFeatures": [
8
+ "OpenXiangdaPlatformClient.workflowWorkCenter 新增可选 view 参数(created/pending/handled/cc),与浏览器端合同对齐;未传时保持 status 兼容行为。",
9
+ "docs/frontend.md 新增「自建待办与消息中心 UI」:openxiangda/core 客户端用法、回执语义与标准路由不可接管等边界。"
10
+ ],
11
+ "fixes": [
12
+ "运行时在 .oxa-ui-root 补基础字体/字号/行高兜底(读取 --ant-font-family/font-size/line-height),裸元素不再继承浏览器衬线默认值,应用品牌字体自动流入标准页。",
13
+ "待办中心改为 layout 底 + 内容卡层次:Typography 页头、Tabs 计数徽标、middle 密度表格、移动端吸顶页头与卡片精修。",
14
+ "消息中心控制区单行对齐(搜索/查询/仅看未读右对齐),摘要卡图标与数字层级、未读圆点显式主色、移动卡片未读左缘条。",
15
+ "verify-design-workbench 改用探测的空闲临时端口,修复本机存在其他 Vite dev server(占用 5173)时设计门必失败的问题。"
16
+ ],
17
+ "affectedUsers": [
18
+ "使用标准待办中心/消息中心的应用及其最终用户(视觉与可读性)。",
19
+ "需要服务端取 created/cc 待办视图或自建中心 UI 的应用开发者。"
20
+ ],
21
+ "upgradeSteps": [
22
+ "应用精确依赖升级到 openxiangda 2.18.9(及配套 openxiangda-cli/openxiangda-nest)后重新 build、check 与部署。",
23
+ "希望标准页跟随品牌字体/字号的应用在 ui.theme 中配置 token 即可,无需其他迁移。"
24
+ ],
25
+ "knownLimitations": [
26
+ "Workflow 待办中心暂无渲染器替换钩子;需要完全不同呈现时按文档使用自有路由 + openxiangda/core 客户端自建。"
27
+ ],
28
+ "issues": [],
29
+ "compatibility": {
30
+ "node": ">=24",
31
+ "workspaceGenerations": "v2",
32
+ "platform": "无平台配合要求。",
33
+ "v1": "V1 工作区不读取该运行时,不受影响。"
34
+ },
35
+ "sha256": "7cc67dfe0aa1b7ccdd28a85fea5e149715edc03321ffc3771cd62a4356cb431a",
36
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.18.9"
37
+ }
@@ -0,0 +1,38 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.19.0",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.19.0:平台探针实测修复——编译期拦截三大易错声明与错误透明化",
6
+ "summary": "来自平台能力探针(platform-capability-probe)全流程实测的修复批:工作流 launch 缺失、快照字段标量投影、数据策略基线角色 unrestricted 三类错误从\"部署后白屏/无限重试/策略静默失效\"提前到编译期拦截;匿名公开策略校验拆分为带指针的独立诊断;发起页防白屏并透出流程命令 lastError;CLI create 支持会话向上继承;同步平台审计列排序与部署 Workflow Head 预检。",
7
+ "newFeatures": [
8
+ "编译器新增三项编译期拦截:workflow definition 必须显式声明 launch;unrestrictedRoleCodes 含基线角色(authenticatedUserRoleCode)直接报错(角色并集必命中,策略会静默失效);option/user/department/resource-ref/cascade 快照字段投影到标量 inputSchema 属性直接报错并给出对象形状与 `<fact>.value` 比较片段。",
9
+ "匿名公开策略校验拆分为带独立错误码与指针的分组诊断(route 绑定/operations/fields/requiredFields/ownRecordFields 子集/draft 规则/public 投影等),不再聚合为一条无指针报错。",
10
+ "工作流发起页:definition.launch 渲染期访问改为可选链,缺失时显示可诊断的 404 而不是白屏;提交后轮询透出 process command 的 lastError(不再无提示转圈)。",
11
+ "平台审计列排序(contracts DATA_SYSTEM_SORT_FIELD_CODES):列表 defaultSort/sortableFields 支持 created_at/updated_at/created_by/updated_by/id/revision,标准 Admin 列表内置创建/更新时间列可点击排序。",
12
+ "deploy 构建前只读比对 workflows.activations 与环境 Head:版本回退拒绝部署(DEPLOY_WORKFLOW_ACTIVATION_VERSION_REGRESSION),源码缺失已激活流程告警,防止盲部署停用流程。"
13
+ ],
14
+ "fixes": [
15
+ "openxiangda-cli create 在目标目录无登录态时按工作区发现规则向上继承会话(.git 边界停住),不再要求在不存在的目标目录里先登录。",
16
+ "openxiangda-skill-kit 打包技能/文档同步:声明速查表补数据策略白名单语义与基线角色陷阱、匿名公开字段子集约束、workflow launch 必填、快照对象事实、cascade 数组路径形状;workflow-events 补发起页与事实投影说明。"
17
+ ],
18
+ "affectedUsers": [
19
+ "所有 OpenXiangda 2.0 应用开发者与 AI 开发会话;使用数据策略、工作流、匿名公开访问的应用需要关注新的编译期校验。"
20
+ ],
21
+ "upgradeSteps": [
22
+ "应用把 openxiangda 精确钉扎到 2.19.0 并重跑 pnpm openxiangda check;此前能通过 check 的声明无需改动,此前靠运行时报错暴露的写法会在编译期给出带修复片段的明确报错。",
23
+ "工作流 definition 若未声明 launch,会在编译期被拒绝:按报错提示补 `launch: { mode: 'standalone' }` 等声明后重新部署。"
24
+ ],
25
+ "knownLimitations": [
26
+ "快照字段投影仅支持对象形状事实,标量投影不支持是契约决定而非缺陷;条件表达式需使用 `<fact>.value` 路径。",
27
+ "平台侧配套修复(auth 落地路由兼容、不变量 NULL 语义、匿名错误透传、验收票据时效、token TTL)在平台服务端发布列车中交付,本工具链列车不含。"
28
+ ],
29
+ "issues": [],
30
+ "compatibility": {
31
+ "node": ">=24",
32
+ "workspaceGenerations": "v2",
33
+ "platform": "平台服务端需随下一平台列车更新到匹配的 openxiangda-contracts;未更新前 check 的目标平台预检会报校验器版本不一致(fail-closed,属预期)。",
34
+ "v1": "V1 工作区不受影响。"
35
+ },
36
+ "sha256": "89940c302299258200c67215c2ddadbcee505642cc586eda90434541b3f81468",
37
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.19.0"
38
+ }
@@ -0,0 +1,48 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.2.0",
4
+ "title": "OpenXiangda 内部支持协作接入",
5
+ "status": "reviewed",
6
+ "summary": "统一入口为 V1/V2 应用开发提供内部支持协作接入,检查官方 DWS 与技能,复用精确账号,并提供授权、打开群邀请和持续案例跟进入口。",
7
+ "newFeatures": [
8
+ "新增 support status、bootstrap、login、join,应用创建和技能刷新后检查支持通道接入状态。",
9
+ "缺少 DWS 时安装官方稳定版 1.0.61,并安装官方完整 multi 技能;已有可用稳定版本可以复用。",
10
+ "增加跨 V1/V2 支持技能,涵盖平台契约咨询、源码诊断上下文、产品架构评审和已授权案例的引用跟进。",
11
+ "使用外置支持通道配置,按原始邀请链接打开钉钉,由用户完成加入。"
12
+ ],
13
+ "fixes": [
14
+ "支持接入失败或等待用户操作时保留独立状态,不改变应用创建成功结果;进度写入 stderr,保持引擎 JSON 输出。",
15
+ "使用保存的精确 DWS profile,不按显示姓名或列表顺序猜测账号,不切换平台或 DWS 全局登录身份。",
16
+ "命令发现由统一分发层维护,技能校验显式接收分发命令,保持 V2 核心与两代引擎边界。"
17
+ ],
18
+ "affectedUsers": [
19
+ "通过统一入口创建应用、初始化工作区或刷新技能的 V1/V2 开发者。",
20
+ "在内部支持通道中继续已授权平台咨询和故障排查的开发 AI。"
21
+ ],
22
+ "compatibility": {
23
+ "node": ">=24",
24
+ "workspaceGenerations": [
25
+ "v1",
26
+ "v2"
27
+ ],
28
+ "v1Policy": "V1 项目保持原代际、版本锁定与登录绑定;支持接入由统一分发入口提供。",
29
+ "platformPolicy": "本次工具发布不要求更新平台镜像;源码诊断仍需目标平台已启用正式源码托管并授予当前账号访问权限。",
30
+ "dws": "最低稳定版 1.0.61;OAuth 与加入群需要用户在官方流程中完成。",
31
+ "releaseChannels": "latest / stable-v2:V2 正式版;legacy-v1:V1 维护版;alpha:预发布。"
32
+ },
33
+ "upgradeSteps": [
34
+ "在 Node.js 24 环境安装统一入口:npm install -g openxiangda@2.2.0。",
35
+ "运行 openxiangda support bootstrap 检查安装与完整技能;离线或 CI 初始化可使用 --skip-support,之后再恢复。",
36
+ "运行 openxiangda support status --json 查看实际状态;需要时执行 support login,SSH 可使用 --device。",
37
+ "尚不能访问支持群时运行 support join,在钉钉完成加入后重新检查状态;已有授权案例继续引用原消息跟进。"
38
+ ],
39
+ "knownLimitations": [
40
+ "可读取群仅证明当前账号的访问能力,不能单独证明群成员身份或组织限制;命令返回独立验证状态。",
41
+ "技能不会唤醒已经结束的开发任务,后台继续需要宿主实际监听或定时任务。",
42
+ "安装、授权和群访问依赖网络及组织配置;新的真实用户入群与双方协作须单独现场验收,替身测试不构成真人验收。",
43
+ "本包提供接入与协作指导,常驻支持服务及知识库由各自私有服务独立部署。"
44
+ ],
45
+ "issues": [],
46
+ "sha256": "638817e7e1d8c9cb99de6b9d41716828d241e31905c9bd0565cb94e43b9ee991",
47
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.2.0"
48
+ }
@@ -0,0 +1,35 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.2.1",
4
+ "title": "原生数据事件接收契约修复",
5
+ "status": "reviewed",
6
+ "summary": "修复当前平台原生数据事件在 Nest 自动化接收端的 Schema 不匹配,保持签名验证和幂等回执边界。",
7
+ "newFeatures": [
8
+ "本次为事件契约修复,不新增业务能力。"
9
+ ],
10
+ "fixes": [
11
+ "移除事件数据体已经退役的 capturePlanRevision 必填要求;捕获身份继续由平台不可变事件账本持有。",
12
+ "接收当前用户角色并集 user_union 操作人的签名事件,并同步类型与开发测试夹具。"
13
+ ],
14
+ "affectedUsers": [
15
+ "使用当前原生 Data API 并通过 Nest 消费数据事件的 OpenXiangda 2.0 应用。"
16
+ ],
17
+ "compatibility": {
18
+ "node": ">=24",
19
+ "workspaceGenerations": [
20
+ "v1",
21
+ "v2"
22
+ ],
23
+ "v1Policy": "V1 引擎与应用契约不变。",
24
+ "platformPolicy": "适用于由不可变捕获计划驱动的当前 V2 原生事件;应用需重新部署接收端。"
25
+ },
26
+ "upgradeSteps": [
27
+ "将 V2 应用的 openxiangda 精确依赖升级为 2.2.1,更新锁文件并通过标准测试部署后验证事件回执。"
28
+ ],
29
+ "knownLimitations": [
30
+ "升级不会自动重放历史失败事件;按原事件和应用幂等标识使用平台运维操作恢复。"
31
+ ],
32
+ "issues": [],
33
+ "sha256": "e56c78fce73cb156731028349b67a784f3aa1bae5073fb16d0b84fafd3b4011f",
34
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.2.1"
35
+ }
@@ -0,0 +1,34 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.2.2",
4
+ "title": "源码托管能力发现契约修复",
5
+ "status": "reviewed",
6
+ "summary": "补齐平台已提供的可选 sourceHosting 字段,修复严格预检拒绝平台能力响应的问题。",
7
+ "newFeatures": [
8
+ "本次修复已有能力声明,不要求应用使用托管仓库。"
9
+ ],
10
+ "fixes": [
11
+ "闭合 Schema 接受 Forgejo provider 和布尔 enabled,同时拒绝未知字段和无效类型。"
12
+ ],
13
+ "affectedUsers": [
14
+ "连接已提供 sourceHosting 能力字段的平台的 V2 应用开发者。"
15
+ ],
16
+ "compatibility": {
17
+ "node": ">=24",
18
+ "workspaceGenerations": [
19
+ "v1",
20
+ "v2"
21
+ ],
22
+ "v1Policy": "V1 引擎与应用契约不变。",
23
+ "platformPolicy": "兼容包含或未包含可选源码托管能力的平台。"
24
+ },
25
+ "upgradeSteps": [
26
+ "将应用 openxiangda 精确依赖升级为 2.2.2,更新锁文件并重新执行正式部署预检。"
27
+ ],
28
+ "knownLimitations": [
29
+ "其他未知平台字段仍按闭合契约拒绝。"
30
+ ],
31
+ "issues": [],
32
+ "sha256": "e45a418150e90adc8658db171afe3bbfef27bb53f6521b7d3cb237decc6dca94",
33
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.2.2"
34
+ }
@@ -0,0 +1,36 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.20.0",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.20.0:行级策略语义防护与匿名表单体验完善",
6
+ "summary": "把平台能力探针实测踩到的行级策略语义陷阱提前到编译期:matchMode AND 配多条不同角色规则会全拒(角色并集取最宽),编译器现在直接警告;匿名策略 requiredFields 比模型必填更严格时报错(标准控件将不带必填校验);放开 created_by/updated_by 审计列作为 current_user 行规则(\"用户只看自己创建\"的基线收窄手段);移除生产环境常驻数据警示横幅。",
7
+ "newFeatures": [
8
+ "created_by/updated_by 审计列支持 current_user 行规则:基线角色(无业务归属字段可用时)也能做\"只看自己创建\"的行级收窄;其余规则主体不支持审计列,编译期明确报错。",
9
+ "编译器新增 AND 多角色规则告警:matchMode AND 且多条规则面向不同角色时警告(规则对非目标角色恒为 false,AND 聚合会拒绝所有身份),提示改用 OR。",
10
+ "匿名公开策略 requiredFields 比模型必填更严格时编译报错:标准表单控件不会为它们生成必填校验,空值提交将被服务端拒绝——报错给出两条修复路径。",
11
+ "移除生产环境\"正在使用正式数据\"常驻警示横幅,生产页面回归正常视觉。"
12
+ ],
13
+ "fixes": [
14
+ "声明速查表补行级策略三坑:角色并集取最宽原则、AND/OR 多角色规则选择、created_by 审计列规则写法。"
15
+ ],
16
+ "affectedUsers": [
17
+ "所有使用数据策略、行级权限、匿名公开访问的 OpenXiangda 2.0 应用开发者与 AI 开发会话。"
18
+ ],
19
+ "upgradeSteps": [
20
+ "应用把 openxiangda 精确钉扎到 2.20.0 并重跑 pnpm openxiangda check;出现新告警/报错时按提示调整策略声明。",
21
+ "使用 created_by 行规则需平台服务端配套版本;升级前请确认平台列车已包含该修复。"
22
+ ],
23
+ "knownLimitations": [
24
+ "created_by 行规则的运行时 WITH CHECK 正向匹配在当前平台版本仍会拒绝(平台开放缺陷),编译通过不代表运行时生效,待平台列车修复后放开使用。",
25
+ "行级策略按角色并集取最宽是平台语义:基线角色与限制性规则并存时限制会失效,无法通过声明规避。"
26
+ ],
27
+ "issues": [],
28
+ "compatibility": {
29
+ "node": ">=24",
30
+ "workspaceGenerations": "v2",
31
+ "platform": "无强制平台配合要求;created_by 行规则的运行时生效需平台列车跟进。",
32
+ "v1": "V1 工作区不受影响。"
33
+ },
34
+ "sha256": "7d381f9f33bcb0c2f14197b94a0bfe542c66dc1c859b83ae97117f9eddceaa86",
35
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.20.0"
36
+ }
@@ -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,35 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.21.0",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.21.0:Agent 原生视觉开发流程",
6
+ "summary": "移除效果和维护成本不匹配的 OpenDesign 运行时、命令与桥接层,把界面设计收敛为同一 AI Agent 内完成的闭环:按需使用 Image 2.5 等图片能力生成少量视觉参考,直接实现真实 React 页面,并以浏览器交互证据完成修正和验收。",
7
+ "newFeatures": [
8
+ "提供 Agent 原生设计工作流:视觉方向、React 实现、浏览器修正和 AppSpec 记录在同一个 OpenXiangda 工作区内完成。",
9
+ "支持把 Image 2.5 或当前可用的图片生成能力作为可选视觉参考;图片不可用或质量不足时可直接基于设计约束、成熟组件和浏览器迭代继续开发。"
10
+ ],
11
+ "fixes": [
12
+ "移除 openxiangda design 命令、OpenDesign CLI/桌面/MCP 桥接、环境变量、内置方法资源和上游同步流程,避免 AI 自动开发依赖额外设计项目。",
13
+ "统一文档、Skill 和工作区模板中的界面开发指导,同时保留 AppSpec 设计资产、平台 Shell、Field Kit、权限、Data API、主题边界和真实角色验收契约。"
14
+ ],
15
+ "affectedUsers": [
16
+ "使用 OpenXiangda 2.0 创建或改版管理后台、PC 用户页和移动端页面的 AI 开发会话与维护者。"
17
+ ],
18
+ "upgradeSteps": [
19
+ "将应用精确依赖升级到 openxiangda 2.21.0,按锁文件安装,并执行 pnpm openxiangda skill install --force 刷新本地 Skill。",
20
+ "删除自动化脚本中对 openxiangda design 的调用;改为按 Agent 原生设计工作流直接实现真实页面并运行项目检查与浏览器验收。"
21
+ ],
22
+ "knownLimitations": [
23
+ "Image 2.5 等图片能力只生成参考,不定义交互、权限、业务数据或验收结论;最终结果仍以真实 React 页面和浏览器证据为准。",
24
+ "本版本不会自动迁移或删除应用工作区中既有的 AppSpec 设计资产。"
25
+ ],
26
+ "issues": [],
27
+ "compatibility": {
28
+ "node": ">=24",
29
+ "workspaceGenerations": "v2",
30
+ "platform": "无需服务端、数据库或平台容器升级。",
31
+ "v1": "V1 工作区与维护引擎不受影响。"
32
+ },
33
+ "sha256": "18c7d0d0c508dec38ab1685d649103dcd820c75203d4a67eddd9c17aabc7651d",
34
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.21.0"
35
+ }
@@ -0,0 +1,37 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.3.0",
4
+ "title": "流程实例撤回期限与业务终止授权",
5
+ "status": "reviewed",
6
+ "summary": "为标准流程实例增加可选的撤回时间限制和精确业务能力终止授权,应用编译器与平台共用策略校验。",
7
+ "newFeatures": [
8
+ "流程可声明 instanceCommands,以必填时间事实限制撤回,并以同应用的精确能力授权业务管理员终止。"
9
+ ],
10
+ "fixes": [
11
+ "阻止未绑定时间事实、跨应用能力和未声明终止能力进入可发布应用包。"
12
+ ],
13
+ "affectedUsers": [
14
+ "需要限制标准流程撤回时间或授权业务角色终止流程的 V2 应用开发者。"
15
+ ],
16
+ "compatibility": {
17
+ "node": ">=24",
18
+ "workspaceGenerations": [
19
+ "v1",
20
+ "v2"
21
+ ],
22
+ "v1Policy": "V1 引擎与应用契约不变。",
23
+ "platformPolicy": "开发与部署需要匹配的共享校验器版本。使用新策略必须由平台提供 workflow.instance-cancellation-policy 1.0.0;平台预检会拒绝不支持该能力的版本。"
24
+ },
25
+ "upgradeSteps": [
26
+ "将应用 openxiangda 精确依赖升级为 2.3.0,更新锁文件并刷新技能与资料。",
27
+ "待目标平台部署匹配版本后执行正式检查、测试发布及真实角色验收。"
28
+ ],
29
+ "knownLimitations": [
30
+ "新策略只作用于声明该策略的新定义,不改写既有实例固定的定义。",
31
+ "撤回和终止的线上执行由平台版本提供;本工具包发布不代表平台已完成部署。",
32
+ "驳回意见校验与 Data API 事务时钟问题不在本次工具包修复范围。"
33
+ ],
34
+ "issues": [],
35
+ "sha256": "134f47befeec3138041d5eb24558379135456cf2f7d437502643fc5919331ec4",
36
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.3.0"
37
+ }
@@ -0,0 +1,37 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.4.0",
4
+ "title": "事务接受时刻与预约时间窗口",
5
+ "status": "reviewed",
6
+ "summary": "增加绑定提交字段的时间守卫,统一在锁等待结束后使用平台数据库时间判断业务期限。",
7
+ "newFeatures": [
8
+ "operation-time 守卫可检查 create/update 中的 datetime 字段,支持正负 366 天以内的整数毫秒偏移和六种比较。"
9
+ ],
10
+ "fixes": [
11
+ "动态时间条件使用守卫锁及写入前校验完成后的数据库接受时刻,成功重放保持原 evaluatedAt。"
12
+ ],
13
+ "affectedUsers": [
14
+ "需要预约窗口、截止时间、签到时间或并发事务时间条件的 V2 应用开发者。"
15
+ ],
16
+ "compatibility": {
17
+ "node": ">=24",
18
+ "workspaceGenerations": [
19
+ "v1",
20
+ "v2"
21
+ ],
22
+ "v1Policy": "V1 引擎和已有应用契约不变。",
23
+ "platformPolicy": "新编译的数据应用要求 Data API 1.1.0 和匹配的共享校验器;平台预检拒绝不支持该能力的目标。"
24
+ },
25
+ "upgradeSteps": [
26
+ "将应用精确依赖升级至 openxiangda 2.4.0,更新锁文件并刷新技能资料。",
27
+ "平台部署匹配版本后执行正式检查、测试发布、数据库截止和真实角色验收。"
28
+ ],
29
+ "knownLimitations": [
30
+ "evaluatedAt 是动态条件的接受时刻,不是最终数据库提交时刻。",
31
+ "字段必须是声明且可写的 datetime 字面值,不支持空值、嵌套路径或操作引用。",
32
+ "工具包发布不代表平台已部署或应用业务验收已通过。"
33
+ ],
34
+ "issues": [],
35
+ "sha256": "2c4e0bf9f880e72a454010d2590fe3ac5b2993a215473c8e29ef29e77431e42a",
36
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.4.0"
37
+ }
@@ -0,0 +1,35 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.4.1",
4
+ "title": "事件处理器依赖作用域修复",
5
+ "status": "reviewed",
6
+ "summary": "事件处理器可正常注入请求级通知服务,签名与回执校验后再由所属 Nest 模块解析依赖。",
7
+ "newFeatures": [],
8
+ "fixes": [
9
+ "修复请求级依赖使事件处理器构造函数未执行、handle 调用失败的问题。",
10
+ "同名 provider 严格按所属模块解析,并发投递与失败重试使用独立作用域;静态单例继续复用。"
11
+ ],
12
+ "affectedUsers": [
13
+ "使用 Nest 签名事件处理器及请求级通知服务或瞬态依赖的 V2 应用开发者。"
14
+ ],
15
+ "compatibility": {
16
+ "node": ">=24",
17
+ "workspaceGenerations": [
18
+ "v1",
19
+ "v2"
20
+ ],
21
+ "v1Policy": "V1 引擎与已有应用契约不变。",
22
+ "platformPolicy": "沿用 2.4.0 的 Data API 1.1.0 要求;事件签名、回执、身份与部署协议不变。"
23
+ },
24
+ "upgradeSteps": [
25
+ "将应用精确依赖升级至 openxiangda 2.4.1,刷新工作区资料并重新检查。",
26
+ "重新发布应用后验证真实事件、通知送达、重复投递与失败恢复。"
27
+ ],
28
+ "knownLimitations": [
29
+ "事件作用域的 REQUEST 不含用户授权,sendFromEvent 仅在已验证的事件执行期间可用。",
30
+ "SDK 测试通过不代表真实平台通知送达或应用业务验收已完成。"
31
+ ],
32
+ "issues": [],
33
+ "sha256": "f81f626e3fb91069c4f5d94da48a80400ae3fca5e3b55ab0d77e0a7c82dc7681",
34
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.4.1"
35
+ }
@@ -0,0 +1,37 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.5.0",
4
+ "title": "按业务记录恢复原流程命令",
5
+ "status": "reviewed",
6
+ "summary": "浏览器和 Nest 可在重新进入详情时按业务记录查找原流程命令,继续原回执和进度查询。",
7
+ "newFeatures": [
8
+ "增加当前用户范围的流程命令分页查询,支持精确记录、流程和操作筛选,每页最多 50 条。"
9
+ ],
10
+ "fixes": [
11
+ "补齐业务记录已提交但流程事件尚未投影时,从列表重新进入详情无法定位原命令的恢复路径。"
12
+ ],
13
+ "affectedUsers": [
14
+ "使用 Business Process 原子提交业务数据与流程的 V2 应用开发者。"
15
+ ],
16
+ "compatibility": {
17
+ "node": ">=24",
18
+ "workspaceGenerations": [
19
+ "v1",
20
+ "v2"
21
+ ],
22
+ "v1Policy": "V1 引擎和已有应用不变。",
23
+ "platformPolicy": "使用 Business Process 的新编译包要求 durable-command 1.1.0 和匹配的共享校验器;旧客户端继续兼容。"
24
+ },
25
+ "upgradeSteps": [
26
+ "将应用精确依赖升级至 openxiangda 2.5.0,更新锁文件并刷新技能资料。",
27
+ "平台部署匹配版本后执行检查和测试发布,验证重新进入详情时恢复原命令而不重复提交。"
28
+ ],
29
+ "knownLimitations": [
30
+ "查询沿用原命令的发起人或既有超级管理员权限,记录读取权限不授予他人命令访问。",
31
+ "同一记录可能有多次流程,应用须根据业务约束选择原命令,不能任意选择第一条。",
32
+ "包发布、平台部署和实际业务验收分别验证。"
33
+ ],
34
+ "issues": [],
35
+ "sha256": "35a3bd6f8f97d3261243e1c65e2876a946448c5af455f43ababf18bd8f6f3653",
36
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.5.0"
37
+ }
@@ -0,0 +1,37 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.6.0",
4
+ "title": "统一应用时区与日期时间输入",
5
+ "status": "reviewed",
6
+ "summary": "应用可指定业务展示时区,标准字段、审批详情、待办、通知和审计时间统一显示,日期时间输入仍保存 UTC。",
7
+ "newFeatures": [
8
+ "OpenXiangdaApplication 和 OpenXiangdaUiProvider 接受可选 timeZone;日期时间字段可覆盖时区并声明 min、max 和 minuteStep。"
9
+ ],
10
+ "fixes": [
11
+ "修复设备时区不同导致日期时间编辑和公共详情、中心时间不一致的问题,拒绝夏令时不存在或重复的本地时间。"
12
+ ],
13
+ "affectedUsers": [
14
+ "需要固定业务时区或限制日期时间输入的 V2 应用开发者。"
15
+ ],
16
+ "compatibility": {
17
+ "node": ">=24",
18
+ "workspaceGenerations": [
19
+ "v1",
20
+ "v2"
21
+ ],
22
+ "v1Policy": "V1 引擎和已有应用不变。",
23
+ "platformPolicy": "展示与输入能力,无新增服务端契约或数据库迁移。未配置时区和限制的应用保留设备本地行为。"
24
+ },
25
+ "upgradeSteps": [
26
+ "将应用精确依赖升级至 openxiangda 2.6.0,更新锁文件并刷新技能资料。",
27
+ "在应用入口指定业务 timeZone,验证 PC 和移动端编辑、审批摘要与各中心显示。"
28
+ ],
29
+ "knownLimitations": [
30
+ "时区只影响呈现;服务端仍须独立验证业务时间窗口和授权。",
31
+ "手机指定时区的日期时间滚轮提供当前选择前后各 365 天并按限制收窄;夏令时重复时间需选择其他无歧义时间。",
32
+ "包发布、应用部署和实际业务验收分别验证。"
33
+ ],
34
+ "issues": [],
35
+ "sha256": "ba11ac3a69cbd9dd27e339c1d84642af99e107ca1170f0876b8be0583abda79f",
36
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.6.0"
37
+ }
@@ -0,0 +1,37 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.7.0",
4
+ "title": "应用统一保护未保存内容",
5
+ "status": "reviewed",
6
+ "summary": "自定义表单可注册未保存状态,应用统一处理站内跳转、浏览器历史和刷新关闭提示。",
7
+ "newFeatures": [
8
+ "增加 useUnsavedChangesGuard,聚合多个表单的未保存状态,取消导航保留输入和原位置,提交成功后解除保护。"
9
+ ],
10
+ "fixes": [
11
+ "补齐原 BrowserRouter 无法使用标准 useBlocker 导致自定义表单浏览器前进后退未受保护的问题。"
12
+ ],
13
+ "affectedUsers": [
14
+ "有自定义录入页面、异步提交或未知结果恢复的 V2 应用开发者。"
15
+ ],
16
+ "compatibility": {
17
+ "node": ">=24",
18
+ "workspaceGenerations": [
19
+ "v1",
20
+ "v2"
21
+ ],
22
+ "v1Policy": "V1 引擎和已有应用不变。",
23
+ "platformPolicy": "公共 React 路由生命周期调整,无服务端契约或数据库变更;应用仍使用既有 Routes、Link 和 navigate。"
24
+ },
25
+ "upgradeSteps": [
26
+ "精确升级到 openxiangda 2.7.0 并刷新技能资料。",
27
+ "在应用入口内使用 useUnsavedChangesGuard,涵盖未保存内容和结果未知状态,验证成功后解除以及取消后的输入保留。"
28
+ ],
29
+ "knownLimitations": [
30
+ "原生刷新/关闭提示受浏览器限制,不能自定义提示文字。",
31
+ "该能力不持久化草稿或代替原提交回执恢复;应用不得直接操作 history.pushState。",
32
+ "包发布、应用部署与真实业务验收分别验证。"
33
+ ],
34
+ "issues": [],
35
+ "sha256": "e8af0fc7c484cad1dc59ce982432e6a2fd4451d7f455141edc2d6128a057542e",
36
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.7.0"
37
+ }
@@ -0,0 +1,31 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.7.1",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.7.1:修复可选后端连接开发",
6
+ "summary": "连接开发按应用配置启动本地 Nest,绑定平台活动应用版本与开发会话,支持已激活前端应用首次启用本地后端。",
7
+ "newFeatures": [],
8
+ "fixes": [
9
+ "不再要求应用手动补根目录 dev:server;使用 backend.root 包内 dev 入口。纯前端应用不启动 Nest。",
10
+ "补齐本地 Nest 所需活动应用版本描述;本地修改的后端使用开发会话标签,不冒充已部署镜像。",
11
+ "开发会话目标发生变化时停止子进程并撤销原会话,防止环境与运行时身份不一致。"
12
+ ],
13
+ "affectedUsers": [
14
+ "使用 dev 连接平台测试环境的纯前端和按需 Nest 应用开发者。"
15
+ ],
16
+ "upgradeSteps": [
17
+ "通过项目正式升级流程采用 openxiangda 2.7.1,刷新项目资料并重启旧 MCP 与 dev 进程。",
18
+ "保留根目录 dev:web,确认配置的后端包具有 dev 启动脚本。"
19
+ ],
20
+ "knownLimitations": [
21
+ "需要平台已有激活应用版本;联调数据写入仍发生在选定远端环境。",
22
+ "本次修复不改变线上应用制品或生产部署。"
23
+ ],
24
+ "compatibility": {
25
+ "node": ">=24",
26
+ "platform": "支持 Application v2 开发会话及活动 AppVersion 的平台"
27
+ },
28
+ "issues": [],
29
+ "sha256": "102d3bdfb8c717e3629dac9eac67eb37f9b50588fda3bf28c9c1930512f4bb75",
30
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.7.1"
31
+ }
@@ -0,0 +1,32 @@
1
+ {
2
+ "schemaVersion": "openxiangda.release-notes/v1",
3
+ "version": "2.8.0",
4
+ "status": "reviewed",
5
+ "title": "OpenXiangda 2.8.0:审计信息读取权限",
6
+ "summary": "模型声明审计信息读取权限,统一保护记录元数据、查询和变更历史。",
7
+ "newFeatures": [
8
+ "模型及直接资源可声明 audit.read,使用现有能力和角色成员权限控制四个审计元数据字段与历史读取。",
9
+ "标准详情页随受权记录元数据显示变更历史入口,PC 和移动端保持一致。"
10
+ ],
11
+ "fixes": [
12
+ "修复业务字段已经受限时,创建人和更新人仍可能通过系统元数据泄露的问题。"
13
+ ],
14
+ "affectedUsers": [
15
+ "需要对忙碌、匿名化或受限业务投影隐藏操作人身份的应用开发者。"
16
+ ],
17
+ "upgradeSteps": [
18
+ "先部署支持 data.audit-read-access 的平台组合,再升级应用到 openxiangda 2.8.0。",
19
+ "在需要限制的模型声明 audit: { read: false },或声明授予管理角色的能力数组,并执行真实角色验收。"
20
+ ],
21
+ "knownLimitations": [
22
+ "省略 audit 保留原有读取行为;应用可信后端和现有超级管理员权限保持原有语义。",
23
+ "受限应用启用后不可回退到忽略审计策略的后端;须保留兼容平台组合或先撤销该应用用户访问。"
24
+ ],
25
+ "compatibility": {
26
+ "node": ">=24",
27
+ "platform": "声明审计读取规则需要 data.audit-read-access 1.0.0"
28
+ },
29
+ "issues": [],
30
+ "sha256": "be1a9505a8b3b3a1148e1f6ce4a1a34a271e7e790f1134b8b546d7146e0eb96d",
31
+ "url": "https://github.com/1377385356/openxiangda/releases/tag/v2.8.0"
32
+ }