@zaofan/dsh-qqbot 0.6.0

package/dist/session/types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * 会话管理层类型定义
+ */
+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;
+    /** 宿主实例能力(可选探测): 注入消息不唤醒 agent, 排队到下个 step 组包(事件通知用) */
+    inject?(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;
+    /** setup 收到的 agent ctx(工具自愈用；setup 竞态失败时可能缺) */
+    agentCtx?: unknown;
+    /** 通道工具是否已确认装载(自愈幂等标记) */
+    channelToolsReady?: boolean;
+}
+/** 会话状态信息（/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/session/workspace-attach.d.ts

@@ -0,0 +1,22 @@
+/**
+ * workspace-attach.ts — 把 QQ 会话挂到其 cwd 对应的工作区分组(修复侧边栏归属)
+ *
+ * 移植自上游 PR tencent-connect/dsh-qqbot#21(workspace-attach)。
+ * 问题: Web 侧边栏按工作区成员列表展示会话, 宿主只在客户端 session.create
+ * RPC 路径调用 workspace.attachSession(dsh-host-apiproxy), dsh-workspace 的
+ * "认领遗漏会话"(bootstrap) 仅在首次初始化执行——插件创建的 QQ 会话两条路径
+ * 都不经过 → 不在任何工作区成员列表, 刷新后只能落 Ungrouped(且闲置回收后
+ * 从侧边栏消失的另一主因是宿主帧语义, 见 deepseek-harness#4045, 本文件不处理)。
+ *
+ * 做法: 在 SessionManager.getOrCreate 创建/恢复会话后调用, 把会话挂到其 cwd
+ * 对应的 workspace(registry.create(cwd) 幂等取回 → workspace.attachSession 幂等)。
+ * - 幂等: 创建与恢复路径都安全调用; 老会话在下一次消息恢复时自动补挂。
+ * - 全 fail-soft: workspaceRegistry 未挂载(如 headless)或任何一步失败 →
+ *   静默降级(仅日志), 绝不影响消息处理主链。
+ *
+ * ⚠️ 本地手改功能(fork 新增, 移植上游): 维护清单见工作区根《插件改动维护注意事项.md》。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Logger } from '../types.js';
+export declare function attachSessionToWorkspace(ctx: Context, cwd: string | undefined, sessionId: string, logger: Logger): Promise<void>;
+//# sourceMappingURL=workspace-attach.d.ts.map

package/dist/session/workspace-attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-attach.d.ts","sourceRoot":"","sources":["../../src/session/workspace-attach.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAO1C,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/session/workspace-attach.js

@@ -0,0 +1,21 @@
+export async function attachSessionToWorkspace(ctx, cwd, sessionId, logger) {
+    if (!cwd)
+        return;
+    try {
+        const registry = ctx.get?.('workspaceRegistry');
+        if (!registry?.create) {
+            // workspaceRegistry 未挂载(如 headless profile) → 静默跳过
+            return;
+        }
+        const workspace = await registry.create(cwd);
+        if (workspace?.attachSession) {
+            await workspace.attachSession(sessionId);
+            logger.info(`[workspace-attach] session ${sessionId} → workspace ${cwd}`);
+        }
+    }
+    catch (err) {
+        // fail-soft: 挂载失败绝不影响会话使用; 留 warn 便于主人查(无 workspaceRegistry 时宿主会抛)
+        logger.warn?.(`[workspace-attach] skipped: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=workspace-attach.js.map

package/dist/session/workspace-attach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-attach.js","sourceRoot":"","sources":["../../src/session/workspace-attach.ts"],"names":[],"mappings":"AA0BA,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,GAAY,EACZ,GAAuB,EACvB,SAAiB,EACjB,MAAc;IAEd,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAI,GAA2C,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAsC,CAAC;QAC9H,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;YACtB,mDAAmD;YACnD,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,SAAS,EAAE,aAAa,EAAE,CAAC;YAC7B,MAAM,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,8BAA8B,SAAS,gBAAgB,GAAG,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,mEAAmE;QACnE,MAAM,CAAC,IAAI,EAAE,CAAC,+BAA+B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnG,CAAC;AACH,CAAC"}

package/dist/setup.d.ts

@@ -0,0 +1,25 @@
+/** 凭据结果 */
+export interface SetupCredentials {
+    appId: string;
+    appSecret: string;
+}
+/**
+ * 执行 QR 扫码绑定，获取 QQ Bot 凭据
+ *
+ * 在终端打印二维码等待用户扫码；同时输出扫码 URL，
+ * 供二维码因系统字符问题渲染错位时点击/复制到浏览器打开扫码。
+ */
+export declare function runQrSetup(source?: string): Promise<SetupCredentials | null>;
+/**
+ * 将凭据写入 dsh profile 的 cordis.patch.yml
+ *
+ * 行级编辑(不再整文件 YAML 解析)——cordis.patch.yml 常含宿主 `!!js` 自定义标签,
+ * js-yaml 无法解析会抛错导致自动保存失败(实测线上文件即因此走到手动引导)。
+ * 只定位/更新顶层 `- id: im-qqbot` 条目块中的 appId/appSecret 行,
+ * 文件其它内容(含 !!js、其它实例、insert 包装)原样保留。文件不存在时安全重建。
+ */
+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;AAOD;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,MAAM,SAAc,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAyDvF;AAED;;;;;;;GAOG;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,CA2FT"}

