@guandata/decidex 0.3.0 → 0.5.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.
package/README.md CHANGED
@@ -1,11 +1,11 @@
1
1
  # Decidex CLI
2
2
 
3
- 基于 Decidex **0.0.6** HTTP API 的零依赖 Node.js CLI(CLI 版本 0.3.0)。要求 Node.js 22+。
3
+ 基于 Decidex **0.0.8** HTTP API 的零依赖 Node.js CLI(CLI 版本 0.5.0)。要求 Node.js 22+。
4
4
 
5
- 适配基线:[tag 0.0.6 / 73901fa03](https://gitlab.mayidata.com/zijie0/decidex/-/tree/0.0.6),2026-11-06。按实际部署的 release 契约执行,保留 0.0.5 调度兼容。
5
+ 适配基线:[tag 0.0.8 / b5cbd94c0](https://gitlab.mayidata.com/zijie0/decidex/-/tree/0.0.8),2026-11-13。按实际部署的 release 契约执行,保留 0.0.5 调度兼容。
6
6
 
7
7
  ```bash
8
- npm install -g @guandata/decidex@0.3.0
8
+ npm install -g @guandata/decidex@0.5.0
9
9
  decidex version --json # 本地 CLI 版本
10
10
  decidex server version # 目标服务端版本与 commit
11
11
  decidex server check auth whoami
@@ -34,7 +34,7 @@ decidex auth whoami # 服务端 >= 0.0.5,返回已验证的
34
34
 
35
35
  版本来自已登录目标的 `GET /api/app-version`,每次 CLI 进程重新读取,不持久缓存。`version` 查询即使遇到 `dev` 等版本也会显示原值和 `comparable=false`;需要版本决策的命令遇到无法比较的版本、认证失败或版本查询失败会明确报错,不猜测版本或在写入失败后重试另一种协议。
36
36
 
37
- `server check` 对没有版本规则的命令返回 `supported=null`、`reason=no_version_rule`,表示尚未声明版本边界,不能据此断言目标支持。`0.0.6` 是本次适配基线,不是所有命令的首次发布版本。SemVer 比较支持 `v` 前缀、预发布和构建信息;例如 `0.0.8-rc.1` 低于正式 `0.0.8`。
37
+ `server check` 对没有版本规则的命令返回 `supported=null`、`reason=no_version_rule`,表示尚未声明版本边界,不能据此断言目标支持。`0.0.8` 是本次适配基线,不是所有命令的首次发布版本。SemVer 比较支持 `v` 前缀、预发布和构建信息;例如 `0.0.8-rc.1` 低于正式 `0.0.8`。
38
38
 
39
39
  已核实的版本差异:
40
40
 
@@ -98,6 +98,8 @@ decidex agent delete AGENT_ID
98
98
 
99
99
  每个 Agent 最多绑定一个业务本体;`versionId` 可以使用固定版本 ID 或 `latest`。`contextReferences` 的 BI 资产需要保留来源环境(`guandataEnvRef` 或有效的 `guandataBaseUrl`);也可按服务端契约传钉钉/飞书文档引用。`builtInInstructions` 仅支持更新已有 Agent。
100
100
 
101
+ 服务端 >= 0.0.7 可配置 `biUserPropertiesEnabled`(创建默认 `false`)和 `biUserPropertyKeys`(默认 `[]`)。Key 最多 20 项,每项去空白后 1..200 字符,去重保序;可选 Key 通过 `decidex platform call personal-agents.bi-user-property-options.list --agent-id AGENT_ID` 查询,实际可用性取决于维护者的 BI 身份和属性目录。旧服务端使用这些字段会在写入前被 CLI 拒绝。
102
+
101
103
  上传参考文件和执行冒烟问题:
102
104
 
103
105
  ```bash
@@ -144,6 +146,7 @@ decidex agent knowledge remove AGENT_ID DOCUMENT_ID
144
146
 
145
147
  ```bash
146
148
  decidex session list --status running
149
+ decidex session list --pinned-session-id SESSION_ID --pinned-agent-id AGENT_ID
147
150
  decidex session view SESSION_ID
148
151
  decidex session send SESSION_ID --message "继续拆解渠道" --wait --follow
149
152
  decidex session stop SESSION_ID
@@ -158,6 +161,8 @@ decidex session files download SESSION_ID --scope analysis --suffix .boe --all -
158
161
  decidex run diagnose RUN_ID --session-id SESSION_ID --json
159
162
  ```
160
163
 
164
+ `session list` 的两个 `--pinned-*-id` 参数可重复,要求服务端 >= 0.0.7;只用于历史列表保留指定条目,不修改平台的置顶状态。
165
+
161
166
  `session rename` 的标题不能为空,最多 24 个字符。
162
167
 
163
168
  会话列表按页返回;`--cursor` 接收 `nextCursor` 原值,`--agent-id` 查询指定 Agent 的历史页。`--status` 只过滤当前页,`completed` 表示非 RUNNING(含 ERROR),空页仍可能有下一页。`--query` 不可与 `--cursor` / `--agent-id` 同用。`session view --before OLDER_CURSOR` 读取更早消息,`--since LIVE_CURSOR` 读取增量;两者互斥。
@@ -285,6 +290,31 @@ decidex eval files download AGENT_ID RUN_ID --scope analysis --suffix .boe --all
285
290
 
286
291
  `eval files download` 按 Case 分目录下载评测会话文件;用 `--scope analysis --suffix .boe` 可只下载证据链。该命令要求服务端评测详情返回 `targetSessionId`;旧版服务端会给出明确升级提示。
287
292
 
293
+ ## 专家协作与后台改进(服务端 >= 0.0.8)
294
+
295
+ 普通 Personal Agent 人工 normal 会话空闲且无排队消息时,可显式开启专家协作。先检查 `available`;平台功能开关或 Runtime 不满足要求时,服务端会拒绝,不会自动开启配置:
296
+
297
+ ```bash
298
+ decidex session collaboration status SESSION_ID
299
+ decidex session collaboration activate SESSION_ID --accept-governance-notice
300
+ decidex session collaboration stop SESSION_ID --epoch 1
301
+ decidex session collaboration download SESSION_ID shared/result.txt ./result.txt
302
+ ```
303
+
304
+ 专家以会话所有者的身份和权限运行,可能增加模型消耗,专家管理者可审查收到及共享的材料。`--epoch` 必须取最新 `status` 返回的 `work.epoch`,不要固定照抄示例。材料路径取状态返回的 `shared/...` 或 `deliveries/...`;不传 Runtime 工作区路径。专家任务详情可用 `task SESSION_ID TASK_ID` 查询。
305
+
306
+ 显式继续已停止的工作使用 `continue SESSION_ID --submission-id UUID`;同一次操作保留相同 UUID,响应不确定时先查状态,不自动重新触发。`session send` 原有的普通回复或排队返回不能替代协作交付确认。
307
+
308
+ 后台改进开关独立于 Agent JSON,需要编辑权限:
309
+
310
+ ```bash
311
+ decidex agent improvement get AGENT_ID
312
+ decidex agent improvement enable AGENT_ID
313
+ decidex agent improvement disable AGENT_ID
314
+ ```
315
+
316
+ 开启后处理新的反馈,不回放关闭期间的历史反馈;生成的修改仍须审查。`personal-agents.self-evolution.knowledge-changes.list` 读取待确认知识修改,`self-evolutions.list` 查询改进记录。0.0.8 已移除旧 `self-evolutions.create` 和 `self-evolution.sources.list`,旧 `memory-suggestions` 的确认/拒绝入口迁移到 `self-evolution.knowledge-changes`;停止改进接口改为 204 空响应。
317
+
288
318
  ## 定时任务
289
319
 
290
320
  创建文件 `automation.json`:
@@ -306,7 +336,7 @@ decidex automation runs AUTOMATION_ID --cursor NEXT_CURSOR
306
336
  decidex automation delete AUTOMATION_ID
307
337
  ```
308
338
 
309
- 文件包含 `id` 时用 PATCH 更新;可只传 `{ "id": "...", "status": "PAUSED" }` 暂停,改为 `ACTIVE` 恢复。暂停状态不能手动运行;单次调度完成后由服务端写入 `FINISHED`,不能手动设置、恢复或再次运行。
339
+ 文件包含 `id` 时用 PATCH 更新;服务端 >= 0.0.7 可只传 `{ "id": "...", "status": "PAUSED" }` 暂停,改为 `ACTIVE` 恢复。目标 0.0.5/0.0.6 更新时必须附上原 `schedule`,CLI 会阻止省略计划的写入,避免服务端应用默认计划。暂停状态不能手动运行;单次调度完成后由服务端写入 `FINISHED`,不能手动设置、恢复或再次运行。
310
340
 
311
341
  服务端 >= 0.0.6 支持以下调度:
312
342
 
@@ -322,6 +352,8 @@ decidex automation delete AUTOMATION_ID
322
352
 
323
353
  CLI 根据目标版本选择协议:0.0.6 的旧 `weekday` 转为 `weekdays`,旧 `HOURLY` 转为 `INTERVAL(60)`;目标 0.0.5 保留原协议,单元素 `weekdays` 可转换为 `weekday`,多元素及新调度模式在写入前拒绝。`server check automation apply` 查看所选协议。
324
354
 
355
+ 服务端 >= 0.0.7 可在 `imPush.channels[]`、`emailPush` 内设置 `biGroupIds`;用 `decidex platform call personal-agent-automations.bi-groups.list` 读取目录。IM 用户组目标仍需指定 `channel` 和 `botId`,邮件即使仅选组也需传 `recipientUserIds: []`。组成员在每次执行时按当时目录解析,保存成功不代表实际送达。
356
+
325
357
  文件还可按服务端契约配置 `imPush`、`emailPush`;更新时省略保留原配置,`null` 清空。手动 `run --wait` 等待分析 Run,不代表通知已送达;送达结果查看 `automation runs`。服务端 0.0.5 的启动接口会同步等待执行结果,`--wait --timeout` 覆盖该请求及后续读取的总时间。客户端超时不会取消服务端执行;应先查 `automation runs`,不要直接重试触发。
326
358
 
327
359
  ## 任务中心
@@ -351,7 +383,17 @@ decidex action-task complete TASK_ID --version 1
351
383
  }
352
384
  ```
353
385
 
354
- `--run-id` 从当前会话窗口查找回答;较早的回答用 `session view --before CURSOR` 找到消息后传 `--message-id`。采纳后可完成或取消,待处理时可拒绝。`reject`、`cancel` 必须传 `--note 理由`。每次操作使用 `get` 返回的当前 `task.version`;409 表示任务已变化,应重新确认,不自动重试。平台没有行动任务删除接口。
386
+ `--run-id` 从当前会话窗口查找回答;较早的回答用 `session view --before CURSOR` 找到消息后传 `--message-id`。采纳后可完成或取消,待处理时可拒绝;服务端 >= 0.0.7 也允许直接完成待处理任务,`complete --note` 可附完成说明。`reject`、`cancel` 必须传 `--note 理由`。每次操作使用 `get` 返回的当前 `task.version`;409 表示任务已变化,应重新确认,不自动重试。平台没有行动任务删除接口。
387
+
388
+ 服务端 >= 0.0.7 可读取分发选项、显式分发任务和下载事件证据附件:
389
+
390
+ ```bash
391
+ decidex action-task dispatch-info TASK_ID
392
+ decidex action-task dispatch TASK_ID dispatch.json
393
+ decidex action-task attachment TASK_ID EVENT_ID 0 evidence.bin
394
+ ```
395
+
396
+ 分发文件包含 `botId`、`recipientIds`、`idempotencyKey`,可选 `createNativeTask`(默认 `true`;只推消息时设为 `false`);所选渠道要求的授权信息以 `dispatch-info` 返回为准。分发会发送真实通知,同一次分发应保留同一幂等键,响应不确定时先查分发状态,不自动重发。附件的 `EVENT_ID` 来自 `get` 返回的事件,序号从 0 开始;只有已有渠道证据才能下载,材料失效或上游不可用会保留服务端错误。
355
397
 
356
398
  ### 指标追踪
357
399
 
@@ -392,7 +434,7 @@ decidex platform coverage
392
434
 
393
435
  版本边界来自 release tag 中的路由存在性,**不等于该版本所有业务字段均兼容**;字段与权限仍以服务端契约为准。仅在 main 存在的操作默认拒绝,确认目标已部署后才能显式 `--allow-unreleased`,不猜测未来版本号。`inputHints` 是路由文件线索,不是完整请求 schema。
394
436
 
395
- 当前目录覆盖 444/444 个纳入范围的操作,全部存在于 0.0.6 tag。全部 549 个路由操作中另有 105 个运行时、服务令牌、公开分享、回调、流式或代理协议,未纳入浏览器登录态 CLI;按全部路由计为 80.9%。这表示操作入口覆盖,不是逐接口业务验证或真实冒烟覆盖。详见 [覆盖审计](docs/api-coverage.md)。
437
+ 当前目录覆盖 469/469 个纳入范围的操作,全部存在于 0.0.8 tag。全部 584 个路由操作中另有 115 个运行时、服务令牌、公开分享、回调、流式或代理协议,未纳入浏览器登录态 CLI;按全部路由计为 80.3%。这表示操作入口覆盖,不是逐接口业务验证或真实冒烟覆盖。详见 [覆盖审计](docs/api-coverage.md)。
396
438
 
397
439
  ## 组织
398
440
 
@@ -447,7 +489,7 @@ CI 中可使用 `DECIDEX_BASE_URL` 和 `DECIDEX_SESSION`,无需写本地配置
447
489
  npm test
448
490
  npm pack --dry-run
449
491
  # 更新 API 目录:必须指定已核对的源码 commit 和适配 tag
450
- python3 scripts/sync-api-catalog.py --repo /path/to/decidex --ref COMMIT --baseline 0.0.6
492
+ python3 scripts/sync-api-catalog.py --repo /path/to/decidex --ref COMMIT --baseline 0.0.8
451
493
  npm install -g . # 更新本机 decidex;不发布到 npm
452
494
  ```
453
495
 
@@ -475,3 +517,11 @@ npm install -g . # 更新本机 decidex;不发布到 npm
475
517
  ## 2026-11-06 / 服务端 0.0.6 适配
476
518
 
477
519
  适配 tag `0.0.6 / 73901fa03`,CLI 0.3.0 在此补充 0.0.6 适配。新增多星期、月度、固定间隔和单次调度,保留 0.0.5 legacy 协议并拒绝不兼容写入;操作目录更新为已发布的 444 项,新增 BI 用户同步入口。机器人成员候选需传 `botId`,可用机器人支持 `purpose=push|channel`、`transport=STREAM|WEBHOOK`;使用授权支持成员或 BI 组。在线文档不支持下载或替换上传原件。权限与业务字段仍以目标服务端为准。
520
+
521
+ ## 2026-11-11 / 服务端 0.0.7 适配
522
+
523
+ CLI 0.4.0 适配 tag `0.0.7 / cfdf08dba`:新增 Agent BI 用户属性、历史会话保留参数、行动任务分发与证据附件下载,定时推送支持 BI 用户组。新增字段按 0.0.7 版本预检;旧版定时任务更新必须显式带计划,防止计划被重置。平台目录更新为 461 项,新增统一权限、渠道回调配置和推送管理入口,移除已废弃的渠道绑定成员接口;外部事件回调仍不作为普通管理 API。
524
+
525
+ ## 2026-11-13 / 服务端 0.0.8 适配
526
+
527
+ CLI 0.5.0 适配 `0.0.8 / b5cbd94c0`:新增专家协作状态、开启/继续/停止、任务详情与材料下载,增加后台改进开关。新命令在目标低于 0.0.8 时停止。目录更新为 469 项,补入企微证据存储配置及知识修改新入口,移除已退休的手动自进化与旧记忆建议操作。服务令牌与内部协作协议继续排除,不借用用户登录态调用。
@@ -1,18 +1,18 @@
1
1
  # API 覆盖审计
2
2
 
3
- 更新:2026-11-06;CLI:0.3.0;适配服务端:0.0.6。
3
+ 更新:2026-11-13;CLI:0.5.0;适配服务端:0.0.8。
4
4
 
5
- 源码依据与适配基线:[0.0.6 / 73901fa03](https://gitlab.mayidata.com/zijie0/decidex/-/tree/0.0.6),与生产 `server version` 返回的 commit 一致。逐一扫描 `src/app/api/**/route.ts` 的 HTTP 方法导出,以“方法 + 路径”计数,未把 `decidex api` 兜底算作覆盖。
5
+ 源码依据与适配基线:[0.0.8 / b5cbd94c0](https://gitlab.mayidata.com/zijie0/decidex/-/tree/0.0.8),与生产 `server version` 返回的 commit 一致。逐一扫描 `src/app/api/**/route.ts` 的 HTTP 方法导出,以“方法 + 路径”计数,未把 `decidex api` 兜底算作覆盖。
6
6
 
7
7
  ## 覆盖口径
8
8
 
9
9
  | 范围 | 操作数 | CLI 入口 |
10
10
  | --- | ---: | --- |
11
- | 用户/管理员主动调用的 HTTP 操作 | 444 | 全部注册到 `platform list/show/call`,目录覆盖 100% |
12
- | 其中存在于 0.0.6 tag | 444 | 默认可调用,实际权限由服务端判断 |
11
+ | 用户/管理员主动调用的 HTTP 操作 | 469 | 全部注册到 `platform list/show/call`,目录覆盖 100% |
12
+ | 其中存在于 0.0.8 tag | 469 | 默认可调用,实际权限由服务端判断 |
13
13
  | 其中仅在 main | 0 | 本次目录仅取部署 release |
14
- | 运行时、分享、认证回调等协议 | 105 | 不纳入浏览器登录态 CLI |
15
- | 全部路由操作 | 549 | 按全部路由计算为 80.9% |
14
+ | 运行时、分享、认证回调等协议 | 115 | 不纳入浏览器登录态 CLI |
15
+ | 全部路由操作 | 584 | 按全部路由计算为 80.3% |
16
16
 
17
17
  **90% 目标在“用户/管理员主动操作”的入口范围内达到;若包含服务协议全部路由,仍未达到 90%。** 目录注册证明请求入口可发现、路径参数可校验、传输可执行,不证明每个接口字段已适配或业务功能经过冒烟。特殊协议不应通过替换认证头强行视为普通管理 API。
18
18
 
@@ -26,7 +26,7 @@
26
26
 
27
27
  - 上述扩展领域多数没有专用流程命令;请求字段仍需依据对应服务端 route/契约,`inputHints` 只提供线索。
28
28
  - 版本元数据只证明路由在哪个 tag 已存在,不保证相同路由的请求字段、语义或权限始终不变;字段协议变化仍需单独适配与测试。
29
- - 未支持内部运行时 24 项、服务令牌协议 61 项、外部消息回调/投递 5 项、认证回调/元数据 7 项、事件流 2 项、代理/预览 catch-all 3 项、公开分享 3 项。
29
+ - 未支持内部运行时 25 项、服务令牌协议 67 项、外部消息回调/投递 8 项、认证回调/元数据 7 项、事件流 2 项、代理/预览 catch-all 3 项、公开分享 3 项。
30
30
  - 当前上传/下载整包载入内存;外部消息实际送达、管理员写配置及每个接口的业务成功路径未全量验证。
31
31
 
32
32
  ## 0.0.6 版本差异
@@ -37,10 +37,24 @@
37
37
  - `organizations.current.bi-user-sync.users.list` 必须传 `--query-param q=关键词`,`offset` 默认 0;省略 q 的实际请求返回服务端 500,补齐参数后成功。CLI 保留原始错误,没有改写服务端错误码。
38
38
  - 在线知识文档不支持上传原件的下载/替换协议;该限制由目标服务端判断,普通上传文档传输保持可用。
39
39
 
40
+ ## 0.0.7 版本差异
41
+
42
+ - 新增 19 个管理操作,移除 2 个渠道绑定成员操作:权限集中到本体、Skill 和机器人权限接口;补入行动分发/附件、BI 属性/组目录、推送配置和渠道回调配置。
43
+ - Agent BI 属性、会话保留参数、定时推送 BI 组与行动分发/附件仅在 >= 0.0.7 使用;相同路由上的新增字段也先检查目标版本。
44
+ - 0.0.7 修复定时任务 PATCH 省略计划时重置默认计划的问题;CLI 对旧版本要求显式带原计划。
45
+ - 区分用户读取证据的 `/action-tasks/.../events/.../attachments/...` 与外部事件接收接口,保留飞书/企微回调配置管理,排除实际外部事件接收协议。
46
+
47
+ ## 0.0.8 版本差异
48
+
49
+ - 新增 12 个管理操作、移除 4 个旧操作,净增 8 项:协作状态/操作/任务/材料、后台改进设置、知识修改建议、改进重试和企微证据存储配置。
50
+ - 旧记忆建议确认/拒绝迁移到 `self-evolution/knowledge-changes`;手动自进化创建及来源列表退休,停止改进改为 204 空响应。`platform call` 保留空响应的成功语义。
51
+ - 新增的内部协作 1 项、服务令牌 6 项协议不纳入用户登录态调用入口;系统与自定义 BI 属性使用同一目录,新参数仍由目标校验。
52
+ - 原生协作命令保留显式治理确认、调用方提交 UUID 和当前 epoch,不自动生成继续请求或冲突重试;是否可用仍由平台开关与 Kubernetes Runtime 判断。
53
+
40
54
  ## 复核方法
41
55
 
42
56
  ```bash
43
- python3 scripts/sync-api-catalog.py --repo /path/to/decidex --ref COMMIT --baseline 0.0.6
57
+ python3 scripts/sync-api-catalog.py --repo /path/to/decidex --ref COMMIT --baseline 0.0.8
44
58
  decidex platform coverage
45
59
  decidex platform list --group knowledge-library
46
60
  decidex platform show knowledge-library.folders.documents.create
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@guandata/decidex",
3
- "version": "0.3.0",
3
+ "version": "0.5.0",
4
4
  "description": "CLI for building and operating Decidex ontologies, agents, skills, sessions, and evaluations.",
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",