dsh-qqbot-plus 0.0.0-stage → 0.1.2
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/CHANGELOG.md +188 -0
- package/CHANGELOG_EN.md +188 -0
- package/LICENSE +21 -0
- package/README.md +281 -2
- package/README_EN.md +248 -0
- package/cordis.patch.yml +163 -0
- package/cordis.yml +112 -0
- package/install.sh +108 -0
- package/lib/alarms.js +371 -0
- package/lib/client.js +2411 -0
- package/lib/commands/auth.d.ts +18 -0
- package/lib/commands/auth.d.ts.map +1 -0
- package/lib/commands/auth.js +15 -0
- package/lib/commands/auth.js.map +1 -0
- package/lib/commands/help.d.ts +10 -0
- package/lib/commands/help.d.ts.map +1 -0
- package/lib/commands/help.js +39 -0
- package/lib/commands/help.js.map +1 -0
- package/lib/commands/index.d.ts +15 -0
- package/lib/commands/index.d.ts.map +1 -0
- package/lib/commands/index.js +30 -0
- package/lib/commands/index.js.map +1 -0
- package/lib/commands/misc.d.ts +21 -0
- package/lib/commands/misc.d.ts.map +1 -0
- package/lib/commands/misc.js +93 -0
- package/lib/commands/misc.js.map +1 -0
- package/lib/commands/model.d.ts +6 -0
- package/lib/commands/model.d.ts.map +1 -0
- package/lib/commands/model.js +63 -0
- package/lib/commands/model.js.map +1 -0
- package/lib/commands/new.js +17 -0
- package/lib/commands/preset.d.ts +8 -0
- package/lib/commands/preset.d.ts.map +1 -0
- package/lib/commands/preset.js +56 -0
- package/lib/commands/preset.js.map +1 -0
- package/lib/commands/session.d.ts +14 -0
- package/lib/commands/session.d.ts.map +1 -0
- package/lib/commands/session.js +34 -0
- package/lib/commands/session.js.map +1 -0
- package/lib/commands/status.d.ts +7 -0
- package/lib/commands/status.d.ts.map +1 -0
- package/lib/commands/status.js +26 -0
- package/lib/commands/status.js.map +1 -0
- package/lib/commands/types.d.ts +21 -0
- package/lib/commands/types.d.ts.map +1 -0
- package/lib/commands/types.js +2 -0
- package/lib/commands/types.js.map +1 -0
- package/lib/config.d.ts +95 -0
- package/lib/config.js +88 -0
- package/lib/features/answer-parser.d.ts +9 -0
- package/lib/features/answer-parser.d.ts.map +1 -0
- package/lib/features/answer-parser.js +23 -0
- package/lib/features/answer-parser.js.map +1 -0
- package/lib/features/approval-channel.d.ts +94 -0
- package/lib/features/approval-channel.d.ts.map +1 -0
- package/lib/features/approval-channel.js +158 -0
- package/lib/features/approval-channel.js.map +1 -0
- package/lib/features/approval-renderer.d.ts +18 -0
- package/lib/features/approval-renderer.d.ts.map +1 -0
- package/lib/features/approval-renderer.js +52 -0
- package/lib/features/approval-renderer.js.map +1 -0
- package/lib/features/button-utils.d.ts +34 -0
- package/lib/features/button-utils.d.ts.map +1 -0
- package/lib/features/button-utils.js +27 -0
- package/lib/features/button-utils.js.map +1 -0
- package/lib/features/history-store.d.ts +8 -0
- package/lib/features/history-store.d.ts.map +1 -0
- package/lib/features/history-store.js +23 -0
- package/lib/features/history-store.js.map +1 -0
- package/lib/features/question-channel.d.ts +96 -0
- package/lib/features/question-channel.d.ts.map +1 -0
- package/lib/features/question-channel.js +234 -0
- package/lib/features/question-channel.js.map +1 -0
- package/lib/features/question-renderer.d.ts +20 -0
- package/lib/features/question-renderer.d.ts.map +1 -0
- package/lib/features/question-renderer.js +70 -0
- package/lib/features/question-renderer.js.map +1 -0
- package/lib/fishcheck/measure.js +230 -0
- package/lib/fishcheck/rules.js +99 -0
- package/lib/fishmeme/plugin.js +605 -0
- package/lib/fishmeme/routes.js +141 -0
- package/lib/fishmemory/plugin.js +1052 -0
- package/lib/gateway/bootstrap.d.ts +12 -0
- package/lib/gateway/bootstrap.d.ts.map +1 -0
- package/lib/gateway/bootstrap.js +200 -0
- package/lib/gateway/bootstrap.js.map +1 -0
- package/lib/gateway/index.d.ts +3 -0
- package/lib/gateway/index.d.ts.map +1 -0
- package/lib/gateway/index.js +3 -0
- package/lib/gateway/index.js.map +1 -0
- package/lib/gateway/middleware-setup.d.ts +12 -0
- package/lib/gateway/middleware-setup.d.ts.map +1 -0
- package/lib/gateway/middleware-setup.js +82 -0
- package/lib/gateway/middleware-setup.js.map +1 -0
- package/lib/host/adapter.d.ts +48 -0
- package/lib/host/adapter.d.ts.map +1 -0
- package/lib/host/adapter.js +127 -0
- package/lib/host/adapter.js.map +1 -0
- package/lib/humanlike/ENV_PROMPT.md +28 -0
- package/lib/humanlike/affinity.js +316 -0
- package/lib/humanlike/learn.js +343 -0
- package/lib/humanlike/life.js +899 -0
- package/lib/humanlike/mind.js +323 -0
- package/lib/humanlike/plugin.js +587 -0
- package/lib/humanlike/reach.js +119 -0
- package/lib/humanlike/real.js +276 -0
- package/lib/humanlike/rules.js +67 -0
- package/lib/humanlike/settings-api.js +159 -0
- package/lib/humanlike/settings.js +370 -0
- package/lib/humanlike/together.js +251 -0
- package/lib/identity/paths.js +27 -0
- package/lib/identity/persona.js +75 -0
- package/lib/identity/portrait.js +25 -0
- package/lib/identity/runtime.js +78 -0
- package/lib/index.d.ts +15 -0
- package/lib/index.js +117 -0
- package/lib/media/draft-tool.js +442 -0
- package/lib/media/draft-tool.js.bak-to-182027 +389 -0
- package/lib/media/media-cleaner.d.ts +19 -0
- package/lib/media/media-cleaner.d.ts.map +1 -0
- package/lib/media/media-cleaner.js +81 -0
- package/lib/media/media-cleaner.js.map +1 -0
- package/lib/media/say-tool.js +72 -0
- package/lib/media/send-file-tool.d.ts +12 -0
- package/lib/media/send-file-tool.d.ts.map +1 -0
- package/lib/media/send-file-tool.js +122 -0
- package/lib/media/send-file-tool.js.map +1 -0
- package/lib/media/send-media.d.ts +61 -0
- package/lib/media/send-media.d.ts.map +1 -0
- package/lib/media/send-media.js +104 -0
- package/lib/media/send-media.js.map +1 -0
- package/lib/media/vision-tool.d.ts +22 -0
- package/lib/media/vision-tool.d.ts.map +1 -0
- package/lib/media/vision-tool.js +288 -0
- package/lib/media/vision-tool.js.map +1 -0
- package/lib/middleware/attachment.d.ts +11 -0
- package/lib/middleware/attachment.d.ts.map +1 -0
- package/lib/middleware/attachment.js +30 -0
- package/lib/middleware/attachment.js.map +1 -0
- package/lib/middleware/question-answer.d.ts +10 -0
- package/lib/middleware/question-answer.d.ts.map +1 -0
- package/lib/middleware/question-answer.js +19 -0
- package/lib/middleware/question-answer.js.map +1 -0
- package/lib/model/index.d.ts +10 -0
- package/lib/model/index.d.ts.map +1 -0
- package/lib/model/index.js +9 -0
- package/lib/model/index.js.map +1 -0
- package/lib/model/model-resolver.d.ts +102 -0
- package/lib/model/model-resolver.d.ts.map +1 -0
- package/lib/model/model-resolver.js +206 -0
- package/lib/model/model-resolver.js.map +1 -0
- package/lib/model/prefs-store.d.ts +50 -0
- package/lib/model/prefs-store.d.ts.map +1 -0
- package/lib/model/prefs-store.js +215 -0
- package/lib/model/prefs-store.js.map +1 -0
- package/lib/model/settings-reader.d.ts +19 -0
- package/lib/model/settings-reader.d.ts.map +1 -0
- package/lib/model/settings-reader.js +76 -0
- package/lib/model/settings-reader.js.map +1 -0
- package/lib/model/types.d.ts +15 -0
- package/lib/model/types.d.ts.map +1 -0
- package/lib/model/types.js +5 -0
- package/lib/model/types.js.map +1 -0
- package/lib/resume-check.js +122 -0
- package/lib/resume-tool.js +29 -0
- package/lib/rules.js +57 -0
- package/lib/session/idle-evictor.d.ts +18 -0
- package/lib/session/idle-evictor.d.ts.map +1 -0
- package/lib/session/idle-evictor.js +31 -0
- package/lib/session/idle-evictor.js.map +1 -0
- package/lib/session/index.d.ts +9 -0
- package/lib/session/index.d.ts.map +1 -0
- package/lib/session/index.js +8 -0
- package/lib/session/index.js.map +1 -0
- package/lib/session/pick-agent.js +116 -0
- package/lib/session/session-id.d.ts +5 -0
- package/lib/session/session-id.d.ts.map +1 -0
- package/lib/session/session-id.js +15 -0
- package/lib/session/session-id.js.map +1 -0
- package/lib/session/session-manager.d.ts +138 -0
- package/lib/session/session-manager.d.ts.map +1 -0
- package/lib/session/session-manager.js +1157 -0
- package/lib/session/session-manager.js.bak-target +1081 -0
- package/lib/session/session-manager.js.bak-title-20261118 +1119 -0
- package/lib/session/session-manager.js.map +1 -0
- package/lib/session/types.d.ts +162 -0
- package/lib/session/types.d.ts.map +1 -0
- package/lib/session/types.js +2 -0
- package/lib/session/types.js.map +1 -0
- package/lib/setup/bind-routes.d.ts +78 -0
- package/lib/setup/bind-routes.d.ts.map +1 -0
- package/lib/setup/bind-routes.js +588 -0
- package/lib/setup/bind-routes.js.bak-join-163944 +761 -0
- package/lib/setup/bind-routes.js.map +1 -0
- package/lib/setup/binding-service.d.ts +86 -0
- package/lib/setup/binding-service.d.ts.map +1 -0
- package/lib/setup/binding-service.js +175 -0
- package/lib/setup/binding-service.js.map +1 -0
- package/lib/setup/index.d.ts +50 -0
- package/lib/setup/index.d.ts.map +1 -0
- package/lib/setup/index.js +163 -0
- package/lib/setup/index.js.map +1 -0
- package/lib/setup/persist.d.ts +42 -0
- package/lib/setup/persist.d.ts.map +1 -0
- package/lib/setup/persist.js +344 -0
- package/lib/setup/persist.js.map +1 -0
- package/lib/setup/presenters.d.ts +40 -0
- package/lib/setup/presenters.d.ts.map +1 -0
- package/lib/setup/presenters.js +84 -0
- package/lib/setup/presenters.js.map +1 -0
- package/lib/setup/qr-svg.d.ts +9 -0
- package/lib/setup/qr-svg.d.ts.map +1 -0
- package/lib/setup/qr-svg.js +33 -0
- package/lib/setup/qr-svg.js.map +1 -0
- package/lib/shared/bind-protocol.d.ts +42 -0
- package/lib/shared/bind-protocol.d.ts.map +1 -0
- package/lib/shared/bind-protocol.js +33 -0
- package/lib/shared/bind-protocol.js.map +1 -0
- package/lib/shared/dirs.d.ts +10 -0
- package/lib/shared/dirs.d.ts.map +1 -0
- package/lib/shared/dirs.js +20 -0
- package/lib/shared/dirs.js.map +1 -0
- package/lib/shared/http-body.js +43 -0
- package/lib/shared/index.d.ts +8 -0
- package/lib/shared/index.d.ts.map +1 -0
- package/lib/shared/index.js +8 -0
- package/lib/shared/index.js.map +1 -0
- package/lib/shared/json-file.js +34 -0
- package/lib/shared/orders.js +26 -0
- package/lib/shared/scope.d.ts +14 -0
- package/lib/shared/scope.d.ts.map +1 -0
- package/lib/shared/scope.js +12 -0
- package/lib/shared/scope.js.map +1 -0
- package/lib/shared/send-helper.d.ts +11 -0
- package/lib/shared/send-helper.d.ts.map +1 -0
- package/lib/shared/send-helper.js +13 -0
- package/lib/shared/send-helper.js.map +1 -0
- package/lib/shared/utils.d.ts +31 -0
- package/lib/shared/utils.d.ts.map +1 -0
- package/lib/shared/utils.js +228 -0
- package/lib/shared/utils.js.map +1 -0
- package/lib/tool-guard.js +74 -0
- package/lib/transport/attachment.d.ts +41 -0
- package/lib/transport/attachment.d.ts.map +1 -0
- package/lib/transport/attachment.js +191 -0
- package/lib/transport/attachment.js.map +1 -0
- package/lib/transport/chunker.d.ts +14 -0
- package/lib/transport/chunker.d.ts.map +1 -0
- package/lib/transport/chunker.js +78 -0
- package/lib/transport/chunker.js.map +1 -0
- package/lib/transport/deliverables.d.ts +20 -0
- package/lib/transport/deliverables.d.ts.map +1 -0
- package/lib/transport/deliverables.js +72 -0
- package/lib/transport/deliverables.js.map +1 -0
- package/lib/transport/events.d.ts +117 -0
- package/lib/transport/events.d.ts.map +1 -0
- package/lib/transport/events.js +112 -0
- package/lib/transport/events.js.map +1 -0
- package/lib/transport/inbound.d.ts +11 -0
- package/lib/transport/inbound.d.ts.map +1 -0
- package/lib/transport/inbound.js +511 -0
- package/lib/transport/inbound.js.map +1 -0
- package/lib/transport/index.d.ts +10 -0
- package/lib/transport/index.d.ts.map +1 -0
- package/lib/transport/index.js +10 -0
- package/lib/transport/index.js.map +1 -0
- package/lib/transport/msgid-cache.d.ts +23 -0
- package/lib/transport/msgid-cache.d.ts.map +1 -0
- package/lib/transport/msgid-cache.js +57 -0
- package/lib/transport/msgid-cache.js.map +1 -0
- package/lib/transport/notify.js +147 -0
- package/lib/transport/outbound-buffer.d.ts +42 -0
- package/lib/transport/outbound-buffer.d.ts.map +1 -0
- package/lib/transport/outbound-buffer.js +68 -0
- package/lib/transport/outbound-buffer.js.map +1 -0
- package/lib/transport/outbound.d.ts +42 -0
- package/lib/transport/outbound.d.ts.map +1 -0
- package/lib/transport/outbound.js +183 -0
- package/lib/transport/outbound.js.map +1 -0
- package/lib/transport/reply-limiter.d.ts +31 -0
- package/lib/transport/reply-limiter.d.ts.map +1 -0
- package/lib/transport/reply-limiter.js +50 -0
- package/lib/transport/reply-limiter.js.map +1 -0
- package/lib/transport/reply-target.d.ts +32 -0
- package/lib/transport/reply-target.d.ts.map +1 -0
- package/lib/transport/reply-target.js +64 -0
- package/lib/transport/reply-target.js.map +1 -0
- package/lib/transport/streaming-writer.d.ts +55 -0
- package/lib/transport/streaming-writer.d.ts.map +1 -0
- package/lib/transport/streaming-writer.js +122 -0
- package/lib/transport/streaming-writer.js.map +1 -0
- package/lib/transport/tool-presenter.d.ts +37 -0
- package/lib/transport/tool-presenter.d.ts.map +1 -0
- package/lib/transport/tool-presenter.js +116 -0
- package/lib/transport/tool-presenter.js.map +1 -0
- package/lib/turn-check.js +85 -0
- package/lib/types.d.ts +39 -0
- package/lib/types.js +5 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +127 -4
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 出站回复目标解析与发送 — 被动回复三级兜底 + msg_id/event_id 区分。
|
|
3
|
+
*
|
|
4
|
+
* 从 gateway 层抽离,保持 bootstrap 只做组装。三级兜底:
|
|
5
|
+
* 1. 优先显式 target.msgId;
|
|
6
|
+
* 2. 超频/过期后,用缓存里「最近一条未超频未过期」的 target;
|
|
7
|
+
* 3. 全部候选都超频/过期,才降级为主动推送(proactive)。
|
|
8
|
+
*/
|
|
9
|
+
import { MsgType } from '@tencent-connect/qqbot-nodejs';
|
|
10
|
+
import { getCachedReplyIds } from "./msgid-cache.js";
|
|
11
|
+
/**
|
|
12
|
+
* 解析被动回复目标。
|
|
13
|
+
*
|
|
14
|
+
* 显式 msgId 须经 cache 确认未超平台被动窗口(群 5min/私聊 30min),
|
|
15
|
+
* 否则跳过(延迟投递携带的旧 id 会被平台 40034005 拒绝)。
|
|
16
|
+
*
|
|
17
|
+
* @param allowEvent 是否允许返回互动事件 eventId。markdown 发送支持 event_id
|
|
18
|
+
* (bot.send 的 extra),传 true;文件发送 SDK 暂不支持 event_id,传 false
|
|
19
|
+
* 跳过 event 候选,降级为 msg 候选或主动推送。
|
|
20
|
+
*/
|
|
21
|
+
export function resolveReplyTarget(target, limiter, allowEvent) {
|
|
22
|
+
const cached = getCachedReplyIds(target.scope, target.targetId);
|
|
23
|
+
const explicitMsgId = target.msgId;
|
|
24
|
+
const candidates = [];
|
|
25
|
+
// 显式 id 在 cache TTL 内(未超平台被动窗口)才置顶优先,否则跳过
|
|
26
|
+
if (explicitMsgId !== undefined && cached.some((c) => c.id === explicitMsgId)) {
|
|
27
|
+
candidates.push({ kind: 'msg', id: explicitMsgId });
|
|
28
|
+
}
|
|
29
|
+
for (const c of cached) {
|
|
30
|
+
if (c.id === explicitMsgId)
|
|
31
|
+
continue; // undefined 时恒 false,安全
|
|
32
|
+
candidates.push(c);
|
|
33
|
+
}
|
|
34
|
+
for (const c of candidates) {
|
|
35
|
+
if (c.kind === 'event' && !allowEvent)
|
|
36
|
+
continue;
|
|
37
|
+
if (limiter.checkLimit(c.id).allowed) {
|
|
38
|
+
limiter.record(c.id);
|
|
39
|
+
if (c.kind === 'event') {
|
|
40
|
+
return { ...target, msgId: undefined, eventId: c.id };
|
|
41
|
+
}
|
|
42
|
+
return { ...target, msgId: c.id, eventId: undefined };
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
return { ...target, msgId: undefined, eventId: undefined };
|
|
46
|
+
}
|
|
47
|
+
/**
|
|
48
|
+
* 发送 markdown:区分 msg_id 与 event_id。
|
|
49
|
+
* 带 eventId 时通过 bot.send 的 extra 填 event_id(SDK sendMarkdown 不支持);
|
|
50
|
+
* 否则走 sendMarkdown 填 msg_id。
|
|
51
|
+
*/
|
|
52
|
+
export function sendResolvedMarkdown(bot, target, content, opts) {
|
|
53
|
+
if (target.eventId) {
|
|
54
|
+
return bot.send({
|
|
55
|
+
target: { scope: target.scope, targetId: target.targetId, msgId: undefined },
|
|
56
|
+
msgType: MsgType.MARKDOWN,
|
|
57
|
+
markdown: { content },
|
|
58
|
+
keyboard: opts?.keyboard,
|
|
59
|
+
extra: { event_id: target.eventId },
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
return bot.sendMarkdown(target, content, opts);
|
|
63
|
+
}
|
|
64
|
+
//# sourceMappingURL=reply-target.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reply-target.js","sourceRoot":"","sources":["../../src/transport/reply-target.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAS,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAG/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAIrD;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAmB,EACnB,OAAqB,EACrB,UAAmB;IAEnB,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChE,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC;IACnC,MAAM,UAAU,GAAoB,EAAE,CAAC;IACvC,0CAA0C;IAC1C,IAAI,aAAa,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,aAAa,CAAC,EAAE,CAAC;QAC9E,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,EAAE,KAAK,aAAa;YAAE,SAAS,CAAC,wBAAwB;QAC9D,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,UAAU;YAAE,SAAS;QAChD,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YACrC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACrB,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACvB,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YACxD,CAAC;YACD,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QACxD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAU,EACV,MAAmB,EACnB,OAAe,EACf,IAAoC;IAEpC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,GAAG,CAAC,IAAI,CAAC;YACd,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE;YAC5E,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,QAAQ,EAAE,EAAE,OAAO,EAAE;YACrB,QAAQ,EAAE,IAAI,EAAE,QAAQ;YACxB,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AACjD,CAAC"}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* StreamingWriter — QQ 流式文本写入器
|
|
3
|
+
*
|
|
4
|
+
* 边界条件设计:
|
|
5
|
+
* - 节流(throttle):固定间隔 flush,避免每 token 发 HTTP,同时保证长文本分多次推送
|
|
6
|
+
* - 串行队列(chain):保证 update 顺序,finish 前最后一次文本必达
|
|
7
|
+
* - 降级(sentChunkCount === 0):只有从未成功发送分片才降级静态,
|
|
8
|
+
* 避免"已流式部分 + 静态全量"的重复内容
|
|
9
|
+
* - 终态幂等(finished):finish/abort 后忽略 append,重复 finish 不重复 complete
|
|
10
|
+
* - 中止关闭(abort):abort 时若 session 已打开,串行 complete 关闭,避免悬挂
|
|
11
|
+
*/
|
|
12
|
+
import type { Logger, ReplyTarget } from '../types.ts';
|
|
13
|
+
import type { QQBotSender } from './outbound-buffer.ts';
|
|
14
|
+
export interface StreamingWriterDeps {
|
|
15
|
+
bot: QQBotSender;
|
|
16
|
+
target: ReplyTarget;
|
|
17
|
+
logger: Logger;
|
|
18
|
+
/** 节流间隔(ms):连续 append 累积后,停顿该间隔才 update */
|
|
19
|
+
throttleMs: number;
|
|
20
|
+
}
|
|
21
|
+
export declare class StreamingWriter {
|
|
22
|
+
private fullText;
|
|
23
|
+
private session;
|
|
24
|
+
private sentChunkCount;
|
|
25
|
+
private failed;
|
|
26
|
+
private finished;
|
|
27
|
+
private aborted;
|
|
28
|
+
private throttleTimer;
|
|
29
|
+
private chain;
|
|
30
|
+
private readonly deps;
|
|
31
|
+
constructor(deps: StreamingWriterDeps);
|
|
32
|
+
/** 是否应降级为静态发送:从未成功发送过任何分片 */
|
|
33
|
+
get shouldFallback(): boolean;
|
|
34
|
+
/** 累积全文(降级静态发送时使用) */
|
|
35
|
+
get text(): string;
|
|
36
|
+
/**
|
|
37
|
+
* 重置累积文本(LLM 重试的新 attempt)。
|
|
38
|
+
*
|
|
39
|
+
* 保留已打开的流式会话与 sentChunkCount:QQ 流式 update 是全量替换语义,
|
|
40
|
+
* 新 attempt 的增量会把同一条消息整体重写,用户不会看到两条消息;
|
|
41
|
+
* sentChunkCount 保留则防止重试后误判"从未发送"而降级静态造成重复。
|
|
42
|
+
*/
|
|
43
|
+
reset(): void;
|
|
44
|
+
/** 追加增量文本,节流(throttle)后 update 全量 */
|
|
45
|
+
append(delta: string): void;
|
|
46
|
+
/** 结束:flush 最终文本 + complete 收尾 */
|
|
47
|
+
finish(): Promise<void>;
|
|
48
|
+
/** 中止(异常/取消):关闭已打开的流式会话,避免悬挂 */
|
|
49
|
+
abort(): void;
|
|
50
|
+
/** 入队一次 update(串行,保证顺序) */
|
|
51
|
+
private enqueue;
|
|
52
|
+
/** 推送当前累积文本(首次 openStream + update 全量) */
|
|
53
|
+
private pushUpdate;
|
|
54
|
+
}
|
|
55
|
+
//# sourceMappingURL=streaming-writer.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"streaming-writer.d.ts","sourceRoot":"","sources":["../../src/transport/streaming-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,sBAAsB,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,WAAW,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,KAAK,CAAoC;IAEjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsB;gBAExB,IAAI,EAAE,mBAAmB;IAI5C,6BAA6B;IAC7B,IAAW,cAAc,IAAI,OAAO,CAEnC;IAED,sBAAsB;IACtB,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;;;;OAMG;IACI,KAAK,IAAI,IAAI;IAKpB,qCAAqC;IAC9B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAclC,kCAAkC;IACrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBpC,gCAAgC;IACzB,KAAK,IAAI,IAAI;IAwBpB,2BAA2B;IAC3B,OAAO,CAAC,OAAO;IAIf,0CAA0C;YAC5B,UAAU;CA2BzB"}
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
export class StreamingWriter {
|
|
2
|
+
fullText = '';
|
|
3
|
+
session = null;
|
|
4
|
+
sentChunkCount = 0;
|
|
5
|
+
failed = false;
|
|
6
|
+
finished = false;
|
|
7
|
+
aborted = false;
|
|
8
|
+
throttleTimer = null;
|
|
9
|
+
chain = Promise.resolve();
|
|
10
|
+
deps;
|
|
11
|
+
constructor(deps) {
|
|
12
|
+
this.deps = deps;
|
|
13
|
+
}
|
|
14
|
+
/** 是否应降级为静态发送:从未成功发送过任何分片 */
|
|
15
|
+
get shouldFallback() {
|
|
16
|
+
return this.sentChunkCount === 0;
|
|
17
|
+
}
|
|
18
|
+
/** 累积全文(降级静态发送时使用) */
|
|
19
|
+
get text() {
|
|
20
|
+
return this.fullText;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* 重置累积文本(LLM 重试的新 attempt)。
|
|
24
|
+
*
|
|
25
|
+
* 保留已打开的流式会话与 sentChunkCount:QQ 流式 update 是全量替换语义,
|
|
26
|
+
* 新 attempt 的增量会把同一条消息整体重写,用户不会看到两条消息;
|
|
27
|
+
* sentChunkCount 保留则防止重试后误判"从未发送"而降级静态造成重复。
|
|
28
|
+
*/
|
|
29
|
+
reset() {
|
|
30
|
+
if (this.finished)
|
|
31
|
+
return;
|
|
32
|
+
this.fullText = '';
|
|
33
|
+
}
|
|
34
|
+
/** 追加增量文本,节流(throttle)后 update 全量 */
|
|
35
|
+
append(delta) {
|
|
36
|
+
if (this.finished)
|
|
37
|
+
return;
|
|
38
|
+
this.fullText += delta;
|
|
39
|
+
// throttle:仅在无 pending timer 时启动,固定间隔 flush。
|
|
40
|
+
// 不用 debounce(否则 chunk 持续到达时永远憋着,流式退化成一次性全量发送)
|
|
41
|
+
if (this.throttleTimer === null) {
|
|
42
|
+
this.throttleTimer = setTimeout(() => {
|
|
43
|
+
this.throttleTimer = null;
|
|
44
|
+
this.enqueue();
|
|
45
|
+
}, this.deps.throttleMs);
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
/** 结束:flush 最终文本 + complete 收尾 */
|
|
49
|
+
async finish() {
|
|
50
|
+
if (this.finished)
|
|
51
|
+
return;
|
|
52
|
+
this.finished = true;
|
|
53
|
+
if (this.throttleTimer) {
|
|
54
|
+
clearTimeout(this.throttleTimer);
|
|
55
|
+
this.throttleTimer = null;
|
|
56
|
+
}
|
|
57
|
+
// 立即把最终累积文本入队(覆盖节流未触发的场景)
|
|
58
|
+
this.enqueue();
|
|
59
|
+
await this.chain;
|
|
60
|
+
// 只要 session 存在就 complete(关闭流式消息,无论是否降级)
|
|
61
|
+
if (this.session) {
|
|
62
|
+
try {
|
|
63
|
+
await this.session.complete();
|
|
64
|
+
}
|
|
65
|
+
catch (err) {
|
|
66
|
+
this.deps.logger.error(`im-qqbot: stream complete failed: ${err instanceof Error ? err.message : String(err)}`);
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
/** 中止(异常/取消):关闭已打开的流式会话,避免悬挂 */
|
|
71
|
+
abort() {
|
|
72
|
+
if (this.finished)
|
|
73
|
+
return;
|
|
74
|
+
this.finished = true;
|
|
75
|
+
this.aborted = true;
|
|
76
|
+
if (this.throttleTimer) {
|
|
77
|
+
clearTimeout(this.throttleTimer);
|
|
78
|
+
this.throttleTimer = null;
|
|
79
|
+
}
|
|
80
|
+
// 串行 complete(排在 pending update 之后),关闭已打开的流式会话
|
|
81
|
+
this.chain = this.chain.then(async () => {
|
|
82
|
+
if (this.session) {
|
|
83
|
+
try {
|
|
84
|
+
await this.session.complete();
|
|
85
|
+
}
|
|
86
|
+
catch (err) {
|
|
87
|
+
this.deps.logger.error(`im-qqbot: stream abort complete failed: ${err instanceof Error ? err.message : String(err)}`);
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
});
|
|
91
|
+
}
|
|
92
|
+
/** 入队一次 update(串行,保证顺序) */
|
|
93
|
+
enqueue() {
|
|
94
|
+
this.chain = this.chain.then(() => this.pushUpdate());
|
|
95
|
+
}
|
|
96
|
+
/** 推送当前累积文本(首次 openStream + update 全量) */
|
|
97
|
+
async pushUpdate() {
|
|
98
|
+
if (this.aborted || this.failed || !this.fullText)
|
|
99
|
+
return;
|
|
100
|
+
if (!this.session) {
|
|
101
|
+
try {
|
|
102
|
+
this.session = this.deps.bot.openStream(this.deps.target);
|
|
103
|
+
this.deps.logger.debug(`im-qqbot: stream opened (chars=${this.fullText.length})`);
|
|
104
|
+
}
|
|
105
|
+
catch (err) {
|
|
106
|
+
// openStream 失败:标记 failed 避免重复尝试,后续走降级静态
|
|
107
|
+
this.failed = true;
|
|
108
|
+
this.deps.logger.warn(`im-qqbot: openStream failed, fallback to static: ${err instanceof Error ? err.message : String(err)}`);
|
|
109
|
+
return;
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
try {
|
|
113
|
+
await this.session.update(this.fullText);
|
|
114
|
+
this.sentChunkCount++;
|
|
115
|
+
}
|
|
116
|
+
catch (err) {
|
|
117
|
+
// update 失败:不标记 failed(session 已打开,finish 会 complete 关闭)
|
|
118
|
+
this.deps.logger.warn(`im-qqbot: stream update failed: ${err instanceof Error ? err.message : String(err)}`);
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
//# sourceMappingURL=streaming-writer.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"streaming-writer.js","sourceRoot":"","sources":["../../src/transport/streaming-writer.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 工具调用结果 → Markdown 格式化
|
|
3
|
+
*
|
|
4
|
+
* 适配 QQ 消息通道:优先用工具自定义的 presentResult 视图,
|
|
5
|
+
* fallback 到 raw text。错误始终展示,成功结果按 config 开关。
|
|
6
|
+
*/
|
|
7
|
+
/** dsh-tools 主机平面注册表(presentResult 能力) */
|
|
8
|
+
export interface ToolsRegistryLike {
|
|
9
|
+
get(name: string, scope?: unknown): {
|
|
10
|
+
presentResult?(args: unknown, result: unknown): unknown;
|
|
11
|
+
} | undefined;
|
|
12
|
+
}
|
|
13
|
+
/** 工具结果事件数据(tool/result) */
|
|
14
|
+
export interface ToolResultData {
|
|
15
|
+
message: {
|
|
16
|
+
content: Array<{
|
|
17
|
+
type: string;
|
|
18
|
+
content?: unknown;
|
|
19
|
+
isError?: boolean;
|
|
20
|
+
}>;
|
|
21
|
+
source: {
|
|
22
|
+
callId: string;
|
|
23
|
+
};
|
|
24
|
+
};
|
|
25
|
+
error?: {
|
|
26
|
+
name: string;
|
|
27
|
+
code: string;
|
|
28
|
+
};
|
|
29
|
+
meta?: unknown;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* 将工具调用结果格式化为 Markdown 文本
|
|
33
|
+
*
|
|
34
|
+
* 返回 null 表示无需发送(无内容)。
|
|
35
|
+
*/
|
|
36
|
+
export declare function formatToolResult(name: string, rawArgs: string, data: ToolResultData, toolsRegistry: ToolsRegistryLike | undefined, agent: unknown): string | null;
|
|
37
|
+
//# sourceMappingURL=tool-presenter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tool-presenter.d.ts","sourceRoot":"","sources":["../../src/transport/tool-presenter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG;QAClC,aAAa,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;KACzD,GAAG,SAAS,CAAC;CACf;AAED,4BAA4B;AAC5B,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE;QACP,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAC;YAAC,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACvE,MAAM,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KAC5B,CAAC;IACF,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAWD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,EACpB,aAAa,EAAE,iBAAiB,GAAG,SAAS,EAC5C,KAAK,EAAE,OAAO,GACb,MAAM,GAAG,IAAI,CAmBf"}
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 工具调用结果 → Markdown 格式化
|
|
3
|
+
*
|
|
4
|
+
* 适配 QQ 消息通道:优先用工具自定义的 presentResult 视图,
|
|
5
|
+
* fallback 到 raw text。错误始终展示,成功结果按 config 开关。
|
|
6
|
+
*/
|
|
7
|
+
const RESULT_PREVIEW_LIMIT = 1500;
|
|
8
|
+
/**
|
|
9
|
+
* 将工具调用结果格式化为 Markdown 文本
|
|
10
|
+
*
|
|
11
|
+
* 返回 null 表示无需发送(无内容)。
|
|
12
|
+
*/
|
|
13
|
+
export function formatToolResult(name, rawArgs, data, toolsRegistry, agent) {
|
|
14
|
+
// 1. 错误优先:始终展示
|
|
15
|
+
if (data.error) {
|
|
16
|
+
return `❌ 工具 \`${name}\` 执行失败\n\`${data.error.name}: ${data.error.code}\``;
|
|
17
|
+
}
|
|
18
|
+
// 2. 尝试工具自定义视图(presentResult)
|
|
19
|
+
const view = presentResultView(name, rawArgs, data, toolsRegistry, agent);
|
|
20
|
+
if (view) {
|
|
21
|
+
const rendered = renderView(name, view);
|
|
22
|
+
if (rendered)
|
|
23
|
+
return rendered;
|
|
24
|
+
}
|
|
25
|
+
// 3. fallback raw text
|
|
26
|
+
const block = data.message.content[0];
|
|
27
|
+
const result = block !== undefined && block.type === 'tool-result' ? textOf(block.content) : '';
|
|
28
|
+
if (!result)
|
|
29
|
+
return null;
|
|
30
|
+
return `🔧 \`${name}\` 完成\n${truncate(result)}`;
|
|
31
|
+
}
|
|
32
|
+
/** 调用工具自定义 presentResult,失败/不可用时返回 undefined */
|
|
33
|
+
function presentResultView(name, rawArgs, data, toolsRegistry, agent) {
|
|
34
|
+
if (!toolsRegistry)
|
|
35
|
+
return undefined;
|
|
36
|
+
try {
|
|
37
|
+
const tool = toolsRegistry.get(name, agent);
|
|
38
|
+
if (tool?.presentResult === undefined)
|
|
39
|
+
return undefined;
|
|
40
|
+
const block = data.message.content[0];
|
|
41
|
+
const content = block !== undefined && block.type === 'tool-result' ? block.content : [];
|
|
42
|
+
return tool.presentResult(JSON.parse(rawArgs), {
|
|
43
|
+
content,
|
|
44
|
+
isError: block?.isError === true,
|
|
45
|
+
...(data.meta !== undefined ? { meta: data.meta } : {}),
|
|
46
|
+
});
|
|
47
|
+
}
|
|
48
|
+
catch {
|
|
49
|
+
return undefined;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
/** 将结构化视图渲染为 Markdown */
|
|
53
|
+
function renderView(name, view) {
|
|
54
|
+
const header = `🔧 \`${name}\` 完成`;
|
|
55
|
+
switch (view.card) {
|
|
56
|
+
case 'terminal': {
|
|
57
|
+
const output = (view.output ?? '').trimEnd();
|
|
58
|
+
if (!output)
|
|
59
|
+
return null;
|
|
60
|
+
const exit = view.exitCode !== undefined && view.exitCode !== 0 ? `\n退出码 ${view.exitCode}` : '';
|
|
61
|
+
return `${header}\n\`\`\`\n${output}\n\`\`\`${exit}`;
|
|
62
|
+
}
|
|
63
|
+
case 'diff': {
|
|
64
|
+
return `${header}\n\`\`\`diff\n${truncate(renderDiffs(view.diffs))}\n\`\`\``;
|
|
65
|
+
}
|
|
66
|
+
case 'read': {
|
|
67
|
+
const content = view.content ? textOf(view.content) : '';
|
|
68
|
+
if (!content)
|
|
69
|
+
return null;
|
|
70
|
+
const path = view.path ? ` (${view.path})` : '';
|
|
71
|
+
return `${header}${path}\n\`\`\`\n${truncate(content)}\n\`\`\``;
|
|
72
|
+
}
|
|
73
|
+
case 'generic':
|
|
74
|
+
default: {
|
|
75
|
+
const content = view.content ? textOf(view.content) : '';
|
|
76
|
+
if (!content)
|
|
77
|
+
return null;
|
|
78
|
+
return `${header}\n${truncate(content)}`;
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
/** 提取 content blocks 中的纯文本 */
|
|
83
|
+
function textOf(content) {
|
|
84
|
+
if (!Array.isArray(content))
|
|
85
|
+
return '';
|
|
86
|
+
return content
|
|
87
|
+
.map((b) => {
|
|
88
|
+
if (typeof b === 'object' && b !== null && b.type === 'text') {
|
|
89
|
+
return b.text ?? '';
|
|
90
|
+
}
|
|
91
|
+
return '';
|
|
92
|
+
})
|
|
93
|
+
.filter(Boolean)
|
|
94
|
+
.join('');
|
|
95
|
+
}
|
|
96
|
+
/** 渲染 diff hunks 为纯文本 */
|
|
97
|
+
function renderDiffs(diffs) {
|
|
98
|
+
return diffs
|
|
99
|
+
.map((d) => {
|
|
100
|
+
if (typeof d === 'object' && d !== null) {
|
|
101
|
+
const { path, hunks } = d;
|
|
102
|
+
const body = (hunks ?? []).map((h) => h.text ?? '').join('\n');
|
|
103
|
+
return path ? `--- ${path} ---\n${body}` : body;
|
|
104
|
+
}
|
|
105
|
+
return '';
|
|
106
|
+
})
|
|
107
|
+
.filter(Boolean)
|
|
108
|
+
.join('\n');
|
|
109
|
+
}
|
|
110
|
+
/** 截断长文本,避免刷屏 */
|
|
111
|
+
function truncate(text) {
|
|
112
|
+
if (text.length <= RESULT_PREVIEW_LIMIT)
|
|
113
|
+
return text;
|
|
114
|
+
return `${text.slice(0, RESULT_PREVIEW_LIMIT)}\n…(已截断)`;
|
|
115
|
+
}
|
|
116
|
+
//# sourceMappingURL=tool-presenter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tool-presenter.js","sourceRoot":"","sources":["../../src/transport/tool-presenter.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 回合结束的漏发检查。
|
|
3
|
+
*
|
|
4
|
+
* 为什么要有它:规则写进系统提示只是「提醒」,我可以忽略;真正能兜住的只有代码。
|
|
5
|
+
* 做法:每轮结束时看这一轮有没有真的调用过「发消息」类工具(qq_confirm send / qq_skip)。
|
|
6
|
+
* 没有就算一次漏发,记下来;下一轮的系统提示最上面会带着这条记录。
|
|
7
|
+
*/
|
|
8
|
+
import fs from 'node:fs';
|
|
9
|
+
import { join } from 'node:path';
|
|
10
|
+
import { PLUGIN_HOME } from './shared/dirs.js';
|
|
11
|
+
import { writeJsonAtomic } from './shared/json-file.js';
|
|
12
|
+
|
|
13
|
+
const STATE_FILE = join(PLUGIN_HOME, 'turn-check.json');
|
|
14
|
+
const MAX_KEEP = 50;
|
|
15
|
+
|
|
16
|
+
/** 本轮已经发过(内存态,进程重启就清空,不影响计数) */
|
|
17
|
+
const spoke = new Set();
|
|
18
|
+
|
|
19
|
+
function readState() {
|
|
20
|
+
try {
|
|
21
|
+
const raw = JSON.parse(fs.readFileSync(STATE_FILE, 'utf8'));
|
|
22
|
+
if (raw && typeof raw === 'object') {
|
|
23
|
+
return {
|
|
24
|
+
misses: Number(raw.misses) || 0,
|
|
25
|
+
lastMissAt: typeof raw.lastMissAt === 'string' ? raw.lastMissAt : '',
|
|
26
|
+
recent: Array.isArray(raw.recent) ? raw.recent.slice(-MAX_KEEP) : [],
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
} catch {
|
|
30
|
+
// 没有文件 / 文件坏了:从零开始,不抛
|
|
31
|
+
}
|
|
32
|
+
return { misses: 0, lastMissAt: '', recent: [] };
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
function writeState(state) {
|
|
36
|
+
try {
|
|
37
|
+
writeJsonAtomic(STATE_FILE, state);
|
|
38
|
+
} catch {
|
|
39
|
+
// 写不进去也不影响这一轮,下次还会再记
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** 这一轮说过话了:qq_confirm(send) 或 qq_skip */
|
|
44
|
+
export function markSpoke(sessionId) {
|
|
45
|
+
spoke.add(String(sessionId ?? 'default'));
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* 一轮结束:没说过话就记一笔。
|
|
50
|
+
* @returns {{missed: boolean, misses: number}}
|
|
51
|
+
*/
|
|
52
|
+
export function endTurn(sessionId) {
|
|
53
|
+
const key = String(sessionId ?? 'default');
|
|
54
|
+
const said = spoke.delete(key);
|
|
55
|
+
if (said) return { missed: false, misses: readState().misses };
|
|
56
|
+
const state = readState();
|
|
57
|
+
state.misses += 1;
|
|
58
|
+
state.lastMissAt = new Date().toISOString();
|
|
59
|
+
state.recent.push(state.lastMissAt);
|
|
60
|
+
if (state.recent.length > MAX_KEEP) state.recent = state.recent.slice(-MAX_KEEP);
|
|
61
|
+
writeState(state);
|
|
62
|
+
return { missed: true, misses: state.misses };
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/** 漏发提示只在「刚漏发」的 10 分钟内出现;过了就返回空,前缀保持逐字不变。 */
|
|
66
|
+
const MISS_WINDOW_MS = 10 * 60 * 1000;
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* 给系统提示用的一行。平时返回空字符串——这是有意为之:
|
|
70
|
+
* 文本里任何数字(次数、时间)一变,整段前缀就作废,缓存全白付。
|
|
71
|
+
* 所以只留下「刚漏了一次,这一轮别再漏」这一个语义,且 10 分钟后自动消失。
|
|
72
|
+
*/
|
|
73
|
+
export function turnCheckText() {
|
|
74
|
+
const state = readState();
|
|
75
|
+
if (!state.lastMissAt) return '';
|
|
76
|
+
const age = Date.now() - Date.parse(state.lastMissAt);
|
|
77
|
+
if (!Number.isFinite(age) || age > MISS_WINDOW_MS) return '';
|
|
78
|
+
return [
|
|
79
|
+
'',
|
|
80
|
+
'### 漏发检查(代码记的,不是提醒)',
|
|
81
|
+
'- 刚才有一轮整轮没发消息。这一轮只要有一句话是冲着对方说的,就先 qq_draft + qq_confirm;不想说话就 qq_skip。',
|
|
82
|
+
].join('\n');
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
export { STATE_FILE };
|
package/lib/types.d.ts
ADDED
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* dsh-im-qqbot 插件内部类型定义
|
|
3
|
+
*/
|
|
4
|
+
/** 会话作用域 */
|
|
5
|
+
export type ChatScope = 'c2c' | 'group';
|
|
6
|
+
/** QQ 回复目标 */
|
|
7
|
+
export interface ReplyTarget {
|
|
8
|
+
scope: ChatScope;
|
|
9
|
+
targetId: string;
|
|
10
|
+
msgId?: string;
|
|
11
|
+
/** 互动事件 id(带 INTERACTION_CREATE 前缀),填 event_id 字段,与 msgId 互斥 */
|
|
12
|
+
eventId?: string;
|
|
13
|
+
}
|
|
14
|
+
/** SDK 原始消息附件(snake_case 字段,来自 QQ 网关 C2C_MESSAGE_CREATE) */
|
|
15
|
+
export interface RawAttachment {
|
|
16
|
+
content_type: string;
|
|
17
|
+
filename: string;
|
|
18
|
+
size: number;
|
|
19
|
+
url: string;
|
|
20
|
+
asr_refer_text?: string;
|
|
21
|
+
width?: number;
|
|
22
|
+
height?: number;
|
|
23
|
+
[key: string]: unknown;
|
|
24
|
+
}
|
|
25
|
+
/** 引用消息附件(quoteRef 中间件解析的 camelCase 视图) */
|
|
26
|
+
export interface QuotedAttachment {
|
|
27
|
+
contentType?: string;
|
|
28
|
+
url?: string;
|
|
29
|
+
filename?: string;
|
|
30
|
+
asrText?: string;
|
|
31
|
+
}
|
|
32
|
+
/** 插件 Logger 接口 */
|
|
33
|
+
export interface Logger {
|
|
34
|
+
info(msg: string, ...args: unknown[]): void;
|
|
35
|
+
warn(msg: string, ...args: unknown[]): void;
|
|
36
|
+
error(msg: string, ...args: unknown[]): void;
|
|
37
|
+
debug(msg: string, ...args: unknown[]): void;
|
|
38
|
+
}
|
|
39
|
+
//# sourceMappingURL=types.d.ts.map
|
package/lib/types.js
ADDED
package/locale/en.json
ADDED