@qlingzzy/qling 1.0.0

package/dist/pipeline/verification.js

@@ -0,0 +1,138 @@
+// ============================================================
+// 轻灵 - Verification Agent（精简版）
+// - 简单操作跳过 LLM，直接规则判断
+// - LLM 输出严格限制在 150 tokens 内
+// - 只返回判决 + 一句话说明
+// ============================================================
+const VERIFICATION_PROMPT = `你是轻灵的验证 Agent，负责判断操作是否成功。
+
+【输出规则】必须严格遵循以下格式，禁止添加任何额外内容：
+
+PASS  // 操作完全成功
+FAIL  // 操作明显失败
+PARTIAL  // 部分成功，有警告
+
+一行说明：原因
+
+【判断标准】
+- PASS: 达到了预期结果，无错误
+- FAIL: 错误、异常、或未达到预期
+- PARTIAL: 达到了核心目标，但有小问题
+
+请直接返回判决和说明，不要解释验证过程。`;
+export class VerificationAgent {
+    apiKey;
+    model;
+    constructor(apiKey, model = "deepseek-chat") {
+        this.apiKey = apiKey;
+        this.model = model;
+    }
+    async verify(operation, expectedOutcome, actualOutput, context) {
+        // 规则验证（快速路径）
+        const ruleResult = this.ruleBasedVerify(operation, expectedOutcome, actualOutput);
+        // 如果 output 很短（bash 无输出、权限拒绝等），直接用规则结果
+        const isSimple = actualOutput.length < 100 || actualOutput.includes("denied") || actualOutput.includes("not found") || actualOutput.includes("Error");
+        if (isSimple && this.apiKey) {
+            try {
+                const llmResult = await this.verifyWithLLM(operation, actualOutput, ruleResult);
+                return llmResult;
+            }
+            catch {
+                // LLM 失败，降级到规则
+                return ruleResult;
+            }
+        }
+        return ruleResult;
+    }
+    async verifyWithLLM(operation, actualOutput, fallback) {
+        const prompt = `${VERIFICATION_PROMPT}
+
+【操作类型】${operation}
+【实际输出】${actualOutput.slice(0, 500)}${actualOutput.length > 500 ? "..." : ""}`;
+        try {
+            const response = await this.callLLM(prompt);
+            return this.parseResponse(response);
+        }
+        catch {
+            return fallback;
+        }
+    }
+    async callLLM(prompt) {
+        const resp = await fetch("https://api.deepseek.com/chat/completions", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: this.model,
+                messages: [{ role: "user", content: prompt }],
+                max_tokens: 150,
+                temperature: 0,
+            }),
+        });
+        if (!resp.ok)
+            throw new Error(`API error: ${resp.status}`);
+        const data = await resp.json();
+        return data.choices?.[0]?.message?.content ?? "";
+    }
+    parseResponse(response) {
+        const lines = response.split("\n").map((l) => l.trim()).filter(Boolean);
+        let verdict = "PARTIAL";
+        let details = response;
+        const steps = [];
+        for (const line of lines) {
+            if (line.startsWith("PASS")) {
+                verdict = "PASS";
+                details = line.replace(/^PASS\s*/, "").replace(/^一行说明：/, "").trim();
+                steps.push({ description: "通过", passed: true });
+            }
+            else if (line.startsWith("FAIL")) {
+                verdict = "FAIL";
+                details = line.replace(/^FAIL\s*/, "").replace(/^一行说明：/, "").trim();
+                steps.push({ description: "失败", passed: false });
+            }
+            else if (line.startsWith("PARTIAL")) {
+                verdict = "PARTIAL";
+                details = line.replace(/^PARTIAL\s*/, "").replace(/^一行说明：/, "").trim();
+                steps.push({ description: "部分成功", passed: true });
+            }
+        }
+        return { verdict, details, steps };
+    }
+    // 规则验证（无 LLM 时降级，也作为快速路径）
+    ruleBasedVerify(operation, expected, actual) {
+        const steps = [];
+        let failedChecks = 0;
+        // 检查明显的错误标记
+        const errorPatterns = [
+            "error", "Error", "ERROR", "failed", "Failed", "FAILED",
+            "denied", "permission", "not found", "NotADirectory",
+            "WinError", "Traceback", "SyntaxError", "cannot",
+        ];
+        const hasError = errorPatterns.some((p) => actual.toLowerCase().includes(p.toLowerCase()));
+        if (hasError) {
+            steps.push({ description: "输出包含错误标记", passed: false });
+            failedChecks++;
+        }
+        else {
+            steps.push({ description: "无错误标记", passed: true });
+        }
+        // 检查 exit code 标记
+        if (actual.includes("exit code: 0") || actual.includes("✅")) {
+            steps.push({ description: "成功退出", passed: true });
+        }
+        else if (/\bexit code: [1-9]\b/.test(actual) || /\bexit code: null\b/.test(actual)) {
+            steps.push({ description: "非零退出码", passed: false });
+            failedChecks++;
+        }
+        const verdict = failedChecks === 0 ? "PASS" : failedChecks < steps.length ? "PARTIAL" : "FAIL";
+        return {
+            verdict,
+            details: failedChecks === 0
+                ? "规则验证通过"
+                : `规则验证: ${failedChecks} 项失败`,
+            steps,
+        };
+    }
+}

