skyloom 1.15.4 → 1.16.0

package/src/cli/command_args.ts

@@ -0,0 +1,159 @@
+/**
+ * 斜杠命令向导 · Cascading argument wizard for slash commands.
+ *
+ * After a slash command that takes structured arguments is chosen in the loom
+ * palette, the TUI walks the user through its arguments one level at a time:
+ * pick a provider, then paste a key; pick a model; pick a session. Each level is
+ * navigable with ↑/↓ and filterable by typing — the same affordance as the
+ * command palette itself, extended to arguments.
+ *
+ * This module is the pure brain of that flow (no I/O, no terminal) so it is
+ * fully unit-testable: given a command, the values chosen so far, and a snapshot
+ * of runtime context, it returns the next step — or null when the command is
+ * complete and ready to submit.
+ */
+
+export interface ArgChoice {
+  /** The value contributed to the final command line. */
+  value: string;
+  /** Display label in the list. */
+  label: string;
+  /** Optional dim hint shown after the label. */
+  hint?: string;
+  /** Optional group heading (e.g. provider name) for sectioned lists. */
+  group?: string;
+}
+
+export interface WizardStep {
+  kind: 'choice' | 'freeform';
+  /** Heading shown above the list / prompt. */
+  title: string;
+  /** Choices for a 'choice' step (already ordered). */
+  choices: ArgChoice[];
+  /** A 'choice' step may also accept a typed value not in the list. */
+  allowFreeform: boolean;
+  /** Placeholder for a 'freeform' step (or a free-typed choice). */
+  placeholder?: string;
+  /** Mask typed input (API keys). */
+  secret?: boolean;
+}
+
+export interface WizardProvider { id: string; label: string; configured: boolean; envVar?: string }
+export interface WizardModel { id: string; provider: string; label: string; hint?: string }
+export interface WizardSession { id: string; label: string }
+
+export interface WizardContext {
+  providers: WizardProvider[];
+  models: WizardModel[];
+  sessions: WizardSession[];
+}
+
+/** Commands that drive a guided wizard (base name without the leading slash). */
+const WIZARD_COMMANDS = new Set(['model', 'apikey', 'connect', 'resume']);
+
+/** Does this base command (with or without leading slash) have a wizard? */
+export function hasWizard(command: string): boolean {
+  return WIZARD_COMMANDS.has(command.replace(/^\//, '').trim().toLowerCase());
+}
+
+function providerChoices(ctx: WizardContext): ArgChoice[] {
+  return ctx.providers.map((p) => ({
+    value: p.id,
+    label: p.label,
+    hint: p.configured ? '✓ 已配置' : (p.envVar ? `需 ${p.envVar}` : '未配置'),
+  }));
+}
+
+function modelChoices(ctx: WizardContext): ArgChoice[] {
+  return ctx.models.map((m) => ({
+    value: m.id,
+    label: m.id,
+    hint: m.hint,
+    group: m.provider,
+  }));
+}
+
+/**
+ * The next step for `command` given the values already chosen, or null when the
+ * command is complete (ready to submit via {@link buildCommandLine}).
+ */
+export function nextWizardStep(command: string, prior: string[], ctx: WizardContext): WizardStep | null {
+  const cmd = command.replace(/^\//, '').trim().toLowerCase();
+
+  switch (cmd) {
+    case 'model': {
+      if (prior.length >= 1) return null;
+      const choices: ArgChoice[] = [
+        { value: 'reset', label: '↺ reset', hint: '回到统一默认模型' },
+        ...modelChoices(ctx),
+      ];
+      return { kind: 'choice', title: '选择模型（输入可筛选）', choices, allowFreeform: true, placeholder: '模型 id' };
+    }
+
+    case 'connect': {
+      if (prior.length >= 1) return null;
+      return { kind: 'choice', title: '选择 Provider', choices: providerChoices(ctx), allowFreeform: true, placeholder: 'provider' };
+    }
+
+    case 'apikey': {
+      // step 0: provider · step 1: the key
+      if (prior.length === 0) {
+        return { kind: 'choice', title: '为哪个 Provider 配置 API Key', choices: providerChoices(ctx), allowFreeform: true, placeholder: 'provider' };
+      }
+      if (prior.length === 1) {
+        return { kind: 'freeform', title: `粘贴 ${prior[0]} 的 API Key`, choices: [], allowFreeform: true, placeholder: 'sk-…（回车保存）', secret: true };
+      }
+      return null;
+    }
+
+    case 'resume': {
+      if (prior.length >= 1) return null;
+      const choices: ArgChoice[] = ctx.sessions.map((s, i) => ({ value: String(i + 1), label: `${i + 1}. ${s.label}`, hint: s.id.slice(0, 8) }));
+      return { kind: 'choice', title: choices.length ? '选择要恢复的会话' : '暂无历史会话', choices, allowFreeform: true, placeholder: '序号或 id' };
+    }
+  }
+  return null;
+}
+
+/** Assemble the final command line from the base command + chosen values. */
+export function buildCommandLine(command: string, values: string[]): string {
+  const cmd = command.replace(/^\//, '').trim().toLowerCase();
+  const v = values.filter((x) => x !== undefined && x !== null);
+  switch (cmd) {
+    case 'apikey':
+      // /apikey set <provider> <key>
+      return `/apikey set ${v.join(' ')}`.trim();
+    case 'model':
+      return `/model ${v.join(' ')}`.trim();
+    case 'connect':
+      return `/connect ${v.join(' ')}`.trim();
+    case 'resume':
+      return `/resume ${v.join(' ')}`.trim();
+    default:
+      return `/${cmd} ${v.join(' ')}`.trim();
+  }
+}
+
+/**
+ * Filter + rank choices by a typed query (case-insensitive substring on value,
+ * label, and group). Empty query returns the list unchanged. Exact value/label
+ * prefix matches sort first so the obvious pick lands at the top.
+ */
+export function filterChoices(choices: ArgChoice[], typed: string): ArgChoice[] {
+  const q = typed.trim().toLowerCase();
+  if (!q) return choices;
+  const scored: Array<{ c: ArgChoice; rank: number }> = [];
+  for (const c of choices) {
+    const value = c.value.toLowerCase();
+    const label = c.label.toLowerCase();
+    const group = (c.group || '').toLowerCase();
+    let rank = -1;
+    if (value === q || label === q) rank = 0;
+    else if (value.startsWith(q) || label.startsWith(q)) rank = 1;
+    else if (value.includes(q) || label.includes(q)) rank = 2;
+    else if (group.includes(q)) rank = 3;
+    if (rank >= 0) scored.push({ c, rank });
+  }
+  scored.sort((a, b) => a.rank - b.rank); // stable within equal ranks
+  return scored.map((s) => s.c);
+}

package/src/cli/loom.ts

@@ -30,6 +30,7 @@ import * as readline from "readline";
 import chalk from "chalk";
 import { agentTheme, AGENT_ORDER, PALETTE } from "../core/theme";
 import { charWidth, visualWidth, SLASH_COMMANDS } from "./tui";
+import { hasWizard, buildCommandLine, filterChoices, type WizardStep, type ArgChoice } from "./command_args";
 
 /* ════════════════════════════════════════
    ANSI-aware string helpers (pure, tested)
@@ -409,6 +410,14 @@ export class LoomUI {
   modeBadge = "";
   /** User-defined slash commands shown in the palette ([name, description]). */
   extraCommands: [string, string][] = [];
+  /**
+   * Cascading argument wizard, active after a structured slash command is
+   * chosen (e.g. /apikey → pick provider → paste key). Resolved step-by-step
+   * via the wizardStep callback the chat loop wires up.
+   */
+  private wizard: { command: string; values: string[]; step: WizardStep; typed: string; idx: number } | null = null;
+  /** Next-step resolver for the argument wizard (set by the chat loop with runtime context). */
+  wizardStep: ((command: string, prior: string[]) => WizardStep | null) | null = null;
   private keypressHandler: ((str: string, key: any) => void) | null = null;
   private resizeHandler: (() => void) | null = null;
 
@@ -622,6 +631,9 @@ export class LoomUI {
     const name = key?.name;
     if (key?.ctrl && name === "c") { this.handleSigint(); return; }
 
+    // The argument wizard owns all keys while it is open.
+    if (this.wizard && !this.busy) { this.handleWizardKey(str, key); return; }
+
     if (name === "pageup") { this.scrollOff += Math.max(1, this.bodyH() - 2); this.clampScroll(); this.paint(); return; }
     if (name === "pagedown") { this.scrollOff -= Math.max(1, this.bodyH() - 2); this.clampScroll(); this.paint(); return; }
 
@@ -630,15 +642,14 @@ export class LoomUI {
       let text = this.inputGlyphs.join("").trim();
 
       // Palette open: Enter runs the ↑↓-highlighted command (Claude Code
-      // style). Commands that take arguments fill the input instead so the
-      // user can type them.
+      // style). A command with a guided argument wizard opens the wizard;
+      // otherwise an argument-taking command fills the input to wait for input.
       const matches = this.paletteMatches();
       if (matches.length > 0 && text.startsWith("/")) {
         const [cmd] = matches[Math.max(0, Math.min(this.paletteIdx, matches.length - 1))];
+        if (this.startWizard(cmd.trim())) return;
         if (cmd.endsWith(" ")) {
-          // argument-taking command: fill the input and wait for arguments
-          // (the palette closes once the line contains a space; a second
-          // Enter then submits as typed)
+          // argument-taking command without a wizard: fill the input and wait.
           this.inputGlyphs = [...cmd];
           this.cursor = this.inputGlyphs.length;
           this.paletteIdx = 0;
@@ -648,13 +659,7 @@ export class LoomUI {
         text = cmd.trimEnd();
       }
 
-      this.inputGlyphs = []; this.cursor = 0; this.histIdx = -1; this.paletteIdx = 0;
-      this.scrollOff = 0; // submitting a turn snaps back to the tail to watch the reply
-      if (text) { this.history.unshift(text); if (this.history.length > 200) this.history.pop(); }
-      const r = this.pendingResolve;
-      this.pendingResolve = null;
-      this.paint();
-      if (r) r(text);
+      this.submitText(text);
       return;
     }
 
@@ -683,7 +688,10 @@ export class LoomUI {
       if (paletteOpen) {
         const m = this.paletteMatches();
         const pick = m[Math.min(this.paletteIdx, m.length - 1)];
-        if (pick) { this.inputGlyphs = [...pick[0].trimEnd()]; this.cursor = this.inputGlyphs.length; }
+        if (pick) {
+          if (this.startWizard(pick[0].trim())) return;
+          this.inputGlyphs = [...pick[0].trimEnd()]; this.cursor = this.inputGlyphs.length;
+        }
       }
       this.paint(); return;
     }
@@ -744,6 +752,91 @@ export class LoomUI {
 
   private flashHint = "";
 
+  /* ── argument wizard ── */
+
+  /** Submit a turn: clear input, record history, resolve the pending read. */
+  private submitText(text: string) {
+    this.wizard = null;
+    this.inputGlyphs = []; this.cursor = 0; this.histIdx = -1; this.paletteIdx = 0;
+    this.scrollOff = 0; // submitting a turn snaps back to the tail to watch the reply
+    if (text) { this.history.unshift(text); if (this.history.length > 200) this.history.pop(); }
+    const r = this.pendingResolve;
+    this.pendingResolve = null;
+    this.paint();
+    if (r) r(text);
+  }
+
+  /** Choices for the current wizard step, filtered by what the user has typed. */
+  private wizardFiltered(): ArgChoice[] {
+    if (!this.wizard || this.wizard.step.kind !== "choice") return [];
+    return filterChoices(this.wizard.step.choices, this.wizard.typed);
+  }
+
+  /** Open the wizard for `command` (e.g. "/model"). Returns false if it has none. */
+  private startWizard(command: string): boolean {
+    if (!this.wizardStep || !hasWizard(command)) return false;
+    const step = this.wizardStep(command, []);
+    if (!step) return false;
+    this.wizard = { command, values: [], step, typed: "", idx: 0 };
+    this.inputGlyphs = []; this.cursor = 0; this.paletteIdx = 0;
+    this.paint();
+    return true;
+  }
+
+  /** Accept a value for the current step; advance to the next or submit. */
+  private wizardCommit(value: string) {
+    const w = this.wizard!;
+    const values = [...w.values, value];
+    const next = this.wizardStep ? this.wizardStep(w.command, values) : null;
+    if (next) {
+      this.wizard = { command: w.command, values, step: next, typed: "", idx: 0 };
+      this.paint();
+    } else {
+      this.submitText(buildCommandLine(w.command, values));
+    }
+  }
+
+  /** Step back one level (or close the wizard when at the first level). */
+  private wizardBack() {
+    const w = this.wizard!;
+    if (w.values.length === 0 || !this.wizardStep) { this.wizard = null; this.paint(); return; }
+    const values = w.values.slice(0, -1);
+    const step = this.wizardStep(w.command, values);
+    if (!step) { this.wizard = null; this.paint(); return; }
+    this.wizard = { command: w.command, values, step, typed: "", idx: 0 };
+    this.paint();
+  }
+
+  private handleWizardKey(str: string, key: any) {
+    const w = this.wizard!;
+    const name = key?.name;
+    if (name === "escape") { this.wizard = null; this.paint(); return; }
+    if (name === "up") { if (w.step.kind === "choice") w.idx = Math.max(0, w.idx - 1); this.paint(); return; }
+    if (name === "down") {
+      if (w.step.kind === "choice") w.idx = Math.min(Math.max(0, this.wizardFiltered().length - 1), w.idx + 1);
+      this.paint(); return;
+    }
+    if (name === "return" || name === "tab") {
+      if (w.step.kind === "choice") {
+        const filtered = this.wizardFiltered();
+        const pick = filtered[Math.min(w.idx, filtered.length - 1)];
+        if (pick) { this.wizardCommit(pick.value); return; }
+        if (w.step.allowFreeform && w.typed.trim()) { this.wizardCommit(w.typed.trim()); return; }
+        return;
+      }
+      if (w.typed.trim()) this.wizardCommit(w.typed.trim());
+      return;
+    }
+    if (name === "backspace") {
+      if (w.typed.length > 0) { w.typed = w.typed.slice(0, -1); w.idx = 0; this.paint(); return; }
+      this.wizardBack(); return;
+    }
+    if (str && !key?.ctrl && !key?.meta) {
+      const glyphs = [...str].filter((c) => c >= " " || charWidth(c.codePointAt(0)!) > 0);
+      if (glyphs.length) { w.typed += glyphs.join(""); w.idx = 0; this.paint(); }
+    }
+  }
+
   private paletteMatches(): [string, string][] {
     const l = this.inputGlyphs.join("");
     if (!l.startsWith("/") || l.includes(" ")) return [];
@@ -936,6 +1029,13 @@ export class LoomUI {
       if (this.modal) {
         content = " " + chalk.yellow("⚠ ") + cutVisual(this.modal.text, innerW - 14) + chalk.bold(" 允许? ") + chalk.dim("[y/N]");
         cursorPos = { row: rows - 2, col: Math.min(innerW, visualWidth(content) + 1) };
+      } else if (this.wizard) {
+        const w = this.wizard;
+        const crumb = [w.command.replace(/^\//, ""), ...w.values].join(" ");
+        const shownTyped = w.step.secret ? "•".repeat([...w.typed].length) : w.typed;
+        const head = chalk.hex(t.hex)(` ${t.symbol} `) + chalk.hex(PALETTE.inkLight)(crumb + " ▸ ");
+        content = head + cutVisual(shownTyped, innerW - visualWidth(head) - 2);
+        cursorPos = { row: rows - 2, col: Math.min(innerW, visualWidth(content) + 1) };
       } else {
         const promptStr = chalk.hex(t.hex)(` ${t.symbol} `) + chalk.hex(PALETTE.inkLight)("❯ ");
         const promptW = visualWidth(promptStr);
@@ -966,17 +1066,55 @@ export class LoomUI {
       const paletteUp = this.paletteMatches().length > 0 && this.inputGlyphs[0] === "/";
       const hint = this.busy
         ? " Ctrl-C 中断本轮 "
-        : paletteUp
-          ? " ↑↓ 选命令 · Enter 执行 · Tab 补全 · Esc 收起 "
-          : " / 命令 · 滚轮/PgUp 回看 · Shift+Tab 切模式 · Ctrl-C 退出 ";
+        : this.wizard
+          ? (this.wizard.step.kind === "choice"
+              ? " ↑↓ 选择 · Enter 确认 · 输入筛选 · ⌫ 返回 · Esc 取消 "
+              : " 输入后 Enter 确认 · ⌫ 返回上一步 · Esc 取消 ")
+          : paletteUp
+            ? " ↑↓ 选命令 · Enter 执行 · Tab 补全 · Esc 收起 "
+            : " / 命令 · 滚轮/PgUp 回看 · Shift+Tab 切模式 · Ctrl-C 退出 ";
       // └─ hint ───…┘  →  2 + w(hint) + fill + 1 = cols
       const fill = innerW - visualWidth(hint) - 1;
       frame.push(B("└─") + chalk.dim(hint) + B("─".repeat(Math.max(0, fill)) + "┘"));
     }
 
+    // ── argument wizard: overlay the title + selectable choices ──
+    if (this.wizard && !this.modal) {
+      const w = this.wizard;
+      const overlayRow = (row: number, s: string) => {
+        if (row < 1 + SKY_H || row >= 1 + SKY_H + bodyH) return;
+        frame[row] = B("│") + padAnsi(rail[row - 1 - SKY_H] ?? "", RAIL_W) + B("│") + " " + padAnsi(s, this.viewW()) + B("│");
+      };
+      const lines: string[] = [];
+      lines.push(chalk.dim(" " + cutVisual(w.step.title, this.viewW() - 4)));
+      if (w.step.kind === "choice") {
+        const filtered = this.wizardFiltered();
+        const bodyRows = Math.min(7, bodyH - 1);
+        if (!filtered.length) {
+          lines.push("   " + chalk.dim(w.step.allowFreeform ? `直接输入，回车确认` : `无匹配项`));
+        } else {
+          w.idx = Math.max(0, Math.min(w.idx, filtered.length - 1));
+          const start = Math.max(0, Math.min(w.idx - bodyRows + 1, filtered.length - bodyRows));
+          filtered.slice(start, start + bodyRows).forEach((c, i) => {
+            const sel = start + i === w.idx;
+            const mark = sel ? chalk.hex(t.hex)(" ▸ ") : "   ";
+            const group = c.group ? chalk.dim(`${c.group}/`) : "";
+            const label = sel ? chalk.bold.hex(t.hex)(c.label) : chalk.hex(PALETTE.inkLight)(c.label);
+            const hint = c.hint ? chalk.dim("  " + c.hint) : "";
+            const counter = sel && filtered.length > bodyRows ? chalk.dim(`  ${w.idx + 1}/${filtered.length}`) : "";
+            lines.push(mark + group + cutVisual(label + hint, this.viewW() - 8) + counter);
+          });
+        }
+      } else {
+        lines.push("   " + chalk.dim(w.step.placeholder || "输入后回车确认"));
+      }
+      const baseRow = 1 + SKY_H + bodyH - lines.length;
+      lines.forEach((s, i) => overlayRow(baseRow + i, s));
+    }
+
     // ── slash palette: overlay onto the rows just above the divider ──
     const matches = this.paletteMatches();
-    if (matches.length > 0 && this.inputGlyphs[0] === "/" && !this.modal) {
+    if (!this.wizard && matches.length > 0 && this.inputGlyphs[0] === "/" && !this.modal) {
       const maxShow = Math.min(8, bodyH - 1);
       this.paletteIdx = Math.max(0, Math.min(this.paletteIdx, matches.length - 1));
       // scroll window that keeps the ↑↓ selection visible

package/src/cli/loom_chat.ts

@@ -320,6 +320,39 @@ export async function loomChat(ctx: any, startAgent: any, deps: LoomChatDeps): P
   let customCommands = loadCustomCommands();
   ui.extraCommands = customCommands.map((c) => ["/" + c.name, c.description] as [string, string]);
 
+  // Pre-load the session list so the /resume wizard has choices from the start.
+  try { lastSessions = await agent.memory.listSessions(); } catch { /* best-effort */ }
+
+  // Guided argument wizard for structured commands (/model · /apikey · /connect · /resume):
+  // pick a provider/model/session from a ↑↓ list, paste a key — no syntax to memorize.
+  ui.wizardStep = (command, prior) => {
+    try {
+      const { nextWizardStep } = require("./command_args");
+      const { listProviders, modelsFor, providerLabel, allModels } = require("../core/catalog");
+      const { loadConfig } = require("../core/config");
+      const cfg = loadConfig();
+      const configured = (p: string): boolean => {
+        const meta = PROVIDER_META[p];
+        if (meta?.envVar && process.env[meta.envVar]) return true;
+        if (cfg?.api_keys?.[p]) return true;
+        const models = modelsFor(p);
+        return models.length > 0 && models.every((m: any) => m.local); // local providers need no key
+      };
+      const providers = listProviders().map((p: string) => ({
+        id: p, label: providerLabel(p), configured: configured(p), envVar: PROVIDER_META[p]?.envVar,
+      }));
+      const models = allModels().map((m: any) => ({
+        id: m.id, provider: m.provider, label: m.id,
+        hint: m.local ? "本地/免费" : (m.costIn != null ? `$${m.costIn}/$${m.costOut}` : undefined),
+      }));
+      const sessions = lastSessions.map((s: any) => ({
+        id: String(s.id),
+        label: (s.preview || "(空)").replace(/\s+/g, " ").slice(0, 40),
+      }));
+      return nextWizardStep(command, prior, { providers, models, sessions });
+    } catch { return null; }
+  };
+
   try {
     while (true) {
       const inp = await ui.readInput();

package/src/core/agent.ts

@@ -199,10 +199,10 @@ export class BaseAgent {
     const lang = (this.config as any).llm?.language || 'zh';
     if (lang === 'en') {
       return prompt +
-        `\n\n## Thinking Protocol\nBefore acting, briefly weigh: (1) **What** is the actual need? (2) **How** sure am I? If <80%, flag with [uncertain] and ask.\nIf stuck, admit it — propose a partial answer or ask the user. Never fabricate.\n\n## Behavior\n- Act, don't narrate. No "I will..." before tool calls.\n- Stay in scope. Do what's asked, then stop.\n- Batch independent tool calls in one response.\n- For tasks with 3+ steps, plan with todo_write first and update item status as you go.\n- Verify writes: read back, report verified state.\n- Call list_skills when the task needs specialized capabilities.`;
+        `\n\n## Thinking Protocol\nBefore acting, briefly weigh: (1) **What** is the actual need? (2) **How** sure am I? If <80%, flag with [uncertain] and ask.\nIf stuck, admit it — propose a partial answer or ask the user. Never fabricate.\n\n## Behavior\n- Act, don't narrate. No "I will..." before tool calls.\n- Stay in scope. Do what's asked, then stop.\n- Batch independent tool calls in one response.\n- For tasks with 3+ steps, plan with todo_write first and update item status as you go.\n- Verify writes: read back, report verified state.\n- For anything current or real-time (today's news/hot topics, recent events, latest versions, prices, weather), call web_search FIRST, then read_url for detail. Never answer from memory or claim you can't go online.\n- Call list_skills when the task needs specialized capabilities.`;
     }
     return prompt +
-      `\n\n## 思考协议\n行动前快速判断：(1) 用户真实需求是什么？(2) 我有多大把握？低于80%标注 [不确定] 并主动询问。\n卡住时承认，给出部分答案或请求用户指导。绝不编造。\n\n## 行为守则\n- 直接行动,不预告。不说「我将要...」,直接调用工具\n- 不擅自扩大范围。用户要什么做什么,核心完成即止\n- 独立的工具调用一次发出,并行执行\n- 3 步以上的任务先用 todo_write 列任务清单,开工/完成时逐项更新状态\n- 写入后回读验证,汇报已验证状态而非仅尝试\n- 任务涉及专业能力时（PPT/Excel/PDF/网页设计/代码审查等），先调 list_skills 查看可用技能，再用 use_skill 激活`;
+      `\n\n## 思考协议\n行动前快速判断：(1) 用户真实需求是什么？(2) 我有多大把握？低于80%标注 [不确定] 并主动询问。\n卡住时承认，给出部分答案或请求用户指导。绝不编造。\n\n## 行为守则\n- 直接行动,不预告。不说「我将要...」,直接调用工具\n- 不擅自扩大范围。用户要什么做什么,核心完成即止\n- 独立的工具调用一次发出,并行执行\n- 3 步以上的任务先用 todo_write 列任务清单,开工/完成时逐项更新状态\n- 写入后回读验证,汇报已验证状态而非仅尝试\n- 凡涉及最新/实时信息（今日新闻热点、近期事件、最新版本、价格、天气等）一律先调 web_search 联网核实，再用 read_url 读全文；绝不凭记忆作答，也不要声称无法联网\n- 任务涉及专业能力时（PPT/Excel/PDF/网页设计/代码审查等），先调 list_skills 查看可用技能，再用 use_skill 激活`;
   }
 
   protected injectProgrammingWisdom(prompt: string): string {

package/src/core/security.ts

@@ -89,6 +89,7 @@ const TOOL_DANGER_MAP: Record<string, DangerLevel> = {
   git_branch: DangerLevel.LOW,
   http_get: DangerLevel.LOW,
   fetch_page: DangerLevel.LOW,
+  read_url: DangerLevel.LOW,
   web_search: DangerLevel.LOW,
   remember_fact: DangerLevel.LOW,
   use_skill: DangerLevel.LOW,

package/src/core/tool_router.ts

@@ -101,9 +101,17 @@ function scoreTool(tool: ToolDefinition, queryTokens: Set<string>, queryLc: stri
     ['git', 'commit', 'diff', 'branch', '提交', '分支', '差异'].some(k => queryLc.includes(k))) {
     score += 4;
   }
-  if (['web_search', 'fetch_page', 'http_get'].includes(name) &&
-    ['web', 'url', 'http', 'research', '搜索', '网页', '联网', '资料'].some(k => queryLc.includes(k))) {
-    score += 4;
+  if (['web_search', 'read_url', 'fetch_page', 'http_get'].includes(name) &&
+    [
+      // explicit web/search intent
+      'web', 'url', 'http', 'research', '搜索', '搜', '网页', '联网', '上网', '资料', '查询', '查一下', '查查',
+      // time-sensitive / current-events intent — the reason "今日热点新闻" used to
+      // miss web_search entirely (it scored 0 and never made the tool shortlist)
+      'news', 'today', 'latest', 'current', 'recent', 'now', 'breaking', 'trending', 'weather', 'price', 'stock',
+      '新闻', '今日', '今天', '最新', '近期', '实时', '热点', '热搜', '头条', '动态', '行情', '股价', '汇率', '天气', '比分', '发布',
+      '2024', '2025', '2026',
+    ].some(k => queryLc.includes(k))) {
+    score += 5;
   }
   if (['list_skills', 'use_skill'].includes(name) &&
     ['skill', '能力', '技能', 'ppt', 'pdf', 'excel', 'xlsx', 'docx'].some(k => queryLc.includes(k))) {