@tencent-connect/dsh-qqbot 0.1.0

package/dist/session/session-manager.js

@@ -0,0 +1,341 @@
+/**
+ * SessionManager — 管理 QQ peer → dsh Agent 的映射和生命周期
+ *
+ * sessionKey 格式: `qqbot:${appId}:${kind}:${peerId}`
+ *   - c2c:   peerId = senderId (用户 openid)
+ *   - group: peerId = groupOpenid
+ *
+ * SessionId 由 sessionKey 确定性派生（SHA-256），
+ * 保证同一个用户/群的消息始终路由到同一个会话，
+ * 重启后可根据 key 恢复 session。
+ *
+ * 支持 agent-presets 系统：通过 setup hook 在 create/resume 时
+ * 挂载 preset（工具集、prompt sections 等），实现场景化配置。
+ */
+import { createHash, randomUUID } from 'node:crypto';
+import { SessionId } from '@deepseek-ai/dsh-session';
+import { ModelResolver } from '../model/model-resolver.js';
+import { IdleEvictor } from './idle-evictor.js';
+export class SessionManager {
+    ctx;
+    agents;
+    config;
+    logger;
+    sessions = new Map();
+    evictor;
+    modelResolver;
+    constructor(ctx, agents, config, logger) {
+        this.ctx = ctx;
+        this.agents = agents;
+        this.config = config;
+        this.logger = logger;
+        this.modelResolver = new ModelResolver(ctx, config, logger);
+        this.evictor = new IdleEvictor(this.sessions, config.sessionIdleTimeout, (key, record) => {
+            this.logger.info(`evicting idle session: key=${key}`);
+            this.sessions.delete(key);
+            record.agent.cancel({ kind: 'user' });
+            void record.handle.dispose().catch(() => { });
+        });
+    }
+    /**
+     * 动态获取 sessions 服务（fork 能力，可选）
+     */
+    getSessionsService() {
+        try {
+            return this.ctx.get('sessions');
+        }
+        catch {
+            return undefined;
+        }
+    }
+    // ── 模型相关（委托给 ModelResolver） ──
+    getEffectiveModel(scope, peerId) {
+        return this.modelResolver.getEffectiveRoute(this.sessionKey(scope, peerId));
+    }
+    /**
+     * 切换模型（fork + 重建，对齐 dsh-TUI 的 switchModel）
+     */
+    async setModelOverride(scope, peerId, route) {
+        const key = this.sessionKey(scope, peerId);
+        this.modelResolver.setOverride(key, route);
+        const record = this.sessions.get(key);
+        if (!record) {
+            this.logger.info(`model pref saved (no active session): key=${key} → ${route.provider}/${route.model}`);
+            return;
+        }
+        const sessionsService = this.getSessionsService();
+        if (!sessionsService) {
+            this.logger.warn(`fork unavailable, fallback to dispose: key=${key}`);
+            this.sessions.delete(key);
+            record.agent.cancel({ kind: 'user' });
+            await record.handle.dispose().catch(() => { });
+            return;
+        }
+        let seed;
+        try {
+            seed = sessionsService.fork(record.agent.session).events;
+        }
+        catch (err) {
+            this.logger.warn(`fork failed, fallback to dispose: key=${key} err=${err instanceof Error ? err.message : String(err)}`);
+            this.sessions.delete(key);
+            record.agent.cancel({ kind: 'user' });
+            await record.handle.dispose().catch(() => { });
+            return;
+        }
+        const childId = SessionId(randomUUID());
+        const composed = await this.composePreset(this.config.preset);
+        const created = await this.agents.create({
+            sessionId: childId,
+            seed,
+            meta: {
+                cwd: this.config.cwd || process.cwd(),
+                parentSession: record.sessionId,
+                seedLength: seed.length,
+                ...(composed.agentPreset ? { agentPreset: composed.agentPreset } : {}),
+            },
+            agentOptions: route,
+            ...(composed.setup ? { setup: composed.setup } : {}),
+        });
+        this.modelResolver.setSessionId(key, childId);
+        const oldHandle = record.handle;
+        record.sessionId = childId;
+        record.agent = created.agent;
+        record.handle = created;
+        record.agentPreset = composed.agentPreset;
+        record.lastActivity = Date.now();
+        void oldHandle.dispose().catch(() => { });
+        this.logger.info(`model switched via fork: key=${key} → ${route.provider}/${route.model} sessionId=${childId}`);
+    }
+    clearModelOverride(scope, peerId) {
+        const key = this.sessionKey(scope, peerId);
+        this.modelResolver.clearOverride(key);
+        this.modelResolver.clearSessionId(key);
+    }
+    listAvailableModels() {
+        return this.modelResolver.listModels();
+    }
+    listProviders() {
+        return this.modelResolver.listProviders();
+    }
+    // ── 会话状态 / 统计 ──
+    getSessionRecord(scope, peerId) {
+        return this.sessions.get(this.sessionKey(scope, peerId));
+    }
+    getStatus(scope, peerId) {
+        const record = this.getSessionRecord(scope, peerId);
+        const route = this.getEffectiveModel(scope, peerId);
+        return {
+            active: !!record,
+            sessionId: record?.sessionId,
+            provider: route?.provider,
+            model: route?.model,
+            preset: record?.agentPreset,
+            lastActivity: record?.lastActivity,
+            messageCount: this.countMessages(record),
+        };
+    }
+    getTokenUsage(scope, peerId) {
+        const record = this.getSessionRecord(scope, peerId);
+        const stats = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 };
+        const events = record?.agent.session.events;
+        if (!events)
+            return stats;
+        for (const event of events) {
+            if (event.type !== 'assistant/message' || !event.usage)
+                continue;
+            stats.input += event.usage.input ?? 0;
+            stats.output += event.usage.output ?? 0;
+            stats.cacheRead += event.usage.cacheRead ?? 0;
+            stats.cacheWrite += event.usage.cacheWrite ?? 0;
+        }
+        return stats;
+    }
+    exportMarkdown(scope, peerId) {
+        const record = this.getSessionRecord(scope, peerId);
+        if (!record)
+            return '';
+        const events = record.agent.session.events;
+        if (!events || events.length === 0)
+            return '';
+        const lines = [`# QQ 会话导出\n`, `> session: ${record.sessionId}\n`];
+        for (const event of events) {
+            if (event.type === 'user/message') {
+                const text = extractMessageText(event.message);
+                if (text)
+                    lines.push(`## 用户\n\n${text}\n`);
+            }
+            else if (event.type === 'assistant/message') {
+                const text = extractMessageText(event.message);
+                if (text)
+                    lines.push(`## 助手\n\n${text}\n`);
+            }
+        }
+        return lines.join('\n');
+    }
+    countMessages(record) {
+        const events = record?.agent.session.events;
+        if (!events)
+            return 0;
+        let count = 0;
+        for (const event of events) {
+            if (event.type === 'user/message' || event.type === 'assistant/message') {
+                count += 1;
+            }
+        }
+        return count;
+    }
+    // ── Session 生命周期管理 ──
+    sessionKey(scope, peerId) {
+        return `qqbot:${this.config.appId}:${scope}:${peerId}`;
+    }
+    deriveSessionId(sessionKey) {
+        const hash = createHash('sha256').update(sessionKey).digest('hex');
+        return `${hash.slice(0, 8)}-${hash.slice(8, 12)}-${hash.slice(12, 16)}-${hash.slice(16, 20)}-${hash.slice(20, 32)}`;
+    }
+    currentSessionId(sessionKey) {
+        return this.modelResolver.getSessionId(sessionKey) ?? this.deriveSessionId(sessionKey);
+    }
+    async composePreset(presetId) {
+        let presets;
+        try {
+            presets = this.ctx.agentPresets;
+        }
+        catch {
+            // agentPresets 服务未注入，降级跳过
+        }
+        if (!presets)
+            return {};
+        try {
+            const resolved = await presets.resolve(presetId);
+            const resolvedId = resolved.id;
+            return {
+                agentPreset: resolvedId,
+                setup: async (agentCtx) => {
+                    await presets.mount(agentCtx, resolvedId);
+                },
+            };
+        }
+        catch (err) {
+            this.logger.warn(`im-qqbot: preset ${presetId ?? '(default)'} unavailable: ${err instanceof Error ? err.message : String(err)} — using host composition`);
+            return {};
+        }
+    }
+    /** 获取或恢复或创建会话（get → resume → create） */
+    async getOrCreate(scope, peerId, senderId, replyTarget) {
+        const key = this.sessionKey(scope, peerId);
+        const existing = this.sessions.get(key);
+        if (existing) {
+            existing.replyTarget = replyTarget;
+            existing.lastActivity = Date.now();
+            return existing;
+        }
+        const route = this.modelResolver.getEffectiveRoute(key);
+        const sessionId = SessionId(this.currentSessionId(key));
+        this.logger.info(`getOrCreate: key=${key} route=${route ? `${route.provider}/${route.model}` : 'host-default'} sessionId=${sessionId}`);
+        let agent;
+        let handle;
+        let agentPreset;
+        const live = this.agents.get(sessionId);
+        if (live) {
+            agent = live;
+            this.logger.info(`reusing live agent: key=${key}`);
+        }
+        else {
+            try {
+                const composed = await this.composePreset(this.config.preset);
+                agentPreset = composed.agentPreset;
+                const resumeRoute = this.modelResolver.getResumeRoute(key);
+                const resumed = await this.agents.resume({
+                    resumeSessionId: sessionId,
+                    ...(resumeRoute ? { agentOptions: resumeRoute } : {}),
+                    ...(composed.setup ? { setup: composed.setup } : {}),
+                });
+                agent = resumed.agent;
+                handle = resumed;
+                this.logger.info(`resumed session: key=${key} preset=${agentPreset ?? 'none'} route=${resumeRoute ? `${resumeRoute.provider}/${resumeRoute.model}` : 'session-own'}`);
+            }
+            catch {
+                const composed = await this.composePreset(this.config.preset);
+                agentPreset = composed.agentPreset;
+                const created = await this.agents.create({
+                    sessionId,
+                    meta: {
+                        cwd: this.config.cwd || process.cwd(),
+                        ...(agentPreset ? { agentPreset } : {}),
+                    },
+                    ...(route ? { agentOptions: route } : {}),
+                    ...(composed.setup ? { setup: composed.setup } : {}),
+                });
+                agent = created.agent;
+                handle = created;
+                this.logger.info(`created new session: key=${key} preset=${agentPreset ?? 'none'}`);
+            }
+        }
+        const record = {
+            sessionKey: key,
+            sessionId,
+            agent,
+            handle: handle ?? { agent, dispose: async () => { } },
+            replyTarget,
+            scope,
+            peerId,
+            senderId,
+            lastActivity: Date.now(),
+            agentPreset,
+        };
+        this.sessions.set(key, record);
+        return record;
+    }
+    findBySessionId(sessionId) {
+        for (const record of this.sessions.values()) {
+            if (record.sessionId === sessionId)
+                return record;
+        }
+        return undefined;
+    }
+    findByAgent(agent) {
+        for (const record of this.sessions.values()) {
+            if (record.agent === agent)
+                return record;
+        }
+        return undefined;
+    }
+    async remove(scope, peerId) {
+        const key = this.sessionKey(scope, peerId);
+        const record = this.sessions.get(key);
+        if (!record)
+            return;
+        this.sessions.delete(key);
+        this.modelResolver.clearSessionId(key);
+        record.agent.cancel({ kind: 'user' });
+        await record.handle.dispose().catch(() => { });
+        this.logger.info(`session removed: key=${key}`);
+    }
+    async disposeAll() {
+        this.evictor.dispose();
+        const records = [...this.sessions.values()];
+        this.sessions.clear();
+        for (const record of records) {
+            record.agent.cancel({ kind: 'user' });
+        }
+        await Promise.allSettled(records.map((r) => r.handle.dispose()));
+        this.logger.info(`all sessions disposed (count=${records.length})`);
+    }
+    get size() {
+        return this.sessions.size;
+    }
+}
+/** 从消息对象中提取纯文本（用于导出/统计） */
+function extractMessageText(message) {
+    const blocks = message?.content;
+    if (!blocks || !Array.isArray(blocks))
+        return '';
+    const parts = [];
+    for (const block of blocks) {
+        if (block.type === 'text' && block.text) {
+            parts.push(block.text);
+        }
+    }
+    return parts.join('\n').trim();
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/session/session-manager.js.map

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

package/dist/session/types.d.ts

@@ -0,0 +1,124 @@
+/**
+ * 会话管理层类型定义
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ChatScope, ReplyTarget } from '../types.js';
+/** AgentSetup hook 类型 */
+export type AgentSetup = (agentCtx: Context) => Promise<void> | void;
+/** dsh SessionEvent 简化类型（用于统计 token 用量 / 导出） */
+export interface SessionEventLike {
+    type: string;
+    seq?: number;
+    usage?: {
+        input?: number;
+        output?: number;
+        cacheRead?: number;
+        cacheWrite?: number;
+    };
+    message?: {
+        content?: Array<{
+            type: string;
+            text?: string;
+        }>;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/** dsh Agent 简化接口 */
+export interface DshAgent {
+    readonly id: string;
+    readonly ctx: Context;
+    /** 底层 session（fork 时作为 source，events 用于统计/导出） */
+    readonly session: {
+        readonly id: string;
+        readonly events?: readonly SessionEventLike[];
+    };
+    cancel(cause: {
+        kind: string;
+    }): void;
+    followup(message: unknown): void;
+    whenIdle(): Promise<void>;
+}
+export interface DshAgentHandle {
+    agent: DshAgent;
+    dispose(): Promise<void>;
+}
+/** sessions 服务（fork 能力） */
+export interface SessionsService {
+    fork(source: unknown, boundary?: number): {
+        events: readonly unknown[];
+    };
+}
+export interface DshAgentRegistry {
+    /** 获取进程内已存活的 agent */
+    get(sessionId: string): DshAgent | undefined;
+    /** 从持久化存储恢复 session */
+    resume(options: {
+        resumeSessionId: string;
+        agentOptions?: {
+            provider?: string;
+            model?: string;
+        };
+        setup?: AgentSetup;
+    }): Promise<DshAgentHandle>;
+    /** 创建全新 session */
+    create(options: {
+        sessionId: string;
+        meta?: {
+            cwd?: string;
+            parentSession?: string;
+            seedLength?: number;
+            agentPreset?: string;
+        };
+        seed?: readonly unknown[];
+        agentOptions?: {
+            provider?: string;
+            model?: string;
+        };
+        setup?: AgentSetup;
+    }): Promise<DshAgentHandle>;
+}
+/** agent-presets 服务接口（可选，部署中可能没有） */
+export interface AgentPresetsLike {
+    readonly defaultId: string;
+    resolve(id?: string): Promise<{
+        id: string;
+    }>;
+    mount(agentCtx: Context, id?: string): Promise<unknown>;
+}
+/** preset 组合结果 */
+export interface PresetComposition {
+    agentPreset?: string;
+    setup?: AgentSetup;
+}
+/** 单个会话记录 */
+export interface SessionRecord {
+    sessionKey: string;
+    sessionId: string;
+    agent: DshAgent;
+    handle: DshAgentHandle;
+    replyTarget: ReplyTarget;
+    scope: ChatScope;
+    peerId: string;
+    senderId: string;
+    lastActivity: number;
+    agentPreset?: string;
+}
+/** 会话状态信息（/status 用） */
+export interface SessionStatus {
+    active: boolean;
+    sessionId?: string;
+    provider?: string;
+    model?: string;
+    preset?: string;
+    lastActivity?: number;
+    messageCount?: number;
+}
+/** token 用量统计（/cost 用） */
+export interface TokenUsageStats {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/session/types.d.ts.map

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

package/dist/session/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/session/types.js.map

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

package/dist/setup.d.ts

@@ -0,0 +1,24 @@
+/** 凭据结果 */
+export interface SetupCredentials {
+    appId: string;
+    appSecret: string;
+}
+/**
+ * 执行 QR 扫码绑定，获取 QQ Bot 凭据
+ *
+ * 使用动态 import 加载 qqbot-connector（可能未安装），
+ * 在终端打印二维码等待用户扫码。
+ */
+export declare function runQrSetup(source?: string): Promise<SetupCredentials | null>;
+/**
+ * 将凭据写入 dsh profile 的 cordis.patch.yml
+ *
+ * 用 js-yaml 解析现有文件后更新/追加 im-qqbot 条目，再 dump 写回，
+ * 保证输出始终是合法 YAML。兼容空数组 `[]`、条目列表，以及
+ * `[]` 与条目混合导致解析失败等异常情况（失败时重建）。
+ */
+export declare function persistCredentialsToProfile(credentials: SetupCredentials, profileDir?: string, logger?: {
+    info(msg: string, ...args: unknown[]): void;
+    warn(msg: string, ...args: unknown[]): void;
+}): boolean;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAWA,WAAW;AACX,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AASD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,MAAM,SAAc,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAwCvF;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,gBAAgB,EAC7B,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE;IAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAAE,GACpG,OAAO,CAiDT"}

package/dist/setup.js

@@ -0,0 +1,135 @@
+/**
+ * QQ Bot 凭据初始化 — 扫码绑定
+ *
+ * 当 appId/appSecret 未配置时，通过 @tencent-connect/qqbot-connector
+ * 唤起终端扫码流程获取凭据，并写入 dsh profile 配置。
+ */
+import { resolve } from 'node:path';
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import yaml from 'js-yaml';
+import { qrConnect } from '@tencent-connect/qqbot-connector';
+/**
+ * 执行 QR 扫码绑定，获取 QQ Bot 凭据
+ *
+ * 使用动态 import 加载 qqbot-connector（可能未安装），
+ * 在终端打印二维码等待用户扫码。
+ */
+export async function runQrSetup(source = 'dsh-qqbot') {
+    console.log('\n══════════════════════════════════════════════════════');
+    console.log('  QQ Bot 凭据未配置，启动扫码绑定');
+    console.log('══════════════════════════════════════════════════════\n');
+    try {
+        console.log('请使用手机 QQ 扫描下方二维码完成绑定...\n');
+        const credentials = await qrConnect({ source });
+        if (!credentials || credentials.length === 0) {
+            console.error('[im-qqbot] 扫码未返回凭据');
+            return null;
+        }
+        const cred = credentials[0];
+        if (!cred) {
+            console.error('[im-qqbot] 扫码未返回有效凭据');
+            return null;
+        }
+        console.log(`\n✔ 绑定成功！AppID: ${cred.appId}\n`);
+        return {
+            appId: cred.appId,
+            appSecret: cred.appSecret,
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes('Cannot find') || msg.includes('ERR_MODULE_NOT_FOUND')) {
+            console.error('[im-qqbot] @tencent-connect/qqbot-connector 未安装，无法扫码绑定');
+            console.error('[im-qqbot] 请通过环境变量配置:');
+            console.error('  export QQBOT_APPID="你的AppID"');
+            console.error('  export QQBOT_SECRET="你的AppSecret"');
+        }
+        else {
+            console.error(`[im-qqbot] 扫码绑定失败: ${msg}`);
+        }
+        return null;
+    }
+}
+/**
+ * 将凭据写入 dsh profile 的 cordis.patch.yml
+ *
+ * 用 js-yaml 解析现有文件后更新/追加 im-qqbot 条目，再 dump 写回，
+ * 保证输出始终是合法 YAML。兼容空数组 `[]`、条目列表，以及
+ * `[]` 与条目混合导致解析失败等异常情况（失败时重建）。
+ */
+export function persistCredentialsToProfile(credentials, profileDir, logger) {
+    const log = logger ?? console;
+    const dir = profileDir;
+    if (!dir) {
+        printManualInstructions(credentials, log);
+        return false;
+    }
+    const patchPath = resolve(dir, 'cordis.patch.yml');
+    try {
+        // 1. 解析现有条目（容错处理）
+        let entries = [];
+        if (existsSync(patchPath)) {
+            entries = parsePatchEntries(readFileSync(patchPath, 'utf8'), log);
+        }
+        // 2. 查找已有 im-qqbot 条目
+        const existing = entries.find((e) => e.id === 'im-qqbot');
+        if (existing) {
+            // 更新已有条目的 config
+            existing.config = {
+                ...(existing.config ?? {}),
+                appId: credentials.appId,
+                appSecret: credentials.appSecret,
+            };
+        }
+        else {
+            // 追加新条目
+            entries.push({
+                id: 'im-qqbot',
+                config: {
+                    appId: credentials.appId,
+                    appSecret: credentials.appSecret,
+                },
+            });
+        }
+        // 3. dump 写回（保证合法 YAML）
+        const output = `# QQ Bot 凭据（扫码绑定自动生成）\n${yaml.dump(entries)}`;
+        writeFileSync(patchPath, output, 'utf8');
+        log.info(`✔ 凭据已写入: ${patchPath}`);
+        log.info(`  下次启动将自动使用保存的凭据`);
+        return true;
+    }
+    catch (err) {
+        log.warn(`写入配置失败: ${err instanceof Error ? err.message : String(err)}`);
+        printManualInstructions(credentials, log);
+        return false;
+    }
+}
+/**
+ * 解析 cordis.patch.yml 为条目数组
+ *
+ * 容错处理：
+ * - 空内容 / 空数组 `[]` → 空数组
+ * - 条目列表 → 过滤出含 id 的对象
+ * - 解析失败（如 `[]` 与条目混合的多文档）→ 返回空数组（重建）
+ */
+function parsePatchEntries(content, log) {
+    if (!content.trim())
+        return [];
+    try {
+        const parsed = yaml.load(content);
+        if (Array.isArray(parsed)) {
+            return parsed.filter((e) => typeof e === 'object' && e !== null && typeof e.id === 'string');
+        }
+        return [];
+    }
+    catch (err) {
+        log.warn(`cordis.patch.yml 解析失败，将重建: ${err instanceof Error ? err.message : String(err)}`);
+        return [];
+    }
+}
+function printManualInstructions(credentials, log) {
+    log.warn('无法自动保存凭据，请手动设置环境变量:');
+    log.warn(`  export QQBOT_APPID="${credentials.appId}"`);
+    log.warn(`  export QQBOT_SECRET="${credentials.appSecret}"`);
+}
+//# sourceMappingURL=setup.js.map