@zaofan/dsh-qqbot 0.6.0

package/dist/transport/tool-presenter.js

@@ -0,0 +1,121 @@
+/**
+ * 工具调用结果 → Markdown 格式化
+ *
+ * 参考 dsh-TUI 的 presentResult 机制（channel.ts presentResultView），
+ * 适配 QQ 消息通道：优先用工具自定义的 presentResult 视图，
+ * fallback 到 raw text。错误始终展示，成功结果按 config 开关。
+ */
+const RESULT_PREVIEW_LIMIT = 1500;
+/** 静默工具集: 这些工具"失败"(尤其被主动 abort)是**有意行为**, 不展示失败提示(如 reply_gate 判定不吃瓜→self-cancel, 应静默无痕) */
+const SILENT_TOOLS = new Set(['reply_gate']);
+/**
+ * 将工具调用结果格式化为 Markdown 文本
+ *
+ * 返回 null 表示无需发送（无内容）。
+ */
+export function formatToolResult(name, rawArgs, data, toolsRegistry, agent) {
+    // 1. 错误优先：始终展示（静默工具除外——其中止=有意静默，如 reply_gate 吃瓜 self-cancel）
+    if (data.error) {
+        if (SILENT_TOOLS.has(name))
+            return null;
+        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

@@ -0,0 +1,45 @@
+/**
+ * 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;
+}
+/** 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;
+    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,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/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/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "@zaofan/dsh-qqbot",
+  "version": "0.6.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"
+    },
+    "./channel-tools": {
+      "types": "./dist/channel-tools.d.ts",
+      "import": "./dist/channel-tools.js"
+    },
+    "./sticker-store": {
+      "types": "./dist/features/sticker-store.d.ts",
+      "import": "./dist/features/sticker-store.js"
+    },
+    "./schedule-store": {
+      "types": "./dist/features/schedule-store.d.ts",
+      "import": "./dist/features/schedule-store.js"
+    },
+    "./client": "./client/qqbot-settings.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build && node scripts/check-package.mjs",
+    "check:package": "node scripts/check-package.mjs",
+    "lint": "eslint src/",
+    "test": "vitest run",
+    "clean": "rm -rf dist",
+    "ci:prepare-test-pkg": "node scripts/prepare-test-pkg.js"
+  },
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "qqbot",
+    "cordis",
+    "plugin"
+  ],
+  "license": "MIT",
+  "files": [
+    "dist",
+    "client",
+    "cordis.patch.yml",
+    "settings-host.js",
+    "README.md",
+    "README_EN.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": []
+    }
+  },
+  "dependencies": {
+    "@tencent-connect/qqbot-connector": "1.2.0",
+    "@tencent-connect/qqbot-nodejs": "^1.0.4",
+    "js-yaml": "^4.1.0"
+  },
+  "peerDependencies": {
+    "@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/dsh-tools": "^0.1.1-rc.2",
+    "@deepseek-ai/schemastery": ">=3.18.1",
+    "@tencent-connect/qqbot-connector": "1.2.0"
+  },
+  "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/dsh-tools": "^0.0.1-rc.1",
+    "@deepseek-ai/schemastery": "3.18.1",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^26.2.0",
+    "typescript": "^5.5.0",
+    "vitest": "^4.1.8"
+  }
+}