pi-cc-extensions 0.8.51 → 0.8.53

package/README.en.md

@@ -39,14 +39,14 @@ Run `/reload` after installation.
 ## Features
 
 
-| Feature                      | Description                                                                                                                                                   | Entry point |
-| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
-| Claude Code-style output     | Tool summaries, expand/collapse, rich edit/write diffs, and`on` / `off` modes                                                                                 | `/ccstyle`  |
-| Fullscreen mouse interaction | Tool card/group click-to-toggle,`[show more]` previews, hover highlight, and a back-to-bottom button (motion reporting auto-enabled under tmux/zellij/screen) | `/ccstyle`  |
-| Settings panel               | `Style / Diff / Thinking / Feature` tabs: startup header toggle and wheel step                                                                                | `/ccstyle`  |
-| Context inspection           | Usage breakdown and previews for the system prompt, tools, skills, and messages                                                                               | `/context`  |
-| Session references           | Search and inject effective context from previous Sessions or existing SubAgents                                                                              | `@session:` |
-| Theme                        | Bundled CC Dark and CC Light themes                                                                                                                           | `/theme`    |
+| Feature                      | Description                                                                                                                                       | Entry point |
+| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
+| Claude Code-style output     | Tool summaries, expand/collapse, rich edit/write diffs, and`on` / `compact` / `off` modes                                                         | `/ccstyle`  |
+| Fullscreen mouse interaction | Tool card/group click-to-toggle, previews, hover highlight, and a back-to-bottom button | `TUIMODE=fullscreen` or `--tui-mode fullscreen` |
+| Settings panel               | `Style / Diff / Thinking / Feature` tabs: startup header toggle and wheel step                                                                    | `/ccstyle`  |
+| Context inspection           | Usage breakdown and previews for the system prompt, tools, skills, and messages                                                                   | `/context`  |
+| Session references           | Search and inject effective context from previous Sessions or existing SubAgents                                                                  | `@session:` |
+| Theme                        | Bundled CC Dark and CC Light themes                                                                                                               | `/theme`    |
 
 ## Configuration
 
