@tencent-connect/dsh-qqbot 0.1.0

package/dist/transport/outbound-buffer.js

@@ -0,0 +1,65 @@
+import { chunkMarkdownText } from './chunker.js';
+export class OutboundBuffer {
+    record;
+    bot;
+    limit;
+    logger;
+    buffer = '';
+    timer = null;
+    flushing = false;
+    constructor(record, bot, limit, logger) {
+        this.record = record;
+        this.bot = bot;
+        this.limit = limit;
+        this.logger = logger;
+    }
+    /** 追加文本增量 */
+    append(text) {
+        this.buffer += text;
+    }
+    /** 获取当前累积文本 */
+    get text() {
+        return this.buffer;
+    }
+    /** 安排延迟发送（debounce） */
+    scheduleSend(delayMs) {
+        if (this.timer)
+            return;
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            void this.flush();
+        }, delayMs);
+    }
+    /** 立即发送所有累积文本 */
+    async flush() {
+        if (this.flushing || !this.buffer.trim())
+            return;
+        this.flushing = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        try {
+            const chunks = chunkMarkdownText(this.buffer, this.limit);
+            for (const chunk of chunks) {
+                await this.bot.sendMarkdown(this.record.replyTarget, chunk);
+            }
+        }
+        catch (err) {
+            this.logger.error(`im-qqbot: sendMarkdown failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            this.buffer = '';
+            this.flushing = false;
+        }
+    }
+    /** 取消未发送的定时器 */
+    cancel() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.buffer = '';
+    }
+}
+//# sourceMappingURL=outbound-buffer.js.map

package/dist/transport/outbound-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound-buffer.js","sourceRoot":"","sources":["../../src/transport/outbound-buffer.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAOjD,MAAM,OAAO,cAAc;IAMN;IACA;IACA;IACA;IARX,MAAM,GAAG,EAAE,CAAC;IACZ,KAAK,GAAyC,IAAI,CAAC;IACnD,QAAQ,GAAG,KAAK,CAAC;IAEzB,YACmB,MAAqB,EACrB,GAAgB,EAChB,KAAa,EACb,MAAc;QAHd,WAAM,GAAN,MAAM,CAAe;QACrB,QAAG,GAAH,GAAG,CAAa;QAChB,UAAK,GAAL,KAAK,CAAQ;QACb,WAAM,GAAN,MAAM,CAAQ;IAC9B,CAAC;IAEJ,aAAa;IACb,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;IACtB,CAAC;IAED,eAAe;IACf,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,uBAAuB;IACvB,YAAY,CAAC,OAAe;QAC1B,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;IAED,iBAAiB;IACjB,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,OAAO;QACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1G,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;YACjB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF"}

package/dist/transport/outbound.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 出站处理器 — dsh session/event → QQ 消息发送
+ */
+import type { SessionManager } from '../session/index.js';
+import type { ImQQBotConfig } from '../config.js';
+import type { Logger } from '../types.js';
+import { type QQBotSender } from './outbound-buffer.js';
+export type { QQBotSender } from './outbound-buffer.js';
+/** dsh SessionEvent 简化类型 */
+export interface SessionEvent {
+    type: string;
+    data: Record<string, unknown>;
+}
+/** dsh Session 简化类型 */
+export interface SessionLike {
+    header: {
+        id: string;
+    };
+}
+/**
+ * 创建出站事件处理器
+ *
+ * 返回一个 handler 函数，应注册到 ctx.on('session/event', handler)
+ */
+export declare function createOutboundHandler(manager: SessionManager, bot: QQBotSender, config: ImQQBotConfig, logger: Logger): (session: SessionLike, event: SessionEvent) => void;
+//# sourceMappingURL=outbound.d.ts.map

package/dist/transport/outbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../../src/transport/outbound.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,4BAA4B;AAC5B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,uBAAuB;AACvB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,KAAK,IAAI,CA0BrD"}

package/dist/transport/outbound.js

@@ -0,0 +1,92 @@
+import { chunkMarkdownText } from './chunker.js';
+import { OutboundBuffer } from './outbound-buffer.js';
+/**
+ * 创建出站事件处理器
+ *
+ * 返回一个 handler 函数，应注册到 ctx.on('session/event', handler)
+ */
+export function createOutboundHandler(manager, bot, config, logger) {
+    const buffers = new Map();
+    const limit = config.textChunkLimit;
+    return (session, event) => {
+        const sessionId = session.header.id;
+        const record = manager.findBySessionId(sessionId);
+        if (!record)
+            return;
+        switch (event.type) {
+            case 'assistant/chunk': {
+                handleChunk(sessionId, record, event, buffers, bot, limit, logger);
+                break;
+            }
+            case 'assistant/message': {
+                handleMessage(sessionId, record, event, buffers, bot, limit, logger);
+                break;
+            }
+            case 'turn/end': {
+                handleTurnEnd(sessionId, buffers, logger);
+                break;
+            }
+        }
+    };
+}
+/** 处理流式文本增量 */
+function handleChunk(sessionId, record, event, buffers, bot, limit, logger) {
+    const chunk = event.data.chunk;
+    if (!chunk || chunk.type !== 'text-delta' || !chunk.text)
+        return;
+    let buffer = buffers.get(sessionId);
+    if (!buffer) {
+        buffer = new OutboundBuffer(record, bot, limit, logger);
+        buffers.set(sessionId, buffer);
+    }
+    buffer.append(chunk.text);
+}
+/** 处理完整 assistant 消息 */
+function handleMessage(sessionId, record, event, buffers, bot, limit, logger) {
+    const buffer = buffers.get(sessionId);
+    if (buffer && buffer.text.trim()) {
+        void buffer.flush();
+        buffers.delete(sessionId);
+        return;
+    }
+    const message = event.data;
+    const blocks = message?.message?.content;
+    if (!blocks || !Array.isArray(blocks))
+        return;
+    const textParts = [];
+    for (const block of blocks) {
+        if (block.type === 'text' && block.text) {
+            textParts.push(block.text);
+        }
+    }
+    const fullText = textParts.join('\n');
+    if (!fullText.trim())
+        return;
+    const chunks = chunkMarkdownText(fullText, limit);
+    void (async () => {
+        for (const chunk of chunks) {
+            try {
+                await bot.sendMarkdown(record.replyTarget, chunk);
+            }
+            catch (err) {
+                logger.error(`im-qqbot: sendMarkdown failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    })();
+    buffers.delete(sessionId);
+}
+/** 处理轮次结束，清理 buffer */
+function handleTurnEnd(sessionId, buffers, logger) {
+    const buffer = buffers.get(sessionId);
+    if (buffer) {
+        if (buffer.text.trim()) {
+            void buffer.flush();
+        }
+        else {
+            buffer.cancel();
+        }
+        buffers.delete(sessionId);
+    }
+    logger.debug(`im-qqbot: turn/end sessionId=${sessionId}`);
+}
+//# sourceMappingURL=outbound.js.map

