Plandex CLI 完全指南：掌握AI驱动的开发工作流

Plandex CLI 完全指南：掌握AI驱动的开发工作流

plandex An AI coding engine for complex tasks 项目地址: https://gitcode.com/gh_mirrors/pl/plandex

Plandex 是一个AI驱动的开发工具，通过命令行界面(CLI)提供了一套完整的开发辅助功能。本文将详细介绍Plandex CLI的各项功能和使用方法，帮助开发者充分利用这个工具提升工作效率。

基础使用

Plandex CLI提供了两种命令形式：

plandex [command] [flags]  # 完整形式
pdx [command] [flags]      # 简写形式

要获取帮助信息，可以使用：

plandex help       # 查看基础帮助
plandex help --all # 查看所有命令帮助

REPL交互模式

Plandex最常用的方式是REPL(Read-Eval-Print Loop)交互模式：

plandex   # 启动REPL
pdx       # 简写形式

在REPL中，所有命令都可以通过添加反斜杠前缀来执行，例如\new。

REPL启动参数

启动REPL时可以指定多种模式：

工作模式：

• --chat/-c：对话模式(仅交流不修改代码)
• --tell/-t：执行模式(实际修改代码)

自动化级别：

• --no-auto：完全手动，逐步执行
• --basic：基础自动化，自动继续计划
• --plus：增强自动化，自动更新上下文和提交变更
• --semi：半自动化，自动加载上下文
• --full：全自动化，自动应用、执行和调试

模型预设：

• --daily：日常使用预设(默认)
• --reasoning：强化推理能力预设
• --strong：高性能模型预设
• --cheap：经济型模型预设
• --oss：开源模型预设
• --gemini-preview：Gemini预览模型预设

计划管理

创建新计划

plandex new
plandex new -n "计划名称"  # 指定名称

可选参数：

• --context-dir：设置上下文加载目录
• 各种自动化级别和模型预设参数

计划列表与切换

plandex plans      # 列出所有计划
plandex cd 计划名  # 切换到指定计划
plandex current    # 显示当前计划

计划维护

plandex rename 新名称  # 重命名计划
plandex delete-plan   # 删除计划
plandex archive       # 归档计划
plandex unarchive     # 取消归档

上下文管理

添加上下文

plandex load 文件路径       # 加载文件
plandex load 目录 -r       # 递归加载目录
plandex load URL           # 加载网页内容
plandex load -n "备注内容"  # 添加文字备注

上下文操作

plandex ls       # 列出所有上下文
plandex rm 文件  # 移除上下文
plandex show 文件 # 查看上下文内容
plandex update   # 更新过期的上下文
plandex clear    # 清除所有上下文

任务执行

执行任务

plandex tell "任务描述"  # 执行具体任务
plandex continue        # 继续执行当前计划
plandex build          # 构建待处理的变更

调试与聊天

plandex debug "测试命令"  # 自动调试命令
plandex chat "问题"      # 仅交流不修改代码

变更管理

查看与处理变更

plandex diff          # 查看待处理变更
plandex diff --ui     # 在浏览器中查看变更
plandex apply         # 应用变更
plandex reject 文件   # 拒绝特定变更

历史与分支

历史记录

plandex log      # 查看历史记录
plandex rewind   # 回退到历史状态
plandex convo    # 查看对话记录

分支管理

plandex branches        # 列出所有分支
plandex checkout 分支名  # 切换或创建分支

后台任务

plandex ps       # 查看后台任务
plandex connect  # 连接到后台任务
plandex stop     # 停止后台任务

配置管理

plandex config           # 查看当前配置
plandex set-config 参数   # 修改配置

使用技巧

1. 渐进式自动化：初次使用时建议从--no-auto开始，熟悉后再逐步提高自动化级别。

2. 上下文管理：合理使用.plandexignore文件排除不需要的上下文，提高效率。

3. 分支策略：为不同功能开发创建独立分支，避免相互干扰。

4. 变更审查：重要变更建议先使用plandex diff --ui仔细审查后再应用。

5. 模型选择：日常开发使用--daily，复杂任务可尝试--reasoning或--strong。

通过熟练掌握这些命令和技巧，开发者可以充分利用Plandex的AI能力，显著提升开发效率和代码质量。

plandex An AI coding engine for complex tasks 项目地址: https://gitcode.com/gh_mirrors/pl/plandex