pi-cc-extensions 0.8.42 → 0.8.43

package/README.en.md

@@ -22,11 +22,9 @@
 ## Preview
 
 <table>
-  <img src="./assets/readme/welcome.webp" width="100%" alt="Pi welcome screen">
+  <img width="2788" height="1846" alt="demo_new" src="https://github.com/user-attachments/assets/d4f9bb51-a49a-4a34-aa60-006514d37b09" />
 </table>
 
-https://github.com/user-attachments/assets/4ae094d2-7480-484b-a0c8-6e782495ce9f
-
 ## Quick start
 
 ```bash
@@ -113,9 +111,18 @@ Run `/reload` after changing extensions.
 ## Compatibility
 
 - Node.js `>=22.19.0`
-- Loaded through `pi.extensions` and `pi.themes` in the root `package.json`
+- Pi `^0.84.0` (loaded through `pi.extensions` and `pi.themes` in the root `package.json`)
+- For Pi 0.80.x and earlier, use an older release of this package (peerDependencies are now `^0.84.0`)
 - If a Pi, TUI, or `@tifan/pi-fixed-editor` update causes display issues, try `/reload` first
 
+### Fullscreen mode & sunset features
+
+- Official `--tui-mode fullscreen` (and runtime switching via `/settings`) is reused as-is: when `tui.mode === "fullscreen"`, the extension stands down and installs no rendering layer (tool styling, compact mode, tool grouping, and the fixed editor are all skipped), leaving fullscreen entirely to the official TUI. Data features (context, session references, autocomplete, etc.) are unaffected.
+- Capabilities that overlap with the official fullscreen TUI are sunset (frozen, kept working only): fixed-editor layout, independently scrollable transcript, etc. — no second implementation.
+- Known boundary: when switching from regular to fullscreen at runtime, per-TUI rendering patches are automatically abandoned with the old TUI instance, but component-level style patches remain active (they do not affect the official layout); for full isolation, start the session in fullscreen mode.
+- Pi 0.84+ wraps the TUI reference in a lazy Proxy (`createInteractiveTuiReference`): capturing `doRender`/`render`/`handleInput` through it resolves to the wrapper itself and recurses infinitely. The extension detects the lazy Proxy and skips line-level rendering patches; `@tifan/pi-fixed-editor`'s compositor is likewise disabled on 0.84+ (Fixed editor interactions are temporarily unavailable; rendering is handled by the official pipeline).
+- The `compact-thinking.json` config file is sunset (no longer read or maintained); compact-thinking settings are managed exclusively by `claude-code-style.json`.
+
 ## Recommended companions
 
 

package/README.md

@@ -22,11 +22,9 @@
 ## 界面预览
 
 <table>
- <img src="./assets/readme/welcome.webp" width="100%" alt="Pi 启动后的欢迎界面">
+  <img width="2788" height="1846" alt="demo_new" src="https://github.com/user-attachments/assets/d4f9bb51-a49a-4a34-aa60-006514d37b09" />
 </table>
 
-https://github.com/user-attachments/assets/4ae094d2-7480-484b-a0c8-6e782495ce9f
-
 ## 快速开始
 
 ```bash
@@ -61,9 +59,18 @@ pi -e .
 ## 兼容性
 
 - Node.js `>=22.19.0`
-- 通过根目录 `package.json` 的 `pi.extensions` 和 `pi.themes` 加载
+- Pi `^0.84.0`（通过根目录 `package.json` 的 `pi.extensions` 和 `pi.themes` 加载）
+- 0.80.x 及更早版本请使用本包的旧版本（peerDependencies 已收紧为 `^0.84.0`）
 - `@tifan/pi-fixed-editor`、Pi 或 TUI 内部实现升级后若显示异常，先执行 `/reload`
 