package/dist/transport/outbound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbound.js","sourceRoot":"","sources":["../../src/transport/outbound.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,cAAc,EAAoB,MAAM,sBAAsB,CAAC;AAexE;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAuB,EACvB,GAAgB,EAChB,MAAqB,EACrB,MAAc;IAEd,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC;IAEpC,OAAO,CAAC,OAAoB,EAAE,KAAmB,EAAE,EAAE;QACnD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;gBACnE,MAAM;YACR,CAAC;YAED,KAAK,mBAAmB,CAAC,CAAC,CAAC;gBACzB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;gBACrE,MAAM;YACR,CAAC;YAED,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC1C,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,eAAe;AACf,SAAS,WAAW,CAClB,SAAiB,EACjB,MAAqB,EACrB,KAAmB,EACnB,OAAoC,EACpC,GAAgB,EAChB,KAAa,EACb,MAAc;IAEd,MAAM,KAAK,GAAI,KAAK,CAAC,IAAqD,CAAC,KAAK,CAAC;IACjF,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,KAAK,CAAC,IAAI;QAAE,OAAO;IAEjE,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,wBAAwB;AACxB,SAAS,aAAa,CACpB,SAAiB,EACjB,MAAqB,EACrB,KAAmB,EACnB,OAAoC,EACpC,GAAgB,EAChB,KAAa,EACb,MAAc;IAEd,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAA0E,CAAC;IACjG,MAAM,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IACzC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO;IAE9C,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACxC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO;IAE7B,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClD,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrG,CAAC;QACH,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;AAC5B,CAAC;AAED,uBAAuB;AACvB,SAAS,aAAa,CACpB,SAAiB,EACjB,OAAoC,EACpC,MAAc;IAEd,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,gCAAgC,SAAS,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * dsh-im-qqbot 插件内部类型定义
+ */
+/** 会话作用域 */
+export type ChatScope = 'c2c' | 'group';
+/** QQ 回复目标 */
+export interface ReplyTarget {
+    scope: ChatScope;
+    targetId: string;
+    msgId?: string;
+}
+/** QQ 入站消息（简化） */
+export interface QQInboundMessage {
+    content?: string;
+    senderId: string;
+    groupOpenid?: string;
+    replyTarget: ReplyTarget;
+    attachments?: QQAttachment[];
+}
+/** QQ 附件 */
+export interface QQAttachment {
+    contentType: string;
+    filename?: string;
+    url?: string;
+    size?: number;
+}
+/** 插件 Logger 接口 */
+export interface Logger {
+    info(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+    error(msg: string, ...args: unknown[]): void;
+    debug(msg: string, ...args: unknown[]): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +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"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * dsh-im-qqbot 插件内部类型定义
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/install.sh

@@ -0,0 +1,108 @@
+#!/bin/sh
+# @tencent-connect/dsh-qqbot 一键安装
+#
+# 走 dsh CLI 的 profile 插件机制：`add` 自动初始化 profile（首层
+# dsh-base），pnpm 安装后按 dsh.bundle.patch 元数据把本包追加为 bundle 层。
+# 无需 DSH 源码，无需 workspace 链接。
+#
+# 用法：
+#   sh install.sh                                            # 安装默认包最新版本
+#   sh install.sh --version 0.2.0                            # 指定版本
+#   sh install.sh --pkg @myorg/my-plugin                     # 指定包名
+#   sh install.sh --pkg @myorg/my-plugin --version 1.0.0     # 指定包名+版本
+#   sh install.sh --registry https://registry.npmmirror.com  # 指定 npm registry
+set -eu
+
+# ── 默认值 ──
+PACKAGE="@tencent-connect/dsh-qqbot"
+VERSION=""
+REGISTRY=""
+PROFILE="qqbot"
+
+# ── 参数解析 ──
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --pkg)
+      shift; PACKAGE="$1" ;;
+    --pkg=*)
+      PACKAGE="${1#--pkg=}" ;;
+    --version)
+      shift; VERSION="$1" ;;
+    --version=*)
+      VERSION="${1#--version=}" ;;
+    --registry)
+      shift; REGISTRY="$1" ;;
+    --registry=*)
+      REGISTRY="${1#--registry=}" ;;
+    --profile)
+      shift; PROFILE="$1" ;;
+    --profile=*)
+      PROFILE="${1#--profile=}" ;;
+    -h|--help)
+      echo "用法: sh install.sh [选项]"
+      echo
+      echo "选项:"
+      echo "  --pkg <name>        指定 npm 包名 (默认: @tencent-connect/dsh-qqbot)"
+      echo "  --version <ver>     指定包版本 (默认: latest)"
+      echo "  --registry <url>    指定 npm registry"
+      echo "  --profile <name>    指定 dsh profile 名 (默认: qqbot)"
+      echo "  -h, --help          显示帮助"
+      exit 0
+      ;;
+    *)
+      echo "未知参数: $1 (使用 --help 查看用法)" >&2
+      exit 1
+      ;;
+  esac
+  shift
+done
+
+# ── 预检 ──
+if ! command -v dsh >/dev/null 2>&1; then
+  echo "未检测到 dsh CLI。先安装：" >&2
+  echo "  npm install -g @deepseek-ai/dsh" >&2
+  exit 1
+fi
+
+if ! command -v pnpm >/dev/null 2>&1; then
+  echo "未检测到 pnpm。dsh plugin 依赖 pnpm，请先安装：" >&2
+  echo "  npm install -g pnpm" >&2
+  exit 1
+fi
+
+# ── 构造安装标识 ──
+INSTALL_SPEC="$PACKAGE"
+if [ -n "$VERSION" ]; then
+  INSTALL_SPEC="${PACKAGE}@${VERSION}"
+fi
+
+REGISTRY_ARG=""
+if [ -n "$REGISTRY" ]; then
+  REGISTRY_ARG="--registry ${REGISTRY}"
+fi
+
+# ── 安装 ──
+echo "=================================================="
+echo "  安装 QQ Bot 插件到 dsh"
+echo "=================================================="
+echo
+echo "  包名:     ${INSTALL_SPEC}"
+echo "  Profile:  ${PROFILE}"
+[ -n "$REGISTRY" ] && echo "  Registry: ${REGISTRY}"
+echo
+
+dsh plugin --profile "$PROFILE" add "$INSTALL_SPEC" $REGISTRY_ARG
+
+echo
+echo "=================================================="
+echo "  安装完成"
+echo "=================================================="
+echo
+echo "配置环境变量："
+echo "  export QQBOT_APPID=\"你的AppID\""
+echo "  export QQBOT_SECRET=\"你的AppSecret\""
+echo "  export DEEPSEEK_API_KEY=\"你的API Key\""
+echo
+echo "启动："
+echo "  dsh --profile ${PROFILE}"
+echo

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@tencent-connect/dsh-qqbot",
+  "version": "0.1.0",
+  "description": "QQ Bot IM channel plugin for deepseek-harness (dsh)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist",
+    "ci:prepare-test-pkg": "node scripts/prepare-test-pkg.js"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "qqbot",
+    "cordis",
+    "plugin"
+  ],
+  "license": "MIT",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@tencent-connect/qqbot-connector": "1.2.0",
+    "@tencent-connect/qqbot-nodejs": "^1.0.4",
+    "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"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": false
+    },
+    "@deepseek-ai/schemastery": {
+      "optional": false
+    },
+    "@deepseek-ai/dsh-agent": {
+      "optional": false
+    },
+    "@deepseek-ai/dsh-session": {
+      "optional": false
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@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",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^26.2.0",
+    "typescript": "^5.5.0"
+  }
+}

