openxiangda-skill-kit 2.3.98 → 2.3.99

package/package.json

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

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

@@ -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 判断是否允许继续。并发请求返回进行中；服务重启释放锁后允许恢复原运行。