+### Fullscreen 模式与日落功能
+
+- 官方 `--tui-mode fullscreen`（及 `/settings` 运行时切换）复用官方布局：插件在 `tui.mode === "fullscreen"` 时自动让位，不安装任何渲染层（工具样式、紧凑模式、工具分组、固定编辑器均跳过），fullscreen 完全由官方 TUI 提供。数据类功能（context、session 引用、自动补全等）不受影响。
+- 与官方 fullscreen 重叠的能力已日落（冻结开发、仅维持可用）：固定编辑器布局、独立滚动 transcript 等不再二次实现。
+- 已知边界：运行时从 regular 切换到 fullscreen 时，插件行级渲染 patch 随旧 TUI 实例自动失效，但组件级样式 patch 仍生效（不影响官方布局）；如需完全隔离，建议以 fullscreen 模式启动会话。
+- Pi 0.84+ 的 TUI 引用是惰性 Proxy（`createInteractiveTuiReference`），通过它捕获 `doRender`/`render`/`handleInput` 会解析到包装自身形成无限递归。插件检测到惰性 Proxy 后跳过行级渲染 patch；`@tifan/pi-fixed-editor` 的 compositor 因同样原因在 0.84+ 下停用（Fixed editor 交互功能暂时不可用，渲染由官方管线接管）。
+- `compact-thinking.json` 配置文件已日落（不再读取、不再兼容），compact-thinking 的配置统一由 `claude-code-style.json` 管控。
+
 ## 推荐搭配
 
 | 扩展                            | 用途                                |

package/extensions/claude-code-style.ts