package/pnpm-workspace.yaml

@@ -0,0 +1,16 @@
+allowBuilds:
+  esbuild: true
+minimumReleaseAgeExclude:
+  - '@deepseek-ai/cordis@4.0.1'
+  - '@deepseek-ai/cosmokit@1.8.2'
+  - '@deepseek-ai/dsh-agent@0.1.0-rc.6'
+  - '@deepseek-ai/dsh-attachment@0.1.0-rc.6'
+  - '@deepseek-ai/dsh-brand@0.1.0-rc.6'
+  - '@deepseek-ai/dsh-invariants@0.1.0-rc.6'
+  - '@deepseek-ai/dsh-llm@0.1.0-rc.6'
+  - '@deepseek-ai/dsh-scope@0.1.0-rc.6'
+  - '@deepseek-ai/dsh-session@0.1.0-rc.6'
+  - '@deepseek-ai/dsh-system-prompt@0.1.0-rc.6'
+  - '@deepseek-ai/dsh-timeout@0.1.0-rc.6'
+  - '@deepseek-ai/dsh-typert-protocol@0.1.0-rc.6'
+  - '@deepseek-ai/schemastery@3.18.1'

package/scripts/prepare-test-pkg.js

@@ -0,0 +1,23 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..');
+const INTRANET_NAME = '@tencent/dsh-qqbot';
+
+// 1. 修改 package.json 的 name
+const pkgPath = join(root, 'package.json');
+const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+pkg.name = INTRANET_NAME;
+writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
+
+// 2. 同步 cordis.patch.yml 中的插件 name
+const patchFile = pkg.dsh?.bundle?.patch;
+if (patchFile) {
+  const patchPath = join(root, patchFile);
+  const patch = readFileSync(patchPath, 'utf8');
+  writeFileSync(
+    patchPath,
+    patch.replace(/name:\s*'@tencent-connect\/dsh-qqbot'/, `name: '${INTRANET_NAME}'`),
+  );
+}