@zaofan/dsh-qqbot 1.8.8 → 1.9.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.
Files changed (60) hide show
  1. package/README.md +113 -26
  2. package/README_EN.md +122 -8
  3. package/dist/features/ext-capabilities.d.ts +85 -0
  4. package/dist/features/ext-capabilities.d.ts.map +1 -1
  5. package/dist/features/ext-capabilities.js +4 -0
  6. package/dist/features/ext-capabilities.js.map +1 -1
  7. package/dist/features/ext-hooks.d.ts +84 -0
  8. package/dist/features/ext-hooks.d.ts.map +1 -0
  9. package/dist/features/ext-hooks.js +299 -0
  10. package/dist/features/ext-hooks.js.map +1 -0
  11. package/dist/features/ext-inbound-context.d.ts +202 -0
  12. package/dist/features/ext-inbound-context.d.ts.map +1 -0
  13. package/dist/features/ext-inbound-context.js +724 -0
  14. package/dist/features/ext-inbound-context.js.map +1 -0
  15. package/dist/features/ext-inbound-state.d.ts +153 -0
  16. package/dist/features/ext-inbound-state.d.ts.map +1 -0
  17. package/dist/features/ext-inbound-state.js +419 -0
  18. package/dist/features/ext-inbound-state.js.map +1 -0
  19. package/dist/features/ext-inbound.d.ts +117 -0
  20. package/dist/features/ext-inbound.d.ts.map +1 -0
  21. package/dist/features/ext-inbound.js +518 -0
  22. package/dist/features/ext-inbound.js.map +1 -0
  23. package/dist/features/ext-reload.d.ts +22 -0
  24. package/dist/features/ext-reload.d.ts.map +1 -1
  25. package/dist/features/ext-reload.js +32 -0
  26. package/dist/features/ext-reload.js.map +1 -1
  27. package/dist/features/extension-store.d.ts +13 -0
  28. package/dist/features/extension-store.d.ts.map +1 -1
  29. package/dist/features/extension-store.js +32 -4
  30. package/dist/features/extension-store.js.map +1 -1
  31. package/dist/gateway/bootstrap.d.ts.map +1 -1
  32. package/dist/gateway/bootstrap.js +44 -0
  33. package/dist/gateway/bootstrap.js.map +1 -1
  34. package/dist/gateway/debounce.d.ts +43 -1
  35. package/dist/gateway/debounce.d.ts.map +1 -1
  36. package/dist/gateway/debounce.js +71 -35
  37. package/dist/gateway/debounce.js.map +1 -1
  38. package/dist/gateway/middleware-setup.d.ts.map +1 -1
  39. package/dist/gateway/middleware-setup.js +88 -1
  40. package/dist/gateway/middleware-setup.js.map +1 -1
  41. package/dist/session/session-manager.d.ts.map +1 -1
  42. package/dist/session/session-manager.js +7 -3
  43. package/dist/session/session-manager.js.map +1 -1
  44. package/dist/shared/utils.d.ts +6 -0
  45. package/dist/shared/utils.d.ts.map +1 -1
  46. package/dist/shared/utils.js +6 -2
  47. package/dist/shared/utils.js.map +1 -1
  48. package/dist/transport/inbound.d.ts.map +1 -1
  49. package/dist/transport/inbound.js +23 -3
  50. package/dist/transport/inbound.js.map +1 -1
  51. package/docs/USER-GUIDE.md +92 -35
  52. package/docs/botplay-contract.md +2 -0
  53. package/docs/extension-contract.md +187 -0
  54. package/examples/ext-hooks/README.md +95 -0
  55. package/examples/ext-hooks/hello-hook.mjs +54 -0
  56. package/examples/ext-hooks/session-watch-hook.mjs +119 -0
  57. package/examples/ext-inbound/README.md +230 -0
  58. package/examples/ext-inbound/class-advisor.mjs +306 -0
  59. package/examples/ext-inbound/no-wake-on-child-quote.mjs +192 -0
  60. package/package.json +2 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ext-inbound-state.js","sourceRoot":"","sources":["../../src/features/ext-inbound-state.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,117 @@
