qiyu-cli 0.2.1 → 0.2.3
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 +433 -72
- package/dist/cli.js +48 -7
- package/dist/commands/api-notes.js +70 -0
- package/dist/commands/api.js +169 -49
- package/dist/commands/auth.js +151 -29
- package/dist/commands/credentials-source.js +30 -5
- package/dist/commands/db-notes.js +75 -0
- package/dist/commands/db.js +165 -127
- package/dist/commands/query-notes.js +58 -0
- package/dist/commands/query.js +449 -61
- package/dist/commands/skill.js +445 -51
- package/dist/commands/spec-types.js +101 -1
- package/dist/commands/stats.js +160 -33
- package/dist/commands/store-flags.js +18 -0
- package/dist/commands/store-notes.js +38 -0
- package/dist/commands/store-precheck.js +321 -0
- package/dist/commands/store.js +165 -77
- package/dist/commands/sync-notes.js +374 -0
- package/dist/commands/sync-run.js +180 -47
- package/dist/commands/sync.js +232 -127
- package/dist/core/config.js +280 -24
- package/dist/core/credentials.js +38 -4
- package/dist/core/edition.js +1 -1
- package/dist/core/envelope.js +73 -9
- package/dist/core/errors.js +73 -16
- package/dist/core/http.js +175 -54
- package/dist/core/ratelimit.js +5 -1
- package/dist/core/registry/index.js +36 -2
- package/dist/core/registry/params/export.session.check.json +17 -2
- package/dist/core/registry/params/export.session.json +24 -2
- package/dist/core/registry/params/export.session.one.json +10 -2
- package/dist/core/registry/params/export.session.one.message.json +17 -2
- package/dist/core/registry/specs.json +65 -43
- package/dist/core/shell.js +30 -0
- package/dist/core/time.js +1 -1
- package/dist/core/validate.js +21 -2
- package/dist/output.js +215 -29
- package/dist/postinstall.js +14 -5
- package/dist/query/errors.js +145 -45
- package/dist/query/mask.js +1277 -25
- package/dist/query/metric-catalog.js +11 -0
- package/dist/query/native-error.js +189 -0
- package/dist/query/sandbox.js +148 -25
- package/dist/query/table-query.js +36 -5
- package/dist/schedule/install.js +136 -13
- package/dist/skill/check.js +11 -6
- package/dist/skill/detect.js +89 -29
- package/dist/skill/install.js +233 -43
- package/dist/skill/paths.js +54 -0
- package/dist/skill/qiyu/SKILL.md +29 -5
- package/dist/skill/qiyu/errors.md +5 -4
- package/dist/skill/qiyu/protocols.md +57 -5
- package/dist/skill/qiyu/setup.md +6 -2
- package/dist/store/config.js +92 -16
- package/dist/store/duckdb.js +1551 -64
- package/dist/store/object-kinds.js +32 -0
- package/dist/store/retry.js +190 -7
- package/dist/store/schema.js +32 -4
- package/dist/sync/engine.js +439 -77
- package/dist/sync/registry.js +6 -0
- package/dist/sync/state.js +20 -0
- package/dist/sync/tasks/dim.js +23 -14
- package/dist/sync/tasks/knowledge.js +50 -8
- package/dist/sync/tasks/pace.js +27 -0
- package/dist/sync/tasks/pipeline.js +29 -9
- package/dist/sync/tasks/reports.js +176 -49
- package/dist/sync/tasks/sessions.js +88 -21
- package/dist/sync/tasks/tickets.js +59 -8
- package/dist/sync/types.js +60 -1
- package/dist/sync/windowing.js +0 -22
- package/dist/sync/write-contract.js +79 -0
- package/package.json +2 -2
|
@@ -155,9 +155,10 @@
|
|
|
155
155
|
"callable": true,
|
|
156
156
|
"dangerous": false,
|
|
157
157
|
"auth": "checksum",
|
|
158
|
-
"verified":
|
|
158
|
+
"verified": true,
|
|
159
159
|
"envelope": null,
|
|
160
|
-
"category": "在线系统/事件"
|
|
160
|
+
"category": "在线系统/事件",
|
|
161
|
+
"note": "成功信封已实测(2026-10-30):`{code:200, staffInfo:[…]}` —— 载荷在 **staffInfo**,成功时**没有 message**;失败时则相反(`{code:14004, message:\"'groupId' param error\"}`)。空 staffInfo([])是「组内无人在线」的**正常**状态,不是 not_found(解析走专用分支,恒不置 not_found)。⚠️ envelope 保持 null:A/B/C/D 没有可登记「载荷在非标准键」的形状,成功形态由结构分支处理、不读 envelope;这里的 null **不表示「未实测」**。该接口是否存在「code:200 + message 纯文本」的 C 式失败**未实测** —— 宽松兜底对这种报文会判成成功。"
|
|
161
162
|
},
|
|
162
163
|
{
|
|
163
164
|
"id": "crm.modifyOrder",
|
|
@@ -325,7 +326,8 @@
|
|
|
325
326
|
"auth": "checksum",
|
|
326
327
|
"verified": false,
|
|
327
328
|
"envelope": null,
|
|
328
|
-
"category": "在线系统/事件"
|
|
329
|
+
"category": "在线系统/事件",
|
|
330
|
+
"note": "成功路径未实测(2026-10-30):未排队的 uid 恒返回 `{code:14007, message:\"user not in queue\"}` —— 这是未排队 uid 的**预期回答**,不是错误(厂商对该接口 code 字段的描述与实际返回的 message 不一致);需要「正在排队」的 uid 才能取得成功信封,本次构造不出。"
|
|
329
331
|
},
|
|
330
332
|
{
|
|
331
333
|
"id": "event.queueEnter",
|
|
@@ -449,8 +451,9 @@
|
|
|
449
451
|
"dangerous": true,
|
|
450
452
|
"auth": "checksum",
|
|
451
453
|
"verified": true,
|
|
452
|
-
"envelope": "
|
|
453
|
-
"maxWindowDays": 6
|
|
454
|
+
"envelope": "M",
|
|
455
|
+
"maxWindowDays": 6,
|
|
456
|
+
"note": "⚠️ 窗口边界是**开**的(2026-11-08 真实凭证实测):跨度恰等于 6 × 86400000 = 518400000ms(144.0h)报 14004 Timestamp interval limit,518399999ms(143.9999h)通过 —— 必须**严格小于** 6 天;按 max_window_days 切到「恰好 6 天」必失败。`qiyu sync run sessions.export` 每窗发 end−1ms 正是为此(引擎的半开区间 → 本接口闭区间 [start, end] 的映射)。边界以下此前实测 143.5h 通过。"
|
|
454
457
|
},
|
|
455
458
|
{
|
|
456
459
|
"id": "export.session.check",
|
|
@@ -462,7 +465,7 @@
|
|
|
462
465
|
"dangerous": false,
|
|
463
466
|
"auth": "checksum",
|
|
464
467
|
"verified": true,
|
|
465
|
-
"envelope": "
|
|
468
|
+
"envelope": "M"
|
|
466
469
|
},
|
|
467
470
|
{
|
|
468
471
|
"id": "export.session.one",
|
|
@@ -570,7 +573,8 @@
|
|
|
570
573
|
"auth": "checksum",
|
|
571
574
|
"verified": false,
|
|
572
575
|
"envelope": null,
|
|
573
|
-
"category": "呼叫系统/外呼机器人"
|
|
576
|
+
"category": "呼叫系统/外呼机器人",
|
|
577
|
+
"note": "成功路径未实测(2026-10-30):返回 `{code:14500, message:\"Service Offline\"}` —— 服务端对该子服务报告离线,本账号无法走通成功路径(无法从报文区分是子服务未开通还是停用)。⚠️ 同模块的 `icoutcall.history.seat` 实测可用(code:200),可见 Service Offline 是**按子服务**判定,不是整个外呼模块离线;且 14500 这个码同时承载「内部错误」,报错时不能只按 message 区分成因。"
|
|
574
578
|
},
|
|
575
579
|
{
|
|
576
580
|
"id": "icoutcall.dialogFlow.fuzzySearch",
|
|
@@ -584,7 +588,8 @@
|
|
|
584
588
|
"auth": "checksum",
|
|
585
589
|
"verified": false,
|
|
586
590
|
"envelope": null,
|
|
587
|
-
"category": "呼叫系统/外呼机器人"
|
|
591
|
+
"category": "呼叫系统/外呼机器人",
|
|
592
|
+
"note": "成功路径未实测(2026-10-30):返回 `{code:14500, message:\"Service Offline\"}` —— 服务端对该子服务报告离线,本账号无法走通成功路径(无法从报文区分是子服务未开通还是停用)。⚠️ 同模块的 `icoutcall.history.seat` 实测可用(code:200),可见 Service Offline 是**按子服务**判定,不是整个外呼模块离线;且 14500 这个码同时承载「内部错误」,报错时不能只按 message 区分成因。"
|
|
588
593
|
},
|
|
589
594
|
{
|
|
590
595
|
"id": "icoutcall.dialogFlow.getDialogFlowList",
|
|
@@ -598,7 +603,8 @@
|
|
|
598
603
|
"auth": "checksum",
|
|
599
604
|
"verified": false,
|
|
600
605
|
"envelope": null,
|
|
601
|
-
"category": "呼叫系统/外呼机器人"
|
|
606
|
+
"category": "呼叫系统/外呼机器人",
|
|
607
|
+
"note": "成功路径未实测(2026-10-30):返回 `{code:14500, message:\"Service Offline\"}` —— 服务端对该子服务报告离线,本账号无法走通成功路径(无法从报文区分是子服务未开通还是停用)。⚠️ 同模块的 `icoutcall.history.seat` 实测可用(code:200),可见 Service Offline 是**按子服务**判定,不是整个外呼模块离线;且 14500 这个码同时承载「内部错误」,报错时不能只按 message 区分成因。"
|
|
602
608
|
},
|
|
603
609
|
{
|
|
604
610
|
"id": "icoutcall.get.customer",
|
|
@@ -612,7 +618,8 @@
|
|
|
612
618
|
"auth": "checksum",
|
|
613
619
|
"verified": false,
|
|
614
620
|
"envelope": null,
|
|
615
|
-
"category": "呼叫系统/外呼机器人"
|
|
621
|
+
"category": "呼叫系统/外呼机器人",
|
|
622
|
+
"note": "成功路径未实测(2026-10-30):返回 `{code:14500, message:\"Service Offline\"}` —— 服务端对该子服务报告离线,本账号无法走通成功路径(无法从报文区分是子服务未开通还是停用)。⚠️ 同模块的 `icoutcall.history.seat` 实测可用(code:200),可见 Service Offline 是**按子服务**判定,不是整个外呼模块离线;且 14500 这个码同时承载「内部错误」,报错时不能只按 message 区分成因。"
|
|
616
623
|
},
|
|
617
624
|
{
|
|
618
625
|
"id": "icoutcall.get.jobdetail",
|
|
@@ -626,7 +633,8 @@
|
|
|
626
633
|
"auth": "checksum",
|
|
627
634
|
"verified": false,
|
|
628
635
|
"envelope": null,
|
|
629
|
-
"category": "呼叫系统/外呼机器人"
|
|
636
|
+
"category": "呼叫系统/外呼机器人",
|
|
637
|
+
"note": "成功路径未实测(2026-10-30):返回 `{code:14500, message:\"Service Offline\"}` —— 服务端对该子服务报告离线,本账号无法走通成功路径(无法从报文区分是子服务未开通还是停用)。⚠️ 同模块的 `icoutcall.history.seat` 实测可用(code:200),可见 Service Offline 是**按子服务**判定,不是整个外呼模块离线;且 14500 这个码同时承载「内部错误」,报错时不能只按 message 区分成因。"
|
|
630
638
|
},
|
|
631
639
|
{
|
|
632
640
|
"id": "icoutcall.get.jobproperties",
|
|
@@ -640,7 +648,8 @@
|
|
|
640
648
|
"auth": "checksum",
|
|
641
649
|
"verified": false,
|
|
642
650
|
"envelope": null,
|
|
643
|
-
"category": "呼叫系统/外呼机器人"
|
|
651
|
+
"category": "呼叫系统/外呼机器人",
|
|
652
|
+
"note": "成功路径未实测(2026-10-30):返回 `{code:14500, message:\"Service Offline\"}` —— 服务端对该子服务报告离线,本账号无法走通成功路径(无法从报文区分是子服务未开通还是停用)。⚠️ 同模块的 `icoutcall.history.seat` 实测可用(code:200),可见 Service Offline 是**按子服务**判定,不是整个外呼模块离线;且 14500 这个码同时承载「内部错误」,报错时不能只按 message 区分成因。"
|
|
644
653
|
},
|
|
645
654
|
{
|
|
646
655
|
"id": "icoutcall.history.seat",
|
|
@@ -661,14 +670,15 @@
|
|
|
661
670
|
"pageId": "api-10845511",
|
|
662
671
|
"title": "呼叫团队历史总览数据",
|
|
663
672
|
"method": "POST",
|
|
664
|
-
"path": "/openapi/ipcc/history/
|
|
673
|
+
"path": "/openapi/ipcc/history/team",
|
|
665
674
|
"direction": "outbound",
|
|
666
675
|
"callable": true,
|
|
667
676
|
"dangerous": false,
|
|
668
677
|
"auth": "checksum",
|
|
669
|
-
"verified":
|
|
670
|
-
"envelope":
|
|
671
|
-
"category": "呼叫系统/数据接口"
|
|
678
|
+
"verified": false,
|
|
679
|
+
"envelope": null,
|
|
680
|
+
"category": "呼叫系统/数据接口",
|
|
681
|
+
"note": "路径与信封均未实测(2026-11-04 修正):此前本行被登记成与 `icoutcall.history.seat` **相同的路径** `/openapi/ipcc/history/seat`、信封 C(数组)—— 而设计稿两处记载 team 是**独立路径** `/ipcc/history/team`、载荷是**对象**(55 字段)。那份「已验证」实际验证的是 seat,按旧登记调用会把 team 的 body 发到 seat 路由、静默拿到坐席数组。本账号未取得 team 的成功样本(同模块部分子服务返回 14500 Service Offline),故路径按设计稿修正、信封与 verified 降为未实测。⚠️ 不要把 seat 的数组形状套用到本接口。"
|
|
672
682
|
},
|
|
673
683
|
{
|
|
674
684
|
"id": "icoutcall.job.create",
|
|
@@ -766,7 +776,8 @@
|
|
|
766
776
|
"auth": "checksum",
|
|
767
777
|
"verified": false,
|
|
768
778
|
"envelope": null,
|
|
769
|
-
"category": "呼叫系统/外呼机器人"
|
|
779
|
+
"category": "呼叫系统/外呼机器人",
|
|
780
|
+
"note": "成功路径未实测(2026-10-30):返回 `{code:14500, message:\"Service Offline\"}` —— 服务端对该子服务报告离线,本账号无法走通成功路径(无法从报文区分是子服务未开通还是停用)。⚠️ 同模块的 `icoutcall.history.seat` 实测可用(code:200),可见 Service Offline 是**按子服务**判定,不是整个外呼模块离线;且 14500 这个码同时承载「内部错误」,报错时不能只按 message 区分成因。"
|
|
770
781
|
},
|
|
771
782
|
{
|
|
772
783
|
"id": "ipcc.calltask.add.auto",
|
|
@@ -850,7 +861,8 @@
|
|
|
850
861
|
"auth": "checksum",
|
|
851
862
|
"verified": false,
|
|
852
863
|
"envelope": null,
|
|
853
|
-
"category": "呼叫系统/外呼任务"
|
|
864
|
+
"category": "呼叫系统/外呼任务",
|
|
865
|
+
"note": "成功路径未实测(2026-10-30):taskId=1 返回 `{code:8012, message:\"该任务id不存在\"}` —— 需要真实存在的呼叫任务 id,本次构造不出。"
|
|
854
866
|
},
|
|
855
867
|
{
|
|
856
868
|
"id": "ipcc.calltaskdetail.add",
|
|
@@ -890,9 +902,10 @@
|
|
|
890
902
|
"callable": true,
|
|
891
903
|
"dangerous": false,
|
|
892
904
|
"auth": "checksum",
|
|
893
|
-
"verified":
|
|
894
|
-
"envelope":
|
|
895
|
-
"category": "呼叫系统/外呼任务"
|
|
905
|
+
"verified": true,
|
|
906
|
+
"envelope": "A",
|
|
907
|
+
"category": "呼叫系统/外呼任务",
|
|
908
|
+
"note": "顶层信封形状已实测(2026-10-30):`{code, data}`,**无 message**(形状 A —— 载荷在 data)。⚠️ 只观测到 **空载荷**那一条路径:taskId=1 时 `code:200, data:{}`(该任务不存在,见 ipcc.calltask.get 的 8012),与「空 data = 查无此物」一致;**非空 data(有明细的真实任务)未取得样本**,字段集未知 —— 需要一个真实存在的呼叫任务 id 才能补测。"
|
|
896
909
|
},
|
|
897
910
|
{
|
|
898
911
|
"id": "ipcc.calltaskdetail.update",
|
|
@@ -918,9 +931,10 @@
|
|
|
918
931
|
"callable": true,
|
|
919
932
|
"dangerous": false,
|
|
920
933
|
"auth": "checksum",
|
|
921
|
-
"verified":
|
|
934
|
+
"verified": true,
|
|
922
935
|
"envelope": null,
|
|
923
|
-
"category": "呼叫系统/服务记录"
|
|
936
|
+
"category": "呼叫系统/服务记录",
|
|
937
|
+
"note": "成功信封已实测(2026-10-30):**裸 JSON 数组,完全没有 {code,message} 信封**(templateType=1 返回 1 个元素,键 id/name/description),解析先看首字符是否 '['。⚠️ envelope 保持 null:A/B/C/D 没有可登记这个形状的值,这里的 null **不表示「未实测」**。"
|
|
924
938
|
},
|
|
925
939
|
{
|
|
926
940
|
"id": "ipcc.login",
|
|
@@ -1131,7 +1145,8 @@
|
|
|
1131
1145
|
"auth": "checksum",
|
|
1132
1146
|
"verified": false,
|
|
1133
1147
|
"envelope": null,
|
|
1134
|
-
"category": "平台电商(Platform OpenAPI)"
|
|
1148
|
+
"category": "平台电商(Platform OpenAPI)",
|
|
1149
|
+
"note": "成功路径未实测(2026-10-30):返回 `{code:8002, message:\"appKey dose not belong to a platform\", total}`(message 拼写原文如此)—— `/platform/api/*` 需要**平台版 appKey**,企业版凭证被拒;须换平台版凭证再实测。"
|
|
1135
1150
|
},
|
|
1136
1151
|
{
|
|
1137
1152
|
"id": "merchant.query",
|
|
@@ -1145,7 +1160,8 @@
|
|
|
1145
1160
|
"auth": "checksum",
|
|
1146
1161
|
"verified": false,
|
|
1147
1162
|
"envelope": null,
|
|
1148
|
-
"category": "平台电商(Platform OpenAPI)"
|
|
1163
|
+
"category": "平台电商(Platform OpenAPI)",
|
|
1164
|
+
"note": "成功路径未实测(2026-10-30):返回 `{code:8002, message:\"appKey dose not belong to a platform\"}`(message 拼写原文如此)—— `/platform/api/*` 需要**平台版 appKey**,企业版凭证被拒;须换平台版凭证再实测。"
|
|
1149
1165
|
},
|
|
1150
1166
|
{
|
|
1151
1167
|
"id": "merchant.update",
|
|
@@ -1343,7 +1359,7 @@
|
|
|
1343
1359
|
"verified": true,
|
|
1344
1360
|
"envelope": null,
|
|
1345
1361
|
"category": "在线系统/消息收发",
|
|
1346
|
-
"note": "入站推送:方向相反,响应信封由我方实现决定,无从实测。⚠️ path 的 \"/\" 是**占位符**,不是真实路径 —— 本接口由七鱼回调我方,不存在可调用的 URL。callable 为 false 即表示这一点。⚠️
|
|
1362
|
+
"note": "入站推送:方向相反,响应信封由我方实现决定,无从实测。⚠️ path 的 \"/\" 是**占位符**,不是真实路径 —— 本接口由七鱼回调我方,不存在可调用的 URL。callable 为 false 即表示这一点。⚠️ 本记录与 `chat.queue.group.query`、`ipcc.customfield.template.get` 是全表仅有的三条 `verified: true` 与 `envelope: null` 并存的记录 —— 成因各不相同:那两条是**实测确认形状不在 A/B/C/D 内**(载荷在 staffInfo / 裸数组),本条是响应体由我方实现决定、**无从实测**;三条的 `envelope: null` 都**不表示「未实测」** —— 这里的 `verified` 指的是'**不可主动调用**已实测'(`/` 的 POST 302 实测 —— 它重定向到网易云商产品页,不是可调用的 API 端点),**不是**'信封已实测';信封(`envelope: null`)恰恰是**无从实测**的,因为响应体由我方实现决定。**也不是**'方向/鉴权已实测':`direction: inbound` 是据文档对 9 个推送页的分类(302 只证明它不可调用,不能证明七鱼确实会回调我们),`auth: eventType` 是按注册表类型联合做的分类(入站推送不走 checksum)—— 入站推送的**鉴权方式从未实测**(实测它必须真实接收一次推送,而 CLI 不接收推送)。与 `robot.transfer.config` 的 note 同理,不要据 `verified: true` 以为它的信封被验证过"
|
|
1347
1363
|
},
|
|
1348
1364
|
{
|
|
1349
1365
|
"id": "robot.data.getQuestionsByCategoryName",
|
|
@@ -1465,11 +1481,12 @@
|
|
|
1465
1481
|
"path": "/openapi/robot/session/chat",
|
|
1466
1482
|
"direction": "outbound",
|
|
1467
1483
|
"callable": true,
|
|
1468
|
-
"dangerous":
|
|
1484
|
+
"dangerous": true,
|
|
1469
1485
|
"auth": "checksum",
|
|
1470
1486
|
"verified": false,
|
|
1471
1487
|
"envelope": null,
|
|
1472
|
-
"category": "机器人/消息接口/会话类接口"
|
|
1488
|
+
"category": "机器人/消息接口/会话类接口",
|
|
1489
|
+
"note": "成功路径未实测(2026-10-30):`msg` 传字符串返回 `{code:14004, message:\"body内容json解析错误\"}` —— 必须传**对象** `{\"msgType\":\"text\",\"msgBody\":{\"content\":\"…\"}}`(此前已实测记录;厂商文档把 msg 标成 type:string,是错的)。⚠️ 该接口**不是只读**:会话不存在时会**自动创建真实会话**并返回 sessionId,成功调用会向生产机器人写入会话数据(且未命中 FAQ 时 sessionId 会轮换)—— 故未继续采样。**2026-11-19 改判 `dangerous: false → true`**:此前登记为 false 并附注「只表示非破坏性、不代表无副作用」,但 §5.2 对 `dangerous` 的定义是「**写**/破坏性操作 → 需要 --yes」—— 它会写(自动建会话),且同族的 `robot.session.create` 就是 true。误分类的代价是一次不动声色的生产写入被门禁放行,因此按定义收口,`--yes` 门禁自此生效。"
|
|
1473
1490
|
},
|
|
1474
1491
|
{
|
|
1475
1492
|
"id": "robot.session.close",
|
|
@@ -1495,9 +1512,10 @@
|
|
|
1495
1512
|
"callable": true,
|
|
1496
1513
|
"dangerous": false,
|
|
1497
1514
|
"auth": "checksum",
|
|
1498
|
-
"verified":
|
|
1499
|
-
"envelope":
|
|
1500
|
-
"category": "机器人/消息接口/会话类接口"
|
|
1515
|
+
"verified": true,
|
|
1516
|
+
"envelope": "A",
|
|
1517
|
+
"category": "机器人/消息接口/会话类接口",
|
|
1518
|
+
"note": "成功信封已实测(2026-10-30):`{code:200, data:{groupQuestions:[…], questionGuide, questionList:[…], robotId}}`,顶层只有 code 与 data、没有 message;本次一次实测 data 恒含上述 4 键。⚠️ 空 data({})会按形状 A 的通用规则置 not_found。"
|
|
1501
1519
|
},
|
|
1502
1520
|
{
|
|
1503
1521
|
"id": "robot.session.create",
|
|
@@ -1565,9 +1583,10 @@
|
|
|
1565
1583
|
"callable": true,
|
|
1566
1584
|
"dangerous": false,
|
|
1567
1585
|
"auth": "checksum",
|
|
1568
|
-
"verified":
|
|
1569
|
-
"envelope":
|
|
1570
|
-
"category": "机器人/消息接口/会话类接口"
|
|
1586
|
+
"verified": true,
|
|
1587
|
+
"envelope": "A",
|
|
1588
|
+
"category": "机器人/消息接口/会话类接口",
|
|
1589
|
+
"note": "成功信封已实测(2026-10-30):`{code:200, data:[{action, content, label}, …]}`(本次 8 条),顶层**没有 message** —— 与厂商 schema 矛盾(该端点 schema 对 code/message 本身的描述也是错的)。⚠️ 此前实测:`question` 是死参数(返回同一份静态快捷短语列表);缺 `uid` 返回 14004。空数组(无快捷短语)会按形状 A 的通用规则置 not_found。"
|
|
1571
1590
|
},
|
|
1572
1591
|
{
|
|
1573
1592
|
"id": "robot.session.transfer",
|
|
@@ -1994,9 +2013,10 @@
|
|
|
1994
2013
|
"callable": true,
|
|
1995
2014
|
"dangerous": false,
|
|
1996
2015
|
"auth": "checksum",
|
|
1997
|
-
"verified":
|
|
1998
|
-
"envelope":
|
|
1999
|
-
"category": "工单系统"
|
|
2016
|
+
"verified": true,
|
|
2017
|
+
"envelope": "C",
|
|
2018
|
+
"category": "工单系统",
|
|
2019
|
+
"note": "成功信封已实测(2026-10-30):`{code:200, message:\"<JSON 字符串>\"}`,message 解析为 `{total, tickets:[…]}` —— 形状 C。⚠️ 别把「形状 C 的错误也返回 code:200」当成普遍规律:staffId 非法时返回 **code:14100** + 纯文本 `Bad holder staff id`(不是 200)—— C 类解析先看 code 再看 message,两条路径都判得对,但 C 族的错误码不恒为 200。⚠️ 行内 `follower` 是**字符串**(ticket.new.detail 里是对象)。"
|
|
2000
2020
|
},
|
|
2001
2021
|
{
|
|
2002
2022
|
"id": "ticket.log",
|
|
@@ -2008,9 +2028,10 @@
|
|
|
2008
2028
|
"callable": true,
|
|
2009
2029
|
"dangerous": false,
|
|
2010
2030
|
"auth": "checksum",
|
|
2011
|
-
"verified":
|
|
2012
|
-
"envelope":
|
|
2013
|
-
"category": "工单系统"
|
|
2031
|
+
"verified": true,
|
|
2032
|
+
"envelope": "A",
|
|
2033
|
+
"category": "工单系统",
|
|
2034
|
+
"note": "成功信封已实测(2026-10-30):`{code:200, data:[…]}`,顶层**只有 code 与 data、没有 message 键**;失败路径(ticketId 不存在)返回 `{code:14106, message:\"Invalid worksheet\"}` —— **同一接口的顶层键集随成败变化**(成功 {code,data}、失败 {code,message}),envelope 按「载荷在 data」登记。⚠️ `data:[]`(工单无操作记录)会按形状 A 的通用规则置 not_found —— 该情形未实测。"
|
|
2014
2035
|
},
|
|
2015
2036
|
{
|
|
2016
2037
|
"id": "ticket.modify",
|
|
@@ -2036,9 +2057,10 @@
|
|
|
2036
2057
|
"callable": true,
|
|
2037
2058
|
"dangerous": false,
|
|
2038
2059
|
"auth": "checksum",
|
|
2039
|
-
"verified":
|
|
2040
|
-
"envelope":
|
|
2041
|
-
"category": "工单系统"
|
|
2060
|
+
"verified": true,
|
|
2061
|
+
"envelope": "A",
|
|
2062
|
+
"category": "工单系统",
|
|
2063
|
+
"note": "成功信封已实测(2026-10-30):`{code:200, data:{…}}`(data 是工单对象,含 attachments/content/customField/follower/questionType 等),顶层只有 code 与 data、没有 message;失败路径与 ticket.log 相同(14106 Invalid worksheet)。⚠️ `follower` 在本端点是**对象**、在 ticket.list 行里却是**字符串**(同名字段形状随命令不同)。⚠️ 此前记载历史工单的 follower 可能含**整数键未加引号**的畸形 JSON(会让整个响应体 JSON.parse 失败,信封层的修复只覆盖 message 载荷、覆盖不到它);本次 5 个样本(含最早 19 张工单里 follower 非空者)全部解析正常,未复现。"
|
|
2042
2064
|
},
|
|
2043
2065
|
{
|
|
2044
2066
|
"id": "ticket.reminder",
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
// src/core/shell.ts
|
|
2
|
+
//
|
|
3
|
+
// shell 参数的**方言感知引号**(单一实现点)。放在 core 层而非 output.ts:
|
|
4
|
+
// `core/config.ts` 的 chmod/icacls hint 也要渲染可执行命令,而架构不变量
|
|
5
|
+
// 禁止 core/ import output.js(tests/cli.test.ts 静态扫描钉着)——
|
|
6
|
+
// 下沉到这里后 core 与 CLI 层各自引用同一份实现。
|
|
7
|
+
/**
|
|
8
|
+
* 单个参数值的 shell 渲染:安全集内裸渲染,其余单引号包裹。
|
|
9
|
+
* POSIX 安全集取自 Python `shlex.quote`(`[A-Za-z0-9_@%+=:,./-]`);**win32 安全集更窄**
|
|
10
|
+
*(去掉 `@` `%` `,`)—— PowerShell 下裸 `a,b` 会变成 `Object[]`、前导 `@` 是 splatting、
|
|
11
|
+
* `%` 是 ForEach-Object 别名(pwsh 实测:`--profile a,b` → argc=2 且 arg 是数组)。
|
|
12
|
+
* 引号内的转义**方言按平台区分**:
|
|
13
|
+
* · POSIX 用 `'\''`(关引号→转义单引号→重开引号);
|
|
14
|
+
* · PowerShell 用 `''`(反斜杠不是转义符,POSIX 写法会被 pwsh 解析成「提前闭合引号 +
|
|
15
|
+
* `;` 切命令」,2026-10-30 pwsh 实测能执行注入载荷)。
|
|
16
|
+
* ⚠️ PowerShell 还把 **4 个弯引号 `‘ ’ ‚ ‛`(U+2018/2019/201A/201B)当作单引号定界符**
|
|
17
|
+
*(pwsh 实测:`'/tmp/a’; echo X; #'` 提前闭合并执行 echo)—— win32 分支同样翻倍它们,
|
|
18
|
+
* 只处理 ASCII `'` 会漏(CodeRabbit 2026-10-30 minor,已实测复现)。
|
|
19
|
+
* ⚠️ 解析出的路径恒为绝对路径,不含 `~`,故无「引号会阻止波浪号展开」的问题。
|
|
20
|
+
*/
|
|
21
|
+
export function shellArg(v, platform = process.platform) {
|
|
22
|
+
const win = platform === 'win32';
|
|
23
|
+
const safe = win ? /^[A-Za-z0-9_+=:./-]+$/ : /^[A-Za-z0-9_@%+=:,./-]+$/;
|
|
24
|
+
if (safe.test(v))
|
|
25
|
+
return v;
|
|
26
|
+
const escaped = win
|
|
27
|
+
? v.replace(/['‘’‚‛]/g, (c) => c + c)
|
|
28
|
+
: v.replace(/'/g, `'\\''`);
|
|
29
|
+
return `'${escaped}'`;
|
|
30
|
+
}
|
package/dist/core/time.js
CHANGED
|
@@ -48,7 +48,7 @@ export function shanghaiDayStart(ms) {
|
|
|
48
48
|
}
|
|
49
49
|
/**
|
|
50
50
|
* 毫秒 → 上海「昨天 00:00」的 epoch 毫秒。
|
|
51
|
-
* attendance/performance 的 `endTime`
|
|
51
|
+
* attendance/performance 的 `endTime` 必须早于今天 00:00(`14501 endTime is invalid`),
|
|
52
52
|
* 且实测「今天 0:00」这条边界不稳定(同一取值时而 200 时而 14501,设计稿 §6.2)——
|
|
53
53
|
* 统一退到昨天 0:00 留整日余量:当天数据不做(次日自动补上),绝不贴着边界。
|
|
54
54
|
*/
|
package/dist/core/validate.js
CHANGED
|
@@ -48,7 +48,10 @@ export function normalizeAliases(file, body, ov) {
|
|
|
48
48
|
}
|
|
49
49
|
const BODY_TYPE_MAP = {
|
|
50
50
|
string: (v) => typeof v === 'string',
|
|
51
|
-
|
|
51
|
+
// ⚠️ 必须是 Number.isInteger,不能只判 typeof === 'number':后者放行 1.5,
|
|
52
|
+
// 而注册表声明 integer 的字段(id、页码、时间戳)传小数会被服务端截断或报 14004,
|
|
53
|
+
// 图例却承诺「类型不符是软告警」—— 等于让 Agent 以为已通过检查。
|
|
54
|
+
integer: (v) => typeof v === 'number' && Number.isInteger(v),
|
|
52
55
|
number: (v) => typeof v === 'number',
|
|
53
56
|
boolean: (v) => typeof v === 'boolean',
|
|
54
57
|
array: (v) => Array.isArray(v),
|
|
@@ -69,11 +72,27 @@ export function validateBody(spec, file, body, ov, mode) {
|
|
|
69
72
|
const hasBodySchema = file.bodyKind === 'json' && bodyParams.length > 0;
|
|
70
73
|
// bodyKind !== 'json' 的接口根本不进形状表:只可能出 non_json_body(软)。
|
|
71
74
|
// ⚠️ message 不得含「未验证」(spec §四 第 68 条③ + 验收 9)——那是「值得再试」的措辞;只陈述「已发出 + 不要重发」。
|
|
75
|
+
// ⚠️ 也不能说「按原样字面量发送」(2026-11-07 审查实测):`--body` 先 JSON.parse,
|
|
76
|
+
// 再经 http.ts 的 buildBody = JSON.stringify 发出,Content-Type 恒 application/json
|
|
77
|
+
// (http.ts 只有这一条发送通道)。所谓「原样」连空白与转义都不成立,
|
|
78
|
+
// xml/multipart/text/form 的原始字节更是无法表达 —— 与 `api schema` 的 body_kind
|
|
79
|
+
// 图例(「传输层恒为 JSON」)逐字对齐。
|
|
80
|
+
// ⚠️ bodyKind `none` 的 callable 接口(data.overview.ipcc、icoutcall.phone.getLineList 等)
|
|
81
|
+
// 也走这里:它们不吃任何 body,传了的 JSON 会被发出去并被忽略 —— 同样要说「该编码无法表达」,
|
|
82
|
+
// 不能笼统说成「服务端会解析失败」。
|
|
72
83
|
if (file.bodyKind !== 'json') {
|
|
73
84
|
if (body === undefined)
|
|
74
85
|
return { hard: [], soft: [] };
|
|
86
|
+
const kind = sanitizeControlChars(file.bodyKind);
|
|
75
87
|
return { hard: [], soft: [{ kind: 'non_json_body',
|
|
76
|
-
message: `本接口 body_kind 是 ${
|
|
88
|
+
message: `本接口 body_kind 是 ${kind}:本 CLI 只有一条发送通道 —— `
|
|
89
|
+
+ '--body 一律 JSON.parse 后再 JSON.stringify、Content-Type 恒 application/json,'
|
|
90
|
+
+ (file.bodyKind === 'none'
|
|
91
|
+
? '该接口不接收 body。'
|
|
92
|
+
: `${kind} 的原始编码(如 xml 标签、multipart 分段)无法表达。`)
|
|
93
|
+
+ '你给的字面量未经该编码表达 —— 该请求已发出(按 JSON 字节),'
|
|
94
|
+
+ (file.bodyKind === 'none' ? '服务端多半忽略它' : '服务端多半按 JSON 解析而失败')
|
|
95
|
+
+ ';不要重发(重发 = 再执行一次接口,写接口会重复写入)' }] };
|
|
77
96
|
}
|
|
78
97
|
if (!hasBodySchema)
|
|
79
98
|
return { hard: [], soft: [] };
|