u1s1-cli 0.13.5 → 0.13.7

package/dist/agent-setup.d.ts

@@ -21,7 +21,10 @@ export declare function cleanupBrandThemes(): void;
  * 环境变量,文件里不落密钥。U1S1_TOOLS_VIA_EXTENSION 守卫:旧版 CLI 仍在
  * 进程内注册工具且不设该变量,残留的本文件在旧版下自动空转,避免双重注册。
  */
-export declare function writeWebToolsExtension(cfg: CliConfig, webSearchEnabled: boolean): void;
+export declare function writeWebToolsExtension(cfg: CliConfig, features: {
+    webSearch: boolean;
+    webFetchRender: boolean;
+}): void;
 /**
  * pi-web-ui 的就绪检测只认 <agentDir>/auth.json 里有没有凭据条目(models.json
  * 的 apiKey 它不看),空 {} 会在网页里弹「未检测到 pi agent 配置」引导装 pi。

package/dist/agent-setup.js

@@ -123,11 +123,11 @@ export function cleanupBrandThemes() {
  * 环境变量,文件里不落密钥。U1S1_TOOLS_VIA_EXTENSION 守卫:旧版 CLI 仍在
  * 进程内注册工具且不设该变量,残留的本文件在旧版下自动空转,避免双重注册。
  */
