@chainingintention/pi-web-cn 2.202610.2 → 2.202610.3

package/dist/pi-web-plugins/workspace-tasks/tasksPanelElement.js

@@ -222,11 +222,11 @@ function cacheKeyForContext(context) {
     return `${context.machine.id}:${context.workspace.projectId}:${context.workspace.id}`;
 }
 function renderMissingState(state) {
-    return `<div class="empty-state"><strong class="ui-toolbar-title toolbar-title">${escapeHtml(state.message)}</strong><p>${escapeHtml(state.hint)}</p></div>`;
+    return `<div class="empty-state"><strong>${escapeHtml(state.message)}</strong><p>${escapeHtml(state.hint)}</p></div>`;
 }
 function renderUnavailableState(state) {
     const detail = state.detail === undefined ? "" : `<pre>${escapeHtml(state.detail)}</pre>`;
-    return `<div class="status error"><strong class="ui-toolbar-title toolbar-title">${escapeHtml(state.message)}</strong><p>${escapeHtml(state.hint)}</p>${detail}</div>`;
+    return `<div class="status error"><strong>${escapeHtml(state.message)}</strong><p>${escapeHtml(state.hint)}</p>${detail}</div>`;
 }
 function renderTaskGroups(tasks, runningTaskId) {
     return `<div class="tasks">${groupTasks(tasks).map((group) => renderTaskGroup(group, runningTaskId)).join("")}</div>`;
@@ -255,7 +255,7 @@ function renderTask(task, runningTaskId) {
     return `
     <article class="task-card">
       <div class="task-copy">
-        <strong class="ui-toolbar-title toolbar-title">${escapeHtml(task.title)}</strong>
+        <strong>${escapeHtml(task.title)}</strong>
         ${description}
         <code>${escapeHtml(task.command)}</code>
       </div>

package/dist/pi-web-plugins/zh-cn/components.json

@@ -1229,6 +1229,9 @@
   "ui.navigation.agentSubsessionsActive": "代理子会话正在运行",
   "ui.navigation.unreadSubsessionActivity": "子会话有未读活动",
   "ui.navigation.collapsePanel": "折叠导航面板",
+  "ui.navigation.expandPanel": "展开导航面板",
+  "ui.workspacePanel.expandPanel": "展开工作区面板",
+  "ui.workspacePanel.collapsePanel": "折叠工作区面板",
   "ui.navigation.resizeSection": "调整{section}高度",
   "ui.navigation.resizeSectionReset": "调整{section}高度。双击或轻点两次以重置。",
   "ui.navigation.otherMachinesTerminalActive": "其他机器上的终端正在运行",
@@ -1248,5 +1251,7 @@
   "ui.projectDialog.remoteFolders": "远端机器 {machineId} 上的文件夹。",
   "ui.projectDialog.machinePaths": "路径属于此机器，而非浏览器所在设备。",
   "ui.projectDialog.folderLookupFailed": "无法读取此机器上的文件夹。请检查连接后重试，或直接输入文件夹路径。",
-  "ui.projectDialog.retryFolderLookup": "重新查找文件夹"
+  "ui.projectDialog.retryFolderLookup": "重新查找文件夹",
+  "ui.settingsDialog.backToApp": "返回应用",
+  "ui.sessionSearchDialog.searchSessions": "搜索会话"
 }

package/dist/plugin-api.d.ts

@@ -34,6 +34,7 @@ export type SessionLabelContextV5 = SessionLabelContext & PluginDiscoveryContext
 export type MessageActionContextV5 = MessageActionContext & PluginDiscoveryContext;
 export type DisplayedMessageActionContextV5 = DisplayedMessageActionContext & PluginDiscoveryContext;
 export interface PluginContributionsV5 extends Omit<PluginContributions, "actions" | "applicationPanels" | "workspacePanels" | "workspaceLabels" | "sessionLabels" | "messageActions" | "contentRenderers" | "themes"> {
+    uiPresentations?: UiPresentationContributionV1[];
     stylesheets?: StylesheetContribution[];
     syntaxHighlighters?: SyntaxHighlighterContribution[];
     contentRenderers?: ContentRendererContributionV5[];
@@ -45,6 +46,53 @@ export interface PluginContributionsV5 extends Omit<PluginContributions, "action
     sessionLabels?: SessionLabelContributionV5[];
     messageActions?: MessageActionContributionV5[];
 }
+export type UiPresentationRegion = "navigation" | "context-bar" | "chat-chrome" | "settings-navigation";
+/** Host-supplied actions remain bound to the selection and permissions that created them. */
+export interface UiPresentationActionV1 {
+    readonly id: string;
+    readonly label: string;
+    readonly disabled?: boolean;
+    readonly run: () => void | Promise<void>;
+}
+/** Display-only selection; no credentials, transcript, internal paths, or session connection. */
+export interface UiPresentationContextV1 {
+    readonly mode: "normal" | "management";
+    readonly compact?: boolean;
+    readonly machine?: Readonly<{
+        id: string;
+        name: string;
+    }>;
+    readonly project?: Readonly<{
+        id: string;
+        name: string;
+    }>;
+    readonly workspace?: Readonly<{
+        id: string;
+        label: string;
+    }>;
+    readonly session?: Readonly<{
+        id: string;
+        label: string;
+    }>;
+    readonly actions?: readonly UiPresentationActionV1[];
+}
+export interface UiPresentationRenderContextV1 extends UiPresentationContextV1 {
+    readonly region: UiPresentationRegion;
+    /** Named slots for host-owned controls. Render slots, never inspect or move host DOM. */
+    readonly slots: readonly string[];
+}
+/** One gateway-owned renderer per region. Editor/transcript stay mounted; navigation may recompose. */
+export interface UiPresentationContributionV1 {
+    readonly id: LocalContributionId;
+    readonly region: UiPresentationRegion;
+    /** Navigation only: compose the host-owned lists as a selected-branch tree. */
+    readonly navigationLayout?: "tree";
+    render(context: UiPresentationRenderContextV1): TemplateResult;
+}
+export interface UiPresentationCapabilityV1 {
+    readonly version: 1;
+    readonly regions: readonly UiPresentationRegion[];
+}
 export type PluginActionV5 = Omit<PluginAction, "enabled" | "disabledReason" | "run"> & {
     enabled?: (context: PluginRuntimeContextV5) => boolean;
     disabledReason?: (context: PluginRuntimeContextV5) => string | undefined;

package/dist/server/terminals/requiredTerminalService.js

@@ -1,4 +1,5 @@
 import { REQUIRED_TERMINAL_PLUGIN_ID } from "../../shared/requiredTerminalPlugin.js";
+import { requireTerminalCommandRun } from "../../shared/terminalCommandRun.js";
 /** Core's typed view of the bundled Terminal service capability. */
 export const REQUIRED_TERMINAL_SERVICE_CAPABILITY = Object.freeze({
     pluginId: REQUIRED_TERMINAL_PLUGIN_ID,
@@ -23,7 +24,7 @@ export function snapshotRequiredTerminalService(value) {
     }
     return Object.freeze({
         closeForCwd: (cwd) => { Reflect.apply(closeForCwd, value, [cwd]); },
-        runCommand: (options) => requireCommandRun(Reflect.apply(runCommand, value, [options])),
+        runCommand: (options) => requireTerminalCommandRun(Reflect.apply(runCommand, value, [options]), invalidCommandRun),
         bindActivitySink: (sink) => {
             Reflect.apply(bindActivitySink, value, [Object.freeze({
                     updateTerminal: (terminal) => { sink.updateTerminal(terminal); },
@@ -42,58 +43,6 @@ export function unavailableRequiredTerminalService() {
         bindActivitySink: () => undefined,
     });
 }
-function requireCommandRun(value) {
-    if (!isRecord(value))
-        throw invalidCommandRun();
-    const status = value["status"];
-    const exitCode = optionalFiniteNumber(value["exitCode"]);
-    const startedAt = optionalString(value["startedAt"]);
-    const completedAt = optionalString(value["completedAt"]);
-    if (typeof value["id"] !== "string"
-        || typeof value["origin"] !== "string"
-        || typeof value["projectId"] !== "string"
-        || typeof value["workspaceId"] !== "string"
-        || typeof value["terminalId"] !== "string"
-        || typeof value["title"] !== "string"
-        || typeof value["command"] !== "string"
-        || (status !== "queued" && status !== "running" && status !== "succeeded" && status !== "failed")
-        || exitCode === invalidOptionalField
-        || typeof value["createdAt"] !== "string"
-        || startedAt === invalidOptionalField
-        || completedAt === invalidOptionalField
-        || !isStringRecord(value["metadata"])) {
-        throw invalidCommandRun();
-    }
-    return {
-        id: value["id"],
-        origin: value["origin"],
-        projectId: value["projectId"],
-        workspaceId: value["workspaceId"],
-        terminalId: value["terminalId"],
-        title: value["title"],
-        command: value["command"],
-        status,
-        ...(exitCode === undefined ? {} : { exitCode }),
-        createdAt: value["createdAt"],
-        ...(startedAt === undefined ? {} : { startedAt }),
-        ...(completedAt === undefined ? {} : { completedAt }),
-        metadata: { ...value["metadata"] },
-    };
-}
-const invalidOptionalField = Symbol("invalid optional Terminal field");
-function optionalFiniteNumber(value) {
-    if (value === undefined)
-        return undefined;
-    return typeof value === "number" && Number.isFinite(value) ? value : invalidOptionalField;
-}
-function optionalString(value) {
-    if (value === undefined)
-        return undefined;
-    return typeof value === "string" ? value : invalidOptionalField;
-}
-function isStringRecord(value) {
-    return isRecord(value) && Object.values(value).every((child) => typeof child === "string");
-}
 function invalidCommandRun() {
     return new Error("Required Terminal server entry returned an invalid command run");
 }

package/dist/server/terminals/requiredTerminalService.js.map

@@ -1 +1 @@
-{"version":3,"file":"requiredTerminalService.js","sourceRoot":"","sources":["../../../src/server/terminals/requiredTerminalService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"requiredTerminalService.js","sourceRoot":"","sources":["../../../src/server/terminals/requiredTerminalService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAuC/E,oEAAoE;AACpE,MAAM,CAAC,MAAM,oCAAoC,GAAG,MAAM,CAAC,MAAM,CAAC;IAChE,QAAQ,EAAE,2BAA2B;IACrC,EAAE,EAAE,SAAS;IACb,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,+BAA+B;CACvC,CAAwD,CAAC;AAE1D,MAAM,OAAO,gCAAiC,SAAQ,KAAK;IAA3D;;QACW,SAAI,GAAG,kCAAkC,CAAC;IACrD,CAAC;CAAA;AAED,MAAM,UAAU,+BAA+B,CAAC,KAAc;IAC5D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAChH,MAAM,WAAW,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,gBAAgB,GAAG,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACnD,IAAI,OAAO,WAAW,KAAK,UAAU,IAAI,OAAO,UAAU,KAAK,UAAU,IAAI,OAAO,gBAAgB,KAAK,UAAU,EAAE,CAAC;QACpH,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,CAAC,GAAW,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3E,UAAU,EAAE,CAAC,OAAkC,EAAE,EAAE,CAAC,yBAAyB,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,iBAAiB,CAAC;QAC7I,gBAAgB,EAAE,CAAC,IAAkC,EAAE,EAAE;YACvD,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC;oBACpD,cAAc,EAAE,CAAC,QAAkC,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;oBAC1F,cAAc,EAAE,CAAC,UAAkB,EAAE,GAAY,EAAE,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;iBAChG,CAAC,CAAC,CAAC,CAAC;QACP,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kCAAkC;IAChD,MAAM,WAAW,GAAG,GAAU,EAAE;QAC9B,MAAM,IAAI,gCAAgC,CACxC,mGAAmG,CACpG,CAAC;IACJ,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,WAAW;QACxB,UAAU,EAAE,WAAW;QACvB,gBAAgB,EAAE,GAAG,EAAE,CAAC,SAAS;KAClC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}

package/dist/shared/terminalCommandRun.js

@@ -0,0 +1,56 @@
+export function requireTerminalCommandRun(value, invalidCommandRun) {
+    if (!isRecord(value))
+        throw invalidCommandRun();
+    const status = value["status"];
+    const exitCode = optionalFiniteNumber(value["exitCode"]);
+    const startedAt = optionalString(value["startedAt"]);
+    const completedAt = optionalString(value["completedAt"]);
+    if (typeof value["id"] !== "string"
+        || typeof value["origin"] !== "string"
+        || typeof value["projectId"] !== "string"
+        || typeof value["workspaceId"] !== "string"
+        || typeof value["terminalId"] !== "string"
+        || typeof value["title"] !== "string"
+        || typeof value["command"] !== "string"
+        || (status !== "queued" && status !== "running" && status !== "succeeded" && status !== "failed")
+        || exitCode === invalidOptionalField
+        || typeof value["createdAt"] !== "string"
+        || startedAt === invalidOptionalField
+        || completedAt === invalidOptionalField
+        || !isStringRecord(value["metadata"])) {
+        throw invalidCommandRun();
+    }
+    return {
+        id: value["id"],
+        origin: value["origin"],
+        projectId: value["projectId"],
+        workspaceId: value["workspaceId"],
+        terminalId: value["terminalId"],
+        title: value["title"],
+        command: value["command"],
+        status,
+        ...(exitCode === undefined ? {} : { exitCode }),
+        createdAt: value["createdAt"],
+        ...(startedAt === undefined ? {} : { startedAt }),
+        ...(completedAt === undefined ? {} : { completedAt }),
+        metadata: { ...value["metadata"] },
+    };
+}
+const invalidOptionalField = Symbol("invalid optional Terminal field");
+function optionalFiniteNumber(value) {
+    if (value === undefined)
+        return undefined;
+    return typeof value === "number" && Number.isFinite(value) ? value : invalidOptionalField;
+}
+function optionalString(value) {
+    if (value === undefined)
+        return undefined;
+    return typeof value === "string" ? value : invalidOptionalField;
+}
+function isStringRecord(value) {
+    return isRecord(value) && Object.values(value).every((child) => typeof child === "string");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=terminalCommandRun.js.map

package/dist/shared/terminalCommandRun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalCommandRun.js","sourceRoot":"","sources":["../../src/shared/terminalCommandRun.ts"],"names":[],"mappings":"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"}

package/docs/config.md

@@ -59,7 +59,11 @@ Pi 包由目标机器的 `pi install`、`pi remove`、`pi update` 或 **设置
 
 `defaultTheme` 是网关配置，形如 `{ "themeId": "plugin-id:theme-id", "auto": true }`：`themeId` 必须为限定贡献 ID，`auto` 必须为布尔值。`auto: true` 在该主题有明暗配对时跟随系统明暗，否则使用所选主题。浏览器设备已保存的主题覆盖优先；主题暂不可用时使用回退，不删除原选择。主题属于整个应用，不保存到当前远端机器；保存/刷新配置后生效，无需重启 daemon。
 
-在 **设置 → 通用 → 主题** 中，“在此设备使用”保存浏览器覆盖，“设为默认”保存网关默认且不覆盖已有设备选择，“使用默认值”清除此浏览器覆盖。Auto 只在主题有明暗配对时跟随设备。
+在 **设置 → 通用 → 主题** 中，“在此设备使用”保存浏览器覆盖，“设为默认”保存网关默认且不覆盖已有设备选择，“使用默认值”清除此浏览器覆盖并采用应用默认。设置页的“默认主题”说明与应用的默认选择一致；网关未显式配置 `defaultTheme` 时，也会反映 Custom UI Codex 可用时的隐式默认。读取默认值或清除设备覆盖均不写入网关配置。Auto 只在主题有明暗配对时跟随设备。
+
+内置 **Custom UI Codex** 展示插件默认启用，配置 ID 为 `pi-web.custom-ui-codex`。在网关的插件设置中禁用，或在网关有效机器配置设置 `plugins["pi-web.custom-ui-codex"].enabled: false`，刷新页面后恢复宿主默认布局；中文语言插件与权限模式不受影响，无需重启 daemon。远端机器不能替网关接管整个应用界面。
+
+该插件启用且设备、网关均未显式选择主题时，使用 Paper / Graphite 明暗配对并跟随系统。已有设备或网关主题选择仍优先。主题限定 ID 为 `pi-web.custom-ui-codex:paper`、`pi-web.custom-ui-codex:graphite`；旧的 `themes:paper`、`themes:graphite` 在插件可用时继续解析到对应主题，设置页的名称、选项及保存操作同样识别这些旧 ID。读取和显示不改写原有配置，只有显式保存才使用当前可用主题的限定 ID。插件不可用时按正常主题回退规则显示，保留原选择以便恢复；设置页仍标记原主题不可用，不允许把回退主题当作原选择保存。
 
 网关 `defaultStreamingBehavior` 为 `"steer"`（默认）或 `"followUp"`，决定流式工作期间编辑器的默认发送方式，不改变已在 daemon 中排队的消息。浏览器分区尺寸、编辑器偏好与普通导航顺序不是新的项目配置文件；导航顺序是按机器管理的托管状态，管理模式不共用普通存储。
 
@@ -399,7 +403,7 @@ daemon 日志记录忽略的配置变更与模型列表应用，不输出提供
 
 优先级与 Pi 无交互提示时一致：没有需要信任资源则正常加载；全局扩展 `project_trust` 决定优先，可请求 `remember` 写入 agent `trust.json`；否则已保存决定优先；最后 `defaultProjectTrust` 的 `always` 加载，`never`/`ask` 跳过（没有浏览器运行时信任弹窗）。
 
-添加项目可显式勾选“信任此项目”，不操作不写决定；工作区菜单可切换“已信任”。服务器解析授权工作区路径，远端保存于远端。下次运行时创建/打开读决定，既有运行时不立即重新加载，`/reload` 保留运行时信任状态。项目 auth/model/preferences 存储不迁入 trust；管理嵌入不读取/写入普通信任 API，继续独立授权资源与沙箱。
+添加项目可显式勾选“信任此项目”，不操作不写决定；普通文件夹项目可在项目的“⋯”菜单切换“已信任”，提供器工作区在工作区菜单切换。服务器解析授权工作区路径，远端保存于远端。下次运行时创建/打开读决定，既有运行时不立即重新加载，`/reload` 保留运行时信任状态。项目 auth/model/preferences 存储不迁入 trust；管理嵌入不读取/写入普通信任 API，继续独立授权资源与沙箱。
 
 <a id="session-daemon-tools"></a>
 <a id="session-tools"></a>

package/docs/plugins.md

@@ -21,7 +21,7 @@
 | 添加仪表盘、文件查看器或项目工具 | 工作区面板、文件帮助方法与浏览器 UI |
 | 方便查找常用操作 | 操作面板命令与快捷键 |
 | 运行构建、测试或开发服务器 | 工作区终端命令 |
-| 定制外观 | 主题及明暗主题组合 |
+| 定制外观与界面布局 | 主题、明暗主题组合与网关展示区域 |
 | 在聊天和文件中预览图表、文本格式 | 浏览器内容渲染器 |
 | 读取或修改工作区文件 | 列出、读取、写入、移动、删除及上传文件 |
 | 显示后端实时结果 | 浏览器入口与服务端入口之间的请求或流式通道 |
@@ -76,10 +76,30 @@ v5 `stylesheets` 贡献包含 `id`、HTTP(S) `url` 和可选 `order`（默认 `1
 
 基础主题同步提供默认布局与控件表现，主题 CSS 可扩展配色与布局；基础规则在 `pi-web-base` cascade layer，普通未分层主题规则遵循 CSS cascade 覆盖。内部选择器、共享类和外观仍属实验性，不因能力版本而冻结；具体控件入口见[共享 UI 导航](https://github.com/nayuto-wakusei/pi-web-ChineseTranslation/blob/main/docs/ui-primitives.md)。
 
+宿主锚点弹层支持面板 CSS 变量 `--ui-popup-placement`，可取 `below-end`、`below-start`、`above-start` 或 `left-end`。宿主显式定位选项优先；未指定选项时读取该变量，空值或不支持的值使用默认 `below-end`。样式只选择首选对齐，宿主仍按可见视口约束尺寸并在必要时切换上下方向，继续管理焦点和弹层关闭。
+
 v5 `syntaxHighlighters` 返回有序、不重叠的 UTF-16 范围 token，不返回 HTML；宿主负责安全显示，插件遵守输入 `signal`。v5 内容渲染器还可提供 `title`、同步 `supports(request)`，并接收机器、语言和文件路径提示；正文仍是不可信输入，净化与清理要求不变。精确签名以公开声明为准。
 
 Pi 的 Markdown transformer 链在 daemon 的浏览器投影阶段运行，仅对完成及历史的用户、assistant 文本和 thinking 派生 `displayText`；部分流式文本完成后才应用，文件预览不受影响。canonical 消息、持久化历史、模型输入、审计原文和实际 `thinkingLevel` 不变。“复制消息”和消息操作使用原文；代码围栏的 Raw/Copy 使用变换后的围栏源码。
 
+<a id="ui-presentation"></a>
+### 界面展示区域
+
+浏览器 API v5 的 `uiPresentations` 贡献以 `id`、`region` 和同步 `render(context)` 声明展示区域。插件必须声明 `{ pluginId: "pi-web", id: "ui-presentation", version: 1, parse }` 依赖。展示贡献属于整个网关应用，不接受远端或机器专属注册；每个区域只允许一个所有者，重复贡献会拒绝激活。
+
+| `region` | 宿主提供的命名插槽 |
+| --- | --- |
+| `navigation` | `header`、`machines`、`projects`、`project-resize`、`workspaces`、`workspace-resize`、`sessions` |
+| `context-bar` | `content`、`actions` |
+| `chat-chrome` | `transcript`、`composer` |
+| `settings-navigation` | `navigation` |
+
+`navigation` 贡献可选声明 `navigationLayout: "tree"`，请求宿主将原有列表组合为选中分支树：在选中项目下展开工作区，在选中工作区下展开会话；普通文件夹省略重复的工作区层。其他区域不能声明该字段，不支持的布局值会拒绝激活。树模式采用静态分区标题，由节点展开控件管理分支，不沿用手机独立列表的单层互斥折叠；定向定位工作区或会话时先展开所选祖先。展开和选择由宿主控件处理，数据仍由原有 controller 按当前选择加载；插件不会因此获得未选中分支的会话数据。未声明时保留宿主的独立列表布局与折叠偏好。
+
+渲染器使用 `context.slots` 中的名称输出 `<slot name="...">`，不查找、移动或重建宿主控件。宿主持有编辑器和消息视图的生命周期，界面切换不重建它们；导航列表可随树形与独立布局切换重新装配，操作仍复用宿主菜单、信任入口和权限检查。上下文仅含普通/管理模式、紧凑布局标记及机器、项目、工作区、会话的只读标识和显示名称；可选操作由宿主按权限提供，并在选择或生命周期变化后失效。调用操作时还会核对展示贡献当前是否活动，未重绘前失去活动资格也不能执行保留的回调；界面回退后，旧快照不会因贡献恢复活动而重新生效。它不提供凭据、消息正文、内部路径或普通宿主会话连接，管理视图也不因此获得额外权限。
+
+禁用或缺少展示贡献时使用宿主默认界面，并恢复独立导航列表。展示渲染失败时，宿主停止使用该插件的展示贡献、样式和主题，报告错误并回退；插件仍是可信代码，此机制不是执行沙箱。布局 API 与样式表互补，精确类型以公开 `plugin-api` 声明为准。
+
 ### 应用级面板与选择
 
 `applicationPanels` 与 `workspacePanels` 由同一个浏览器工具区域装配。前者依附当前机器，无需先选项目、工作区或会话；后者需要已选工作区。应用级面板获得当前机器与公开选择快照，`workspace` 和工作区终端按可用性提供。内置 Info 使用应用级面板；无工作区时仍可显示机器和 PI WEB 状态。
@@ -211,6 +231,7 @@ ln -s /path/to/plugin-folder ~/.pi-web/plugins/my-plugin
 <a id="included-tools-and-optional-packages"></a>
 ## 内置工具与可选包
 
+- **Custom UI Codex** 随包提供且默认启用，提供 Codex 风格导航、聊天外围布局、设置导航及明暗主题。它只改变展示，中文语言插件与功能权限保持独立。可在网关的插件设置中禁用并刷新页面，恢复宿主默认界面；浏览器插件变更不要求重启 daemon。
 - **终端**提供终端和命令运行，是普通启动的必需插件，仅紧急安全启动可跳过。
 - **文件**提供文件浏览、预览、上传；禁用面板不移除其他插件的文件帮助方法。
 - **Git**发现工作区并显示状态/差异；禁用后保留项目目录工作区，除非其他提供器认领。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chainingintention/pi-web-cn",
-  "version": "2.202610.2",
+  "version": "2.202610.3",
   "description": "Web UI for persistent Pi Coding Agent sessions in real workspaces.",
   "license": "MIT",
   "author": "Federico Jaramillo Martinez",
@@ -111,7 +111,7 @@
     "marked": "^18.1.1",
     "node-pty": "^1.1.0",
     "pi-web-typebox": "npm:typebox@1.3.37",
-    "undici": "^8.11.2",
+    "undici": "^8.12.2",
     "ws": "^8.22.0",
     "yauzl": "^3.4.0"
   },