@qlingzzy/qling 1.0.0

package/dist/commands/loop.js

@@ -0,0 +1,138 @@
+import { DEFAULT_LOOP_INTERVAL_MS, resolveLoopPrompt } from "../session/loop-prompt.js";
+import { evaluateIsolationPolicy } from "../agents/isolation-policy.js";
+function parseIntervalToken(token) {
+    if (!token)
+        return null;
+    const match = token.trim().match(/^(\d+)(s|m|h|d)$/i);
+    if (!match)
+        return null;
+    const value = Number(match[1]);
+    const unit = match[2].toLowerCase();
+    if (!Number.isFinite(value) || value <= 0)
+        return null;
+    switch (unit) {
+        case "s":
+            return value * 1000;
+        case "m":
+            return value * 60 * 1000;
+        case "h":
+            return value * 60 * 60 * 1000;
+        case "d":
+            return value * 24 * 60 * 60 * 1000;
+        default:
+            return null;
+    }
+}
+function formatInterval(ms) {
+    if (ms % (24 * 60 * 60 * 1000) === 0)
+        return `${ms / (24 * 60 * 60 * 1000)}d`;
+    if (ms % (60 * 60 * 1000) === 0)
+        return `${ms / (60 * 60 * 1000)}h`;
+    if (ms % (60 * 1000) === 0)
+        return `${ms / (60 * 1000)}m`;
+    if (ms % 1000 === 0)
+        return `${ms / 1000}s`;
+    return `${ms}ms`;
+}
+export const loopCommand = {
+    name: "/loop",
+    aliases: ["/循环"],
+    description: "在当前 session 中周期性重跑 prompt",
+    usage: "/loop [interval] [prompt]",
+    execute: async (args, context) => {
+        const scheduler = context.scheduler;
+        if (!scheduler || typeof scheduler.createLoopTask !== "function") {
+            context.writeError("❌ 当前会话未启用 loop 调度器。");
+            return;
+        }
+        const sub = args[0]?.toLowerCase();
+        const daemonMode = sub === "daemon" || sub === "durable" || sub === "bg";
+        if (sub === "stop" || sub === "cancel") {
+            const taskId = args[1];
+            if (!taskId) {
+                context.writeError("❌ 用法: /loop stop <id>");
+                return;
+            }
+            const canceled = await scheduler.cancelTask(taskId);
+            context.writeLine("");
+            context.writeLine(`🛑 已停止 loop 任务 ${canceled.id}`);
+            context.writeLine("");
+            return;
+        }
+        const loopArgs = daemonMode ? args.slice(1) : args;
+        const leadingInterval = parseIntervalToken(loopArgs[0]);
+        const promptArgs = leadingInterval === null ? loopArgs : loopArgs.slice(1);
+        const inlinePrompt = promptArgs.join(" ").trim();
+        const resolved = await resolveLoopPrompt({
+            workspaceDir: context.workspaceDir ??
+                (typeof context.agentLoop.getWorkspaceDir === "function"
+                    ? context.agentLoop.getWorkspaceDir()
+                    : process.cwd()),
+            homeDir: context.homeDir,
+            inlinePrompt: inlinePrompt || undefined,
+        });
+        const intervalMs = leadingInterval ?? DEFAULT_LOOP_INTERVAL_MS;
+        const mode = leadingInterval === null ? "default" : "fixed";
+        if (daemonMode) {
+            const workspaceDir = context.workspaceDir ??
+                (typeof context.agentLoop.getWorkspaceDir === "function"
+                    ? context.agentLoop.getWorkspaceDir()
+                    : process.cwd());
+            const isolation = await evaluateIsolationPolicy({
+                workspaceDir,
+                mode: process.env.QLING_AGENTS_ISOLATION_MODE === "off" ? "off" : "worktree",
+                requireGit: process.env.QLING_AGENTS_ISOLATION_REQUIRE_GIT !== "false",
+                nonGitPolicy: process.env.QLING_AGENTS_ISOLATION_NON_GIT_POLICY === "deny"
+                    ? "deny"
+                    : process.env.QLING_AGENTS_ISOLATION_NON_GIT_POLICY === "off"
+                        ? "off"
+                        : "warn",
+            });
+            if (isolation.level === "deny") {
+                context.writeError(`❌ ${isolation.message ?? "当前 workspace 不允许 daemon 隔离执行。"}`);
+                return;
+            }
+            if (isolation.level === "warn") {
+                context.writeLine(`⚠️ ${isolation.message ?? "当前 workspace 不是 Git 仓库，已降级执行。"}`);
+            }
+        }
+        const task = daemonMode
+            ? await createDaemonLoopTask(context, {
+                prompt: resolved.prompt,
+                intervalMs,
+                mode,
+            })
+            : await scheduler.createLoopTask({
+                prompt: resolved.prompt,
+                intervalMs,
+                mode,
+                runner: "session",
+            });
+        context.writeLine("");
+        context.writeLine(`🔁 【已创建 ${daemonMode ? "Daemon" : "Loop"} 任务】`);
+        context.writeLine("-----------------------------------------");
+        context.writeLine(`任务 ID   : ${task.id}`);
+        context.writeLine(`执行间隔 : ${formatInterval(intervalMs)}`);
+        context.writeLine(`模式     : ${mode}`);
+        context.writeLine(`Runner   : ${task.runner ?? (daemonMode ? "daemon" : "session")}`);
+        context.writeLine(`Prompt 来源: ${resolved.source}${resolved.path ? ` (${resolved.path})` : ""}`);
+        context.writeLine(`Prompt 摘要: ${resolved.prompt.slice(0, 80)}`);
+        if (leadingInterval === null && inlinePrompt) {
+            context.writeLine("说明     : 当前版本对“只给 prompt”的 /loop 采用固定 10m 轮询。");
+        }
+        context.writeLine("-----------------------------------------");
+        context.writeLine("");
+    },
+};
+async function createDaemonLoopTask(context, payload) {
+    if (!context.daemonSessionApi?.createLoopTask) {
+        throw new Error("当前会话未启用 daemon session API。请先启动 `qling daemon start`。");
+    }
+    if (typeof context.agentLoop?.checkpointSession === "function") {
+        await context.agentLoop.checkpointSession();
+    }
+    return context.daemonSessionApi.createLoopTask(context.agentLoop.getSessionId(), {
+        ...payload,
+        runner: "daemon",
+    });
+}

