openxiangda-skill-kit 2.1.10 → 2.1.12
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.
package/package.json
CHANGED
|
@@ -126,6 +126,44 @@ capability，不使用角色名或影子字段判断。
|
|
|
126
126
|
|
|
127
127
|
DataQuery 使用有界 where 条件树，支持 and/or/not。标准列表的筛选、关键词、分页和导出共用已声明字段与同一查询条件，不在页面重写查询协议。
|
|
128
128
|
|
|
129
|
+
## 自建待办与消息中心 UI {#self-hosted-centers}
|
|
130
|
+
|
|
131
|
+
应用不满意默认待办中心/消息中心的呈现时，在自有 user 路由上用 `openxiangda/core`
|
|
132
|
+
公开客户端自建 UI；数据和事实仍由平台唯一拥有：
|
|
133
|
+
|
|
134
|
+
```tsx
|
|
135
|
+
import {
|
|
136
|
+
loadWorkflowWorkCenter,
|
|
137
|
+
loadApplicationTodos,
|
|
138
|
+
recordApplicationTodoInteraction,
|
|
139
|
+
} from 'openxiangda/core';
|
|
140
|
+
|
|
141
|
+
// 待办四视图：created / pending / handled / cc，counts 随每次查询内嵌返回
|
|
142
|
+
const work = await loadWorkflowWorkCenter({ view: 'pending', limit: 20, offset: 0 });
|
|
143
|
+
// 消息视图：all / pending / informational / completed，未读与回执由 Notification Hub 投影
|
|
144
|
+
const todos = await loadApplicationTodos({ view: 'all', unread: false, keyword: '', limit: 12, offset: 0 });
|
|
145
|
+
// read/click 回执幂等；失败不阻断目标页自身的读取与鉴权
|
|
146
|
+
await recordApplicationTodoInteraction(item.messageId, 'click');
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
边界（与默认标准页一致，`check` 与运行时都会强制）：
|
|
150
|
+
|
|
151
|
+
- 不得注册、替换或重定向 `/todos`、`/m/todos`、`/work-center`、`/m/work-center`
|
|
152
|
+
及任何 Workflow 路由；自建页面必须挂在应用自己声明的路由上。
|
|
153
|
+
- 收件箱只读当前用户：没有跨用户查询、没有批量审批；待办页不执行
|
|
154
|
+
Workflow approve/reject/return 命令，操作一律进入平台解析的
|
|
155
|
+
`detailNavigation.desktopPath/mobilePath`，`navigationUnavailable` 时禁用入口。
|
|
156
|
+
- 视图语义由服务端裁定（待办的 created/cc 是 Workflow 事实，不是消息搜索的
|
|
157
|
+
客户端并集）；合同没有的优先级、截止时间、排序与批量选择不得在浏览器伪造。
|
|
158
|
+
- 服务端集成使用 `openxiangda-nest` 的 `OpenXiangdaPlatformClient`：
|
|
159
|
+
`workflowWorkCenter` 支持 `view`（`created/handled/cc` 需要 view，
|
|
160
|
+
`status` 仅保留 pending/completed 兼容映射），`applicationTodos` 与回执
|
|
161
|
+
访问同名可用。
|
|
162
|
+
|
|
163
|
+
默认呈现的替换式定制仅限既有 contribution 面（用户面 frame、
|
|
164
|
+
`applicationTodoCenter` 渲染器）；Workflow 待办中心目前没有渲染器替换钩子，
|
|
165
|
+
需要完全不同的呈现时走本节的自建路由方案。
|
|
166
|
+
|
|
129
167
|
## 标准后台扩展
|
|
130
168
|
|
|
131
169
|
### 未保存内容的离开保护
|
|
@@ -43,7 +43,9 @@ openxiangda update install --target workspace
|
|
|
43
43
|
openxiangda version --json
|
|
44
44
|
```
|
|
45
45
|
|
|
46
|
-
|
|
46
|
+
更新完成后审查依赖、锁文件差异并运行项目检查与业务验收。
|
|
47
|
+
|
|
48
|
+
升级或手改依赖后若出现 `WORKSPACE_ENGINE_PIN_MISMATCH`（项目声明与已安装版本不一致），按顺序恢复：先运行 `pnpm install`（锁文件已指向目标版本时一步修复）；钉位互相不一致（多个 package.json 或锁文件各说各话）时运行 `openxiangda update install --target workspace`，它会递归统一全部声明、锁文件与安装。`update`、`version`、`changelog` 命令不受该校验限制，漂移状态下也能执行用于诊断与修复；业务命令（check/deploy/dev）保持严格 fail-closed。统一入口不会后台自动升级工具或转换项目。V1 独立 CLI 的 `update install` 会尝试刷新 V1 Skill（可用 `--no-skills` 跳过）；统一入口的更新完成后按下面命令显式刷新 Skill。
|
|
47
49
|
|
|
48
50
|
### 安装或刷新 Skill
|
|
49
51
|
|