pi-web-ui 0.83.0 → 0.85.0

package/CHANGELOG.md

@@ -8,9 +8,57 @@
 每个版本的内容按"实际合入该版本发布的提交"归档（以 `package.json` 的 version 变更提交为准），
 而不是按提交日期聚类——连续快速发布的 patch 版本以此为准最准确。
 
-## [Unreleased]
+## [0.85.0] — 2026-09-14
 
-暂无其他未发布内容。
+### Added
+
+- **微信里也能指挥 agent 了**：新插件 `wechat-ilink`（💬 微信通道）——微信扫码登录，直连微信 ilink 后端（与腾讯官方 `openclaw-weixin` 同源协议），出站长轮询收消息，家里内网、公司内网都能跑，不用开端口、不用公网 IP。白名单用户（或填 `*` 全放行）的消息自动投给 agent，跑完回结果；陌生人先挂「待配对」，在视图里点允许/拒绝。附带 `wechat_send` 工具，agent 可主动发微信消息。
+  - 通道能力由宿主新扩展点 `host.chat` 承载（`server/plugins.ts` + `AgentService.chatFromPlugin`）：无头调用、无浏览器也能跑，每个（插件，账号）独立伪客户端，fire-and-forget 投递、运行结果经 `onRunEvent(run_end)` 按 conversationId 关联回包；需要 manifest `chat` 能力声明，文本 8000 字封顶。
+  - v1 诚实范围：单账号、文本全双工，图片/语音/文件只转写占位；默认只回私聊；与该服务 cwd 下最近会话共享（peer 名拼进前缀，per-peer 独立会话以后再加）。`bot_token` 存宿主加密机密。
+- **「浏览器操作」面板有了扩展安装引导** —— 扩展不在 Chrome 应用商店，以前用户卡在第一步。现在面板里直接给下载按钮（`page-picker-extension.zip`，永远最新版，走 GitHub Release latest 别名）+ 四步图文（解压 → 开发者模式 → 加载已解压 → 点图标设为服务地址，地址端口不用手填）。
+- **image-toolkit 的配置搬进插件自己家里了** —— 以前 7 项设置走 ⚙ 面板 → 界面插件的声明式 `settings`（manifest 已删）；现在存在插件自己的 storage（`config` 键），在 🖼 视图右上角 ⚙ 里改，并新增内部配置存取路由（视图 ↔ 服务端经 `settings` 广播同步，改完即时生效，按需上/下架 AI 工具）。老版本声明式设置一次性自动迁移（读不到就全默认，坏值归一化回默认值，绝不带崩工具/视图）。
+- **`legado_book_sources` 多了 `unmark`** —— AI 修完源、验证通过后调它摘掉废源/可疑标记，否则页面默认隐藏废源、用户会以为源丢了（`rules.md` 修源流程已同步到 6 步：先 `probe` 验证、再 `unmark`、最后提醒刷新）。
+- **Legado 阅读页不再拿旧规则误判废源** —— AI 刚修完规则时，页面内存里还是旧的，之前失败一次就记废源。现在失败前先比对磁盘新规则的「可读性指纹」（搜索/发现/头/四条解析规则变了才算新），命中则按新规则重读并提示重试，这次失败不记废源。另：发现页书源下拉的筛选词重渲染不再丢失。
+
+### Changed
+
+- **`browser_page` 工具默认关了**（原来默认开）—— AI 动用户浏览器，应该是 opt-in 才开；关掉后顶栏「浏览器操作」入口整个隐藏（面板里的例子与「引用到对话」都是教模型用 `browser_page` 的，工具不在留着只会给出做不到的承诺）。扩展侧总开关关了则保留面板，好把人送去开开关。
+
+### Fixed
+
+- **机密存储重启后全炸的 bug 修了** —— `secrets.key` 的读法把文件缓冲直接 `.toString("hex")`（hex 文本又做了一次 hex 编码），重启后 key 变成 65 字节，AES-256-GCM 全线报 "Invalid key length"。现在按 UTF-8 读 hex 文本再解码，并校验 32 字节：长度不对视为损坏、重新生成（旧机密按 fail closed 丢弃，总比所有机密操作全炸好；单测 `plugin-facilities.test.ts` 回归）。
+- **Windows 上新终端偶发吃掉首字节** —— 刚 spawn 的 PTY 在 shell 还没开始读时就写入，ConPTY 会丢最前面的字节，经典症状是 `pi-web-ui` 到达时变成 `i-web-ui`。现在复用输出就绪信号（首包输出即 shell 可读，1.5s 超时兜底；重启/kill 掉的过期条目跳过），命令只在就绪后写入。
+- **目标（goal）展开时内容不再被挤扁**（issue #141）—— `.goalbar` 纵向容器原来是 `align-items: center`，展开态的两行被压成内容宽度，输入框缩成一小截。现在容器改 `align-items: stretch` 让展开的行铺满整列，只有折叠态（小药丸）保留居中。
+
+<!-- auto-i18n:start -->
+### i18n
+
+- 前端新增 key（7）：`browserControlInstall`、`browserControlInstallLead`、`browserControlInstallDownload`、`browserControlInstallStep1`、`browserControlInstallStep2`、`browserControlInstallStep3`、`browserControlInstallStep4`
+<!-- auto-i18n:end -->
+
+## [0.84.0] — 2026-09-13
+
+### Added
+
+- **Git 视图的左栏可以拖宽了**（issue #139）—— 改动文件 / 提交历史那一栏原来固定 300px，路径或分支名一长就被截断且无处可展。现在拖它右边的分隔条即可调宽（**双击复位**），宽度**跨会话记住**（`localStorage`）；拖动时按容器宽度收敛，保证 diff 区不会被挤没（额外还有一条 `max-width` 兜底）。
+  - 与左右主面板同一套手感（拖动分隔条、双击复位、松开才写存档）；纯函数 `web/src/scm-sidebar.ts` + 单测 `tests/unit/scm-sidebar.test.ts`，真浏览器回归 `tests/scm-test.mjs`（拖 +120px → 刷新后保持 → 双击回 300px）。
+
+### Fixed
+
+- **正在聊的那条对话不再从左栏「运行的对话」里消失**（issue #140）—— 原来新对话只有「被换到后台且仍在流式输出」时才入列，于是你在当前对话里发消息时，左栏里根本没有它；只开一条对话时连「运行的对话」这个标题都不渲染，观感像是对话丢了。现在**当前对话一旦有内容**（有消息、或已被首条提示词命名）就立刻出现在列表里（还在流式输出时也会亮起绿点），行上标「当前」、点击是安全的空动作。
+  - **空白新对话仍然不入列**（连点「新建对话」不会堆出一排空条目），历史对话列表也不受影响。
+  - 这是**纯展示口径**：`listed` 的语义，以及「被挤出后台时是保留还是释放 runtime」「每项目 8 个上限」这些规则完全没变（换走时该释放的仍然释放）；列表里当前对话那一行的 ✕ 按同一口径判定，真能移出（不再静默无反应）。
+  - 回归：`tests/unit/…` 无（口径在服务端），零 token 协议测试 `tests/running-list-test.mjs`（空白不入列 / 流式中入列 / 跑完留住 / 当前行 ✕ 可移出 / 后台运行语义不变），真浏览器 `tests/panel-layout-test.mjs`（区标题、「当前」副标签、流式绿点、只有一行）。DSH 引擎同口径一并改了（共用同一套左栏与 wire 协议）。
+
+- **切项目时左栏不再闪一下项目名**（#140 那个改动的回归）—— 切项目会自动切到该项目的对话；如果切过去时那个项目只有一条对话（就是这条当前对话），列表里只有一组，它顶上原来会闪出一行项目名再消失（实测约 8ms 一帧）。原因是两个信号不同时到达：`conversations` 推送先到（activeId 已是新项目的对话），带新 `cwd` 的快照后到，只按 `cwd` 分组的那一帧就把当前项目当成了「别的项目」。
+  - 现在**只要当前对话在列表里，就认它所在的分组为当前项目**（`currentCwd` 只在它不在列表里时——空白新对话——作为回落），并直接置顶，顺带免掉随后的位置跳动；其他项目的后台运行照旧显示项目名。
+  - 分组逻辑抽成纯函数 `web/src/conv-groups.ts` + 单测 `tests/unit/conv-groups.test.ts`，另有真浏览器逐帧回归 `tests/conv-group-flash-test.mjs`（MutationObserver 记录每一帧 DOM，两个方向都断言不再渲染项目名；改回只看 `cwd` 即变红）。
+
+<!-- auto-i18n:start -->
+### i18n
+
+- 服务端新增 key（1）：`terminals.cwd.outside.workspace`
+<!-- auto-i18n:end -->
 
 ## [0.83.0] — 2026-09-13
 