@@ -1,5 +1,6 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { getSettingsListTheme, ToolExecutionComponent } from "@earendil-works/pi-coding-agent";
+import { isFullscreenUi, isLazyProxyTui } from "./fullscreen-detect.ts";
 import {
 	installCompactStyle,
 	type CompactStyleHooks,
@@ -227,7 +228,6 @@ function formatExcludeRenderers(names: readonly string[]): string {
 export function formatConfigStatus(source: Config = config): string {
 	return [
 		`mode=${source.mode}`,
-		`fixedEditor=${source.fixedEditorFeatures ? "on" : "off"}`,
 		`exclude=[${source.excludeRenderers.join(", ") || "none"}]`,
 		`diffView=${source.diffViewMode}`,
 		`diffIndicator=${source.diffIndicatorMode}`,
@@ -1515,6 +1515,8 @@ function renderScrollButton(width: number, theme: any): string[] {
  */
 function patchToolMouseInputCapture(tui: any): void {
 	if (toolMouseInputPatchTui === tui) return;
+	// 0.84+ 惰性 Proxy：捕获 handleInput 会解析到 wrapper 自身（无限递归），跳过。
+	if (isLazyProxyTui(tui)) return;
 
 	restoreToolMouseInputCapture();
 	const originalHandle = tui?.handleInput;
@@ -1722,6 +1724,8 @@ function patchToolMouseMotionAfterRender(tui: any): void {
 	) {
 		return;
 	}
+	// 0.84+ 惰性 Proxy：捕获 doRender 会解析到 wrapper 自身（无限递归），跳过。
+	if (isLazyProxyTui(tui)) return;
 	restoreToolMouseRenderPatch();
 	const original = tui?.doRender;
 	const terminal = tui?.terminal;
@@ -1947,8 +1951,16 @@ export function installToolMouseInteraction(
 
 	toolMouseUi = ctx.ui;
 	toolMouseFixedFeaturesEnabled = fixedEditorFeatures;
+	// 0.84+ 的 tui 是惰性 Proxy：行级 patch（doRender/handleInput）无法安全捕获，
+	// fixed-editor compositor 亦停用 —— 整个工具鼠标交互体系（hover/点击/滚动按钮）
+	// 让位给官方，连 onTerminalInput 监听都不注册。
+	let proxyTui = false;
 	ctx.ui.setWidget(TOOL_MOUSE_WIDGET_KEY, (tui: any, theme: any) => {
 		toolMouseTui = tui;
+		if (isLazyProxyTui(tui)) {
+			proxyTui = true;
+			return { render: () => 0, invalidate() {} };
+		}
 		// Root input capture follows the live compositor; onRebuild re-applies it
 		// once the fixed-editor compositor actually owns the terminal.
 		if (useFixedEditorFeatures(tui)) patchToolMouseInputCapture(tui);
@@ -1967,6 +1979,10 @@ export function installToolMouseInteraction(
 		scrollButtonWidget = widget;
 		return widget;
 	});
+	if (proxyTui) {
+		teardownToolMouseInteraction(fixedEditorFeatures);
+		return;
+	}
 	toolMouseInputUnsubscribe = ctx.ui.onTerminalInput(handleToolMouseInput);
 }
 
@@ -2040,18 +2056,12 @@ function applyStyleMode(
 
 function modeSettingDescription(mode: CompactStyleMode): string {
 	if (mode === "compact") {
-		return "Compact transcript summaries. Fixed editor and diff options below still apply independently.";
+		return "Compact transcript summaries. Diff options below still apply independently.";
 	}
 	if (mode === "off") {
-		return "Pi native tool rendering. Fixed editor and diff options below still apply independently.";
+		return "Pi native tool rendering. Diff options below still apply independently.";
 	}
-	return "Claude Code style with rich edit/write diffs. Tune fixed editor and diff options below.";
-}
-
-function fixedEditorSettingDescription(enabled: boolean): string {
-	return enabled
-		? "Pinned editor via @tifan/pi-fixed-editor. Mouse capture, 5-row wheel, tool clicks, back-to-bottom button, message count, and Ctrl+End."
-		: "Native scrolling editor; mouse hover/click and wheel reporting off. Ctrl+End remains enabled.";
+	return "Claude Code style with rich edit/write diffs. Tune diff options below.";
 }
 
 function excludeRenderersDescription(names: readonly string[]): string {
@@ -2162,7 +2172,6 @@ function renderSectionTabBar(
 async function showCcstylePanel(
 	ctx: any,
 	compactStyle: CompactStyleHooks,
-	fixedEditorController: FixedEditorController,
 	toolGrouping?: ToolGroupingHooks,
 	compactThinking?: CompactThinkingController,
 ): Promise<void> {
@@ -2179,13 +2188,6 @@ async function showCcstylePanel(
 			currentValue: config.mode,
 			values: ["on", "off", "compact"],
 		};
-		const fixedEditorSetting = {
-			id: "fixedEditorFeatures",
-			label: "Fixed editor",
-			description: fixedEditorSettingDescription(config.fixedEditorFeatures),
-			currentValue: config.fixedEditorFeatures ? "on" : "off",
-			values: ["on", "off"],
-		};
 		// Tracks whether the Exclude-tools submenu is open so Tab switches sections
 		// only at the top level (mirrors Zentui settings: Tab = switch sections).
 		let excludeSubmenuOpen = false;
@@ -2287,17 +2289,6 @@ async function showCcstylePanel(
 					modeSetting.description = modeSettingDescription(value as CompactStyleMode);
 					applyStyleMode(value as CompactStyleMode, ctx, compactStyle, toolGrouping);
 					return;
-				case "fixedEditorFeatures":
-					config.fixedEditorFeatures = value === "on";
-					fixedEditorSetting.description = fixedEditorSettingDescription(
-						config.fixedEditorFeatures,
-					);
-					saveConfig();
-					fixedEditorController.setEnabled(config.fixedEditorFeatures);
-					installToolMouseInteraction(ctx);
-					refreshCurrentTranscript(compactStyle, ctx);
-					ctx.ui.notify(`Fixed editor: ${value}`, "info");
-					return;
 				case "excludeRenderers":
 					excludeSetting.currentValue = formatExcludeRenderers(config.excludeRenderers);
 					excludeSetting.description = excludeRenderersDescription(config.excludeRenderers);
@@ -2367,11 +2358,6 @@ async function showCcstylePanel(
 				label: "Style",
 				items: [modeSetting, excludeSetting],
 			},
-			{
-				id: "editor",
-				label: "Editor",
-				items: [fixedEditorSetting],
-			},
 			{
 				id: "diff",
 				label: "Diff",
@@ -3189,6 +3175,8 @@ export default function (
 		| undefined;
 	const ensureTuiInstallation = (ctx: any) => {
 		if (ctx?.mode !== "tui" || !ctx?.hasUI) return undefined;
+		// fullscreen 复用官方布局，插件渲染层（工具样式/紧凑模式/分组）让位
+		if (isFullscreenUi(ctx)) return undefined;
 		if (installation) return installation;
 		const globalToolRendering = installGlobalToolRendering(writeExecutionMetadata);
 		const toolGrouping = installToolGrouping(() => config.mode === "on");
@@ -3215,23 +3203,25 @@ export default function (
 		},
 		handler: async (args, ctx) => {
 			const arg = args.trim().toLowerCase();
-			if (!arg || arg === "panel") {
-				const hooks = ensureTuiInstallation(ctx);
-				if (hooks)
-					await showCcstylePanel(
-						ctx,
-						hooks.compactStyle,
-						fixedEditorController,
-						hooks.toolGrouping,
-						compactThinking,
+			if (!arg || arg === "panel" || arg === "on" || arg === "off" || arg === "compact") {
+				if (ctx?.mode !== "tui" || !ctx?.hasUI) {
+					ctx.ui?.notify?.("/ccstyle requires TUI mode", "warning");
+					return;
+				}
+				if (isFullscreenUi(ctx)) {
+					ctx.ui.notify(
+						"ccstyle 渲染已在 fullscreen 模式下让位给官方 TUI；请切换到 regular 模式后使用 /ccstyle",
+						"warning",
 					);
-				else ctx.ui?.notify?.("/ccstyle requires TUI mode", "warning");
-				return;
-			}
-			if (arg === "on" || arg === "off" || arg === "compact") {
+					return;
+				}
 				const hooks = ensureTuiInstallation(ctx);
-				if (hooks) applyStyleMode(arg, ctx, hooks.compactStyle, hooks.toolGrouping);
-				else ctx.ui?.notify?.("/ccstyle requires TUI mode", "warning");
+				if (!hooks) return;
+				if (!arg || arg === "panel") {
+					await showCcstylePanel(ctx, hooks.compactStyle, hooks.toolGrouping, compactThinking);
+				} else {
+					applyStyleMode(arg, ctx, hooks.compactStyle, hooks.toolGrouping);
+				}
 				return;
 			}
 			if (arg === "status") {

package/extensions/compact-thinking.ts

@@ -2,7 +2,7 @@ import * as piAi from "@earendil-works/pi-ai";
 import * as piCodingAgent from "@earendil-works/pi-coding-agent";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import * as piTui from "@earendil-works/pi-tui";
-import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { readFileSync, rmSync } from "node:fs";
 import { createRequire } from "node:module";
 import { homedir } from "node:os";
 import { join } from "node:path";
@@ -188,20 +188,16 @@ export function installCompactThinking(
 		host[COMPACT_THINKING_OWNER]?.stop(event, ctx);
 		session = { event, ctx };
 
-		// upstream lib/config.ts 在模块顶层读取 compact-thinking.json，缺失时
-		// 会自建默认配置；预写我们的配置供其读取，加载完成后立即删除，
-		// 不在 .pi/agent 下残留文件（文件原本存在时保持不动）。
+		// compact-thinking.json 已日落：不预写、不读取，配置统一由
+		// claude-code-style.json 管控（下方 Object.assign 覆盖库默认值）。
+		// 库首次加载会在 .pi/agent 下自建默认文件，加载完成后立即删除，不留残留。
 		const agentDir = process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
 		const configPath = join(agentDir, "compact-thinking.json");
-		const fileExisted = existsSync(configPath);
-		if (!fileExisted) {
-			writeFileSync(configPath, `${JSON.stringify(initialConfig, null, 2)}\n`, "utf8");
-		}
 		let loaded: ReturnType<typeof loadPatchedUpstream>;
 		try {
 			loaded = loadPatchedUpstream();
 		} finally {
-			if (!fileExisted) rmSync(configPath, { force: true });
+			rmSync(configPath, { force: true });
 		}
 		upstreamConfig = loaded.config;
 		Object.assign(upstreamConfig, initialConfig);

package/extensions/fixed-editor.ts

@@ -2,6 +2,7 @@ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import * as piCodingAgent from "@earendil-works/pi-coding-agent";
 import * as piTui from "@earendil-works/pi-tui";
 import { visibleWidth } from "@earendil-works/pi-tui";
+import { isFullscreenUi, isLazyProxyTui } from "./fullscreen-detect.ts";
 import { createJiti } from "jiti";
 
 type LifecycleHandler = (event: any, ctx: any) => void;
@@ -196,8 +197,25 @@ export function installFixedEditorImePatch(compositorClass: {
 	}
 }
 
+const COMPOSITOR_PROXY_GUARD = Symbol.for("pi.ccstyle.compositor-proxy-guard");
+
 if (terminalSplit.TerminalSplitCompositor) {
 	installFixedEditorImePatch(terminalSplit.TerminalSplitCompositor);
+	// 0.84+ 的 tui 是惰性 Proxy：compositor 构造时捕获的 doRender/render 是
+	// 每次重新解析的包装，install 后执行会解析到 compositor 自身（无限递归）。
+	// 检测到惰性 Proxy 时跳过安装，渲染管线完全交给官方。
+	installProxyGuard(terminalSplit.TerminalSplitCompositor);
+}
+
+function installProxyGuard(compositorClass: { prototype: Record<PropertyKey, any> }): void {
+	const prototype = compositorClass.prototype;
+	const originalInstall = prototype.install;
+	if (typeof originalInstall !== "function" || prototype[COMPOSITOR_PROXY_GUARD]) return;
+	prototype[COMPOSITOR_PROXY_GUARD] = true;
+	prototype.install = function (this: any, ...args: any[]) {
+		if (isLazyProxyTui(this.tui)) return;
+		return Reflect.apply(originalInstall, this, args);
+	};
 }
 
 export type FixedEditorController = {
@@ -320,6 +338,8 @@ export function installFixedEditor(
 	}
 	function activate() {
 		if (!session || session.ctx?.mode !== "tui" || active) return;
+		// fullscreen 复用官方的 sticky editor，固定编辑器让位
+		if (isFullscreenUi(session.ctx)) return;
 		const previous = (globalThis as any)[FIXED_EDITOR_OWNER] as FixedEditorOwner | undefined;
 		if (previous?.owner !== owner) previous?.stop();
 		const currentSession = session;

package/extensions/fullscreen-detect.ts

@@ -0,0 +1,38 @@
+// fullscreen 模式探测：官方 fullscreen TUI（TuiAltScreen）由官方独占布局，
+// 插件渲染层应让位。检测方式是瞬时 setWidget 拿 tui 实例检查 mode。
+const PROBE_KEY = "cc-fullscreen-probe";
+
+/**
+ * 官方 0.84+ 的 tui 引用是惰性 Proxy（createInteractiveTuiReference）：
+ * 函数属性每次 get 都返回新包装，执行时才解析到当前实现。
+ * 通过它捕获 doRender/render/handleInput 会解析到自身形成无限递归，
+ * 因此检测到惰性 Proxy 时必须跳过所有"捕获后包装"类 patch。
+ */
+export function isLazyProxyTui(tui: any): boolean {
+	if (!tui || typeof tui !== "object") return false;
+	const probe = tui.requestRender;
+	return typeof probe === "function" && probe !== tui.requestRender;
+}
+
+/**
+ * 探测当前会话的 TUI 是否运行在官方 fullscreen 模式。
+ * 无 setWidget 的环境（测试 mock）视为 regular。
+ */
+export function isFullscreenUi(ctx: { ui?: any }): boolean {
+	if (typeof ctx?.ui?.setWidget !== "function") return false;
+	let fullscreen = false;
+	try {
+		ctx.ui.setWidget(PROBE_KEY, (tui: any) => {
+			fullscreen = tui?.mode === "fullscreen";
+			return { render: () => 0, invalidate() {} };
+		});
+	} catch {
+		// 探测失败按 regular 处理，避免误伤
+	}
+	try {
+		ctx.ui.setWidget(PROBE_KEY, undefined);
+	} catch {
+		// 忽略
+	}
+	return fullscreen;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-cc-extensions",
-	"version": "0.8.42",
+	"version": "0.8.43",
 	"license": "MIT",
 	"description": "A Pi productivity suite with Claude Code-style UI, fixed editor, context inspection, and agent/session references",
 	"type": "module",
@@ -55,9 +55,9 @@
 		"@tifan/pi-fixed-editor"
 	],
 	"peerDependencies": {
-		"@earendil-works/pi-ai": "*",
-		"@earendil-works/pi-coding-agent": "*",
-		"@earendil-works/pi-tui": "*"
+		"@earendil-works/pi-ai": "^0.84.0",
+		"@earendil-works/pi-coding-agent": "^0.84.0",
+		"@earendil-works/pi-tui": "^0.84.0"
 	},
 	"engines": {
 		"node": ">=22.19.0"