pi-web-ui 0.69.0 → 0.71.0

package/CHANGELOG.md

@@ -0,0 +1,302 @@
+# Changelog
+
+> 面向使用者的版本变更记录：升级前先看这里，再决定是否升级。
+> 版本号规则：npm 上的版本不带 `v` 前缀（如 `0.70.0`），GitHub 的 tag / Release 带 `v` 前缀（如 `v0.70.0`），两者数字部分一一对应。
+> 日期为 npm 发布时间（UTC+8 换算后的日历日）。
+
+格式说明：`Added` 新增功能、`Fixed` 修复、`Changed` 行为/样式变更、`i18n` 多语言相关。
+每个版本的内容按"实际合入该版本发布的提交"归档（以 `package.json` 的 version 变更提交为准），
+而不是按提交日期聚类——连续快速发布的 patch 版本以此为准最准确。
+
+## [Unreleased]
+
+暂无未发布内容。
+
+## [0.71.0] — 2026-09-09
+
+### Added
+
+- 全屏壁纸与容器背景变量，新增半透明（translucent）/全透明（transparent）主题。
+- 右侧文件列表加"复制名称 / 复制路径"按钮。
+
+### Fixed
+
+- CollapsedMessage：`button` 改 `div`，窄消息区 rail 避让仅桌面生效。
+
+### Changed
+
+- prettier 收尾：`web/src/i18n.tsx` 上游 drift 格式化（post-#102）。
+
+## [0.70.0] — 2026-09-09
+
+### Added
+
+- 全局共享设置：服务端持久化 + 服务端 quick-phrases 种子、quick-seed 标记、动态 marker overlay。
+- 输入框快捷短语改为服务端下发种子；超长 notice 自动换行。
+- 聊天壁纸设置基础（issue #100，含主题 cyberpunk 壁纸变量与 `wallpaper-settings` 单测；全屏壁纸与容器背景变量见 0.71.0）。
+- 终端"运行中"列表只统计存活 PTY（countLive）。
+
+### Fixed
+
+- 语言包 slot 语法与换行转义；条件分支预渲染 segments。
+
+### i18n
+
+- 葡萄牙语 serverStrings 163 条翻译 + 文案润色。
+
+### Changed
+
+- 面板按钮对比度、主题英文名、思考/工具头重排。
+
+## [0.69.0] — 2026-09-08
+
+### Added
+
+- 目标模式总开关：关闭时隐藏目标条，阻断向导与审查。
+- `PI_WEB_TABS`（实例提供哪些 tab）与 `PI_WEB_MANAGED`（外部更新的实例）及文档。
+- 首次访问语言跟随浏览器，而非固定默认。
+
+### Fixed
+
+- 用户气泡保留单个换行；快捷短语输入后重新聚焦。
+- 子代理归属其所属会话（issue #95）。
+- E2E 明确上报 zh locale；terminal-smoke 与终端工具默认关对齐。
+
+### Changed
+
+- pt-BR 文案润色；`index.mjs` 参数化查询（#97）。
+
+## [0.68.2] — 2026-09-08
+
+### Added
+
+- 意大利语（it） locale；可下载语言包（核心只带 zh/en）。
+- 标准 pi 引擎接入 `ask_user_question` 问卷。
+- 文本块与思考块复制按钮。
+
+### Fixed
+
+- 网页终端里 vim 无法输入（提高 Vite 构建 target）。
+- Android/Termux 死锁：服务端热路径消除全部 fork。
+- pt-BR 字符串润色（markers 描述 + locale 列表报错）。
+
+## [0.68.1] — 2026-09-07
+
+### Added
+
+- 运行轨迹时间线插件：`host.onRunEvent` 轨迹事件通道、harness 式轨迹分析 v2、vis-timeline 专业引擎（vendor 自带）、工具按名着色 + 图例、自绘即时悬浮层。
+- 浏览器标题显示项目名。
+
+### Fixed
+
+- webmail：secret 存储失败时不再丢密码。
+- 宽屏消息列/输入列按实测滚动条宽精确对齐；重试提示条幅与消息正文列同宽；goalbar 对齐。
+
+## [0.68.0] — 2026-09-07
+
+### Added
+
+- 输入框快捷短语：一键发送 + 设置页管理。
+
+## [0.67.0] — 2026-09-07
+
+### Added
+
+- 系统提示词模板组合（system prompt template composition）+ `edit_soft` 宽松编辑工具。
+
+## [0.66.0] — 2026-09-07
+
+### Added
+
+- Termux（Android）安装指南。
+- Mermaid 图表跟随当前主题。
+
+### Fixed
+
+- 同步 pi CLI 探测改为异步后台探测（解决死锁，#79）。
+- Mermaid 主题同步与排版规整。
+
+## [0.65.0] — 2026-09-06
+
+### Added
+
+- 插件市场 + fenced-code 渲染插件（mermaid 插件化）。
+- 超宽屏聊天列开关。
+
+## [0.64.8] — 2026-09-06
+
+### Fixed
+
+- 后台服务列表过滤桌面软件噪音进程。
+
+## [0.64.7] — 2026-09-06
+
+### Added
+
+- 子代理父子链接树、保留与干净 rpc 绑定。
+
+## [0.64.6] — 2026-09-06
+
+### Added
+
+- 子代理：错误透出、模型选择、`wait-for-all` 工具。
+
+## [0.64.5] — 2026-09-06
+
+### Fixed
+
+- 重启浏览器恢复上次工作目录。
+- 目录消失时列表/会话刷新不再崩溃（issue #74）。
+
+## [0.64.4] — 2026-09-06
+
+### Added
+
+- 设置 → 显示：mermaid 图表渲染开关。
+
+### Fixed
+
+- 历史/最近项目遵循 `PI_CODING_AGENT_SESSION_DIR`。
+
+## [0.64.3] — 2026-09-05
+
+### Added
+
+- `pi-web-ui --help` 中英双语（按 LANG 检测，#72）。
+
+## [0.64.2] — 2026-09-05
+
+### Added
+
+- mermaid 代码块渲染为图表。
+- 机器浏览模式：`@root` 机器根 + 绝对 wire 路径跨盘符浏览。
+
+### Fixed
+
+- `PI_WEB_TOKEN` 改口令后 cookie 自动刷新/过期，一次 `?token=` 即恢复（issue #71）。
+- mermaid 原生 SVG 尺寸、流式路径渲染、取消渲染清理；宽图表可读宽度保持。
+
+## [0.64.1] — 2026-09-05
+
+### Added
+
+- 33 条 notice 的英文 textEn、locale 实时退出横幅与页面标题。
+
+### Fixed
+
+- 移动端发送按钮盖过思考强度底弹层（#70）。
+- Windows 下 stale-marker 单测时间戳（pre-1970 mtime 回绕到 2106）。
+
+## [0.64.0] — 2026-09-04
+
+### Added
+
+- 全局提示词历史、目录选择器（含新建文件夹）与 UI 抛光。
+
+## [0.63.4] — 2026-09-04
+
+- 版本重发（随带 `rename` 内置 marker 一行修正），无功能变更。
+
+## [0.63.3] — 2026-09-04
+
+### Added
+
+- PWA 支持与移动端键盘回车换行（#64）；会话结束/需输入时桌面通知（#65）；PWA 资源与通知图标子路径感知（nginx `/pi/` 部署）。
+- 历史对话与终端标签 UI 重命名（#63）；`/name` 命令重命名当前会话（#66）。
+- 行内 marker 系统：todo/svc/notify/rename，无需工具往返。
+
+### Fixed
+
+- SCM 提交遵循暂存区，并新增"提交全部"。
+
+## [0.63.2] — 2026-09-03
+
+### Fixed
+
+- 主题名跟随界面语言（英文用 nameEn，#61）。
+- terminal-smoke 改轮询 shell banner，消除慢 CI 机器抖动。
+
+## [0.63.1] — 2026-09-03
+
+### Fixed
+
+- 左侧栏折叠区块统一样式：折叠后三标题一致、切换不位移、收起按钮垂直居中、标题高亮通栏居中。
+
+## [0.63.0] — 2026-09-03
+
+### Added
+
+- 子代理模板：角色系统提示词（append/replace）+ 技能/扩展白名单，AI 可选用、可停用，内置 6 个默认模板。
+- 对话可从运行列表移出（dismiss_conversation）+ pi-subagents 存活检测（WIP）。
+
+### Changed
+
+- 全仓库 prettier（Tab/120）与 oxlint 接入 CI（#57/#58）。
+- DSH notice、终端退出横幅、目标状态跟随界面语言（#54 及后续）。
+
+### Fixed
+
+- 插件目录搬迁后坏掉的冒烟测试 fixture（#59）。
+
+## [0.62.1] — 2026-09-03
+
+### Fixed
+
+- SCM 的 `git add/reset` 路径引号闭合（issue #51）。
+
+## [0.62.0] — 2026-09-02
+
+### Added
+
+- 排队消息可删除（✕）；底部栏实时缓存命中率与生成速率。
+
+### Fixed
+
+- `terminal_create` 带 title 下发，服务端不再用中文默认覆盖。
+
+## [0.61.0] — 2026-09-02
+
+### Added
+
+- 内置服务商多密钥管理 + 项目级模型/key 记忆。
+
+## 更早版本
+
+0.62 之前的版本没有逐版归档，以下是发布提交记录中的要点（详见 `git log`）：
+
+- 0.60.0（2026-09-02）：移除 `PORT` 环境变量兼容，仅保留 `PI_WEB_PORT`；修复 `--host` 直启失效。
+- 0.59.0（2026-09-01）、0.58.0（2026-08-30）。
+- 0.56.1 / 0.55.0 / 0.53.0 / 0.51.0（2026-08-30）。
+- 0.50.0 / 0.49.0（2026-08-29）：0.49.0 起移除 Electron 桌面壳，只保留纯 Web。
+- 0.48.3 / 0.48.2（2026-08-29）：pi SDK 升到 `^0.84.4`。
+- 0.44.1（2026-08-28）。
+- 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.71.0...main
+[0.71.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.71.0
+[0.70.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.70.0
+[0.69.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.69.0
+[0.68.2]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.68.2
+[0.68.1]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.68.1
+[0.68.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.68.0
+[0.67.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.67.0
+[0.66.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.66.0
+[0.65.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.65.0
+[0.64.8]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.64.8
+[0.64.7]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.64.7
+[0.64.6]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.64.6
+[0.64.5]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.64.5
+[0.64.4]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.64.4
+[0.64.3]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.64.3
+[0.64.2]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.64.2
+[0.64.1]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.64.1
+[0.64.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.64.0
+[0.63.4]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.63.4
+[0.63.3]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.63.3
+[0.63.2]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.63.2
+[0.63.1]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.63.1
+[0.63.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.63.0
+[0.62.1]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.62.1
+[0.62.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.62.0
+[0.61.0]: https://github.com/xing-shuyin/pi-web-ui/releases/tag/v0.61.0

package/dist/server/agent-service.js

@@ -1110,9 +1110,15 @@ export class ClientSession {
                 // 复用现有重命名路径（内存标题 + 磁盘 session_info）
                 void this.renameConversation(convId, title);
             },
+            // 标记 widget 合并进扩展 widget 里，跟随当前活动会话渲染（切换会话即刷新）。
+            refreshMarkers: () => this.webUi.refresh(),
             // issue #91：标记引导/错误按客户端 UI 语言出中英（英文默认）。
             lang: () => this.getLang(),
         });
+        // 标记 widget 动态渲染「当前活动会话」的 todo/overlay：切换会话时只要刷新
+        // webUi（见 switchConversation/setCwd/newChat）就会显示对应会话的标记，
+        // 且与扩展 widget 合并下发、不会互相覆盖。
+        this.webUi.setDynamicWidget("markers", () => this.markerSvc.overlayLines(this.activeId));
         this.settingsSvc = new SettingsService({
             clientId,
             stateStore,
@@ -2839,7 +2845,10 @@ export class ClientSession {
     }
     /** Persist + apply a partial settings update (prompt text/mode, toggles). */
     async setSettings(partial) {
-        const { markersEnabled, disabledMarkers, ...rest } = partial;
+        const { markersEnabled, disabledMarkers, quickPhrasesSeeded, ...rest } = partial;
+        // 快捷短语「已 seed」是全局标记（非 per-clientId）：置位一次后永久生效。
+        if (quickPhrasesSeeded)
+            this.stateStore.markQuickPhrasesSeeded();
         let markerChanged = false;
         if (markersEnabled !== undefined || disabledMarkers !== undefined) {
             this.markerSvc.setAll({
@@ -3475,7 +3484,7 @@ export class ClientSession {
                 reviewing: conv.goal.reviewing,
                 wizardRunning: conv.wizardRunning,
                 streaming: conv.session.isStreaming,
-                openTerminals: conv.terminals.list().length,
+                openTerminals: conv.terminals.countLive(),
                 listed: conv.listed,
                 promptedSinceActive: conv.promptedSinceActive,
                 hasActiveSubagentRun: () => hasActiveSubagentRun({ sessionId: conv.session.sessionFile }),
@@ -3872,7 +3881,7 @@ export class ClientSession {
                 reviewing: conv.goal.reviewing,
                 wizardRunning: conv.wizardRunning,
                 streaming: conv.session.isStreaming,
-                openTerminals: conv.terminals.list().length,
+                openTerminals: conv.terminals.countLive(),
                 listed: conv.listed,
                 promptedSinceActive: conv.promptedSinceActive,
                 hasActiveSubagentRun: () => hasActiveSubagentRun({ sessionId: conv.session.sessionFile }),
@@ -3887,7 +3896,7 @@ export class ClientSession {
                     textEn: `Conversation "${conv.title}" is still running — wait for it to finish or press Stop before removing`,
                 });
             }
-            else if (conv.terminals.list().length > 0) {
+            else if (conv.terminals.countLive() > 0) {
                 this.emit({
                     type: "notice",
                     level: "warning",

package/dist/server/client-state.js

@@ -76,6 +76,14 @@ export class ClientStateStore {
     constructor(filePath) {
         this.filePath = filePath;
     }
+    /** 长期设置（设置面板 config + 预设 + 标记开关）的固定存储键。
+     *
+     * 为什么用固定全局键而非 per-clientId：clientId 存 sessionStorage（每标签页独立、
+     * 关浏览器即失），按 clientId 存设置会在每次新会话/重启后生成新 id → 设置全部重置、
+     * 且各标签页/浏览器各有一套互不同步。改为全局共享后：所有客户端（标签页/浏览器）
+     * 使用同一套配置，且持久化在服务端，重启不丢（「同一套配置」）。会话级状态
+     * （最近项目 / lastCwd / 项目模型与密钥等）仍按 clientId 各自保留。 */
+    static GLOBAL_SETTINGS_KEY = "__settings__";
     /** <dataDir>（client-state.json 的上一级）——共享配置（子代理模板库等）落在这里。 */
     get dataDir() {
         return dirname(this.filePath);
@@ -197,9 +205,9 @@ export class ClientStateStore {
         }
         return list;
     }
-    /** Last-used settings-panel state for a client, or defaults. */
-    getSettings(clientId) {
-        const s = this.load()[clientId];
+    /** 设置面板状态（系统提示词模式/文字 + 禁用技能/扩展）——全局共享同一套配置。 */
+    getSettings(_clientId) {
+        const s = this.load()[ClientStateStore.GLOBAL_SETTINGS_KEY];
         const stored = s?.settings;
         // 旧存档（promptMode/customSystemPrompt）迁移到 compose：追加文字成为独立
         // {{append}} 覆盖、替换文字成为 {{soul}} 覆盖；无自定义则用默认模板。
@@ -242,10 +250,10 @@ export class ClientStateStore {
             disabledPlugins: stored?.disabledPlugins ?? [],
         };
     }
-    /** Persist the client's settings-panel state (partial merge). */
-    saveSettings(clientId, settings) {
+    /** Persist the settings-panel state (partial merge) — global shared config. */
+    saveSettings(_clientId, settings) {
         const all = this.load();
-        const state = (all[clientId] ??= { projects: [] });
+        const state = (all[ClientStateStore.GLOBAL_SETTINGS_KEY] ??= { projects: [] });
         const cur = state.settings ?? {};
         state.settings = {
             promptMode: settings.promptMode ?? cur.promptMode ?? "append",
@@ -276,9 +284,9 @@ export class ClientStateStore {
         };
         this.save();
     }
-    /** Named settings presets for a client (empty if never saved). */
-    getPresets(clientId) {
-        return (this.load()[clientId]?.presets ?? []).map((p) => ({
+    /** Named settings presets for a client (empty if never saved) — global shared. */
+    getPresets(_clientId) {
+        return (this.load()[ClientStateStore.GLOBAL_SETTINGS_KEY]?.presets ?? []).map((p) => ({
             ...p,
             // Older client-state files predate review settings.
             reviewPrompt: p.reviewPrompt ?? "",
@@ -287,10 +295,10 @@ export class ClientStateStore {
             retryMaxAttempts: normalizeRetryMaxAttempts(p.retryMaxAttempts),
         }));
     }
-    /** Persist the client's named settings presets. */
-    savePresets(clientId, presets) {
+    /** Persist the named settings presets — global shared config. */
+    savePresets(_clientId, presets) {
         const all = this.load();
-        const state = (all[clientId] ??= { projects: [] });
+        const state = (all[ClientStateStore.GLOBAL_SETTINGS_KEY] ??= { projects: [] });
         state.presets = presets;
         this.save();
     }
@@ -346,17 +354,36 @@ export class ClientStateStore {
             delete all[clientId].projectModels;
         this.save();
     }
-    /** 内置标记工具开关（全局 + 按 marker 禁用）。 */
-    getMarkerSettings(clientId) {
-        const s = this.load()[clientId]?.markers;
+    /** 全局「快捷短语已 seed」标记（非 per-clientId）。
+     *
+     * 为什么全局：clientId 存 sessionStorage（每标签页独立、关浏览器即失），按
+     * clientId 记 seed 会在每次新会话生成新 clientId 时误判为「从未 seed」，导致
+     * 用户删掉的默认短语又被填回默认。seed 只需一次（首次见空列表），之后即为用户
+     * 数据，增删改/恢复默认/关闭都走设置面板。存服务端而非浏览器 localStorage，
+     * 任何浏览器/标签页/清缓存都不受影响。 */
+    getQuickPhrasesSeeded() {
+        const meta = this.load()[ClientStateStore.GLOBAL_SETTINGS_KEY];
+        return !!meta?.quickPhrasesSeeded;
+    }
+    markQuickPhrasesSeeded() {
+        const all = this.load();
+        const meta = (all[ClientStateStore.GLOBAL_SETTINGS_KEY] ??= { projects: [] });
+        if (meta.quickPhrasesSeeded)
+            return;
+        meta.quickPhrasesSeeded = true;
+        this.save();
+    }
+    /** 内置标记工具开关（全局共享同一套 + 按 marker 禁用）。 */
+    getMarkerSettings(_clientId) {
+        const s = this.load()[ClientStateStore.GLOBAL_SETTINGS_KEY]?.markers;
         return {
             markersEnabled: s?.markersEnabled ?? true,
             disabledMarkers: s?.disabledMarkers ?? [],
         };
     }
-    saveMarkerSettings(clientId, settings) {
+    saveMarkerSettings(_clientId, settings) {
         const all = this.load();
-        const state = (all[clientId] ??= { projects: [] });
+        const state = (all[ClientStateStore.GLOBAL_SETTINGS_KEY] ??= { projects: [] });
         const cur = state.markers ?? { markersEnabled: true, disabledMarkers: [] };
         state.markers = {
             markersEnabled: settings.markersEnabled ?? cur.markersEnabled ?? true,

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

@@ -2141,10 +2141,13 @@ export class DshClientSession {
             subagentModels: [],
             quickPhrases: [...this.settings.quickPhrases],
             quickPhrasesEnabled: this.settings.quickPhrasesEnabled,
+            quickPhrasesSeeded: this.stateStore.getQuickPhrasesSeeded(),
         };
         this.emit({ type: "settings_state", settings });
     }
     async setSettings(partial) {
+        if (partial.quickPhrasesSeeded)
+            this.stateStore.markQuickPhrasesSeeded();
         if (partial.promptMode !== undefined)
             this.settings.promptMode = partial.promptMode;
         if (partial.customSystemPrompt !== undefined)

package/dist/server/index.js

@@ -947,6 +947,7 @@ wss.on("connection", (ws) => {
                     disabledMarkers: msg.disabledMarkers,
                     quickPhrases: msg.quickPhrases,
                     quickPhrasesEnabled: msg.quickPhrasesEnabled,
+                    quickPhrasesSeeded: msg.quickPhrasesSeeded,
                 });
                 break;
             case "extensions_reload":

package/dist/server/locales.js

@@ -15,7 +15,7 @@
  */
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { extractServerStrings, registerServerStrings, unregisterServerStrings, } from "./i18n.js";
+import { extractServerStrings, registerServerStrings, unregisterServerStrings } from "./i18n.js";
 /** Packs available for download (alphabetical by code). */
 export const LOCALE_PACKS = [
     { code: "de", nativeName: "Deutsch" },

package/dist/server/marker-service.js

@@ -44,15 +44,18 @@ export class MarkerService {
         const lines = collectGuidance(disabled, this.lang());
         if (lines.length === 0)
             return "";
+        // The dynamic lines ride the `{lines}` slot so translator packs can
+        // place them (a static table value could never inline them).
+        const linesText = lines.join("\n");
         return pick(this.lang(), "\n\n────────── 内联标记工具（重要）──────────\n" +
             "状态类操作（任务、标记位、通知）请直接写在回答正文里，采用内联标记语法，而不要调用对应工具。\n" +
             "插件会替你执行并把标记从展示文本中移除，不会中断你的回答。\n\n" +
-            lines.join("\n") +
+            linesText +
             "\n──────────\n", "\n\n────────── Inline marker tools (important) ──────────\n" +
             "Write status operations (tasks, marker bits, notifications) directly in your reply text using inline marker syntax — do not call a tool for them.\n" +
             "The plugin executes them and strips the markers from the displayed text without interrupting your reply.\n\n" +
-            lines.join("\n") +
-            "\n──────────\n", "markers.service.guidance.frame");
+            linesText +
+            "\n──────────\n", "markers.service.guidance.frame", { lines: linesText });
     }
     setEnabled(enabled) {
         this.settings.markersEnabled = !!enabled;
@@ -205,6 +208,18 @@ export class MarkerService {
         this.pushOverlay(conversationId);
     }
     pushOverlay(conversationId) {
+        const lines = this.overlayLines(conversationId);
+        const key = `markers:${conversationId}`;
+        const prev = this.overlayCache.get(key);
+        const next = lines.length ? lines : [];
+        if (prev && prev.join("\n") === next.join("\n"))
+            return;
+        this.overlayCache.set(key, next);
+        // 通过宿主的 widget 合并（跟随当前活动会话，不覆盖扩展 widget）。
+        this.host.refreshMarkers();
+    }
+    /** 计算某个会话的标记 overlay 行（供 UI widget 动态渲染当前活动会话）。 */
+    overlayLines(conversationId) {
         const lines = [];
         for (const m of allMarkers()) {
             if (this.settings.disabledMarkers.includes(m.name))
@@ -230,18 +245,7 @@ export class MarkerService {
             lines.push(`[${ov.tool}]`);
             lines.push(...ov.lines.map((l) => `  ${l}`));
         }
-        const key = `markers:${conversationId}`;
-        const prev = this.overlayCache.get(key);
-        const next = lines.length ? lines : [];
-        if (prev && prev.join("\n") === next.join("\n"))
-            return;
-        this.overlayCache.set(key, next);
-        if (lines.length > 0) {
-            this.host.emit({ type: "widgets", widgets: [{ key: "markers", lines }] });
-        }
-        else {
-            this.host.emit({ type: "widgets", widgets: [] });
-        }
+        return lines;
     }
     describe(conversationId, tool, includeDeleted = false) {
         const st = this.getState(conversationId, TODO_NAMESPACE, initTodoState);

package/dist/server/settings-service.js

@@ -232,6 +232,7 @@ export class SettingsService {
                 subagentModels: this.collectSubagentModels(),
                 quickPhrases: [...this.settings.quickPhrases],
                 quickPhrasesEnabled: this.settings.quickPhrasesEnabled,
+                quickPhrasesSeeded: this.host.stateStore.getQuickPhrasesSeeded(),
             },
         });
     }

package/dist/server/subagents.js

@@ -126,18 +126,25 @@ export function makeSubagentTools(host, lang) {
                 const convId = await host.spawnSubagent(p.prompt, p.type ?? "general", p.cwd ?? ctx.cwd, p.template, p.model);
                 const subagentType = p.type ?? "general";
                 const subagentTitleText = subagentTitle(p.prompt);
-                return text(pick(getLang(), `子代理已启动（运行列表可见）：${convId}\n类型：${subagentType} · 标题：${subagentTitleText}` +
-                    (p.template ? `\n模板：${p.template}` : "") +
-                    (p.model ? `\n模型：${p.model}` : "") +
-                    `\n用 subagent_wait_all 一次等全部完成（不用轮询），subagent_get_result 取单个结果，subagent_list 看运行态，subagent_steer 改向，subagent_stop 停止。`, `Subagent started (visible in the running list): ${convId}\nType: ${subagentType} · Title: ${subagentTitleText}` +
-                    (p.template ? `\nTemplate: ${p.template}` : "") +
-                    (p.model ? `\nModel: ${p.model}` : "") +
+                // Optional segments are pre-rendered per language (translators pick
+                // the Zh/En variant through the vars table; inline ternaries would
+                // leak source syntax into packs that copy them verbatim).
+                const templateLineZh = p.template ? `\n模板：${p.template}` : "";
+                const templateLineEn = p.template ? `\nTemplate: ${p.template}` : "";
+                const modelLineZh = p.model ? `\n模型：${p.model}` : "";
+                const modelLineEn = p.model ? `\nModel: ${p.model}` : "";
+                return text(pick(getLang(), `子代理已启动（运行列表可见）：${convId}\n类型：${subagentType} · 标题：${subagentTitleText}${templateLineZh}${modelLineZh}` +
+                    `\n用 subagent_wait_all 一次等全部完成（不用轮询），subagent_get_result 取单个结果，subagent_list 看运行态，subagent_steer 改向，subagent_stop 停止。`, `Subagent started (visible in the running list): ${convId}\nType: ${subagentType} · Title: ${subagentTitleText}${templateLineEn}${modelLineEn}` +
                     `\nUse subagent_wait_all to wait for all at once (no polling), subagent_get_result for a single result, subagent_list for live status, subagent_steer to redirect, subagent_stop to stop.`, "subagents.spawn.started", {
                     convId: convId,
                     subagentType: subagentType,
                     subagentTitleText: subagentTitleText,
                     "p.template": p.template,
                     "p.model": p.model,
+                    templateLineZh: templateLineZh,
+                    templateLineEn: templateLineEn,
+                    modelLineZh: modelLineZh,
+                    modelLineEn: modelLineEn,
                 }), { convId, template: p.template, model: p.model });
             },
         }),

package/dist/server/terminals.js

@@ -1009,6 +1009,17 @@ export class TerminalManager {
     list() {
         return [...this.terms.values(), ...this.history.values()].map((entry) => this.info(entry));
     }
+    /** Count of LIVE PTYs only — exited terminals that merely retain their
+     *  output for review (history) do NOT count. Conversations are kept in the
+     *  running list while a live terminal exists; exited leftovers must not
+     *  pin an idle conversation forever. */
+    countLive() {
+        let n = 0;
+        for (const entry of this.terms.values())
+            if (!entry.exited)
+                n++;
+        return n;
+    }
     emitList() {
         this.emit({ type: "terminal_list", terminals: this.list() });
     }
@@ -1539,7 +1550,7 @@ function backgroundResult(terminals, opts, command, partialText, silentSeconds,
                 text: pick(lang, `命令仍在持久终端 ai-bash 中运行（已连续 ${silentSeconds} 秒无输出，未结束）。` +
                     `本次调用不阻塞——命令继续在后台执行，结束时你会收到自动通知。\n` +
                     `已有输出：\n${partialZh}\n` +
-                    `要重新阻塞等它结束就用 terminal_wait(terminalId="ai-bash")（无需反复轮询）；需要交互用 terminal_input / terminal_key（Ctrl+C 可终止）。`, `Command still running in the persistent terminal ai-bash (no output for ${silentSeconds}s, not finished).` +
+                    `要重新阻塞等它结束就用 terminal_wait(terminalId="ai-bash")（无需反复轮询）；需要交互用 terminal_input / terminal_key（Ctrl+C 可终止）。`, `Command still running in the persistent terminal ai-bash (no output for ${silentSeconds}s, not finished). ` +
                     `This call does not block — the command keeps running in the background and you will be notified automatically when it finishes.\n` +
                     `Partial output:\n${partialEn}\n` +
                     `To block until it finishes, use terminal_wait(terminalId="ai-bash") (no polling needed); use terminal_input / terminal_key to interact (Ctrl+C aborts).`, "terminals.bash.background.running", { silentSeconds, partialZh, partialEn }),

package/dist/server/webui-context.js

@@ -45,6 +45,15 @@ export class WebUIContext {
         this.emit = emit;
     }
     // -- widgets -------------------------------------------------------------
+    /** Register a widget whose lines come from a plain getter, re-evaluated on
+     *  every render/refresh (no SDK Component required). Used for
+     *  conversation-scoped overlays (e.g. markers) so switching conversations
+     *  re-renders them without re-registering. */
+    setDynamicWidget(key, lines) {
+        this.widgets.set(key, { render: () => lines() });
+        this.lastLines.delete(key);
+        this.push();
+    }
     /** Matches ExtensionUIContext's overloaded setWidget exactly. */
     setWidget = (key, content, options) => {
         void options;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-web-ui",
-	"version": "0.69.0",
+	"version": "0.71.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": {
@@ -21,6 +21,7 @@
 		"deploy/",
 		"extensions/",
 		"plugins/catalog.json",
+		"CHANGELOG.md",
 		"README.md",
 		"LICENSE"
 	],