pi-web-ui 0.80.0 → 0.80.2

package/dist/server/agent-service.js

@@ -45,6 +45,7 @@ import { collectSubagentDescendantIds, makeSubagentTools, subagentTitle, withSub
 import { makeDelegateTaskTool } from "./delegate-task.js";
 import { buildAttachmentMessages } from "./attachments.js";
 import { BUILTIN_SOUL, DEFAULT_PROMPT_TEMPLATE, buildToolsSchemaText, renderPromptTemplate, resolveSectionTexts, } from "./prompt-composer.js";
+import { launchOrigin, toServiceInfo } from "./launch-origin.js";
 import { serializeMessage, serializeStreamingMessage, stripTransientRetryErrors, } from "./serialize.js";
 import { loadCommands, saveCommandsFile, TerminalManager } from "./terminals.js";
 const SNAPSHOT_INTERVAL_MS = 60;
@@ -127,7 +128,9 @@ Many legacy Chinese text files (.html/.txt/.md/.log, exported documents) are GBK
  * terminal) plus head/tail (post-processed on the returned output) so the parameter
  * schema stays consistent with the terminal-backed tool.
  */
-export function makeKillableBashTool(cwd, kills) {
+export function makeKillableBashTool(cwd, kills, 
+/** per-call 返回文本的服务端语言（默认英文）；工具 definition 走 bilingual 内联双语。 */
+lang = () => "en") {
     const base = createLocalBashOperations();
     const tool = createBashTool(cwd, {
         operations: {
@@ -176,7 +179,7 @@ export function makeKillableBashTool(cwd, kills) {
             // head/tail 后处理（native 无终端，直接截返回行即可）。
             const p = params;
             if ((p?.head || p?.tail) && result?.content?.[0]?.text != null) {
-                result.content[0].text = applyHeadTail(result.content[0].text, p.head, p.tail);
+                result.content[0].text = applyHeadTail(result.content[0].text, p.head, p.tail, lang());
             }
             return result;
         },
@@ -1408,7 +1411,9 @@ export class ClientSession {
                 // 「默认 bash 覆盖」开关（terminalBash）关 → 原生 SDK bash（纯进程、不开终端）；
                 // 开 → 终端接管 bash（persist 决定一次性/持久，可静默自动转后台）。
                 customTools: [
-                    makeAdaptiveBashTool(makeKillableBashTool(effectiveCwd, this.bashKills), makeTerminalBashTool(terminals, {
+                    makeAdaptiveBashTool(
+                    // issue #91：bash 返回按客户端 UI 语言出中英（英文默认）。
+                    makeKillableBashTool(effectiveCwd, this.bashKills, () => this.getLang()), makeTerminalBashTool(terminals, {
                         cwd: effectiveCwd,
                         // 设置开 = 用终端；此分支里 persist 未显式给时默认一次性（false）。
                         defaultPersist: () => false,
@@ -2707,6 +2712,8 @@ export class ClientSession {
         cwd: () => this.cwd,
         getSession: () => this.session,
         newChat: () => this.newChat(),
+        // /new <prompt>: deliver the text as the new session's first prompt.
+        prompt: (text) => this.prompt(text),
         setModel: (id) => this.setModel(id),
         setCwd: (path) => this.setCwd(path),
         setThinking: (level) => this.setThinking(level),
@@ -3528,9 +3535,13 @@ export class ClientSession {
             });
         }
     }
+    /** 新建/切到一个空白对话。返回值 = 「当前活动对话就是一个可以接收首条的
+     *  空白新对话」——/new <prompt> 只在 true 时投递首条提示；false 表示没能进入
+     *  新对话（准入关闭 / 同项目对话数达上限 / runtime 创建失败），此时照发会把
+     *  首条提示投进用户原本正在用的那个对话里。 */
     async newChat() {
         if (this.quiesceBlocked())
-            return;
+            return false;
         // Reuse an already-open blank conversation instead of piling up new ones
         // on every click: if the active chat has no messages it IS the new chat
         // (focus already on it); otherwise switch to the first blank one (under
@@ -3548,7 +3559,7 @@ export class ClientSession {
         const active = this.conv;
         if (active && isBlank(active)) {
             this.flushSnapshot();
-            return;
+            return true;
         }
         for (const conv of this.convs.values()) {
             if (conv.id === this.activeId)
@@ -3556,7 +3567,7 @@ export class ClientSession {
             if (isBlank(conv)) {
                 await this.switchConversation(conv.id);
                 this.flushSnapshot();
-                return;
+                return true;
             }
         }
         // Cap is per project — conversations of other projects keep their own
@@ -3570,7 +3581,7 @@ export class ClientSession {
                 text: `当前项目运行的对话已达上限（${MAX_OPEN_CONVERSATIONS} 个），请先打开某个对话并离开（不继续对话）以移出列表`,
                 textEn: `This project already has the max open conversations (${MAX_OPEN_CONVERSATIONS}). Open one and leave it (without continuing) to remove it from the list.`,
             });
-            return;
+            return false;
         }
         // The outgoing conversation is left behind — apply the running-list
         // lifecycle. Removal is deferred until the new chat exists so the active
@@ -3579,6 +3590,7 @@ export class ClientSession {
         // Carry the model chosen in the active chat over to the new chat so it
         // doesn't silently revert to the ModelRuntime default model.
         const prevModel = this.conv.session.agent.state.model ?? null;
+        let ready = false;
         try {
             const conversationId = this.nextConversationId();
             const terminals = this.makeTerminalManager(conversationId, this.cwd);
@@ -3617,6 +3629,7 @@ export class ClientSession {
             void this.pushSlashCommands();
             // 新对话即当前打开 → 插件重拉（轨迹视图跟随）。
             this.notifyConversationChanged();
+            ready = true;
         }
         catch (err) {
             this.emit({
@@ -3627,6 +3640,7 @@ export class ClientSession {
             });
         }
         this.flushSnapshot();
+        return ready;
     }
     /**
      * The active conversation is being left (new_chat / switch_conversation /
@@ -5163,6 +5177,7 @@ export class AgentService {
             connectedClients: this.socketCount,
             activeConversations: this.activeConversations(),
             pendingMessages: this.pendingMessages(),
+            service: toServiceInfo(launchOrigin()),
         };
     }
     /** Get or create the session for a client, racing attach calls safely. */

package/dist/server/dsh/dsh-agent-service.js

@@ -38,6 +38,7 @@ import { TerminalManager, loadCommands, saveCommandsFile } from "../terminals.js
 import { saveUpload } from "../uploads.js";
 import { checkAll as checkAllUpdates, collectTargets } from "../update-check.js";
 import { previewKind } from "../text-sniff.js";
+import { launchOrigin, toServiceInfo } from "../launch-origin.js";
 import { DshRuntime, loadDeepSeekKey } from "./dsh-client.js";
 import { DshStreamAccumulator, assistantMessageEventToUiMessage, toolResultEventToUiMessage, userMessageEventToUiMessage, } from "./dsh-serialize.js";
 import { firstUserText, findSessionFilesForCwd, readSessionLog, replayEventsToMessages } from "./dsh-sessions.js";
@@ -1137,13 +1138,15 @@ export class DshClientSession {
         }
         this.emit({ type: "conversations", conversations: list, activeId: this.activeId });
     }
+    /** 语义同 pi 引擎的 newChat：true = 当前活动对话是可接收首条的空白新对话
+     *  （/new <prompt> 靠它决定要不要把首条提示发出去）。 */
     async newChat() {
         if (this.quiesceBlocked())
-            return;
+            return false;
         const active = this.conv;
         if (active.messages.length === 0 && active.terminals.list().length === 0) {
             this.flushSnapshot();
-            return;
+            return true;
         }
         for (const conv of this.convs.values()) {
             if (conv.id === this.activeId)
@@ -1151,7 +1154,7 @@ export class DshClientSession {
             if (conv.messages.length === 0) {
                 this.switchConversation(conv.id);
                 this.flushSnapshot();
-                return;
+                return true;
             }
         }
         const openInProject = [...this.convs.values()].filter((c) => c.cwd === this.cwd).length;
@@ -1162,7 +1165,7 @@ export class DshClientSession {
                 text: `当前项目运行的对话已达上限（${MAX_OPEN_CONVERSATIONS} 个）`,
                 textEn: `This project already has the max open conversations (${MAX_OPEN_CONVERSATIONS}).`,
             });
-            return;
+            return false;
         }
         // 旧对话保留（listed 生命周期简化：不主动移除）。
         const prevModel = this.model;
@@ -1174,6 +1177,7 @@ export class DshClientSession {
         this.emitGoalStatus();
         this.pushTerminals();
         this.flushSnapshot();
+        return true;
     }
     async switchConversation(id) {
         if (!this.convs.has(id) || id === this.activeId)
@@ -2854,9 +2858,14 @@ export class DshClientSession {
     /** 拦截执行斜杠命令；返回 true 表示已处理（不发给模型）。 */
     async execSlash(name, args) {
         switch (name) {
-            case "new":
-                await this.newChat();
+            case "new": {
+                const first = args.trim();
+                // /new <prompt>：与 pi 引擎一致（共用 NATIVE_COMMANDS 的提示词），
+                // 仅当真的落在空白新对话上才投递首条提示，否则会把提示误发进当前对话。
+                if ((await this.newChat()) && first)
+                    await this.prompt(first);
                 return true;
+            }
             case "model": {
                 if (!args.trim()) {
                     this.emit({
@@ -3421,6 +3430,7 @@ export class DshAgentService {
             connectedClients: this.socketCount,
             activeConversations: this.activeConversations(),
             pendingMessages: this.pendingMessages(),
+            service: toServiceInfo(launchOrigin()),
         };
     }
     async attach(clientId, send) {

package/dist/server/index.js

@@ -37,6 +37,7 @@ import { scheduleUploadCleanup } from "./uploads.js";
 import { ensureWindowsBash, windowsBashDir } from "./ensure-bash.js";
 import { listThemes, resolveThemeFile } from "./themes.js";
 import { isManaged, managedRefusal } from "./managed.js";
+import { launchOrigin, toServiceInfo } from "./launch-origin.js";
 import { parseTabs, tabsRefusal } from "./tabs.js";
 import { installPack, isKnownPack, listPacks, loadServerStrings, readPackFile, removePack, unloadServerStrings, } from "./locales.js";
 import { PluginManager, resolvePluginClientFile, } from "./plugins.js";
@@ -194,6 +195,13 @@ if (AUTH_TOKEN) {
 const ENGINE = process.env.PI_WEB_ENGINE === "dsh" ? "dsh" : "pi";
 /** PI_WEB_MANAGED=1: this instance is updated by whoever deploys it. */
 const MANAGED = isManaged();
+/** Who started this process: a platform service manager (launchd / systemd /
+ *  Windows watchdog — i.e. `pi-web-ui server start|install`) or nothing
+ *  (foreground / dev / Docker). Decides whether the UPDATE panel offers
+ *  "restart service" and what quitting means (see scheduleQuit). */
+const ORIGIN = launchOrigin();
+/** 下发给浏览器的服务信息（null = 没有 supervisor）。 */
+const SERVICE_INFO = toServiceInfo(ORIGIN);
 /** PI_WEB_TABS: the tabs this instance offers. null = all of them, as before. */
 const TABS = parseTabs();
 app.get("/api/health", (_req, res) => {
@@ -665,8 +673,12 @@ service.onClientCwdChanged = (cwd) => pluginMgr.notifyCwd(cwd);
 function scheduleQuit() {
     const isLaunchd = process.platform === "darwin" && process.ppid === 1;
     const isSystemd = process.platform === "linux" && !!process.env.INVOCATION_ID;
+    // Windows `server install` runs the server under the powershell watchdog
+    // launcher (`while ($true) { node …; Start-Sleep 10 }`) — exiting brings it
+    // back within ~10s, same contract as launchd/systemd (see launch-origin.ts).
+    const isWinWatchdog = ORIGIN.supervisor === "windows-watchdog";
     const inDocker = existsSync("/.dockerenv");
-    if (isLaunchd || isSystemd || inDocker) {
+    if (isLaunchd || isSystemd || isWinWatchdog || inDocker) {
         setTimeout(() => {
             console.log("pi-web-ui:quit — shutting down (supervisor will restart)…");
             if (isSystemd)
@@ -922,6 +934,30 @@ wss.on("connection", (ws) => {
             case "check_updates_all":
                 void cs.checkUpdatesAll(msg.force === true);
                 break;
+            case "restart_service": {
+                // Same effect as `pi-web-ui server restart`: this process exits and its
+                // supervisor brings it back (launchd/systemd immediately, the Windows
+                // watchdog within ~10s). Refused without a supervisor — exiting there
+                // would just stop the server the user is looking at.
+                if (!ORIGIN.supervisor) {
+                    send({
+                        type: "notice",
+                        level: "error",
+                        text: "当前实例不是由 pi-web-ui 服务启动的（前台运行），无法自动重启；请在终端里重启，或先用 pi-web-ui server install 安装服务。",
+                        textEn: "This instance runs in the foreground, not as a pi-web-ui service — nothing would bring it back. Restart it in its terminal, or install the service with `pi-web-ui server install`.",
+                    });
+                    break;
+                }
+                send({
+                    type: "notice",
+                    level: "info",
+                    text: "正在重启服务…页面会在服务恢复后自动重连。",
+                    textEn: "Restarting the service… this page reconnects once it is back.",
+                });
+                // Let the notice (and this socket's backlog) flush before we go down.
+                setTimeout(() => void scheduleQuit(), 400);
+                break;
+            }
             case "dialog_response":
                 cs.resolveDialog(msg.id, msg.value);
                 break;
@@ -1153,6 +1189,7 @@ wss.on("connection", (ws) => {
                     appVersion: appVersion(),
                     managed: MANAGED,
                     tabs: TABS ? [...TABS] : undefined,
+                    service: SERVICE_INFO ?? undefined,
                 });
                 // Plugin catalog: re-scan + activate new dirs on every attach so
                 // freshly dropped plugins show up without a server restart.

package/dist/server/launch-origin.js

@@ -0,0 +1,148 @@
+/**
+ * launch-origin — 这个进程是被谁启动的？
+ *
+ * 界面里有一处需要知道答案：更新面板的「重启服务」按钮。它只有在**退出后会被
+ * 自动拉起**的实例上才有意义（`pi-web-ui server start` 起的是这种），前台
+ * `pi-web-ui` / `npm run dev` 起的实例点它 = 把服务关掉不回来了。
+ *
+ * 判定的是「有没有 supervisor 会在本进程退出后把它拉起来」，一共三种：
+ *  - **launchd**（macOS，`server install` 写的 plist）——launchd 给每个 job 设
+ *    `XPC_SERVICE_NAME`，据此认出我们生成的 label（com.xingshuyin.pi-web-ui /
+ *    com.<name>.server）；
+ *  - **systemd**（Linux，`Restart=always`）——systemd 给每个 unit 设
+ *    `INVOCATION_ID`；unit 名从 /proc/self/cgroup 里取（`…/pi-web-ui.service`）；
+ *  - **windows-watchdog**（Windows，`server install` 写的 ps1：
+ *    `while ($true) { node …; Start-Sleep 10 }`）——没有环境变量可依，靠 PID
+ *    文件反查：ps1 把自己的 PID 写进 `%APPDATA%\pi-web-ui\<name>.pid`，而 node
+ *    是它的直接子进程，所以 `process.ppid` 等于文件里那个 PID。同名 ps1 里必须
+ *    真的有 watchdog 循环 —— 桌面快捷方式的 ps1 也写同一个 PID 文件，但它
+ *    （未安装服务时）是前台跑，退出不会回来。
+ *
+ * 新版 `server install` 另外烘焙 `PI_WEB_LAUNCHED_BY=service` +
+ * `PI_WEB_SERVICE_NAME=<name>`（最高优先级、最明确的一路）；已装好的老服务没有
+ * 这两个变量，所以上面的运行时判据必须保留。
+ *
+ * Docker **刻意不算**：容器由编排/`restart:` 策略管，重启容器不是这个按钮该干的事。
+ *
+ * 纯函数（env / ppid / fs 读取全部可注入）便于单测；`launchOrigin()` 是进程级
+ * 缓存的一次性探测，服务端多处共用同一份结论。
+ */
+import { readdirSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** 默认服务名（`server install` 没传 --name 时）。 */
+export const DEFAULT_SERVICE_NAME = "pi-web-ui";
+/** 默认 launchd label —— 与 bin/pi-web-ui.mjs 的 serviceLabel() 保持一致。 */
+const LAUNCHD_LABEL_DEFAULT = "com.xingshuyin.pi-web-ui";
+/** Windows 启动器目录（CLI 的 winServiceDir 同源）。 */
+const WIN_SERVICE_DIR_NAME = "pi-web-ui";
+function defaultListDir(dir) {
+    try {
+        return readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+}
+function defaultReadFile(path) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+/** Windows 启动器目录：`%APPDATA%\pi-web-ui`（CLI 的 winServiceDir）。 */
+export function winServiceDir(env = process.env) {
+    const appData = env.APPDATA?.trim() || join(homedir(), "AppData", "Roaming");
+    return join(appData, WIN_SERVICE_DIR_NAME);
+}
+/** launchd label → 服务名；不是我们生成的 label 返回 null。 */
+function nameFromLaunchdLabel(label) {
+    if (label === LAUNCHD_LABEL_DEFAULT)
+        return DEFAULT_SERVICE_NAME;
+    // serviceLabel(`--name foo`) = com.foo.server
+    const m = /^com\.(.+)\.server$/.exec(label);
+    return m?.[1] ?? null;
+}
+/** systemd cgroup 内容 → unit 名（`0::/system.slice/pi-web-ui.service`）。 */
+function nameFromCgroup(content) {
+    const m = /([A-Za-z0-9_.@-]+)\.service/.exec(content ?? "");
+    return m?.[1];
+}
+/** `PI_WEB_LAUNCHED_BY=service` 时的 supervisor（按平台推导）。 */
+function supervisorForPlatform(platform) {
+    if (platform === "win32")
+        return "windows-watchdog";
+    if (platform === "darwin")
+        return "launchd";
+    return "systemd";
+}
+/** Windows：PID 文件里的 PID === 本进程的 ppid，且同名 ps1 里确实有 watchdog 循环。 */
+function detectWindows(input, env) {
+    const dir = input.winServiceDir ?? winServiceDir(env);
+    const listDir = input.listDir ?? defaultListDir;
+    const readFile = input.readFile ?? defaultReadFile;
+    const ppid = input.ppid ?? process.ppid;
+    for (const file of listDir(dir)) {
+        if (!file.endsWith(".pid"))
+            continue;
+        const raw = readFile(join(dir, file));
+        if (raw === null)
+            continue;
+        if (Number(raw.trim()) !== ppid)
+            continue;
+        const name = file.slice(0, -".pid".length);
+        const ps1 = readFile(join(dir, `${name}.ps1`));
+        if (ps1 && ps1.includes("while ($true)"))
+            return { supervisor: "windows-watchdog", name };
+    }
+    return { supervisor: null };
+}
+/**
+ * 探测启动来源。`PI_WEB_LAUNCHED_BY=service` 优先（新版 install 烘焙的），
+ * 否则按平台识别 supervisor 自己的运行时痕迹。
+ */
+export function detectLaunchOrigin(input = {}) {
+    const env = input.env ?? process.env;
+    const platform = input.platform ?? process.platform;
+    const serviceName = env.PI_WEB_SERVICE_NAME?.trim() || undefined;
+    if ((env.PI_WEB_LAUNCHED_BY ?? "").trim().toLowerCase() === "service") {
+        return { supervisor: supervisorForPlatform(platform), name: serviceName ?? DEFAULT_SERVICE_NAME };
+    }
+    if (platform === "darwin") {
+        const label = env.XPC_SERVICE_NAME?.trim();
+        if (!label)
+            return { supervisor: null };
+        const name = nameFromLaunchdLabel(label);
+        return name ? { supervisor: "launchd", name } : { supervisor: null };
+    }
+    if (platform === "linux") {
+        if (!env.INVOCATION_ID)
+            return { supervisor: null };
+        const readCgroup = input.readCgroup ?? defaultReadCgroup;
+        return { supervisor: "systemd", name: serviceName ?? nameFromCgroup(readCgroup()) ?? DEFAULT_SERVICE_NAME };
+    }
+    if (platform === "win32")
+        return detectWindows(input, env);
+    return { supervisor: null };
+}
+function defaultReadCgroup() {
+    return defaultReadFile("/proc/self/cgroup");
+}
+let cached = null;
+/** 进程级缓存的一次性探测（服务端多处共用：ready 消息 / quit 语义 / 控制 socket）。 */
+export function launchOrigin() {
+    cached ??= detectLaunchOrigin();
+    return cached;
+}
+/** 仅测试用：清掉缓存。 */
+export function resetLaunchOriginCache() {
+    cached = null;
+}
+/** 下发给浏览器的服务信息（null = 没有 supervisor，界面不提供「重启服务」）。 */
+export function toServiceInfo(origin) {
+    if (!origin.supervisor)
+        return null;
+    return { name: origin.name ?? DEFAULT_SERVICE_NAME, supervisor: origin.supervisor };
+}

package/dist/server/slash-commands.js

@@ -3,7 +3,13 @@
  * prompt() — without this they'd be sent to the model as plain text). Keep in
  * sync with exec(). */
 export const NATIVE_COMMANDS = [
-    { name: "new", description: "新建对话", descriptionEn: "New chat" },
+    {
+        name: "new",
+        description: "新建对话（可带首条提示：/new <提示>）",
+        descriptionEn: "New chat (optional first prompt: /new <prompt>)",
+        argumentHint: "[提示]",
+        argumentHintEn: "[prompt]",
+    },
     {
         name: "name",
         description: "重命名当前会话",
@@ -135,9 +141,19 @@ export class SlashCommandsService {
      *  name is not a native command (the prompt falls through to the SDK). */
     async exec(name, args) {
         switch (name) {
-            case "new":
-                await this.host.newChat();
+            case "new": {
+                const first = args.trim();
+                const ready = await this.host.newChat();
+                // /new <prompt>: deliver the text as the new session's first
+                // prompt, exactly as if typed after the switch. Empty = old
+                // behavior (blank chat, no send). Only when the switch actually
+                // landed on a blank chat — newChat() reports false when it bailed
+                // (cap reached / runtime creation failed) and sending anyway would
+                // drop the text into the conversation the user was already in.
+                if (ready !== false && first && this.host.prompt)
+                    await this.host.prompt(first);
                 return true;
+            }
             case "name": {
                 const trimmed = args.trim();
                 if (!trimmed) {

package/dist/server/terminals.js

@@ -1366,18 +1366,24 @@ let oneShotBashSeq = 0;
 /** 应用 head / tail 参数到输出顶层行（替代 `| head` / `| tail` 管道——管道会
  *  缓冲输出、让可见终端全程哑火，还容易白白触发静默解阻）。两者同时给时先
  *  截头再截尾。 */
-export function applyHeadTail(text, head, tail) {
+export function applyHeadTail(text, head, tail, lang = "en") {
     // 只对真实数据行切片；省略提示行单独存，最后再包回输出，避免提示行在
     // head+tail 组合时被当成数据行参与第二次截取（导致尾部少截一行）。
     let data = text.split("\n");
     let headNote = null;
     let tailNote = null;
     if (head && head > 0 && data.length > head) {
-        headNote = `…（后 ${data.length - head} 行已省略）`;
+        const n = data.length - head;
+        headNote = pick(lang, `…（后 ${n} 行已省略）`, `…[${n} lines omitted below]…`, "terminals.headtail.omitted.below", {
+            n,
+        });
         data = data.slice(0, head);
     }
     if (tail && tail > 0 && data.length > tail) {
-        tailNote = `…（前 ${data.length - tail} 行已省略）`;
+        const n = data.length - tail;
+        tailNote = pick(lang, `…（前 ${n} 行已省略）`, `…[${n} lines omitted above]…`, "terminals.headtail.omitted.above", {
+            n,
+        });
         data = data.slice(-tail);
     }
     const parts = [];
@@ -1460,10 +1466,12 @@ export function makeTerminalBashTool(terminals, opts) {
             const redirect = stripped && limiter.kind === "tail" ? detectStdoutRedirect(runCommand) : null;
             const tailFile = redirect ? { file: redirect.file, lines: limiter.lines ?? 10 } : undefined;
             // 复杂子表达式先 hoist 成干净 const（issue #91 v2：vars key 不写复杂表达式）。
-            const limiterSegment = limiter.segment;
-            const limiterTailLines = limiter.lines ?? 10;
-            const limiterTailZh = limiter.kind === "tail" ? `本次返回末尾 ${limiterTailLines} 行。` : "本次返回全部输出。";
-            const limiterTailEn = limiter.kind === "tail"
+            // 注意：limiter 对「没有尾部限输出管道」的命令是 null（issue #121）——
+            // 这些 const 一律走可选链，只在 stripped=true（limiterNote 才被取用）时才有意义。
+            const limiterSegment = limiter?.segment ?? "";
+            const limiterTailLines = limiter?.lines ?? 10;
+            const limiterTailZh = limiter?.kind === "tail" ? `本次返回末尾 ${limiterTailLines} 行。` : "本次返回全部输出。";
+            const limiterTailEn = limiter?.kind === "tail"
                 ? `Returning the last ${limiterTailLines} lines this time.`
                 : "Returning the full output this time.";
             const limiterNote = stripped
@@ -1497,7 +1505,7 @@ export function makeTerminalBashTool(terminals, opts) {
                     if (m) {
                         terminals.setSentinelPending(termId, false);
                         closeOneShot();
-                        const text = applyHeadTail(cleanBashOutput(collected), p.head, effectiveTail);
+                        const text = applyHeadTail(cleanBashOutput(collected), p.head, effectiveTail, lang);
                         return {
                             content: [
                                 {
@@ -1517,7 +1525,7 @@ export function makeTerminalBashTool(terminals, opts) {
                     }
                     // 静默解阻（仅持久终端）：转后台 + 注册完成观察器，立即把控制权还给模型。
                     if (persist && idleMs > 0 && Date.now() - lastDataAt >= idleMs) {
-                        return backgroundResult(terminals, opts, runCommand, applyHeadTail(cleanBashOutput(collected), p.head, effectiveTail), Math.round((Date.now() - lastDataAt) / 1000), lang);
+                        return backgroundResult(terminals, opts, runCommand, applyHeadTail(cleanBashOutput(collected), p.head, effectiveTail, lang), Math.round((Date.now() - lastDataAt) / 1000), lang);
                     }
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-web-ui",
-	"version": "0.80.0",
+	"version": "0.80.2",
 	"description": "Web chat interface for the pi coding agent, powered by the pi SDK (@earendil-works/pi-coding-agent) — one-command run, Docker/systemd/launchd deployable",
 	"license": "MIT",
 	"author": {
@@ -81,7 +81,7 @@
 	"dependencies": {
 		"@deepseek-ai/dsh-sdk-jsonrpc-server": "^0.1.1-rc.2",
 		"@deepseek-ai/dsh-sdk-protocol": "^0.1.1-rc.2",
-		"@earendil-works/pi-coding-agent": "^0.84.4",
+		"@earendil-works/pi-coding-agent": "^0.85.1",
 		"@xterm/addon-fit": "^0.11.0",
 		"@xterm/xterm": "^6.0.0",
 		"compression": "^1.8.1",

package/plugins/catalog.json

@@ -43,5 +43,14 @@
 		"descriptionEn": "Run trajectory: task → thinking → tools → file changes → result timeline with replay and node details.",
 		"source": "xing-shuyin/pi-web-ui/plugins/run-trace",
 		"homepage": "https://github.com/xing-shuyin/pi-web-ui/tree/main/plugins/run-trace"
+	},
+	{
+		"id": "legado-web",
+		"name": "legado-web",
+		"icon": "📖",
+		"description": "Legado 阅读（文本源）：搜索 / 发现 / 详情 / 目录 / 正文，书源 JSON 与安卓版兼容，可导入、检测、删废源；内置跨域+GBK 代理与本地存储，并给 AI 配了修源接口（读规则、读书源文件、逐步诊断链路、试规则验证）。",
+		"descriptionEn": "Legado reader (text book sources): search / explore / info / TOC / content with Android-compatible book source JSON, plus source import and health checking. Ships its own CORS+GBK proxy, local store, and AI tools to diagnose and repair book sources.",
+		"source": "xing-shuyin/pi-web-ui/plugins/legado-web",
+		"homepage": "https://github.com/xing-shuyin/pi-web-ui/tree/main/plugins/legado-web"
 	}
 ]

package/web/dist/assets/{TerminalPanel-BYigWYyx.js → TerminalPanel-CeruoZjh.js}

@@ -1,4 +1,4 @@
-import{a as l,j as n}from"./markdown-D3PKeHAZ.js";import{u as P,b as O,T as M,a as p,c as W,F as Y,d as z,e as Z,f as H,g as ee,h as ne,i as te,j as se,r as ae}from"./index-D7BpHJ59.js";import{D as re,o as ie}from"./xterm-B96xOxS9.js";import"./react-w24rH0km.js";function le(t){let c=null;return{clean:t.replace(/\r?\n?\[pi-term-exit:(-?\d+)\]\r?\n?/g,(h,u)=>(c=Number(u),`\r
+import{a as l,j as n}from"./markdown-D3PKeHAZ.js";import{u as P,b as O,T as M,a as p,c as W,F as Y,d as z,e as Z,f as H,g as ee,h as ne,i as te,j as se,r as ae}from"./index-DtBJSe33.js";import{D as re,o as ie}from"./xterm-B96xOxS9.js";import"./react-w24rH0km.js";function le(t){let c=null;return{clean:t.replace(/\r?\n?\[pi-term-exit:(-?\d+)\]\r?\n?/g,(h,u)=>(c=Number(u),`\r
 `)).replace(/\r?\n?\x1b\[90m\[(?:进程已退出，退出码 |Process exited with code )-?\d+\]\x1b\[0m\r?\n?/g,`\r
 `),exitCode:c}}function ce({conversationId:t,terminalId:c,command:s,cwd:h,title:u,active:w,running:f,exitCode:k,register:g}){const C=l.useRef(null),j=l.useRef(null),{locale:o}=P(),y=l.useRef(o);y.current=o;const E=s?JSON.stringify(s):"";l.useEffect(()=>{const m=C.current;if(!m)return;const r=new re({theme:O(),fontFamily:'"SF Mono", "JetBrains Mono", ui-monospace, Menlo, Consolas, monospace',fontSize:13,cursorBlink:!0,scrollback:8e3}),v=new ie;r.loadAddon(v),r.open(m),j.current={term:r,fit:v},w&&r.focus();const b=()=>{r.options.theme=O()};window.addEventListener(M,b),r.attachCustomKeyEventHandler(d=>{if(d.type!=="keydown")return!0;const S=d.key?.toLowerCase();if((d.ctrlKey||d.metaKey)&&S==="v")return!1;if(d.ctrlKey&&!d.shiftKey&&!d.altKey&&S==="c"&&r.hasSelection()){const D=r.textarea;return D&&(D.value=r.getSelection(),D.select()),!1}return!0});const _=g(t,c,{write:d=>r.write(le(d).clean),dispose:()=>r.dispose()}),$=()=>{try{v.fit(),p({type:"terminal_resize",terminalId:c,conversationId:t,cols:r.cols,rows:r.rows})}catch{}},B=requestAnimationFrame(()=>{try{v.fit()}catch{}s?p({type:"run_command",terminalId:c,conversationId:t,command:s,cols:r.cols,rows:r.rows}):p({type:"terminal_create",terminalId:c,title:u,locale:y.current,conversationId:t,cwd:h,cols:r.cols,rows:r.rows})}),R=r.onData(d=>{p({type:"terminal_input",terminalId:c,conversationId:t,data:d})});let T=null;return typeof ResizeObserver<"u"&&(T=new ResizeObserver(()=>{m.offsetWidth>0&&m.offsetHeight>0&&$()}),T.observe(m)),()=>{cancelAnimationFrame(B),R.dispose(),window.removeEventListener(M,b),T?.disconnect(),_(),r.dispose(),j.current=null}},[t,c,E,g]),l.useEffect(()=>{if(!w)return;const m=requestAnimationFrame(()=>{const r=j.current;if(r){try{r.fit.fit(),p({type:"terminal_resize",terminalId:c,conversationId:t,cols:r.term.cols,rows:r.term.rows})}catch{}r.term.focus()}});return()=>cancelAnimationFrame(m)},[w]);const{t:F}=P(),x=l.useRef(void 0);return l.useEffect(()=>{if(f===x.current||(x.current=f,f!==!1))return;const m=j.current;m&&m.term.write(`\r
 \x1B[90m${F("exitBanner",{code:k??""})}\x1B[0m\r