package/dist/privacy-report.d.ts

@@ -0,0 +1,24 @@
+import type { SlashCommandContext } from "./commands/runtime.js";
+import { type EnvSecretHit } from "./config.js";
+export interface PrivacyReport {
+    workspaceDir: string;
+    stateDir: string;
+    sessionsDir: string;
+    cacheDir: string;
+    savedSessionCount: number;
+    model: string;
+    plaintextSecretHits: EnvSecretHit[];
+}
+export interface PrivacyReportOptions {
+    env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
+}
+export interface LocalPrivacyReportOptions {
+    workspaceDir: string;
+    stateDir: string;
+    cacheDir?: string;
+    model?: string;
+}
+export declare function buildPrivacyReport(context: SlashCommandContext, options?: PrivacyReportOptions): Promise<PrivacyReport>;
+export declare function buildLocalPrivacyReport(options: LocalPrivacyReportOptions): Promise<PrivacyReport>;
+export declare function formatPrivacyReport(report: PrivacyReport): string[];
+//# sourceMappingURL=privacy-report.d.ts.map

package/dist/privacy-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-report.d.ts","sourceRoot":"","sources":["../src/privacy-report.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAG1E,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,YAAY,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CAgBxB;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC,CAcxG;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAkCnE"}

package/dist/privacy-report.js

