pi-plan-mode

Plan mode 扩展 — 为 pi 提供只读探索模式，支持创建计划、跟踪执行进度。

功能

• 只读探索模式：限制工具为只读命令（read、grep、find、ls 等），禁止编辑、写入等操作
• 安全 Bash：仅允许白名单中的只读命令，拦截 rm、mv、git push、npm install 等破坏性操作
• 计划创建：AI 代理自动从回复中提取 "Plan:" 编号步骤
• 进度追踪：执行阶段使用 [DONE:n] 标记完成步骤，UI 显示进度（☐ / ☑）
• 执行模式：用户确认后切换回完整工具权限，逐步骤执行
• 快捷键：Ctrl+Alt+P 切换 plan 模式；空编辑器中 Tab 快速切换
• 持久化状态：会话重启后恢复 plan 状态和已完成步骤

安装

# 从 npm 安装
pi install npm:@erasin/pi-plan-mode

# 从 git 安装
pi install git:github.com/erasin/pi-plan-mode

# 从本地路径安装
pi install ~/Projects/pi-plan-mode

启动时自动启用 plan 模式：

pi --plan

用法

1. 按 Ctrl+Alt+P 进入 plan 模式（或使用命令 /plan）
2. AI 代理将仅使用只读工具探索代码库
3. 代理回复中应包含 "Plan:" 标题和编号步骤
4. 扩展提供操作选择：执行计划 / 保持 plan 模式 / 细化计划
5. 选择"执行计划"后，切换为完整工具权限，逐步执行
6. 执行中在回复里添加 [DONE:1]、[DONE:2] 等标记完成步骤

命令

| 命令 | 说明 | |------|------| | /plan | 切换 plan 模式 | | /todos | 显示当前计划进度 |

快捷键

| 快捷键 | 说明 | |--------|------| | Ctrl+Alt+P | 切换 plan 模式 | | Tab | 编辑器为空时切换 plan 模式 |

开发

# 构建（tsc 类型检查）
npm run build

# 类型检查
npm run typecheck

许可证

MIT