package/dist/commands/mcp.d.ts

@@ -0,0 +1,3 @@
+import { SlashCommand } from "./types.js";
+export declare const mcpCommand: SlashCommand;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1C,eAAO,MAAM,UAAU,EAAE,YAuDxB,CAAC"}

package/dist/commands/mcp.js

@@ -0,0 +1,57 @@
+import { buildLocalMcpReport, formatLocalMcpReport } from "../mcp-report.js";
+import { formatMcpPresetTable } from "../mcp/presets.js";
+import { defaultMcpStorePath, loadMcpStore } from "../mcp/store.js";
+function parseTimeoutEnv(name) {
+    const value = Number(process.env[name]);
+    return Number.isFinite(value) && value >= 0 ? value : 0;
+}
+export const mcpCommand = {
+    name: "/mcp",
+    aliases: ["/外部工具"],
+    description: "查看本地 MCP 配置；提示 presets / add",
+    usage: "/mcp [status|presets|list]",
+    argumentHint: "[status|presets|list]",
+    execute: async (args, context) => {
+        const sub = (args[0] ?? "status").toLowerCase();
+        if (sub === "presets" || sub === "preset") {
+            context.writeLine("");
+            context.writeLine("可用 MCP 预设:");
+            context.writeLine("-----------------------------------------");
+            for (const line of formatMcpPresetTable()) {
+                context.writeLine(line);
+            }
+            context.writeLine("-----------------------------------------");
+            context.writeLine("添加: qling mcp add <preset>");
+            context.writeLine("");
+            return;
+        }
+        if (sub === "list" || sub === "ls") {
+            const store = await loadMcpStore(defaultMcpStorePath());
+            const names = Object.keys(store.servers).sort();
+            context.writeLine("");
+            context.writeLine("本机 MCP store:");
+            context.writeLine("-----------------------------------------");
+            if (names.length === 0) {
+                context.writeLine("(空) — qling mcp add filesystem");
+            }
+            else {
+                for (const name of names) {
+                    const s = store.servers[name];
+                    context.writeLine(`- ${name}: ${s.command} ${(s.args ?? []).join(" ")}`);
+                }
+            }
+            context.writeLine("-----------------------------------------");
+            context.writeLine("");
+            return;
+        }
+        const report = buildLocalMcpReport({
+            servers: {},
+            connection_timeout_ms: parseTimeoutEnv("QLING_MCP_CONNECTION_TIMEOUT_MS"),
+            call_timeout_ms: parseTimeoutEnv("QLING_MCP_CALL_TIMEOUT_MS"),
+        }, process.env);
+        for (const line of formatLocalMcpReport(report)) {
+            context.writeLine(line);
+        }
+        context.writeLine("提示: /mcp presets · qling mcp add <preset> · qling mcp list");
+    },
+};