@@ -0,0 +1,78 @@
+import { homedir } from "os";
+import { join } from "path";
+import { SessionRegistry } from "./session/session-registry.js";
+import { scanRuntimeDotEnvSecrets } from "./config.js";
+import { getLocalizedText } from "./i18n/index.js";
+function resolveStateDir(env, agentLoop) {
+    return env?.QLING_FILE_STATE_DIR
+        || agentLoop.getRuntimeRootDir?.()
+        || join(homedir(), ".qling");
+}
+function resolveCacheDir(env, stateDir) {
+    return env?.QLING_FILE_CACHE_DIR || join(stateDir, "cache");
+}
+export async function buildPrivacyReport(context, options = {}) {
+    const env = options.env ?? process.env;
+    const agentLoop = context.agentLoop;
+    const stateDir = resolveStateDir(env, agentLoop);
+    const savedSessions = context.listSavedSessions ? await context.listSavedSessions() : [];
+    const hits = await scanRuntimeDotEnvSecrets(stateDir);
+    return {
+        workspaceDir: context.workspaceDir || agentLoop.getWorkspaceDir?.() || process.cwd(),
+        stateDir,
+        sessionsDir: join(stateDir, "sessions"),
+        cacheDir: resolveCacheDir(env, stateDir),
+        savedSessionCount: Array.isArray(savedSessions) ? savedSessions.length : 0,
+        model: agentLoop.getModel?.() || "unknown",
+        plaintextSecretHits: hits,
+    };
+}
+export async function buildLocalPrivacyReport(options) {
+    const registry = new SessionRegistry({ stateDir: options.stateDir });
+    const savedSessions = await registry.list();
+    const hits = await scanRuntimeDotEnvSecrets(options.stateDir);
+    return {
+        workspaceDir: options.workspaceDir,
+        stateDir: options.stateDir,
+        sessionsDir: join(options.stateDir, "sessions"),
+        cacheDir: options.cacheDir || join(options.stateDir, "cache"),
+        savedSessionCount: savedSessions.length,
+        model: options.model || "unknown",
+        plaintextSecretHits: hits,
+    };
+}
+export function formatPrivacyReport(report) {
+    const secretLines = [];
+    if (report.plaintextSecretHits && report.plaintextSecretHits.length > 0) {
+        const byFile = new Map();
+        for (const h of report.plaintextSecretHits) {
+            if (!byFile.has(h.file))
+                byFile.set(h.file, []);
+            byFile.get(h.file).push(h.varName);
+        }
+        secretLines.push("");
+        secretLines.push("⚠️  检测到运行时明文密钥（仅显示变量名）：");
+        for (const [f, vars] of byFile.entries()) {
+            secretLines.push(`   ${f} : ${vars.join(", ")}`);
+        }
+        secretLines.push("   建议：轮换密钥 → 移至系统环境变量 → 删除 .env 中对应行 → 重新运行 /privacy 或 /doctor 确认。");
+    }
+    const t = getLocalizedText();
+    return [
+        "",
+        `🔒 【${t.privacy?.title || "本地数据留存"}】`,
+        "-----------------------------------------",
+        `${t.privacy?.workspaceDir || "Workspace"}  : ${report.workspaceDir}`,
+        `${t.privacy?.stateDir || "State dir"}  : ${report.stateDir}`,
+        `${t.privacy?.sessionsDir || "Sessions"}   : ${report.sessionsDir}`,
+        `${t.privacy?.cacheDir || "Cache dir"}  : ${report.cacheDir}`,
+        `已存快照   : ${report.savedSessionCount}`,
+        `${t.labels.model || "模型配置"}   : ${report.model}`,
+        ...secretLines,
+        "-----------------------------------------",
+        "本命令只读取本地状态，不上传诊断数据，也不扫描消息正文。",
+        "边界说明: 模型请求仍按 provider 配置发送必要上下文；如需完全离线，需要配置本地模型/provider。",
+        "提示: 用 /context 查看上下文占用，用 /doctor 检查本地稳定性。",
+        "",
+    ];
+}

package/dist/providers/presets.d.ts

@@ -0,0 +1,25 @@
+export interface ProviderPreset {
+    /** 稳定 id，用于 /model use <id> */
+    id: string;
+    /** 展示名（中文优先） */
+    displayName: string;
+    /** QLING_LLM_PROVIDER 写入值 */
+    provider: string;
+    endpoint: string;
+    model: string;
+    keyHint?: string;
+    /** 本地/无密钥场景为 false */
+    requiresApiKey: boolean;
+    tags?: string[];
+}
+/** setup 数字菜单用的有序列表（1-based 由调用方映射） */
+export declare const PROVIDER_PRESET_ORDER: string[];
+export declare function listProviderPresets(options?: {
+    includeAliases?: boolean;
+}): ProviderPreset[];
+export declare function getProviderPreset(idOrAlias: string): ProviderPreset | undefined;
+export declare function resolveModelCandidates(): string[];
+export declare function isLoopbackEndpoint(endpoint: string): boolean;
+export declare function apiKeyRequiredForEndpoint(endpoint: string, provider?: string): boolean;
+export declare function formatPresetTableLines(): string[];
+//# sourceMappingURL=presets.d.ts.map

