@yinan_chen/pi-claude-code-ui 0.2.1 → 0.3.0

package/README.md

@@ -26,6 +26,57 @@ pi -e npm:@yinan_chen/pi-claude-code-ui
 - **工作状态提示** — working message / running effect
 - **只读工具美化** — read/bash/grep/find/ls 结果渲染
 
+## 配置
+
+配置文件：`~/.pi/agent/lean-tidy.json`（不存在时全部使用默认值）：
+
+```json
+{
+  "profile": "claude",
+  "skillRendering": "native",
+  "subagentRendering": "claude",
+  "detailsBackground": "selectedBg",
+  "bashPreviewLines": 0,
+  "codePreviewLines": 0,
+  "errorPreviewLines": 0,
+  "liveThinking": true,
+  "thinkingTailLines": 5,
+  "foldAnimMs": 240,
+  "stickyIncludeCustom": false,
+  "skillResumePreview": true,
+  "resultPrefix": "└",
+  "diff": {
+    "diffViewMode": "auto",
+    "diffIndicatorMode": "bars",
+    "diffSplitMinWidth": 120,
+    "editDiffCollapsedLines": 0,
+    "writeDiffCollapsedLines": 0,
+    "diffWordWrap": true,
+    "expandedPreviewMaxLines": 40
+  }
+}
+```
+
+| 键 | 默认 | 说明 |
+|---|---|---|
+| `profile` | `"claude"` | 整体风格：`claude` / `native`（pi 原生） |
+| `skillRendering` | `"native"` | skill 块样式：pi 原生折叠行 / `claude` 两行风格 |
+| `subagentRendering` | `"claude"` | 子代理完成通知：`claude` 分支风格 / `native` 保留包内面板 |
+| `detailsBackground` | `"selectedBg"` | 详情背景色（主题色键名，可选 `customMessageBg`/`toolPendingBg`/`toolSuccessBg`/`toolErrorBg`/`""`） |
+| `bash/code/errorPreviewLines` | `0`/`0`/`0` | 三类工具结果的预览行数（0–100；0 = 默认折叠） |
+| `liveThinking` | `true` | 思考过程流式展示 |
+| `thinkingTailLines` | `5` | 思考尾行数 |
+| `foldAnimMs` | `240` | 折叠动画时长（ms，0 关闭） |
+| `stickyIncludeCustom` | `false` | 吸附泡是否包含扩展注入/跨会话转发的旁路消息 |
+| `skillResumePreview` | `true` | `/resume` 列表预览是否折回 `[skill] 名` 单行 |
+| `resultPrefix` | `"└"` | 工具结果行拐角前缀（制表符族，等宽字体最稳；可换 `↳` 或 Claude Code 官方的 `⎿`，后两者在部分字体下会变宽） |
+| `diff.diffViewMode` | `"auto"` | diff 视图：`auto`/`split`/`unified` |
+| `diff.diffIndicatorMode` | `"bars"` | 变更指示条：`bars`/`classic`/`none` |
+| `diff.diffSplitMinWidth` | `120` | 宽于此才用 split 视图 |
+| `diff.edit/writeDiffCollapsedLines` | `0`/`0` | edit/write 默认折叠行数（0 = 默认展开） |
+| `diff.diffWordWrap` | `true` | diff 自动换行 |
+| `diff.expandedPreviewMaxLines` | `40` | 展开后最多显示行数 |
+
 ## 兼容性
 
 按 `VERIFIED_PI_VERSION = 1.0.2` 验收；版本不一致时扩展会在 session 启动时提示一次。

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@yinan_chen/pi-claude-code-ui",
-	"version": "0.2.1",
+	"version": "0.3.0",
 	"description": "Claude Code-style UI for Pi: transcript view, rich diffs, subagent panels and working-message status.",
 	"type": "module",
 	"license": "MIT",

package/src/claude-tools.ts