package/dist/setup.js

@@ -0,0 +1,198 @@
+/**
+ * QQ Bot 凭据初始化 — 扫码绑定
+ *
+ * 当 appId/appSecret 未配置时，通过 @tencent-connect/qqbot-connector
+ * 唤起终端扫码流程获取凭据，并写入 dsh profile 配置。
+ */
+import { resolve } from 'node:path';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { startQrConnect } from '@tencent-connect/qqbot-connector';
+/** 终端可点击的 OSC 8 超链接（不支持 OSC 8 的终端会忽略控制序列，退化为纯 URL 文本） */
+function clickableLink(url) {
+    return `\u001b]8;;${url}\u001b\\${url}\u001b]8;;\u001b\\`;
+}
+/**
+ * 执行 QR 扫码绑定，获取 QQ Bot 凭据
+ *
+ * 在终端打印二维码等待用户扫码；同时输出扫码 URL，
+ * 供二维码因系统字符问题渲染错位时点击/复制到浏览器打开扫码。
+ */
+export async function runQrSetup(source = 'dsh-qqbot') {
+    console.log('\n══════════════════════════════════════════════════════');
+    console.log('  QQ Bot 凭据未配置，启动扫码绑定');
+    console.log('══════════════════════════════════════════════════════\n');
+    try {
+        console.log('请使用手机 QQ 扫描下方二维码完成绑定...\n');
+        // 回调风格：onQrDisplayed 会在二维码打印后、轮询开始前回调扫码 URL，
+        // 让用户在二维码错位时也能通过链接打开扫码页（二维码过期刷新会再次触发）。
+        const credentials = await new Promise((resolve, reject) => {
+            startQrConnect({
+                onSuccess: resolve,
+                onFailure: reject,
+                onQrDisplayed: (url) => {
+                    console.log('二维码显示异常？点击下方链接，用浏览器打开即可完成扫码:');
+                    console.log(`  ${clickableLink(url)}\n`);
+                },
+                onQrExpired: () => {
+                    console.log('二维码已过期，正在刷新…\n');
+                },
+            }, { 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
+ *
+ * 行级编辑(不再整文件 YAML 解析)——cordis.patch.yml 常含宿主 `!!js` 自定义标签,
+ * js-yaml 无法解析会抛错导致自动保存失败(实测线上文件即因此走到手动引导)。
+ * 只定位/更新顶层 `- id: im-qqbot` 条目块中的 appId/appSecret 行,
+ * 文件其它内容(含 !!js、其它实例、insert 包装)原样保留。文件不存在时安全重建。
+ */
+export function persistCredentialsToProfile(credentials, profileDir, logger) {
+    const log = logger ?? console;
+    const dir = profileDir;
+    if (!dir) {
+        // 开发模式：插件从源码加载、不在 node_modules 下，无法定位 profile 目录
+        printEnvInstructions(credentials);
+        return false;
+    }
+    const patchPath = resolve(dir, 'cordis.patch.yml');
+    try {
+        // 1. 读原文(可能含 !!js 等宿主标签, 绝不做整文件 YAML 解析)
+        let text = '';
+        if (existsSync(patchPath))
+            text = readFileSync(patchPath, 'utf8');
+        const eol = text.includes('\r\n') ? '\r\n' : '\n';
+        const lines = text.length ? text.split(/\r\n|\n/) : [];
+        const yq = (v) => {
+            // YAML 值引号化: 纯安全字符可不加引号; 否则单引号包裹(内部单引号翻倍)
+            return /^[A-Za-z0-9_./:\-]+$/.test(v) ? v : `'${v.replace(/'/g, "''")}'`;
+        };
+        // 顶层条目行 "- id: im-qqbot"(允许引号包裹的 id)
+        const HEAD_RE = /^-\s*id:\s*['"]?im-qqbot['"]?\s*$/;
+        const headIdx = lines.findIndex((l) => HEAD_RE.test(l));
+        let outLines;
+        if (headIdx >= 0) {
+            // 2a. 已有 im-qqbot 顶层块: 块结束 = 下一个"顶格 - "条目行(或文件尾)
+            let blockEnd = lines.length;
+            for (let i = headIdx + 1; i < lines.length; i++) {
+                const li = lines[i];
+                if (/^\s*-\s/.test(li) && !/^\s+/.test(li)) {
+                    blockEnd = i;
+                    break;
+                }
+            }
+            const block = lines.slice(headIdx, blockEnd);
+            // config 字段缩进: 找块内 `config:` 行缩进; 默认 2
+            let cfgIndent = 2;
+            const cfgLine = block.findIndex((l) => /^\s*config:\s*$/.test(l));
+            if (cfgLine >= 0) {
+                cfgIndent = (block[cfgLine].match(/^\s*/) ?? [''])[0].length;
+            }
+            const valIndent = cfgIndent + 2;
+            const upsertKey = (key, value, arr) => {
+                const re = new RegExp(`^(\\s*)${key}:\\s*.*$`);
+                const hit = arr.findIndex((l) => re.test(l));
+                if (hit >= 0) {
+                    const indent = (arr[hit].match(/^\s*/) ?? [''])[0];
+                    arr[hit] = `${indent}${key}: ${yq(value)}`;
+                    return arr;
+                }
+                // 无该键: config: 行后插入; 无 config: 则在 id 行后补 config + 键
+                const insertAt = cfgLine >= 0 ? cfgLine + 1 : 1;
+                const pad = ' '.repeat(valIndent);
+                if (cfgLine < 0) {
+                    arr.splice(1, 0, ' '.repeat(cfgIndent) + 'config:', `${pad}${key}: ${yq(value)}`);
+                }
+                else {
+                    // 找同 key 族(appId 先于 appSecret 落位; 插入到已有 appId/其它 config 键之前保持整洁)
+                    arr.splice(insertAt, 0, `${pad}${key}: ${yq(value)}`);
+                }
+                return arr;
+            };
+            const nb = upsertKey('appId', credentials.appId, block.slice());
+            upsertKey('appSecret', credentials.appSecret, nb);
+            outLines = lines.slice(0, headIdx).concat(nb, lines.slice(blockEnd));
+        }
+        else {
+            // 2b. 没有 im-qqbot 顶层块: 文件末尾追加新条目(顶格 "- id:" 形态; 保留原有内容)
+            const tail = lines.slice();
+            while (tail.length > 0 && tail[tail.length - 1] === '')
+                tail.pop();
+            outLines = tail.concat([
+                '',
+                '# QQ Bot 凭据（扫码绑定自动生成）',
+                '- id: im-qqbot',
+                '  config:',
+                `    appId: ${yq(credentials.appId)}`,
+                `    appSecret: ${yq(credentials.appSecret)}`,
+            ]);
+        }
+        mkdirSync(dir, { recursive: true });
+        const finalText = (outLines.join(eol)).replace(/\n{3,}/g, '\n\n').trimEnd() + eol;
+        writeFileSync(patchPath, finalText, 'utf8');
+        log.info(`✔ 凭据已写入: ${patchPath}`);
+        log.info(`  下次启动将自动使用保存的凭据`);
+        return true;
+    }
+    catch (err) {
+        log.warn(`写入配置失败: ${err instanceof Error ? err.message : String(err)}`);
+        printYamlInstructions(credentials, patchPath);
+        return false;
+    }
+}
+/** 开发模式引导：未定位到 profile 目录，引导用环境变量配置（console.log 确保可见） */
+function printEnvInstructions(credentials) {
+    console.log('未检测到 profile 目录（开发模式），请通过环境变量配置凭据:');
+    if (process.platform === 'win32') {
+        // CMD 语法
+        console.log(`  set QQBOT_APPID=${credentials.appId}`);
+        console.log(`  set QQBOT_SECRET=${credentials.appSecret}`);
+        // PowerShell 语法（dsh 默认 shell 是 pwsh）
+        console.log('PowerShell 用户请用:');
+        console.log(`  $env:QQBOT_APPID="${credentials.appId}"`);
+        console.log(`  $env:QQBOT_SECRET="${credentials.appSecret}"`);
+    }
+    else {
+        console.log(`  export QQBOT_APPID="${credentials.appId}"`);
+        console.log(`  export QQBOT_SECRET="${credentials.appSecret}"`);
+    }
+}
+/** 正式安装引导：自动写入失败，引导手动在 cordis.patch.yml 配置（console.log 确保可见） */
+function printYamlInstructions(credentials, patchPath) {
+    console.log('无法自动保存凭据，请手动打开以下文件添加配置:');
+    console.log(`  ${patchPath}`);
+    console.log('');
+    console.log('  - id: im-qqbot');
+    console.log('    config:');
+    console.log(`      appId: "${credentials.appId}"`);
+    console.log(`      appSecret: "${credentials.appSecret}"`);
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/shared/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 共享工具层
+ */
+export { getProfileDir, resolveEnv, formatRelativeTime, buildUserAgent } from './utils.js';
+export { getScopePeer } from './scope.js';
+export { sendMarkdownChunked } from './send-helper.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/shared/index.js

@@ -0,0 +1,7 @@
+/**
+ * 共享工具层
+ */
+export { getProfileDir, resolveEnv, formatRelativeTime, buildUserAgent } from './utils.js';
+export { getScopePeer } from './scope.js';
+export { sendMarkdownChunked } from './send-helper.js';
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/shared/scope.d.ts

@@ -0,0 +1,14 @@
+/**
+ * scope 提取工具
+ *
+ * 从 SDK 命令上下文中提取 scope + peerId。
+ */
+import type { SlashCommandHandlerContext } from '@tencent-connect/qqbot-nodejs';
+/**
+ * 从命令上下文提取 scope + peerId
+ */
+export declare function getScopePeer(cmdCtx: SlashCommandHandlerContext): {
+    scope: 'c2c' | 'group';
+    peerId: string;
+};
+//# sourceMappingURL=scope.d.ts.map

package/dist/shared/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/shared/scope.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAEhF;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,0BAA0B,GAAG;IAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAO3G"}

package/dist/shared/scope.js

@@ -0,0 +1,12 @@
+/**
+ * 从命令上下文提取 scope + peerId
+ */
+export function getScopePeer(cmdCtx) {
+    const msg = cmdCtx.message;
+    const scope = msg.kind === 'group' ? 'group' : 'c2c';
+    const peerId = scope === 'group'
+        ? (msg.groupOpenid ?? msg.senderId)
+        : msg.senderId;
+    return { scope, peerId };
+}
+//# sourceMappingURL=scope.js.map

package/dist/shared/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../../src/shared/scope.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAkC;IAC7D,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC;IAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IACrD,MAAM,MAAM,GAAG,KAAK,KAAK,OAAO;QAC9B,CAAC,CAAC,CAAE,GAA0C,CAAC,WAAqB,IAAI,GAAG,CAAC,QAAQ,CAAC;QACrF,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;IACjB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC"}

package/dist/shared/send-helper.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 分块发送 markdown 工具
+ *
+ * 长内容自动按 QQ 消息限制切分后逐条发送。
+ */
+import type { SlashCommandHandlerContext } from '@tencent-connect/qqbot-nodejs';
+/**
+ * 分块发送 markdown（长内容自动切分）
+ */
+export declare function sendMarkdownChunked(cmdCtx: SlashCommandHandlerContext, content: string, chunkLimit: number): Promise<void>;
+//# sourceMappingURL=send-helper.d.ts.map

package/dist/shared/send-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-helper.d.ts","sourceRoot":"","sources":["../../src/shared/send-helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAGhF;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,0BAA0B,EAClC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/shared/send-helper.js

@@ -0,0 +1,13 @@
+import { chunkMarkdownText } from '../transport/chunker.js';
+/**
+ * 分块发送 markdown（长内容自动切分）
+ */
+export async function sendMarkdownChunked(cmdCtx, content, chunkLimit) {
+    const bot = cmdCtx.bot;
+    const replyTarget = cmdCtx.replyTarget;
+    const chunks = chunkMarkdownText(content, chunkLimit);
+    for (const chunk of chunks) {
+        await bot.sendMarkdown(replyTarget, chunk);
+    }
+}
+//# sourceMappingURL=send-helper.js.map

package/dist/shared/send-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-helper.js","sourceRoot":"","sources":["../../src/shared/send-helper.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAkC,EAClC,OAAe,EACf,UAAkB;IAElB,MAAM,GAAG,GAAI,MAA6C,CAAC,GAA2E,CAAC;IACvI,MAAM,WAAW,GAAI,MAA6C,CAAC,WAAW,CAAC;IAC/E,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACtD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/shared/utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 构造 User-Agent 头
+ *
+ * 格式: dsh-qqbot/{version} (Node/{nodeVersion}; {platform})
+ */
+export declare function buildUserAgent(): string;
+/**
+ * 定位当前 dsh profile 目录（装本插件的那个 profile 根，如 …/profiles/web）
+ *
+ * 探测链（前两级对 pnpm link:/symlink/isolated 等任意安装形态都可靠，不依赖代码文件位置）：
+ *   0) 环境变量 QQBOT_PROFILE_DIR 显式指定（安装脚本/高级用户）；
+ *   1) 宿主扫描：遍历 ~/.dsh/profiles/<name>，找到「装着本插件」的 profile
+ *      （node_modules/<scope>/<name> 存在，或 package.json 的 bundles/dependencies 提及本包名）；
+ *   2) 兜底：从代码安装路径逐级向上找名为 node_modules 的目录并返回其父目录
+ *      （仅实体安装/hoisted 布局有效）。
+ *
+ * @param baseDir - 起始目录，缺省为插件根（可注入便于测试）
+ */
+export declare function getProfileDir(baseDir?: string): string | null;
+/**
+ * 解析环境变量占位配置
+ */
+export declare function resolveEnv(configValue: string, envKey: string): string;
+/**
+ * 格式化相对时间
+ */
+export declare function formatRelativeTime(ts?: number): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/shared/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAuCA;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAoB,GAAG,MAAM,GAAG,IAAI,CAkB1E;AAyCD;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOtD"}