package/dist/providers/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/providers/presets.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,uCAAuC;AACvC,eAAO,MAAM,qBAAqB,EAAE,MAAM,EAWzC,CAAC;AA6HF,wBAAgB,mBAAmB,CAAC,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,cAAc,EAAE,CAOhG;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAmB/E;AAED,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAUjD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAO5D;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAMtF;AAED,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAYjD"}

package/dist/providers/presets.js

@@ -0,0 +1,205 @@
+// ============================================================
+// 轻灵 - Provider 预设（单一真相源）
+// setup / /model / doctor 共用，避免各处硬编码分叉
+// ============================================================
+/** setup 数字菜单用的有序列表（1-based 由调用方映射） */
+export const PROVIDER_PRESET_ORDER = [
+    "deepseek",
+    "dashscope",
+    "zhipu",
+    "moonshot",
+    "minimax",
+    "mimo",
+    "mimo-token-plan",
+    "siliconflow",
+    "openai",
+    "ollama",
+];
+const PRESET_MAP = {
+    deepseek: {
+        id: "deepseek",
+        displayName: "DeepSeek",
+        provider: "deepseek",
+        endpoint: "https://api.deepseek.com",
+        model: "deepseek-chat",
+        requiresApiKey: true,
+        tags: ["china", "recommended"],
+    },
+    dashscope: {
+        id: "dashscope",
+        displayName: "阿里云百炼 (Qwen)",
+        provider: "dashscope",
+        endpoint: "https://dashscope.aliyuncs.com/compatible-mode/v1",
+        model: "qwen-plus",
+        keyHint: "阿里云 API Key",
+        requiresApiKey: true,
+        tags: ["china"],
+    },
+    zhipu: {
+        id: "zhipu",
+        displayName: "智谱清言 (GLM)",
+        provider: "zhipu",
+        endpoint: "https://open.bigmodel.cn/api/paas/v4",
+        model: "glm-4",
+        keyHint: "智谱 AI Key",
+        requiresApiKey: true,
+        tags: ["china"],
+    },
+    moonshot: {
+        id: "moonshot",
+        displayName: "月之暗面 (Kimi)",
+        provider: "moonshot",
+        endpoint: "https://api.moonshot.cn/v1",
+        model: "moonshot-v1-8k",
+        keyHint: "Kimi API Key",
+        requiresApiKey: true,
+        tags: ["china"],
+    },
+    minimax: {
+        id: "minimax",
+        displayName: "MiniMax (海螺)",
+        provider: "minimax",
+        endpoint: "https://api.minimaxi.com/v1",
+        model: "MiniMax-M2.7",
+        keyHint: "MiniMax API Key",
+        requiresApiKey: true,
+        tags: ["china"],
+    },
+    mimo: {
+        id: "mimo",
+        displayName: "Xiaomi MiMo (按量计费)",
+        provider: "mimo",
+        endpoint: "https://api.xiaomimimo.com/v1",
+        model: "MiMo-V2.5-Pro",
+        keyHint: "小米 MiMo sk-xxx",
+        requiresApiKey: true,
+        tags: ["china"],
+    },
+    "mimo-token-plan": {
+        id: "mimo-token-plan",
+        displayName: "Xiaomi MiMo (Token Plan 订阅)",
+        provider: "mimo",
+        endpoint: "https://token-plan-cn.xiaomimimo.com/v1",
+        model: "MiMo-V2.5-Pro",
+        keyHint: "小米 MiMo tp-xxx",
+        requiresApiKey: true,
+        tags: ["china"],
+    },
+    siliconflow: {
+        id: "siliconflow",
+        displayName: "硅基流动 (SiliconFlow)",
+        provider: "siliconflow",
+        endpoint: "https://api.siliconflow.cn/v1",
+        model: "Qwen/Qwen2.5-7B-Instruct",
+        keyHint: "硅基流动 Key",
+        requiresApiKey: true,
+        tags: ["china"],
+    },
+    openai: {
+        id: "openai",
+        displayName: "OpenAI",
+        provider: "openai",
+        endpoint: "https://api.openai.com/v1",
+        model: "gpt-4o",
+        requiresApiKey: true,
+        tags: ["global"],
+    },
+    ollama: {
+        id: "ollama",
+        displayName: "本地 Ollama",
+        provider: "ollama",
+        endpoint: "http://localhost:11434/v1",
+        model: "llama3",
+        keyHint: "Ollama（可留空）",
+        requiresApiKey: false,
+        tags: ["local"],
+    },
+    // 别名：历史 setup 用 local 命名
+    local: {
+        id: "local",
+        displayName: "本地部署 (Ollama)",
+        provider: "ollama",
+        endpoint: "http://localhost:11434/v1",
+        model: "llama3",
+        keyHint: "Ollama（可留空）",
+        requiresApiKey: false,
+        tags: ["local", "alias"],
+    },
+};
+const ALIASES = {
+    local: "ollama",
+    ollama: "ollama",
+    "llama": "ollama",
+    "openai-compat": "openai",
+    qwen: "dashscope",
+    kimi: "moonshot",
+    glm: "zhipu",
+    deepseek: "deepseek",
+};
+export function listProviderPresets(options = {}) {
+    const includeAliases = options.includeAliases === true;
+    const ordered = PROVIDER_PRESET_ORDER.map((id) => PRESET_MAP[id]).filter(Boolean);
+    if (includeAliases) {
+        return Object.values(PRESET_MAP);
+    }
+    return ordered;
+}
+export function getProviderPreset(idOrAlias) {
+    const raw = String(idOrAlias ?? "").trim().toLowerCase();
+    if (!raw)
+        return undefined;
+    // 数字索引 1..N → 有序列表
+    if (/^\d+$/.test(raw)) {
+        const index = Number(raw) - 1;
+        const ordered = listProviderPresets();
+        return ordered[index];
+    }
+    const canonical = ALIASES[raw] ?? raw;
+    if (PRESET_MAP[canonical])
+        return PRESET_MAP[canonical];
+    if (PRESET_MAP[raw])
+        return PRESET_MAP[raw];
+    // 允许用 provider 字段模糊匹配第一个
+    return listProviderPresets().find((p) => p.provider.toLowerCase() === raw || p.id.toLowerCase() === raw);
+}
+export function resolveModelCandidates() {
+    const seen = new Set();
+    const out = [];
+    for (const p of listProviderPresets()) {
+        if (!seen.has(p.model)) {
+            seen.add(p.model);
+            out.push(p.model);
+        }
+    }
+    return out;
+}
+export function isLoopbackEndpoint(endpoint) {
+    try {
+        const url = new URL(endpoint);
+        return ["localhost", "127.0.0.1", "::1"].includes(url.hostname);
+    }
+    catch {
+        return false;
+    }
+}
+export function apiKeyRequiredForEndpoint(endpoint, provider) {
+    if (provider && (provider === "ollama" || provider === "local"))
+        return false;
+    if (endpoint && isLoopbackEndpoint(endpoint))
+        return false;
+    const preset = provider ? getProviderPreset(provider) : undefined;
+    if (preset)
+        return preset.requiresApiKey;
+    return true;
+}
+export function formatPresetTableLines() {
+    const lines = [];
+    const presets = listProviderPresets();
+    presets.forEach((p, i) => {
+        const key = p.requiresApiKey ? "key" : "no-key";
+        lines.push(`${String(i + 1).padStart(2, " ")}. ${p.id.padEnd(16)} ${p.displayName}`);
+        lines.push(`    provider=${p.provider}  model=${p.model}`);
+        lines.push(`    endpoint=${p.endpoint}  (${key})`);
+    });
+    return lines;
+}

