Plandex CLI 版本演进全景解析从 v2 架构到 2.2.x 模型供应商系统【免费下载链接】plandexOpen source AI coding agent. Designed for large projects and real world tasks.项目地址: https://gitcode.com/GitHub_Trending/pl/plandex本文基于 Plandex 仓库中的 CLI 变更日志系统梳理 Plandex 命令行客户端从 0.7.x 到 2.2.x 的完整版本演进脉络v2 的架构级重构、2.2.0 大版本中的模型供应商/JSON 配置系统以及 Claude 订阅接入、Ollama 本地模型等关键特性。结合 app/cli 与 app/shared 中的源码实现你将掌握每个版本命令行为的真实依据、各版本间的功能取舍以及如何在不同版本能力下选择与配置 Plandex。版本时间线总览变更日志按版本倒序记录覆盖的 CLI 版本线为2.2.1 / 2.2.0Claude Pro/Max 订阅接入模型供应商与模型配置系统大改版当前主线2.1.61 / 2.1.6 / 2.1.5Claude Sonnet 4 与 Opus 4 引入并逐步成为默认2.1.01 / 2.1.0BYO Key 模式仅凭 OpenRouter 即可运行模型回退与重试系统2.0.71 ~ 2.0.0REPL 命令纠错、浏览器调试以及 v2 公测1.1.1 / 1.1.0 / 1.0.0图片上下文、plandex reject、Claude 3.5 Sonnet 内置包0.9.x ~ 0.7.1自定义模型、模型包model packs、diff/archive命令等早期能力各版本的发布说明文件独立存放于 releases/cli/versions 目录如 2.2.0、2.0.0CHANGELOG 即它们的汇总视图。2.2.1接入 Claude Pro / Max 订阅2.2.1 的核心是让拥有 Claude Pro 或 Max 订阅的用户把订阅用于调用 Anthropic 模型——既可用于 Plandex Cloud 的 Integrated Models 模式也可用于 BYO Key 模式Cloud 或自托管。变更日志说明只要当前使用 Anthropic 模型默认模型包即是首次运行 Plandex 时会提示是否连接订阅。在源码层面这一能力由三个 cobra 子命令实现见 claude_max.goplandex connect-claude连接订阅内部调用lib.ConnectClaudeMax()plandex disconnect-claude断开订阅plandex claude-status查看连接状态判断依据是凭据中ClaudeMax非空且组织用户配置中UseClaudeSubscription为 trueclaude-status还输出一条重要的运维信息当 Claude 订阅配额耗尽时下一个拥有有效凭据的供应商将被用于 Anthropic 模型直到配额重置——这与下文 2.2.0 的供应商回退机制直接呼应。订阅接入的更多细节可参考仓库内文档 docs/docs/models/claude-subscription.md。2.2.0模型供应商系统大版本变更日志称 2.2.0 是一次大版本显著提升模型供应商灵活性、简化自定义模型配置、降低 Cloud 成本并内置 Ollama 支持。以下逐点展开。内置供应商矩阵与环境变量变更日志列出的 BYO Key 模式新增内置供应商为Anthropic API、Google AI Studio、Google Vertex AI、Azure OpenAI、AWS Bedrock、DeepSeek API、Perplexity API、Ollama本地模型加上此前的 OpenRouter 与 OpenAI API。这些供应商在共享层有统一枚举见 ai_models_providers.goconst ( ModelProviderOpenRouter ModelProvider openrouter ModelProviderOpenAI ModelProvider openai ModelProviderAnthropic ModelProvider anthropic ModelProviderAnthropicClaudeMax ModelProvider anthropic-pro ModelProviderGoogleAIStudio ModelProvider google-ai-studio ModelProviderGoogleVertex ModelProvider google-vertex ModelProviderAzureOpenAI ModelProvider azure-openai ModelProviderAmazonBedrock ModelProvider aws-bedrock ModelProviderDeepSeek ModelProvider deepseek ModelProviderPerplexity ModelProvider perplexity ModelProviderOllama ModelProvider ollama ModelProviderCustom ModelProvider custom )同文件定义了每个供应商的认证环境变量L7-L17OPENAI_API_KEY、OPENROUTER_API_KEY、ANTHROPIC_API_KEY、GEMINI_API_KEYGoogle AI Studio、AZURE_OPENAI_API_KEY、DEEPSEEK_API_KEY、PERPLEXITY_API_KEY。ModelProviderConfigSchema结构还支持HasAWSAuthAWS Bedrock 使用 AWS 凭据而非 API Key、HasClaudeMaxAuthClaude 订阅、SkipAuth/LocalOnlyOllama 等免认证的本地供应商等开关说明供应商抽象是一个配置模式覆盖所有认证形态的设计。服务端调用链中Google/Azure/Bedrock 等经由内置的 LiteLLM 代理转发ModelProviderToLiteLLMId映射这一实现细节可在 app/server/litellm_proxy.py 中查看。供应商回退Provider Fallback变更日志描述当同一模型配置了多个供应商凭据时若首个供应商调用失败Plandex 会回退到下一个有效供应商。典型组合是直接供应商OpenAI/Anthropic OpenRouter直连默认走无额外成本与延迟直连失败则落到 OpenRouter而 OpenRouter 自身还有跨供应商的内部回退形成多层韧性。Claude 订阅配额耗尽时切换供应商的claude-status提示正是这一机制在 Anthropic 侧的体现。Integrated Models 模式降价 5.5%变更日志说明新的供应商系统让 Plandex Cloud 的 Integrated Models 模式可以直连供应商避开了 OpenRouter 对模型调用加收的 5.5% 溢价并将该节省转嫁给用户OpenRouter 仍作为回退保留。OpenAI o3 在 Cloud 集成模式下的价格同步大幅下调输入 $2/M、输出 $8/M降幅 80%。JSON 化模型配置与 IDE 支持这是 2.2.0 最核心的体验改动。模型配置文件采用带 JSON Schema 的 JSON 格式支持主流 IDE 的自动补全、校验与内联文档。Schema 文件就在仓库中位于 app/cli/schema/json-schemas/ 目录model-pack-config.schema.json、model-pack-roles.schema.json模型包与角色配置model-config.schema.json、model-provider-config.schema.json模型与供应商配置models-input.schema.jsonmodels custom使用的整包输入格式plan-config.schema.json计划级配置set-model命令的完整行为可以在 set_model.go 中逐一印证命令定义为set-model [model-pack-name]参数最多一个set-model default是子命令作用于新计划的组织级默认设置而非当前计划支持三个标志--json用 JSON 文件方式设置、--file/-f指定配置文件路径、--save保存已编辑好的 JSON 文件不带参数运行时弹出二选一菜单Select a model pack或Edit model settings JSON——正是变更日志所述选择内置/自定义模型包或直接用 JSON 内联编辑名称匹配大小写不敏感并内置两条兼容别名daily→daily-driveropus-4-planner→opus-planner后者是 2.1.6 中opus-4-planner改名遗留的旧名兼容云端模式下会过滤掉LocalProvider非空的模型包即纯本地 Ollama 包不出现在 Cloud 的选择列表中JSON 流程采用写出文件 → 打开编辑器 → 回来保存的两步交互先把当前设置写入默认路径的 JSON 文件通过maybePromptAndOpenModelsFile打开用户首选编辑器首次编辑时提示设置偏好编辑器再用lib.ApplyModelSettings将文件内容应用回设置若本地文件已有改动会先做冲突检查与确认models custom自定义模型管理的统一入口变更日志说明models custom取代了旧的models add、models delete、model-packs create/update/delete命令。源码 models.go 印证了迁移期的痕迹models add、models update、models rm子命令仍然存在但执行体都指向customModelsNotImplemented即仅作占位引导用户改用models custom。models custom的关键行为L93-L238首次运行且服务器上还没有任何自定义模型/模型包时serverModelsInput.IsEmpty()会生成一份示例模板 JSON 写入默认路径提示编辑后回来保存若已有配置则把服务端数据同步为本地文件供编辑编辑后通过lib.MustSyncCustomModels回传支持--save直接保存本地已编辑文件文件不存在则报错与--file/-f指定非默认路径默认路径位于用户主目录下lib.GetCustomModelsPath(auth.Current.UserId)且仅默认路径才做本地改动冲突检查plandex models custom # 打开/生成 JSON编辑后回车保存 plandex models custom --file my-models.json --save # 保存指定文件models输出简化与回退链展示models与models default默认输出简化视图新增--all/-a标志显示全部属性见 models.go L31。输出现在会展示每个角色的多级回退模型大上下文回退、大输出回退、错误回退等。这类回退结构在共享层通过LargeContextFallback、ErrorFallback、StrongModel等可选字段表达构建辅助函数getLargeContextFallback、getErrorFallback见 ai_models_packs.go。内置 Ollama 支持2.2.0 将 Ollama 作为一等内置供应商使本地模型开箱即用。从源码结构看Ollama 供应商带LocalProvider/SkipAuth语义且有一组专用模型包ollama-experimental、ollama-adaptive-oss、ollama-adaptive-daily注册在 BuiltInModelPacks 列表中云端模式下这些本地包会被set-model的选择列表过滤掉。快速上手文档见 docs/docs/models/ollama.md。内置模型与模型包更新2.2.0 的模型侧变更逐项继承自变更日志新增mistral/devstral-smallOpenRouter 与 Ollama 双供应商Qwen 3 系列 8B 到 235Bcloud变体走 OpenRouterlocal变体走 Ollamadeepseek/r1蒸馏本地版 8b 到 70bOllama模型包调整移除gemini-exp新增gemini-plannerGemini 2.5 Pro 负责规划与上下文选择其余角色用默认模型与google所有角色用 Gemini 2.5 Pro 或 Flash新增o3-plannero3-medium 负责规划其余默认标识符更新Gemini 2.5 Pro/Flash 换用最新标识符替代 Preview 版本deepseek/r1在 OpenRouter 上更新为deepseek/deepseek-r1-0528移除gemini-preview模型包当前仓库内置模型包全集可从 ai_models_packs.go 确认daily-driver默认、reasoning、strong、cheap、oss、三个 Ollama 包、anthropic、openai、google、gemini-planner、opus-planner、o3-planner、r1-planner、perplexity-planner。其他变更与修复TypeScript 文件映射修复export const foo bar这类直接导出的符号此前会被遗漏出 map 文件同时改进了declare global、namespace、enum块与箭头函数的映射。文件映射实现位于 app/server/syntax/file_mapplandex checkout --yes/-y分支不存在时自动确认创建命令可用于脚本化无交互运行--skip-menu标志plandex tell、plandex continue、plandex build新增该标志跳过响应结束且有待应用变更时的交互菜单同时新增skip-changes-menu配置项设为true即默认跳过。源码见 plan_exec_helpers.go当--skip-menu未显式指定时回落到config.SkipChangesMenu配置值2.2.1 补丁修复了自定义模型与供应商相关的缺陷2.1.xSonnet 4 / Opus 4 时代的模型包演进2.1.5新增 Claude Sonnet 4 与 Opus 4 内置模型。因初期测试偶发错误Sonnet 4 暂未进入默认daily-driver包可经sonnet-4-daily包试用Opus 4 经opus-4-planner包使用规划用 Opus 4、编码用 Sonnet 42.1.6Sonnet 4 测试稳定后在上下文小于 200k 的场景取代 Sonnet 3.7 成为各模型包默认新增strong-opus包规划与编码均用 Opus 4opus-4-planner更名为opus-planner旧名仍受支持新增 Sonnet 4 → Sonnet 3.7 的错误回退以应对供应商偶发错误与限流2.1.61错误处理修复并补齐 2.1.6 中daily-driver包部分角色未正确升级到 Sonnet 4 的问题2.1.3 / 2.1.2 / 2.1.1默认模型包未正确应用于新计划的修复、Linux 下应用计划时潜在崩溃修复、无文件加载时的 auto-load 上下文超时修复、Gemini 2.5 Pro Experimental 免费端点修复及对 No endpoints found that support cache control 错误的重试2.1.0OpenRouter 单键运行与模型回退系统2.1.0 是 BYO Key 模式的分水岭仅 OpenRouter 即可运行Cloud 或自托管的 BYO Key 模式下只需OPENROUTER_API_KEY不再要求单独的 OpenAI 账号如需直连 OpenAI更快更省再额外设置OPENAI_API_KEY即可新模型Gemini 2.5 Pro Preview 成为 200k~1M 上下文的默认模型并附gemini-preview包失败时回退 Gemini 1.5 ProGemini Flash 2.5 Preview 内置o4-minihigh/medium/low 推理档替代 o3-mini 成为各包主力o4-mini-medium成为cheap包的规划默认o3 内置BYO Key 模式需组织验证gpt-4.1/gpt-4.1-mini/gpt-4.1-nano替代 gpt-4o 系列strong包规划模型o3-high 取代 o1因 o3 需组织验证不可用时回退 o4-mini-highgpt-4.1 大上下文回退作为默认coder角色的大上下文回退模型把实现阶段的有效上下文上限从 200k 提升到 1M模型回退与重试系统为快速引入存在初期可靠性问题的新模型/预览模型实现了更健壮的回退与重试context length exceeded 类错误会自动回退到模型包中定义的大上下文模型修复了此前以 400/413 报错而非正确回退的问题Gemini 提示缓存规划、实现、构建阶段的成本与延迟显著下降更安静的推理reasoning与strong包中 Claude 3.7 Sonnet 的思考过程默认不再外显避免特定格式内容在推理与主输出间重复其他REPL 命令纠错增强Cloud 免费试用可在 BYO Key 与 Integrated Models 之间切换、积分低于 $1.00 时告警Windows 行尾符导致的 Plan replacement failed 修复XML 输出格式自定义模型的 tool calls not supported 错误修复2.0.0v2 公测2.0.0 是架构级发布变更日志中的官方描述Dane 发布信要点多供应商混合默认默认模型包组合 Claude 3.7 Sonnet、o3-mini 与 Gemini 1.5 Pro各角色使用最擅长的供应商新增architect与coder角色区分规划/实现阶段上下文管理tree-sitter 项目映射30 语言自动选择上下文约 20M token 规模代码库可被索引实现阶段仅加载必要文件OpenAI/Anthropic 提示缓存可靠文件编辑简单编辑可确定性应用免模型调用复杂编辑靠校验与多级回退单文件上限 100k tokenCloud 端微调的 instant apply 模型进一步加速 32k token 内文件的编辑新默认交互REPL任意项目目录输入plandex即进入聊天式体验、命令/文件模糊自动补全、chat与tell模式分离发散讨论与实现、多行编辑模式所有命令仍可直接从终端调用可配置自动化basic同 v1手动加载、禁执行/semi-autov2 默认自动上下文加载应用与执行需审批/full auto全自动加载、应用、执行、自动调试命令执行与 diff 审查沙箱集成——变更先暂存应用命令失败则回滚debug命令可对任意终端命令做自动调试Cloud 计费Integrated Models 模式无需额外账号与密钥与 BYO API Key 模式usage命令用量报表、自动充值阈值、月度消费告警、月度总限额billing命令打开仪表盘协议变更从 AGPL 3.0 转为 MIT 许可升级注意v2 独立于 v1 运行不是原地升级——旧用户按新用户流程走快速上手即可2.0.0 之前的 2.0.x 补丁线2.0.1~2.0.7主要修复自托管/BYOK 模式 REPL 启动失败、自定义模型包崩溃、上下文更新竞态、stream TUI 渲染错位等问题2.0.4 引入了 Claude Sonnet 3.7 thinkingreasoning包、浏览器直接调试捕获错误并读取 console 日志需 Chrome、指数退避的 HTTP 重试2.0.5~2.0.7 则持续打磨 REPL 对拼写错误的命令的容错避免误把半截\命令发给模型浪费 token。1.1.x 与 0.9.x能力奠基期1.1.1流式计划时的终端闪烁大幅减少、客户端/服务端 CPU 占用下降Claude 3.5 Sonnet 经 OpenRouter 内置anthropic-claude-3.5-sonnet与anthropic-claude-3.5-sonnet-gpt-4o两个包1.1.0plandex load支持把 png/jpeg/非动图 gif/webp 图片载入上下文当时仅 GPT-4o 可用builder/verifier/auto-fix 角色不再硬性绑定 OpenAI 模型因流式函数调用不再是这些角色的必要条件但可靠函数调用仍是硬性要求非 OpenAI 模型用于这些角色属实验性plandex reject支持按文件或批量拒绝待应用变更plandex convo支持消息号/区间plandex convo 1-5、plandex convo 2-与--plain纯文本输出plandex rm支持区间参数0.9.0能力奠基版plandex diff以 git diff 格式查看待应用变更计划归档plandex archive/plans --archived/unarchiveplandex models add自定义模型任何 OpenAI 兼容供应商OpenRouter、Together.ai、Ollama、Replicate 等每个供应商关联*API_KEY环境变量模型包与模型默认值体系model-packs create、set-model defaultsummary、rename命令apply生成描述性 commit 消息版本选择与迁移要点从这份变更日志可以读出清晰的版本决策依据新项目/新环境直接用 2.2.x这是当前主线具备完整的多供应商矩阵、JSON 配置、供应商回退与 Claude 订阅接入。若使用 Anthropic 模型首次运行按提示接入 Claude Pro/Max 订阅或手动plandex connect-claude配额耗尽会自动切换其他有效凭据BYO Key 用户2.1.0 起单凭OPENROUTER_API_KEY即可运行2.2.0 起可再叠加ANTHROPIC_API_KEY、DEEPSEEK_API_KEY等直连键形成直连优先 OpenRouter 兜底的双层结构本地模型用户需要 2.2.0 及以上的 Ollama 内置支持参考 docs/docs/models/ollama.md注意云端set-model菜单会隐藏纯本地模型包脚本化2.2.0 起checkout --yes与tell/continue/build --skip-menu或配置skip-changes-menu: true使无交互自动化成为官方支持路径从 v1 迁移v2 不是原地升级按新用户流程初始化即可各命令的完整说明见 docs/docs/cli-reference.md更多背景可结合仓库内文档阅读模型总览、模型设置、自定义模型、模型供应商、角色体系。【免费下载链接】plandexOpen source AI coding agent. Designed for large projects and real world tasks.项目地址: https://gitcode.com/GitHub_Trending/pl/plandex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Plandex CLI 版本演进全景解析：从 v2 架构到 2.2.x 模型供应商系统
Plandex CLI 版本演进全景解析从 v2 架构到 2.2.x 模型供应商系统【免费下载链接】plandexOpen source AI coding agent. Designed for large projects and real world tasks.项目地址: https://gitcode.com/GitHub_Trending/pl/plandex本文基于 Plandex 仓库中的 CLI 变更日志系统梳理 Plandex 命令行客户端从 0.7.x 到 2.2.x 的完整版本演进脉络v2 的架构级重构、2.2.0 大版本中的模型供应商/JSON 配置系统以及 Claude 订阅接入、Ollama 本地模型等关键特性。结合 app/cli 与 app/shared 中的源码实现你将掌握每个版本命令行为的真实依据、各版本间的功能取舍以及如何在不同版本能力下选择与配置 Plandex。版本时间线总览变更日志按版本倒序记录覆盖的 CLI 版本线为2.2.1 / 2.2.0Claude Pro/Max 订阅接入模型供应商与模型配置系统大改版当前主线2.1.61 / 2.1.6 / 2.1.5Claude Sonnet 4 与 Opus 4 引入并逐步成为默认2.1.01 / 2.1.0BYO Key 模式仅凭 OpenRouter 即可运行模型回退与重试系统2.0.71 ~ 2.0.0REPL 命令纠错、浏览器调试以及 v2 公测1.1.1 / 1.1.0 / 1.0.0图片上下文、plandex reject、Claude 3.5 Sonnet 内置包0.9.x ~ 0.7.1自定义模型、模型包model packs、diff/archive命令等早期能力各版本的发布说明文件独立存放于 releases/cli/versions 目录如 2.2.0、2.0.0CHANGELOG 即它们的汇总视图。2.2.1接入 Claude Pro / Max 订阅2.2.1 的核心是让拥有 Claude Pro 或 Max 订阅的用户把订阅用于调用 Anthropic 模型——既可用于 Plandex Cloud 的 Integrated Models 模式也可用于 BYO Key 模式Cloud 或自托管。变更日志说明只要当前使用 Anthropic 模型默认模型包即是首次运行 Plandex 时会提示是否连接订阅。在源码层面这一能力由三个 cobra 子命令实现见 claude_max.goplandex connect-claude连接订阅内部调用lib.ConnectClaudeMax()plandex disconnect-claude断开订阅plandex claude-status查看连接状态判断依据是凭据中ClaudeMax非空且组织用户配置中UseClaudeSubscription为 trueclaude-status还输出一条重要的运维信息当 Claude 订阅配额耗尽时下一个拥有有效凭据的供应商将被用于 Anthropic 模型直到配额重置——这与下文 2.2.0 的供应商回退机制直接呼应。订阅接入的更多细节可参考仓库内文档 docs/docs/models/claude-subscription.md。2.2.0模型供应商系统大版本变更日志称 2.2.0 是一次大版本显著提升模型供应商灵活性、简化自定义模型配置、降低 Cloud 成本并内置 Ollama 支持。以下逐点展开。内置供应商矩阵与环境变量变更日志列出的 BYO Key 模式新增内置供应商为Anthropic API、Google AI Studio、Google Vertex AI、Azure OpenAI、AWS Bedrock、DeepSeek API、Perplexity API、Ollama本地模型加上此前的 OpenRouter 与 OpenAI API。这些供应商在共享层有统一枚举见 ai_models_providers.goconst ( ModelProviderOpenRouter ModelProvider openrouter ModelProviderOpenAI ModelProvider openai ModelProviderAnthropic ModelProvider anthropic ModelProviderAnthropicClaudeMax ModelProvider anthropic-pro ModelProviderGoogleAIStudio ModelProvider google-ai-studio ModelProviderGoogleVertex ModelProvider google-vertex ModelProviderAzureOpenAI ModelProvider azure-openai ModelProviderAmazonBedrock ModelProvider aws-bedrock ModelProviderDeepSeek ModelProvider deepseek ModelProviderPerplexity ModelProvider perplexity ModelProviderOllama ModelProvider ollama ModelProviderCustom ModelProvider custom )同文件定义了每个供应商的认证环境变量L7-L17OPENAI_API_KEY、OPENROUTER_API_KEY、ANTHROPIC_API_KEY、GEMINI_API_KEYGoogle AI Studio、AZURE_OPENAI_API_KEY、DEEPSEEK_API_KEY、PERPLEXITY_API_KEY。ModelProviderConfigSchema结构还支持HasAWSAuthAWS Bedrock 使用 AWS 凭据而非 API Key、HasClaudeMaxAuthClaude 订阅、SkipAuth/LocalOnlyOllama 等免认证的本地供应商等开关说明供应商抽象是一个配置模式覆盖所有认证形态的设计。服务端调用链中Google/Azure/Bedrock 等经由内置的 LiteLLM 代理转发ModelProviderToLiteLLMId映射这一实现细节可在 app/server/litellm_proxy.py 中查看。供应商回退Provider Fallback变更日志描述当同一模型配置了多个供应商凭据时若首个供应商调用失败Plandex 会回退到下一个有效供应商。典型组合是直接供应商OpenAI/Anthropic OpenRouter直连默认走无额外成本与延迟直连失败则落到 OpenRouter而 OpenRouter 自身还有跨供应商的内部回退形成多层韧性。Claude 订阅配额耗尽时切换供应商的claude-status提示正是这一机制在 Anthropic 侧的体现。Integrated Models 模式降价 5.5%变更日志说明新的供应商系统让 Plandex Cloud 的 Integrated Models 模式可以直连供应商避开了 OpenRouter 对模型调用加收的 5.5% 溢价并将该节省转嫁给用户OpenRouter 仍作为回退保留。OpenAI o3 在 Cloud 集成模式下的价格同步大幅下调输入 $2/M、输出 $8/M降幅 80%。JSON 化模型配置与 IDE 支持这是 2.2.0 最核心的体验改动。模型配置文件采用带 JSON Schema 的 JSON 格式支持主流 IDE 的自动补全、校验与内联文档。Schema 文件就在仓库中位于 app/cli/schema/json-schemas/ 目录model-pack-config.schema.json、model-pack-roles.schema.json模型包与角色配置model-config.schema.json、model-provider-config.schema.json模型与供应商配置models-input.schema.jsonmodels custom使用的整包输入格式plan-config.schema.json计划级配置set-model命令的完整行为可以在 set_model.go 中逐一印证命令定义为set-model [model-pack-name]参数最多一个set-model default是子命令作用于新计划的组织级默认设置而非当前计划支持三个标志--json用 JSON 文件方式设置、--file/-f指定配置文件路径、--save保存已编辑好的 JSON 文件不带参数运行时弹出二选一菜单Select a model pack或Edit model settings JSON——正是变更日志所述选择内置/自定义模型包或直接用 JSON 内联编辑名称匹配大小写不敏感并内置两条兼容别名daily→daily-driveropus-4-planner→opus-planner后者是 2.1.6 中opus-4-planner改名遗留的旧名兼容云端模式下会过滤掉LocalProvider非空的模型包即纯本地 Ollama 包不出现在 Cloud 的选择列表中JSON 流程采用写出文件 → 打开编辑器 → 回来保存的两步交互先把当前设置写入默认路径的 JSON 文件通过maybePromptAndOpenModelsFile打开用户首选编辑器首次编辑时提示设置偏好编辑器再用lib.ApplyModelSettings将文件内容应用回设置若本地文件已有改动会先做冲突检查与确认models custom自定义模型管理的统一入口变更日志说明models custom取代了旧的models add、models delete、model-packs create/update/delete命令。源码 models.go 印证了迁移期的痕迹models add、models update、models rm子命令仍然存在但执行体都指向customModelsNotImplemented即仅作占位引导用户改用models custom。models custom的关键行为L93-L238首次运行且服务器上还没有任何自定义模型/模型包时serverModelsInput.IsEmpty()会生成一份示例模板 JSON 写入默认路径提示编辑后回来保存若已有配置则把服务端数据同步为本地文件供编辑编辑后通过lib.MustSyncCustomModels回传支持--save直接保存本地已编辑文件文件不存在则报错与--file/-f指定非默认路径默认路径位于用户主目录下lib.GetCustomModelsPath(auth.Current.UserId)且仅默认路径才做本地改动冲突检查plandex models custom # 打开/生成 JSON编辑后回车保存 plandex models custom --file my-models.json --save # 保存指定文件models输出简化与回退链展示models与models default默认输出简化视图新增--all/-a标志显示全部属性见 models.go L31。输出现在会展示每个角色的多级回退模型大上下文回退、大输出回退、错误回退等。这类回退结构在共享层通过LargeContextFallback、ErrorFallback、StrongModel等可选字段表达构建辅助函数getLargeContextFallback、getErrorFallback见 ai_models_packs.go。内置 Ollama 支持2.2.0 将 Ollama 作为一等内置供应商使本地模型开箱即用。从源码结构看Ollama 供应商带LocalProvider/SkipAuth语义且有一组专用模型包ollama-experimental、ollama-adaptive-oss、ollama-adaptive-daily注册在 BuiltInModelPacks 列表中云端模式下这些本地包会被set-model的选择列表过滤掉。快速上手文档见 docs/docs/models/ollama.md。内置模型与模型包更新2.2.0 的模型侧变更逐项继承自变更日志新增mistral/devstral-smallOpenRouter 与 Ollama 双供应商Qwen 3 系列 8B 到 235Bcloud变体走 OpenRouterlocal变体走 Ollamadeepseek/r1蒸馏本地版 8b 到 70bOllama模型包调整移除gemini-exp新增gemini-plannerGemini 2.5 Pro 负责规划与上下文选择其余角色用默认模型与google所有角色用 Gemini 2.5 Pro 或 Flash新增o3-plannero3-medium 负责规划其余默认标识符更新Gemini 2.5 Pro/Flash 换用最新标识符替代 Preview 版本deepseek/r1在 OpenRouter 上更新为deepseek/deepseek-r1-0528移除gemini-preview模型包当前仓库内置模型包全集可从 ai_models_packs.go 确认daily-driver默认、reasoning、strong、cheap、oss、三个 Ollama 包、anthropic、openai、google、gemini-planner、opus-planner、o3-planner、r1-planner、perplexity-planner。其他变更与修复TypeScript 文件映射修复export const foo bar这类直接导出的符号此前会被遗漏出 map 文件同时改进了declare global、namespace、enum块与箭头函数的映射。文件映射实现位于 app/server/syntax/file_mapplandex checkout --yes/-y分支不存在时自动确认创建命令可用于脚本化无交互运行--skip-menu标志plandex tell、plandex continue、plandex build新增该标志跳过响应结束且有待应用变更时的交互菜单同时新增skip-changes-menu配置项设为true即默认跳过。源码见 plan_exec_helpers.go当--skip-menu未显式指定时回落到config.SkipChangesMenu配置值2.2.1 补丁修复了自定义模型与供应商相关的缺陷2.1.xSonnet 4 / Opus 4 时代的模型包演进2.1.5新增 Claude Sonnet 4 与 Opus 4 内置模型。因初期测试偶发错误Sonnet 4 暂未进入默认daily-driver包可经sonnet-4-daily包试用Opus 4 经opus-4-planner包使用规划用 Opus 4、编码用 Sonnet 42.1.6Sonnet 4 测试稳定后在上下文小于 200k 的场景取代 Sonnet 3.7 成为各模型包默认新增strong-opus包规划与编码均用 Opus 4opus-4-planner更名为opus-planner旧名仍受支持新增 Sonnet 4 → Sonnet 3.7 的错误回退以应对供应商偶发错误与限流2.1.61错误处理修复并补齐 2.1.6 中daily-driver包部分角色未正确升级到 Sonnet 4 的问题2.1.3 / 2.1.2 / 2.1.1默认模型包未正确应用于新计划的修复、Linux 下应用计划时潜在崩溃修复、无文件加载时的 auto-load 上下文超时修复、Gemini 2.5 Pro Experimental 免费端点修复及对 No endpoints found that support cache control 错误的重试2.1.0OpenRouter 单键运行与模型回退系统2.1.0 是 BYO Key 模式的分水岭仅 OpenRouter 即可运行Cloud 或自托管的 BYO Key 模式下只需OPENROUTER_API_KEY不再要求单独的 OpenAI 账号如需直连 OpenAI更快更省再额外设置OPENAI_API_KEY即可新模型Gemini 2.5 Pro Preview 成为 200k~1M 上下文的默认模型并附gemini-preview包失败时回退 Gemini 1.5 ProGemini Flash 2.5 Preview 内置o4-minihigh/medium/low 推理档替代 o3-mini 成为各包主力o4-mini-medium成为cheap包的规划默认o3 内置BYO Key 模式需组织验证gpt-4.1/gpt-4.1-mini/gpt-4.1-nano替代 gpt-4o 系列strong包规划模型o3-high 取代 o1因 o3 需组织验证不可用时回退 o4-mini-highgpt-4.1 大上下文回退作为默认coder角色的大上下文回退模型把实现阶段的有效上下文上限从 200k 提升到 1M模型回退与重试系统为快速引入存在初期可靠性问题的新模型/预览模型实现了更健壮的回退与重试context length exceeded 类错误会自动回退到模型包中定义的大上下文模型修复了此前以 400/413 报错而非正确回退的问题Gemini 提示缓存规划、实现、构建阶段的成本与延迟显著下降更安静的推理reasoning与strong包中 Claude 3.7 Sonnet 的思考过程默认不再外显避免特定格式内容在推理与主输出间重复其他REPL 命令纠错增强Cloud 免费试用可在 BYO Key 与 Integrated Models 之间切换、积分低于 $1.00 时告警Windows 行尾符导致的 Plan replacement failed 修复XML 输出格式自定义模型的 tool calls not supported 错误修复2.0.0v2 公测2.0.0 是架构级发布变更日志中的官方描述Dane 发布信要点多供应商混合默认默认模型包组合 Claude 3.7 Sonnet、o3-mini 与 Gemini 1.5 Pro各角色使用最擅长的供应商新增architect与coder角色区分规划/实现阶段上下文管理tree-sitter 项目映射30 语言自动选择上下文约 20M token 规模代码库可被索引实现阶段仅加载必要文件OpenAI/Anthropic 提示缓存可靠文件编辑简单编辑可确定性应用免模型调用复杂编辑靠校验与多级回退单文件上限 100k tokenCloud 端微调的 instant apply 模型进一步加速 32k token 内文件的编辑新默认交互REPL任意项目目录输入plandex即进入聊天式体验、命令/文件模糊自动补全、chat与tell模式分离发散讨论与实现、多行编辑模式所有命令仍可直接从终端调用可配置自动化basic同 v1手动加载、禁执行/semi-autov2 默认自动上下文加载应用与执行需审批/full auto全自动加载、应用、执行、自动调试命令执行与 diff 审查沙箱集成——变更先暂存应用命令失败则回滚debug命令可对任意终端命令做自动调试Cloud 计费Integrated Models 模式无需额外账号与密钥与 BYO API Key 模式usage命令用量报表、自动充值阈值、月度消费告警、月度总限额billing命令打开仪表盘协议变更从 AGPL 3.0 转为 MIT 许可升级注意v2 独立于 v1 运行不是原地升级——旧用户按新用户流程走快速上手即可2.0.0 之前的 2.0.x 补丁线2.0.1~2.0.7主要修复自托管/BYOK 模式 REPL 启动失败、自定义模型包崩溃、上下文更新竞态、stream TUI 渲染错位等问题2.0.4 引入了 Claude Sonnet 3.7 thinkingreasoning包、浏览器直接调试捕获错误并读取 console 日志需 Chrome、指数退避的 HTTP 重试2.0.5~2.0.7 则持续打磨 REPL 对拼写错误的命令的容错避免误把半截\命令发给模型浪费 token。1.1.x 与 0.9.x能力奠基期1.1.1流式计划时的终端闪烁大幅减少、客户端/服务端 CPU 占用下降Claude 3.5 Sonnet 经 OpenRouter 内置anthropic-claude-3.5-sonnet与anthropic-claude-3.5-sonnet-gpt-4o两个包1.1.0plandex load支持把 png/jpeg/非动图 gif/webp 图片载入上下文当时仅 GPT-4o 可用builder/verifier/auto-fix 角色不再硬性绑定 OpenAI 模型因流式函数调用不再是这些角色的必要条件但可靠函数调用仍是硬性要求非 OpenAI 模型用于这些角色属实验性plandex reject支持按文件或批量拒绝待应用变更plandex convo支持消息号/区间plandex convo 1-5、plandex convo 2-与--plain纯文本输出plandex rm支持区间参数0.9.0能力奠基版plandex diff以 git diff 格式查看待应用变更计划归档plandex archive/plans --archived/unarchiveplandex models add自定义模型任何 OpenAI 兼容供应商OpenRouter、Together.ai、Ollama、Replicate 等每个供应商关联*API_KEY环境变量模型包与模型默认值体系model-packs create、set-model defaultsummary、rename命令apply生成描述性 commit 消息版本选择与迁移要点从这份变更日志可以读出清晰的版本决策依据新项目/新环境直接用 2.2.x这是当前主线具备完整的多供应商矩阵、JSON 配置、供应商回退与 Claude 订阅接入。若使用 Anthropic 模型首次运行按提示接入 Claude Pro/Max 订阅或手动plandex connect-claude配额耗尽会自动切换其他有效凭据BYO Key 用户2.1.0 起单凭OPENROUTER_API_KEY即可运行2.2.0 起可再叠加ANTHROPIC_API_KEY、DEEPSEEK_API_KEY等直连键形成直连优先 OpenRouter 兜底的双层结构本地模型用户需要 2.2.0 及以上的 Ollama 内置支持参考 docs/docs/models/ollama.md注意云端set-model菜单会隐藏纯本地模型包脚本化2.2.0 起checkout --yes与tell/continue/build --skip-menu或配置skip-changes-menu: true使无交互自动化成为官方支持路径从 v1 迁移v2 不是原地升级按新用户流程初始化即可各命令的完整说明见 docs/docs/cli-reference.md更多背景可结合仓库内文档阅读模型总览、模型设置、自定义模型、模型供应商、角色体系。【免费下载链接】plandexOpen source AI coding agent. Designed for large projects and real world tasks.项目地址: https://gitcode.com/GitHub_Trending/pl/plandex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考