@qlingzzy/qling 1.0.0

package/dist/doctor.js

@@ -0,0 +1,343 @@
+import { existsSync } from "fs";
+import { join, resolve } from "path";
+import { homedir } from "os";
+import { resolveGitBranch } from "./statusline.js";
+import { sanitizeEndpoint } from "./config-report.js";
+import { buildLocalMcpReport } from "./mcp-report.js";
+import { guardConfigFromEnv, scanRuntimeDotEnvSecrets } from "./config.js";
+import { buildLocalHooksReport } from "./hooks-report.js";
+import { getLocalizedText } from "./i18n/index.js";
+const t = getLocalizedText();
+const DEFAULT_STATE_DIR = join(homedir(), ".qling");
+const DEFAULT_DAEMON_HEALTH_URL = "http://127.0.0.1:39871/health";
+function summarize(checks) {
+    return checks.reduce((acc, check) => ({ ...acc, [check.status]: acc[check.status] + 1 }), { pass: 0, warn: 0, fail: 0 });
+}
+function checkLocalPath(id, label, path, exists) {
+    const resolved = resolve(path);
+    const t = getLocalizedText();
+    return exists(resolved)
+        ? { id, label, status: "pass", detail: resolved }
+        : { id, label, status: "warn", detail: `${resolved} ${t.doctor ? "不存在；首次运行或迁移前可能需要初始化。" : ""}` };
+}
+function isLoopbackUrl(raw) {
+    try {
+        const url = new URL(raw);
+        return url.protocol === "http:" && ["127.0.0.1", "localhost", "::1"].includes(url.hostname);
+    }
+    catch {
+        return false;
+    }
+}
+function envText(env, name) {
+    const value = env?.[name];
+    return typeof value === "string" && value.trim() ? value.trim() : "";
+}
+function envNumber(env, name) {
+    const value = Number(envText(env, name));
+    return Number.isFinite(value) && value >= 0 ? value : 0;
+}
+function boolText(value) {
+    return value ? "on" : "off";
+}
+function buildConfigCheck(env) {
+    const provider = envText(env, "QLING_LLM_PROVIDER") || "unset";
+    const model = envText(env, "QLING_LLM_MODEL") || "unset";
+    const endpoint = sanitizeEndpoint(envText(env, "QLING_LLM_ENDPOINT"));
+    const apiKeyStatus = envText(env, "QLING_LLM_API_KEY") ? "set(redacted)" : "missing";
+    return {
+        id: "config",
+        label: "config",
+        status: apiKeyStatus === "missing" ? "warn" : "pass",
+        detail: `provider=${provider} model=${model} endpoint=${endpoint} api_key=${apiKeyStatus}`,
+    };
+}
+async function buildSecretsCheck() {
+    const hits = await scanRuntimeDotEnvSecrets();
+    if (hits.length === 0) {
+        return {
+            id: "secrets",
+            label: "secrets",
+            status: "pass",
+            detail: "未在 ~/.qling/.env 或项目 .env 发现明文密钥变量",
+        };
+    }
+    // Group by file, list only var names
+    const byFile = new Map();
+    for (const h of hits) {
+        if (!byFile.has(h.file))
+            byFile.set(h.file, []);
+        byFile.get(h.file).push(h.varName);
+    }
+    const details = Array.from(byFile.entries())
+        .map(([f, vars]) => `${f} → ${vars.join(", ")}`)
+        .join(" | ");
+    return {
+        id: "secrets",
+        label: "secrets",
+        status: "warn",
+        detail: `检测到明文密钥变量（仅列出变量名）: ${details}`,
+    };
+}
+function buildRecommendations(checks) {
+    const recommendations = [];
+    const byId = new Map(checks.map((check) => [check.id, check]));
+    if (byId.get("config")?.status === "warn") {
+        const text = getLocalizedText();
+        recommendations.push("- 新用户优先运行 `qling bootstrap` 完成本机初始化检查。");
+        recommendations.push("- 运行 `qling setup` 配置本地 Provider / Model / Endpoint。");
+        recommendations.push(`- ${text.boundaries.setupSecret}`);
+        recommendations.push(`  ${text.setup.windowsEnvExample}`);
+    }
+    const stateDir = byId.get("state_dir");
+    const cacheDir = byId.get("cache_dir");
+    if (stateDir?.status === "warn" || cacheDir?.status === "warn") {
+        recommendations.push("- 首次运行会初始化本地数据目录；如需预先创建，可检查 `qling storage` 输出的路径。");
+    }
+    if (byId.get("daemon")?.status === "warn") {
+        recommendations.push("- 如需后台任务或使命附着，运行 `qling daemon start` 后再执行 `qling doctor`。");
+    }
+    if (byId.get("git")?.status === "warn") {
+        recommendations.push("- 在 Git 仓库内运行可获得更完整的分支和工作区诊断。");
+    }
+    if (byId.get("secrets")?.status === "warn") {
+        recommendations.push("- 检测到运行时 .env 中的明文 API key/secret。");
+        recommendations.push("  立即在 Provider 控制台轮换密钥。");
+        recommendations.push("  将密钥迁移到系统用户环境变量（推荐）或安全的 secret store，删除 .env 中的对应行。");
+        recommendations.push("  运行 `qling doctor` 再次确认。");
+    }
+    if (byId.get("ollama")?.status === "warn") {
+        recommendations.push("- 本机未检测到 Ollama。若要用本地模型：安装并启动 Ollama，然后 `/model use ollama` 或 `qling setup` 选本地部署。");
+        recommendations.push("  默认探测 http://127.0.0.1:11434 ；可用环境变量 QLING_OLLAMA_URL 覆盖。");
+    }
+    if (byId.get("ollama")?.status === "pass") {
+        recommendations.push("- 已检测到本机 Ollama。可用 `/model use ollama` 切换到本地模型（无需 API key）。");
+    }
+    // P4: channel connectors (完善 Telegram/Slack，规划其他)
+    const hasTelegram = !!process.env.QLING_CHANNEL_TELEGRAM_TOKEN;
+    const hasSlack = !!process.env.QLING_CHANNEL_SLACK_BOT_TOKEN;
+    const hasFeishu = !!process.env.QLING_CHANNEL_FEISHU_APP_ID;
+    if (hasTelegram) {
+        checks.push({ id: "channel_telegram", label: "channel:telegram", status: "pass", detail: "Telegram token 已设置" });
+        recommendations.push("- Telegram 已配置。使用 /connect telegram test 或 doctor 验证。");
+    }
+    if (hasSlack) {
+        checks.push({ id: "channel_slack", label: "channel:slack", status: "pass", detail: "Slack bot token 已设置" });
+        recommendations.push("- Slack 已配置。使用 /connect slack test 验证。");
+    }
+    if (hasTelegram || hasSlack || hasFeishu) {
+        recommendations.push("  常见失败: token 无效/权限不足/网络。运行 /connect <平台> guide 获取向导。");
+    }
+    if (!hasTelegram && !hasSlack && !hasFeishu) {
+        recommendations.push("- 未配置国内 IM 连接器。使用 /connect telegram guide 等获取中文准备向导。");
+        recommendations.push("  优先完善 Telegram/Slack，Feishu/DingTalk/WeChat 规划中。");
+    }
+    // 敏感检查已在 secrets 中
+    recommendations.push("- 敏感 token: 绝不写入 .env，复用 scanner + doctor 警告。");
+    return recommendations;
+}
+function buildMcpCheck(env) {
+    const report = buildLocalMcpReport({
+        servers: {},
+        connection_timeout_ms: envNumber(env, "QLING_MCP_CONNECTION_TIMEOUT_MS"),
+        call_timeout_ms: envNumber(env, "QLING_MCP_CALL_TIMEOUT_MS"),
+    }, env);
+    return {
+        id: "mcp",
+        label: "MCP",
+        status: "pass",
+        detail: `enabled=${report.enabled}/${report.total} connect=${report.connectionTimeoutMs}ms call=${report.callTimeoutMs}ms`,
+    };
+}
+function buildHooksCheck(env) {
+    const report = buildLocalHooksReport(guardConfigFromEnv(env));
+    return {
+        id: "hooks",
+        label: "hooks",
+        status: report.guardEnabled ? "pass" : "warn",
+        detail: `guard=${boolText(report.guardEnabled)} permission=${report.permissionDefault} rules=${report.permissionRuleCount} rate_limit=${boolText(report.rateLimitEnabled)}(${report.rateLimitMaxPerMinute}/min) content_filter=${boolText(report.contentFilterEnabled)} custom=${report.customContentPatternCount}`,
+    };
+}
+async function probeDaemon(env) {
+    const url = env?.QLING_DAEMON_HEALTH_URL ?? DEFAULT_DAEMON_HEALTH_URL;
+    if (!isLoopbackUrl(url)) {
+        return { ok: false, detail: "跳过：daemon health URL 不是本机 loopback。生产诊断不会访问公网。" };
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 800);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        return response.ok
+            ? { ok: true, detail: `${url} reachable` }
+            : { ok: false, detail: `${url} HTTP ${response.status}` };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            detail: error instanceof Error ? error.message : String(error),
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+const DEFAULT_OLLAMA_URL = "http://127.0.0.1:11434/api/tags";
+async function probeOllama(env) {
+    const raw = envText(env, "QLING_OLLAMA_URL") || DEFAULT_OLLAMA_URL;
+    let url = raw;
+    try {
+        const parsed = new URL(raw);
+        // 允许用户只给 base；自动补 /api/tags
+        if (!parsed.pathname || parsed.pathname === "/") {
+            parsed.pathname = "/api/tags";
+            url = parsed.toString();
+        }
+    }
+    catch {
+        return { ok: false, detail: `无效 QLING_OLLAMA_URL: ${raw}` };
+    }
+    if (!isLoopbackUrl(url)) {
+        return { ok: false, detail: "跳过：Ollama URL 不是本机 loopback。doctor 不会探测公网。" };
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 800);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        if (!response.ok) {
+            return { ok: false, detail: `${url} HTTP ${response.status}` };
+        }
+        let modelHint = "";
+        try {
+            const body = (await response.json());
+            const names = (body.models ?? []).map((m) => m.name).filter(Boolean);
+            if (names.length > 0) {
+                modelHint = ` models=${names.slice(0, 5).join(",")}${names.length > 5 ? "…" : ""}`;
+            }
+            else {
+                modelHint = " models=(empty — 可 ollama pull llama3)";
+            }
+        }
+        catch {
+            modelHint = "";
+        }
+        return { ok: true, detail: `${url} reachable${modelHint}` };
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        return { ok: false, detail: `unreachable: ${msg}` };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function buildDoctorReport(context, options = {}) {
+    const env = options.env ?? process.env;
+    const exists = options.exists ?? existsSync;
+    const gitBranch = options.gitBranch ?? resolveGitBranch;
+    const nodeVersion = options.nodeVersion ?? process.versions.node;
+    const stateDir = env.QLING_FILE_STATE_DIR || join(homedir(), ".qling");
+    const cacheDir = env.QLING_FILE_CACHE_DIR || join(stateDir, "cache");
+    const workspaceDir = context.workspaceDir || context.agentLoop.getWorkspaceDir?.() || process.cwd();
+    const stats = typeof context.agentLoop.getSessionStats === "function"
+        ? await context.agentLoop.getSessionStats()
+        : { sessionId: context.agentLoop.getSessionId?.() ?? "" };
+    const permissionMode = typeof context.agentLoop.getPermissionMode === "function"
+        ? context.agentLoop.getPermissionMode()
+        : env.QLING_GUARD_PERMISSIONS_DEFAULT;
+    const branch = gitBranch(workspaceDir);
+    const daemon = options.daemonProbe ? await options.daemonProbe() : await probeDaemon(env);
+    const ollama = options.ollamaProbe ? await options.ollamaProbe() : await probeOllama(env);
+    const secretsCheck = await buildSecretsCheck();
+    const checks = [
+        {
+            id: "node",
+            label: "Node runtime",
+            status: nodeVersion ? "pass" : "fail",
+            detail: nodeVersion ? `v${nodeVersion}` : "无法读取 Node 版本。",
+        },
+        checkLocalPath("workspace", "workspace", workspaceDir, exists),
+        {
+            id: "git",
+            label: "git",
+            status: branch ? "pass" : "warn",
+            detail: branch ? `branch=${branch}` : "当前 workspace 不是 git 仓库或无法读取分支。",
+        },
+        checkLocalPath("state_dir", "本地 state 目录", stateDir || DEFAULT_STATE_DIR, exists),
+        checkLocalPath("cache_dir", "本地 cache 目录", cacheDir, exists),
+        {
+            id: "session",
+            label: "session",
+            status: stats.sessionId ? "pass" : "warn",
+            detail: stats.sessionId ? `sessionId=${stats.sessionId}` : "当前会话尚无 session id。",
+        },
+        {
+            id: "permission",
+            label: "permission",
+            status: permissionMode ? "pass" : "warn",
+            detail: permissionMode ? `mode=${permissionMode}` : "未显式配置权限默认策略。",
+        },
+        buildConfigCheck(env),
+        secretsCheck,
+        buildMcpCheck(env),
+        buildHooksCheck(env),
+        // P4 connectors
+        {
+            id: "channel_telegram",
+            label: "channel:telegram",
+            status: !!env.QLING_CHANNEL_TELEGRAM_TOKEN ? "pass" : "warn",
+            detail: env.QLING_CHANNEL_TELEGRAM_TOKEN ? "token 已设置" : "未设置 QLING_CHANNEL_TELEGRAM_TOKEN",
+        },
+        {
+            id: "channel_slack",
+            label: "channel:slack",
+            status: !!env.QLING_CHANNEL_SLACK_BOT_TOKEN ? "pass" : "warn",
+            detail: env.QLING_CHANNEL_SLACK_BOT_TOKEN ? "bot token 已设置" : "未设置 Slack token",
+        },
+        {
+            id: "daemon",
+            label: "qlingd",
+            status: daemon.ok ? "pass" : "warn",
+            detail: daemon.detail,
+        },
+        {
+            id: "ollama",
+            label: "ollama",
+            status: ollama.ok ? "pass" : "warn",
+            detail: ollama.detail,
+        },
+    ];
+    return {
+        checks,
+        summary: summarize(checks),
+        recommendations: buildRecommendations(checks),
+    };
+}
+function icon(status) {
+    if (status === "pass")
+        return "PASS";
+    if (status === "warn")
+        return "WARN";
+    return "FAIL";
+}
+export function formatDoctorReport(report) {
+    const t = getLocalizedText();
+    const doctorTitle = t.doctor?.title || "Doctor - 本地环境诊断";
+    const lines = [
+        "",
+        `🩺 ${t.product.name} ${doctorTitle}`,
+        "-----------------------------------------",
+        `${t.doctor?.summary || "诊断摘要"}: pass=${report.summary.pass} warn=${report.summary.warn} fail=${report.summary.fail}`,
+    ];
+    for (const check of report.checks) {
+        lines.push(`[${icon(check.status)}] ${check.label}: ${check.detail}`);
+    }
+    if (report.recommendations.length > 0) {
+        lines.push("");
+        lines.push(t.doctor?.recommendations || "建议");
+        lines.push(...report.recommendations);
+    }
+    lines.push("-----------------------------------------");
+    lines.push("说明: Doctor 只读取本地状态与本机 loopback，不上传诊断数据。");
+    lines.push("");
+    return lines;
+}

package/dist/eval/runner.d.ts

@@ -0,0 +1,10 @@
+import type { EvalReport, EvalTask } from "./types.js";
+export interface RunEvalOptions {
+    tasks?: EvalTask[];
+    /** 保留临时目录（调试） */
+    keepTemp?: boolean;
+}
+export declare function runEvalSuite(options?: RunEvalOptions): Promise<EvalReport>;
+export declare function formatEvalReport(report: EvalReport): string[];
+export declare function evalReportToJson(report: EvalReport): string;
+//# sourceMappingURL=runner.d.ts.map

package/dist/eval/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/eval/runner.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAkB,MAAM,YAAY,CAAC;AAGvE,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,iBAAiB;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAsB,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiDpF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAkB7D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAE3D"}

package/dist/eval/runner.js

@@ -0,0 +1,78 @@
+// ============================================================
+// 轻灵 - 评测 runner
+// ============================================================
+import { mkdtemp, rm } from "fs/promises";
+import { tmpdir } from "os";
+import { join } from "path";
+import { buildEvalSmokeTasks } from "./tasks.js";
+export async function runEvalSuite(options = {}) {
+    const tasks = options.tasks ?? buildEvalSmokeTasks();
+    const started = Date.now();
+    const results = [];
+    const workspaceDir = await mkdtemp(join(tmpdir(), "qling-eval-"));
+    try {
+        for (const task of tasks) {
+            const t0 = Date.now();
+            try {
+                const outcome = await task.run({
+                    workspaceDir,
+                    env: process.env,
+                });
+                results.push({
+                    id: task.id,
+                    title: task.title,
+                    status: outcome.ok ? "pass" : "fail",
+                    detail: outcome.detail,
+                    durationMs: Date.now() - t0,
+                });
+            }
+            catch (err) {
+                results.push({
+                    id: task.id,
+                    title: task.title,
+                    status: "fail",
+                    detail: err instanceof Error ? err.message : String(err),
+                    durationMs: Date.now() - t0,
+                });
+            }
+        }
+    }
+    finally {
+        if (!options.keepTemp) {
+            await rm(workspaceDir, { recursive: true, force: true }).catch(() => undefined);
+        }
+    }
+    const pass = results.filter((r) => r.status === "pass").length;
+    const fail = results.filter((r) => r.status === "fail").length;
+    const skip = results.filter((r) => r.status === "skip").length;
+    return {
+        total: results.length,
+        pass,
+        fail,
+        skip,
+        results,
+        durationMs: Date.now() - started,
+    };
+}
+export function formatEvalReport(report) {
+    const lines = [
+        "",
+        "🧪 Qling eval:smoke",
+        "-----------------------------------------",
+        `summary: pass=${report.pass} fail=${report.fail} skip=${report.skip} total=${report.total} (${report.durationMs}ms)`,
+    ];
+    for (const r of report.results) {
+        const icon = r.status === "pass" ? "PASS" : r.status === "skip" ? "SKIP" : "FAIL";
+        lines.push(`[${icon}] ${r.id} — ${r.title} (${r.durationMs}ms)`);
+        if (r.status !== "pass" || process.env.QLING_EVAL_VERBOSE === "1") {
+            lines.push(`       ${r.detail}`);
+        }
+    }
+    lines.push("-----------------------------------------");
+    lines.push(report.fail === 0 ? "✅ eval:smoke passed" : "❌ eval:smoke failed");
+    lines.push("");
+    return lines;
+}
+export function evalReportToJson(report) {
+    return JSON.stringify(report, null, 2);
+}

package/dist/eval/tasks.d.ts

@@ -0,0 +1,3 @@
+import type { EvalTask } from "./types.js";
+export declare function buildEvalSmokeTasks(): EvalTask[];
+//# sourceMappingURL=tasks.d.ts.map

package/dist/eval/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/eval/tasks.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAsC3C,wBAAgB,mBAAmB,IAAI,QAAQ,EAAE,CA2JhD"}

package/dist/eval/tasks.js

@@ -0,0 +1,179 @@
+// ============================================================
+// 轻灵 - 本地 smoke 评测任务集
+// ============================================================
+import { writeFile, readFile, mkdir } from "fs/promises";
+import { join } from "path";
+import { checkSensitiveWriteTarget, isPathAllowedForWrite, resolveWriteSandboxMode, } from "../runtime-paths.js";
+import { resolveNetworkGuardMode, checkUrlFetchPolicy } from "../guard.js";
+import { getProviderPreset, listProviderPresets } from "../providers/presets.js";
+import { buildOnboardingSteps } from "../onboarding/tutorial.js";
+import { listMcpPresets, getMcpPreset } from "../mcp/presets.js";
+import { PLAN_MODE_DENY_TOOLS, HookManager } from "../pipeline/hooks.js";
+import { formatToolOutputCard } from "../tui/shell.js";
+function miniGuard(overrides = {}) {
+    return {
+        enabled: true,
+        network: {
+            url_fetch: {
+                allowed_url_prefixes: ["https://"],
+                deny_private_ips: true,
+                follow_redirects: false,
+                ...overrides,
+            },
+        },
+        redaction: { enabled: false, patterns: [] },
+        audit: { jsonl_path: "" },
+        rate_limit: { enabled: false, max_per_minute: 0 },
+        content_filter: {
+            enabled: false,
+            pii_detection: false,
+            injection_detection: false,
+            custom_patterns: [],
+        },
+        permissions: { default: "allow", rules: [] },
+    };
+}
+export function buildEvalSmokeTasks() {
+    return [
+        {
+            id: "write-sandbox-default",
+            title: "写沙箱默认 workspace",
+            run: async () => {
+                const mode = resolveWriteSandboxMode({});
+                const ok = mode === "workspace";
+                return { ok, detail: `mode=${mode}` };
+            },
+        },
+        {
+            id: "write-sandbox-blocks-outside",
+            title: "写沙箱拒绝工作区外路径",
+            run: async ({ workspaceDir }) => {
+                const roots = {
+                    workspaceDir,
+                    fileCacheDir: join(workspaceDir, ".cache"),
+                    fileStateDir: join(workspaceDir, ".state"),
+                };
+                const inside = isPathAllowedForWrite(join(workspaceDir, "a.ts"), roots, "workspace");
+                const outside = isPathAllowedForWrite(join(workspaceDir, "..", "out.ts"), roots, "workspace");
+                const ok = inside && !outside;
+                return { ok, detail: `inside=${inside} outside=${outside}` };
+            },
+        },
+        {
+            id: "sensitive-write-env",
+            title: "敏感写拦截 .env",
+            run: async ({ workspaceDir }) => {
+                const hit = checkSensitiveWriteTarget(join(workspaceDir, ".env"), {});
+                const ok = Boolean(hit?.blocked);
+                return { ok, detail: hit?.code ?? "no-block" };
+            },
+        },
+        {
+            id: "network-mode-deny",
+            title: "网络 mode=deny 阻断 https",
+            run: async () => {
+                const decision = await checkUrlFetchPolicy(new URL("https://example.com"), miniGuard(), { QLING_GUARD_NETWORK_MODE: "deny" });
+                return {
+                    ok: decision.allowed === false,
+                    detail: decision.reason ?? "no-reason",
+                };
+            },
+        },
+        {
+            id: "network-mode-open-http",
+            title: "网络 mode=open 允许 http",
+            run: async () => {
+                const mode = resolveNetworkGuardMode({ QLING_GUARD_NETWORK_MODE: "open" });
+                const decision = await checkUrlFetchPolicy(new URL("http://example.com"), miniGuard(), { QLING_GUARD_NETWORK_MODE: "open" });
+                return {
+                    ok: mode === "open" && decision.allowed === true,
+                    detail: `mode=${mode} allowed=${decision.allowed}`,
+                };
+            },
+        },
+        {
+            id: "provider-presets",
+            title: "Provider 预设含 ollama/deepseek",
+            run: async () => {
+                const list = listProviderPresets();
+                const ollama = getProviderPreset("ollama");
+                const ok = list.length >= 8 && ollama?.provider === "ollama";
+                return { ok, detail: `count=${list.length} ollama=${ollama?.id}` };
+            },
+        },
+        {
+            id: "mcp-presets",
+            title: "MCP 预设表非空且可解析",
+            run: async () => {
+                const list = listMcpPresets();
+                const fs = getMcpPreset("filesystem");
+                const ok = list.length >= 3 && Boolean(fs?.server?.command);
+                return { ok, detail: `count=${list.length} filesystem=${fs?.id}` };
+            },
+        },
+        {
+            id: "plan-mode-denies-write",
+            title: "Plan Mode 拒绝 write",
+            run: async () => {
+                const hm = new HookManager([
+                    { name: "write", description: "w", parameters: { type: "object", properties: {} } },
+                    { name: "read", description: "r", parameters: { type: "object", properties: {} } },
+                ], miniGuard());
+                hm.setPlanMode(true);
+                const baseCtx = {
+                    arguments: {},
+                    inputSchema: {},
+                    isConcurrencySafe: true,
+                    dangerousPatterns: [],
+                };
+                const write = await hm.runPreHook({
+                    ...baseCtx,
+                    toolName: "write",
+                    isReadOnly: false,
+                    isDestructive: false,
+                });
+                const read = await hm.runPreHook({
+                    ...baseCtx,
+                    toolName: "read",
+                    isReadOnly: true,
+                    isDestructive: false,
+                });
+                const ok = write.decision === "deny" &&
+                    read.decision === "allow" &&
+                    PLAN_MODE_DENY_TOOLS.includes("write");
+                return { ok, detail: `write=${write.decision} read=${read.decision}` };
+            },
+        },
+        {
+            id: "onboarding-steps",
+            title: "Onboarding 至少 3 步",
+            run: async () => {
+                const steps = buildOnboardingSteps();
+                return { ok: steps.length >= 3, detail: `steps=${steps.length}` };
+            },
+        },
+        {
+            id: "tool-output-card-collapse",
+            title: "工具输出折叠卡片",
+            run: async () => {
+                const long = Array.from({ length: 20 }, (_, i) => `L${i}`).join("\n");
+                const card = formatToolOutputCard(long, { expand: false });
+                return {
+                    ok: card.collapsed && card.hidden > 0,
+                    detail: `hidden=${card.hidden} lines=${card.totalLines}`,
+                };
+            },
+        },
+        {
+            id: "workspace-roundtrip",
+            title: "工作区读写往返",
+            run: async ({ workspaceDir }) => {
+                await mkdir(workspaceDir, { recursive: true });
+                const file = join(workspaceDir, "eval-roundtrip.txt");
+                await writeFile(file, "qling-eval\n", "utf8");
+                const text = await readFile(file, "utf8");
+                return { ok: text.includes("qling-eval"), detail: `bytes=${text.length}` };
+            },
+        },
+    ];
+}

package/dist/eval/types.d.ts

@@ -0,0 +1,31 @@
+export type EvalStatus = "pass" | "fail" | "skip";
+export interface EvalTaskContext {
+    /** 临时工作目录（由 runner 提供） */
+    workspaceDir: string;
+    env: NodeJS.ProcessEnv;
+}
+export interface EvalTask {
+    id: string;
+    title: string;
+    /** 纯本地、无网络、无真实 LLM */
+    run: (ctx: EvalTaskContext) => Promise<{
+        ok: boolean;
+        detail: string;
+    }>;
+}
+export interface EvalTaskResult {
+    id: string;
+    title: string;
+    status: EvalStatus;
+    detail: string;
+    durationMs: number;
+}
+export interface EvalReport {
+    total: number;
+    pass: number;
+    fail: number;
+    skip: number;
+    results: EvalTaskResult[];
+    durationMs: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/eval/types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,GAAG,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/eval/types.js

@@ -0,0 +1,4 @@
+// ============================================================
+// 轻灵 - 本地评测类型（不依赖外部 LLM）
+// ============================================================
+export {};