pi-cc-extensions 0.7.9 → 0.7.11

package/README.md

@@ -50,9 +50,9 @@
 
 `extensions/claude-code-style.ts` 提供：
 
-- Claude Code 风格的工具调用行与结果摘要
+- Claude Code 风格的工具调用行与结果摘要（默认覆盖普通工具 renderer）
 - Pi 默认输入栏
-- 未被专用 renderer 接管的工具兜底渲染
+- 通过 `excludeRenderers` 保留指定工具的原生或扩展 renderer
 - 工具结果的折叠与展开
 - 类 claude code 滚动到底部 button
 
@@ -65,6 +65,17 @@
 /ccstyle status      # 查看状态
 ```
 
+需要保留指定工具的原生或扩展 renderer 时，编辑 `~/.pi/agent/claude-code-style.json`：
+
+```json
+{
+  "enabled": true,
+  "excludeRenderers": ["edit", "write"]
+}
+```
+
+名单使用精确工具名；修改后执行 `/reload`。`Agent` 的专用 renderer 始终保留。
+
 ### 上下文窗口查看
 
 `extensions/context.ts` 注册 `/context`，展示当前上下文窗口的使用分布，并可进一步预览：
@@ -141,3 +152,23 @@ pi install /absolute/path/to/pi-cc-extensions
 
 - Node.js `>=22.19.0`
 - 作为 Pi package 加载，入口由根目录 `package.json` 的 `pi.extensions` 显式声明
+
+## 扩展推荐
+
+
+| 扩展                                     | 作用                                                                          |
+| ------------------------------------------ | ------------------------------------------------------------------------------- |
+| `npm:pi-theme-picker`                    | 通过`/theme` 交互式切换 Pi 主题，支持模糊搜索和实时预览                       |
+| `npm:@juicesharp/rpiv-ask-user-question` | 提供`ask_user_question` 结构化问卷工具，支持单选、多选、预览和备注            |
+| `npm:pi-mcp-adapter`                     | 将 MCP 服务接入 Pi，并通过代理工具按需发现，减少上下文占用                    |
+| `npm:@tintinweb/pi-subagents`            | Claude Code 风格的并行 SubAgent、后台任务、任务编排、工作树隔离和自定义 Agent |
+| `npm:@ayulab/pi-rewind`                  | 基于 checkpoint 的`/rewind` 回退，支持分别恢复代码、对话或两者                |
+| `npm:pi-compact-thinking`                | 将隐藏的思考块渲染为紧凑、带动画的推理预览                                    |
+| `npm:pi-startup-header`                  | 用跟随当前主题配色的渐变 ASCII 标题替换默认启动头                             |
+| `npm:pi-zentui`                          | Starship 风格状态栏与 Opencode 风格编辑器，支持固定编辑器和 Git 状态          |
+
+### 使用注意
+
+- `pi-cc-extensions` 与 `pi-zentui` 都会修改 Pi 的 TUI / renderer。若出现布局或渲染冲突，建议先确定一个作为主要界面扩展，另一个按需停用。
+- `pi-mcp-adapter` 默认延迟连接 MCP 服务，有助于节省上下文；包含凭据的 MCP 配置不要提交到仓库。
+- `pi-compact-thinking` 和 `pi-zentui` 都涉及 Pi 内部 UI 行为，升级 Pi 后若出现异常，优先执行 `/reload` 或暂时停用对应扩展。

package/extensions/claude-code-style.ts

@@ -12,8 +12,8 @@ import { join } from "node:path";
 /**
  * Claude Code Style for pi
  *
- * Tool calls and results use a compact fallback renderer. Dedicated renderers
- * supplied by other extensions remain untouched. A collapsed tool result can be
+ * Tool calls and results use a compact fallback renderer by default. Renderers
+ * listed in excludeRenderers remain untouched. A collapsed tool result can be
  * clicked on its Ctrl+O hint to expand only that tool.
  *
  * Dynamic commands:
@@ -28,6 +28,7 @@ import { join } from "node:path";
 
 type Config = {
 	enabled: boolean;
+	excludeRenderers: string[];
 };
 
 const CONFIG_PATH = join(homedir(), ".pi", "agent", "claude-code-style.json");
@@ -38,14 +39,18 @@ function loadConfig(): Config {
 	try {
 		if (existsSync(CONFIG_PATH)) {
 			const parsed = JSON.parse(readFileSync(CONFIG_PATH, "utf8")) as Partial<Config>;
+			const excludeRenderers = Array.isArray(parsed.excludeRenderers)
+				? [...new Set(parsed.excludeRenderers.filter((name): name is string => typeof name === "string" && name.length > 0))]
+				: [];
 			return {
 				enabled: parsed.enabled ?? true,
+				excludeRenderers,
 			};
 		}
 	} catch {
 		// Ignore bad config and fall back to defaults.
 	}
-	return { enabled: true };
+	return { enabled: true, excludeRenderers: [] };
 }
 
 function saveConfig() {
@@ -1069,10 +1074,9 @@ function createCcstyleTool(originalTool: any): any {
 
 /**
  * This extension does not register tools. ToolExecutionComponent is shared by
- * the TUI and exported by pi; patch its renderer lookup once so generic tools
- * use the same compact fallback shell.
- * Native Pi tools and extension tools without a dedicated renderer can use the
- * fallback; subagents and extension-owned renderers keep their own output.
+ * the TUI and exported by pi; patch its renderer lookup once so tools use the
+ * same compact fallback shell by default. Tools named in excludeRenderers keep
+ * their original renderer; subagent rendering remains protected.
  */
 const GLOBAL_TOOL_RENDER_PATCH = Symbol.for("pi.ccstyle.global-tool-render-patch");
 const COMPONENT_TOOL_RENDER_MODE = Symbol.for("pi.ccstyle.component-tool-render-mode");
@@ -1098,21 +1102,20 @@ function isMcpToolDefinition(definition: any, toolName: string): boolean {
 	return toolName === "mcp" || label === "MCP" || label.startsWith("MCP: ");
 }
 
-/**
- * ToolExecutionComponent keeps extension-supplied and native definitions in
- * separate fields. Native renderers are eligible for ccstyle's fallback, while
- * an extension-owned dedicated renderer must remain untouched.
- */
+/** Return true when this tool must keep its original renderer. */
 export function preservesOriginalRenderer(
 	extensionDefinition: any,
 	toolName: string,
 	builtInToolDefinition?: any,
+	excludeRenderers: readonly string[] = config.excludeRenderers,
 ): boolean {
 	if (SUBAGENT_TOOL_NAMES.has(toolName)) return true;
-	if (!extensionDefinition || extensionDefinition === builtInToolDefinition) return false;
-	return extensionDefinition.renderShell === "self"
-		|| typeof extensionDefinition.renderCall === "function"
-		|| typeof extensionDefinition.renderResult === "function";
+	if (!excludeRenderers.includes(toolName)) return false;
+	return [extensionDefinition, builtInToolDefinition].some((definition) =>
+		definition?.renderShell === "self"
+		|| typeof definition?.renderCall === "function"
+		|| typeof definition?.renderResult === "function",
+	);
 }
 
 function shouldGloballyStyleTool(component: any, patch: GlobalToolRenderPatch): boolean {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-cc-extensions",
-  "version": "0.7.9",
+  "version": "0.7.11",
   "description": "A Pi productivity suite with Claude Code-style UI, context inspection, and agent/session references",
   "type": "module",
   "keywords": [