@qlingzzy/qling 1.0.0

package/dist/commands/connect.js

@@ -0,0 +1,102 @@
+// P4: 国内平台连接器引导
+// 统一入口 /connect 或 qling connect
+// 先完善 Telegram/Slack, 规划 Feishu/DingTalk/WeChat
+// 中文指南 + doctor 检查 + 脱敏
+const CONNECTORS = {
+    telegram: {
+        name: "Telegram",
+        guide: "准备: Bot Token (从 @BotFather 获取)\n权限: 机器人需有 chat 权限\n存放: 环境变量 QLING_CHANNEL_TELEGRAM_TOKEN\n测试: /connect telegram test",
+        env: "QLING_CHANNEL_TELEGRAM_TOKEN",
+        doctor: "检查 token 是否设置, 网络连通",
+    },
+    slack: {
+        name: "Slack",
+        guide: "准备: Bot Token, App Token, Channel IDs\n权限: 机器人需加入频道\n存放: QLING_CHANNEL_SLACK_BOT_TOKEN 等\n测试: /connect slack test",
+        env: "QLING_CHANNEL_SLACK_BOT_TOKEN",
+        doctor: "检查 tokens, app 权限",
+    },
+    feishu: {
+        name: "飞书 (Feishu)",
+        guide: "准备: App ID, App Secret, User Access Token\n权限: 应用需有 im:message 权限\n存放: 环境变量 (暂未内置)\n规划中: 使用 lark-cli 集成",
+        env: "QLING_CHANNEL_FEISHU_APP_ID",
+        doctor: "检查 token, 飞书开放平台权限",
+    },
+    dingtalk: {
+        name: "钉钉 (DingTalk)",
+        guide: "准备: AppKey, AppSecret, Agent ID\n权限: 机器人权限\n存放: 环境变量\n规划中",
+        env: "QLING_CHANNEL_DINGTALK_APPKEY",
+        doctor: "检查配置, 钉钉连接",
+    },
+    wechat: {
+        name: "微信 (WeChat)",
+        guide: "准备: 公众号/企业微信配置\n注意: 敏感, 推荐使用 opencli 或外部桥接\n存放: 绝不写入 .env\n规划中: 参考 LangBot",
+        env: "",
+        doctor: "使用 doctor 检查 webhook 等",
+    },
+};
+export const connectCommand = {
+    name: "/connect",
+    aliases: ["/连接", "/connector"],
+    description: "国内平台连接器引导 (P4)",
+    usage: "/connect [telegram|slack|feishu|dingtalk|wechat] [test|guide]",
+    execute: async (args, context) => {
+        const sub = (args[0] || "").toLowerCase();
+        const action = (args[1] || "").toLowerCase();
+        context.writeLine("");
+        context.writeLine("🔗 【轻灵连接器】国内平台引导");
+        context.writeLine("-----------------------------------------");
+        if (!sub || sub === "help") {
+            context.writeLine("支持: telegram, slack, feishu, dingtalk, wechat");
+            context.writeLine("用法: /connect <平台> guide | test");
+            context.writeLine("示例: /connect telegram guide");
+            context.writeLine("优先: 完善 Telegram/Slack, 规划其他");
+            context.writeLine("敏感: 绝不保存明文到 .env, 用 doctor 检查");
+        }
+        else if (CONNECTORS[sub]) {
+            const c = CONNECTORS[sub];
+            if (action === "guide" || action === "指南") {
+                context.writeLine(`${c.name} 准备向导:`);
+                context.writeLine(c.guide);
+                context.writeLine(`环境变量: ${c.env || "参考 config"}`);
+                context.writeLine("敏感: 绝不写入 .env，使用系统环境变量或 secret store");
+            }
+            else if (action === "test" || action === "测试") {
+                context.writeLine(`正在测试 ${c.name} 连通性...`);
+                const token = process.env[c.env] || "";
+                if (!token) {
+                    context.writeLine(`❌ ${c.name} 测试失败: 未设置 ${c.env}`);
+                    context.writeLine("提示: 运行 qling doctor 检查配置");
+                    context.writeLine("常见: token 缺失或错误");
+                }
+                else if (sub === "telegram") {
+                    // 实际简单测试：调用 getMe (不泄露 token)
+                    try {
+                        // 模拟或实际 axios getMe，但为脱敏，这里用提示
+                        context.writeLine("✅ Token 已设置，尝试连通性检查 (使用 doctor 验证完整)");
+                        context.writeLine("提示: 真实测试需在 TUI 或启用 channel 后运行");
+                    }
+                    catch (e) {
+                        context.writeLine(`❌ 测试失败: ${e}`);
+                    }
+                }
+                else {
+                    context.writeLine("✅ 配置存在，使用 doctor 进行详细检查");
+                    context.writeLine("常见失败: token 无效, 权限不足, 网络问题");
+                }
+            }
+            else {
+                context.writeLine(`${c.name} 信息:`);
+                context.writeLine(c.guide.split("\n")[0]);
+                context.writeLine("使用 /connect " + sub + " guide 获取完整指南");
+            }
+        }
+        else {
+            context.writeLine("未知平台: " + sub);
+            context.writeLine("可用: " + Object.keys(CONNECTORS).join(", "));
+        }
+        context.writeLine("-----------------------------------------");
+        context.writeLine("边界: 敏感 token 用环境变量或 secret store");
+        context.writeLine("复用: scanner + doctor 警告");
+        context.writeLine("");
+    },
+};

