@zaofan/dsh-qqbot 0.6.0

package/dist/model/model-resolver.js

@@ -0,0 +1,151 @@
+import { PrefsStore } from './prefs-store.js';
+import { SettingsReader } from './settings-reader.js';
+export class ModelResolver {
+    ctx;
+    config;
+    logger;
+    prefs;
+    settings;
+    constructor(ctx, config, logger) {
+        this.ctx = ctx;
+        this.config = config;
+        this.logger = logger;
+        this.prefs = new PrefsStore(config.debug ? (msg) => this.logger?.debug(msg) : undefined);
+        this.settings = new SettingsReader();
+    }
+    /**
+     * 获取指定 sessionKey 的有效模型路由（create 用）
+     *
+     * 优先级：per-peer 偏好 > config 显式指定 > settings.yaml > 宿主服务
+     */
+    getEffectiveRoute(sessionKey) {
+        return this.prefs.getOverride(sessionKey) ?? this.resolveDefault();
+    }
+    /**
+     * 获取 resume 时覆盖 session 的模型路由
+     *
+     * 优先级：per-peer 偏好 > cordis.yml 显式配置 > 默认链（settings.yaml > host）
+     *
+     * 注意：不能像 dsh-TUI 那样返回 undefined 让 session 沿用 requestHeader。
+     * dsh-TUI 靠 installModelSelection 从 session.requestHeader 恢复 {{model}}，
+     * 而我们未装 installModelSelection，system-prompt 的 {{model}} 变量直接读
+     * agent.options.model（agent-loop index.ts:352）——若无值会抛
+     * "prompt variable {{model}} has no value for this assembly"。
+     * 因此这里兜底到默认链，确保 agent.options.model 始终有值。
+     */
+    getResumeRoute(sessionKey) {
+        const override = this.prefs.getOverride(sessionKey);
+        if (override)
+            return override;
+        if (this.config.provider && this.config.model) {
+            return { provider: this.config.provider, model: this.config.model };
+        }
+        return this.resolveDefault();
+    }
+    /**
+     * 设置 per-peer 模型偏好并持久化到隔离文件
+     */
+    setOverride(sessionKey, route) {
+        this.prefs.setOverride(sessionKey, route);
+    }
+    /**
+     * 清除 per-peer 模型偏好并持久化
+     */
+    clearOverride(sessionKey) {
+        this.prefs.clearOverride(sessionKey);
+    }
+    /**
+     * 是否存在指定 session 的模型偏好
+     */
+    hasOverride(sessionKey) {
+        return this.prefs.hasOverride(sessionKey);
+    }
+    /**
+     * 获取指定 sessionKey 的最新 sessionId（fork 后记录，重启恢复用）
+     */
+    getSessionId(sessionKey) {
+        return this.prefs.getSessionId(sessionKey);
+    }
+    /**
+     * 记录指定 sessionKey 的最新 sessionId（fork 后调用）并持久化
+     */
+    setSessionId(sessionKey, sessionId) {
+        this.prefs.setSessionId(sessionKey, sessionId);
+    }
+    /**
+     * 清除指定 sessionKey 的 sessionId 记录
+     */
+    clearSessionId(sessionKey) {
+        this.prefs.clearSessionId(sessionKey);
+    }
+    /**
+     * 解析默认模型路由（不含 per-peer 偏好）
+     *
+     * 优先级：config 显式指定 > settings.yaml（只读） > 宿主 agentDefaultModel
+     * 最终兜底 deepseek-official/deepseek-v4-flash，确保 {{model}} 变量始终有值。
+     */
+    resolveDefault() {
+        if (this.config.provider && this.config.model) {
+            return { provider: this.config.provider, model: this.config.model };
+        }
+        const fromSettings = this.settings.readDefaultRoute();
+        if (fromSettings)
+            return fromSettings;
+        const fromHost = this.readFromHost();
+        if (fromHost)
+            return fromHost;
+        return { provider: 'deepseek-official', model: 'deepseek-v4-flash' };
+    }
+    /**
+     * 列出所有可用模型
+     */
+    listModels() {
+        return this.settings.readModels();
+    }
+    /**
+     * 列出可用 provider 名称
+     */
+    listProviders() {
+        try {
+            const llm = this.getService('llm');
+            if (llm && typeof llm.listProviders === 'function') {
+                const providers = llm.listProviders();
+                if (providers.length > 0) {
+                    const first = providers[0];
+                    if (typeof first === 'string')
+                        return providers;
+                    return providers.map((p) => p.id);
+                }
+            }
+        }
+        catch {
+            // 忽略
+        }
+        return this.settings.readProviders();
+    }
+    // ── 私有方法 ──
+    readFromHost() {
+        try {
+            const agentDefaultModel = this.getService('agentDefaultModel');
+            if (agentDefaultModel && typeof agentDefaultModel.currentSelection === 'function') {
+                const selection = agentDefaultModel.currentSelection();
+                if (selection?.provider && selection?.model) {
+                    return { provider: selection.provider, model: selection.model };
+                }
+            }
+        }
+        catch (err) {
+            if (this.config.debug) {
+                this.logger?.debug(`ModelResolver: host service failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        return undefined;
+    }
+    /** 统一的 Cordis 服务访问 */
+    getService(name) {
+        const ctxAny = this.ctx;
+        return ctxAny[name] ??
+            (typeof ctxAny.get === 'function' ? ctxAny.get(name) : undefined);
+    }
+}
+//# sourceMappingURL=model-resolver.js.map

package/dist/model/model-resolver.js.map

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

package/dist/model/prefs-store.d.ts

@@ -0,0 +1,24 @@
+import type { ModelRoute } from './types.js';
+/** 日志回调（可选） */
+type DebugFn = (msg: string) => void;
+export declare class PrefsStore {
+    /** per-peer 模型偏好（内存态） */
+    private overrides;
+    /** per-peer 最新 sessionId（fork 后更新，内存态） */
+    private sessionIds;
+    /** 隔离偏好文件路径 */
+    private readonly prefsPath;
+    private readonly debugLog?;
+    constructor(debugLog?: DebugFn);
+    getOverride(sessionKey: string): ModelRoute | undefined;
+    setOverride(sessionKey: string, route: ModelRoute): void;
+    clearOverride(sessionKey: string): boolean;
+    hasOverride(sessionKey: string): boolean;
+    getSessionId(sessionKey: string): string | undefined;
+    setSessionId(sessionKey: string, sessionId: string): void;
+    clearSessionId(sessionKey: string): boolean;
+    private load;
+    private write;
+}
+export {};
+//# sourceMappingURL=prefs-store.d.ts.map

package/dist/model/prefs-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefs-store.d.ts","sourceRoot":"","sources":["../../src/model/prefs-store.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAe;AACf,KAAK,OAAO,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AASrC,qBAAa,UAAU;IACrB,yBAAyB;IACzB,OAAO,CAAC,SAAS,CAAiC;IAClD,0CAA0C;IAC1C,OAAO,CAAC,UAAU,CAA6B;IAC/C,eAAe;IACf,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAU;gBAExB,QAAQ,CAAC,EAAE,OAAO;IAQ9B,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIvD,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAKxD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAM1C,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAMxC,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIpD,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKzD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAQ3C,OAAO,CAAC,IAAI;IAmCZ,OAAO,CAAC,KAAK;CAwBd"}

package/dist/model/prefs-store.js

@@ -0,0 +1,126 @@
+/**
+ * PrefsStore — per-peer 模型偏好持久化
+ *
+ * 隔离文件 I/O 操作，便于单元测试时 mock。
+ * 存储路径：~/.dsh-qqbot/model-prefs.json
+ *
+ * 2026-09-06 移植上游 tencent-connect/dsh-qqbot PR #41:
+ *   - 写入改原子(先写 .tmp 再 renameSync 覆盖, 同卷 rename 由 OS 保证原子,
+ *     避免写盘瞬间被 kill 留下半截 JSON);
+ *   - load 解析失败不再静默吞掉: 损坏文件改名 .corrupt-<ts> 保留取证, 空偏好继续。
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, renameSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { homedir } from 'node:os';
+export class PrefsStore {
+    /** per-peer 模型偏好（内存态） */
+    overrides = new Map();
+    /** per-peer 最新 sessionId（fork 后更新，内存态） */
+    sessionIds = new Map();
+    /** 隔离偏好文件路径 */
+    prefsPath;
+    debugLog;
+    constructor(debugLog) {
+        this.prefsPath = resolve(homedir(), '.dsh-qqbot', 'model-prefs.json');
+        this.debugLog = debugLog;
+        this.load();
+    }
+    // ── Override 操作 ──
+    getOverride(sessionKey) {
+        return this.overrides.get(sessionKey);
+    }
+    setOverride(sessionKey, route) {
+        this.overrides.set(sessionKey, route);
+        this.write();
+    }
+    clearOverride(sessionKey) {
+        const deleted = this.overrides.delete(sessionKey);
+        if (deleted)
+            this.write();
+        return deleted;
+    }
+    hasOverride(sessionKey) {
+        return this.overrides.has(sessionKey);
+    }
+    // ── SessionId 操作 ──
+    getSessionId(sessionKey) {
+        return this.sessionIds.get(sessionKey);
+    }
+    setSessionId(sessionKey, sessionId) {
+        this.sessionIds.set(sessionKey, sessionId);
+        this.write();
+    }
+    clearSessionId(sessionKey) {
+        const deleted = this.sessionIds.delete(sessionKey);
+        if (deleted)
+            this.write();
+        return deleted;
+    }
+    // ── 私有方法 ──
+    load() {
+        try {
+            if (!existsSync(this.prefsPath))
+                return;
+            const content = readFileSync(this.prefsPath, 'utf8');
+            const data = JSON.parse(content);
+            if (data.overrides && typeof data.overrides === 'object') {
+                for (const [key, route] of Object.entries(data.overrides)) {
+                    if (route.provider && route.model) {
+                        this.overrides.set(key, { provider: route.provider, model: route.model });
+                    }
+                }
+            }
+            if (data.sessionIds && typeof data.sessionIds === 'object') {
+                for (const [key, sessionId] of Object.entries(data.sessionIds)) {
+                    if (typeof sessionId === 'string' && sessionId) {
+                        this.sessionIds.set(key, sessionId);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            // 2026-09-06 (PR #41): 解析失败不静默 —— 损坏文件改名 .corrupt-<ts> 保留取证, 空偏好继续。
+            // 旧行为只在 debug 时打一行日志然后以空偏好继续, 坏文件会被下次 write 覆盖, 无法事后排查。
+            this.debugLog?.(`loadPrefs failed: ${err instanceof Error ? err.message : String(err)}`);
+            try {
+                if (existsSync(this.prefsPath)) {
+                    const quarantine = `${this.prefsPath}.corrupt-${Date.now()}`;
+                    renameSync(this.prefsPath, quarantine);
+                    this.debugLog?.(`prefs 文件损坏, 已隔离到 ${quarantine} 保留取证`);
+                }
+            }
+            catch (qErr) {
+                this.debugLog?.(`prefs 损坏文件隔离失败: ${qErr instanceof Error ? qErr.message : String(qErr)}`);
+            }
+        }
+    }
+    write() {
+        try {
+            mkdirSync(dirname(this.prefsPath), { recursive: true });
+            const data = {
+                overrides: Object.fromEntries(this.overrides.entries()),
+                sessionIds: Object.fromEntries(this.sessionIds.entries()),
+            };
+            // 2026-09-06 (PR #41): 原子写入 —— 先写 .tmp 再 renameSync 覆盖(同卷 rename 原子, OS 保证)。
+            // 旧行为 writeFileSync 就地全量覆盖, 写盘瞬间进程被 kill → 留下半截 JSON, 下次 load 静默重置。
+            const tmpPath = `${this.prefsPath}.tmp`;
+            writeFileSync(tmpPath, JSON.stringify(data, null, 2), 'utf8');
+            try {
+                renameSync(tmpPath, this.prefsPath);
+            }
+            catch (renameErr) {
+                // 极端情况下 rename 失败(如目标被占用): 清掉 tmp 残留, 避免堆积
+                try {
+                    if (existsSync(tmpPath))
+                        renameSync(tmpPath, `${this.prefsPath}.stale-${Date.now()}`);
+                }
+                catch { /* ignore */ }
+                throw renameErr;
+            }
+        }
+        catch (err) {
+            this.debugLog?.(`writePrefs failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+//# sourceMappingURL=prefs-store.js.map

package/dist/model/prefs-store.js.map

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

package/dist/model/settings-reader.d.ts

@@ -0,0 +1,19 @@
+import type { ModelRoute, ModelEntry } from './types.js';
+export declare class SettingsReader {
+    /** settings.yaml 缓存 */
+    private settingsCache;
+    /**
+     * 从 settings.yaml 的 agent-default-model 字段读取默认模型路由
+     */
+    readDefaultRoute(): ModelRoute | undefined;
+    /**
+     * 列出 settings.yaml 中配置的所有模型
+     */
+    readModels(): ModelEntry[];
+    /**
+     * 列出 settings.yaml 中配置的 provider 名称
+     */
+    readProviders(): string[];
+    private loadSettings;
+}
+//# sourceMappingURL=settings-reader.d.ts.map

package/dist/model/settings-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-reader.d.ts","sourceRoot":"","sources":["../../src/model/settings-reader.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAazD,qBAAa,cAAc;IACzB,uBAAuB;IACvB,OAAO,CAAC,aAAa,CAA6C;IAElE;;OAEG;IACH,gBAAgB,IAAI,UAAU,GAAG,SAAS;IAc1C;;OAEG;IACH,UAAU,IAAI,UAAU,EAAE;IAsB1B;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAMzB,OAAO,CAAC,YAAY;CAiBrB"}

package/dist/model/settings-reader.js

@@ -0,0 +1,76 @@
+/**
+ * SettingsReader — settings.yaml 只读解析
+ *
+ * 从 ~/.dsh/settings.yaml 中读取模型配置信息。
+ * 只读，不修改 settings.yaml。
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { homedir } from 'node:os';
+import yaml from 'js-yaml';
+export class SettingsReader {
+    /** settings.yaml 缓存 */
+    settingsCache;
+    /**
+     * 从 settings.yaml 的 agent-default-model 字段读取默认模型路由
+     */
+    readDefaultRoute() {
+        const settings = this.loadSettings();
+        if (!settings)
+            return undefined;
+        const defaultModel = settings['agent-default-model'];
+        if (defaultModel?.provider && defaultModel?.model) {
+            return { provider: defaultModel.provider, model: defaultModel.model };
+        }
+        return undefined;
+    }
+    /**
+     * 列出 settings.yaml 中配置的所有模型
+     */
+    readModels() {
+        const settings = this.loadSettings();
+        if (!settings)
+            return [];
+        const models = [];
+        const llmPiAi = settings['llm-pi-ai'];
+        if (llmPiAi?.providers) {
+            for (const [providerName, providerConfig] of Object.entries(llmPiAi.providers)) {
+                if (Array.isArray(providerConfig?.models)) {
+                    for (const m of providerConfig.models) {
+                        if (m.id) {
+                            models.push({ provider: providerName, id: m.id, name: m.name || undefined });
+                        }
+                    }
+                }
+            }
+        }
+        return models;
+    }
+    /**
+     * 列出 settings.yaml 中配置的 provider 名称
+     */
+    readProviders() {
+        const settings = this.loadSettings();
+        const llmPiAi = settings?.['llm-pi-ai'];
+        return llmPiAi?.providers ? Object.keys(llmPiAi.providers) : [];
+    }
+    loadSettings() {
+        if (this.settingsCache !== undefined)
+            return this.settingsCache;
+        try {
+            const settingsPath = resolve(homedir(), '.dsh', 'settings.yaml');
+            if (!existsSync(settingsPath)) {
+                this.settingsCache = null;
+                return null;
+            }
+            const content = readFileSync(settingsPath, 'utf8');
+            this.settingsCache = yaml.load(content);
+            return this.settingsCache;
+        }
+        catch {
+            this.settingsCache = null;
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=settings-reader.js.map

package/dist/model/settings-reader.js.map

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

package/dist/model/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 模型路由层类型定义
+ */
+/** 模型路由 */
+export interface ModelRoute {
+    provider: string;
+    model: string;
+}
+/** 模型信息条目 */
+export interface ModelEntry {
+    provider: string;
+    id: string;
+    name?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/model/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,WAAW;AACX,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,aAAa;AACb,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/model/types.js

@@ -0,0 +1,5 @@
+/**
+ * 模型路由层类型定义
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/model/types.js.map

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

package/dist/session/idle-evictor.d.ts

@@ -0,0 +1,18 @@
+/**
+ * IdleEvictor — 闲置会话回收器
+ *
+ * 定期检查会话最后活跃时间，超时则自动回收释放资源。
+ */
+import type { SessionRecord } from './types.js';
+export declare class IdleEvictor {
+    private readonly sessions;
+    private readonly timeoutMs;
+    private readonly onEvict;
+    private timer;
+    constructor(sessions: Map<string, SessionRecord>, timeoutMs: number, onEvict: (key: string, record: SessionRecord) => void);
+    /** 执行一轮回收检查 */
+    check(): void;
+    /** 停止回收定时器 */
+    dispose(): void;
+}
+//# sourceMappingURL=idle-evictor.d.ts.map

package/dist/session/idle-evictor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-evictor.d.ts","sourceRoot":"","sources":["../../src/session/idle-evictor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,KAAK,CAA+C;gBAGzC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,KAAK,IAAI;IAOxE,eAAe;IACf,KAAK,IAAI,IAAI;IASb,cAAc;IACd,OAAO,IAAI,IAAI;CAMhB"}

package/dist/session/idle-evictor.js

@@ -0,0 +1,31 @@
+export class IdleEvictor {
+    sessions;
+    timeoutMs;
+    onEvict;
+    timer = null;
+    constructor(sessions, timeoutMs, onEvict) {
+        this.sessions = sessions;
+        this.timeoutMs = timeoutMs;
+        this.onEvict = onEvict;
+        if (timeoutMs > 0) {
+            this.timer = setInterval(() => this.check(), 60_000);
+        }
+    }
+    /** 执行一轮回收检查 */
+    check() {
+        const now = Date.now();
+        for (const [key, record] of this.sessions) {
+            if (now - record.lastActivity > this.timeoutMs) {
+                this.onEvict(key, record);
+            }
+        }
+    }
+    /** 停止回收定时器 */
+    dispose() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+}
+//# sourceMappingURL=idle-evictor.js.map

package/dist/session/idle-evictor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-evictor.js","sourceRoot":"","sources":["../../src/session/idle-evictor.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,WAAW;IAIH;IACA;IACA;IALX,KAAK,GAA0C,IAAI,CAAC;IAE5D,YACmB,QAAoC,EACpC,SAAiB,EACjB,OAAqD;QAFrD,aAAQ,GAAR,QAAQ,CAA4B;QACpC,cAAS,GAAT,SAAS,CAAQ;QACjB,YAAO,GAAP,OAAO,CAA8C;QAEtE,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,eAAe;IACf,KAAK;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1C,IAAI,GAAG,GAAG,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC/C,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,cAAc;IACd,OAAO;QACL,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;CACF"}

package/dist/session/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 会话管理层
+ *
+ * 管理 QQ peer → dsh Agent 的映射和生命周期。
+ */
+export { SessionManager } from './session-manager.js';
+export { IdleEvictor } from './idle-evictor.js';
+export type { AgentSetup, SessionEventLike, DshAgent, DshAgentHandle, SessionsService, DshAgentRegistry, AgentPresetsLike, PresetComposition, SessionRecord, SessionStatus, TokenUsageStats, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/session/index.js

@@ -0,0 +1,8 @@
+/**
+ * 会话管理层
+ *
+ * 管理 QQ peer → dsh Agent 的映射和生命周期。
+ */
+export { SessionManager } from './session-manager.js';
+export { IdleEvictor } from './idle-evictor.js';
+//# sourceMappingURL=index.js.map

package/dist/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/session/session-manager.d.ts

@@ -0,0 +1,97 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { ChatScope, Logger, ReplyTarget } from '../types.js';
+import type { ImQQBotConfig } from '../config.js';
+import type { ModelRoute, ModelEntry } from '../model/types.js';
+import type { DshAgent, DshAgentRegistry, SessionRecord, SessionStatus, TokenUsageStats } from './types.js';
+import type { QQBotSender } from '../transport/outbound-buffer.js';
+import { createGroupAdmin } from '../api/group-admin.js';
+export declare class SessionManager {
+    private readonly ctx;
+    private readonly agents;
+    private readonly config;
+    private readonly logger;
+    private sessions;
+    private readonly evictor;
+    private readonly modelResolver;
+    /** QQ 通道发送能力(由 bootstrap 注入)；仅作为 qqChannel service 暴露给通道工具，不在此注册工具 */
+    private channelSender;
+    /** 最近一次 setup 收到的 agent ctx(工具自愈用；getOrCreate 完成后读走并清空) */
+    private lastSetupCtx;
+    /** 注入 QQ 通道发送能力(供通道工具)；bootstrap 调用 */
+    installChannelSender(sender: QQBotSender): void;
+    /** 本实例图库目录(多账号: 每实例 cwd 独立; config.sticker.dataDir 可覆盖) */
+    get stickerDataDir(): string;
+    /** 本实例定时任务目录(多账号: 每实例 cwd 独立) */
+    get scheduleDataDir(): string;
+    /** 本实例群管理客户端(懒建; groupAdmin.enabled=false 时 undefined) */
+    get groupAdmin(): ReturnType<typeof createGroupAdmin> | undefined;
+    private _groupAdmin?;
+    /** 对话内默认管理群(web/非群会话时群工具用它; 空=未配置) */
+    get manageGroup(): string;
+    constructor(ctx: Context, agents: DshAgentRegistry, config: ImQQBotConfig, logger: Logger);
+    /**
+     * 动态获取 sessions 服务（fork 能力，可选）
+     */
+    private getSessionsService;
+    getEffectiveModel(scope: ChatScope, peerId: string): ModelRoute | undefined;
+    /**
+     * 切换模型（fork + 重建，对齐 dsh-TUI 的 switchModel）
+     */
+    setModelOverride(scope: ChatScope, peerId: string, route: ModelRoute): Promise<void>;
+    clearModelOverride(scope: ChatScope, peerId: string): void;
+    listAvailableModels(): ModelEntry[];
+    listProviders(): string[];
+    getSessionRecord(scope: ChatScope, peerId: string): SessionRecord | undefined;
+    getStatus(scope: ChatScope, peerId: string): SessionStatus;
+    getTokenUsage(scope: ChatScope, peerId: string): TokenUsageStats;
+    exportMarkdown(scope: ChatScope, peerId: string): string;
+    private countMessages;
+    private sessionKey;
+    private deriveSessionId;
+    private currentSessionId;
+    private composePreset;
+    /** 获取或恢复或创建会话（get → resume → create） */
+    getOrCreate(scope: ChatScope, peerId: string, senderId: string, replyTarget: ReplyTarget): Promise<SessionRecord>;
+    /**
+     * 通道工具自愈 + 固化(2026-09-05 升级): 每次消息都全量幂等注册 channel-tools(静态 import,
+     * 进程加载的就是最新 dist) → 重启后"恢复"会话的第一条消息也会自动把 reply_gate 等正式工具
+     * 全部注册上,**工具永久固化, 重启不再需要 /tools-reload**(热刷只留给进程内"新增"工具的即时生效)。
+     * 已注册工具重复注册会被 channel-tools 内部静默跳过(already registered), 无副作用无噪音。
+     */
+    ensureChannelTools(record: SessionRecord): Promise<void>;
+    /**
+     * 工具热刷新(2026-09-05, 主人定 A 方案): cache-bust 动态重载最新 dist 的 channel-tools
+     * 并注册到给定 agentCtx。DSH 工具表每步现收集 → 新工具**下一轮立即对 LLM 可见**, 无需重启宿主。
+     * 说明: 新增工具即时生效; 与已有工具同名的注册会被 channel-tools 内部 try/catch 跳过(保留旧实现),
+     *       想更新已有工具逻辑仍需正式重启(或临时换新工具名)。
+     */
+    /**
+     * qqChannel 上下文自愈(2026-09-05): 重启后"恢复"的会话不跑 setup → agent.ctx 上没有
+     * qqChannel → 通道工具路由不到本实例(channelOf 失败 → 图库/定时落到别的实例或 C 盘幽灵库)。
+     * 每次消息补一次 provide(幂等: 已是本实例就跳过)。用 record.agent.ctx(恒有)。
+     */
+    ensureChannelContext(record: SessionRecord): Promise<void>;
+    hotReloadChannelTools(agentCtx: Context): Promise<void>;
+    /** 对所有活会话的 agentCtx 执行一次工具热刷新。返回给人看的摘要文本。 */
+    reloadAllChannelTools(): Promise<string>;
+    /**
+     * 守则/身份 context 注册自愈(幂等): 每次消息处理路径都会调用。
+     * 用 record.agent.ctx(恒有, 不依赖 setup; 重启恢复会话也覆盖)。
+     * 注册方式照审批 approval:policy: ctx.inject(['systemPrompt']) → systemPrompt.context;
+     * text 每次渲染现读 live config(空串不贡献、热更新)。
+     */
+    ensureGroupRules(record: SessionRecord): Promise<void>;
+    findBySessionId(sessionId: string): SessionRecord | undefined;
+    findByAgent(agent: DshAgent): SessionRecord | undefined;
+    /** 按会话键找活跃会话(group/c2c); 无则 undefined(会话被回收/未建立) */
+    findByPeer(scope: ChatScope, peerId: string): SessionRecord | undefined;
+    /**
+     * 定时/主动注入: 向某会话塞一条新消息(像收到新消息, AI 带上下文处理并回复到 QQ)。
+     * 会话当前不在(被回收/未建立)→ 返回 false, 由调用方决定(计数/跳过)。
+     */
+    injectToPeer(scope: ChatScope, peerId: string, text: string): Promise<boolean>;
+    remove(scope: ChatScope, peerId: string): Promise<void>;
+    disposeAll(): Promise<void>;
+    get size(): number;
+}
+//# sourceMappingURL=session-manager.d.ts.map