package/dist/recap.d.ts

@@ -0,0 +1,38 @@
+import type { SlashCommandContext } from "./commands/runtime.js";
+interface RecapMessage {
+    role?: string;
+    content?: unknown;
+}
+interface RecapStats {
+    sessionId?: string;
+    turnCount?: number;
+    tokens?: number;
+    compactions?: number;
+}
+interface LocalRecapInput {
+    stats: RecapStats;
+    workspaceDir?: string;
+    goalStatus?: {
+        status?: string;
+        condition?: string;
+    } | null;
+    activeTasks: Array<{
+        id?: string;
+        status?: string;
+        prompt?: string;
+    }>;
+    messages: RecapMessage[];
+    limit: number;
+}
+export interface SavedSessionRecapRequest {
+    sessionRef: string;
+    count: number;
+}
+export declare function resolveRecapLimit(value?: string): number;
+export declare function parseSavedSessionRecapArgs(args?: string[]): SavedSessionRecapRequest;
+export declare function formatRecapMessage(message: RecapMessage, maxLength?: number): string;
+export declare function formatLocalRecap(input: LocalRecapInput): string;
+export declare function buildSavedSessionRecap(stateDir: string, request: SavedSessionRecapRequest): Promise<string>;
+export declare function buildLocalRecap(context: SlashCommandContext, limit?: number): Promise<string>;
+export {};
+//# sourceMappingURL=recap.d.ts.map