package/dist/commands/context.d.ts

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

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

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

package/dist/commands/context.js

@@ -0,0 +1,13 @@
+import { buildContextReport, formatContextReport } from "../context-report.js";
+export const contextCommand = {
+    name: "/context",
+    aliases: ["/上下文"],
+    description: "查看当前会话上下文占用与本地留存路径",
+    usage: "/context",
+    execute: async (_args, context) => {
+        const report = await buildContextReport(context);
+        for (const line of formatContextReport(report)) {
+            context.writeLine(line);
+        }
+    },
+};

package/dist/commands/dashboard.d.ts

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

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

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

package/dist/commands/dashboard.js

@@ -0,0 +1,22 @@
+export const dashboardCommand = {
+    name: "/dashboard",
+    description: "获取观测控制台链接",
+    usage: "/dashboard",
+    execute: async (_args, context) => {
+        const port = process.env.QLING_DASHBOARD_PORT || "9999";
+        const enabled = process.env.QLING_FEATURES_DASHBOARD === "true";
+        context.writeLine("");
+        context.writeLine("📊 【Observability Dashboard】");
+        context.writeLine("-----------------------------------------");
+        if (enabled) {
+            context.writeLine(`本地链接 : http://localhost:${port}`);
+            context.writeLine("状态     : 运行中");
+        }
+        else {
+            context.writeLine("状态     : 未开启");
+            context.writeLine("提示     : 请设置环境变量 QLING_FEATURES_DASHBOARD=true 以启用。");
+        }
+        context.writeLine("-----------------------------------------");
+        context.writeLine("");
+    },
+};

package/dist/commands/detach.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"detach.d.ts","sourceRoot":"","sources":["../../src/commands/detach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,eAAO,MAAM,aAAa,EAAE,YA+C3B,CAAC"}

package/dist/commands/detach.js

@@ -0,0 +1,44 @@
+import axios from "axios";
+export const detachCommand = {
+    name: "/detach",
+    description: "将当前任务脱离终端在后台运行 (v0.5 M3)",
+    usage: "/detach",
+    execute: async (_args, context) => {
+        const DAEMON_PORT = process.env.QLING_DAEMON_PORT || "9998";
+        const endpoint = `http://localhost:${DAEMON_PORT}/missions`;
+        context.writeLine("");
+        context.writeLine("🚀 【正在尝试后台脱离...】");
+        try {
+            // 1. 获取当前状态快照
+            const checkpoint = context.agentLoop.getWorkflowRuntime().getCheckpoint();
+            const stats = {
+                turnCount: context.agentLoop.turnCount,
+                sessionTokens: context.agentLoop.sessionTokens,
+            };
+            // 2. 提交至守护进程
+            await axios.post(endpoint, {
+                name: "Detached Mission",
+                description: "从交互式会话脱离的任务",
+                sessionId: context.agentLoop.getSessionId(),
+                checkpoint,
+                stats,
+            }, { timeout: 3000 });
+            context.writeLine("-----------------------------------------");
+            context.writeLine("✅ 使命已成功移交至 qlingd 守护进程。");
+            context.writeLine("状态 : 已脱离 (Detached)");
+            context.writeLine("提示 : 您现在可以安全地关闭此终端。");
+            context.writeLine("查看 : 请访问 Dashboard 或输入 qling mission list");
+            context.writeLine("-----------------------------------------");
+            context.writeLine("");
+            // 触发本进程退出逻辑
+            process.exit(0);
+        }
+        catch (err) {
+            context.writeError("-----------------------------------------");
+            context.writeError("❌ 脱离失败: 守护进程 qlingd 未响应。");
+            context.writeError("请先执行 `qling daemon start` 启动后台守护进程。");
+            context.writeError("-----------------------------------------");
+            context.writeError("");
+        }
+    },
+};

