pi-one-ui 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 minuque
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,106 @@
+# pi-one-ui
+
+`pi-one-ui` 是一个单一 Pi 插件包，将两个 UI 扩展合并为一个可自定义的源码仓库：
+
+- **Zentui**：Editor、User message、Working line、Selector border、Footer
+- **CC Style**：Tool renderer、Rich diff、Thinking、Compact transcript、鼠标交互和辅助功能
+
+安装后只需要启用这个包，不需要再单独安装 `pi-zentui` 或 `pi-cc-extensions`。
+
+## 安装
+
+```bash
+pi install /path/to/pi-one-ui
+# 或安装远程仓库
+pi install git:github.com/<your-account>/pi-one-ui
+```
+
+安装后执行 `/reload`。
+
+## 统一入口
+
+```text
+/oneui
+```
+
+`/oneui` 是唯一的公开管理命令，执行后直接打开融合后的交互面板。面板按 `Tab` / `Shift+Tab` 切换 Shell、Renderer、Features、Presets 分区。Shell 分区会显示 Editor 和 User Message 的实时样式预览；修改会立即写入统一配置，活动会话支持的样式也会自动重绘。
+
+```text
+~/.pi/agent/pi-one-ui.json
+```
+
+面板中的详细配置仍可直接编辑 JSON，以便开发自定义字段。
+
+## 配置结构
+
+Zentui 的配置保留在 JSON 根级，CC Style 的配置放在 `renderer` 下：
+
+```json
+{
+  "version": 1,
+  "components": {
+    "editor": { "enabled": true, "style": "accent-rail" },
+    "userMessages": { "enabled": true, "style": "framed" },
+    "workingLine": { "enabled": true },
+    "footer": { "style": "starship" }
+  },
+  "renderer": {
+    "mode": "on",
+    "diffViewMode": "auto",
+    "enableWorkingMessage": false
+  }
+}
+```
+
+完整字段可参考上游快照：
+
+- `vendor/pi-zentui/docs/configuration.md`
+- `vendor/pi-cc-extensions/README.md`
+
+Working line 的 owner 固定为 Zentui，因此默认关闭 CC Style 的 `enableWorkingMessage`，避免两个扩展争抢 Pi 的无 key working row。
+
+## 来源与目录结构
+
+本项目基于以下上游项目进行融合开发：
+
+- `pi-zentui`：提供 Shell chrome、Editor、Footer、Working line 等能力
+- `pi-cc-extensions`：提供 Tool renderer、Diff、Thinking 和 Transcript 能力
+
+上游源码快照保存在 `vendor/` 中，仅用于追踪和同步。`extensions/` 按 `pi-one-ui` 的产品能力组织，不保留上游项目的目录结构：
+
+```text
+extensions/
+  index.ts                 # 唯一公开入口和 /oneui 命令
+  app/                     # 统一配置、面板、预设和应用装配
+  shell/                  # Editor、Footer、Working line 等终端外壳能力
+  transcript/             # Tool、Diff、Thinking 和消息渲染
+  features/               # Context、Session reference、Agent summary 等功能
+  tools/                  # Patch、ANSI、组件树和其他底层能力
+vendor/                    # 上游只读参考快照和版本记录
+```
+
+公共入口只有 `/oneui`。Shell 和 Transcript 的内部 owner 由应用装配层统一管理，避免不同模块争抢同一个 Pi UI 接缝。
+
+## 开发
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run pack:check
+```
+
+`npm test` 会同时运行：
+
+- `node:test`：Transcript、工具渲染和融合入口测试
+- `Vitest`：Shell 及其生命周期、布局和配置测试
+
+测试文件按产品能力命名为 `tests/shell-*`、`tests/transcript-*` 和 `tests/one-ui-*`。
+
+本地启动：
+
+```bash
+npm run pi:dev
+```
+
+上游快照版本记录在 `ARCHITECTURE.md`。更新上游时，先在 `vendor/` 中获取新快照，再将对应源码同步到 `extensions/`，不要直接修改 vendor 参考目录。

package/extensions/app/config/renderer.ts

@@ -0,0 +1,452 @@
+import type { CompactThinkingConfig } from "../../features/compact-thinking.ts";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+export type CompactStyleMode = "on" | "compact" | "off";
+
+// ── diff 显示配置：作为配置 schema 的一部分由 config 层拥有 ──
+// renderer（diff）从 config 导入并 re-export，避免 config → renderer 的反向依赖。
+
+export type DiffViewMode = "auto" | "split" | "unified";
+export type DiffIndicatorMode = "bars" | "classic" | "none";
+
+export interface ToolDisplayConfig {
+  diffViewMode: DiffViewMode;
+  diffIndicatorMode: DiffIndicatorMode;
+  diffSplitMinWidth: number;
+  editDiffCollapsedLines: number;
+  /** Write-only collapsed body lines. 0 = `↳ created • click to show more`. */
+  writeDiffCollapsedLines: number;
+  diffWordWrap: boolean;
+  expandedPreviewMaxLines: number;
+}
+
+export const DEFAULT_TOOL_DISPLAY_CONFIG: ToolDisplayConfig = {
+  diffViewMode: "auto",
+  diffIndicatorMode: "bars",
+  diffSplitMinWidth: 120,
+  /** Collapsed edit/diff body: ~half a typical terminal after chrome. */
+  editDiffCollapsedLines: 24,
+  /**
+   * Write create/overwrite collapsed body.
+   * 0 = `↳ created • click to show more` (stats stay on the title).
+   */
+  writeDiffCollapsedLines: 0,
+  diffWordWrap: true,
+  /**
+   * Expanded tool/diff body cap. 40 ≈ one screen of content after title,
+   * Input section, editor, and status — keeps the TUI compact.
+   * Raise via /ccstyle → Diff → Expanded max lines when reviewing large dumps.
+   */
+  expandedPreviewMaxLines: 40,
+};
+
+export type Config = {
+  mode: CompactStyleMode;
+  excludeRenderers: string[];
+  diffViewMode: DiffViewMode;
+  diffIndicatorMode: DiffIndicatorMode;
+  diffSplitMinWidth: number;
+  editDiffCollapsedLines: number;
+  writeDiffCollapsedLines: number;
+  diffWordWrap: boolean;
+  expandedPreviewMaxLines: number;
+  toolInputNameLength: number;
+  useSummaryTitlesAsThinkingTitle: boolean;
+  previewLines: number;
+  animationIntervalMs: number;
+  dimThinkingText: boolean;
+  showStartupHeader: boolean;
+  scrollStepLines: number;
+  enableSessionReference: boolean;
+  enableSubagentAutocomplete: boolean;
+  enableContextCommand: boolean;
+  enableAgentSummary: boolean;
+  enableWorkingMessage: boolean;
+  enableAliases: boolean;
+};
+
+const AGENT_DIR =
+  process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
+const CONFIG_PATH = join(AGENT_DIR, "pi-one-ui.json");
+const LEGACY_UNIFIED_CONFIG_PATH = join(AGENT_DIR, "pi-mine-ui.json");
+const LEGACY_CONFIG_PATH = join(AGENT_DIR, "claude-code-style.json");
+const LEGACY_ZENTUI_CONFIG_PATH = join(AGENT_DIR, "zentui.json");
+
+type ConfigRecord = Record<string, unknown>;
+
+function readJson(path: string): ConfigRecord | undefined {
+  try {
+    if (!existsSync(path)) return undefined;
+    const value = JSON.parse(readFileSync(path, "utf8"));
+    return value && typeof value === "object" && !Array.isArray(value)
+      ? (value as ConfigRecord)
+      : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+/**
+ * Keep the two upstream configuration schemas under one portable file. Zentui
+ * owns the root fields; the CC renderer owns `renderer`. Existing installations
+ * are imported once without deleting their legacy files.
+ */
+function readUnifiedConfig(): ConfigRecord {
+  const current = readJson(CONFIG_PATH) ?? readJson(LEGACY_UNIFIED_CONFIG_PATH);
+  if (current) {
+    if (!existsSync(CONFIG_PATH)) {
+      try {
+        writeFileSync(CONFIG_PATH, JSON.stringify(current, null, 2));
+      } catch {
+        // Keep using the legacy file in memory if migration cannot be written.
+      }
+    }
+    return current;
+  }
+
+  const shell = readJson(LEGACY_ZENTUI_CONFIG_PATH) ?? {};
+  const renderer = readJson(LEGACY_CONFIG_PATH);
+  if (!renderer && Object.keys(shell).length === 0) return {};
+
+  const migrated = { ...shell, version: 1, renderer: renderer ?? {} };
+  try {
+    writeFileSync(CONFIG_PATH, JSON.stringify(migrated, null, 2));
+  } catch {
+    // A read-only agent directory still uses the migrated in-memory value.
+  }
+  return migrated;
+}
+
+function rendererConfigFrom(record: ConfigRecord): ConfigRecord {
+  const renderer = record.renderer;
+  return renderer && typeof renderer === "object" && !Array.isArray(renderer)
+    ? (renderer as ConfigRecord)
+    : record;
+}
+
+export const DIFF_VIEW_MODES: DiffViewMode[] = ["auto", "split", "unified"];
+export const DIFF_INDICATOR_MODES: DiffIndicatorMode[] = [
+  "bars",
+  "classic",
+  "none",
+];
+export const DIFF_SPLIT_MIN_WIDTH_VALUES = [
+  "80",
+  "100",
+  "120",
+  "140",
+  "160",
+  "180",
+];
+export const DIFF_COLLAPSED_LINES_VALUES = [
+  "12",
+  "24",
+  "36",
+  "48",
+  "80",
+  "120",
+];
+/** Write collapsed presets. 0 = stats only (`+N -0` + expand hint). */
+export const WRITE_DIFF_COLLAPSED_LINES_VALUES = [
+  "0",
+  "4",
+  "8",
+  "12",
+  "24",
+  "36",
+];
+/** Presets for expanded body height — keep low options first so cycling stays TUI-friendly. */
+export const EXPANDED_PREVIEW_MAX_LINES_VALUES = [
+  "40",
+  "60",
+  "80",
+  "120",
+  "200",
+  "500",
+  "2000",
+];
+/** 工具摘要里 path/command 等输入的折叠字符数。 */
+export const TOOL_INPUT_NAME_LENGTH_VALUES = [
+  "40",
+  "60",
+  "80",
+  "100",
+  "120",
+  "160",
+];
+export const THINKING_PREVIEW_LINES_VALUES = ["0", "1", "3", "5", "10"];
+export const THINKING_ANIMATION_INTERVAL_VALUES = [
+  "40",
+  "60",
+  "90",
+  "120",
+  "180",
+];
+/** fullscreen 滚轮步进行数预设。 */
+export const SCROLL_STEP_LINES_VALUES = ["1", "2", "3", "5", "10"];
+/** Tools commonly toggled in excludeRenderers via the settings panel. */
+export const EXCLUDE_RENDERER_CANDIDATES = [
+  "bash",
+  "read",
+  "edit",
+  "write",
+  "grep",
+  "find",
+  "ls",
+  "webfetch",
+  "wait",
+];
+
+export const DEFAULT_CONFIG: Config = {
+  mode: "on",
+  excludeRenderers: [],
+  diffViewMode: DEFAULT_TOOL_DISPLAY_CONFIG.diffViewMode,
+  diffIndicatorMode: DEFAULT_TOOL_DISPLAY_CONFIG.diffIndicatorMode,
+  diffSplitMinWidth: DEFAULT_TOOL_DISPLAY_CONFIG.diffSplitMinWidth,
+  editDiffCollapsedLines: DEFAULT_TOOL_DISPLAY_CONFIG.editDiffCollapsedLines,
+  writeDiffCollapsedLines: DEFAULT_TOOL_DISPLAY_CONFIG.writeDiffCollapsedLines,
+  diffWordWrap: DEFAULT_TOOL_DISPLAY_CONFIG.diffWordWrap,
+  expandedPreviewMaxLines: DEFAULT_TOOL_DISPLAY_CONFIG.expandedPreviewMaxLines,
+  toolInputNameLength: 100,
+  useSummaryTitlesAsThinkingTitle: true,
+  previewLines: 3,
+  animationIntervalMs: 90,
+  dimThinkingText: false,
+  showStartupHeader: true,
+  scrollStepLines: 3,
+  enableSessionReference: true,
+  enableSubagentAutocomplete: true,
+  enableContextCommand: true,
+  enableAgentSummary: true,
+  // Zentui is the sole owner of Pi's unkeyed working row in pi-one-ui.
+  enableWorkingMessage: false,
+  enableAliases: true,
+};
+
+function pickEnum<T extends string>(
+  value: unknown,
+  allowed: readonly T[],
+  fallback: T,
+): T {
+  return typeof value === "string" &&
+    (allowed as readonly string[]).includes(value)
+    ? (value as T)
+    : fallback;
+}
+
+export function pickPositiveInt(
+  value: unknown,
+  fallback: number,
+  min = 1,
+  max = 100_000,
+): number {
+  const n =
+    typeof value === "number"
+      ? value
+      : typeof value === "string"
+        ? Number(value)
+        : NaN;
+  if (!Number.isFinite(n)) return fallback;
+  return Math.min(max, Math.max(min, Math.floor(n)));
+}
+
+export function pickPositiveNumber(
+  value: unknown,
+  fallback: number,
+  min = 1,
+): number {
+  const n =
+    typeof value === "number"
+      ? value
+      : typeof value === "string"
+        ? Number(value)
+        : NaN;
+  return Number.isFinite(n) ? Math.max(min, n) : fallback;
+}
+
+export function normalizeConfig(input: unknown): Config {
+  const source = (input && typeof input === "object" ? input : {}) as Record<
+    string,
+    unknown
+  >;
+  const mode = source.mode;
+  // 旧 `enabled: boolean` 配置迁移；compact 已恢复为受支持模式，不再回退 on。
+  const migratedMode: CompactStyleMode =
+    mode === "on" || mode === "compact" || mode === "off"
+      ? mode
+      : typeof source.enabled === "boolean"
+        ? source.enabled
+          ? "on"
+          : "off"
+        : "on";
+  const excludeRenderers = Array.isArray(source.excludeRenderers)
+    ? [
+        ...new Set(
+          source.excludeRenderers.filter(
+            (name): name is string =>
+              typeof name === "string" && name.length > 0,
+          ),
+        ),
+      ]
+    : [];
+  return {
+    mode: migratedMode,
+    excludeRenderers,
+    diffViewMode: pickEnum(
+      source.diffViewMode,
+      DIFF_VIEW_MODES,
+      DEFAULT_CONFIG.diffViewMode,
+    ),
+    diffIndicatorMode: pickEnum(
+      source.diffIndicatorMode,
+      DIFF_INDICATOR_MODES,
+      DEFAULT_CONFIG.diffIndicatorMode,
+    ),
+    diffSplitMinWidth: pickPositiveInt(
+      source.diffSplitMinWidth,
+      DEFAULT_CONFIG.diffSplitMinWidth,
+      40,
+      300,
+    ),
+    editDiffCollapsedLines: pickPositiveInt(
+      source.editDiffCollapsedLines ?? source.diffCollapsedLines,
+      DEFAULT_CONFIG.editDiffCollapsedLines,
+      1,
+      500,
+    ),
+    writeDiffCollapsedLines: pickPositiveInt(
+      source.writeDiffCollapsedLines,
+      DEFAULT_CONFIG.writeDiffCollapsedLines,
+      0,
+      500,
+    ),
+    diffWordWrap: source.diffWordWrap !== false,
+    expandedPreviewMaxLines: pickPositiveInt(
+      source.expandedPreviewMaxLines,
+      DEFAULT_CONFIG.expandedPreviewMaxLines,
+      10,
+      50_000,
+    ),
+    toolInputNameLength: pickPositiveInt(
+      source.toolInputNameLength,
+      DEFAULT_CONFIG.toolInputNameLength,
+      8,
+      500,
+    ),
+    useSummaryTitlesAsThinkingTitle:
+      source.useSummaryTitlesAsThinkingTitle !== false,
+    previewLines: pickPositiveInt(
+      source.previewLines,
+      DEFAULT_CONFIG.previewLines,
+      0,
+      Number.MAX_SAFE_INTEGER,
+    ),
+    animationIntervalMs: pickPositiveNumber(
+      source.animationIntervalMs,
+      DEFAULT_CONFIG.animationIntervalMs,
+    ),
+    dimThinkingText: source.dimThinkingText === true,
+    showStartupHeader: source.showStartupHeader !== false,
+    scrollStepLines: pickPositiveInt(
+      source.scrollStepLines,
+      DEFAULT_CONFIG.scrollStepLines,
+      1,
+      50,
+    ),
+    enableSessionReference: source.enableSessionReference !== false,
+    enableSubagentAutocomplete: source.enableSubagentAutocomplete !== false,
+    enableContextCommand: source.enableContextCommand !== false,
+    enableAgentSummary: source.enableAgentSummary !== false,
+    enableWorkingMessage: source.enableWorkingMessage === true,
+    enableAliases: source.enableAliases !== false,
+  };
+}
+
+export function getCompactThinkingConfig(
+  source: Config = config,
+): CompactThinkingConfig {
+  return {
+    useSummaryTitlesAsThinkingTitle: source.useSummaryTitlesAsThinkingTitle,
+    previewLines: source.previewLines,
+    animationIntervalMs: source.animationIntervalMs,
+  };
+}
+
+export function getToolDisplayConfig(
+  source: Config = config,
+): ToolDisplayConfig {
+  return {
+    diffViewMode: source.diffViewMode,
+    diffIndicatorMode: source.diffIndicatorMode,
+    diffSplitMinWidth: source.diffSplitMinWidth,
+    editDiffCollapsedLines: source.editDiffCollapsedLines,
+    writeDiffCollapsedLines: source.writeDiffCollapsedLines,
+    diffWordWrap: source.diffWordWrap,
+    expandedPreviewMaxLines: source.expandedPreviewMaxLines,
+  };
+}
+
+export function formatExcludeRenderers(names: readonly string[]): string {
+  return names.length === 0 ? "none" : names.join(", ");
+}
+
+export function formatConfigStatus(source: Config = config): string {
+  return [
+    `mode=${source.mode}`,
+    `exclude=[${source.excludeRenderers.join(", ") || "none"}]`,
+    `diffView=${source.diffViewMode}`,
+    `diffIndicator=${source.diffIndicatorMode}`,
+    `diffSplitMin=${source.diffSplitMinWidth}`,
+    `editCollapsed=${source.editDiffCollapsedLines}`,
+    `writeCollapsed=${source.writeDiffCollapsedLines}`,
+    `diffWordWrap=${source.diffWordWrap ? "on" : "off"}`,
+    `expandedMax=${source.expandedPreviewMaxLines}`,
+    `toolInputName=${source.toolInputNameLength}`,
+    `thinkingTitle=${source.useSummaryTitlesAsThinkingTitle ? "summary" : "default"}`,
+    `thinkingPreview=${source.previewLines}`,
+    `thinkingAnimation=${source.animationIntervalMs}ms`,
+    `thinkingDim=${source.dimThinkingText ? "on" : "off"}`,
+    `startupHeader=${source.showStartupHeader ? "on" : "off"}`,
+    `scrollStep=${source.scrollStepLines}`,
+    `sessionRef=${source.enableSessionReference ? "on" : "off"}`,
+    `subagentAuto=${source.enableSubagentAutocomplete ? "on" : "off"}`,
+    `context=${source.enableContextCommand ? "on" : "off"}`,
+    `agentSummary=${source.enableAgentSummary ? "on" : "off"}`,
+    `workingMsg=${source.enableWorkingMessage ? "on" : "off"}`,
+    `aliases=${source.enableAliases ? "on" : "off"}`,
+  ].join(" · ");
+}
+
+/** 进程内唯一的活动配置对象。读取直接用 `config.xxx`；写入必须走 `updateConfig`。 */
+export const config: Config = loadConfig();
+
+function loadConfig(): Config {
+  try {
+    const unified = readUnifiedConfig();
+    return normalizeConfig(rendererConfigFrom(unified));
+  } catch {
+    // Ignore bad config and fall back to defaults.
+  }
+  return { ...DEFAULT_CONFIG };
+}
+
+export function saveConfig() {
+  const unified = readUnifiedConfig();
+  writeFileSync(
+    CONFIG_PATH,
+    JSON.stringify({ ...unified, version: 1, renderer: config }, null, 2),
+  );
+}
+
+/** 运行时配置写入的唯一入口：合并 + 规范化 + 持久化。 */
+export function updateConfig(partial: Partial<Config>): void {
+  Object.assign(config, normalizeConfig({ ...config, ...partial }));
+  saveConfig();
+}
+
+/** 整体替换配置（default export 的 configOverride 注入路径；就地覆盖，不持久化）。 */
+export function setConfig(next: Config): void {
+  Object.assign(config, next);
+}