package/dist/commands/memory.d.ts

@@ -0,0 +1,3 @@
+import { SlashCommand } from "./types.js";
+export declare const memoryCommand: SlashCommand;
+//# sourceMappingURL=memory.d.ts.map

package/dist/commands/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/commands/memory.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA8C1C,eAAO,MAAM,aAAa,EAAE,YAgL3B,CAAC"}

package/dist/commands/memory.js

@@ -0,0 +1,215 @@
+import { homedir } from "os";
+import { join } from "path";
+import { buildLocalMemoryReport, buildLocalMemorySourcesReport, findLocalMemoryEntry, formatLocalMemoryEntry, formatLocalMemoryGraphReport, formatLocalMemoryPracticesReport, formatLocalMemoryReport, formatLocalMemorySearchReport, formatLocalMemorySourcesReport, listLocalMemoryGraph, listLocalMemoryPractices, parseMemoryReportCount, parseMemorySearchArgs, searchLocalMemoryEntries, } from "../memory-report.js";
+function resolveStateDir(context) {
+    const agentLoop = context.agentLoop;
+    return agentLoop.getRuntimeRootDir?.()
+        || process.env.QLING_FILE_STATE_DIR
+        || join(context.homeDir ?? homedir(), ".qling");
+}
+function normalizeSubcommand(value) {
+    const normalized = (value ?? "").toLowerCase();
+    const aliases = {
+        "": "list",
+        "status": "list",
+        "状态": "list",
+        "list": "list",
+        "列表": "list",
+        "practice": "practices",
+        "practices": "practices",
+        "实践": "practices",
+        "经验": "practices",
+        "graph": "graph",
+        "图谱": "graph",
+        "知识图谱": "graph",
+        "search": "search",
+        "搜索": "search",
+        "source": "sources",
+        "sources": "sources",
+        "来源": "sources",
+        "来源图": "sources",
+        "show": "show",
+        "查看": "show",
+        "详情": "show",
+        "add": "add",
+        "添加": "add",
+        "delete": "delete",
+        "remove": "delete",
+        "删除": "delete",
+        "edit": "edit",
+        "update": "edit",
+        "修改": "edit",
+        "更新": "edit",
+    };
+    return aliases[normalized] ?? normalized;
+}
+export const memoryCommand = {
+    name: "/memory",
+    aliases: ["/记忆"],
+    description: "查看本地持久化记忆索引",
+    usage: "/memory [list] [global|workspace] [count] | /memory add <fact> [--global] | /memory delete <id> | /memory edit <id> <new_content>",
+    execute: async (args, context) => {
+        const stateDir = resolveStateDir(context);
+        const [rawSub, ...rest] = args;
+        const sub = normalizeSubcommand(rawSub);
+        const agentLoop = context.agentLoop;
+        const memoryStore = agentLoop.getMemoryStore?.();
+        const workspaceMemoryDir = memoryStore ? memoryStore.getWorkspaceMemoryDir() : join(stateDir, "memory");
+        const globalMemoryDir = memoryStore ? memoryStore.getGlobalMemoryDir() : join(stateDir, "memory/global");
+        if (sub === "add") {
+            const isGlobal = args.includes("--global");
+            const factParts = rest.filter(x => x !== "--global");
+            const fact = factParts.join(" ").trim();
+            if (!fact) {
+                context.writeError("用法: /memory add <fact> [--global]");
+                return;
+            }
+            if (memoryStore) {
+                memoryStore.add(fact, "manual", 0.8, isGlobal ? "global" : "workspace");
+                await memoryStore.saveToDisk();
+                context.writeLine(`成功添加记忆到 ${isGlobal ? "全局" : "工作区"}。`);
+            }
+            else {
+                context.writeError("当前会话不支持内存存储。");
+            }
+            return;
+        }
+        if (sub === "delete" || sub === "remove") {
+            const id = rest[0];
+            if (!id) {
+                context.writeError("用法: /memory delete <id>");
+                return;
+            }
+            if (memoryStore) {
+                const removedWs = memoryStore.remove(id, "workspace");
+                const removedGlobal = memoryStore.remove(id, "global");
+                if (removedWs || removedGlobal) {
+                    await memoryStore.saveToDisk();
+                    context.writeLine(`成功删除记忆 ID: ${id}`);
+                }
+                else {
+                    context.writeError(`未找到记忆 ID: ${id}`);
+                }
+            }
+            else {
+                context.writeError("当前会话不支持内存存储。");
+            }
+            return;
+        }
+        if (sub === "edit" || sub === "update") {
+            const id = rest[0];
+            const newContent = rest.slice(1).join(" ").trim();
+            if (!id || !newContent) {
+                context.writeError("用法: /memory edit <id> <new_content>");
+                return;
+            }
+            if (memoryStore) {
+                const updatedWs = memoryStore.update(id, { content: newContent }, "workspace");
+                const updatedGlobal = memoryStore.update(id, { content: newContent }, "global");
+                if (updatedWs || updatedGlobal) {
+                    await memoryStore.saveToDisk();
+                    context.writeLine(`成功更新记忆 ID: ${id}`);
+                }
+                else {
+                    context.writeError(`未找到记忆 ID: ${id}`);
+                }
+            }
+            else {
+                context.writeError("当前会话不支持内存存储。");
+            }
+            return;
+        }
+        if (sub === "show") {
+            const id = rest[0];
+            if (!id) {
+                context.writeError("用法: /memory show <id>");
+                return;
+            }
+            const entry = (await findLocalMemoryEntry(workspaceMemoryDir, id)) || (await findLocalMemoryEntry(globalMemoryDir, id));
+            if (entry) {
+                for (const line of formatLocalMemoryEntry(entry)) {
+                    context.writeLine(line);
+                }
+            }
+            else {
+                context.writeError(`未找到记忆 ID: ${id}`);
+            }
+            return;
+        }
+        if (sub === "search") {
+            const request = parseMemorySearchArgs(rest);
+            if (!request.query) {
+                context.writeError("用法: /memory search <query> [count]");
+                return;
+            }
+            const wsReport = await searchLocalMemoryEntries(workspaceMemoryDir, request);
+            const globalReport = await searchLocalMemoryEntries(globalMemoryDir, request);
+            const mergedEntries = [
+                ...wsReport.entries.map(e => ({ ...e, preview: "[工作区] " + e.preview })),
+                ...globalReport.entries.map(e => ({ ...e, preview: "[全局] " + e.preview }))
+            ];
+            mergedEntries.sort((a, b) => b.score - a.score);
+            const report = {
+                stateDir: workspaceMemoryDir,
+                memoryDir: workspaceMemoryDir,
+                memoryFile: join(workspaceMemoryDir, "memory.json"),
+                query: request.query,
+                entries: mergedEntries.slice(0, request.count),
+                totalEntries: wsReport.totalEntries + globalReport.totalEntries,
+                totalMatches: wsReport.totalMatches + globalReport.totalMatches,
+                requestedCount: request.count,
+                truncated: mergedEntries.length > request.count,
+                warnings: [...wsReport.warnings, ...globalReport.warnings],
+            };
+            for (const line of formatLocalMemorySearchReport(report)) {
+                context.writeLine(line);
+            }
+            return;
+        }
+        if (sub === "practices") {
+            const report = await listLocalMemoryPractices(workspaceMemoryDir, {
+                count: parseMemoryReportCount(rest[0]),
+            });
+            for (const line of formatLocalMemoryPracticesReport(report)) {
+                context.writeLine(line);
+            }
+            return;
+        }
+        if (sub === "sources") {
+            const report = await buildLocalMemorySourcesReport(workspaceMemoryDir);
+            for (const line of formatLocalMemorySourcesReport(report)) {
+                context.writeLine(line);
+            }
+            return;
+        }
+        if (sub === "graph") {
+            const report = await listLocalMemoryGraph(workspaceMemoryDir, {
+                count: parseMemoryReportCount(rest[0]),
+            });
+            for (const line of formatLocalMemoryGraphReport(report)) {
+                context.writeLine(line);
+            }
+            return;
+        }
+        // List operation
+        let targetDir = workspaceMemoryDir;
+        let countVal = undefined;
+        if (rawSub === "global" || rawSub === "全局") {
+            targetDir = globalMemoryDir;
+            countVal = rest[0];
+        }
+        else if (rawSub === "workspace" || rawSub === "工作区") {
+            targetDir = workspaceMemoryDir;
+            countVal = rest[0];
+        }
+        else {
+            countVal = rawSub === "list" ? rest[0] : rawSub;
+        }
+        const report = await buildLocalMemoryReport(targetDir, {
+            count: parseMemoryReportCount(countVal),
+        });
+        for (const line of formatLocalMemoryReport(report)) {
+            context.writeLine(line);
+        }
+    },
+};