package/dist/commands/distill.d.ts

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

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

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

package/dist/commands/distill.js

@@ -0,0 +1,23 @@
+import { homedir } from "os";
+import { join } from "path";
+import { formatLocalMemoryPracticesReport, listLocalMemoryPractices, parseMemoryReportCount, } 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");
+}
+export const distillCommand = {
+    name: "/distill",
+    aliases: ["/蒸馏", "/经验"],
+    description: "查看本地蒸馏实践摘要",
+    usage: "/distill [count]",
+    execute: async (args, context) => {
+        const report = await listLocalMemoryPractices(resolveStateDir(context), {
+            count: parseMemoryReportCount(args[0]),
+        });
+        for (const line of formatLocalMemoryPracticesReport(report)) {
+            context.writeLine(line);
+        }
+    },
+};

package/dist/commands/doctor.d.ts

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

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

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

package/dist/commands/doctor.js

@@ -0,0 +1,13 @@
+import { buildDoctorReport, formatDoctorReport } from "../doctor.js";
+export const doctorCommand = {
+    name: "/doctor",
+    aliases: ["/诊断"],
+    description: "运行本地稳定性与数据留存诊断",
+    usage: "/doctor",
+    execute: async (_args, context) => {
+        const report = await buildDoctorReport(context);
+        for (const line of formatDoctorReport(report)) {
+            context.writeLine(line);
+        }
+    },
+};

package/dist/commands/dream.d.ts

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

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

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

package/dist/commands/dream.js

@@ -0,0 +1,59 @@
+import { extractDreamMemories } from "../memory.js";
+function parseCount(value) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return 4;
+    return Math.min(Math.floor(parsed), 20);
+}
+function getConversationMessages(context) {
+    const agentLoop = context.agentLoop;
+    if (typeof agentLoop.getMessagesSnapshot !== "function")
+        return [];
+    const messages = agentLoop.getMessagesSnapshot();
+    if (!Array.isArray(messages))
+        return [];
+    return messages.filter((message) => message.role === "user" || message.role === "assistant");
+}
+function getExistingMemoryContents(memoryStore) {
+    if (typeof memoryStore.exportPersisted !== "function")
+        return new Set();
+    const entries = memoryStore.exportPersisted();
+    if (!Array.isArray(entries))
+        return new Set();
+    return new Set(entries
+        .map((entry) => typeof entry?.content === "string" ? entry.content : null)
+        .filter((content) => Boolean(content)));
+}
+export const dreamCommand = {
+    name: "/dream",
+    aliases: ["/记梦", "/沉淀"],
+    description: "将当前会话中的关键信息沉淀到本地记忆",
+    usage: "/dream [count]",
+    execute: async (args, context) => {
+        const agentLoop = context.agentLoop;
+        const memoryStore = typeof agentLoop.getMemoryStore === "function" ? agentLoop.getMemoryStore() : null;
+        if (!memoryStore || typeof memoryStore.add !== "function" || typeof memoryStore.saveToDisk !== "function") {
+            context.writeError("当前会话不支持本地 dream 写入。");
+            return;
+        }
+        const count = parseCount(args[0]);
+        const messages = getConversationMessages(context);
+        const transcript = messages.map((message) => message.content);
+        const memories = await extractDreamMemories({ turnCount: Math.max(transcript.length, count), transcript }, { enabled: true, turnThreshold: 1, transcriptWindow: count });
+        const existingContents = getExistingMemoryContents(memoryStore);
+        const newMemories = memories.filter((memory) => !existingContents.has(memory));
+        if (newMemories.length === 0) {
+            context.writeLine("dream: 没有新的本地记忆候选；未写入、不调用模型、不联网。");
+            return;
+        }
+        for (const memory of newMemories) {
+            memoryStore.add(memory, "manual-dream", 0.7);
+        }
+        if (typeof memoryStore.compactPersisted === "function") {
+            memoryStore.compactPersisted(1000);
+        }
+        await memoryStore.saveToDisk();
+        context.writeLine(`dream: 已沉淀 ${newMemories.length} 条本地记忆。`);
+        context.writeLine("边界: 未输出记忆正文；只读取当前 user/assistant 消息；不调用模型、不联网。");
+    },
+};