@@ -3,6 +3,9 @@ import { getLanguageFromPath, highlightCode, keyText } from "@earendil-works/pi-
 import { truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
 import { homedir } from "node:os";
 
+/** UI 符号集（lean-tidy.json 可覆盖；见 index.ts loadConfig 的 resultPrefix）。 */
+export const SYMBOLS = { resultPrefix: "└" };
+
 export interface ToolView {
 	name: string;
 	args: Record<string, any>;
@@ -194,12 +197,12 @@ export function summaryOf(v: ToolView, theme: any): string | undefined {
 export function paintTool(v: ToolView, theme: any, width: number, config: ToolAppearance): PaintedTool {
 	const lines = headerOf(v, theme, width), headerHeight = lines.length;
 	let moreRow: number | undefined;
-	const result = (s: string) => lines.push(...prefixed(s, width, `   ${fg(theme, "dim", "⎿")}  `, "      "));
+	const result = (s: string) => lines.push(...prefixed(s, width, `   ${fg(theme, "dim", SYMBOLS.resultPrefix)}  `, "      "));
 	const body = (source: string[], limit: number, full = v.expanded, firstResult = false) => {
 		const shown = full ? source : source.slice(0, limit);
 		let clipped = false;
 		shown.forEach((line, i) => {
-			const first = firstResult && i === 0 ? `   ${fg(theme, "dim", "⎿")}  ` : "      ";
+			const first = firstResult && i === 0 ? `   ${fg(theme, "dim", SYMBOLS.resultPrefix)}  ` : "      ";
 			if (full) lines.push(...prefixed(line, width, first, "      "));
 			else {
 				const pw = Math.min(6, Math.max(0, width - 1)), bw = Math.max(1, width - pw);

package/src/claude-view.ts

@@ -1,7 +1,7 @@
 /** Pi-specific transcript adapter. All private component fields are isolated here. */
 import { Box, Container, Markdown, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { getMarkdownTheme, keyText } from "@earendil-works/pi-coding-agent";
-import { BUILTIN_NAMES, PROCESS_TOOL_NAMES, bold, canExpandTool, expandHint, failedTool, fg, fit, headerOf, isBlank, isImageLine, oneLine, paintBackground, paintTool, prefixed, prefixZones, targetOf, type ToolAppearance, type ToolView } from "./claude-tools.ts";
+import { BUILTIN_NAMES, PROCESS_TOOL_NAMES, bold, canExpandTool, expandHint, failedTool, fg, fit, headerOf, isBlank, isImageLine, oneLine, paintBackground, paintTool, prefixed, prefixZones, SYMBOLS, targetOf, type ToolAppearance, type ToolView } from "./claude-tools.ts";
 import { animateRunningSummary } from "./running-effect.ts";
 
 export interface ClaudeConfig extends ToolAppearance {
@@ -313,7 +313,7 @@ export function createClaudeView(
 			if (raw.length > rowsLeft) { hidden += raw.length - rowsLeft; raw = raw.slice(0, Math.max(0, rowsLeft)); }
 			rowsLeft -= raw.length;
 			const start = lines.length;
-			for (let i = 0; i < raw.length; i++) lines.push(isImageLine(raw[i]) ? raw[i] : fit(truncateToWidth(start + i === 0 ? `   ${fg(theme(), "dim", "⎿")}  ` : "      ", indent, "") + raw[i], width));
+			for (let i = 0; i < raw.length; i++) lines.push(isImageLine(raw[i]) ? raw[i] : fit(truncateToWidth(start + i === 0 ? `   ${fg(theme(), "dim", SYMBOLS.resultPrefix)}  ` : "      ", indent, "") + raw[i], width));
 			const proxy = {
 				handleMouse(e: any) {
 					if (e.x < indent) return undefined;
@@ -346,7 +346,7 @@ export function createClaudeView(
 				const last = entries.at(-1);
 				if (last && --last.height <= 0) entries.pop();
 			}
-			const more = prefixed(fg(theme(), "dim", `… +${hidden} lines`) + expandHint(theme()), width, `   ${fg(theme(), "dim", "⎿")}  `, "      ");
+			const more = prefixed(fg(theme(), "dim", `… +${hidden} lines`) + expandHint(theme()), width, `   ${fg(theme(), "dim", SYMBOLS.resultPrefix)}  `, "      ");
 			lines.push(...more);
 			entries.push({ component: toggleTool(self), height: more.length });
 		}
@@ -368,7 +368,7 @@ export function createClaudeView(
 			lines = [...head, ...(body?.lines ?? [])];
 			entries = [{ component: toggleTool(self), height: head.length }, ...(body?.entries ?? [])];
 			if (v.partial && !body?.lines.length) {
-				const pending = prefixed(fg(t, "dim", v.started ? "Running…" : "Waiting…"), width, `   ${fg(t, "dim", "⎿")}  `, "      ");
+				const pending = prefixed(fg(t, "dim", v.started ? "Running…" : "Waiting…"), width, `   ${fg(t, "dim", SYMBOLS.resultPrefix)}  `, "      ");
 				lines.push(...pending); entries.push({ component: {}, height: pending.length });
 			}
 		} else {
@@ -390,7 +390,7 @@ export function createClaudeView(
 						// The vendored renderer limits body rows and supplies its own remainder hint.
 						// Do not also slice by codePreviewLines: that counts the diff header/frame
 						// against the body and hides almost every changed row.
-						const prefix = `   ${fg(t, "dim", "⎿")}  `;
+						const prefix = `   ${fg(t, "dim", SYMBOLS.resultPrefix)}  `;
 						// The rich edit header already reports +N/-M; do not repeat
 						// paintTool's "Added N lines, removed M lines" summary above it.
 						const introRows = painted.headerHeight + (v.name === "edit" ? 0 : 1);
@@ -610,7 +610,7 @@ export function createClaudeView(
 			if (active && tools.length) {
 				const focus = [...tools].reverse().find((p) => p.owner.isPartial) ?? tools.at(-1)!;
 				const v = toolView(focus.owner), target = targetOf(v.name, v.args, v.cwd).text;
-				if (target) rows.push(...prefixed(fg(theme(), "muted", (v.name === "bash" || v.name === "powershell" ? "$ " : "") + target), width, `   ${fg(theme(), "dim", "⎿")}  `, "      ").slice(0, 2));
+				if (target) rows.push(...prefixed(fg(theme(), "muted", (v.name === "bash" || v.name === "powershell" ? "$ " : "") + target), width, `   ${fg(theme(), "dim", SYMBOLS.resultPrefix)}  `, "      ").slice(0, 2));
 			}
 			append(rows, toggle);
 			// Failures stay folded like the rest: the summary counts them ("N failed")
@@ -700,7 +700,7 @@ export function createClaudeView(
 				return trimmed;
 			}
 			const name = oneLine(self.skillBlock.name), lines = [` ${fg(theme(), "success", "●")} ${bold(theme(), "Skill")}(${name})`];
-			lines.push(...prefixed(fg(theme(), "muted", "Loaded skill") + (self.expanded ? "" : ` (${keyText("app.tools.expand")} to expand)`), width, `   ${fg(theme(), "dim", "⎿")}  `, "      "));
+			lines.push(...prefixed(fg(theme(), "muted", "Loaded skill") + (self.expanded ? "" : ` (${keyText("app.tools.expand")} to expand)`), width, `   ${fg(theme(), "dim", SYMBOLS.resultPrefix)}  `, "      "));
 			if (self.expanded) {
 				const md = new Markdown(self.skillBlock.content ?? "", 0, 0, self.markdownTheme ?? getMarkdownTheme());
 				for (const l of md.render(Math.max(1, width - 3))) lines.push(fit("   " + l, width));

package/src/index.ts

@@ -29,6 +29,7 @@ import { createClaudeView } from "./claude-view.ts";
 import registerSubagentPanels from "./subagent-panel.ts";
 import stickyFirstMessage from "./sticky-first-message.ts";
 import registerSkillRecollapse from "./skill-block-recollapse.ts";
+import { SYMBOLS } from "./claude-tools.ts";
 import registerWorkingMessage from "./working-message.ts";
 // Vendored rich diff (MIT; see vendor/diff/ATTRIBUTION.md).
 import { renderRichToolResult, WriteExecutionMetadataStore } from "./vendor/diff/index.ts";
@@ -76,6 +77,12 @@ interface Config {
 	liveThinking: boolean;
 	thinkingTailLines: number;
 	foldAnimMs: number;
+	/** sticky 吸附池是否含 CustomMessage（扩展注入/跨会话转发），默认 false。 */
+	stickyIncludeCustom: boolean;
+	/** /resume 列表预览是否折回 [skill] 名，默认 true。 */
+	skillResumePreview: boolean;
+	/** 工具结果行的拐角前缀符号（默认 └；可换 ↳ 或 Claude Code 官方的 ⎿）。 */
+	resultPrefix: string;
 }
 
 function loadConfig(): Config {
@@ -84,12 +91,15 @@ function loadConfig(): Config {
 		skillRendering: "native",
 		subagentRendering: "claude",
 		detailsBackground: "selectedBg",
-		bashPreviewLines: 1,
-		codePreviewLines: 3,
-		errorPreviewLines: 1,
+		bashPreviewLines: 0,
+		codePreviewLines: 0,
+		errorPreviewLines: 0,
 		liveThinking: true,
-		thinkingTailLines: 3,
+		thinkingTailLines: 5,
 		foldAnimMs: 240,
+		stickyIncludeCustom: false,
+		skillResumePreview: true,
+		resultPrefix: "└",
 	};
 	diffDisplayConfig = { ...DEFAULT_TOOL_DISPLAY_CONFIG };
 	try {
@@ -108,6 +118,9 @@ function loadConfig(): Config {
 			config.thinkingTailLines = Math.floor(data.thinkingTailLines);
 		}
 		if (Number.isFinite(data?.foldAnimMs) && data.foldAnimMs >= 0) config.foldAnimMs = Math.floor(data.foldAnimMs);
+		if (typeof data?.stickyIncludeCustom === "boolean") config.stickyIncludeCustom = data.stickyIncludeCustom;
+		if (typeof data?.skillResumePreview === "boolean") config.skillResumePreview = data.skillResumePreview;
+		if (typeof data?.resultPrefix === "string" && data.resultPrefix.trim()) config.resultPrefix = data.resultPrefix;
 		if (data?.diff && typeof data.diff === "object" && !Array.isArray(data.diff)) {
 			diffDisplayConfig = { ...DEFAULT_TOOL_DISPLAY_CONFIG, ...data.diff };
 		}
@@ -367,9 +380,10 @@ async function patchAllCopies(): Promise<ScanInfo> {
 
 export default async function leanTidy(pi: ExtensionAPI): Promise<void> {
 	registerWorkingMessage(pi);
-	await stickyFirstMessage(pi);
-	registerSkillRecollapse(pi);
 	const config = loadConfig();
+	SYMBOLS.resultPrefix = config.resultPrefix;
+	await stickyFirstMessage(pi, { includeCustom: config.stickyIncludeCustom });
+	registerSkillRecollapse(pi, { resumePreview: config.skillResumePreview });
 	// Subagent 通知接管必须发生在加载期（registerMessageRenderer 仅 factory 内合法）：
 	// lean-tidy 先于 npm 包加载，首个命中 customType 的渲染器胜出（一南 2026-02-12）。
 	// redraw 闭包延迟读 LAST_MODE（hookMode 后才看得到 TUI）。

package/src/skill-block-recollapse.ts

@@ -263,8 +263,11 @@ function patchForkPreview(): boolean {
  * 不回写 .jsonl。可用 PI_SKILL_RECOLLAPSE_RESUME=0 关闭这一处。
  * @returns 是否已处于「已打好补丁」状态
  */
+/** /resume 列表预览改写：json 显式配置（skillResumePreview） > env 兼容 > 默认开启 */
+let RESUME_PREVIEW = true;
+
 function patchResumePreview(): boolean {
-  if ((process.env.PI_SKILL_RECOLLAPSE_RESUME || "").trim() === "0") return true;
+  if (!RESUME_PREVIEW) return true;
   const cls = SessionManager as unknown as Record<string | symbol, unknown>;
   if (cls[RESUME_PATCHED]) return true;
 
@@ -293,7 +296,9 @@ function patchResumePreview(): boolean {
   return true;
 }
 
-export default function (pi: ExtensionAPI) {
+export default function (pi: ExtensionAPI, opts?: { resumePreview?: boolean }) {
+  // json 配置优先，未提供时回退旧 env 逃生口（PI_SKILL_RECOLLAPSE_RESUME=0），再回退默认 true。
+  RESUME_PREVIEW = opts?.resumePreview ?? (process.env.PI_SKILL_RECOLLAPSE_RESUME || "").trim() !== "0";
   /**
    * 计划一次「读回编辑器 → 命中则折叠」的补偿。
    * @param ctx 事件上下文，仅用 ctx.ui 的编辑器读写

package/src/sticky-first-message.ts

@@ -67,7 +67,10 @@ const VERSION = "2.2.1-20260910";
 
 const env = (k: string) => (process.env[k] || "").trim();
 const killed = () => env("PI_STICKY_FIRST_MESSAGE") === "0";
-const includeCustom = () => env("PI_STICKY_INCLUDE_CUSTOM") === "1";
+/** 是否吸附 CustomMessage：json 显式配置（stickyIncludeCustom，入口传入） > env 兼容 > 默认不吸附。
+ * 每次调用动态求值，json 未提供（undefined）时 env 可随时启停。 */
+let OPTS_INCLUDE_CUSTOM: boolean | undefined;
+const includeCustom = () => OPTS_INCLUDE_CUSTOM ?? env("PI_STICKY_INCLUDE_CUSTOM") === "1";
 /** 健康日志 + 快照落盘开关；默认关闭，不产生任何文件（状态机仍运行，仅不写盘） */
 const healthEnabled = () => env("PI_STICKY_HEALTH") === "1";
 
@@ -1087,7 +1090,9 @@ export const __stickyTest = {
 	}),
 };
 
-export default async function stickyFirstMessage(pi: ExtensionAPI): Promise<void> {
+export default async function stickyFirstMessage(pi: ExtensionAPI, opts?: { includeCustom?: boolean }): Promise<void> {
+	// json 配置优先（undefined = 未配置，回退旧 env 开关 PI_STICKY_INCLUDE_CUSTOM=1，再回退默认 false）。
+	OPTS_INCLUDE_CUSTOM = opts?.includeCustom;
 	// 主题探针：零高 widget，只为拿到 (tui, theme) 里的 theme（泡的底色/前景跟随主题）
 	pi.on("session_start", async (_e, ctx: any) => {
 		if (!ctx?.hasUI || typeof ctx.ui?.setWidget !== "function") return;

package/src/subagent-panel.ts

@@ -22,7 +22,7 @@
  * host 驱动，两者 OR 叠加。
  */
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { bold, expandHint, fg, fit, linesOf, oneLine, prefixed } from "./claude-tools.ts";
+import { bold, expandHint, fg, fit, linesOf, oneLine, prefixed, SYMBOLS } from "./claude-tools.ts";
 
 /** 只用到 pi 传入 options 的 expanded；outputPad 由内置 Spacer(1) 承担，忽略。 */
 interface PanelOptions {
@@ -35,7 +35,7 @@ export interface SubagentPanelHooks {
 }
 
 /** ⎿ 分支前缀，与 claude-view.ts 工具结果/技能块同款（3 空格 + ⎿ + 2 空格，续行 6 空格）。 */
-const branch = (theme: any): string => `   ${fg(theme, "dim", "⎿")}  `;
+const branch = (theme: any): string => `   ${fg(theme, "dim", SYMBOLS.resultPrefix)}  `;
 const BRANCH_REST = "      ";
 
 /** 与该包 ui/agent-widget.ts 的 formatTokens 对齐："33.8k token" / "1.2M token"。 */

package/src/vendor/diff-config.ts

@@ -20,7 +20,7 @@ export const DEFAULT_TOOL_DISPLAY_CONFIG: ToolDisplayConfig = {
 	diffViewMode: "auto",
 	diffIndicatorMode: "bars",
 	diffSplitMinWidth: 120,
-	editDiffCollapsedLines: 24,
+	editDiffCollapsedLines: 0,
 	writeDiffCollapsedLines: 0,
 	diffWordWrap: true,
 	expandedPreviewMaxLines: 40,