@tencent-connect/dsh-qqbot 0.1.0 → 0.3.0

package/dist/transport/streaming-writer.d.ts

@@ -0,0 +1,47 @@
+/**
+ * StreamingWriter — QQ 流式文本写入器
+ *
+ * 边界条件设计：
+ *   - 节流（throttle）：固定间隔 flush，避免每 token 发 HTTP，同时保证长文本分多次推送
+ *   - 串行队列（chain）：保证 update 顺序，finish 前最后一次文本必达
+ *   - 降级（sentChunkCount === 0）：只有从未成功发送分片才降级静态，
+ *     避免"已流式部分 + 静态全量"的重复内容
+ *   - 终态幂等（finished）：finish/abort 后忽略 append，重复 finish 不重复 complete
+ *   - 中止关闭（abort）：abort 时若 session 已打开，串行 complete 关闭，避免悬挂
+ */
+import type { Logger, ReplyTarget } from '../types.js';
+import type { QQBotSender } from './outbound-buffer.js';
+export interface StreamingWriterDeps {
+    bot: QQBotSender;
+    target: ReplyTarget;
+    logger: Logger;
+    /** 节流间隔（ms）：连续 append 累积后，停顿该间隔才 update */
+    throttleMs: number;
+}
+export declare class StreamingWriter {
+    private readonly deps;
+    private fullText;
+    private session;
+    private sentChunkCount;
+    private failed;
+    private finished;
+    private aborted;
+    private throttleTimer;
+    private chain;
+    constructor(deps: StreamingWriterDeps);
+    /** 是否应降级为静态发送：从未成功发送过任何分片 */
+    get shouldFallback(): boolean;
+    /** 累积全文（降级静态发送时使用） */
+    get text(): string;
+    /** 追加增量文本，节流（throttle）后 update 全量 */
+    append(delta: string): void;
+    /** 结束：flush 最终文本 + complete 收尾 */
+    finish(): Promise<void>;
+    /** 中止（异常/取消）：关闭已打开的流式会话，避免悬挂 */
+    abort(): void;
+    /** 入队一次 update（串行，保证顺序） */
+    private enqueue;
+    /** 推送当前累积文本（首次 openStream + update 全量） */
+    private pushUpdate;
+}
+//# sourceMappingURL=streaming-writer.d.ts.map

package/dist/transport/streaming-writer.d.ts.map

@@ -0,0 +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;IAUP,OAAO,CAAC,QAAQ,CAAC,IAAI;IATxC,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;gBAEb,IAAI,EAAE,mBAAmB;IAE7D,6BAA6B;IAC7B,IAAW,cAAc,IAAI,OAAO,CAEnC;IAED,sBAAsB;IACtB,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,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"}

package/dist/transport/streaming-writer.js