-export function writeWebToolsExtension(cfg, webSearchEnabled) {
+export function writeWebToolsExtension(cfg, features) {
     const dir = join(agentDir, "extensions");
     mkdirSync(dir, { recursive: true });
     const toolsUrl = new URL("./tools.js", import.meta.url).href;
-    const searchLine = webSearchEnabled
+    const searchLine = features.webSearch
         ? `  pi.registerTool(tools.createSearchTool({ baseUrl: ${JSON.stringify(cfg.baseUrl)}, apiKey: process.env.U1S1_API_KEY }));\n`
         : "";
     writeFileSync(join(dir, "u1s1-tools.js"), `// 由 u1s1 每次启动自动生成,请勿手改\n` +
@@ -135,7 +135,7 @@ export function writeWebToolsExtension(cfg, webSearchEnabled) {
         `  if (process.env.U1S1_TOOLS_VIA_EXTENSION !== "1") return;\n` +
         `  const tools = await import(${JSON.stringify(toolsUrl)});\n` +
         searchLine +
-        `  pi.registerTool(tools.webFetchTool);\n` +
+        `  pi.registerTool(tools.createFetchTool({ baseUrl: ${JSON.stringify(cfg.baseUrl)}, apiKey: process.env.U1S1_API_KEY, renderFallback: ${features.webFetchRender} }));\n` +
         `}\n`);
 }
 /**

package/dist/api.d.ts

@@ -46,6 +46,8 @@ export interface ApiModel {
 /** 服务端能力开关;字段缺失(老网关)时按开启处理,保持现状。 */
 export interface ApiFeatures {
     web_search?: boolean;
+    /** 网关配了 Browser Rendering 才为 true;老网关没有 /v1/fetch,缺失按关闭处理。 */
+    web_fetch_render?: boolean;
 }
 export interface ModelsResponse {
     models: ApiModel[];
@@ -88,4 +90,9 @@ export interface SearchResponse {
 }
 /** 联网搜索走网关代理（上游 key 只在服务端）。maxResults 不传时由服务端决定默认值。 */
 export declare function searchWeb(cfg: Pick<CliConfig, "baseUrl" | "apiKey">, query: string, maxResults?: number, signal?: AbortSignal): Promise<SearchResponse>;
+/** web_fetch 直连失败时的回退:网关用 Cloudflare Browser Rendering 渲染后转 markdown。 */
+export declare function renderPage(cfg: Pick<CliConfig, "baseUrl" | "apiKey">, url: string, signal?: AbortSignal): Promise<{
+    url: string;
+    markdown: string;
+}>;
 export declare function fetchMe(cfg: CliConfig): Promise<MeResponse>;

package/dist/api.js

@@ -80,6 +80,33 @@ export async function searchWeb(cfg, query, maxResults, signal) {
     }
     return (await resp.json());
 }
+/** web_fetch 直连失败时的回退:网关用 Cloudflare Browser Rendering 渲染后转 markdown。 */
+export async function renderPage(cfg, url, signal) {
+    if (!cfg.apiKey)
+        throw new Error("没有配置 API Key");
+    let resp;
+    try {
+        resp = await fetch(`${cfg.baseUrl}/fetch`, {
+            method: "POST",
+            headers: {
+                ...authHeaders(cfg.apiKey),
+                "content-type": "application/json",
+            },
+            body: JSON.stringify({ url }),
+            signal,
+        });
+    }
+    catch {
+        throw new Error(`连不上 ${cfg.baseUrl}`);
+    }
+    if (resp.status === 401)
+        throw new Error("这把 Key 不对或已失效,去 https://u1s1.io/dashboard 看看");
+    if (!resp.ok) {
+        const body = (await resp.json().catch(() => null));
+        throw new Error(body?.error?.message ?? `渲染服务返回 ${resp.status}`);
+    }
+    return (await resp.json());
+}
 export async function fetchMe(cfg) {
     if (!cfg.apiKey)
         throw new Error("没有配置 API Key");

package/dist/index.js

@@ -134,8 +134,10 @@ function ensureTmuxKeyboardProtocol() {
 }
 async function runAgent(cfg, args) {
     cleanupBrandThemes();
-    ensureBrandPrompt(ensureUsableShell());
     ensureDefaultSettings();
+    // Windows shell 体检异步先行,与取模型列表/搜索工具下载并行;首启验活
+    // (Defender 首扫 bash.exe 可达秒级)藏进网络等待,进 pi 前再 await
+    const shellReady = ensureUsableShell();
     // 预 seed fd/rg(国内直连 GitHub 不通,pi 自己下不动);与取模型列表并行,
     // 但必须在进 pi 之前就位,否则 pi 会自己去 GitHub 下载
     const searchToolsReady = ensureSearchTools(cfg);
@@ -143,19 +145,23 @@ async function runAgent(cfg, args) {
     // 服务端没开搜索(或老网关没有 features 字段)时不注册 web_search,模型就不会白调
     // 自定义端点与模型列表并行拉取,失败各自兜底(内置列表 / 本地缓存)
     let webSearchEnabled = true;
+    // 老网关没有 /v1/fetch,web_fetch_render 缺失时按关闭处理,直连失败不去白调
+    let webFetchRenderEnabled = false;
     const endpointsReady = loadCustomEndpoints(cfg);
     try {
         const { models, features } = await fetchModels(cfg);
         setModelsFromApi(models.map(apiModelToDef));
         webSearchEnabled = features.web_search !== false;
+        webFetchRenderEnabled = features.web_fetch_render === true;
     }
     catch (e) {
         console.error("  获取模型列表失败,使用内置列表:", e.message);
     }
     await endpointsReady;
+    ensureBrandPrompt(await shellReady);
     ensureProviderModels(cfg);
     // 联网工具经 agentDir/extensions 投影,TUI 和 u1s1 web 共用一份注册
-    writeWebToolsExtension(cfg, webSearchEnabled);
+    writeWebToolsExtension(cfg, { webSearch: webSearchEnabled, webFetchRender: webFetchRenderEnabled });
     ensureTmuxKeyboardProtocol();
     // must be set before pi reads them (getAgentDir() reads at call time, env at import is fine too)
     process.env["PI_CODING_AGENT_DIR"] = agentDir;

package/dist/login.js

@@ -126,7 +126,7 @@ export async function login(keyArg) {
         quotaNote =
             me.free_claim === "first"
                 ? "免费用量包还没领,去 https://u1s1.io/dashboard 点「领取」(首月每天 1 亿 Token)"
-                : "免费用量包到期了,去 https://u1s1.io/dashboard 续领(每天 5000 万 Token)";
+                : "免费用量包到期了,去 https://u1s1.io/dashboard 续领(每天 3000 万 Token)";
     }
     else if (tpu > 0) {
         const tok = (usd) => {

package/dist/shell-doctor.d.ts

@@ -5,6 +5,10 @@
  * 常见),所有命令 0.1s 内失败,stderr 还是 UTF-16 乱码,模型只能干瞪眼。
  * 这里在进 pi 之前把一个「验过活」的 bash 写进 settings.json 的 shellPath;
  * 找不到就当场把修复指引打给用户,并让品牌 prompt 告知模型别撞墙。
+ *
+ * 整个探测是异步的:调用方先拿 Promise 与拉模型列表等网络请求并行,进 pi 前
+ * 再 await——首启的 where/验活成本(Defender 首扫 bash.exe 可达秒级)藏进
+ * 网络等待里。验活结果持久化到 shellPath,之后每次启动只花 existsSync。
  */
 export type ShellDoctorResult = {
     status: "posix";
@@ -19,4 +23,4 @@ export type ShellDoctorResult = {
 } | {
     status: "unknown";
 };
-export declare function ensureUsableShell(): ShellDoctorResult;
+export declare function ensureUsableShell(): Promise<ShellDoctorResult>;

package/dist/shell-doctor.js

@@ -1,4 +1,4 @@
-import { spawnSync } from "node:child_process";
+import { spawn } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { agentDir, agentSettingsFile } from "./config.js";
@@ -7,70 +7,125 @@ function isWslRelayBash(p) {
     const normalized = p.replace(/\//g, "\\").toLowerCase();
     return /^[a-z]:\\windows\\(?:system32|sysnative)\\bash\.exe$/.test(normalized);
 }
-/** 真跑一条 echo 验活。WSL 转发器不支持 -c 传参(pi 对它走 stdin),探活同款。 */
-function bashWorks(bashPath) {
-    const viaStdin = isWslRelayBash(bashPath);
-    try {
-        const res = spawnSync(bashPath, viaStdin ? ["-s"] : ["-c", "echo u1s1-shell-ok"], {
-            input: viaStdin ? "echo u1s1-shell-ok\n" : undefined,
-            encoding: "utf-8",
-            timeout: 5000,
-            windowsHide: true,
+/** 异步跑子进程收 stdout;超时杀掉。任何失败都归为 ok=false,不抛。 */
+function runCapture(cmd, args, opts) {
+    return new Promise((resolve) => {
+        let done = false;
+        let timer;
+        const finish = (ok, stdout) => {
+            if (done)
+                return;
+            done = true;
+            if (timer)
+                clearTimeout(timer);
+            resolve({ ok, stdout });
+        };
+        let child;
+        try {
+            child = spawn(cmd, args, { windowsHide: true, stdio: ["pipe", "pipe", "ignore"] });
+        }
+        catch {
+            finish(false, "");
+            return;
+        }
+        timer = setTimeout(() => {
+            try {
+                child.kill();
+            }
+            catch {
+                // 已退出
+            }
+            finish(false, "");
+        }, opts.timeoutMs);
+        let out = "";
+        child.stdout?.on("data", (d) => {
+            out += d.toString("utf8");
+            if (out.length > 65536)
+                out = out.slice(-65536);
         });
-        // WSL 转发器可能按 UTF-16LE 输出(ASCII 字符间夹 NUL),剔掉再找标记
-        return res.status === 0 && (res.stdout ?? "").replace(/\u0000/g, "").includes("u1s1-shell-ok");
-    }
-    catch {
-        return false;
-    }
-}
-function runWhere(name) {
-    try {
-        const res = spawnSync("where", [name], { encoding: "utf-8", timeout: 5000, windowsHide: true });
-        if (res.status !== 0 || !res.stdout)
-            return [];
-        return res.stdout
-            .trim()
-            .split(/\r?\n/)
-            .map((l) => l.trim())
-            .filter(Boolean);
-    }
-    catch {
-        return [];
-    }
+        child.on("error", () => finish(false, out));
+        child.on("close", (code) => finish(code === 0, out));
+        child.stdin?.on("error", () => { });
+        child.stdin?.end(opts.input ?? "");
+    });
 }
 /**
- * Git Bash 候选位置:pi 只认 Program Files 两处,漏掉 winget 默认的用户级
- * 安装(%LOCALAPPDATA%\Programs\Git)和 scoop;再从 git.exe 反推兜住
- * portable 安装。只返回磁盘上真实存在的路径。
+ * 真跑一条 echo 验活。WSL 转发器不支持 -c 传参(pi 对它走 stdin),探活同款;
+ * WSL 冷启动一个发行版可能要好几秒,超时放宽——真坏的 WSL(缺 /bin/bash)
+ * 是瞬间失败,不会吃满超时。
  */
-function candidateGitBashPaths() {
+async function bashWorks(bashPath) {
+    const viaStdin = isWslRelayBash(bashPath);
+    const res = await runCapture(bashPath, viaStdin ? ["-s"] : ["-c", "echo u1s1-shell-ok"], {
+        input: viaStdin ? "echo u1s1-shell-ok\n" : undefined,
+        timeoutMs: viaStdin ? 10_000 : 5_000,
+    });
+    // WSL 转发器可能按 UTF-16LE 输出(ASCII 字符间夹 NUL),剔掉再找标记
+    return res.ok && res.stdout.replace(/\u0000/g, "").includes("u1s1-shell-ok");
+}
+async function runWhere(name) {
+    const res = await runCapture("where", [name], { timeoutMs: 5_000 });
+    if (!res.ok)
+        return [];
+    return res.stdout
+        .trim()
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .filter(Boolean);
+}
+/** 快路径候选:环境变量推得出的固定安装位置,只花 existsSync,零进程开销。 */
+function knownGitBashPaths() {
     const out = [];
-    const add = (p) => {
-        if (!out.includes(p))
-            out.push(p);
-    };
     for (const [envKey, ...rest] of [
         ["ProgramFiles", "Git", "bin", "bash.exe"],
         ["ProgramFiles(x86)", "Git", "bin", "bash.exe"],
-        ["LOCALAPPDATA", "Programs", "Git", "bin", "bash.exe"],
+        ["LOCALAPPDATA", "Programs", "Git", "bin", "bash.exe"], // winget 用户级默认位置
         ["USERPROFILE", "scoop", "apps", "git", "current", "bin", "bash.exe"],
     ]) {
         const base = process.env[envKey];
-        if (base)
-            add(join(base, ...rest));
+        if (!base)
+            continue;
+        const p = join(base, ...rest);
+        if (!out.includes(p) && existsSync(p))
+            out.push(p);
     }
+    return out;
+}
+/** 慢路径候选:where git.exe 反推安装根,兜住 portable 等非常规安装。 */
+async function discoveredGitBashPaths(skip) {
+    const out = [];
     // git.exe 在 <root>\cmd、<root>\bin 或 <root>\mingw64\bin 下,向上找 root
-    for (const gitPath of runWhere("git.exe")) {
+    for (const gitPath of await runWhere("git.exe")) {
         const dir = dirname(gitPath);
         for (const root of [dirname(dir), dirname(dirname(dir))]) {
-            add(join(root, "bin", "bash.exe"));
-            add(join(root, "usr", "bin", "bash.exe"));
+            for (const p of [join(root, "bin", "bash.exe"), join(root, "usr", "bin", "bash.exe")]) {
+                if (!out.includes(p) && !skip.includes(p) && existsSync(p))
+                    out.push(p);
+            }
         }
     }
-    return out.filter((p) => existsSync(p));
+    return out;
 }
-export function ensureUsableShell() {
+/** 持久化写 settings.json:写入时现读现改,避免覆盖并行流程刚写的其他键。 */
+function persistShellPath(p) {
+    let settings = {};
+    if (existsSync(agentSettingsFile)) {
+        try {
+            settings = JSON.parse(readFileSync(agentSettingsFile, "utf8"));
+        }
+        catch {
+            return false; // 不动损坏的文件
+        }
+    }
+    settings["shellPath"] = p;
+    writeFileSync(agentSettingsFile, JSON.stringify(settings, null, 2) + "\n");
+    return true;
+}
+function adviseInstallGitBash() {
+    console.error("  ⚠ 未找到 Git Bash,将使用 WSL 的 bash:命令会在 WSL 的 Linux 里执行,不是 Windows 本机。");
+    console.error("    建议安装 Git for Windows(PowerShell 运行: winget install --id Git.Git)后重启 u1s1。");
+}
+export async function ensureUsableShell() {
     if (process.platform !== "win32")
         return { status: "posix" };
     mkdirSync(agentDir, { recursive: true });
@@ -83,36 +138,50 @@ export function ensureUsableShell() {
             return { status: "unknown" }; // 不动损坏的文件,pi 启动时会自己报
         }
     }
-    // 已配置且文件还在:信它,不每次启动都探活(坏了 pi 会在会话里报错)
+    // 已配置且文件还在:信它,不每次启动都探活(坏了 pi 会在会话里报错)。
+    // 配置的是 WSL 转发器时,零成本看一眼 Git Bash 是否新装了,装了就换轨。
     const configured = settings["shellPath"];
     if (typeof configured === "string" && configured && existsSync(configured)) {
-        return isWslRelayBash(configured)
-            ? { status: "wsl", shellPath: configured }
-            : { status: "bash", shellPath: configured };
-    }
-    // shellPath 缺失或指向已卸载的文件:探测 + 验活,找到就固定下来
-    for (const candidate of candidateGitBashPaths()) {
-        if (bashWorks(candidate)) {
-            settings["shellPath"] = candidate;
-            writeFileSync(agentSettingsFile, JSON.stringify(settings, null, 2) + "\n");
-            if (typeof configured === "string") {
-                console.error(`  原 shellPath 已失效,自动改用: ${candidate}`);
+        if (!isWslRelayBash(configured))
+            return { status: "bash", shellPath: configured };
+        for (const candidate of knownGitBashPaths()) {
+            if (await bashWorks(candidate)) {
+                persistShellPath(candidate);
+                console.error(`  检测到 Git Bash,命令改回 Windows 本机执行: ${candidate}`);
+                return { status: "bash", shellPath: candidate };
             }
-            return { status: "bash", shellPath: candidate };
         }
+        adviseInstallGitBash();
+        return { status: "wsl", shellPath: configured };
+    }
+    // shellPath 缺失或指向已卸载的文件:探测 + 验活,找到就固定下来。
+    // 先试零开销的固定位置,全灭才花 where git.exe 找非常规安装。
+    const adopt = (candidate) => {
+        persistShellPath(candidate);
+        if (typeof configured === "string") {
+            console.error(`  原 shellPath 已失效,自动改用: ${candidate}`);
+        }
+        return { status: "bash", shellPath: candidate };
+    };
+    const known = knownGitBashPaths();
+    for (const candidate of known) {
+        if (await bashWorks(candidate))
+            return adopt(candidate);
+    }
+    for (const candidate of await discoveredGitBashPaths(known)) {
+        if (await bashWorks(candidate))
+            return adopt(candidate);
     }
     // 没有 Git Bash:看 PATH 上还有什么(与 pi 的兜底一致,但这里要验活)
-    const fallback = runWhere("bash.exe").find((p) => existsSync(p));
-    if (fallback && bashWorks(fallback)) {
+    const fallback = (await runWhere("bash.exe")).find((p) => existsSync(p));
+    if (fallback && (await bashWorks(fallback))) {
+        // WSL 转发器也持久化:冷启 WSL 验活要好几秒,不能每次启动都付。装了
+        // Git Bash 后的换轨由上面的 configured-WSL 分支负责(零成本 existsSync)。
+        persistShellPath(fallback);
         if (isWslRelayBash(fallback)) {
-            // 能用但跑在 Linux 里。不写进 settings:一旦用户装了 Git Bash,
-            // 下次启动就能自动切回 Windows 本机执行。
-            console.error("  ⚠ 未找到 Git Bash,将使用 WSL 的 bash:命令会在 WSL 的 Linux 里执行,不是 Windows 本机。");
-            console.error("    建议安装 Git for Windows(PowerShell 运行: winget install --id Git.Git)后重启 u1s1。");
+            adviseInstallGitBash();
             return { status: "wsl", shellPath: fallback };
         }
-        settings["shellPath"] = fallback;
-        writeFileSync(agentSettingsFile, JSON.stringify(settings, null, 2) + "\n");
         return { status: "bash", shellPath: fallback };
     }
     if (fallback) {

package/dist/tools.d.ts

@@ -8,11 +8,21 @@ export declare function createSearchTool(cfg: Pick<CliConfig, "baseUrl" | "apiKe
     query: string;
     count: number;
 }, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
-/** 抓网页:纯客户端出网,不经过我们的服务器,也不额外计费。 */
-export declare const webFetchTool: import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
+export interface FetchToolConfig {
+    baseUrl: string;
+    apiKey?: string;
+    /** 网关配了 Browser Rendering(features.web_fetch_render)才开;老网关没有 /v1/fetch。 */
+    renderFallback?: boolean;
+}
+/**
+ * 抓网页工具:先直连(免费、快),打不开或疑似被反爬/JS 空壳时,回退到
+ * 网关的 Cloudflare Browser Rendering 渲染(真无头浏览器,按次计费)。
+ */
+export declare function createFetchTool(cfg: FetchToolConfig): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
     url: Type.TString;
 }>, {
     url: string;
     contentType: string;
+    via: "direct" | "render";
     chars: number;
 }, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;

package/dist/tools.js

@@ -1,9 +1,13 @@
 import { defineTool } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
-import { searchWeb } from "./api.js";
+import { renderPage, searchWeb } from "./api.js";
 const FETCH_TIMEOUT_MS = 20_000;
 const MAX_FETCH_BYTES = 2_000_000;
 const MAX_TEXT_CHARS = 30_000;
+/** 云端渲染是真开浏览器,比直连慢得多,给宽裕些。 */
+const RENDER_TIMEOUT_MS = 45_000;
+/** 200 但榨出的正文比这还短,多半是 JS 渲染的空壳页,值得上浏览器再试。 */
+const MIN_HTML_TEXT_CHARS = 200;
 const HTML_ENTITIES = {
     " ": " ",
     "&": "&",
@@ -104,59 +108,113 @@ export function createSearchTool(cfg) {
         },
     });
 }
-/** 抓网页:纯客户端出网,不经过我们的服务器,也不额外计费。 */
-export const webFetchTool = defineTool({
-    name: "web_fetch",
-    label: "读取网页",
-    description: "Fetch a URL and return its readable text content (HTML is stripped to text; JSON and plain text are returned as-is). Use it to read a page found via web_search, or any URL the user pasted.",
-    promptSnippet: "抓取指定网址并转成可读文本",
-    promptGuidelines: [
-        "Use web_fetch to read a specific URL, and web_search when you still need to find the URL.",
-    ],
-    parameters: Type.Object({
-        url: Type.String({ description: "Absolute http(s) URL to fetch." }),
-    }),
-    async execute(_toolCallId, params, signal) {
-        let url;
-        try {
-            // 用户从聊天工具粘来的链接常带 "@https://…" 前缀,顺手剥掉
-            url = new URL(params.url.trim().replace(/^@/, ""));
-        }
-        catch {
-            throw new Error(`不是合法的网址: ${params.url}`);
-        }
-        if (url.protocol !== "http:" && url.protocol !== "https:") {
-            throw new Error(`只支持 http/https,收到 ${url.protocol}`);
-        }
-        const timeout = AbortSignal.timeout(FETCH_TIMEOUT_MS);
+/** 直连失败里值得换浏览器再试的一类:网络不通/超时,或典型的反爬状态码。 */
+class DirectFetchError extends Error {
+    renderWorthy;
+    constructor(message, renderWorthy) {
+        super(message);
+        this.renderWorthy = renderWorthy;
+    }
+}
+/** 反爬/风控常用的状态码;404/500 这类真错误换浏览器也救不回来,不白花一次渲染。 */
+const RENDER_WORTHY_STATUS = new Set([403, 405, 406, 429, 503]);
+/** 直连抓取:纯客户端出网,不经过我们的服务器,也不额外计费。 */
+async function fetchDirect(url, signal) {
+    const timeout = AbortSignal.timeout(FETCH_TIMEOUT_MS);
+    const abort = signal ? AbortSignal.any([signal, timeout]) : timeout;
+    let resp;
+    try {
+        resp = await fetch(url, {
+            redirect: "follow",
+            headers: {
+                accept: "text/html,application/xhtml+xml,application/json,text/plain;q=0.9,*/*;q=0.8",
+                "user-agent": "u1s1-cli",
+            },
+            signal: abort,
+        });
+    }
+    catch (e) {
+        // 用户主动打断不算失败,直接往外抛,不去碰云端渲染
+        if (signal?.aborted)
+            throw e;
+        throw new DirectFetchError(`打不开 ${url.href}: ${e.message}`, true);
+    }
+    if (!resp.ok) {
+        throw new DirectFetchError(`${url.href} 返回 ${resp.status} ${resp.statusText}`, RENDER_WORTHY_STATUS.has(resp.status));
+    }
+    const type = resp.headers.get("content-type") ?? "";
+    if (!/text\/|json|xml|javascript/i.test(type)) {
+        throw new DirectFetchError(`${url.href} 不是文本内容 (${type || "unknown"}),读不了`, false);
+    }
+    const raw = decodeBody(await readBodyCapped(resp, MAX_FETCH_BYTES), type);
+    const isHtml = /html|xml/i.test(type);
+    return { text: isHtml ? htmlToText(raw) : raw.trim(), contentType: type, isHtml };
+}
+/**
+ * 抓网页工具:先直连(免费、快),打不开或疑似被反爬/JS 空壳时,回退到
+ * 网关的 Cloudflare Browser Rendering 渲染(真无头浏览器,按次计费)。
+ */
+export function createFetchTool(cfg) {
+    const canRender = () => !!(cfg.renderFallback && cfg.apiKey);
+    async function renderViaGateway(url, signal) {
+        const timeout = AbortSignal.timeout(RENDER_TIMEOUT_MS);
         const abort = signal ? AbortSignal.any([signal, timeout]) : timeout;
-        let resp;
-        try {
-            resp = await fetch(url, {
-                redirect: "follow",
-                headers: {
-                    accept: "text/html,application/xhtml+xml,application/json,text/plain;q=0.9,*/*;q=0.8",
-                    "user-agent": "u1s1-cli",
-                },
-                signal: abort,
+        const { markdown } = await renderPage(cfg, url.href, abort);
+        return markdown.trim();
+    }
+    return defineTool({
+        name: "web_fetch",
+        label: "读取网页",
+        description: "Fetch a URL and return its readable text content (HTML is stripped to text; JSON and plain text are returned as-is). Use it to read a page found via web_search, or any URL the user pasted. If the direct fetch fails or the page needs JavaScript, it automatically retries through a cloud headless browser.",
+        promptSnippet: "抓取指定网址并转成可读文本",
+        promptGuidelines: [
+            "Use web_fetch to read a specific URL, and web_search when you still need to find the URL.",
+        ],
+        parameters: Type.Object({
+            url: Type.String({ description: "Absolute http(s) URL to fetch." }),
+        }),
+        async execute(_toolCallId, params, signal) {
+            let url;
+            try {
+                // 用户从聊天工具粘来的链接常带 "@https://…" 前缀,顺手剥掉
+                url = new URL(params.url.trim().replace(/^@/, ""));
+            }
+            catch {
+                throw new Error(`不是合法的网址: ${params.url}`);
+            }
+            if (url.protocol !== "http:" && url.protocol !== "https:") {
+                throw new Error(`只支持 http/https,收到 ${url.protocol}`);
+            }
+            const ok = (text, via, contentType) => ({
+                content: [{ type: "text", text: truncate(`# ${url.href}\n\n${text || "(空白页面)"}`) }],
+                details: { url: url.href, contentType, via, chars: text.length },
             });
-        }
-        catch (e) {
-            throw new Error(`打不开 ${url.href}: ${e.message}`);
-        }
-        if (!resp.ok)
-            throw new Error(`${url.href} 返回 ${resp.status} ${resp.statusText}`);
-        const type = resp.headers.get("content-type") ?? "";
-        if (!/text\/|json|xml|javascript/i.test(type)) {
-            throw new Error(`${url.href} 不是文本内容 (${type || "unknown"}),读不了`);
-        }
-        const raw = decodeBody(await readBodyCapped(resp, MAX_FETCH_BYTES), type);
-        const text = /html|xml/i.test(type) ? htmlToText(raw) : raw.trim();
-        return {
-            content: [
-                { type: "text", text: truncate(`# ${url.href}\n\n${text || "(空白页面)"}`) },
-            ],
-            details: { url: url.href, contentType: type, chars: text.length },
-        };
-    },
-});
+            let direct = null;
+            try {
+                direct = await fetchDirect(url, signal);
+            }
+            catch (e) {
+                if (!(e instanceof DirectFetchError) || !e.renderWorthy || !canRender())
+                    throw e;
+                try {
+                    return ok(await renderViaGateway(url, signal), "render", "text/markdown");
+                }
+                catch (re) {
+                    throw new Error(`${e.message}；云端浏览器渲染也失败: ${re.message}`);
+                }
+            }
+            // 直连 200 但正文近乎空:大概率是 JS 渲染的 SPA,换浏览器再试;渲染失败就退回空壳
+            if (direct.isHtml && direct.text.length < MIN_HTML_TEXT_CHARS && canRender()) {
+                try {
+                    const rendered = await renderViaGateway(url, signal);
+                    if (rendered.length > direct.text.length)
+                        return ok(rendered, "render", "text/markdown");
+                }
+                catch {
+                    // 直连结果虽薄但还在,渲染挂了不至于让整次调用失败
+                }
+            }
+            return ok(direct.text, "direct", direct.contentType);
+        },
+    });
+}

package/dist/usage.js

@@ -66,7 +66,7 @@ export async function usage() {
             console.log("  → 你有免费用量包没领:首月每天 1 亿 Token,去 https://u1s1.io/dashboard 点「领取」");
         }
         else if (me.free_claim === "renew") {
-            console.log("  → 免费用量包到期了,去 https://u1s1.io/dashboard 续领:每天 5000 万 Token,一年有效");
+            console.log("  → 免费用量包到期了,去 https://u1s1.io/dashboard 续领:每天 3000 万 Token,一年有效");
         }
         else {
             console.log("  免费包每天 0 点恢复;邀请朋友双方各得一次性 1 亿 Token 包 → https://u1s1.io/dashboard");

package/dist/web.js

@@ -21,29 +21,34 @@ const require = createRequire(import.meta.url);
  */
 export async function prepareWebEnv(cfg) {
     cleanupBrandThemes();
-    ensureBrandPrompt(ensureUsableShell());
     ensureDefaultSettings();
+    // Windows shell 体检异步先行,与取模型列表并行,写 brand prompt 前 await
+    const shellReady = ensureUsableShell();
     // 网页版/App 的 agent 会话同样依赖 fd/rg(同一个 agentDir);与取模型列表并行
     const searchToolsReady = ensureSearchTools(cfg);
     // Fetch model list from server; fall back to built-in MODELS on error.
     // 服务端没开搜索(或老网关没有 features 字段)时不注册 web_search
     // 自定义端点与模型列表并行拉取,失败各自兜底(内置列表 / 本地缓存)
     let webSearchEnabled = true;
+    // 老网关没有 /v1/fetch,web_fetch_render 缺失时按关闭处理,直连失败不去白调
+    let webFetchRenderEnabled = false;
     const endpointsReady = loadCustomEndpoints(cfg);
     try {
         const { models, features } = await fetchModels(cfg);
         setModelsFromApi(models.map(apiModelToDef));
         webSearchEnabled = features.web_search !== false;
+        webFetchRenderEnabled = features.web_fetch_render === true;
     }
     catch (e) {
         console.error("  获取模型列表失败,使用内置列表:", e.message);
     }
     await endpointsReady;
+    ensureBrandPrompt(await shellReady);
     ensureProviderModels(cfg);
     // pi-web-ui 靠 auth.json 判断「已配置」,否则网页会弹 pi 安装引导
     ensureAuthCredential();
     // 联网工具经 agentDir/extensions 投影,和 TUI 共用一份注册
-    writeWebToolsExtension(cfg, webSearchEnabled);
+    writeWebToolsExtension(cfg, { webSearch: webSearchEnabled, webFetchRender: webFetchRenderEnabled });
     // 网页版新会话从 settings.json 的 defaultModel 取模型(TUI 是每次传 --model),
     // 确保它有值;resolvePreferredModel 优先尊重已有的 in-session 选择,不会回退覆盖。
     const pref = resolvePreferredModel(cfg);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u1s1-cli",
-  "version": "0.13.5",
+  "version": "0.13.7",
   "description": "u1s1 — 有一说一,最省心的 AI 编程搭子。终端里用中文说需求,AI 帮你读文件、改代码、跑命令。",
   "type": "module",
   "bin": {