package/dist/recap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recap.d.ts","sourceRoot":"","sources":["../src/recap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,UAAU;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,eAAe;IACvB,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5D,WAAW,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAoBD,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAIxD;AAQD,wBAAgB,0BAA0B,CAAC,IAAI,GAAE,MAAM,EAAO,GAAG,wBAAwB,CAYxF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,SAAM,GAAG,MAAM,CAIjF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA6B/D;AAsCD,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAkC9F"}

package/dist/recap.js

@@ -0,0 +1,154 @@
+import { SessionRegistry } from "./session/session-registry.js";
+function stringifyContent(content) {
+    if (typeof content === "string")
+        return content;
+    try {
+        return JSON.stringify(content);
+    }
+    catch {
+        return String(content);
+    }
+}
+function compactOneLine(value) {
+    return value.replace(/\s+/g, " ").trim();
+}
+function truncate(value, maxLength) {
+    if (value.length <= maxLength)
+        return value;
+    return value.slice(0, Math.max(0, maxLength - 1)) + "...";
+}
+export function resolveRecapLimit(value) {
+    const parsed = Number.parseInt(String(value ?? ""), 10);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return 6;
+    return Math.min(parsed, 20);
+}
+function isCountArg(value) {
+    if (!value)
+        return false;
+    const parsed = Number.parseInt(value, 10);
+    return Number.isFinite(parsed) && String(parsed) === value.trim();
+}
+export function parseSavedSessionRecapArgs(args = []) {
+    const [first, second] = args;
+    if (!first) {
+        return { sessionRef: "latest", count: resolveRecapLimit(undefined) };
+    }
+    if (isCountArg(first)) {
+        return { sessionRef: "latest", count: resolveRecapLimit(first) };
+    }
+    return {
+        sessionRef: first,
+        count: resolveRecapLimit(second),
+    };
+}
+export function formatRecapMessage(message, maxLength = 120) {
+    const role = compactOneLine(String(message.role || "unknown")) || "unknown";
+    const content = truncate(compactOneLine(stringifyContent(message.content ?? "")), maxLength);
+    return `${role}: ${content}`;
+}
+export function formatLocalRecap(input) {
+    const stats = input.stats ?? {};
+    const messages = Array.isArray(input.messages) ? input.messages : [];
+    const recent = messages.slice(-Math.max(0, input.limit));
+    const goal = input.goalStatus?.status
+        ? `${input.goalStatus.status}${input.goalStatus.condition ? ` (${input.goalStatus.condition})` : ""}`
+        : "none";
+    const lines = [
+        "",
+        "📌 【本地会话回顾】",
+        "-----------------------------------------",
+        `session=${stats.sessionId || "-"}  turns=${Number(stats.turnCount ?? 0)}  tokens=${Number(stats.tokens ?? 0).toLocaleString()}  compactions=${Number(stats.compactions ?? 0)}`,
+        `goal=${goal}  tasks=${input.activeTasks.length}`,
+        `workspace=${input.workspaceDir || "-"}`,
+        "最近消息:",
+    ];
+    if (recent.length === 0) {
+        lines.push("  最近消息: 无");
+    }
+    else {
+        for (const message of recent) {
+            lines.push(`  ${formatRecapMessage(message)}`);
+        }
+    }
+    lines.push("-----------------------------------------");
+    lines.push("说明: 本回顾只读取当前本地会话状态，不调用模型、不联网、不写远端。");
+    lines.push("");
+    return lines.join("\n");
+}
+function formatMissingSavedSessionRecap(stateDir, sessionRef) {
+    const lines = [
+        "",
+        "📌 【本地会话回顾】",
+        "-----------------------------------------",
+        `stateDir=${stateDir}`,
+        `session=${sessionRef || "latest"}`,
+        "未找到本地会话快照。",
+        "提示: 先完成一次交互会话，或使用 `qling sessions` / `/sessions` 查看已保存快照。",
+        "-----------------------------------------",
+        "说明: 本命令只读取本地已保存会话快照，不调用模型、不联网、不写远端。",
+        "",
+    ];
+    return lines.join("\n");
+}
+function formatSavedSessionRecap(snapshot, limit) {
+    const text = formatLocalRecap({
+        stats: {
+            sessionId: snapshot.sessionId,
+            turnCount: snapshot.turnCount,
+            tokens: snapshot.sessionTokens,
+            compactions: snapshot.compactionCount,
+        },
+        workspaceDir: snapshot.workspaceDir ?? undefined,
+        goalStatus: null,
+        activeTasks: [],
+        messages: snapshot.messages,
+        limit,
+    });
+    return text.replace("说明: 本回顾只读取当前本地会话状态，不调用模型、不联网、不写远端。", "说明: 本命令只读取本地已保存会话快照，不调用模型、不联网、不写远端。");
+}
+export async function buildSavedSessionRecap(stateDir, request) {
+    const registry = new SessionRegistry({ stateDir });
+    const sessionRef = request.sessionRef || "latest";
+    const snapshot = sessionRef === "latest"
+        ? await registry.loadLatest()
+        : await registry.load(sessionRef);
+    if (!snapshot) {
+        return formatMissingSavedSessionRecap(stateDir, sessionRef);
+    }
+    return formatSavedSessionRecap(snapshot, request.count);
+}
+export async function buildLocalRecap(context, limit = 6) {
+    const agentLoop = context.agentLoop;
+    const stats = typeof agentLoop.getSessionStats === "function"
+        ? await agentLoop.getSessionStats()
+        : {
+            sessionId: typeof agentLoop.getSessionId === "function" ? agentLoop.getSessionId() : "",
+            turnCount: 0,
+            tokens: 0,
+            compactions: 0,
+        };
+    const messages = typeof agentLoop.getMessagesSnapshot === "function"
+        ? await agentLoop.getMessagesSnapshot()
+        : [];
+    const tasks = context.scheduler && typeof context.scheduler.listTasks === "function"
+        ? await context.scheduler.listTasks()
+        : [];
+    const activeTasks = Array.isArray(tasks)
+        ? tasks.filter((task) => task.status !== "completed" && task.status !== "canceled")
+        : [];
+    const goalStatus = context.goalController && typeof context.goalController.getGoalStatus === "function"
+        ? await context.goalController.getGoalStatus()
+        : null;
+    const workspaceDir = typeof agentLoop.getWorkspaceDir === "function"
+        ? agentLoop.getWorkspaceDir()
+        : context.workspaceDir;
+    return formatLocalRecap({
+        stats,
+        workspaceDir,
+        goalStatus,
+        activeTasks,
+        messages: Array.isArray(messages) ? messages : [],
+        limit,
+    });
+}