pi-cc-extensions 0.8.48 → 0.8.50

package/README.en.md

@@ -29,32 +29,30 @@
 
 ```bash
 pi install npm:pi-cc-extensions
-```
-
-Run `/reload` after installation, then try:
 
-```text
-/ccstyle       # Configure output and rich diffs
-/context       # Inspect context usage
-@              # Complete Agents, Sessions, and files
+# GitHub
+pi install git:github.com/minuque/pi-cc-extensions
 ```
 
+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, and a back-to-bottom button | `/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` / `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`    |
 
 ## Configuration
 
 `/ccstyle` behavior is configured through `~/.pi/agent/claude-code-style.json`:
 
-```json
+```js
 {
   "mode": "on",                            // on: Claude Code-style output; off: Pi native rendering
   "excludeRenderers": [],                  // exact tool names that keep their native renderer; Agent always keeps its dedicated renderer
@@ -66,33 +64,18 @@ Run `/reload` after installation, then try:
   "expandedPreviewMaxLines": 40,           // max body lines for expanded output/diff
   "useSummaryTitlesAsThinkingTitle": true, // use the latest provider summary as the active thinking title
   "previewLines": 3,                       // thinking preview lines; 0 hides the preview body
-  "animationIntervalMs": 90                // thinking title animation interval in ms
+  "animationIntervalMs": 90,               // thinking title animation interval in ms
+  "showStartupHeader": true,               // custom startup header (logo + tips) toggle
+  "scrollStepLines": 3                     // fullscreen mouse wheel scroll lines
 }
 ```
 
-### `@` references
-
-- Enter `@session:` to reference a previous Session.
-- Enter `@agent-name` to delegate to a custom Agent.
-- Compatible with `@bacnh85/pi-fff` and `@tintinweb/pi-subagents`.
-- Session context is deduplicated and size-limited before injection.
-
-## Other installation methods
-
-```bash
-# GitHub
-pi install git:github.com/minuque/pi-cc-extensions
-
-# Local repository
-pi install /absolute/path/to/pi-cc-extensions
-```
-
 ## Local development
 
 ```bash
 npm test
 npm run typecheck
-pi -e .
+./test.bat # or pi -e .
 ```
 
 Run `/reload` after changing extensions.
@@ -121,5 +104,3 @@ Run `/reload` after changing extensions.
 ## Credits
 
 - Rich diffs are adapted from [`MasuRii/pi-tool-display`](https://github.com/MasuRii/pi-tool-display) (MIT). See [`extensions/tool-diff/ATTRIBUTION.md`](./extensions/tool-diff/ATTRIBUTION.md).
-- Startup header based on [`EnderLiquid/pi-startup-header`](https://github.com/EnderLiquid/pi-startup-header) (MIT).
-- Command aliases based on [`xRyul/pi-aliases`](https://github.com/xRyul/pi-aliases) (MIT).

package/README.md

@@ -39,19 +39,20 @@ pi install git:github.com/minuque/pi-cc-extensions
 ## 功能
 
 
-| 功能                 | 说明                                                                | 入口        |
-| ---------------------- | --------------------------------------------------------------------- | ------------- |
-| Claude Code 风格输出 | 工具摘要、折叠展开、rich edit/write diff，以及`on` / `off` 两种模式 | `/ccstyle`  |
-| Fullscreen 鼠标交互  | 工具卡/group 点击展开与收起、`[show more]` 预览、回到底部按钮       | `/ccstyle`  |
-| 上下文检查           | 查看上下文占用，并预览 System prompt、Tools、Skills 和消息内容      | `/context`  |
-| Session 引用         | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文                 | `@session:` |
-| 主题                 | 随包提供内置 CC Dark、CC Light 主题                                 | `/theme`    |
+| 功能                 | 说明                                                                                                                   | 入口        |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------ | ------------- |
+| 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`    |
 
 ## 配置
 
 `/ccstyle` 的行为由 `~/.pi/agent/claude-code-style.json` 配置：
 
-```json
+```js
 {
   "mode": "on",                            // on：Claude Code 风格输出；off：Pi 原生渲染
   "excludeRenderers": [],                  // 走原生渲染的工具名列表（精确匹配），Agent 始终保留专用渲染器
@@ -63,7 +64,9 @@ pi install git:github.com/minuque/pi-cc-extensions
   "expandedPreviewMaxLines": 40,           // 展开后输出/diff 正文的最大行数
   "useSummaryTitlesAsThinkingTitle": true, // 用最新 provider 摘要作为思考标题
   "previewLines": 3,                       // thinking 预览行数，0 隐藏预览正文
-  "animationIntervalMs": 90                // thinking 标题动画间隔（毫秒）
+  "animationIntervalMs": 90,               // thinking 标题动画间隔（毫秒）
+  "showStartupHeader": true,               // 自定义启动头（logo + tips）开关
+  "scrollStepLines": 3                     // fullscreen 滚轮滚动步进行数
 }
 ```
 
@@ -72,7 +75,7 @@ pi install git:github.com/minuque/pi-cc-extensions
 ```bash
 npm test
 npm run typecheck