package/dist/commands/export.d.ts

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

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

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

package/dist/commands/export.js

@@ -0,0 +1,18 @@
+import { writeSessionExport } from "../session-export.js";
+export const exportCommand = {
+    name: "/export",
+    aliases: ["/导出"],
+    description: "将当前会话导出为本地 Markdown",
+    usage: "/export",
+    execute: async (_args, context) => {
+        const result = await writeSessionExport(context);
+        context.writeLine("");
+        context.writeLine("📄 会话已导出");
+        context.writeLine("-----------------------------------------");
+        context.writeLine(`Path      : ${result.path}`);
+        context.writeLine(`Messages  : ${result.messageCount}`);
+        context.writeLine("说明      : 导出只读取本地会话快照，不调用模型、不联网。");
+        context.writeLine("-----------------------------------------");
+        context.writeLine("");
+    },
+};

package/dist/commands/exports.d.ts

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

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

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

package/dist/commands/exports.js

@@ -0,0 +1,15 @@
+import { formatSessionExportIndex, listSessionExportFiles, parseSessionExportCount } from "../session-export-index.js";
+export const exportsCommand = {
+    name: "/exports",
+    aliases: ["/导出列表"],
+    description: "查看本地 Markdown 会话导出列表",
+    usage: "/exports [count]",
+    execute: async (args, context) => {
+        const report = await listSessionExportFiles(context, {
+            count: parseSessionExportCount(args[0]),
+        });
+        for (const line of formatSessionExportIndex(report)) {
+            context.writeLine(line);
+        }
+    },
+};

package/dist/commands/goal.d.ts

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

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

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

package/dist/commands/goal.js