@@ -54,7 +54,7 @@ Run `/reload` after installation.
 
 ```js
 {
-  "mode": "on",                            // on: Claude Code-style output; off: Pi native rendering
+  "mode": "on",                            // on: Claude Code style; compact: one-line summaries; off: Pi native rendering
   "excludeRenderers": [],                  // exact tool names that keep their native renderer; Agent always keeps its dedicated renderer
   "diffViewMode": "auto",                  // diff layout: auto / split / unified
   "diffIndicatorMode": "bars",             // diff change indicators: bars / classic / none
@@ -83,9 +83,6 @@ Run `/reload` after changing extensions.
 ## Compatibility
 
 - Node.js `>=22.19.0`, Pi `^0.84.0` (loaded through `pi.extensions` and `pi.themes` in the root `package.json`)
-- Fixed-editor features have been smoothly migrated to the official pipeline: in TUI fullscreen mode, all `/ccstyle` mouse interactions work as usual.
-- Need the removed fixed-editor layout or `compact` one-line summary mode? Use version `0.8.46` or earlier
-- Removed: the fixed-editor layout and the `compact` one-line summary mode (a new compact mode is planned for a future release). Old configs with `"mode": "compact"` automatically fall back to `on`, and the `/ccstyle` panel only offers `on` / `off`.
 
 ## Recommended companions
 

package/README.md

@@ -39,14 +39,14 @@ pi install git:github.com/minuque/pi-cc-extensions
 ## 功能
 
 
-| 功能                 | 说明                                                                                                                   | 入口        |
-| ---------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------- |
-| Claude Code 风格输出 | 工具摘要、折叠展开、rich edit/write diff，以及`on` / `off` 两种模式                                                    | `/ccstyle`  |
-| Fullscreen 鼠标交互  | 工具卡/group 点击展开与收起、`[show more]` 预览、hover 高亮、回到底部按钮（tmux/zellij/screen 下自动补开 motion 上报） | `/ccstyle`  |
-| 配置面板             | `Style / Diff / Thinking / Feature` 四页签，含启动头开关与滚轮步进                                                     | `/ccstyle`  |
-| 上下文检查           | 查看上下文占用，并预览 System prompt、Tools、Skills 和消息内容                                                         | `/context`  |
-| Session 引用         | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文                                                                    | `@session:` |
-| 主题                 | 随包提供内置 CC Dark、CC Light 主题                                                                                    | `/theme`    |
+| 功能                 | 说明                                                                                                     | 入口        |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------- | ------------- |
+| Claude Code 风格输出 | 工具摘要、折叠展开、rich edit/write diff，以及`on` / `compact` / `off` 三种模式                          | `/ccstyle`  |
+| Fullscreen 鼠标交互  | 工具卡/group 点击展开与收起、预览、hover 高亮、回到底部按钮 | `TUIMODE=fullscreen` 或 `--tui-mode fullscreen` |
+| 配置面板             | `Style / Diff / Thinking / Feature` 四页签，含启动头开关与滚轮步进                                       | `/ccstyle`  |
+| 上下文检查           | 查看上下文占用，并预览 System prompt、Tools、Skills 和消息内容                                           | `/context`  |
+| Session 引用         | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文                                                      | `@session:` |
+| 主题                 | 随包提供内置 CC Dark、CC Light 主题                                                                      | `/theme`    |
 
 ## 配置
 
@@ -54,7 +54,7 @@ pi install git:github.com/minuque/pi-cc-extensions
 
 ```js
 {
-  "mode": "on",                            // on：Claude Code 风格输出；off：Pi 原生渲染
+  "mode": "on",                            // on：Claude Code 风格；compact：单行摘要；off：Pi 原生渲染
   "excludeRenderers": [],                  // 走原生渲染的工具名列表（精确匹配），Agent 始终保留专用渲染器
   "diffViewMode": "auto",                  // diff 布局：auto / split / unified
   "diffIndicatorMode": "bars",             // diff 变更指示：bars / classic / none
@@ -83,9 +83,6 @@ npm run typecheck
 ## 兼容性
 
 - Node.js `>=22.19.0`，Pi `^0.84.0`（通过根目录 `package.json` 的 `pi.extensions` 和 `pi.themes` 加载）
-- fixed-editor相关功能已平滑迁移至官方管线：TUI mode=fullscreen 模式下 `/ccstyle` 全部鼠标交互功能类照常可用。
-- 需要已移除的 fixed-editor 布局或 `compact` 单行摘要模式？请使用 `0.8.46` 及更早版本
-- 已移除：固定编辑器布局与 `compact` 单行摘要模式（后续会有新版本 compact mode 发布）。旧配置 `mode: "compact"` 自动回退 `on`，`/ccstyle` 面板仅有 `on` / `off`。
 
 ## 推荐搭配
 

package/extensions/config/config.ts

@@ -9,7 +9,7 @@ import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
-export type CompactStyleMode = "on" | "off";
+export type CompactStyleMode = "on" | "compact" | "off";
 
 export type Config = {
 	mode: CompactStyleMode;
@@ -105,9 +105,9 @@ export function nearestPreset(value: number, presets: readonly string[]): string
 export function normalizeConfig(input: unknown): Config {
 	const source = (input && typeof input === "object" ? input : {}) as Record<string, unknown>;
 	const mode = source.mode;
-	// mode=compact 已日落：旧配置回退到 on（Claude Code 风格）。
+	// 旧 `enabled: boolean` 配置迁移；compact 已恢复为受支持模式，不再回退 on。
 	const migratedMode: CompactStyleMode =
-		mode === "on" || mode === "off"
+		mode === "on" || mode === "compact" || mode === "off"
 			? mode
 			: typeof source.enabled === "boolean"
 				? source.enabled
@@ -216,7 +216,12 @@ function loadConfig(): Config {
 			? (JSON.parse(readFileSync(CONFIG_PATH, "utf8")) as Record<string, unknown>)
 			: {};
 		const normalized = normalizeConfig(source);
-		if (typeof source.enabled === "boolean" && source.mode !== "on" && source.mode !== "off") {
+		if (
+			typeof source.enabled === "boolean" &&
+			source.mode !== "on" &&
+			source.mode !== "compact" &&
+			source.mode !== "off"
+		) {
 			try {
 				writeFileSync(CONFIG_PATH, JSON.stringify(normalized, null, 2));
 			} catch {

package/extensions/config/panel.ts

@@ -5,7 +5,7 @@
  * CcstylePanelHooks 注入，避免 config → renderer 循环依赖。
  */
 import { getSettingsListTheme } from "@earendil-works/pi-coding-agent";
-import { SettingsList, matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
+import { Input, SettingsList, matchesKey, truncateToWidth } from "@earendil-works/pi-tui";
 import type { CompactThinkingController } from "../feature/compact-thinking.ts";
 import { applyStartupHeader } from "../feature/pi-startup-header.ts";
 import type { ToolGroupingHooks } from "../renderer/tool-grouping.ts";
@@ -21,7 +21,6 @@ import {
 	EXPANDED_PREVIEW_MAX_LINES_VALUES,
 	formatExcludeRenderers,
 	getCompactThinkingConfig,
-	nearestPreset,
 	pickPositiveInt,
 	pickPositiveNumber,
 	saveConfig,
@@ -38,6 +37,9 @@ export type CcstylePanelHooks = {
 };
 
 function modeSettingDescription(mode: CompactStyleMode): string {
+	if (mode === "compact") {
+		return "(Experimental) One summary line per assistant round; expanded edit/write rows show rich diffs.";
+	}
 	if (mode === "off") {
 		return "Pi native tool rendering. Diff options below still apply independently.";
 	}
@@ -110,6 +112,48 @@ function buildExcludeRenderersSubmenu(
 	};
 }
 
+/** 数值项手动输入子面板：预填当前值，Space 循环预设，输入数字自定义，Enter 应用，Esc 取消。 */
+function buildNumberInputSubmenu(
+	theme: any,
+	setting: { label: string; values: readonly string[]; currentValue: string },
+	closeSubmenu: (selected?: string) => void,
+): {
+	render: (width: number) => string[];
+	invalidate: () => void;
+	handleInput: (data: string) => void;
+} {
+	const input = new Input();
+	let error = "";
+	input.setValue(setting.currentValue);
+	input.onSubmit = (value: string) => {
+		const raw = value.trim();
+		if (raw === "") {
+			closeSubmenu(); // 空输入 = 取消
+			return;
+		}
+		if (!Number.isFinite(Number(raw))) {
+			error = `Invalid number: "${raw}"`;
+			return;
+		}
+		closeSubmenu(raw);
+	};
+	input.onEscape = () => closeSubmenu();
+	return {
+		render: (width: number) => {
+			const safe = Math.max(0, Math.floor(width));
+			const lines = [
+				theme.fg("dim", `  ${setting.label} — custom value:`),
+				...input.render(safe),
+				truncateToWidth(theme.fg("dim", "  Enter to apply · Esc to go back"), safe),
+			];
+			if (error !== "") lines.push(theme.fg("dim", `  ${error}`));
+			return lines;
+		},
+		invalidate: () => {},
+		handleInput: (data: string) => input.handleInput(data),
+	};
+}
+
 /** Section tabs for /ccstyle — matches Zentui-style "A / B / C" headers. */
 type CcstyleSection = {
 	id: "style" | "editor" | "diff" | "thinking" | "feature";
@@ -165,8 +209,8 @@ export async function showCcstylePanel(
 			id: "mode",
 			label: "Mode",
 			description: modeSettingDescription(config.mode),
-			currentValue: config.mode,
-			values: ["on", "off"],
+			currentValue: config.mode === "compact" ? "compact (Experimental)" : config.mode,
+			values: ["on", "compact (Experimental)", "off"],
 		};
 		// Tracks whether the Exclude-tools submenu is open so Tab switches sections
 		// only at the top level (mirrors Zentui settings: Tab = switch sections).
@@ -210,16 +254,22 @@ export async function showCcstylePanel(
 		const diffSplitSetting = {
 			id: "diffSplitMinWidth",
 			label: "Split min width",
-			description: "Minimum terminal width before auto/split layout uses side-by-side columns.",
-			currentValue: nearestPreset(config.diffSplitMinWidth, DIFF_SPLIT_MIN_WIDTH_VALUES),
+			description:
+				"Minimum terminal width before auto/split layout uses side-by-side columns. Enter to type a custom value.",
+			currentValue: String(config.diffSplitMinWidth),
 			values: [...DIFF_SPLIT_MIN_WIDTH_VALUES],
+			submenu: (_current: string, closeSubmenu: (selected?: string) => void) =>
+				buildNumberInputSubmenu(theme, diffSplitSetting, closeSubmenu),
 		};
 		const diffCollapsedSetting = {
 			id: "diffCollapsedLines",
 			label: "Collapsed lines",
-			description: "How many diff body lines to show before the expand hint (Ctrl+O / click).",
-			currentValue: nearestPreset(config.diffCollapsedLines, DIFF_COLLAPSED_LINES_VALUES),
+			description:
+				"How many diff body lines to show before the expand hint (Ctrl+O / click). Enter to type a custom value.",
+			currentValue: String(config.diffCollapsedLines),
 			values: [...DIFF_COLLAPSED_LINES_VALUES],
+			submenu: (_current: string, closeSubmenu: (selected?: string) => void) =>
+				buildNumberInputSubmenu(theme, diffCollapsedSetting, closeSubmenu),
 		};
 		const diffWordWrapSetting = {
 			id: "diffWordWrap",
@@ -235,11 +285,10 @@ export async function showCcstylePanel(
 			label: "Expanded max lines",
 			description:
 				"Max Output/diff body lines when expanded. Default 40 keeps the TUI compact; raise for large dumps.",
-			currentValue: nearestPreset(
-				config.expandedPreviewMaxLines,
-				EXPANDED_PREVIEW_MAX_LINES_VALUES,
-			),
+			currentValue: String(config.expandedPreviewMaxLines),
 			values: [...EXPANDED_PREVIEW_MAX_LINES_VALUES],
+			submenu: (_current: string, closeSubmenu: (selected?: string) => void) =>
+				buildNumberInputSubmenu(theme, expandedMaxSetting, closeSubmenu),
 		};
 		const thinkingTitleSetting = {
 			id: "useSummaryTitlesAsThinkingTitle",
@@ -252,15 +301,19 @@ export async function showCcstylePanel(
 			id: "previewLines",
 			label: "Preview lines",
 			description: "Thinking preview lines; 0 hides the preview body.",
-			currentValue: nearestPreset(config.previewLines, THINKING_PREVIEW_LINES_VALUES),
+			currentValue: String(config.previewLines),
 			values: [...THINKING_PREVIEW_LINES_VALUES],
+			submenu: (_current: string, closeSubmenu: (selected?: string) => void) =>
+				buildNumberInputSubmenu(theme, thinkingPreviewSetting, closeSubmenu),
 		};
 		const thinkingAnimationSetting = {
 			id: "animationIntervalMs",
 			label: "Animation interval ms",
 			description: "Thinking title animation interval for the next thinking run.",
-			currentValue: nearestPreset(config.animationIntervalMs, THINKING_ANIMATION_INTERVAL_VALUES),
+			currentValue: String(config.animationIntervalMs),
 			values: [...THINKING_ANIMATION_INTERVAL_VALUES],
+			submenu: (_current: string, closeSubmenu: (selected?: string) => void) =>
+				buildNumberInputSubmenu(theme, thinkingAnimationSetting, closeSubmenu),
 		};
 		const startupHeaderSetting = {
 			id: "showStartupHeader",
@@ -275,16 +328,22 @@ export async function showCcstylePanel(
 			id: "scrollStepLines",
 			label: "Scroll step",
 			description: "Mouse wheel scroll lines in fullscreen mode.",
-			currentValue: nearestPreset(config.scrollStepLines, SCROLL_STEP_LINES_VALUES),
+			currentValue: String(config.scrollStepLines),
 			values: [...SCROLL_STEP_LINES_VALUES],
+			submenu: (_current: string, closeSubmenu: (selected?: string) => void) =>
+				buildNumberInputSubmenu(theme, scrollStepSetting, closeSubmenu),
 		};
 
 		const onSettingChange = (id: string, value: string) => {
 			switch (id) {
-				case "mode":
-					modeSetting.description = modeSettingDescription(value as CompactStyleMode);
-					hooks.applyStyleMode(value as CompactStyleMode, ctx, toolGrouping);
+				case "mode": {
+					// 选项值带 Experimental 标记，选择后还原为真实 mode 值。
+					const mode: CompactStyleMode =
+						value === "compact (Experimental)" ? "compact" : (value as CompactStyleMode);
+					modeSetting.description = modeSettingDescription(mode);
+					hooks.applyStyleMode(mode, ctx, toolGrouping);
 					return;
+				}
 				case "excludeRenderers":
 					excludeSetting.currentValue = formatExcludeRenderers(config.excludeRenderers);
 					excludeSetting.description = excludeRenderersDescription(config.excludeRenderers);
@@ -304,6 +363,7 @@ export async function showCcstylePanel(
 						40,
 						300,
 					);
+					diffSplitSetting.currentValue = String(config.diffSplitMinWidth);
 					break;
 				case "diffCollapsedLines":
 					config.diffCollapsedLines = pickPositiveInt(
@@ -312,6 +372,7 @@ export async function showCcstylePanel(
 						1,
 						500,
 					);
+					diffCollapsedSetting.currentValue = String(config.diffCollapsedLines);
 					break;
 				case "diffWordWrap":
 					config.diffWordWrap = value === "on";
@@ -326,18 +387,21 @@ export async function showCcstylePanel(
 						10,
 						50_000,
 					);
+					expandedMaxSetting.currentValue = String(config.expandedPreviewMaxLines);
 					break;
 				case "useSummaryTitlesAsThinkingTitle":
 					config.useSummaryTitlesAsThinkingTitle = value === "on";
 					break;
 				case "previewLines":
 					config.previewLines = pickPositiveInt(value, DEFAULT_CONFIG.previewLines, 0);
+					thinkingPreviewSetting.currentValue = String(config.previewLines);
 					break;
 				case "animationIntervalMs":
 					config.animationIntervalMs = pickPositiveNumber(
 						value,
 						DEFAULT_CONFIG.animationIntervalMs,
 					);
+					thinkingAnimationSetting.currentValue = String(config.animationIntervalMs);
 					break;
 				case "showStartupHeader":
 					config.showStartupHeader = value === "on";
@@ -349,6 +413,7 @@ export async function showCcstylePanel(
 					break;
 				case "scrollStepLines":
 					config.scrollStepLines = pickPositiveInt(value, DEFAULT_CONFIG.scrollStepLines, 1, 50);
+					scrollStepSetting.currentValue = String(config.scrollStepLines);
 					break;
 				default:
 					return;
@@ -410,6 +475,27 @@ export async function showCcstylePanel(
 			activeSection = (activeSection + delta + sections.length) % sections.length;
 		};
 
+		/** 数值项：当前选中项有 submenu + values 时，Space 仅循环预设，不打开子面板。 */
+		const cyclePresetInList = (list: InstanceType<typeof SettingsList>): boolean => {
+			const internal = list as unknown as {
+				submenuComponent: unknown;
+				items: {
+					id: string;
+					currentValue: string;
+					submenu?: unknown;
+					values?: readonly string[];
+				}[];
+				selectedIndex: number;
+			};
+			if (internal.submenuComponent) return false;
+			const item = internal.items[internal.selectedIndex];
+			if (!item?.submenu || !item.values?.length) return false;
+			const i = item.values.indexOf(item.currentValue);
+			item.currentValue = item.values[i === -1 ? 0 : (i + 1) % item.values.length]!;
+			onSettingChange(item.id, item.currentValue);
+			return true;
+		};
+
 		return {
 			render(width: number): string[] {
 				const safeWidth = Math.max(0, Math.floor(width));
@@ -435,7 +521,7 @@ export async function showCcstylePanel(
 					truncateToWidth(
 						theme.fg(
 							"dim",
-							"  Enter/Space to change · Tab/Shift+Tab to switch sections · Esc to close",
+							"  Enter/Space to change · Enter on numbers types a custom value · Tab/Shift+Tab to switch sections · Esc to close",
 						),
 						safeWidth,
 					),
@@ -456,7 +542,13 @@ export async function showCcstylePanel(
 					tui.requestRender();
 					return;
 				}
-				activeList().handleInput?.(data);
+				const list = activeList();
+				// Space 循环预设（数值项不进子面板）；Enter 打开子面板输入自定义值。
+				if (data === " " && cyclePresetInList(list)) {
+					tui.requestRender();
+					return;
+				}
+				list.handleInput?.(data);
 				tui.requestRender();
 			},
 		};

package/extensions/feature/agent-autocomplete.ts

@@ -14,6 +14,7 @@ type AgentInfo = {
 	displayName: string;
 	description: string;
 	model?: string;
+	thinking?: string;
 	filePath: string;
 };
 
@@ -53,6 +54,7 @@ function loadAgents(): AgentInfo[] {
 				displayName: fm.display_name || name,
 				description: fm.description || "",
 				model: fm.model,
+				thinking: fm.thinking,
 				filePath,
 			};
 		});
@@ -94,7 +96,7 @@ export function createAgentAutocompleteProvider(
 			const agentItems: AutocompleteItem[] = matches.slice(0, MAX_SUGGESTIONS).map((agent) => ({
 				value: `@${agent.name}`,
 				label: `[SubAgent] ${agent.displayName}`,
-				description: agent.description + (agent.model ? ` · ${agent.model}` : ""),
+				description: `${agent.model ?? "?"} · ${agent.thinking ?? "?"}`,
 			}));
 			const hasCompatibleBaseSuggestions = baseSuggestions?.prefix === `@${query}`;
 			const agentValues = new Set(agents.map((agent) => `@${agent.name}`));

package/extensions/feature/agent-summary.ts

@@ -19,8 +19,8 @@ import {
 export const AGENT_SUMMARY_ENTRY_TYPE = "agent-summary";
 
 export default function (pi: ExtensionAPI): void {
-	pi.registerEntryRenderer<AgentSummaryData>(AGENT_SUMMARY_ENTRY_TYPE, (entry, _options, theme) => {
-		const line = summaryMarkdown(entry.data, true, {
+	pi.registerEntryRenderer(AGENT_SUMMARY_ENTRY_TYPE, (entry, _options, theme) => {
+		const line = summaryMarkdown(entry.data as AgentSummaryData, true, {
 			success: theme.getFgAnsi("success"),
 			failed: theme.getFgAnsi("error"),
 		});