-pi -e .
+./test.bat # or pi -e .
 ```
 
 修改扩展后执行 `/reload`。
@@ -101,5 +104,3 @@ pi -e .
 ## 致谢
 
 - Rich diff 改编自 [`MasuRii/pi-tool-display`](https://github.com/MasuRii/pi-tool-display)（MIT）；详见 [`extensions/tool-diff/ATTRIBUTION.md`](./extensions/tool-diff/ATTRIBUTION.md)。
-- 启动头基于 [`EnderLiquid/pi-startup-header`](https://github.com/EnderLiquid/pi-startup-header)（MIT）。
-- 命令别名基于 [`xRyul/pi-aliases`](https://github.com/xRyul/pi-aliases)（MIT）。

package/extensions/config/config.ts

@@ -0,0 +1,245 @@
+import type { CompactThinkingConfig } from "../feature/compact-thinking.ts";
+import {
+	DEFAULT_TOOL_DISPLAY_CONFIG,
+	type DiffIndicatorMode,
+	type DiffViewMode,
+	type ToolDisplayConfig,
+} from "../renderer/tool-diff/index.ts";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+export type CompactStyleMode = "on" | "off";
+
+export type Config = {
+	mode: CompactStyleMode;
+	excludeRenderers: string[];
+	diffViewMode: DiffViewMode;
+	diffIndicatorMode: DiffIndicatorMode;
+	diffSplitMinWidth: number;
+	diffCollapsedLines: number;
+	diffWordWrap: boolean;
+	expandedPreviewMaxLines: number;
+	useSummaryTitlesAsThinkingTitle: boolean;
+	previewLines: number;
+	animationIntervalMs: number;
+	showStartupHeader: boolean;
+	scrollStepLines: number;
+};
+
+const AGENT_DIR = process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
+const CONFIG_PATH = join(AGENT_DIR, "claude-code-style.json");
+
+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"];
+/** 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"];
+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,
+	diffCollapsedLines: DEFAULT_TOOL_DISPLAY_CONFIG.diffCollapsedLines,
+	diffWordWrap: DEFAULT_TOOL_DISPLAY_CONFIG.diffWordWrap,
+	expandedPreviewMaxLines: DEFAULT_TOOL_DISPLAY_CONFIG.expandedPreviewMaxLines,
+	useSummaryTitlesAsThinkingTitle: true,
+	previewLines: 3,
+	animationIntervalMs: 90,
+	showStartupHeader: true,
+	scrollStepLines: 3,
+};
+
+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 nearestPreset(value: number, presets: readonly string[]): string {
+	const numeric = presets.map((p) => Number(p));
+	let best = presets[0] ?? String(value);
+	let bestDist = Number.POSITIVE_INFINITY;
+	for (let i = 0; i < numeric.length; i++) {
+		const dist = Math.abs((numeric[i] ?? 0) - value);
+		if (dist < bestDist) {
+			bestDist = dist;
+			best = presets[i] ?? best;
+		}
+	}
+	// Prefer exact match when value is already a preset.
+	const exact = presets.find((p) => Number(p) === value);
+	return exact ?? best;
+}
+
+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 风格）。
+	const migratedMode: CompactStyleMode =
+		mode === "on" || 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,
+		),
+		diffCollapsedLines: pickPositiveInt(
+			source.diffCollapsedLines,
+			DEFAULT_CONFIG.diffCollapsedLines,
+			1,
+			500,
+		),
+		diffWordWrap: source.diffWordWrap !== false,
+		expandedPreviewMaxLines: pickPositiveInt(
+			source.expandedPreviewMaxLines,
+			DEFAULT_CONFIG.expandedPreviewMaxLines,
+			10,
+			50_000,
+		),
+		useSummaryTitlesAsThinkingTitle: source.useSummaryTitlesAsThinkingTitle !== false,
+		previewLines: pickPositiveInt(
+			source.previewLines,
+			DEFAULT_CONFIG.previewLines,
+			0,
+			Number.MAX_SAFE_INTEGER,
+		),
+		animationIntervalMs: pickPositiveNumber(
+			source.animationIntervalMs,
+			DEFAULT_CONFIG.animationIntervalMs,
+		),
+		showStartupHeader: source.showStartupHeader !== false,
+		scrollStepLines: pickPositiveInt(
+			source.scrollStepLines,
+			DEFAULT_CONFIG.scrollStepLines,
+			1,
+			50,
+		),
+	};
+}
+
+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,
+		diffCollapsedLines: source.diffCollapsedLines,
+		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}`,
+		`diffCollapsed=${source.diffCollapsedLines}`,
+		`diffWordWrap=${source.diffWordWrap ? "on" : "off"}`,
+		`expandedMax=${source.expandedPreviewMaxLines}`,
+		`thinkingTitle=${source.useSummaryTitlesAsThinkingTitle ? "summary" : "default"}`,
+		`thinkingPreview=${source.previewLines}`,
+		`thinkingAnimation=${source.animationIntervalMs}ms`,
+		`startupHeader=${source.showStartupHeader ? "on" : "off"}`,
+		`scrollStep=${source.scrollStepLines}`,
+	].join(" · ");
+}
+
+export let config: Config = loadConfig();
+
+function loadConfig(): Config {
+	try {
+		const source = existsSync(CONFIG_PATH)
+			? (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") {
+			try {
+				writeFileSync(CONFIG_PATH, JSON.stringify(normalized, null, 2));
+			} catch {
+				// A read-only config still uses the migrated in-memory value.
+			}
+		}
+		return normalized;
+	} catch {
+		// Ignore bad config and fall back to defaults.
+	}
+	return { ...DEFAULT_CONFIG };
+}
+
+export function saveConfig() {
+	writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2));
+}
+
+/** 整体替换配置（default export 的 configOverride 注入路径；导入绑定不可重新赋值）。 */
+export function setConfig(next: Config): void {
+	config = next;
+}