@@ -0,0 +1,110 @@
+export class StreamingWriter {
+    deps;
+    fullText = '';
+    session = null;
+    sentChunkCount = 0;
+    failed = false;
+    finished = false;
+    aborted = false;
+    throttleTimer = null;
+    chain = Promise.resolve();
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** 是否应降级为静态发送：从未成功发送过任何分片 */
+    get shouldFallback() {
+        return this.sentChunkCount === 0;
+    }
+    /** 累积全文（降级静态发送时使用） */
+    get text() {
+        return this.fullText;
+    }
+    /** 追加增量文本，节流（throttle）后 update 全量 */
+    append(delta) {
+        if (this.finished)
+            return;
+        this.fullText += delta;
+        // throttle：仅在无 pending timer 时启动，固定间隔 flush。
+        // 不用 debounce（否则 chunk 持续到达时永远憋着，流式退化成一次性全量发送）
+        if (this.throttleTimer === null) {
+            this.throttleTimer = setTimeout(() => {
+                this.throttleTimer = null;
+                this.enqueue();
+            }, this.deps.throttleMs);
+        }
+    }
+    /** 结束：flush 最终文本 + complete 收尾 */
+    async finish() {
+        if (this.finished)
+            return;
+        this.finished = true;
+        if (this.throttleTimer) {
+            clearTimeout(this.throttleTimer);
+            this.throttleTimer = null;
+        }
+        // 立即把最终累积文本入队（覆盖节流未触发的场景）
+        this.enqueue();
+        await this.chain;
+        // 只要 session 存在就 complete（关闭流式消息，无论是否降级）
+        if (this.session) {
+            try {
+                await this.session.complete();
+            }
+            catch (err) {
+                this.deps.logger.error(`im-qqbot: stream complete failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    /** 中止（异常/取消）：关闭已打开的流式会话，避免悬挂 */
+    abort() {
+        if (this.finished)
+            return;
+        this.finished = true;
+        this.aborted = true;
+        if (this.throttleTimer) {
+            clearTimeout(this.throttleTimer);
+            this.throttleTimer = null;
+        }
+        // 串行 complete（排在 pending update 之后），关闭已打开的流式会话
+        this.chain = this.chain.then(async () => {
+            if (this.session) {
+                try {
+                    await this.session.complete();
+                }
+                catch (err) {
+                    this.deps.logger.error(`im-qqbot: stream abort complete failed: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        });
+    }
+    /** 入队一次 update（串行，保证顺序） */
+    enqueue() {
+        this.chain = this.chain.then(() => this.pushUpdate());
+    }
+    /** 推送当前累积文本（首次 openStream + update 全量） */
+    async pushUpdate() {
+        if (this.aborted || this.failed || !this.fullText)
+            return;
+        if (!this.session) {
+            try {
+                this.session = this.deps.bot.openStream(this.deps.target);
+                this.deps.logger.debug(`im-qqbot: stream opened (chars=${this.fullText.length})`);
+            }
+            catch (err) {
+                // openStream 失败：标记 failed 避免重复尝试，后续走降级静态
+                this.failed = true;
+                this.deps.logger.warn(`im-qqbot: openStream failed, fallback to static: ${err instanceof Error ? err.message : String(err)}`);
+                return;
+            }
+        }
+        try {
+            await this.session.update(this.fullText);
+            this.sentChunkCount++;
+        }
+        catch (err) {
+            // update 失败：不标记 failed（session 已打开，finish 会 complete 关闭）
+            this.deps.logger.warn(`im-qqbot: stream update failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+//# sourceMappingURL=streaming-writer.js.map

package/dist/transport/streaming-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-writer.js","sourceRoot":"","sources":["../../src/transport/streaming-writer.ts"],"names":[],"mappings":"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"}

package/dist/transport/tool-presenter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 工具调用结果 → Markdown 格式化
+ *
+ * 参考 dsh-TUI 的 presentResult 机制（channel.ts presentResultView），
+ * 适配 QQ 消息通道：优先用工具自定义的 presentResult 视图，
+ * fallback 到 raw text。错误始终展示，成功结果按 config 开关。
+ */
+/** dsh-tools 主机平面注册表（presentResult 能力） */
+export interface ToolsRegistryLike {
+    get(name: string, scope?: unknown): {
+        presentResult?(args: unknown, result: unknown): unknown;
+    } | undefined;
+}
+/** 工具结果事件数据（tool/result） */
+export interface ToolResultData {
+    message: {
+        content: Array<{
+            type: string;
+            content?: unknown;
+            isError?: boolean;
+        }>;
+        source: {
+            callId: string;
+        };
+    };
+    error?: {
+        name: string;
+        code: string;
+    };
+    meta?: unknown;
+}
+/**
+ * 将工具调用结果格式化为 Markdown 文本
+ *
+ * 返回 null 表示无需发送（无内容）。
+ */
+export declare function formatToolResult(name: string, rawArgs: string, data: ToolResultData, toolsRegistry: ToolsRegistryLike | undefined, agent: unknown): string | null;
+//# sourceMappingURL=tool-presenter.d.ts.map

package/dist/transport/tool-presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-presenter.d.ts","sourceRoot":"","sources":["../../src/transport/tool-presenter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;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"}

package/dist/transport/tool-presenter.js

@@ -0,0 +1,117 @@
+/**
+ * 工具调用结果 → Markdown 格式化
+ *
+ * 参考 dsh-TUI 的 presentResult 机制（channel.ts presentResultView），
+ * 适配 QQ 消息通道：优先用工具自定义的 presentResult 视图，
+ * fallback 到 raw text。错误始终展示，成功结果按 config 开关。
+ */
+const RESULT_PREVIEW_LIMIT = 1500;
+/**
+ * 将工具调用结果格式化为 Markdown 文本
+ *
+ * 返回 null 表示无需发送（无内容）。
+ */
+export function formatToolResult(name, rawArgs, data, toolsRegistry, agent) {
+    // 1. 错误优先：始终展示
+    if (data.error) {
+        return `❌ 工具 \`${name}\` 执行失败\n\`${data.error.name}: ${data.error.code}\``;
+    }
+    // 2. 尝试工具自定义视图（presentResult）
+    const view = presentResultView(name, rawArgs, data, toolsRegistry, agent);
+    if (view) {
+        const rendered = renderView(name, view);
+        if (rendered)
+            return rendered;
+    }
+    // 3. fallback raw text
+    const block = data.message.content[0];
+    const result = block !== undefined && block.type === 'tool-result' ? textOf(block.content) : '';
+    if (!result)
+        return null;
+    return `🔧 \`${name}\` 完成\n${truncate(result)}`;
+}
+/** 调用工具自定义 presentResult，失败/不可用时返回 undefined */
+function presentResultView(name, rawArgs, data, toolsRegistry, agent) {
+    if (!toolsRegistry)
+        return undefined;
+    try {
+        const tool = toolsRegistry.get(name, agent);
+        if (tool?.presentResult === undefined)
+            return undefined;
+        const block = data.message.content[0];
+        const content = block !== undefined && block.type === 'tool-result' ? block.content : [];
+        return tool.presentResult(JSON.parse(rawArgs), {
+            content,
+            isError: block?.isError === true,
+            ...(data.meta !== undefined ? { meta: data.meta } : {}),
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 将结构化视图渲染为 Markdown */
+function renderView(name, view) {
+    const header = `🔧 \`${name}\` 完成`;
+    switch (view.card) {
+        case 'terminal': {
+            const output = (view.output ?? '').trimEnd();
+            if (!output)
+                return null;
+            const exit = view.exitCode !== undefined && view.exitCode !== 0 ? `\n退出码 ${view.exitCode}` : '';
+            return `${header}\n\`\`\`\n${output}\n\`\`\`${exit}`;
+        }
+        case 'diff': {
+            return `${header}\n\`\`\`diff\n${truncate(renderDiffs(view.diffs))}\n\`\`\``;
+        }
+        case 'read': {
+            const content = view.content ? textOf(view.content) : '';
+            if (!content)
+                return null;
+            const path = view.path ? ` (${view.path})` : '';
+            return `${header}${path}\n\`\`\`\n${truncate(content)}\n\`\`\``;
+        }
+        case 'generic':
+        default: {
+            const content = view.content ? textOf(view.content) : '';
+            if (!content)
+                return null;
+            return `${header}\n${truncate(content)}`;
+        }
+    }
+}
+/** 提取 content blocks 中的纯文本 */
+function textOf(content) {
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .map((b) => {
+        if (typeof b === 'object' && b !== null && b.type === 'text') {
+            return b.text ?? '';
+        }
+        return '';
+    })
+        .filter(Boolean)
+        .join('');
+}
+/** 渲染 diff hunks 为纯文本 */
+function renderDiffs(diffs) {
+    return diffs
+        .map((d) => {
+        if (typeof d === 'object' && d !== null) {
+            const { path, hunks } = d;
+            const body = (hunks ?? []).map((h) => h.text ?? '').join('\n');
+            return path ? `--- ${path} ---\n${body}` : body;
+        }
+        return '';
+    })
+        .filter(Boolean)
+        .join('\n');
+}
+/** 截断长文本，避免刷屏 */
+function truncate(text) {
+    if (text.length <= RESULT_PREVIEW_LIMIT)
+        return text;
+    return `${text.slice(0, RESULT_PREVIEW_LIMIT)}\n…（已截断）`;
+}
+//# sourceMappingURL=tool-presenter.js.map

package/dist/transport/tool-presenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-presenter.js","sourceRoot":"","sources":["../../src/transport/tool-presenter.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -24,6 +24,17 @@ export interface QQAttachment {
     url?: string;
     size?: number;
 }
+/** SDK 原始消息附件（snake_case 字段，来自 QQ 网关 C2C_MESSAGE_CREATE） */
+export interface RawAttachment {
+    content_type: string;
+    filename: string;
+    size: number;
+    url: string;
+    asr_refer_text?: string;
+    width?: number;
+    height?: number;
+    [key: string]: unknown;
+}
 /** 插件 Logger 接口 */
 export interface Logger {
     info(msg: string, ...args: unknown[]): void;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY;AACZ,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;AAExC,cAAc;AACd,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kBAAkB;AAClB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC;CAC9B;AAED,YAAY;AACZ,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,mBAAmB;AACnB,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC9C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY;AACZ,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;AAExC,cAAc;AACd,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kBAAkB;AAClB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC;CAC9B;AAED,YAAY;AACZ,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,mBAAmB;AACnB,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC9C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencent-connect/dsh-qqbot",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "QQ Bot IM channel plugin for deepseek-harness (dsh)",
   "type": "module",
   "main": "./dist/index.js",
@@ -16,6 +16,7 @@
     "dev": "tsc --watch",
     "prepublishOnly": "npm run build",
     "lint": "eslint src/",
+    "test": "vitest run",
     "clean": "rm -rf dist",
     "ci:prepare-test-pkg": "node scripts/prepare-test-pkg.js"
   },
@@ -38,12 +39,12 @@
     "js-yaml": "^4.1.0"
   },
   "peerDependencies": {
-    "@tencent-connect/qqbot-connector": "1.2.0",
     "@deepseek-ai/cordis": ">=4.0.1",
     "@deepseek-ai/dsh-agent": ">=0.1.0-rc.6",
     "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6",
     "@deepseek-ai/dsh-session": ">=0.1.0-rc.6",
-    "@deepseek-ai/schemastery": ">=3.18.1"
+    "@deepseek-ai/schemastery": ">=3.18.1",
+    "@tencent-connect/qqbot-connector": "1.2.0"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
@@ -70,6 +71,7 @@
     "@deepseek-ai/schemastery": "3.18.1",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^26.2.0",
-    "typescript": "^5.5.0"
+    "typescript": "^5.5.0",
+    "vitest": "^4.1.8"
   }
 }