@qlingzzy/qling 1.0.0 → 1.1.0

package/dist/mission/progress-notify.js

@@ -0,0 +1,386 @@
+// ============================================================
+// Phase 3.5 — Mission 进度通知（Telegram / Slack 结构化卡片）
+// QLING_MISSION_NOTIFY=on|off（默认 on：有 token 才发）
+// QLING_MISSION_NOTIFY_STYLE=plain|rich（默认 rich）
+// ============================================================
+import axios from "axios";
+export function isMissionNotifyEnabled(env = process.env) {
+    const raw = String(env.QLING_MISSION_NOTIFY ?? "on").trim().toLowerCase();
+    if (raw === "off" || raw === "0" || raw === "false")
+        return false;
+    return true;
+}
+export function resolveNotifyStyle(env = process.env) {
+    const raw = String(env.QLING_MISSION_NOTIFY_STYLE ?? "rich").trim().toLowerCase();
+    return raw === "plain" || raw === "text" ? "plain" : "rich";
+}
+export function resolveMissionLogNotifyMode(env = process.env) {
+    const raw = String(env.QLING_MISSION_NOTIFY_LOGS ?? "milestone").trim().toLowerCase();
+    if (raw === "off" || raw === "0" || raw === "false" || raw === "none")
+        return "off";
+    if (raw === "all" || raw === "on" || raw === "1" || raw === "true")
+        return "all";
+    return "milestone";
+}
+const MILESTONE_LOG_RE = /使命(开始|执行成功|执行失败|未启动)|开始执行|执行成功|执行失败|恢复状态机|checkpoint|失败|succeeded|failed|canceled|paused|blocked/i;
+/**
+ * 是否应对本条使命日志发通道通知。
+ */
+export function shouldNotifyMissionLog(message, env = process.env) {
+    if (!isMissionNotifyEnabled(env))
+        return false;
+    const mode = resolveMissionLogNotifyMode(env);
+    if (mode === "off")
+        return false;
+    if (mode === "all")
+        return true;
+    return MILESTONE_LOG_RE.test(String(message ?? ""));
+}
+export function formatMissionLogMessage(mission, message) {
+    const msg = String(message ?? "").replace(/\s+/g, " ").slice(0, 240);
+    return [
+        `📝 【轻灵使命日志】`,
+        `id: ${mission.id}`,
+        `name: ${mission.name}`,
+        `status: ${mission.status}`,
+        `log: ${msg}`,
+    ].join("\n");
+}
+const STATUS_EMOJI = {
+    queued: "⏳",
+    running: "🚀",
+    blocked: "🛑",
+    paused: "⏸️",
+    succeeded: "✅",
+    failed: "❌",
+    canceled: "🚫",
+};
+export function statusEmoji(status) {
+    return STATUS_EMOJI[status] ?? "📡";
+}
+export function formatMissionProgressMessage(mission, from, to) {
+    const arrow = from ? `${from} → ${to}` : `→ ${to}`;
+    const desc = (mission.description || "").replace(/\s+/g, " ").slice(0, 120);
+    const err = to === "failed" && mission.error?.message
+        ? `\n错误: ${mission.error.message.slice(0, 200)}`
+        : "";
+    return [
+        `${statusEmoji(to)} 【轻灵使命进度】`,
+        `id: ${mission.id}`,
+        `name: ${mission.name}`,
+        `status: ${arrow}`,
+        desc ? `task: ${desc}` : null,
+        err || null,
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+/** Telegram HTML（需 escape） */
+export function formatMissionProgressTelegramHtml(mission, from, to) {
+    const esc = (s) => s
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+    const arrow = from ? `${esc(from)} → <b>${esc(to)}</b>` : `→ <b>${esc(to)}</b>`;
+    const desc = (mission.description || "").replace(/\s+/g, " ").slice(0, 120);
+    const lines = [
+        `${statusEmoji(to)} <b>轻灵使命进度</b>`,
+        `<code>${esc(mission.id)}</code>`,
+        `名称: ${esc(mission.name || "-")}`,
+        `状态: ${arrow}`,
+    ];
+    if (desc)
+        lines.push(`任务: ${esc(desc)}`);
+    if (to === "failed" && mission.error?.message) {
+        lines.push(`错误: <i>${esc(mission.error.message.slice(0, 200))}</i>`);
+    }
+    return lines.join("\n");
+}
+/** Slack Block Kit 最小卡片 */
+export function formatMissionProgressSlackBlocks(mission, from, to) {
+    const plain = formatMissionProgressMessage(mission, from, to);
+    const arrow = from ? `${from} → *${to}*` : `→ *${to}*`;
+    const desc = (mission.description || "").replace(/\s+/g, " ").slice(0, 120);
+    const fields = [
+        { type: "mrkdwn", text: `*ID*\n\`${mission.id}\`` },
+        { type: "mrkdwn", text: `*状态*\n${arrow}` },
+        { type: "mrkdwn", text: `*名称*\n${mission.name || "-"}` },
+    ];
+    if (desc) {
+        fields.push({ type: "mrkdwn", text: `*任务*\n${desc}` });
+    }
+    const blocks = [
+        {
+            type: "header",
+            text: {
+                type: "plain_text",
+                text: `${statusEmoji(to)} 轻灵使命进度`,
+                emoji: true,
+            },
+        },
+        { type: "section", fields },
+    ];
+    if (to === "failed" && mission.error?.message) {
+        blocks.push({
+            type: "section",
+            text: {
+                type: "mrkdwn",
+                text: `*错误*\n${mission.error.message.slice(0, 200)}`,
+            },
+        });
+    }
+    blocks.push({ type: "divider" });
+    return { text: plain, blocks };
+}
+function parseJsonStringArray(raw) {
+    if (!raw || !raw.trim())
+        return [];
+    try {
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed))
+            return parsed.map(String).filter(Boolean);
+    }
+    catch {
+        return raw.split(/[,，]/).map((s) => s.trim()).filter(Boolean);
+    }
+    return [];
+}
+export function assertSlackResponseOk(data) {
+    if (!data || typeof data !== "object")
+        return;
+    const body = data;
+    if (body.ok === false) {
+        const code = String(body.error ?? "unknown_error")
+            .replace(/[^a-zA-Z0-9_.-]/g, "_")
+            .slice(0, 120);
+        throw new Error(`Slack API error: ${code}`);
+    }
+}
+/**
+ * 向已配置的 Telegram / Slack 发送使命进度（失败不抛出）。
+ */
+export async function notifyMissionProgress(mission, from, to, env = process.env) {
+    const style = resolveNotifyStyle(env);
+    if (!isMissionNotifyEnabled(env)) {
+        return {
+            attempted: false,
+            telegram: "skipped",
+            slack: "skipped",
+            detail: "QLING_MISSION_NOTIFY off",
+            style,
+        };
+    }
+    const notable = new Set([
+        "running",
+        "blocked",
+        "paused",
+        "succeeded",
+        "failed",
+        "canceled",
+    ]);
+    if (!notable.has(to)) {
+        return {
+            attempted: false,
+            telegram: "skipped",
+            slack: "skipped",
+            detail: `status ${to} not notable`,
+            style,
+        };
+    }
+    const plain = formatMissionProgressMessage(mission, from, to);
+    let telegram = "skipped";
+    let slack = "skipped";
+    const details = [];
+    const tgToken = String(env.QLING_CHANNEL_TELEGRAM_TOKEN ?? "").trim();
+    const tgChats = parseJsonStringArray(env.QLING_CHANNEL_TELEGRAM_ALLOWED_CHAT_IDS);
+    const tgProgress = String(env.QLING_MISSION_TELEGRAM_CHAT_ID ?? "").trim();
+    const chatIds = tgProgress ? [tgProgress, ...tgChats] : tgChats;
+    if (tgToken && chatIds.length > 0) {
+        try {
+            for (const chatId of [...new Set(chatIds)]) {
+                if (style === "rich") {
+                    const html = formatMissionProgressTelegramHtml(mission, from, to);
+                    await axios.post(`https://api.telegram.org/bot${tgToken}/sendMessage`, {
+                        chat_id: chatId,
+                        text: html.length > 3900 ? html.slice(0, 3900) + "…" : html,
+                        parse_mode: "HTML",
+                        disable_web_page_preview: true,
+                    }, { timeout: 10_000 });
+                }
+                else {
+                    const body = plain.length > 3900 ? plain.slice(0, 3900) + "\n…" : plain;
+                    await axios.post(`https://api.telegram.org/bot${tgToken}/sendMessage`, { chat_id: chatId, text: body }, { timeout: 10_000 });
+                }
+            }
+            telegram = "sent";
+            details.push(`telegram chats=${chatIds.length} style=${style}`);
+        }
+        catch (err) {
+            telegram = "error";
+            details.push(`telegram: ${err.message}`);
+        }
+    }
+    const slackToken = String(env.QLING_CHANNEL_SLACK_BOT_TOKEN ?? "").trim();
+    let slackChannels = parseJsonStringArray(env.QLING_CHANNEL_SLACK_CHANNEL_IDS);
+    const slackProgress = String(env.QLING_MISSION_SLACK_CHANNEL_ID ?? "").trim();
+    if (slackProgress)
+        slackChannels = [slackProgress, ...slackChannels];
+    if (slackToken && slackChannels.length > 0) {
+        try {
+            const card = style === "rich"
+                ? formatMissionProgressSlackBlocks(mission, from, to)
+                : { text: plain, blocks: undefined };
+            for (const channel of [...new Set(slackChannels)]) {
+                const payload = {
+                    channel,
+                    text: card.text.length > 2900 ? card.text.slice(0, 2900) + "\n…" : card.text,
+                };
+                if (style === "rich" && card.blocks) {
+                    payload.blocks = card.blocks;
+                }
+                const response = await axios.post("https://slack.com/api/chat.postMessage", payload, {
+                    timeout: 10_000,
+                    headers: {
+                        Authorization: `Bearer ${slackToken}`,
+                        "Content-Type": "application/json; charset=utf-8",
+                    },
+                });
+                assertSlackResponseOk(response.data);
+            }
+            slack = "sent";
+            details.push(`slack channels=${slackChannels.length} style=${style}`);
+        }
+        catch (err) {
+            slack = "error";
+            details.push(`slack: ${err.message}`);
+        }
+    }
+    const attempted = telegram === "sent" || slack === "sent" || telegram === "error" || slack === "error";
+    return {
+        attempted,
+        telegram,
+        slack,
+        detail: details.join("; ") || "no channel targets configured",
+        style,
+    };
+}
+/**
+ * 使命日志推送（默认仅里程碑；失败不抛出）。
+ * QLING_MISSION_NOTIFY_LOGS=off|milestone|all
+ */
+export async function notifyMissionLog(mission, message, env = process.env) {
+    const style = resolveNotifyStyle(env);
+    if (!shouldNotifyMissionLog(message, env)) {
+        return {
+            attempted: false,
+            telegram: "skipped",
+            slack: "skipped",
+            detail: "log not notifiable",
+            style,
+        };
+    }
+    const plain = formatMissionLogMessage(mission, message);
+    const esc = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+    const html = [
+        `📝 <b>轻灵使命日志</b>`,
+        `<code>${esc(mission.id)}</code>`,
+        `名称: ${esc(mission.name || "-")}`,
+        `状态: ${esc(mission.status)}`,
+        `日志: ${esc(String(message).slice(0, 240))}`,
+    ].join("\n");
+    let telegram = "skipped";
+    let slack = "skipped";
+    const details = [];
+    const tgToken = String(env.QLING_CHANNEL_TELEGRAM_TOKEN ?? "").trim();
+    const tgChats = parseJsonStringArray(env.QLING_CHANNEL_TELEGRAM_ALLOWED_CHAT_IDS);
+    const tgProgress = String(env.QLING_MISSION_TELEGRAM_CHAT_ID ?? "").trim();
+    const chatIds = tgProgress ? [tgProgress, ...tgChats] : tgChats;
+    if (tgToken && chatIds.length > 0) {
+        try {
+            for (const chatId of [...new Set(chatIds)]) {
+                const payload = {
+                    chat_id: chatId,
+                    text: style === "rich"
+                        ? html.length > 3900
+                            ? html.slice(0, 3900) + "…"
+                            : html
+                        : plain.length > 3900
+                            ? plain.slice(0, 3900) + "\n…"
+                            : plain,
+                };
+                if (style === "rich") {
+                    payload.parse_mode = "HTML";
+                    payload.disable_web_page_preview = true;
+                }
+                await axios.post(`https://api.telegram.org/bot${tgToken}/sendMessage`, payload, {
+                    timeout: 10_000,
+                });
+            }
+            telegram = "sent";
+            details.push("telegram log");
+        }
+        catch (err) {
+            telegram = "error";
+            details.push(`telegram: ${err.message}`);
+        }
+    }
+    const slackToken = String(env.QLING_CHANNEL_SLACK_BOT_TOKEN ?? "").trim();
+    let slackChannels = parseJsonStringArray(env.QLING_CHANNEL_SLACK_CHANNEL_IDS);
+    const slackProgress = String(env.QLING_MISSION_SLACK_CHANNEL_ID ?? "").trim();
+    if (slackProgress)
+        slackChannels = [slackProgress, ...slackChannels];
+    if (slackToken && slackChannels.length > 0) {
+        try {
+            for (const channel of [...new Set(slackChannels)]) {
+                const payload = {
+                    channel,
+                    text: plain.length > 2900 ? plain.slice(0, 2900) + "\n…" : plain,
+                };
+                if (style === "rich") {
+                    payload.blocks = [
+                        {
+                            type: "header",
+                            text: { type: "plain_text", text: "📝 轻灵使命日志", emoji: true },
+                        },
+                        {
+                            type: "section",
+                            fields: [
+                                { type: "mrkdwn", text: `*ID*\n\`${mission.id}\`` },
+                                { type: "mrkdwn", text: `*状态*\n${mission.status}` },
+                            ],
+                        },
+                        {
+                            type: "section",
+                            text: {
+                                type: "mrkdwn",
+                                text: `*日志*\n${String(message).replace(/\s+/g, " ").slice(0, 240)}`,
+                            },
+                        },
+                    ];
+                }
+                const response = await axios.post("https://slack.com/api/chat.postMessage", payload, {
+                    timeout: 10_000,
+                    headers: {
+                        Authorization: `Bearer ${slackToken}`,
+                        "Content-Type": "application/json; charset=utf-8",
+                    },
+                });
+                assertSlackResponseOk(response.data);
+            }
+            slack = "sent";
+            details.push("slack log");
+        }
+        catch (err) {
+            slack = "error";
+            details.push(`slack: ${err.message}`);
+        }
+    }
+    const attempted = telegram === "sent" || slack === "sent" || telegram === "error" || slack === "error";
+    return {
+        attempted,
+        telegram,
+        slack,
+        detail: details.join("; ") || "no channel targets configured",
+        style,
+    };
+}

