@cxyhhhhh/dsh-qqbot 0.1.0-dev.202608141525

package/README.md

@@ -0,0 +1,198 @@
+# @tencent-connect/dsh-qqbot
+
+基于 [deepseek-harness](../deepseek-harness) (dsh) 的 QQ Bot IM 插件，将 QQ 消息平台作为 dsh agent 的前端协议驱动。
+
+## 架构
+
+```
+QQ 用户 → QQ WebSocket → dsh-im-qqbot → ctx.agents → dsh agent loop → LLM
+                                 ↑                           │
+                                 └── session/event ──────────┘
+                                       (assistant reply → QQ sendMarkdown)
+```
+
+## 安装
+
+### 方式一：一键安装脚本
+
+```bash
+# 安装默认包最新版本
+sh install.sh
+
+# 指定版本
+sh install.sh --version 0.2.0
+
+# 指定包名
+sh install.sh --pkg @myorg/my-qqbot-plugin
+
+# 指定包名 + 版本
+sh install.sh --pkg @myorg/my-qqbot-plugin --version 1.0.0
+
+# 指定 npm registry
+sh install.sh --registry https://registry.npmmirror.com
+
+# 查看帮助
+sh install.sh --help
+```
+
+脚本自动完成 dsh/pnpm 预检 + profile 初始化 + 插件注册。
+
+### 方式二：手动执行
+
+```bash
+# 安装到 profile
+dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
+
+# 配置环境变量
+export QQBOT_APPID="你的AppID"
+export QQBOT_SECRET="你的AppSecret"
+
+# 启动
+dsh --profile qqbot
+```
+
+### 方式三：本地路径安装
+
+```bash
+# 构建
+cd /path/to/dsh-qqbot
+pnpm install && pnpm build
+
+# 安装到 profile（本地路径）
+dsh plugin --profile qqbot add /path/to/dsh-qqbot
+
+# 启动
+export QQBOT_APPID="你的AppID" QQBOT_SECRET="你的AppSecret"
+dsh --profile qqbot
+```
+
+### 方式三：--patch 开发模式
+
+```bash
+cd /path/to/deepseek-harness
+export QQBOT_APPID="你的AppID" QQBOT_SECRET="你的AppSecret"
+pnpm dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
+```
+
+## 配置项
+
+| 配置 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `appId` | string | **必填** | QQ Bot AppID（或通过 `QQBOT_APPID` 环境变量） |
+| `appSecret` | string | **必填** | QQ Bot AppSecret（或通过 `QQBOT_SECRET` 环境变量） |
+| `provider` | string | `deepseek-official` | LLM 提供商名称 |
+| `model` | string | `deepseek-chat` | 模型名称 |
+| `preset` | string | - | Agent preset id |
+| `cwd` | string | `process.cwd()` | Agent 工作目录 |
+| `requireMention` | boolean | `true` | 群聊是否需要 @bot 才触发 |
+| `groupPrompt` | string | - | 群聊额外 system prompt |
+| `directPrompt` | string | - | 私聊额外 system prompt |
+| `textChunkLimit` | number | `4500` | 单条消息最大字符数 |
+| `sessionIdleTimeout` | number | `1800000` | 会话闲置超时(ms)，默认 30 分钟 |
+| `debug` | boolean | `false` | 调试模式 |
+
+## 内置命令
+
+| 命令 | 说明 |
+|------|------|
+| `/reset` | 重置当前会话（清除上下文） |
+| `/clear` | 同 `/reset` |
+
+## 核心模块
+
+```
+src/
+├── index.ts              # Cordis 插件入口（async apply）
+├── config.ts             # 配置 Schema
+├── session-manager.ts    # QQ peer → Agent 映射（get → resume → create）
+├── inbound.ts            # QQ 入站消息 → agent.followup()
+├── outbound.ts           # session/event → QQ sendMarkdown
+├── mention.ts            # @mention 检测/清理
+├── chunker.ts            # Markdown 文本切分（代码块/表格感知）
+└── types.ts              # 内部类型定义
+```
+
+## 会话路由
+
+sessionKey 格式: `qqbot:${appId}:${kind}:${peerId}`
+
+- c2c (私聊): `qqbot:102901613:c2c:B9CE1DEEC46B...`
+- group (群聊): `qqbot:102901613:group:16FA861B01EE...`
+
+SessionId 由 sessionKey 确定性派生（SHA-256），保证同一用户/群的消息始终路由到同一 agent，重启后可恢复会话。
+
+会话解析策略（三级降级）：
+1. **进程内复用** — `agents.get(sessionId)`
+2. **持久化恢复** — `agents.resume({ resumeSessionId, setup })`
+3. **全新创建** — `agents.create({ sessionId, meta, setup })`
+
+## 设计原则
+
+- **纯 Cordis 插件** — 遵循 dsh "Plugins, not loop changes" 原则
+- **声明式依赖** — `inject = ['agents']`，不直接耦合其他插件
+- **会话隔离** — 每个 QQ 私聊用户/群聊各一个独立 Agent
+- **Preset 支持** — 可通过 `agent-presets` 服务挂载预设（工具集、prompt 等）
+- **闲置回收** — 超时自动 dispose Agent，防止内存泄漏
+- **Markdown 输出** — 回复以 Markdown 格式发送，支持代码块/表格感知切分
+
+## 本地开发
+
+```bash
+# 安装依赖
+pnpm install
+
+# 构建
+pnpm build
+
+# 开发模式（watch）
+pnpm dev
+
+# 用 --patch 方式调试（在 dsh monorepo 中）
+cd /path/to/deepseek-harness
+export QQBOT_APPID="xxx" QQBOT_SECRET="xxx"
+pnpm dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
+```
+
+### 断点调试
+
+```bash
+node --inspect ./node_modules/.bin/dsh --profile headless \
+  --patch /path/to/dsh-qqbot/cordis.dev.yml
+```
+
+### VS Code launch.json
+
+```json
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "dsh + qqbot (patch)",
+      "type": "node",
+      "request": "launch",
+      "cwd": "/path/to/deepseek-harness",
+      "runtimeExecutable": "pnpm",
+      "runtimeArgs": ["dsh", "web", "--patch", "/path/to/dsh-qqbot/cordis.dev.yml"],
+      "env": {
+        "QQBOT_APPID": "你的AppID",
+        "QQBOT_SECRET": "你的AppSecret",
+        "DEEPSEEK_API_KEY": "sk-xxx"
+      },
+      "console": "integratedTerminal"
+    }
+  ]
+}
+```
+
+## 发布
+
+```bash
+pnpm build
+npm publish --access public
+```
+
+安装后用户通过以下命令添加到 dsh：
+
+```bash
+dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
+```

