# pi-plan-toggle

**Repository Path**: linbirg/pi-plan-toggle

## Basic Information

- **Project Name**: pi-plan-toggle
- **Description**: pi-plan-toggle extention
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-23
- **Last Updated**: 2026-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pi-plan-toggle

一键切换 **Plan ↔ Build** 模式 — 基于 `@narumitw/pi-plan-mode`。

| 快捷键 / 命令 | 动作 |
|--------------|------|
| `Tab` | 切换 Plan / Build 模式 |
| `/plan-toggle` | 切换 Plan / Build 模式（命令后备） |

> ⚠️ `Tab` 键在编辑器中有自动补全功能（`tui.input.tab`），如果冲突严重可用 `/plan-toggle` 命令代替。

## 安装

### 前置依赖

```bash
pi install npm:@narumitw/pi-plan-mode
```

推荐搭配 pi-zentui 获得更好的底部状态栏显示效果：

```bash
pi install npm:pi-zentui
```

### 安装本扩展

```bash
pi install git:gitee.com/linbirg/pi-plan-toggle.git
```

或在 `~/.pi/agent/settings.json` 的 `packages` 中添加：

```json
{
  "packages": [
    "npm:@narumitw/pi-plan-mode",
    "npm:pi-zentui",
    "git:gitee.com/linbirg/pi-plan-toggle.git"
  ]
}
```

## 使用

```bash
pi
# 进入 Plan 模式（只读探索 + 规划）
按 Tab 或输入 /plan-toggle
# 回到 Build 模式（正常编码）
再按 Tab 或输入 /plan-toggle
```

### Plan 模式效果

| 特性 | 说明 |
|------|------|
| **工具限制** | AI 只能使用 `read`, `bash`, `plan_mode_question`, `plan_mode_complete` |
| **Shell 安检** | 写操作 bash 命令（`git push`、`rm`、`>` 等）被拦截 |
| **Stderr 放行** | `2>/dev/null`、`2>&1` 等安全重定向不受阻 |
| **底部状态** | 目录行后显示高亮 `[plan]` 标签（需配合 pi-zentui） |
| **顶部通知** | 切换时显示临时通知气泡 |

### Plan 模式完成规则

覆写 plan-mode 提示词，要求 AI 先展示完整计划文本再提交，不得询问"是否展示"。

## 配合 pi-zentui 配置

在 `~/.pi/agent/zentui.json` 中配置 "plan" 状态显示在左侧并高亮：

```json
{
  "colors": {
    "extensionStatus": "accent"
  },
  "extensionStatuses": {
    "placements": {
      "plan-mode": "left"
    }
  }
}
```

| 配置项 | 说明 |
|--------|------|
| `colors.extensionStatus` | 标签颜色，`"accent"` 使用主题强调色 |
| `extensionStatuses.placements` | 位置：`"left"`、`"middle"`、`"right"`、`"off"` |

`/reload` 后效果：

```
~/DecaInsight (main) [plan]  ↑1.4M ↓128k $0.323  26.8%/1.0M
```

## 项目结构

```
pi-plan-toggle/
├── package.json       # pi package 清单
├── README.md          # 本文档
└── src/
    └── index.ts       # 扩展入口（快捷键 + 命令 + bash 过滤 + 提示词覆写）
```

## 许可

MIT