package/dist/pipeline/hooks.d.ts

@@ -26,7 +26,7 @@ export declare class SpeculativeClassifier {
     classify(toolCall: ToolCall): ClassifierResult;
 }
 /** Plan 模式下禁止的写/执行类工具（OpenCode plan agent 语义） */
-export declare const PLAN_MODE_DENY_TOOLS: readonly ["write", "patch", "bash", "subtask", "browser_fetch"];
+export declare const PLAN_MODE_DENY_TOOLS: readonly ["write", "patch", "bash", "subtask", "browser_fetch", "browser_act"];
 export declare class HookManager {
     private preHooks;
     private postHooks;

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

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

package/dist/pipeline/hooks.js

@@ -161,6 +161,7 @@ export const PLAN_MODE_DENY_TOOLS = [
     "bash",
     "subtask",
     "browser_fetch",
+    "browser_act",
 ];
 export class HookManager {
     preHooks = [];

package/dist/pipeline/sections.d.ts

@@ -7,7 +7,6 @@ export declare const SECTION_IDS: {
     readonly RESTRICTIONS: "restrictions";
     readonly TONE: "tone";
     readonly REPOMAP: "repomap";
-    readonly TOKEN_BUDGET: "token_budget";
     readonly SESSION: "session";
     readonly MCP: "mcp";
     readonly MEMORY: "memory";
@@ -23,17 +22,22 @@ export declare function buildRestrictionsSection(): PromptSection;
 export declare function buildToneSection(): PromptSection;
 export declare function buildSessionSection(): PromptSection;
 export declare function buildMemorySection(): PromptSection;
-export declare function buildTokenBudgetSection(usedTokens: number, maxTokens: number): PromptSection;
 export declare function buildSkillsSection(skills: SkillMeta[]): PromptSection;
 export declare function buildMCPSection(serverInfo?: string): PromptSection;
+/** Default budgets keep repo map from dominating context window. */
+export declare const REPOMAP_DEFAULT_MAX_SYMBOLS = 200;
+export declare const REPOMAP_DEFAULT_MAX_CHARS = 6000;
 export declare function buildRepoMapSection(symbols: {
     file: string;
     name: string;
     type: string;
     line: number;
     signature: string;
-}[]): PromptSection;
-export declare function buildDefaultRegistry(tools: AgentConfig["tools"], usedTokens?: number, maxTokens?: number): PromptSectionRegistry;
+}[], options?: {
+    maxSymbols?: number;
+    maxChars?: number;
+}): PromptSection;
+export declare function buildDefaultRegistry(tools: AgentConfig["tools"]): PromptSectionRegistry;
 export declare function buildSystemPrompt(registry: PromptSectionRegistry, dynamicSections?: {
     memory?: string;
     session?: string;

package/dist/pipeline/sections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../src/pipeline/sections.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAKpD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;CAcd,CAAC;AAEX,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,MAAM,CAgBzE;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAS9E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,aAAa,CAwB5E;AAED,wBAAgB,oBAAoB,IAAI,aAAa,CAYpD;AAED,wBAAgB,wBAAwB,IAAI,aAAa,CAkBxD;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAYhD;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAYnD;AAED,wBAAgB,kBAAkB,IAAI,aAAa,CAUlD;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAe5F;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,aAAa,CAoBrE;AAED,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAWlE;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,GACvF,aAAa,CA+Bf;AAID,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,EAC3B,UAAU,GAAE,MAAU,EACtB,SAAS,GAAE,MAAgB,GAC1B,qBAAqB,CAcvB;AAID,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,qBAAqB,EAC/B,eAAe,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,MAAM,CAgBR"}
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../src/pipeline/sections.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAKpD,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAad,CAAC;AAEX,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,MAAM,CAgBzE;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAS9E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,aAAa,CAwB5E;AAED,wBAAgB,oBAAoB,IAAI,aAAa,CAiBpD;AAED,wBAAgB,wBAAwB,IAAI,aAAa,CAsCxD;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAahD;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAYnD;AAED,wBAAgB,kBAAkB,IAAI,aAAa,CAUlD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,aAAa,CA+BrE;AAED,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAWlE;AAED,oEAAoE;AACpE,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAC/C,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAE/C,wBAAgB,mBAAmB,CACjC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,EACxF,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,aAAa,CAuDf;AAID,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,qBAAqB,CAavF;AAID,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,qBAAqB,EAC/B,eAAe,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,MAAM,CAgBR"}

package/dist/pipeline/sections.js

@@ -12,7 +12,6 @@ export const SECTION_IDS = {
     RESTRICTIONS: "restrictions",
     TONE: "tone",
     REPOMAP: "repomap",
-    TOKEN_BUDGET: "token_budget",
     SESSION: "session",
     MCP: "mcp",
     MEMORY: "memory",
@@ -73,7 +72,12 @@ export function buildWorkflowSection() {
 1. 先思考：这个任务需要几步？是否需要规划？
 2. 如果任务复杂（超过2步），先用 todo add 依次列出执行步骤
 3. 然后逐个执行：每完成一步用 todo done 标记
-4. 所有步骤完成后返回清晰总结`,
+4. 所有步骤完成后返回清晰总结
+
+【任务执行三条基本规则】
+1. **外部工具先关联分析再调用**：调用 bash/opencli/url_fetch/browser_fetch/MCP 等外部能力前，先说明「任务要什么 → 该工具是否匹配 → 选哪个子命令/参数 → 预期输出」；不匹配则换工具或先 skill 加载，禁止盲目试错。
+2. **成功后总结正确流程**：任一关键路径成功后，用中文给出可复现步骤（顺序、关键命令、成功判据、结果要点），便于用户下次照做。
+3. **失败须实事求是**：单流程失败、部分成功或结果与目标不符时，明确写「未完成/失败/偏差」及证据（错误信息、反爬页、命令退出码等），禁止把挑战页/空结果/猜测说成已成功。`,
         cacheable: true,
         cached: false,
     };
@@ -83,15 +87,35 @@ export function buildRestrictionsSection() {
         id: SECTION_IDS.RESTRICTIONS,
         title: "限制",
         content: `【工具使用原则】
-- bash：执行命令、安装、构建、运行
+- bash：执行命令、安装、构建、运行；调用本机 opencli 也用 bash
 - read：查看文件内容后再决定怎么写
 - write：创建或覆盖文件
+- search：内容/文件名搜索
+- code_symbols：按符号名检索函数/类/类型（轻量静态提取）
+- lsp：可选 TS 语义查询（definition/hover/references；须 QLING_LSP=1）
 - todo：规划步骤、跟踪进度
 - skill：遇到不熟悉的工具/API/框架时，用 skill 加载对应知识文件
+- **调用外部工具前必须做关联分析**（任务目标 ↔ 工具能力 ↔ 参数/站点）；分析通过后再调用
+
+【诚实与收尾】
+- 成功：总结「正确流程」（步骤 + 关键命令 + 结果）
+- 失败或未准确执行：明确承认，引用真实输出/错误码，不编造完成结论
+- 禁止用「可能已经…」「应该成功了」替代验证证据
+
+【网页 / 社交平台数据（opencli）】
+- 抖音、小红书、微博、B站、TikTok、推特/X 等：先 skill name="opencli"，再用 bash 执行 opencli <站点> … -f json
+- 禁止用 url_fetch / 裸 curl 抓取上述强反爬站点（会返回 _$jsvmprt、acrawler 挑战页，不是业务数据）
+- 抖音 ≠ TikTok：douyin.com 必须 opencli douyin；禁止用 opencli tiktok 操作抖音
+- 小红书：用 opencli xiaohongshu；note/comments/download 必须传 search/feed 返回的「含 xsec_token 的完整 URL」，禁止只传裸 note-id
+- 不确定子命令时：opencli list -f json 或 opencli <site> --help；需登录时先 opencli <site> whoami / login
+- browser_fetch 适合文档站，不保证能过抖音/小红书风控；平台结构化数据优先 opencli 站点适配器
+- browser_act（点击/填表）默认关闭；仅当 QLING_BROWSER_ACT=1 且非强反爬场景；优先 opencli browser <session>
+- 外联路由详见包内 docs/web-routing.md；先选对通道再调用
 
 【安全限制】
 - 危险命令（rm -rf /、格式化磁盘等）会被自动拒绝
 - 删除/覆盖操作前必须先读取确认
+- opencli 的 delete/publish 等写操作须先征得用户确认
 - 不确定的操作先问用户`,
         cacheable: true,
         cached: false,
@@ -105,7 +129,8 @@ export function buildToneSection() {
 回答应当平衡“简洁”与“丰富”：
 - 对于纯技术、文件或系统操作：保持极致简洁，给出完成报告。
 - 对于图片分析、创意设计或意境咨询：**禁止使用表格 (Table)**。你应当使用分段的叙述性文字、文学化的词汇和排比句，完整转述视觉意象和氛围。**绝对不要将感性描述提取为结构化数据列。**
-工具执行结果用 ✅（成功）或 ❌（失败）标记。`,
+工具执行结果用 ✅（成功）或 ❌（失败）标记。
+成功路径结束时附「正确流程」小结；失败时用 ❌ 并写清原因与已验证事实，不粉饰。`,
         cacheable: true,
         cached: false,
     };
@@ -134,21 +159,6 @@ export function buildMemorySection() {
         cached: false,
     };
 }
-export function buildTokenBudgetSection(usedTokens, maxTokens) {
-    const remaining = maxTokens - usedTokens;
-    const pct = Math.round((remaining / maxTokens) * 100);
-    return {
-        id: SECTION_IDS.TOKEN_BUDGET,
-        title: "Token 预算",
-        content: `【Token 预算】
-已使用: ~${usedTokens.toLocaleString()} tokens
-剩余: ~${remaining.toLocaleString()} tokens (${pct}%)
-当剩余低于 20% 时，主动精简回复，减少工具调用频率。`,
-        cacheable: false,
-        dynamic: true,
-        cached: false,
-    };
-}
 export function buildSkillsSection(skills) {
     if (skills.length === 0) {
         return {
@@ -160,11 +170,22 @@ export function buildSkillsSection(skills) {
             cached: false,
         };
     }
-    const lines = skills.map((s) => `- ${s.name}: ${s.description || "(无描述)"}`);
+    // Progressive skills：system 仅索引（name/desc/tags/triggers），禁止注入正文
+    const DESC_MAX = 160;
+    const lines = skills.map((s) => {
+        let desc = (s.description || "(无描述)").replace(/\s+/g, " ").trim();
+        if (desc.length > DESC_MAX)
+            desc = desc.slice(0, DESC_MAX - 1) + "…";
+        const tags = s.tags?.length ? ` tags=[${s.tags.join(",")}]` : "";
+        const triggers = s.triggers?.length ? ` triggers=[${s.triggers.join(",")}]` : "";
+        return `- ${s.name}: ${desc}${tags}${triggers}`;
+    });
     return {
         id: SECTION_IDS.SKILLS,
         title: "可用技能",
-        content: `【可用技能】（用 skill name="xxx" 加载）\n${lines.join("\n")}`,
+        content: `【可用技能 · 渐进索引】仅名称与描述；**不要假设已掌握正文**。` +
+            `需要步骤时必须 skill name="<名>" 或 /skill <名> 加载全文。\n` +
+            lines.join("\n"),
         cacheable: false,
         dynamic: true,
         cached: false,
@@ -182,9 +203,19 @@ export function buildMCPSection(serverInfo) {
         cached: false,
     };
 }
-export function buildRepoMapSection(symbols) {
+/** Default budgets keep repo map from dominating context window. */
+export const REPOMAP_DEFAULT_MAX_SYMBOLS = 200;
+export const REPOMAP_DEFAULT_MAX_CHARS = 6_000;
+export function buildRepoMapSection(symbols, options = {}) {
+    const maxSymbols = Math.max(1, options.maxSymbols ?? REPOMAP_DEFAULT_MAX_SYMBOLS);
+    const maxChars = Math.max(500, options.maxChars ?? REPOMAP_DEFAULT_MAX_CHARS);
+    const limited = symbols.length > maxSymbols
+        ? [...symbols]
+            .sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line)
+            .slice(0, maxSymbols)
+        : symbols;
     const fileGroups = new Map();
-    for (const sym of symbols) {
+    for (const sym of limited) {
         if (!fileGroups.has(sym.file)) {
             fileGroups.set(sym.file, []);
         }
@@ -192,16 +223,29 @@ export function buildRepoMapSection(symbols) {
     }
     const lines = [];
     const sortedFiles = Array.from(fileGroups.keys()).sort();
+    let truncatedByChars = false;
     for (const file of sortedFiles) {
         lines.push(`📄 ${file}`);
         const fileSymbols = fileGroups.get(file);
         fileSymbols.sort((a, b) => a.line - b.line);
         for (const sym of fileSymbols) {
-            lines.push(`  - [${sym.type}] L${sym.line}: ${sym.name} (${sym.signature})`);
+            const next = `  - [${sym.type}] L${sym.line}: ${sym.name} (${sym.signature})`;
+            const draft = [...lines, next].join("\n");
+            if (draft.length > maxChars) {
+                truncatedByChars = true;
+                break;
+            }
+            lines.push(next);
         }
+        if (truncatedByChars)
+            break;
     }
+    const truncatedByCount = symbols.length > maxSymbols;
+    const note = truncatedByCount || truncatedByChars
+        ? `\n\n…已截断：共 ${symbols.length} 符号，展示 ${limited.length}${truncatedByChars ? "（字符预算）" : ""}。可用 search/code_symbols 精确定位。`
+        : "";
     const content = lines.length > 0
-        ? `已编制项目符号索引，供全局参考：\n\n${lines.join("\n")}`
+        ? `已编制项目符号索引，供全局参考：\n\n${lines.join("\n")}${note}`
         : "当前没有索引到项目符号。运行 /repomap 命令来索引符号。";
     return {
         id: SECTION_IDS.REPOMAP,
@@ -212,7 +256,7 @@ export function buildRepoMapSection(symbols) {
     };
 }
 // --- 默认 Registry Builder ---
-export function buildDefaultRegistry(tools, usedTokens = 0, maxTokens = 120_000) {
+export function buildDefaultRegistry(tools) {
     const registry = new PromptSectionRegistry();
     registry.register(buildIntroSection("轻灵", getPackageVersion()));
     registry.register(buildToolsSection(tools));
@@ -222,7 +266,6 @@ export function buildDefaultRegistry(tools, usedTokens = 0, maxTokens = 120_000)
     registry.register(buildRepoMapSection([]));
     registry.register(buildSessionSection());
     registry.register(buildMemorySection());
-    registry.register(buildTokenBudgetSection(usedTokens, maxTokens));
     return registry;
 }
 // --- Prompt Builder Utility ---

package/dist/pipeline/verification.d.ts

@@ -1,4 +1,5 @@
 import { VerificationResult } from "../types.js";
+/** @deprecated Prefer StagedVerifier for recovery-driving verification. */
 export declare class VerificationAgent {
     private apiKey;
     private model;

package/dist/pipeline/verification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../../src/pipeline/verification.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,kBAAkB,EAGnB,MAAM,aAAa,CAAC;AAmBrB,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,KAAK;gBADL,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAwB;IAGnC,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC;YAiBhB,aAAa;YAkBb,OAAO;IAoBrB,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,eAAe;CAyCxB"}
+{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../../src/pipeline/verification.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,kBAAkB,EAGnB,MAAM,aAAa,CAAC;AAmBrB,2EAA2E;AAC3E,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,KAAK;gBADL,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAwB;IAGnC,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC;YAoBhB,aAAa;YAkBb,OAAO;IAoBrB,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,eAAe;CAyCxB"}