package/cordis.patch.yml

@@ -0,0 +1,24 @@
+# dsh-im-qqbot bundle patch
+#
+# 当本包通过 `dsh plugin --profile <name> add @tencent-connect/dsh-qqbot` 安装后，
+# dsh 启动时自动加载此 patch。
+#
+# 环境变量：
+#   QQBOT_APPID  - QQ Bot AppID（必填）
+#   QQBOT_SECRET - QQ Bot AppSecret（必填）
+#
+# 叠加顺序：dsh-base → 本 bundle patch → profile cordis.patch.yml → --patch
+
+# ── 插入 im-qqbot 插件行 ──
+- insert:
+    - id: im-qqbot
+      name: '@cxyhhhhh/dsh-qqbot'
+      config:
+        appId: __FROM_ENV__
+        appSecret: __FROM_ENV__
+        provider: deepseek-official
+        model: deepseek-chat
+        requireMention: true
+        textChunkLimit: 4500
+        sessionIdleTimeout: 1800000
+        debug: false

package/cordis.yml

@@ -0,0 +1,69 @@
+# dsh-im-qqbot 组合配置示例
+#
+# 运行: pnpm dsh --config ./cordis.yml
+#
+# 环境变量:
+#   QQBOT_APPID     - QQ Bot AppID
+#   QQBOT_SECRET    - QQ Bot AppSecret
+#   DEEPSEEK_API_KEY - DeepSeek API Key
+#   DSH_CWD         - Agent 工作目录（可选）
+
+# ── 核心 spine ──
+- id: sessions
+  name: '@deepseek-ai/dsh-session'
+
+- id: agent
+  name: '@deepseek-ai/dsh-agent'
+
+- id: agent-loop
+  name: '@deepseek-ai/dsh-agent-loop'
+
+- id: system-prompt
+  name: '@deepseek-ai/dsh-system-prompt'
+
+- id: tools
+  name: '@deepseek-ai/dsh-tools'
+
+# ── LLM 适配器 ──
+- id: llm-deepseek
+  name: '@deepseek-ai/dsh-llm-deepseek'
+  config:
+    apiKey: ${DEEPSEEK_API_KEY}
+
+# ── 执行能力（按需启用） ──
+- id: tool-bash
+  name: '@deepseek-ai/dsh-tool-bash'
+
+- id: tool-fs
+  name: '@deepseek-ai/dsh-tool-fs'
+
+- id: tool-web
+  name: '@deepseek-ai/dsh-tool-web'
+
+# ── 上下文管理 ──
+- id: compaction
+  name: '@deepseek-ai/dsh-compaction-basic'
+
+- id: token-meter
+  name: '@deepseek-ai/dsh-token-meter'
+
+# ── 持久化 ──
+- id: session-persistence
+  name: '@deepseek-ai/dsh-session-persistence-jsonl'
+  config:
+    root: ./.dsh-sessions
+
+# ── QQ Bot IM 驱动 ──
+- id: im-qqbot
+  name: '@deepseek-ai/dsh-im-qqbot'
+  config:
+    appId: ${QQBOT_APPID}
+    appSecret: ${QQBOT_SECRET}
+    transport: websocket
+    provider: deepseek
+    model: deepseek-chat
+    cwd: ${DSH_CWD:-/tmp/dsh-qqbot}
+    requireMention: false
+    textChunkLimit: 4500
+    sessionIdleTimeout: 1800000
+    debug: false