package/dist/commands/mission.d.ts

@@ -0,0 +1,3 @@
+import { SlashCommand } from "./types.js";
+export declare const missionCommand: SlashCommand;
+//# sourceMappingURL=mission.d.ts.map

package/dist/commands/mission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission.d.ts","sourceRoot":"","sources":["../../src/commands/mission.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA0E1C,eAAO,MAAM,cAAc,EAAE,YAgE5B,CAAC"}

package/dist/commands/mission.js

@@ -0,0 +1,129 @@
+import { homedir } from "os";
+import { join } from "path";
+import { renderAgentsView, renderMissionEvents } from "../cli/mission-views.js";
+import { MissionManager } from "../mission/manager.js";
+const SUBCOMMAND_ALIASES = {
+    "": "list",
+    "列表": "list",
+    "查看": "show",
+    detail: "show",
+    "详情": "show",
+    "日志": "logs",
+    log: "logs",
+    "暂停": "pause",
+    "恢复": "resume",
+    "取消": "cancel",
+    "停止": "cancel",
+    "终止": "cancel",
+    stop: "cancel",
+    terminate: "cancel",
+    "重试": "retry",
+    respawn: "retry",
+};
+function resolveStateDir(context) {
+    const loop = context.agentLoop;
+    const runtimeRoot = typeof loop.getRuntimeRootDir === "function" ? loop.getRuntimeRootDir() : undefined;
+    return runtimeRoot || process.env.QLING_FILE_STATE_DIR || join(context.homeDir ?? homedir(), ".qling");
+}
+function normalizeSubcommand(value) {
+    const key = (value ?? "").toLowerCase();
+    return SUBCOMMAND_ALIASES[key] ?? key;
+}
+function formatTimestamp(value) {
+    return value ? new Date(value).toLocaleString() : "-";
+}
+function formatMissionDetail(mission) {
+    const lines = [
+        "",
+        "🧭 【使命详情】",
+        "-----------------------------------------",
+        `ID       : ${mission.id}`,
+        `名称     : ${mission.name}`,
+        `状态     : ${mission.status}`,
+        `会话     : ${mission.sessionId}`,
+        `创建     : ${formatTimestamp(mission.createdAt)}`,
+        `更新     : ${formatTimestamp(mission.updatedAt)}`,
+    ];
+    if (mission.sourceMissionId) {
+        lines.push(`来源使命 : ${mission.sourceMissionId}`);
+    }
+    if (mission.error) {
+        lines.push(`错误     : [${mission.error.code}] ${mission.error.message}`);
+    }
+    lines.push(`任务     : ${mission.description}`);
+    lines.push("-----------------------------------------", "");
+    return lines;
+}
+async function createManager(context) {
+    const manager = new MissionManager(resolveStateDir(context));
+    await manager.init();
+    return manager;
+}
+function requireMissionId(id, usage, context) {
+    if (id)
+        return id;
+    context.writeError(`❌ 用法: ${usage}`);
+    return null;
+}
+export const missionCommand = {
+    name: "/mission",
+    aliases: ["/使命"],
+    description: "查看或控制本地 mission",
+    usage: "/mission list|show|logs|pause|resume|cancel|terminate|retry <id>",
+    execute: async (args, context) => {
+        const sub = normalizeSubcommand(args[0]);
+        const id = args[1];
+        try {
+            const manager = await createManager(context);
+            if (sub === "list") {
+                context.writeLine(renderAgentsView(manager.listMissions()));
+                return;
+            }
+            if (sub === "show") {
+                const missionId = requireMissionId(id, "/mission show <id>", context);
+                if (!missionId)
+                    return;
+                for (const line of formatMissionDetail(manager.getMissionOrThrow(missionId))) {
+                    context.writeLine(line);
+                }
+                return;
+            }
+            if (sub === "logs") {
+                const missionId = requireMissionId(id, "/mission logs <id>", context);
+                if (!missionId)
+                    return;
+                context.writeLine(renderMissionEvents(await manager.getMissionLogs(missionId)));
+                return;
+            }
+            if (sub === "pause" || sub === "resume" || sub === "cancel") {
+                const missionId = requireMissionId(id, `/mission ${sub} <id>`, context);
+                if (!missionId)
+                    return;
+                const mission = sub === "pause"
+                    ? await manager.pauseMission(missionId, "slash_local")
+                    : sub === "resume"
+                        ? await manager.resumeMission(missionId, "slash_local")
+                        : await manager.cancelMission(missionId, "slash_local");
+                for (const line of formatMissionDetail(mission)) {
+                    context.writeLine(line);
+                }
+                return;
+            }
+            if (sub === "retry") {
+                const missionId = requireMissionId(id, "/mission retry <id>", context);
+                if (!missionId)
+                    return;
+                const mission = await manager.retryMission(missionId);
+                context.writeLine(`🔄 已创建本地重试使命: ${mission.id}`);
+                for (const line of formatMissionDetail(mission)) {
+                    context.writeLine(line);
+                }
+                return;
+            }
+            context.writeError("❌ 用法: /mission list|show|logs|pause|resume|cancel|terminate|retry <id>");
+        }
+        catch (err) {
+            context.writeError(`❌ mission 操作失败: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    },
+};

package/dist/commands/permissions.d.ts

@@ -0,0 +1,3 @@
+import { SlashCommand } from "./types.js";
+export declare const permissionsCommand: SlashCommand;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/commands/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../src/commands/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA4C1C,eAAO,MAAM,kBAAkB,EAAE,YAsDhC,CAAC"}

package/dist/commands/permissions.js

@@ -0,0 +1,82 @@
+import { formatPermissionMode } from "../statusline.js";
+import { explainLocalPermissionDecision, formatPermissionExplanationReport, } from "../permissions-report.js";
+const MODES = ["allow", "deny", "ask"];
+function isMode(value) {
+    return MODES.includes(value);
+}
+function resolveCurrentMode(context) {
+    const fromLoop = context.agentLoop?.getPermissionMode?.();
+    if (typeof fromLoop === "string" && isMode(fromLoop.toLowerCase())) {
+        return fromLoop.toLowerCase();
+    }
+    const fromEnv = String(process.env.QLING_GUARD_PERMISSIONS_DEFAULT ?? "allow").toLowerCase();
+    if (isMode(fromEnv)) {
+        return fromEnv;
+    }
+    return "allow";
+}
+function parseEnvPermissionRules(env) {
+    const raw = env.QLING_GUARD_PERMISSIONS_RULES;
+    if (!raw)
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter((entry) => Boolean(entry && typeof entry === "object"));
+    }
+    catch {
+        return [];
+    }
+}
+export const permissionsCommand = {
+    name: "/permissions",
+    aliases: ["/权限", "/allowed-tools"],
+    description: "查看或切换工具权限默认策略",
+    usage: "/permissions [status|allow|deny|ask|explain <tool>]",
+    execute: async (args, context) => {
+        const first = (args[0] ?? "status").toLowerCase();
+        if (first === "explain" || first === "解释") {
+            const toolName = args[1];
+            if (!toolName) {
+                context.writeError("❌ 用法: /permissions explain <tool>");
+                return;
+            }
+            const report = explainLocalPermissionDecision({
+                defaultMode: resolveCurrentMode(context),
+                rules: parseEnvPermissionRules(process.env),
+                env: process.env,
+            }, toolName);
+            for (const line of formatPermissionExplanationReport(report)) {
+                context.writeLine(line);
+            }
+            return;
+        }
+        if (first === "status") {
+            const mode = resolveCurrentMode(context);
+            context.writeLine("");
+            context.writeLine("🔐 【权限模式】");
+            context.writeLine("-----------------------------------------");
+            context.writeLine(`Default   : ${formatPermissionMode(mode)}`);
+            context.writeLine("说明      : allow=自动放行, ask=询问确认, deny=默认拒绝");
+            context.writeLine("-----------------------------------------");
+            context.writeLine("");
+            return;
+        }
+        if (!isMode(first)) {
+            context.writeError("❌ 用法: /permissions [status|allow|deny|ask|explain <tool>]");
+            return;
+        }
+        const setMode = context.agentLoop?.setPermissionMode;
+        if (typeof setMode === "function") {
+            await setMode.call(context.agentLoop, first);
+        }
+        process.env.QLING_GUARD_PERMISSIONS_DEFAULT = first;
+        process.env.QLING_PERMISSIONS_MODE = first;
+        const mode = resolveCurrentMode(context);
+        context.writeLine("");
+        context.writeLine(`🔐 权限默认策略已切换为: ${formatPermissionMode(mode)}`);
+        context.writeLine("说明: 后续工具调用将按新策略执行。");
+        context.writeLine("");
+    },
+};

package/dist/commands/privacy.d.ts

@@ -0,0 +1,3 @@
+import { SlashCommand } from "./types.js";
+export declare const privacyCommand: SlashCommand;
+//# sourceMappingURL=privacy.d.ts.map

package/dist/commands/privacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.d.ts","sourceRoot":"","sources":["../../src/commands/privacy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,cAAc,EAAE,YAW5B,CAAC"}