@@ -0,0 +1,147 @@
+const CLEAR_ALIASES = new Set(["clear", "stop", "off", "reset", "none", "cancel"]);
+const STATUS_ALIASES = new Set(["status", "show", "list", "状态", "查看", "列表"]);
+const SET_ALIASES = new Set(["set", "设置"]);
+const DAEMON_ALIASES = new Set(["daemon", "durable", "bg"]);
+function formatGoalStatus(goal) {
+    if (!goal) {
+        return ["", "◎ 当前 session 没有 active goal。", ""];
+    }
+    const lines = [
+        "",
+        "◎ /goal 状态",
+        "-----------------------------------------",
+        `状态     : ${goal.status}`,
+        `Runner   : ${goal.runner ?? "session"}`,
+        `Pending  : ${goal.pending ? "yes" : "no"}`,
+        `条件     : ${goal.condition || "(空)"}`,
+        `创建时间 : ${goal.createdAt ? new Date(goal.createdAt).toLocaleString() : "-"}`,
+        `评估轮次 : ${goal.evaluatedTurns ?? 0}`,
+        `最近原因 : ${goal.lastReason ?? "-"}`,
+        "-----------------------------------------",
+        "",
+    ];
+    return lines;
+}
+export const goalCommand = {
+    name: "/goal",
+    aliases: ["/目标"],
+    description: "设置、查询或清除当前 session 的 goal",
+    usage: "/goal [condition|clear]",
+    execute: async (args, context) => {
+        const controller = context.goalController;
+        if (!controller || typeof controller.getGoalStatus !== "function") {
+            context.writeError("❌ 当前会话未启用 goal controller。");
+            return;
+        }
+        if (args.length === 0) {
+            const status = await controller.getGoalStatus();
+            for (const line of formatGoalStatus(status)) {
+                context.writeLine(line);
+            }
+            return;
+        }
+        const firstArg = args[0].toLowerCase();
+        if (STATUS_ALIASES.has(firstArg)) {
+            const status = await controller.getGoalStatus();
+            for (const line of formatGoalStatus(status)) {
+                context.writeLine(line);
+            }
+            return;
+        }
+        if (CLEAR_ALIASES.has(firstArg)) {
+            const cleared = await controller.clearGoal("user_clear");
+            context.writeLine("");
+            context.writeLine(`🛑 已清除 goal: ${cleared.condition || "(空)"}`);
+            context.writeLine("");
+            return;
+        }
+        if (DAEMON_ALIASES.has(firstArg)) {
+            const daemonApi = context.daemonSessionApi;
+            if (!daemonApi) {
+                context.writeError("❌ 当前会话未启用 daemon session API。请先启动 `qling daemon start`。");
+                return;
+            }
+            const sessionId = context.agentLoop.getSessionId?.() ?? "";
+            if (!sessionId) {
+                context.writeError("❌ 无法解析当前 sessionId。");
+                return;
+            }
+            const daemonSub = args[1]?.toLowerCase();
+            if (!daemonSub) {
+                if (!daemonApi.getGoal) {
+                    context.writeError("❌ daemon session API 未实现 getGoal。");
+                    return;
+                }
+                const status = await daemonApi.getGoal(sessionId);
+                for (const line of formatGoalStatus(status)) {
+                    context.writeLine(line);
+                }
+                return;
+            }
+            if (CLEAR_ALIASES.has(daemonSub)) {
+                if (!daemonApi.clearGoal) {
+                    context.writeError("❌ daemon session API 未实现 clearGoal。");
+                    return;
+                }
+                const cleared = await daemonApi.clearGoal(sessionId);
+                context.writeLine("");
+                context.writeLine(`🛑 已清除 daemon goal: ${cleared.condition || "(空)"}`);
+                context.writeLine("");
+                return;
+            }
+            const condition = args.slice(1).join(" ").trim();
+            if (!condition) {
+                context.writeError("❌ 用法: /goal daemon <condition>");
+                return;
+            }
+            const stats = typeof context.agentLoop.getSessionStats === "function"
+                ? await context.agentLoop.getSessionStats()
+                : { turnCount: 0, tokens: 0 };
+            if (typeof context.agentLoop.checkpointSession === "function") {
+                await context.agentLoop.checkpointSession();
+            }
+            if (!daemonApi.setGoal) {
+                context.writeError("❌ daemon session API 未实现 setGoal。");
+                return;
+            }
+            const goal = await daemonApi.setGoal(sessionId, condition, {
+                turnCount: stats.turnCount ?? 0,
+                tokens: stats.tokens ?? 0,
+            });
+            context.writeLine("");
+            context.writeLine("◎ /goal daemon active");
+            context.writeLine("-----------------------------------------");
+            context.writeLine(`条件     : ${goal.condition}`);
+            context.writeLine(`Runner   : ${goal.runner ?? "daemon"}`);
+            context.writeLine("说明     : 已交由 qlingd 在后台持续推进。");
+            context.writeLine("-----------------------------------------");
+            context.writeLine("");
+            return;
+        }
+        const conditionArgs = SET_ALIASES.has(firstArg) ? args.slice(1) : args;
+        const condition = conditionArgs.join(" ").trim();
+        if (!condition) {
+            context.writeError("❌ 用法: /goal [status|set <condition>|clear|daemon ...]");
+            return;
+        }
+        const stats = typeof context.agentLoop.getSessionStats === "function"
+            ? await context.agentLoop.getSessionStats()
+            : { turnCount: 0, tokens: 0 };
+        const goal = await controller.setGoal(condition, {
+            turnCount: stats.turnCount ?? 0,
+            tokens: stats.tokens ?? 0,
+        }, {
+            runner: "session",
+        });
+        const immediatePrompt = controller.buildInitialPrompt(goal.condition);
+        context.setImmediatePrompt?.(immediatePrompt);
+        context.writeLine("");
+        context.writeLine("◎ /goal active");
+        context.writeLine("-----------------------------------------");
+        context.writeLine(`条件     : ${goal.condition}`);
+        context.writeLine(`Runner   : ${goal.runner ?? "session"}`);
+        context.writeLine("说明     : 已立即启动自动续跑。");
+        context.writeLine("-----------------------------------------");
+        context.writeLine("");
+    },
+};

package/dist/commands/help.d.ts

@@ -0,0 +1,4 @@
+import { SlashCommand } from "./types.js";
+export declare const HELP_LINES: string[];
+export declare const helpCommand: SlashCommand;
+//# sourceMappingURL=help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,eAAO,MAAM,UAAU,UA6DtB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,YAWzB,CAAC"}

package/dist/commands/help.js