@@ -686,7 +734,8 @@
 - 0.35.1（2026-08-27）：编辑重问保留附件（#18）+ 全窗口拖放（#19）。
 - 0.29.0（2026-08-23）：全局搜索弹窗（Ctrl+K）+ 消息列表惰性窗口化。
 
-[Unreleased]: https://github.com/xing-shuyin/pi-web-ui/compare/v0.83.0...main
+[Unreleased]: https://github.com/xing-shuyin/pi-web-ui/compare/v0.84.0...main
+[0.84.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.84.0
 [0.83.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.83.0
 [0.80.1]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.80.1
 [0.80.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.80.0

package/dist/server/agent-service.js

@@ -20,7 +20,7 @@ import { createRequire } from "node:module";
 import { existsSync, readFileSync, rmSync, statSync, mkdirSync, watch } from "node:fs";
 import { basename, delimiter, dirname, join, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
-import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, createBashTool, createLocalBashOperations, getAgentDir, SessionManager, VERSION, } from "@earendil-works/pi-coding-agent";
+import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, createBashToolDefinition, createLocalBashOperations, getAgentDir, SessionManager, VERSION, } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
 import { BgServerTracker } from "./bg-servers.js";
 import { checkAll as checkAllUpdates, collectTargets, compareVersions as compareSemver, } from "./update-check.js";
@@ -133,7 +133,7 @@ export function makeKillableBashTool(cwd, kills,
 /** per-call 返回文本的服务端语言（默认英文）；工具 definition 走 bilingual 内联双语。 */
 lang = () => "en") {
     const base = createLocalBashOperations();
-    const tool = createBashTool(cwd, {
+    const tool = createBashToolDefinition(cwd, {
         operations: {
             exec: async (command, c, opts) => {
                 const ac = new AbortController();
@@ -151,7 +151,7 @@ lang = () => "en") {
             },
         },
     });
-    // AgentTool → ToolDefinition (same fields; customTools expects definitions).
+    // Keep the SDK definition so execute receives the current session context.
     return {
         name: tool.name,
         label: tool.label,
@@ -175,8 +175,8 @@ lang = () => "en") {
         }),
         prepareArguments: tool.prepareArguments,
         executionMode: tool.executionMode,
-        execute: async (toolCallId, params, signal, onUpdate) => {
-            const result = (await tool.execute(toolCallId, params, signal, onUpdate));
+        execute: async (toolCallId, params, signal, onUpdate, ctx) => {
+            const result = (await tool.execute(toolCallId, params, signal, onUpdate, ctx));
             // head/tail 后处理（native 无终端，直接截返回行即可）。
             const p = params;
             if ((p?.head || p?.tail) && result?.content?.[0]?.text != null) {
@@ -1740,8 +1740,12 @@ export class ClientSession {
             session: runtime.session,
             cwd: runtime.cwd,
             createdAt: Date.now(),
-            // A brand-new conversation is not yet in the running list — it enters
-            // only when it is displaced to the background while still streaming.
+            // A brand-new conversation is not yet LISTED — it enters the running
+            // list only when it is displaced to the background while still
+            // streaming (its runtime is what `listed` protects). A blank chat is
+            // also kept out of the left panel's running list; it shows up there as
+            // soon as it has content while it is the active chat — see
+            // shownInRunningList (#140).
             listed: false,
             promptedSinceActive: false,
             lastActiveAt: Date.now(),
@@ -2327,6 +2331,10 @@ export class ClientSession {
                 const task = conv.pendingTask;
                 conv.pendingTask = undefined;
                 this.emitRun(conv, task ? { type: "run_start", task } : { type: "run_start" });
+                // #140：本轮真的开跑了（session.isStreaming 此刻已为 true）—— 左栏
+                // 那行的「流式中」标识要立刻亮起来：首条提示词的入列 emit 早于本轮
+                // 启动，那时它还是 false；后台对话被唤醒重跑也靠这里刷新。
+                this.emitConversations();
                 break;
             }
             case "turn_start": {
@@ -3523,6 +3531,8 @@ export class ClientSession {
             if (conv.title === DEFAULT_CONV_TITLE && text.trim() && !conv.session.sessionName?.trim()) {
                 const trimmed = text.trim().replace(/\s+/g, " ");
                 conv.title = trimmed.length > 30 ? `${trimmed.slice(0, 30)}…` : trimmed;
+                // 同时也是 #140 的入列时刻：这条对话从此有内容了，左栏「运行的对话」
+                // 立刻要有它（此刻还在流式输出，不能等 agent_end 的防抖刷新）。
                 this.emitConversations();
             }
             // Attach files as independent nextTurn context messages (asides) so the
@@ -4128,10 +4138,40 @@ export class ClientSession {
         this.notifyConversationChanged();
         this.flushSnapshot();
     }
+    /** 左栏「运行的对话」的展示口径（issue #140）。
+     *
+     *  老口径只有 listed：新对话要等「被换到后台且仍在跑」才入列 —— 用户正在聊的
+     *  那条反而不在列表里（只有它一条时，左栏连「运行的对话」标题都不渲染，观感
+     *  像是对话丢了）。新口径把「当前对话 + 已经有内容」也算进来：有消息的对话
+     *  （或已被首条提示词命名 —— 命名与首条消息是同一时刻，见 prompt() 里的
+     *  rename 块）立刻出现在列表里；空白新对话仍然不入列（防连点「新建对话」
+     *  堆出一排空条目）。
+     *
+     *  只影响「列表里推什么」：listed 本身的语义、以及 displaceActive /
+     *  shouldRetainActive / MAX_OPEN_CONVERSATIONS 那套「什么算运行中」的规则
+     *  完全不变（换走时该释放的仍然释放，不会被这次展示口径改动永久钉在列表里）。
+     *  Display-only: retention and disposal rules are deliberately untouched. */
+    shownInRunningList(conv) {
+        if (conv.listed)
+            return true;
+        if (conv.id !== this.activeId)
+            return false;
+        // 首条提示词给对话命名 = 用户真的开始聊了（此刻消息可能还没落进会话统计）。
+        if (conv.title !== DEFAULT_CONV_TITLE)
+            return true;
+        try {
+            return conv.session.getSessionStats().totalMessages > 0;
+        }
+        catch {
+            // 会话替换中 —— 先不列，下一次 emit 会补上
+            return false;
+        }
+    }
     /** Push every running conversation across ALL projects to the client. The
      *  running-conversation list is global so a background run from another
      *  workspace stays visible; clicking one switches both the conversation and
-     *  its project (see switchConversation). The client groups the list by cwd. */
+     *  its project (see switchConversation). The client groups the list by cwd.
+     *  推什么见 shownInRunningList（listed + 当前对话有内容时）。 */
     emitConversations() {
         const conversations = [];
         // Active parents are normally absent from Running. Keep them visible while
@@ -4141,7 +4181,7 @@ export class ClientSession {
             .map((conv) => conv.parentId)
             .filter(Boolean));
         for (const conv of this.convs.values()) {
-            if (!conv.listed && !visibleParents.has(conv.id))
+            if (!this.shownInRunningList(conv) && !visibleParents.has(conv.id))
                 continue;
             let messageCount = 0;
             let isStreaming = false;
@@ -4462,8 +4502,9 @@ export class ClientSession {
             });
             return;
         }
-        if (!conv.listed) {
-            // Not in list anyway — nothing to do.
+        if (!this.shownInRunningList(conv)) {
+            // Not in list anyway — nothing to do. 展示口径见 shownInRunningList
+            // （当前对话有内容时也在列表里，对它的 ✕ 必须真的移出，不能静默 no-op）。
             this.emitConversations();
             return;
         }
@@ -5532,6 +5573,27 @@ export class AgentService {
         }
         return best;
     }
+    /** 插件无头调用（host.chat 的落地）：外部通道（微信等）把文本投给 agent。
+     *  每个 (pluginId, accountId) 独立伪客户端——复用 attach 完整链路
+     *  （会话恢复/持久化/工具注入/快照），无浏览器也能跑；sink 是空函数，
+     *  快照/notice 发了即丢，不攒内存。fire-and-forget：prompt 投递即返回，
+     *  运行结果经 onRunEvent(run_end) 按 conversationId 关联。
+     *  v1 语义：与该服务 cwd 下最近会话共享（单用户视角连续）；peer 名由插件
+     *  拼进文本前缀，per-peer 会话隔离以后再加。 */
+    async chatFromPlugin(pluginId, req) {
+        const safe = String(pluginId ?? "plugin").replace(/[^A-Za-z0-9_-]/g, "") || "plugin";
+        const acct = String(req?.accountId ?? "default").replace(/[^A-Za-z0-9_-]/g, "") || "default";
+        const clientId = `plugin:${safe}:${acct}`;
+        const text = String(req?.text ?? "");
+        if (!text.trim())
+            throw new Error("chatFromPlugin: text 为空");
+        if (this.quiesced)
+            throw new QuiesceRejectedError("插件无头调用被拒绝，请等服务器恢复后重试");
+        const cs = await this.attach(clientId, () => { });
+        const before = cs.readConversationForPlugins()?.conversationId ?? "";
+        void cs.prompt(text);
+        return { conversationId: before, clientId };
+    }
     /** index.ts calls this when a browser socket opens/closes. */
     noteSocketOpen() {
         this.socketCount += 1;

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

@@ -1121,11 +1121,18 @@ export class DshClientSession {
     pendingMessages() {
         return 0;
     }
+    /** 左栏展示口径（issue #140，与 pi 引擎同义）：listed 之外，当前对话只要有
+     *  内容（DSH 的对话消息全在内存里，直接数 messages）也在列表里；空白新对话
+     *  不入列。只影响展示，不动 listed 的语义。 */
+    shownInRunningList(conv) {
+        return conv.id === this.activeId && conv.messages.length > 0;
+    }
     emitConversations() {
         const list = [];
         for (const conv of this.convs.values()) {
-            // 只列被置换到后台的运行中会话（与 pi 一致）；active 会话不进“运行的对话”。
-            if (!conv.listed)
+            // 被置换到后台的会话 + 当前对话（一旦有内容就是用户正在聊的那条，
+            // 不该在列表里缺席——issue #140；空白新对话仍然不入列）。
+            if (!conv.listed && !this.shownInRunningList(conv))
                 continue;
             list.push({
                 id: conv.id,
@@ -1797,7 +1804,7 @@ export class DshClientSession {
             });
             return;
         }
-        if (!conv.listed) {
+        if (!conv.listed && !this.shownInRunningList(conv)) {
             this.emitConversations();
             return;
         }

package/dist/server/index.js

@@ -649,6 +649,8 @@ service.onConversationChanged = () => pluginMgr.emitConversationChanged();
 // 插件扩展点：当前打开对话的快照（轨迹视图直接显示打开对话的时间线；
 // dsh 引擎无此方法时回退 null，插件显示空态）。
 pluginMgr.conversationProvider = () => service.readConversationForPlugins?.() ?? null;
+// 插件扩展点：无头调用 agent（微信通道等经 host.chat 投递外部消息，无浏览器也能跑）。
+pluginMgr.chatProvider = (pluginId, req) => service.chatFromPlugin?.(pluginId, req) ?? Promise.reject(new Error("当前引擎不支持无头调用（仅标准 pi 引擎）"));
 // 插件扩展点：插件注册的 AI 工具（registerAgentTool）+ MCP 桥工具 → 会话创建时
 // 带上 + 变化时动态注入/移除已有会话。
 service.pluginToolsProvider = () => [...pluginMgr.getAgentTools(), ...mcpBridge.getTools()];

package/dist/server/plugin-facilities.js

@@ -93,12 +93,22 @@ function unseal(key, blob) {
     decipher.setAuthTag(Buffer.from(blob.tag, "hex"));
     return Buffer.concat([decipher.update(Buffer.from(blob.ct, "hex")), decipher.final()]).toString("utf8");
 }
-/** 读或创建全局密钥文件（懒加载一次）。 */
+/** 读或创建全局密钥文件（懒加载一次）。
+ *
+ * 曾有一个 bug：`readFileSync` 拿到的缓冲直接 `.toString("hex")`（把 hex 文本
+ * 又做了一次 hex 编码），导致重启后 key 变成 65 字节，AES-256-GCM 全线报
+ * "Invalid key length”。此处按 UTF-8 读 hex 文本再解码，并校验 32 字节——
+ * 长度不对即视为损坏，重新生成（旧 secrets.bin 用旧 key 解不开→按 fail closed
+ * 丢弃，总比所有机密操作全炸好；见 tests/unit/plugin-facilities.test.ts 回归）。 */
 function loadOrCreateKey(dataDir) {
     const keyFile = join(dataDir, "secrets.key");
     try {
-        if (existsSync(keyFile))
-            return Buffer.from(readFileSync(keyFile).toString("hex").trim(), "hex");
+        if (existsSync(keyFile)) {
+            const loaded = Buffer.from(readFileSync(keyFile, "utf8").trim(), "hex");
+            if (loaded.length === 32)
+                return loaded;
+            console.warn(`[secrets] ${keyFile} 长度异常（${loaded.length} 字节），重新生成密钥（旧机密将不可读）`);
+        }
     }
     catch {
         /* fallthrough → regenerate */

package/dist/server/plugins.js

@@ -491,6 +491,8 @@ export class PluginManager {
     }
     /** index.ts 注入：读取当前打开对话的快照（轨迹类插件经 host.getActiveConversation 调用）。 */
     conversationProvider = undefined;
+    /** index.ts 注入：插件无头调用 agent（微信通道等经 host.chat 调用）。 */
+    chatProvider = undefined;
     /** 当前打开对话的快照（无提供者/暂无对话时返回 null）。 */
     getActiveConversation() {
         try {
@@ -877,6 +879,20 @@ export class PluginManager {
                 return () => convChangeHandlers.delete(h);
             },
             getActiveConversation: () => self.getActiveConversation(),
+            chat: (req) => {
+                if (!can("chat"))
+                    return Promise.reject(new Error(`插件未声明能力 "chat"（manifest.permissions）——请求被拒`));
+                if (!self.chatProvider) {
+                    return Promise.reject(new Error("宿主未提供无头调用（chatProvider 未接入）——请升级 pi-web-ui"));
+                }
+                const text = String(req?.text ?? "").trim();
+                if (!text)
+                    return Promise.reject(new Error("chat: text 为空"));
+                if (text.length > 8000)
+                    return Promise.reject(new Error("chat: text 超长（>8000 字），请裁剪后重发"));
+                const accountId = String(req?.accountId ?? "default").slice(0, 64);
+                return self.chatProvider(info.id, { text, accountId });
+            },
             onAttach: (h) => {
                 attachHandlers.add(h);
                 return () => attachHandlers.delete(h);

package/dist/server/terminals.js

@@ -678,7 +678,7 @@ export class TerminalManager {
         this.history.delete(id);
         const safeCwd = this.safeCwd(cwd || fallbackCwd);
         if (!safeCwd) {
-            this.fail(id, "终端工作目录必须位于当前工作区内", "Terminal cwd must be inside the current workspace");
+            this.fail(id, pick(this.lang?.() ?? "en", "终端工作目录必须位于当前工作区内", "Terminal cwd must be inside the current workspace", "terminals.cwd.outside.workspace"), "Terminal cwd must be inside the current workspace");
             return null;
         }
         if (this.spawnShell(id, safeCwd, cols, rows, title || `终端 ${++this.seq}`, undefined, opts?.forceBash, opts?.agentBash, opts?.locale)) {
@@ -720,7 +720,7 @@ export class TerminalManager {
         const command = expandPwd(def.command.trim(), pwd);
         const title = def.name || command || `终端 ${++this.seq}`;
         if (!dir) {
-            this.fail(id, "终端工作目录必须位于当前工作区内", "Terminal cwd must be inside the current workspace");
+            this.fail(id, pick(this.lang?.() ?? "en", "终端工作目录必须位于当前工作区内", "Terminal cwd must be inside the current workspace", "terminals.cwd.outside.workspace"), "Terminal cwd must be inside the current workspace");
             return;
         }
         if (existing) {
@@ -748,7 +748,7 @@ export class TerminalManager {
             return;
         this.emitList();
         // Clear the previous run's output, then show a banner and run the command
-        // (the PTY input buffer holds it until the shell is ready).
+        // once the fresh shell is ready to read (see writeWhenReady).
         const banner = "\x1b[2J\x1b[3J\x1b[H" + `\x1b[90m> ${command}\x1b[0m  \x1b[90m(${dir})\x1b[0m\r\n`;
         const fresh = this.terms.get(id);
         if (fresh)
@@ -756,7 +756,47 @@ export class TerminalManager {
         this.writeOut(id, banner);
         this.maybeEmitTccHint(id);
         if (command)
-            this.input(id, command + "\r");
+            this.writeWhenReady(id, command + "\r");
+    }
+    /**
+     * Type text into a freshly spawned shell once it is ready to read.
+     *
+     * Input written to a brand-new PTY before its shell is reading can lose
+     * the first bytes (Windows ConPTY is the usual victim — the classic
+     * symptom is `pi-web-ui` arriving as `i-web-ui`). The shell's first
+     * output is the readiness signal; a timeout covers shells that start
+     * silent. Stale entries (restarted/killed while waiting) are skipped.
+     */
+    writeWhenReady(id, text, timeoutMs = 1500) {
+        const entry = this.terms.get(id);
+        if (!entry || entry.exited)
+            return;
+        let sent = false;
+        let disp;
+        const send = () => {
+            if (sent)
+                return;
+            sent = true;
+            clearTimeout(timer);
+            try {
+                disp?.dispose();
+            }
+            catch {
+                // PTY already gone — the stale-entry guard below no-ops.
+            }
+            const live = this.terms.get(id);
+            if (!live || live !== entry || live.exited)
+                return;
+            this.input(id, text);
+        };
+        const timer = setTimeout(send, timeoutMs);
+        timer.unref?.();
+        try {
+            disp = entry.pty.onData(() => send());
+        }
+        catch {
+            // Spawn failed between the lookup and now — timer fallback no-ops.
+        }
     }
     /** Spawn the user's shell as a PTY. Returns false when the spawn failed. */
     spawnShell(id, cwd, cols, rows, title, command, forceBash, agentBash = false, locale) {

package/dist/server/tool-manager.js

@@ -68,9 +68,9 @@ export const AGENT_TOOL_CATALOG = [
     { name: DELEGATE_TASK_TOOL_NAME, group: "other", defaultOn: true, dshVisible: false },
     { name: ASK_USER_QUESTION_TOOL_NAME, group: "other", defaultOn: true, dshVisible: true },
     { name: MARKERS_LIST_TOOL_NAME, group: "other", defaultOn: true, dshVisible: true },
-    // 默认开但 dshVisible=false：DSH 引擎没有页面桥（page_request 由 pi 引擎的
-    // customTool 发出），列在那里只会让用户关一个不存在的工具。
-    { name: BROWSER_PAGE_TOOL_NAME, group: "other", defaultOn: true, dshVisible: false },
+    // 默认关（AI 动用户浏览器，opt-in 才开）且 dshVisible=false：DSH 引擎没有页面桥
+    // （page_request 由 pi 引擎的 customTool 发出），列在那里只会让用户关一个不存在的工具。
+    { name: BROWSER_PAGE_TOOL_NAME, group: "other", defaultOn: false, dshVisible: false },
 ];
 const KNOWN_NAMES = new Set(AGENT_TOOL_CATALOG.map((t) => t.name));
 /** 是否为本表登记的可开关工具（未知名一律 false，不抛错）。 */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-web-ui",
-	"version": "0.83.0",
+	"version": "0.85.0",
 	"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": {

package/plugins/catalog.json

@@ -53,6 +53,15 @@
 		"source": "xing-shuyin/pi-web-ui/plugins/legado-web",
 		"homepage": "https://github.com/xing-shuyin/pi-web-ui/tree/main/plugins/legado-web"
 	},
+	{
+		"id": "wechat-ilink",
+		"name": "微信通道",
+		"icon": "💬",
+		"description": "微信扫码登录（与腾讯 openclaw-weixin 同源的 ilink 协议）：出站长轮询收消息，微信里直接指挥 agent，无需公网 IP。",
+		"descriptionEn": "WeChat channel (ilink protocol, same origin as Tencent openclaw-weixin): outbound long-polling, drive the agent from WeChat, no public IP needed.",
+		"source": "xing-shuyin/pi-web-ui/plugins/wechat-ilink",
+		"homepage": "https://github.com/xing-shuyin/pi-web-ui/tree/main/plugins/wechat-ilink"
+	},
 	{
 		"id": "image-toolkit",
 		"name": "image-toolkit",

package/web/dist/assets/{TerminalPanel-BF99sld0.js → TerminalPanel-CNz4vxHW.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-D__1RagK.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-DM-A59lk.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