pi-one-ui 0.7.0 → 0.7.2

package/CHANGELOG.md

@@ -6,6 +6,45 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.7.2] - 2026-09-28
+
+### Changed
+
+- The Editor completion dropdown now paints the selected row with the editor frame color, so the selection follows the same static/adaptive thinking-level chain as the frame border while unselected rows keep Pi's native styling.
+
+### Fixed
+
+- Keep the pending tool loading animation alive during long-running commands: the updateDisplay render cache now rebuilds pending tool rows so each animation tick re-enters the renderer, preventing the spinner from freezing while a command is still executing.
+
+### Migration
+
+- No configuration migration is required. Existing canonical v1 files and command names remain supported.
+- For an unpinned npm installation, run `pi update npm:pi-one-ui`; for an existing version pin, run `pi install npm:pi-one-ui@0.7.2`. Fully exit and restart Pi after updating the package.
+
+## [0.7.1] - 2026-09-21
+
+### Changed
+
+- Centralize component composition, settings application, and session lifecycle management in app, with settings and Context Inspector views owned by Overlay Layout.
+- Apply presets with one canonical configuration write and update every affected Layout. Component settings, including Header visibility, apply through their owning Layout; Feature registration switches still require `/reload`.
+- Report corrupt or unreadable configuration files during loading, and distinguish a failed save from a saved configuration that could not be applied to the UI.
+- Coalesce shared Layout redraw requests while preserving forced redraws and session ownership.
+
+### Fixed
+
+- Close managed overlays and input listeners during session replacement, and prevent Context Inspector from reopening a preview's parent window in an ended session.
+
+### Migration
+
+- No configuration migration is required. Existing canonical v1 files and command names remain supported.
+- For an unpinned npm installation, run `pi update npm:pi-one-ui`; for an existing version pin, run `pi install npm:pi-one-ui@0.7.1`. Fully exit and restart Pi after updating the package.
+
+### Release verification
+
+- Release source: [`e4451a2`](https://github.com/kerolt/pi-one-ui/commit/e4451a244838550f0914469bd8ff5ddbaebc1f8f). [CI](https://github.com/kerolt/pi-one-ui/actions/runs/35567977181) and [Publish](https://github.com/kerolt/pi-one-ui/actions/runs/35567977360) completed successfully; local and CI `npm run verify` passed 1,176 tests across 69 files, and `npm run pack:check` confirmed 124 package files.
+- Real Pi regular/fullscreen TUI probes passed, covering settings, Context Inspector, Editor input and focus, presets, reload, session tree, compaction, session replacement, input listeners, and third-party Editor ownership. User-specific terminal, theme, and extension combinations still require manual verification.
+- At publication, npm `latest` resolved to `0.7.1` with the matching release `gitHead` and package SHA-1 `0252f3b21190f56170a96ff8c3a2a1e8df74874f`. The [provenance statement](https://registry.npmjs.org/-/npm/v1/attestations/pi-one-ui@0.7.1) was published at [Sigstore log index 2905054424](https://search.sigstore.dev/?logIndex=2905054424).
+
 ## [0.7.0] - 2026-09-13
 
 ### Added
@@ -21,6 +60,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 - No configuration migration is required. Existing configurations keep showing the Editor directory; set `components.editor.styles.minimalist.showCwd` to `false` only if you want to hide it. Footer directory settings remain independent.
 - For an unpinned npm installation, run `pi update npm:pi-one-ui`; for an existing version pin, run `pi install npm:pi-one-ui@0.7.0`. Fully exit and restart Pi after updating the package. Subsequent JSON configuration edits can be applied with `/reload`.
 
+### Release verification
+
+- Release source: [`10ac3de`](https://github.com/kerolt/pi-one-ui/commit/10ac3dea3f0ac804fef94cbeea937c6f1ae0d347). [CI](https://github.com/kerolt/pi-one-ui/actions/runs/34740987283) and [Publish](https://github.com/kerolt/pi-one-ui/actions/runs/34741047850) completed successfully; `npm run verify` passed 1,165 tests and `npm run pack:check` confirmed 121 package files.
+- At publication, npm `latest` resolved to `0.7.0` with the matching release `gitHead` and [provenance metadata](https://registry.npmjs.org/-/npm/v1/attestations/pi-one-ui@0.7.0). The provenance statement was published at [Sigstore log index 2814335389](https://search.sigstore.dev/?logIndex=2814335389).
+
 ## [0.6.1] - 2026-09-06
 
 ### Added
@@ -130,7 +174,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 - Reduced rendering lag when expanding settled tool groups by reusing cached child output.
 
-[Unreleased]: https://github.com/kerolt/pi-one-ui/compare/v0.7.0...HEAD
+[Unreleased]: https://github.com/kerolt/pi-one-ui/compare/v0.7.2...HEAD
+[0.7.2]: https://github.com/kerolt/pi-one-ui/compare/v0.7.1...v0.7.2
+[0.7.1]: https://github.com/kerolt/pi-one-ui/compare/v0.7.0...v0.7.1
 [0.7.0]: https://github.com/kerolt/pi-one-ui/compare/v0.6.1...v0.7.0
 [0.6.1]: https://github.com/kerolt/pi-one-ui/compare/v0.6.0...v0.6.1
 [0.6.0]: https://github.com/kerolt/pi-one-ui/compare/v0.5.1...v0.6.0

package/README.en.md

@@ -76,9 +76,11 @@ Then open the unified settings panel:
 /oneui
 ```
 
-### Upgrading to 0.7.0
+### Upgrading to 0.7.2
 
-This release adds an Editor working-directory visibility switch and fixes invisible input after changing Editor settings and closing `/oneui`. Existing configurations need no migration; the directory remains visible by default.
+This release paints the Editor completion dropdown selection with the editor frame color so it follows the adaptive thinking-level chain, and keeps the tool loading animation alive during long-running commands.
+
+Existing canonical v1 configurations and commands remain compatible; no migration is required.
 
 For an unpinned npm installation, run:
 
@@ -86,9 +88,7 @@ For an unpinned npm installation, run:
 pi update npm:pi-one-ui
 ```
 
-If your installation pins a version, run `pi install npm:pi-one-ui@0.7.0` to update the pin. Fully exit and restart Pi after updating the package.
-
-To hide the Editor directory, set `components.editor.styles.minimalist.showCwd: false`; Footer directory visibility is configured independently. See the complete example in the [configuration guide](./docs/configuration.md#隐藏-editor-目录在-footer-左侧显示).
+If your installation pins a version, run `pi install npm:pi-one-ui@0.7.2` to update the pin. Fully exit and restart Pi after updating the package.
 
 ## Configuration
 
@@ -102,9 +102,11 @@ To hide the Editor directory, set `components.editor.styles.minimalist.showCwd:
 
 You can configure the extension in two ways:
 
-1. **Interactive settings panel (recommended)**: Run `/oneui` in Pi to adjust common component toggles, styles, and border modes via a visual menu. Changes take effect immediately and are persisted automatically.
+1. **Interactive settings panel (recommended)**: Run `/oneui` in Pi to adjust component toggles, styles, and border modes. Component settings apply after saving; Features switches apply after `/reload`. Each preset saves all related settings in one update and applies them to the corresponding components.
 2. **Direct JSON editing**: Advanced users can edit the JSON configuration file directly for finer-grained control. After saving edits, run `/reload` in Pi to apply changes. When the file does not exist, safe runtime defaults are used in memory.
 
+Corrupt or unreadable configuration files produce an error. Failed saves retain the current settings; if saving succeeds but a component cannot apply the change, the panel reports the application failure explicitly.
+
 ### Basic configuration example
 
 Below is a typical v1 configuration structure:
@@ -156,7 +158,7 @@ To keep the configuration section clean and focused, in-depth options, template
   - Saved changes apply the next time `/oneui` opens; no `/reload` needed.
 - **Color system & theme customization**: see [Editor Colors Reference (docs/editor-colors.md)](./docs/editor-colors.md)
   - All colors resolve through unified theme semantics. Configured `colors.*` values resolve as theme tokens (adapting automatically across themes), while ANSI names map to semantic tokens (e.g. `red` to `error`). Fixed terminal colors can be specified using hex codes, 256-color indexes, or `fg:`/`bg:` prefixes.
-  - Full support for adaptive thinking-effort border colors (from Low to Max) and labels.
+  - Full support for adaptive thinking-effort border colors (from Low to Max) and labels. The completion menu selection shares the editor frame color and follows the same chain.
 - **Migration from legacy versions**: Field cleanups from 0.5.x/0.6.0 (such as merging `opencode` into `minimalist`, or removing `colorSource`) are covered in [docs/configuration.md: Changes and Migration](./docs/configuration.md#6-变更与迁移).
 
 ## Upstream origins and project evolution
@@ -230,6 +232,17 @@ npm run verify
 npm run pack:check
 ```
 
+### Source responsibilities
+
+- `extensions/app/runtime/`: composition, shared events, session lifecycle, render scheduling, and patch management.
+- `extensions/app/config/`: configuration types, normalization, and shared storage.
+- `extensions/app/settings/`: settings operations, presets, and the `/oneui` opening flow.
+- `extensions/app/overlay/`: overlay lifecycle, focus coordination, and input routing.
+- `extensions/layouts/`: component behavior and rendering; settings, Context Inspector, and Selector views live in `layouts/overlay/`.
+- `extensions/features/` and `extensions/services/`: features and shared data, composed by app.
+
+See [ARCHITECTURE.md](./ARCHITECTURE.md) for module rules and real Pi TUI verification commands.
+
 ### Test organization
 
 All tests run through Vitest and are organized into domain directories:

package/README.md

@@ -76,9 +76,11 @@ pi install git:github.com/kerolt/pi-one-ui
 /oneui
 ```
 
-### 升级到 0.7.0
+### 升级到 0.7.2
 
-本次新增 Editor 工作目录显示开关，并修复修改 Editor 配置后关闭 `/oneui` 导致输入不可见的问题。现有配置无需迁移，工作目录仍默认显示。
+本次统一编辑器补全下拉选中项与编辑器外框的颜色，选中项随 thinking 档位自适应变化；同时修复长时间命令执行期间工具加载动画停止刷新的问题。
+
+现有 canonical v1 配置和命令保持兼容，无需迁移。
 
 未固定版本的 npm 安装可执行：
 
@@ -86,9 +88,7 @@ pi install git:github.com/kerolt/pi-one-ui
 pi update npm:pi-one-ui
 ```
 
-若安装时固定了版本，执行 `pi install npm:pi-one-ui@0.7.0` 更新版本指定。更新安装包后，完整退出并重启 Pi。
-
-如需隐藏 Editor 目录，设置 `components.editor.styles.minimalist.showCwd: false`；Footer 中的目录显示独立配置。完整示例见 [配置指南](./docs/configuration.md#隐藏-editor-目录在-footer-左侧显示)。
+若安装时固定了版本，执行 `pi install npm:pi-one-ui@0.7.2` 更新版本指定。更新安装包后，完整退出并重启 Pi。
 
 ## 配置
 
@@ -102,9 +102,11 @@ pi update npm:pi-one-ui
 
 提供两种配置途径：
 
-1. **交互式设置面板（推荐）**：在 Pi 会话中运行 `/oneui`，即可在可视化面板中即时调整常用组件开关、样式和边框模式。修改即刻生效并自动持久化。
+1. **交互式设置面板（推荐）**：在 Pi 会话中运行 `/oneui`，即可调整常用组件开关、样式和边框模式。组件设置保存后即时应用；Features 开关在 `/reload` 后应用。Preset 一次保存全部相关设置并更新对应组件。
 2. **手动编辑配置文件**：高级用户可直接编辑 JSON 配置文件以启用更多细粒度选项。修改保存后，在 Pi 中执行 `/reload` 即可生效。文件不存在时将直接使用内置默认值。
 
+配置文件损坏或无法读取时会报告错误。保存失败时保持当前设置；保存成功但组件应用失败时，面板会明确提示应用失败。
+
 ### 基础配置示例
 
 以下为一个典型的 v1 配置文件结构：
@@ -156,7 +158,7 @@ pi update npm:pi-one-ui
   - 修改保存后下次打开 `/oneui` 即生效，无需 `/reload`。
 - **颜色体系与主题定制**：详见 [Editor 颜色配置说明 (docs/editor-colors.md)](./docs/editor-colors.md)
   - 所有颜色统一按 Theme 语义解释，优先解析为当前主题语义 Token（随主题自动切换），ANSI 色名自动映射为语义色（如 `red` 对应 `error`）；如需固定色彩，可直接指定 Hex、256 色索引或 `fg:`/`bg:` 前缀。
-  - 支持完整的 Thinking 思考档位（Low 至 Max）自适应边框与标签分级配色。
+  - 支持完整的 Thinking 思考档位（Low 至 Max）自适应边框与标签分级配色，补全下拉选中项与编辑器外框同色，跟随同一条颜色链。
 - **历史版本迁移**：旧版升级带来的字段收敛（如 `opencode` 样式统一合并入 `minimalist`、`colorSource` 双模式移除等）参见 [docs/configuration.md 变更与迁移节](./docs/configuration.md#6-变更与迁移)。
 
 ## 上游来源与项目演进
@@ -230,6 +232,17 @@ npm run verify
 npm run pack:check
 ```
 
+### 源码职责
+
+- `extensions/app/runtime/`：装配、共享事件、session 生命周期、渲染调度和 patch 管理。
+- `extensions/app/config/`：配置类型、规范化和统一存储。
+- `extensions/app/settings/`：设置操作、Preset 与 `/oneui` 打开流程。
+- `extensions/app/overlay/`：Overlay 生命周期、焦点协作和输入路由。
+- `extensions/layouts/`：组件行为与渲染；设置面板、Context Inspector 和 Selector 视图位于 `layouts/overlay/`。
+- `extensions/features/`、`extensions/services/`：功能实现与共享数据，由 app 统一组织。
+
+模块约束和真实 Pi TUI 验证命令见 [ARCHITECTURE.md](./ARCHITECTURE.md)。
+
 ### 测试组织
 
 所有测试统一由 Vitest 执行，并按照功能领域组织在子目录中：

package/extensions/app/config/context.ts

@@ -0,0 +1,42 @@
+import { booleanValue, recordValue } from "./values.ts";
+
+export type UserMessageStyle =
+  | "framed"
+  | "framed-copy-friendly"
+  | "compact"
+  | "labeled";
+export type FramedUserMessageStyleConfig = Record<string, never>;
+export type FramedCopyFriendlyUserMessageStyleConfig = Record<string, never>;
+export type CompactUserMessageStyleConfig = Record<string, never>;
+export type LabeledUserMessageStyleConfig = Record<string, never>;
+export type UserMessagesComponentConfig = {
+  enabled: boolean;
+  style: UserMessageStyle;
+  styles: {
+    framed: FramedUserMessageStyleConfig;
+    "framed-copy-friendly": FramedCopyFriendlyUserMessageStyleConfig;
+    compact: CompactUserMessageStyleConfig;
+    labeled: LabeledUserMessageStyleConfig;
+  };
+};
+
+export function normalizeUserMessages(
+  value: unknown,
+): UserMessagesComponentConfig {
+  const source = recordValue(value);
+  return {
+    enabled: booleanValue(source.enabled, true),
+    style:
+      source.style === "framed-copy-friendly" ||
+      source.style === "compact" ||
+      source.style === "labeled"
+        ? source.style
+        : "framed",
+    styles: {
+      framed: {},
+      "framed-copy-friendly": {},
+      compact: {},
+      labeled: {},
+    },
+  };
+}

package/extensions/app/config/editor.ts

@@ -0,0 +1,80 @@
+import { booleanValue, recordValue } from "./values.ts";
+
+export type ModelLabelSource = "id" | "name";
+export type EditorStyle = "on" | "off";
+export type EditorBorderColorMode = "static" | "adaptive";
+export type MinimalistPathDisplayMode = "compact" | "project" | "full";
+export type MinimalistEditorStyleConfig = {
+  pathDisplay: MinimalistPathDisplayMode;
+  showCwd: boolean;
+  showSessionName: boolean;
+  showTimer: boolean;
+  showCost: boolean;
+  showGit: boolean;
+};
+export type MinimalistConfig = MinimalistEditorStyleConfig;
+export type EditorStylesConfig = { minimalist: MinimalistEditorStyleConfig };
+export type EditorComponentConfig = {
+  style: EditorStyle;
+  borderColorMode: EditorBorderColorMode;
+  modelLabel: ModelLabelSource;
+  viewportIndicators: boolean;
+  styles: EditorStylesConfig;
+};
+
+export const DEFAULT_EDITOR_METADATA_FORMAT = "$model  $provider(  $thinking)";
+export const defaultMinimalistStyle: MinimalistEditorStyleConfig = {
+  pathDisplay: "compact",
+  showCwd: true,
+  showSessionName: true,
+  showTimer: true,
+  showCost: true,
+  showGit: true,
+};
+export const defaultEditor: EditorComponentConfig = {
+  style: "on",
+  borderColorMode: "static",
+  modelLabel: "id",
+  viewportIndicators: true,
+  styles: { minimalist: defaultMinimalistStyle },
+};
+
+export function parseEditorModelLabel(value: unknown): ModelLabelSource {
+  return value === "name" ? "name" : "id";
+}
+
+export function parseEditorStyle(value: unknown): EditorStyle {
+  return value === "off" ? "off" : "on";
+}
+
+export function parseEditorBorderColorMode(
+  value: unknown,
+): EditorBorderColorMode {
+  return value === "adaptive" ? "adaptive" : "static";
+}
+
+/** 配置规范化仅生成 canonical 字段。 */
+export function normalizeEditor(value: unknown): EditorComponentConfig {
+  const editor = recordValue(value);
+  const minimalist = recordValue(recordValue(editor.styles).minimalist);
+  return {
+    style: editor.enabled === false ? "off" : parseEditorStyle(editor.style),
+    borderColorMode: parseEditorBorderColorMode(editor.borderColorMode),
+    modelLabel: parseEditorModelLabel(editor.modelLabel),
+    viewportIndicators: booleanValue(editor.viewportIndicators, true),
+    styles: {
+      minimalist: {
+        pathDisplay:
+          minimalist.pathDisplay === "project" ||
+          minimalist.pathDisplay === "full"
+            ? minimalist.pathDisplay
+            : "compact",
+        showCwd: booleanValue(minimalist.showCwd, true),
+        showSessionName: booleanValue(minimalist.showSessionName, true),
+        showTimer: booleanValue(minimalist.showTimer, true),
+        showCost: booleanValue(minimalist.showCost, true),
+        showGit: booleanValue(minimalist.showGit, true),
+      },
+    },
+  };
+}

package/extensions/app/config/footer.ts

@@ -0,0 +1,291 @@
+import { type ModelLabelSource, parseEditorModelLabel } from "./editor.ts";
+import { booleanValue, recordValue } from "./values.ts";
+
+export type ContextStyle = "text" | "gauge" | "text+gauge";
+export type SeparatorStyle = "pipe" | "dot" | "chevron" | "none";
+export type FooterStyle = "native" | "starship" | "hidden";
+export type CompactFooterMaxLines = 1 | 2 | 3 | "unlimited";
+export type ContextThresholds = { warning: number; error: number };
+export type PathDisplayMode = "basename" | "full";
+export type PathDisplayConfig = { mode: PathDisplayMode; depth: number };
+export type GitBranchMaxLength = "full" | number;
+export type GitBranchConfig = { maxLength: GitBranchMaxLength };
+export type GitCommitConfig = {
+  hashLength: number;
+  onlyDetached: boolean;
+  showTag: boolean;
+};
+export type GitMetricsConfig = {
+  onlyNonzero: boolean;
+  ignoreSubmodules: boolean;
+};
+export type ExtensionStatusPlacement = "off" | "left" | "middle" | "right";
+export type ExtensionStatusColorMode = "zentui" | "original";
+export type ExtensionStatusesConfig = {
+  defaultPlacement: ExtensionStatusPlacement;
+  placements: Record<string, ExtensionStatusPlacement>;
+  colorModes: Record<string, ExtensionStatusColorMode>;
+};
+export type FooterSegmentsConfig = {
+  cwd: boolean;
+  sessionName: boolean;
+  gitBranch: boolean;
+  gitStatus: boolean;
+  gitCounts: boolean;
+  gitCommit: boolean;
+  gitMetrics: boolean;
+  runtime: boolean;
+  modelInfo: boolean;
+  context: boolean;
+  tokens: boolean;
+  cost: boolean;
+  sessionDuration: boolean;
+  username: boolean;
+  time: boolean;
+  os: boolean;
+  packageVersion: boolean;
+};
+export type StarshipFooterStyleConfig = {
+  format: string;
+  responsive: boolean;
+  compactFormat: string;
+  compactMaxLines: CompactFooterMaxLines;
+  separator: SeparatorStyle;
+  contextStyle: ContextStyle;
+  contextThresholds: ContextThresholds;
+  pathDisplay: PathDisplayConfig;
+  segments: FooterSegmentsConfig;
+  gitBranch: GitBranchConfig;
+  gitCommit: GitCommitConfig;
+  gitMetrics: GitMetricsConfig;
+  extensionStatuses: ExtensionStatusesConfig;
+};
+export type FooterComponentConfig = {
+  style: FooterStyle;
+  modelLabel: ModelLabelSource;
+  styles: { starship: StarshipFooterStyleConfig };
+};
+
+export const DEFAULT_COMPACT_FOOTER_FORMAT =
+  "$cwd$wrap(in $session_name)$wrap(on $git_branch) $git_status$wrap$context$wrap_sep$tokens";
+export const FOOTER_FORMAT_VARIABLES = [
+  "cwd",
+  "session_name",
+  "git_branch",
+  "git_status",
+  "git_state",
+  "runtime",
+  "model",
+  "provider",
+  "session_duration",
+  "username",
+  "os",
+  "time",
+  "context",
+  "tokens",
+  "cache_read",
+  "cache_write",
+  "cost",
+  "subscription",
+  "auto_compaction",
+  "package",
+  "package_version",
+  "git_commit",
+  "git_tag",
+  "git_metrics",
+  "git_added",
+  "git_deleted",
+  "sep",
+] as const;
+export const FOOTER_FORMAT_ALIASES: Record<string, string> = {
+  directory: "cwd",
+  branch: "git_branch",
+  status: "git_status",
+  state: "git_state",
+  commit: "git_commit",
+  tag: "git_tag",
+  duration: "session_duration",
+  separator: "sep",
+};
+export const defaultFooterSegments: FooterSegmentsConfig = {
+  cwd: true,
+  sessionName: true,
+  gitBranch: true,
+  gitStatus: true,
+  gitCounts: false,
+  gitCommit: false,
+  gitMetrics: false,
+  runtime: true,
+  modelInfo: false,
+  context: true,
+  tokens: true,
+  cost: true,
+  sessionDuration: false,
+  username: false,
+  time: false,
+  os: false,
+  packageVersion: false,
+};
+export const defaultStarshipStyle: StarshipFooterStyleConfig = {
+  format: "",
+  responsive: true,
+  compactFormat: DEFAULT_COMPACT_FOOTER_FORMAT,
+  compactMaxLines: 2,
+  separator: "pipe",
+  contextStyle: "text",
+  contextThresholds: { warning: 70, error: 90 },
+  pathDisplay: { mode: "basename", depth: 0 },
+  segments: defaultFooterSegments,
+  gitBranch: { maxLength: "full" },
+  gitCommit: { hashLength: 7, onlyDetached: true, showTag: true },
+  gitMetrics: { onlyNonzero: true, ignoreSubmodules: false },
+  extensionStatuses: {
+    defaultPlacement: "right",
+    placements: {},
+    colorModes: {},
+  },
+};
+export const defaultFooter: FooterComponentConfig = {
+  style: "starship",
+  modelLabel: "id",
+  styles: { starship: defaultStarshipStyle },
+};
+
+export function isSeparatorStyle(value: unknown): value is SeparatorStyle {
+  return (
+    value === "pipe" ||
+    value === "dot" ||
+    value === "chevron" ||
+    value === "none"
+  );
+}
+export function parseSeparatorStyle(value: unknown): SeparatorStyle {
+  return isSeparatorStyle(value) ? value : "pipe";
+}
+export function parseContextStyle(value: unknown): ContextStyle {
+  return value === "gauge" || value === "text+gauge" ? value : "text";
+}
+export function parseCompactFooterMaxLines(
+  value: unknown,
+): CompactFooterMaxLines {
+  return value === 1 || value === 2 || value === 3 || value === "unlimited"
+    ? value
+    : 2;
+}
+export function isExtensionStatusPlacement(
+  value: unknown,
+): value is ExtensionStatusPlacement {
+  return (
+    value === "off" ||
+    value === "left" ||
+    value === "middle" ||
+    value === "right"
+  );
+}
+export function isExtensionStatusColorMode(
+  value: unknown,
+): value is ExtensionStatusColorMode {
+  return value === "zentui" || value === "original";
+}
+
+function thresholds(value: unknown): ContextThresholds {
+  const source = recordValue(value);
+  const percent = (input: unknown, defaultValue: number) =>
+    typeof input === "number" && Number.isFinite(input)
+      ? Math.max(0, Math.min(100, Math.round(input)))
+      : defaultValue;
+  const warning = percent(source.warning, 70);
+  const error = percent(source.error, 90);
+  return { warning: Math.min(warning, error), error: Math.max(warning, error) };
+}
+
+/** 每个 Footer 字段独立规范化，返回完整的 canonical 配置。 */
+export function normalizeFooter(value: unknown): FooterComponentConfig {
+  const footer = recordValue(value);
+  const source = recordValue(recordValue(footer.styles).starship);
+  const path = recordValue(source.pathDisplay);
+  const branch = recordValue(source.gitBranch);
+  const commit = recordValue(source.gitCommit);
+  const metrics = recordValue(source.gitMetrics);
+  const statuses = recordValue(source.extensionStatuses);
+  const segments = recordValue(source.segments);
+  const hashLength =
+    typeof commit.hashLength === "number"
+      ? commit.hashLength
+      : Number(commit.hashLength);
+  return {
+    style:
+      footer.style === "native" || footer.style === "hidden"
+        ? footer.style
+        : "starship",
+    modelLabel: parseEditorModelLabel(footer.modelLabel),
+    styles: {
+      starship: {
+        format: typeof source.format === "string" ? source.format : "",
+        responsive: booleanValue(source.responsive, true),
+        compactFormat:
+          typeof source.compactFormat === "string" &&
+          source.compactFormat.length > 0
+            ? source.compactFormat
+            : DEFAULT_COMPACT_FOOTER_FORMAT,
+        compactMaxLines: parseCompactFooterMaxLines(source.compactMaxLines),
+        separator: parseSeparatorStyle(source.separator),
+        contextStyle: parseContextStyle(source.contextStyle),
+        contextThresholds: thresholds(source.contextThresholds),
+        pathDisplay: {
+          mode: path.mode === "full" ? "full" : "basename",
+          depth:
+            typeof path.depth === "number" &&
+            Number.isFinite(path.depth) &&
+            path.depth >= 0
+              ? Math.min(5, Math.floor(path.depth))
+              : 0,
+        },
+        segments: Object.fromEntries(
+          Object.entries(defaultFooterSegments).map(([key, enabled]) => [
+            key,
+            booleanValue(segments[key], enabled),
+          ]),
+        ) as FooterSegmentsConfig,
+        gitBranch: {
+          maxLength:
+            typeof branch.maxLength === "number" &&
+            Number.isInteger(branch.maxLength) &&
+            branch.maxLength > 0
+              ? branch.maxLength
+              : "full",
+        },
+        gitCommit: {
+          hashLength: Number.isFinite(hashLength)
+            ? Math.min(40, Math.max(4, Math.round(hashLength)))
+            : 7,
+          onlyDetached: booleanValue(commit.onlyDetached, true),
+          showTag: booleanValue(commit.showTag, true),
+        },
+        gitMetrics: {
+          onlyNonzero: booleanValue(metrics.onlyNonzero, true),
+          ignoreSubmodules: booleanValue(metrics.ignoreSubmodules, false),
+        },
+        extensionStatuses: {
+          defaultPlacement: isExtensionStatusPlacement(
+            statuses.defaultPlacement,
+          )
+            ? statuses.defaultPlacement
+            : "right",
+          placements: Object.fromEntries(
+            Object.entries(recordValue(statuses.placements)).filter(
+              (entry): entry is [string, ExtensionStatusPlacement] =>
+                isExtensionStatusPlacement(entry[1]),
+            ),
+          ),
+          colorModes: Object.fromEntries(
+            Object.entries(recordValue(statuses.colorModes)).filter(
+              (entry): entry is [string, ExtensionStatusColorMode] =>
+                isExtensionStatusColorMode(entry[1]),
+            ),
+          ),
+        },
+      },
+    },
+  };
+}

package/extensions/app/config/panel.ts

@@ -109,9 +109,5 @@ export function normalizePanelOverlay(input: unknown): PanelOverlayConfig {
  * every /oneui open so JSON edits apply without `/reload`.
  */
 export function loadPanelOverlayConfig(): PanelOverlayConfig {
-  try {
-    return normalizePanelOverlay(configStore.read().panel);
-  } catch {
-    return normalizePanelOverlay(undefined);
-  }
+  return normalizePanelOverlay(configStore.read().panel);
 }

package/extensions/app/config/renderer.ts

@@ -364,12 +364,7 @@ export const config: Config = loadConfig();
  * Loads and normalizes the renderer projection from the shared store.
  */
 function loadConfig(): Config {
-  try {
-    return normalizeConfig(rendererConfigFrom(configStore.read()));
-  } catch {
-    // Ignore bad config and fall back to defaults.
-  }
-  return { ...DEFAULT_CONFIG };
+  return normalizeConfig(rendererConfigFrom(configStore.read()));
 }
 
 /**