@@ -0,0 +1,75 @@
+import { formatFocusedHelp } from "../help-topics.js";
+export const HELP_LINES = [
+    "",
+    "【轻灵 Slash Commands】",
+    "-----------------------------------------",
+    "/help, /?               - 显示此帮助信息",
+    "/init [--force]         - 生成轻灵本地项目指南",
+    "/model [list|use <p>|m] - 查看/列出预设/切换模型或 Provider",
+    "/plan [on|off|status|..] - Plan Mode（只读规划，禁写工具）",
+    "/expand [on|off|status]  - 切换长工具输出展开（同 Ctrl+O）",
+    "/plan [description]     - 创建普通会话计划请求",
+    "/usage, /cost, /stats   - 查看本地 token 与上下文用量",
+    "/diff                   - 查看当前 Git 变更摘要",
+    "/copy [N]               - 复制最近第 N 条 assistant 回复",
+    "/rewind, /undo          - 查看可恢复会话点",
+    "/skill [list|search <query>|name] - 列出、搜索或读取本地技能",
+    "/sessions               - 查看最近保存的会话快照",
+    "/resume [session|latest] - 恢复最近一次或指定会话",
+    "/checkpoint [name] [--force], /检查点 - 保存当前会话为本地恢复检查点",
+    "/clear, /reset          - 清空当前对话上下文",
+    "/compact                - 手动触发上下文压缩",
+    "/goal [condition|clear] - 设定、查询或清除当前 session 的目标条件",
+    "/goal daemon            - 查询 daemon runner 的 goal 状态",
+    "/goal daemon clear      - 清理 daemon runner 的 goal",
+    "/goal daemon <condition> - 将 goal 交由 qlingd 在后台持续推进",
+    "/loop [interval] [prompt] - 在当前 session 内周期性重跑 prompt",
+    "/loop daemon [interval] [prompt] - 创建 daemon-backed durable loop",
+    "/tasks [cancel <id>|clear] - 查看或取消当前 session 的 loop 任务",
+    "/tasks daemon [cancel <id>|clear] - 查看或取消 daemon runner 的 loop 任务",
+    "/agents, /代理         - 查看本地后台 mission 分组视图",
+    "/mission, /使命        - 查看或控制本地 mission",
+    "/permissions [status|allow|deny|ask] - 查看或切换工具权限默认策略",
+    "/permissions explain <tool> - 解释指定工具的本地权限决策",
+    "/statusline [on|off]   - 查看或切换 prompt 前本地状态线",
+    "/recap [count], /回顾   - 查看当前本地会话回顾",
+    "/privacy, /隐私         - 查看本地数据留存路径与边界说明",
+    "/shortcuts, /快捷键     - 查看 TUI 输入快捷键",
+    "/queue [clear], /队列 [清空] - TUI 中即时查看或清空 pending 输入队列",
+    "/export, /导出          - 将当前会话导出为本地 Markdown",
+    "/exports [count], /导出列表 - 查看本地 Markdown 导出列表",
+    "/memory [count], /记忆   - 查看本地持久化记忆索引",
+    "/memory search <query>   - 搜索本地持久化记忆并显示匹配路径",
+    "/memory sources          - 查看本地上下文记忆来源与边界",
+    "/memory practices [count] - 查看本地蒸馏实践摘要",
+    "/memory graph [count]   - 查看本地知识图谱节点摘要",
+    "/memory show <id>       - 查看指定本地记忆详情",
+    "/dream [count], /沉淀    - 从当前会话沉淀本地记忆",
+    "/distill [count], /蒸馏  - 查看本地蒸馏实践摘要",
+    "/storage, /存储         - 查看本地数据存储占用",
+    "/repomap [path] [limit] - 扫描项目文件并生成符号地图（Repo Map）",
+    "/verify status|set <cmd>|clear|run - 配置与运行构建/测试验证与自动自愈",
+    "/mcp, /外部工具         - 查看本地 MCP server 配置摘要",
+    "/hooks, /钩子           - 查看本地 hooks/guard 配置摘要",
+    "/doctor, /诊断          - 运行本地稳定性与数据留存诊断",
+    "/context, /上下文       - 查看上下文占用与本地留存路径",
+    "/config                 - 查看当前生效配置",
+    "/status                 - 查看会话状态与 Token 统计",
+    "/dashboard              - 获取观测控制台链接",
+    "-----------------------------------------",
+    "提示: 输入 /help <topic> 查看聚焦帮助；帮助与纠错均在本地完成，不调用模型。",
+    "安全: API key 推荐放在系统用户环境变量；setup 不会写入 .env。",
+    "",
+];
+export const helpCommand = {
+    name: "/help",
+    aliases: ["/?"],
+    description: "显示可用指令列表",
+    usage: "/help [topic]",
+    execute: async (args, context) => {
+        const lines = args.length ? formatFocusedHelp(args.join(" "), { surface: "slash" }) : HELP_LINES;
+        for (const line of lines) {
+            context.writeLine(line);
+        }
+    },
+};

package/dist/commands/hooks.d.ts

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

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

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