1
+ import type { Middleware, MiddlewareContext } from '@tencent-connect/qqbot-nodejs';
2
+ import type { Logger } from '../types.js';
3
+ /** 一个已装载的入站扩展 */
4
+ export interface InboundExtension {
5
+ /** 文件名(含扩展名),日志与诊断用 */
6
+ file: string;
7
+ /** 绝对路径 */
8
+ path: string;
9
+ /** 展示名:模块导出的 `name` 优先,否则去扩展名的文件名 */
10
+ name: string;
11
+ /** **晚**挂点(onDecide / 默认导出 / middleware)—— 与 `bot.use(mw)` 同一个签名 */
12
+ middleware: Middleware;
13
+ /** **早**挂点(onInbound)—— 可选;没有就是纯晚挂点扩展 */
14
+ onInbound?: Middleware;
15
+ /** 可选:模块导出的 `dispose()`,插件卸载时调用 */
16
+ dispose?: () => unknown;
17
+ }
18
+ /** 一次装载的汇总 */
19
+ export interface InboundLoadResult {
20
+ /** 形状合法、已装载的扩展数 */
21
+ total: number;
22
+ /** 形状不合法(没有中间件)或 import 就炸,被跳过的数 */
23
+ skipped: number;
24
+ /** 装载到的**晚**挂点中间件,按文件名升序(直接交给 {@link runInboundExtensions}) */
25
+ middleware: Middleware[];
26
+ /** 装载到的**早**挂点中间件,按文件名升序(直接交给 {@link runEarlyInboundExtensions}) */
27
+ early: Middleware[];
28
+ /** 明细(诊断用) */
29
+ extensions: InboundExtension[];
30
+ /** 目录里被发现、扩展名合法的文件名(升序) */
31
+ files: string[];
32
+ }
33
+ /** `loadInboundExtensions` 的入参 */
34
+ export interface LoadInboundOptions {
35
+ dataRoot: string;
36
+ logger: Logger;
37
+ }
38
+ /** 运行器入参:动作 API 需要的环境(缺 dataRoot 时名单/kv/审计一律降级为空操作,绝不往相对路径写盘) */
39
+ export interface ExtRunOptions {
40
+ /** 数据根(状态文件 + 审计落它下面) */
41
+ dataRoot?: string;
42
+ /** 主人 openid 白名单(`config.groupAdmin.owners`)—— 白名单最高优先靠它 */
43
+ owners?: string[];
44
+ /** bot 的 appId(`ctx.platform.mentioned` 的内容兜底扫描用,与 SDK mentionGate 同款判据) */
45
+ appId?: string;
46
+ /** 当前会话的发送器(发消息/发富媒体用) */
47
+ sender?: unknown;
48
+ /** 当前这条消息的回复目标(被动回复优先) */
49
+ replyTarget?: unknown;
50
+ /** bot 密钥(`api()` 自建 token 兜底) */
51
+ appSecret?: string;
52
+ /** 带 token 的官方 API 调用(挂载点取 `manager.groupAdmin.apiCall`) */
53
+ apiCall?: unknown;
54
+ /** 插件自己的 cordis Context → 能力包里的 `kernel`("遥控器") */
55
+ kernel?: unknown;
56
+ /** `silentInto` 用:把"这条消息所属会话的宿主 agent"解析出来 */
57
+ resolveAgent?: (ctx: MiddlewareContext) => unknown;
58
+ }
59
+ /** 入站扩展目录(相对数据根) */
60
+ export declare function inboundExtensionsDir(dataRoot: string): string;
61
+ /**
62
+ * 扫描 `{dataRoot}/.qqbot-extensions/inbound/*.mjs` 并装载。
63
+ *
64
+ * 目录不存在 / 为空 → 返回空结果,**不打任何日志**。
65
+ * 单个文件 import 失败或形状不合法 → 只记 `warn`,继续下一个;本函数**永不抛出**。
66
+ * 重新调用 = 热重载:`loaded` 被整体替换成新一批(旧版模块留给 dispose 收尾),
67
+ * 并**复位每个文件的熔断记录**(这是文档写明的熔断恢复通道)。
68
+ */
69
+ export declare function loadInboundExtensions(opts: LoadInboundOptions): Promise<InboundLoadResult>;
70
+ /**
71
+ * 跑一遍**早**挂点(`onInbound`):挂载点在 quoteRef 之后、**记群历史之前**。
72
+ *
73
+ * 与晚挂点共用同一套兜底(单扩展 try/catch、next() 幂等且一定被 await、下游异常原样上抛),
74
+ * 外加一条:`ctx.annihilate()` 置位后,**即便扩展又调了 next() 也不再往下走**
75
+ * (消灭的语义是"不进历史、不进上下文、不占冷却",只能靠"链停在这里"实现)。
76
+ * 没导出 `onInbound` 的扩展自动跳过(不占一层 next)。
77
+ */
78
+ export declare function runEarlyInboundExtensions(exts: InboundExtension[], ctx: MiddlewareContext, finalNext: () => Promise<void>, logger: Logger, opts?: ExtRunOptions): Promise<void>;
79
+ /**
80
+ * 跑一遍**晚**挂点(`onDecide` / 默认导出):挂载点在 mentionGate 之后、contentSanitizer 之前。
81
+ *
82
+ * 这是本扩展点自 2026-10-12 起的原有契约(洋葱模型:ext0 → ext1 → … → finalNext),
83
+ * 挂载点与单元测试都直接调它(不依赖 SDK 的 `runMiddlewareChain`)。
84
+ *
85
+ * 三条兜底(见文件头"铁律"):
86
+ * · 扩展抛错且**还没往下走** ⇒ 告警 + 替它 `next()`(用户脚本坏了,消息也绝不能被吞掉);
87
+ * · 扩展抛错但**已经往下走** ⇒ 原样把下游的异常上抛(那是下游的错,不能记成"扩展坏了");
88
+ * · 扩展忘了 await `next()` ⇒ 引擎替它 await(保证中间件链的顺序语义)。
89
+ * 扩展**不调** `next()` ⇒ 整条链到此为止(这是合法用法:这条消息被拦掉;但群历史**已经**记过)。
90
+ */
91
+ export declare function runInboundExtensions(exts: InboundExtension[], ctx: MiddlewareContext, finalNext: () => Promise<void>, logger: Logger, opts?: ExtRunOptions): Promise<void>;
92
+ /**
93
+ * 把已装载的扩展组合成一个中间件(等价于 {@link runInboundExtensions} 的中间件写法)。
94
+ * 挂载点用的是"可变列表 + runInboundExtensions"(为了热重载),这个组合版给需要固定列表的场景用。
95
+ */
96
+ export declare function composeInboundExtensions(exts: InboundExtension[], logger: Logger, opts?: ExtRunOptions): Middleware;
97
+ /**
98
+ * 只把 ctx 的动作 API 提前挂上(不跑任何扩展)。
99
+ * 正常使用不必调 —— 两个运行器都会自动挂;需要它的场景是调用方自己写了
100
+ * "早挂点之后、晚挂点之前"的中间件,想读 `ctx.state.qqInboundForceWake` 之类由动作设置的标记。
101
+ */
102
+ export declare function attachExtContext(ctx: MiddlewareContext, logger: Logger, opts?: ExtRunOptions): void;
103
+ /**
104
+ * 调用所有入站扩展的 `dispose()`(插件卸载 / 宿主退出 / 保存连接设置后重建网关)。
105
+ *
106
+ * 纪律:**逆序**执行(后装载的先清理)、单个失败只告警、整体永不抛出、幂等、清空登记。
107
+ * 返回本次真正调用成功的 dispose 数量(没有导出的 dispose 就不算)。
108
+ * 同时把 ext-reload 里的热重载入口摘掉 —— 否则它会一直指向这个已经死掉的实例。
109
+ */
110
+ export declare function disposeInboundExtensions(logger: Logger): Promise<number>;
111
+ /** 重置模块级状态(仅供单元测试;生产不要调 —— 会把正在生效的扩展登记丢掉) */
112
+ export declare function __resetInboundExtensionsForTest(): void;
113
+ /** 当前登记在册的扩展数(诊断用) */
114
+ export declare function inboundExtensionsCount(): number;
115
+ /** 当前生效的那一批(诊断用;返回副本,防外部改动) */
116
+ export declare function currentInboundExtensions(): InboundExtension[];
117
+ //# sourceMappingURL=ext-inbound.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ext-inbound.d.ts","sourceRoot":"","sources":["../../src/features/ext-inbound.ts"],"names":[],"mappings":"AAwGA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAe1C,iBAAiB;AACjB,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,UAAU,EAAE,UAAU,CAAC;IACvB,yCAAyC;IACzC,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;CACzB;AAED,cAAc;AACd,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,oEAAoE;IACpE,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,cAAc;IACd,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,iEAAiE;AACjE,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IAOf,0BAA0B;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC;CACpD;AAED,oBAAoB;AACpB,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7D;AA4GD;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwDhG;AAmED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,gBAAgB,EAAE,EACxB,GAAG,EAAE,iBAAiB,EACtB,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,IAAI,CAAC,CA4Df;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,gBAAgB,EAAE,EACxB,GAAG,EAAE,iBAAiB,EACtB,SAAS,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,aAAa,GACnB,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,UAAU,CAEnH;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,CAEnG;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB9E;AAED,6CAA6C;AAC7C,wBAAgB,+BAA+B,IAAI,IAAI,CAGtD;AAED,sBAAsB;AACtB,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,+BAA+B;AAC/B,wBAAgB,wBAAwB,IAAI,gBAAgB,EAAE,CAE7D"}