package/dist/chunker.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Markdown 文本切分器
+ *
+ * QQ 单条消息有字符数限制（约 5000），需要在合适边界切分，
+ * 并保持 GFM 表格、代码块的完整性。
+ */
+/**
+ * 按换行边界切分 Markdown 文本
+ * - 不在代码块中间断开
+ * - 不在 GFM 表格中间断开
+ * - 优先在空行处断开
+ */
+export declare function chunkMarkdownText(text: string, limit: number): string[];
+//# sourceMappingURL=chunker.d.ts.map

package/dist/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../src/chunker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAyEvE"}

package/dist/chunker.js

@@ -0,0 +1,83 @@
+/**
+ * Markdown 文本切分器
+ *
+ * QQ 单条消息有字符数限制（约 5000），需要在合适边界切分，
+ * 并保持 GFM 表格、代码块的完整性。
+ */
+const CODE_FENCE_OPEN = /^```/;
+const GFM_TABLE_LINE = /^\|.+\|$/;
+/**
+ * 按换行边界切分 Markdown 文本
+ * - 不在代码块中间断开
+ * - 不在 GFM 表格中间断开
+ * - 优先在空行处断开
+ */
+export function chunkMarkdownText(text, limit) {
+    if (text.length <= limit)
+        return [text];
+    const lines = text.split('\n');
+    const chunks = [];
+    let current = '';
+    let inCodeBlock = false;
+    let tableBuffer = [];
+    const flushTable = () => {
+        if (tableBuffer.length === 0)
+            return;
+        const block = tableBuffer.join('\n');
+        tableBuffer = [];
+        if (!current) {
+            current = block;
+            return;
+        }
+        const candidate = `${current}\n${block}`;
+        if (candidate.length > limit) {
+            chunks.push(current);
+            current = block;
+        }
+        else {
+            current = candidate;
+        }
+    };
+    const appendLine = (line) => {
+        if (!current) {
+            current = line;
+            return;
+        }
+        const candidate = `${current}\n${line}`;
+        if (candidate.length > limit) {
+            chunks.push(current);
+            current = line;
+        }
+        else {
+            current = candidate;
+        }
+    };
+    for (const line of lines) {
+        // 追踪代码块状态
+        if (CODE_FENCE_OPEN.test(line)) {
+            flushTable();
+            inCodeBlock = !inCodeBlock;
+            appendLine(line);
+            continue;
+        }
+        // 代码块内部不切分
+        if (inCodeBlock) {
+            appendLine(line);
+            continue;
+        }
+        // GFM 表格行收集
+        if (GFM_TABLE_LINE.test(line)) {
+            tableBuffer.push(line);
+            continue;
+        }
+        // 非表格行，先 flush 积累的表格
+        flushTable();
+        appendLine(line);
+    }
+    // 处理剩余
+    flushTable();
+    if (current)
+        chunks.push(current);
+    return chunks.length > 0 ? chunks : [text];
+}
+//# sourceMappingURL=chunker.js.map

package/dist/chunker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.js","sourceRoot":"","sources":["../src/chunker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,cAAc,GAAG,UAAU,CAAC;AAElC;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,KAAa;IAC3D,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,WAAW,GAAa,EAAE,CAAC;IAE/B,MAAM,UAAU,GAAG,GAAS,EAAE;QAC5B,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACrC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,WAAW,GAAG,EAAE,CAAC;QAEjB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,KAAK,CAAC;YAChB,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,OAAO,KAAK,KAAK,EAAE,CAAC;QACzC,IAAI,SAAS,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,IAAY,EAAQ,EAAE;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,IAAI,CAAC;YACf,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,GAAG,OAAO,KAAK,IAAI,EAAE,CAAC;QACxC,IAAI,SAAS,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,UAAU;QACV,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,UAAU,EAAE,CAAC;YACb,WAAW,GAAG,CAAC,WAAW,CAAC;YAC3B,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,SAAS;QACX,CAAC;QAED,WAAW;QACX,IAAI,WAAW,EAAE,CAAC;YAChB,UAAU,CAAC,IAAI,CAAC,CAAC;YACjB,SAAS;QACX,CAAC;QAED,YAAY;QACZ,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QAED,qBAAqB;QACrB,UAAU,EAAE,CAAC;QACb,UAAU,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,OAAO;IACP,UAAU,EAAE,CAAC;IACb,IAAI,OAAO;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAElC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,32 @@
+/**
+ * dsh-im-qqbot 插件配置 Schema
+ */
+import Schema from '@deepseek-ai/schemastery';
+export interface ImQQBotConfig {
+    /** QQ Bot AppID */
+    appId: string;
+    /** QQ Bot AppSecret */
+    appSecret: string;
+    /** dsh LLM 提供商名称 */
+    provider?: string;
+    /** 模型名称 */
+    model?: string;
+    /** Agent preset id */
+    preset?: string;
+    /** Agent 工作目录 */
+    cwd: string;
+    /** 是否启用群消息 @mention 门控 */
+    requireMention: boolean;
+    /** 群聊额外 system prompt */
+    groupPrompt?: string;
+    /** 私聊额外 system prompt */
+    directPrompt?: string;
+    /** 单条消息最大长度（QQ 限制约 5000 字符） */
+    textChunkLimit: number;
+    /** 每会话最大闲置时长(ms)，超时自动回收 */
+    sessionIdleTimeout: number;
+    /** 调试模式 */
+    debug: boolean;
+}
+export declare const ConfigSchema: Schema<ImQQBotConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,MAAM,MAAM,0BAA0B,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW;IACX,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,aAAa,CAa7C,CAAC"}

package/dist/config.js

@@ -0,0 +1,19 @@
+/**
+ * dsh-im-qqbot 插件配置 Schema
+ */
+import Schema from '@deepseek-ai/schemastery';
+export const ConfigSchema = Schema.object({
+    appId: Schema.string().default('').description('QQ Bot AppID'),
+    appSecret: Schema.string().default('').description('QQ Bot AppSecret'),
+    provider: Schema.string().description('LLM provider name'),
+    model: Schema.string().description('Model name'),
+    preset: Schema.string().description('Agent preset id'),
+    cwd: Schema.string().default('/').description('Agent working directory'),
+    requireMention: Schema.boolean().default(true).description('群聊是否需要@bot触发'),
+    groupPrompt: Schema.string().description('群聊额外system prompt'),
+    directPrompt: Schema.string().description('私聊额外system prompt'),
+    textChunkLimit: Schema.number().default(4500).description('单条消息最大字符数'),
+    sessionIdleTimeout: Schema.number().default(30 * 60 * 1000).description('会话闲置超时(ms)'),
+    debug: Schema.boolean().default(false),
+});
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,MAAM,MAAM,0BAA0B,CAAC;AA6B9C,MAAM,CAAC,MAAM,YAAY,GAA0B,MAAM,CAAC,MAAM,CAAC;IAC/D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC;IAC9D,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,kBAAkB,CAAC;IACtE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,mBAAmB,CAAC;IAC1D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,YAAY,CAAC;IAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,iBAAiB,CAAC;IACtD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,yBAAyB,CAAC;IACxE,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC;IAC1E,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,mBAAmB,CAAC;IAC7D,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,mBAAmB,CAAC;IAC9D,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC;IACtE,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC;IACrF,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACvC,CAAC,CAAC"}

package/dist/inbound.d.ts

@@ -0,0 +1,8 @@
+import type { SessionManager } from './session-manager.js';
+import type { ImQQBotConfig } from './config.js';
+import type { Logger } from './types.js';
+/**
+ * 处理 QQ 入站消息
+ */
+export declare function handleInbound(rawMsg: unknown, manager: SessionManager, config: ImQQBotConfig, logger: Logger): Promise<void>;
+//# sourceMappingURL=inbound.d.ts.map

package/dist/inbound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../src/inbound.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAa,MAAM,EAAe,MAAM,YAAY,CAAC;AAkBjE;;GAEG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAuDf"}

package/dist/inbound.js

@@ -0,0 +1,71 @@
+import { createUserMessage } from '@deepseek-ai/dsh-llm';
+import { detectMention, stripMention } from './mention.js';
+/**
+ * 处理 QQ 入站消息
+ */
+export async function handleInbound(rawMsg, manager, config, logger) {
+    const msg = rawMsg;
+    // 从 SDK 消息中提取关键字段
+    const scope = msg.kind === 'group' ? 'group' : 'c2c';
+    const peerId = scope === 'group' ? (msg.groupOpenid ?? msg.senderId) : msg.senderId;
+    // 构造 replyTarget（用于出站回复）
+    const replyTarget = {
+        scope,
+        targetId: peerId,
+        msgId: msg.messageId,
+    };
+    console.log(`[im-qqbot] Processing: scope=${scope} peerId=${peerId} content="${msg.content}"`);
+    // ── 群消息 @mention 门控 ──
+    if (scope === 'group' && config.requireMention) {
+        if (!detectMention(msg.content)) {
+            return;
+        }
+    }
+    // ── 提取并清理文本 ──
+    let text = msg.content?.trim() ?? '';
+    if (scope === 'group') {
+        text = stripMention(text);
+    }
+    if (!text)
+        return;
+    // ── 命令处理 ──
+    if (text.startsWith('/')) {
+        const handled = handleCommand(text, scope, peerId, manager, logger);
+        if (handled)
+            return;
+    }
+    // ── 获取或创建会话 ──
+    let record;
+    try {
+        record = await manager.getOrCreate(scope, peerId, msg.senderId, replyTarget);
+    }
+    catch (err) {
+        console.error(`[im-qqbot] ERROR creating session: ${err instanceof Error ? err.message : String(err)}`);
+        return;
+    }
+    // ── 构建 UserMessage → followup ──
+    const content = [{ type: 'text', text }];
+    const message = createUserMessage({
+        content,
+        source: { kind: 'user' },
+    });
+    record.agent.followup(message);
+    console.log(`[im-qqbot] → followup sent: key=${scope}:${peerId} text="${text}"`);
+}
+/**
+ * 处理内置命令
+ */
+function handleCommand(text, scope, peerId, manager, _logger) {
+    const cmd = text.split(/\s+/)[0]?.toLowerCase();
+    switch (cmd) {
+        case '/reset':
+        case '/clear': {
+            void manager.remove(scope, peerId);
+            console.log(`[im-qqbot] Session reset: key=${scope}:${peerId}`);
+            return true;
+        }
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=inbound.js.map

package/dist/inbound.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * dsh-im-qqbot — QQ Bot IM channel plugin for deepseek-harness
+ *
+ * Cordis 插件入口。将 QQ 消息平台作为 dsh 的前端协议驱动。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type ImQQBotConfig } from './config.js';
+export declare const name = "im-qqbot";
+export declare const inject: string[];
+export declare const Config: import("@deepseek-ai/schemastery").default<ImQQBotConfig>;
+export type { ImQQBotConfig } from './config.js';
+export declare function apply(ctx: Context, config: ImQQBotConfig): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAa/D,eAAO,MAAM,IAAI,aAAa,CAAC;AAC/B,eAAO,MAAM,MAAM,UAAa,CAAC;AACjC,eAAO,MAAM,MAAM,2DAAe,CAAC;AAEnC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAUjD,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB9E"}

package/dist/index.js

@@ -0,0 +1,85 @@
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+import { ConfigSchema } from './config.js';
+import { SessionManager } from './session-manager.js';
+import { handleInbound } from './inbound.js';
+import { createOutboundHandler } from './outbound.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PLUGIN_ROOT = resolve(__dirname, '..');
+console.log('[im-qqbot] module loaded, plugin root:', PLUGIN_ROOT);
+// ── Cordis 插件元数据 ──
+export const name = 'im-qqbot';
+export const inject = ['agents'];
+export const Config = ConfigSchema;
+// ── 插件主体 ──
+export async function apply(ctx, config) {
+    const agents = ctx.agents;
+    const logger = ctx.logger ?? console;
+    console.log('[im-qqbot] apply() called');
+    const appId = resolveEnv(config.appId, 'QQBOT_APPID');
+    const appSecret = resolveEnv(config.appSecret, 'QQBOT_SECRET');
+    if (!appId || !appSecret) {
+        console.error('[im-qqbot] ERROR: Missing QQBOT_APPID or QQBOT_SECRET');
+        return;
+    }
+    const resolvedConfig = { ...config, appId, appSecret };
+    await bootstrap(ctx, agents, resolvedConfig, logger);
+}
+async function bootstrap(ctx, agents, config, logger) {
+    const manager = new SessionManager(ctx, agents, config, logger);
+    // ── 动态 import QQ Bot SDK（纯 ESM 包，必须 import() 不能 require） ──
+    let bot;
+    try {
+        // 用绝对路径 import 插件自身 node_modules 中的包
+        const sdkPath = resolve(PLUGIN_ROOT, 'node_modules/@tencent-connect/qqbot-nodejs/dist/index.js');
+        const mod = await import(sdkPath);
+        const QQBot = mod.QQBot ?? mod.default?.QQBot ?? mod.default;
+        bot = new QQBot({
+            appId: config.appId,
+            appSecret: config.appSecret,
+            transport: 'websocket',
+            logger,
+        });
+        console.log('[im-qqbot] QQBot SDK loaded');
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[im-qqbot] ERROR: Cannot load QQBot SDK: ${msg}`);
+        console.error(`[im-qqbot] TIP: cd ${PLUGIN_ROOT} && pnpm install && pnpm -C node_modules/@tencent-connect/qqbot-nodejs build`);
+        return;
+    }
+    // ── 入站 ──
+    bot.on('message', async (_mqCtx, msg) => {
+        console.log('[im-qqbot] ← message received:', JSON.stringify(msg, null, 2).slice(0, 500));
+        await handleInbound(msg, manager, config, logger);
+    });
+    // ── 出站 ──
+    const outboundHandler = createOutboundHandler(manager, bot, config, logger);
+    ctx
+        .on('session/event', outboundHandler);
+    bot.on('error', (err) => {
+        logger.error(`im-qqbot: bot error: ${err instanceof Error ? err.message : String(err)}`);
+    });
+    bot.on('ready', () => {
+        console.log(`[im-qqbot] Bot ready! appId=${config.appId}`);
+    });
+    // ── 生命周期 ──
+    ctx
+        .effect(() => {
+        console.log(`[im-qqbot] Starting bot (appId=${config.appId})`);
+        void bot.start();
+        return async () => {
+            console.log('[im-qqbot] Shutting down');
+            await manager.disposeAll();
+            bot.stop();
+        };
+    }, 'im-qqbot.lifecycle');
+}
+function resolveEnv(configValue, envKey) {
+    if (configValue && configValue !== '__FROM_ENV__' && !configValue.startsWith('process.env')) {
+        return configValue;
+    }
+    return process.env[envKey] ?? '';
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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