u1s1-cli 0.16.6 → 0.18.0

package/dist/brand.d.ts

@@ -9,5 +9,8 @@ export declare const HERO_ART: string[];
  * Startup hero, responsive to terminal width:
  * wide → wordmark with info column beside it; medium → stacked; narrow → one-liner.
  */
-export declare function renderBrandHeader(theme: Theme, version: string, cwd: string, width: number, notice?: string): string[];
+export declare function renderBrandHeader(theme: Theme, version: string, cwd: string, width: number, notice?: string, announcement?: {
+    text: string;
+    url?: string;
+}): string[];
 export declare function printConsoleBanner(version: string): void;

package/dist/brand.js

@@ -42,23 +42,34 @@ function paintArt(theme, line) {
     flush();
     return out;
 }
+/** 公告行:📢 前缀 + 正文(accent 色),可选链接(dim)。 */
+function announcementLine(theme, a) {
+    const link = a.url ? `  ${theme.fg("dim", a.url)}` : "";
+    return `${theme.fg("accent", "📢")} ${theme.fg("accent", a.text)}${link}`;
+}
 /**
  * Startup hero, responsive to terminal width:
  * wide → wordmark with info column beside it; medium → stacked; narrow → one-liner.
  */
-export function renderBrandHeader(theme, version, cwd, width, notice) {
+export function renderBrandHeader(theme, version, cwd, width, notice, announcement) {
     const name = theme.bold(theme.fg("text", `${BRAND_NAME} v${version}`)) +
         (notice ? `  ${theme.fg("accent", notice)}` : "");
     const brand = theme.fg("muted", `${BRAND_CN} · ${BRAND_TAGLINE}`);
     const dir = theme.fg("dim", `cwd: ${formatHomePath(cwd)}`);
     const hints = theme.fg("dim", "/help 看命令 · Shift+Enter 换行 · Esc 中断");
     if (width < ART_WIDTH + 4) {
-        return ["", ` ${theme.fg("accent", "✻")} ${name}  ${theme.fg("muted", BRAND_CN)}`, `   ${dir}`, ""];
+        const lines = ["", ` ${theme.fg("accent", "✻")} ${name}  ${theme.fg("muted", BRAND_CN)}`, `   ${dir}`];
+        if (announcement)
+            lines.push(`   ${announcementLine(theme, announcement)}`);
+        return [...lines, ""];
     }
     const art = HERO_ART.map((line) => ` ${paintArt(theme, line)}`);
     // widest info row (hints) needs 46 cols beside the 28-col wordmark
     if (width < ART_WIDTH + 46) {
-        return ["", ...art, "", ` ${name}  ${brand}`, ` ${dir}`, ""];
+        const lines = ["", ...art, "", ` ${name}  ${brand}`, ` ${dir}`];
+        if (announcement)
+            lines.push(` ${announcementLine(theme, announcement)}`);
+        return [...lines, ""];
     }
     const rows = [...art];
     const gap = "   ";
@@ -66,6 +77,9 @@ export function renderBrandHeader(theme, version, cwd, width, notice) {
     rows[2] += `${gap}${brand}`;
     rows[3] += `${gap}${dir}`;
     rows[4] += `${gap}${hints}`;
+    // 公告放信息列末尾(最后一行字模旁),够醒目又不挤掉常规信息
+    if (announcement)
+        rows[5] += `${gap}${announcementLine(theme, announcement)}`;
     return ["", ...rows, ""];
 }
 export function printConsoleBanner(version) {

package/dist/config.js

@@ -51,7 +51,7 @@ export function apiModelToDef(m) {
 }
 export const MODELS = [
     {
-        id: "deepseek/deepseek-v4-flash",
+        id: "deepseek-v4-flash",
         name: "DeepSeek V4 Flash (u1s1)",
         aliases: ["deepseek", "flash", "v4-flash"],
         reasoning: false,

package/dist/index.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import { execSync, spawnSync } from "node:child_process";
 import { writeFileSync } from "node:fs";
-import { cleanupBrandThemes, endpointKeyEnv, endpointProviderEntry, ensureBrandPrompt, ensureDefaultSettings, ensureProviderModels, scrubForeignProviderEnv, toProviderModels, writeCompactUiExtension, writeWebToolsExtension, } from "./agent-setup.js";
+import { cleanupBrandThemes, endpointKeyEnv, endpointProviderEntry, ensureBrandPrompt, ensureDefaultSettings, ensureProviderModels, ensureWorkflowPromptTemplate, scrubForeignProviderEnv, toProviderModels, writeCompactUiExtension, writeWebToolsExtension, } from "./agent-setup.js";
 import { printConsoleBanner } from "./brand.js";
 import { agentDir, apiModelToDef, CUSTOM_ENDPOINTS, isPortableInstall, loadConfig, MODELS, persistPreferredModel, PROVIDER_ID, readSettings, refValid, resolvePreferredModel, setModelsFromApi, VERSION, } from "./config.js";
 import { registerLoopCommand } from "./loop.js";
 import { ensureSearchTools } from "./search-tools.js";
 import { ensureUsableShell } from "./shell-doctor.js";
-import { applyBrandUi, setUpdateNotice } from "./style.js";
+import { applyBrandUi, setAnnouncement, setUpdateNotice } from "./style.js";
 import { fetchModels, loadCustomEndpoints } from "./api.js";
 const PACKAGE_NAME = "u1s1-cli";
 /** 启动时检测到的可自动安装的新版;TUI 退出后才装(见 installPendingUpdate)。 */
@@ -151,11 +151,14 @@ async function runAgent(cfg, args) {
     let imageGenEnabled = false;
     const endpointsReady = loadCustomEndpoints(cfg);
     try {
-        const { models, features } = await fetchModels(cfg);
+        const { models, features, announcement } = await fetchModels(cfg);
         setModelsFromApi(models.map(apiModelToDef));
         webSearchEnabled = features.web_search !== false;
         webFetchRenderEnabled = features.web_fetch_render === true;
         imageGenEnabled = features.image_gen === true;
+        // 后台下发的启动公告(与模型列表同一次请求捎回,零额外开销);空/老网关不显示
+        if (announcement?.text)
+            setAnnouncement(announcement);
     }
     catch (e) {
         console.error("  获取模型列表失败,使用内置列表:", e.message);
@@ -163,6 +166,7 @@ async function runAgent(cfg, args) {
     await endpointsReady;
     ensureBrandPrompt(await shellReady);
     ensureProviderModels(cfg);
+    ensureWorkflowPromptTemplate();
     // 联网工具经 agentDir/extensions 投影,TUI 和 u1s1 web 共用一份注册
     writeWebToolsExtension(cfg, {
         webSearch: webSearchEnabled,

package/dist/style.d.ts

@@ -1,4 +1,8 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export declare function setAnnouncement(next: {
+    text: string;
+    url?: string;
+} | undefined): void;
 export declare function setUpdateNotice(notice: string): void;
 /**
  * Brand chrome is just the startup hero + window title; everything else

package/dist/style.js

@@ -8,6 +8,12 @@ import { renderBrandHeader } from "./brand.js";
  */
 let updateNotice = "";
 let refreshHeader;
+/** 启动横幅上的运营公告(后台下发,见 fetchModels 的 announcement 字段)。 */
+let announcement;
+export function setAnnouncement(next) {
+    announcement = next;
+    refreshHeader?.();
+}
 export function setUpdateNotice(notice) {
     updateNotice = notice;
     refreshHeader?.();
@@ -28,7 +34,7 @@ export function applyBrandUi(pi, version) {
                 return {
                     render(width) {
                         // pi-tui crashes on lines wider than the terminal, so truncate defensively.
-                        return renderBrandHeader(theme, version, process.cwd(), width, updateNotice).map((line) => truncateToWidth(line, width));
+                        return renderBrandHeader(theme, version, process.cwd(), width, updateNotice, announcement).map((line) => truncateToWidth(line, width));
                     },
                     invalidate() { },
                 };

package/dist/subagent.d.ts

@@ -0,0 +1,44 @@
+/** 同时在跑的子 agent 上限;超额排队,防止打爆网关。 */
+export declare const SUBAGENT_CONCURRENCY = 4;
+/** 单个子任务默认超时;到点 abort,不让一个卡死的任务拖住整批。 */
+export declare const SUBAGENT_TIMEOUT_MS: number;
+/** 主会话当前模型的引用,用于子 agent 默认继承同款模型。 */
+export type ParentModelRef = {
+    provider: string;
+    id: string;
+} | undefined;
+export interface SubagentOptions {
+    task: string;
+    /** 主会话当前模型(缺省时子 agent 尝试继承它)。 */
+    parentModel?: ParentModelRef;
+    /** 覆盖模型:"provider/id" 或裸 id。 */
+    model?: string;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    /** 禁用全部工具(纯文本推理,判分等廉价场景用)。 */
+    noTools?: boolean;
+    /** 子 agent 的工作目录(git worktree 隔离等场景);缺省继承主进程 cwd。 */
+    cwd?: string;
+}
+/** 单个子 agent 的 token/费用用量(汇总自会话内全部 assistant 消息)。 */
+export interface SubagentUsage {
+    totalTokens: number;
+    costUsd: number;
+}
+export interface SubagentOutcome {
+    ok: boolean;
+    text: string;
+    usage: SubagentUsage;
+}
+/**
+ * Spawn 一个独立上下文的子 agent 执行任务,返回其最终文本输出。
+ * 模型解析:"provider/id" 精确匹配;裸 id(如 deepseek-v4-flash)先按原样找,
+ * 再兜底到 u1s1 provider —— 和 CLI --model 的解析习惯保持一致。
+ * 失败(模型错误/超时/取消)抛错,由调用方决定容错语义。
+ */
+export declare function runSubagent(opts: SubagentOptions): Promise<SubagentOutcome>;
+/**
+ * 固定并发的工作池:limit 个工人依次领任务跑完一个补位一个。
+ * worker 抛错由调用方在 fn 内部兜住;signal 中止后不再领新任务。
+ */
+export declare function runPool<T>(items: readonly T[], limit: number, fn: (item: T, index: number) => Promise<void>, signal?: AbortSignal): Promise<void>;

package/dist/subagent.js

@@ -0,0 +1,133 @@
+import { createAgentSession, DefaultResourceLoader, getAgentDir, ModelRuntime, SessionManager, } from "@earendil-works/pi-coding-agent";
+// ---- 子 agent spawn 基础设施:spawn_subagent 工具与 workflow runner 共用 ----
+/** 同时在跑的子 agent 上限;超额排队,防止打爆网关。 */
+export const SUBAGENT_CONCURRENCY = 4;
+/** 单个子任务默认超时;到点 abort,不让一个卡死的任务拖住整批。 */
+export const SUBAGENT_TIMEOUT_MS = 15 * 60_000;
+/** ModelRuntime 进程内只建一次(auth/models 解析有启动开销)。 */
+let sharedModelRuntime;
+/** 从会话消息里取最后一条非空 assistant 文本作为子 agent 的最终输出。 */
+function extractFinalText(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const content = messages[i]?.content;
+        if (!Array.isArray(content))
+            continue;
+        const text = content
+            .filter((b) => b?.type === "text")
+            .map((b) => String(b.text ?? ""))
+            .join("\n")
+            .trim();
+        if (text)
+            return text;
+    }
+    return "(子 agent 结束但没有文本输出)";
+}
+/**
+ * 汇总会话内全部 assistant 消息的 token 与费用。
+ * pi-ai 对自定义 provider(models.json)不算钱(usage.cost.total 恒 0),
+ * 所以优先用自带费用,否则按模型价率(美元/百万 token)自算。
+ */
+function extractUsage(messages, model) {
+    let totalTokens = 0;
+    let costUsd = 0;
+    const rates = model?.cost;
+    for (const m of messages) {
+        const msg = m;
+        const usage = msg?.usage;
+        if (!usage || msg.role !== "assistant")
+            continue;
+        totalTokens += usage.totalTokens ?? 0;
+        const reported = usage.cost?.total ?? 0;
+        if (reported > 0) {
+            costUsd += reported;
+        }
+        else if (rates) {
+            costUsd +=
+                ((usage.input ?? 0) * rates.input +
+                    (usage.output ?? 0) * rates.output +
+                    (usage.cacheRead ?? 0) * rates.cacheRead +
+                    (usage.cacheWrite ?? 0) * rates.cacheWrite) /
+                    1_000_000;
+        }
+    }
+    return { totalTokens, costUsd };
+}
+/**
+ * Spawn 一个独立上下文的子 agent 执行任务,返回其最终文本输出。
+ * 模型解析:"provider/id" 精确匹配;裸 id(如 deepseek-v4-flash)先按原样找,
+ * 再兜底到 u1s1 provider —— 和 CLI --model 的解析习惯保持一致。
+ * 失败(模型错误/超时/取消)抛错,由调用方决定容错语义。
+ */
+export async function runSubagent(opts) {
+    sharedModelRuntime ??= await ModelRuntime.create();
+    let model;
+    if (opts.model) {
+        const slash = opts.model.indexOf("/");
+        const providerId = slash === -1 ? "u1s1" : opts.model.slice(0, slash);
+        const modelId = slash === -1 ? opts.model : opts.model.slice(slash + 1);
+        model =
+            sharedModelRuntime.getModel(providerId, modelId) ??
+                (slash === -1 ? sharedModelRuntime.getModel("u1s1", opts.model) : undefined);
+        if (!model)
+            throw new Error(`找不到模型 "${opts.model}"(可用 /model 查看已配置的模型)`);
+    }
+    else if (opts.parentModel) {
+        // 继承主会话模型;解析不到(端点被删等)就落回默认,不硬失败
+        model = sharedModelRuntime.getModel(opts.parentModel.provider, opts.parentModel.id);
+    }
+    else {
+        model = undefined;
+    }
+    // 子会话不加载精简 UI 扩展:它用 process.cwd() 重建内置工具,会破坏自定义
+    // cwd(worktree 隔离)下的路径解析;且 UI 美化对无界面的子 agent 毫无意义
+    const loader = new DefaultResourceLoader({
+        agentDir: getAgentDir(),
+        cwd: opts.cwd ?? process.cwd(),
+        extensionsOverride: (base) => ({
+            ...base,
+            extensions: base.extensions.filter((e) => !JSON.stringify(e).includes("u1s1-compact-ui")),
+        }),
+    });
+    await loader.reload();
+    const { session } = await createAgentSession({
+        // cwd 必须同时传给顶层(工具的路径解析基于它)和 sessionManager
+        ...(opts.cwd ? { cwd: opts.cwd } : {}),
+        resourceLoader: loader,
+        sessionManager: SessionManager.inMemory(opts.cwd ?? process.cwd()),
+        modelRuntime: sharedModelRuntime,
+        ...(model ? { model } : {}),
+        ...(opts.noTools ? { noTools: "all" } : {}),
+    });
+    const timeoutMs = opts.timeoutMs ?? SUBAGENT_TIMEOUT_MS;
+    const timer = setTimeout(() => void session.abort(), timeoutMs);
+    const onParentAbort = () => void session.abort();
+    opts.signal?.addEventListener("abort", onParentAbort, { once: true });
+    try {
+        await session.prompt(opts.task);
+    }
+    finally {
+        clearTimeout(timer);
+        opts.signal?.removeEventListener("abort", onParentAbort);
+        session.dispose();
+    }
+    if (opts.signal?.aborted)
+        throw new Error("已取消");
+    const messages = session.messages;
+    return { ok: true, text: extractFinalText(messages), usage: extractUsage(messages, model) };
+}
+/**
+ * 固定并发的工作池:limit 个工人依次领任务跑完一个补位一个。
+ * worker 抛错由调用方在 fn 内部兜住;signal 中止后不再领新任务。
+ */
+export async function runPool(items, limit, fn, signal) {
+    let next = 0;
+    const worker = async () => {
+        for (;;) {
+            const i = next++;
+            if (i >= items.length || signal?.aborted)
+                return;
+            await fn(items[i], i);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.max(1, Math.min(limit, items.length)) }, worker));
+}

package/dist/tools.d.ts

@@ -1,10 +1,33 @@
+import { ParentModelRef } from "./subagent.js";
+import { Text } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
 import type { CliConfig } from "./config.js";
+export declare function truncate(text: string): string;
+/** 联网工具通用渲染:调用行不占位,收起时只显一行摘要,ctrl+o 展开全文,出错显一行 ✗ */
+export declare function compactResultRender(result: {
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+}, options: {
+    expanded: boolean;
+}, theme: {
+    fg: (color: any, text: string) => string;
+}, context: {
+    isError: boolean;
+}, summaryLine: string): Text;
 /** 联网搜索工具:走 u1s1 网关代理,上游 key 不落到用户机器上。 */
 export declare function createSearchTool(cfg: Pick<CliConfig, "baseUrl" | "apiKey">): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
     query: Type.TString;
     maxResults: Type.TOptional<Type.TNumber>;
 }>, unknown, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
+/** 子 agent 工具:独立上下文窗口干活,只把结果摘要带回主对话,不污染主 token 预算。 */
+export declare function createSubagentTool(getParentModel: () => ParentModelRef): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
+    task: Type.TOptional<Type.TString>;
+    tasks: Type.TOptional<Type.TArray<Type.TString>>;
+    model: Type.TOptional<Type.TString>;
+    timeout_minutes: Type.TOptional<Type.TNumber>;
+}>, unknown, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
 /** 生图工具:走 u1s1 网关代理火山方舟 Seedream,上游 key 不落到用户机器上。 */
 export declare function createImageTool(cfg: Pick<CliConfig, "baseUrl" | "apiKey">): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
     prompt: Type.TString;

package/dist/tools.js

@@ -1,6 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { dirname, extname, resolve } from "node:path";
 import { defineTool } from "@earendil-works/pi-coding-agent";
+import { runPool, runSubagent, SUBAGENT_CONCURRENCY, SUBAGENT_TIMEOUT_MS } from "./subagent.js";
 import { Text } from "@earendil-works/pi-tui";
 import { Type } from "typebox";
 import { generateImage, renderPage, searchWeb } from "./api.js";
@@ -32,7 +33,7 @@ function htmlToText(html) {
         .replace(/\n\s*\n\s*\n+/g, "\n\n")
         .trim();
 }
-function truncate(text) {
+export function truncate(text) {
     if (text.length <= MAX_TEXT_CHARS)
         return text;
     return `${text.slice(0, MAX_TEXT_CHARS)}\n\n…（内容过长已截断，共 ${text.length} 字符）`;
@@ -87,7 +88,7 @@ function resultText(result) {
     return c && c.type === "text" ? (c.text ?? "") : "";
 }
 /** 联网工具通用渲染:调用行不占位,收起时只显一行摘要,ctrl+o 展开全文,出错显一行 ✗ */
-function compactResultRender(result, options, 
+export function compactResultRender(result, options, 
 // 放宽成 any 只为避开 pi 的 ThemeColor 联合类型在结构化匹配时的逆变报错;
 // 实际传入的就是 pi 的 Theme,取值只用 "warning"/"muted" 两色
 theme, context, summaryLine) {
@@ -148,6 +149,101 @@ export function createSearchTool(cfg) {
         },
     });
 }
+// ---- spawn_subagent 工具:spawn 设施在 ./subagent.ts,与 workflow runner 共用 ----
+/** 单次调用最多并行任务数;再多模型也看不过来,让主 agent 分批调。 */
+const SUBAGENT_MAX_TASKS = 10;
+/** 子 agent 工具:独立上下文窗口干活,只把结果摘要带回主对话,不污染主 token 预算。 */
+export function createSubagentTool(getParentModel) {
+    return defineTool({
+        name: "spawn_subagent",
+        label: "子任务",
+        description: "Spawn an independent sub-agent with its own context window to complete a self-contained task, then return its final answer. " +
+            "Pass `tasks` (array) to run N sub-agents concurrently — ideal for embarrassingly parallel work like translating many locale files, " +
+            "reviewing several files, or researching multiple directions at once. Each sub-agent can read/write files and run commands. " +
+            "Results come back as summaries; the main conversation never holds the sub-agents' intermediate state.",
+        promptSnippet: "Delegate self-contained tasks to independent sub-agents, optionally many in parallel",
+        promptGuidelines: [
+            "Use spawn_subagent when a task splits into independent pieces (e.g. one locale file per language): pass a `tasks` array and they run concurrently.",
+            "Each task description must be fully self-contained — sub-agents start with zero context about the conversation.",
+            "Each call costs tokens per sub-agent; don't fan out for trivial work a couple of tool calls could finish.",
+        ],
+        parameters: Type.Object({
+            task: Type.Optional(Type.String({ description: "Single self-contained task for one sub-agent." })),
+            tasks: Type.Optional(Type.Array(Type.String(), {
+                description: "Multiple self-contained tasks to run in concurrent sub-agents (up to 10). Use instead of `task` for parallelizable work.",
+                maxItems: SUBAGENT_MAX_TASKS,
+            })),
+            model: Type.Optional(Type.String({
+                description: 'Model for the sub-agent(s) as "provider/id" or bare id (defaults to the current conversation model).',
+            })),
+            timeout_minutes: Type.Optional(Type.Number({
+                description: `Per-task timeout in minutes (default ${SUBAGENT_TIMEOUT_MS / 60_000}, max 60). Timed-out tasks are aborted, not fatal to the batch.`,
+                minimum: 1,
+                maximum: 60,
+            })),
+        }),
+        // 精简展示:收起一行摘要,ctrl+o 展开完整报告
+        renderShell: "self",
+        renderCall() {
+            return new Text("", 0, 0);
+        },
+        renderResult(result, options, theme, context) {
+            const d = result.details;
+            const summary = d && typeof d.count === "number"
+                ? `🤖 子任务 ×${d.count}` +
+                    (typeof d.ok === "number" && d.failed ? ` · ✓${d.ok} ✗${d.failed}` : "") +
+                    (typeof d.seconds === "number" ? ` · ${d.seconds}s` : "")
+                : "🤖 子任务";
+            return compactResultRender(result, options, theme, context, summary);
+        },
+        async execute(_toolCallId, params, signal) {
+            const list = (params.tasks?.length ? params.tasks : params.task ? [params.task] : [])
+                .map((t) => t.trim())
+                .filter(Boolean)
+                .slice(0, SUBAGENT_MAX_TASKS);
+            if (list.length === 0) {
+                throw new Error("task 和 tasks 至少填一个");
+            }
+            const parentModel = getParentModel();
+            const timeoutMs = Math.min(60, params.timeout_minutes ?? SUBAGENT_TIMEOUT_MS / 60_000) * 60_000;
+            // 标记子 agent 环境:扩展生成器据此不再给孙 agent 注册本工具,杜绝递归 spawn
+            const prevFlag = process.env.U1S1_IN_SUBAGENT;
+            process.env.U1S1_IN_SUBAGENT = "1";
+            const started = Date.now();
+            const outcomes = new Array(list.length);
+            try {
+                await runPool(list, SUBAGENT_CONCURRENCY, async (task, i) => {
+                    outcomes[i] = await runSubagent({ task, parentModel, model: params.model, timeoutMs, signal }).catch((e) => ({ ok: false, text: e.message, usage: { totalTokens: 0, costUsd: 0 } }));
+                }, signal);
+            }
+            finally {
+                if (prevFlag === undefined)
+                    delete process.env.U1S1_IN_SUBAGENT;
+                else
+                    process.env.U1S1_IN_SUBAGENT = prevFlag;
+            }
+            const seconds = Math.round((Date.now() - started) / 1000);
+            const failedIdx = outcomes.map((o, i) => (o?.ok ? -1 : i)).filter((i) => i >= 0);
+            const details = { count: list.length, ok: list.length - failedIdx.length, failed: failedIdx.length, seconds };
+            // 单任务成功直接回原文,别套报告壳浪费 token
+            if (list.length === 1 && !failedIdx.length) {
+                return {
+                    content: [{ type: "text", text: truncate(outcomes[0]?.text ?? "") }],
+                    details: { ...details, seconds: undefined },
+                };
+            }
+            const lines = [`共 ${list.length} 个子任务,✓${details.ok} ✗${details.failed},用时 ${seconds}s`, ""];
+            outcomes.forEach((o, i) => {
+                lines.push(`## 任务 ${i + 1}/${list.length} ${o?.ok ? "✅" : "❌"}`, "");
+                lines.push(o?.ok ? o.text : `失败:${o?.text ?? "未知错误"}`, "", "---", "");
+            });
+            return {
+                content: [{ type: "text", text: truncate(lines.join("\n").trim()) }],
+                details,
+            };
+        },
+    });
+}
 /** 生图链路 = 网关排队 + 方舟生成(2K 实测 ~10s,4K 更久)+ 下载落盘。 */
 const IMAGE_TIMEOUT_MS = 150_000;
 /** 方舟单张参考图原图上限 10MB。 */

package/dist/web.js

@@ -2,7 +2,7 @@ import { spawn, spawnSync } from "node:child_process";
 import { mkdirSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, join } from "node:path";
-import { cleanupBrandThemes, endpointKeyEnv, ensureAuthCredential, ensureBrandPrompt, ensureDefaultSettings, ensureProviderModels, scrubForeignProviderEnv, writeWebToolsExtension, } from "./agent-setup.js";
+import { cleanupBrandThemes, endpointKeyEnv, ensureAuthCredential, ensureBrandPrompt, ensureWorkflowPromptTemplate, ensureDefaultSettings, ensureProviderModels, scrubForeignProviderEnv, writeWebToolsExtension, } from "./agent-setup.js";
 import { agentDir, apiModelToDef, resolvePreferredModel, setModelsFromApi, u1s1Dir, writeAgentDefaultModel, } from "./config.js";
 import { ensureSearchTools } from "./search-tools.js";
 import { ensureUsableShell } from "./shell-doctor.js";
@@ -47,6 +47,8 @@ export async function prepareWebEnv(cfg) {
     }
     await endpointsReady;
     ensureBrandPrompt(await shellReady);
+    // /workflow 提示词模板与 TUI 同源,web/桌面版也要有
+    ensureWorkflowPromptTemplate();
     ensureProviderModels(cfg);
     // pi-web-ui 靠 auth.json 判断「已配置」,否则网页会弹 pi 安装引导
     ensureAuthCredential();

package/dist/workflow/runner.d.ts

@@ -0,0 +1,48 @@
+import { type ParentModelRef } from "../subagent.js";
+/** 整个 run 的默认墙钟上限。 */
+export declare const WORKFLOW_TIMEOUT_MS: number;
+/** 默认整个 run 的 token 预算;0 或负数表示不设限。 */
+export declare const WORKFLOW_DEFAULT_BUDGET_TOKENS = 20000000;
+/** 静态白名单校验:语法能编译 + 不碰沙箱之外的任何能力。 */
+export declare function validateScript(code: string): string[];
+export interface WorkflowRunResult {
+    /** 给主 agent 的完整报告(markdown)。 */
+    report: string;
+    details: {
+        spawns: number;
+        ok: number;
+        failed: number;
+        cached: number;
+        seconds: number;
+        aborted: boolean;
+    };
+}
+export interface WorkflowProgress {
+    spawns: number;
+    ok: number;
+    failed: number;
+    cached: number;
+    running: number;
+    spentTokens: number;
+    budgetTokens: number;
+}
+export interface WorkflowRunOptions {
+    /** 脚本源码(调用方负责落盘)。 */
+    code: string;
+    /** 进度存档路径;同名文件存在且 resume=true 时跳过已完成任务。 */
+    progressPath: string;
+    resume?: boolean;
+    parentModel: ParentModelRef;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+    /** 整个 run 的 token 上限;缺省 WORKFLOW_DEFAULT_BUDGET_TOKENS,<=0 不限。 */
+    budgetTokens?: number;
+    /** 每次子任务状态变化时回调(工具层节流后转成流式进度)。 */
+    onProgress?: (p: WorkflowProgress) => void;
+}
+/** 执行一个 workflow 脚本,返回给主对话的报告。不抛错——失败也进报告让模型自行修复。 */
+export declare function runWorkflow(opts: WorkflowRunOptions): Promise<WorkflowRunResult>;
+/** 工作区目录:项目根 .u1s1/workflows/(脚本 + 进度存档都在这里)。 */
+export declare function workflowsDir(): string;
+/** 内联脚本落盘,返回脚本路径(进度存档按同名约定派生)。 */
+export declare function saveWorkflowScript(code: string): string;