Pi v0.50.0 - 更新日志

### 新功能 - 用于打包和安装扩展、技能、提示词和主题的 Pi 包。详见 [docs/packages.md](docs/packages.md)。 - 资源热重载（`/reload`），包括 AGENTS.md、SYSTEM.md、APPEND_SYSTEM.md、提示词模板、技能、主题和扩展。详见 [README.md#commands](README.md#commands) 和 [README.md#context-files](README.md#context-files)。 - 通过 `pi.registerProvider()` 支持自定义提供商，用于代理、自定义端点、OAuth 或 SSO 流程以及非标准流式 API。详见 [docs/custom-provider.md](docs/custom-provider.md)。 - Azure OpenAI Responses 提供商支持，具备基于部署的模型映射。详见 [docs/providers.md#azure-openai](docs/providers.md#azure-openai)。 - 通过 `openRouterRouting` 支持 OpenRouter 自定义模型路由。详见 [docs/providers.md#api-keys](docs/providers.md#api-keys) 和 [docs/models.md](docs/models.md)。 - 技能调用消息现在支持折叠，技能可通过 `disable-model-invocation` 选择不触发模型调用。详见 [docs/skills.md#frontmatter](docs/skills.md#frontmatter)。 - 会话选择器支持重命名及可配置的快捷键。详见 [README.md#commands](README.md#commands) 和 [docs/keybindings.md](docs/keybindings.md)。 - `models.json` 的 Header 值现在支持解析环境变量和 Shell 命令。详见 [docs/models.md#value-resolution](docs/models.md#value-resolution)。 - 新增 `--verbose` CLI 参数以覆盖静默启动设置。详见 [README.md#cli-reference](README.md#cli-reference)。请查阅 `README.md` 中全面重构的文档，或让你的 AI 助手为你朗读。 ### SDK 迁移指南自 v0.49.3 版本以来，SDK 存在多项破坏性更新。为快速完成迁移，请将你的智能体指向 `packages/coding-agent/docs/sdk.md`、`packages/coding-agent/examples/sdk` 中的 SDK 示例，以及 `packages/coding-agent/src/core/sdk.ts` 和相关模块的 SDK 源码。 ### 破坏性更新 - `models.json` 的 Header 值现在会解析环境变量（如果 Header 值与某环境变量名匹配，则使用该环境变量的值）。若字面量 Header 值意外匹配了环境变量名，可能会导致行为变更。([#909](https://github.com/badlogic/pi-mono/issues/909)) - 外部包（npm/git）现在通过 `settings.json` 中的 `packages` 数组进行配置，而非 `extensions`。`extensions` 中现有的 `npm:/` 和 `git:` 条目将自动迁移。([#645](https://github.com/badlogic/pi-mono/issues/645)) - 资源加载现仅使用 `ResourceLoader`，且 `settings.json` 中扩展、技能、提示词和主题均使用数组格式。([#645](https://github.com/badlogic/pi-mono/issues/645)) - 从 SDK 中移除了 `discoverAuthStorage` 和 `discoverModels`。除非传入 `agentDir`，否则 `AuthStorage` 和 `ModelRegistry` 现默认使用 `~/.pi/agent` 路径。([#645](https://github.com/badlogic/pi-mono/issues/645)) ### 新增 - 在 `/resume` 选择器中支持通过 `Ctrl+R` 重命名会话，而无需打开会话 ([#863](https://github.com/badlogic/pi-mono/pull/863) by [@svkozak](https://github.com/svkozak)) - 会话选择器快捷键现支持自定义配置 ([#948](https://github.com/badlogic/pi-mono/pull/948) by [@aos](https://github.com/aos)) - 为技能新增 `disable-model-invocation` frontmatter 字段，可阻止智能体自动调用，但仍允许显式执行 `/skill:name` 命令 ([#927](https://github.com/badlogic/pi-mono/issues/927)) - 向扩展暴露 `copyToClipboard` 工具函数 ([#926](https://github.com/badlogic/pi-mono/issues/926) by [@mitsuhiko](https://github.com/mitsuhiko)) - 聊天输出中的技能调用消息现支持折叠，默认以折叠状态显示，包含技能名称及展开提示 ([#894](https://github.com/badlogic/pi-mono/issues/894)) - `models.json` 的 Header 值现在支持环境变量和 Shell 命令，与 `apiKey` 解析逻辑保持一致 ([#909](https://github.com/badlogic/pi-mono/issues/909)) - 新增 API 请求的 HTTP 代理环境变量支持 ([#942](https://github.com/badlogic/pi-mono/pull/942) by [@haoqixu](https://github.com/haoqixu)) - 通过 `openRouterRouting` 兼容字段新增 OpenRouter 提供商的自定义模型路由支持 ([#859](https://github.com/badlogic/pi-mono/pull/859) by [@v01dpr1mr0s3](https://github.com/v01dpr1mr0s3)) - 新增 `azure-openai-responses` 提供商以支持 Azure OpenAI Responses API。([#890](https://github.com/badlogic/pi-mono/pull/890) by [@markusylisiurunen](https://github.com/markusylisiurunen)) - 更新通知中新增变更日志链接 ([#925](https://github.com/badlogic/pi-mono/pull/925) by [@dannote](https://github.com/dannote)) - 新增 `--verbose` CLI 参数以覆盖 `quietStartup` 设置 ([#906](https://github.com/badlogic/pi-mono/pull/906) by [@Perlence](https://github.com/Perlence)) - 新增 `markdown.codeBlockIndent` 设置项，用于自定义渲染输出中的代码块缩进 - 新增扩展包管理命令：`pi install`、`pi remove`、`pi update` 和 `pi list` ([#645](https://github.com/badlogic/pi-mono/issues/645)) - 包过滤功能：通过 `packages` 数组的对象形式选择性加载包内的资源 ([#645](https://github.com/badlogic/pi-mono/issues/645)) - 在包过滤器、顶层设置数组及 pi manifest 中支持使用 minimatch 进行 Glob 模式匹配（例如 `"!funky.json"`、`"*.ts"`） ([#645](https://github.com/badlogic/pi-mono/issues/645)) - 新增 `/reload` 命令以重载扩展、技能、提示词和主题 ([#645](https://github.com/badlogic/pi-mono/issues/645)) - 新增带 TUI（终端用户界面）的 `pi config` 命令，支持通过模式匹配启用/禁用包及顶层资源 ([#938](https://github.com/badlogic/pi-mono/issues/938)) - 新增 CLI 参数：`--skill`、`--prompt-template`、`--theme`、`--no-prompt-templates` 和 `--no-themes` ([#645](https://github.com/badlogic/pi-mono/issues/645)) - 包去重机制：若同一包同时出现在全局和项目设置中，以项目设置为准 ([#645](https://github.com/badlogic/pi-mono/issues/645)) - 为所有资源类型统一使用 `ResourceDiagnostic` 类型进行冲突报告 ([#645](https://github.com/badlogic/pi-mono/issues/645)) - 如果可用多个提供商，在页脚中模型旁显示提供商信息 - 支持通过 `pi.registerProvider()` 配合 `streamSimple` 实现自定义 API 的自定义提供商 - 新增 `custom-provider.ts` 示例扩展，演示使用 OAuth 的自定义 Anthropic 提供商 ### 更改 - `/resume` 选择器的排序切换键移至 `Ctrl+S`，以释放 `Ctrl+R` 用于重命名 ([#863](https://github.com/badlogic/pi-mono/pull/863) by [@svkozak](https://github.com/svkozak)) - HTML 导出：点击侧边栏消息现在会导航至其最新节点并滚动至该处，而非截断分支 ([#853](https://github.com/badlogic/pi-mono/pull/853) by [@mitsuhiko](https://github.com/mitsuhiko)) - HTML 导出：活动路径现在会高亮显示，非活动路径节点则变暗 ([#929](https://github.com/badlogic/pi-mono/pull/929) by [@hewliyang](https://github.com/hewliyang)) - Azure OpenAI Responses 提供商现在使用基础 URL 配置，支持感知部署的模型映射，且不再包含服务层级处理 - `/reload` 现在会重新渲染整个滚动缓冲区，以便立即显示已更新的扩展组件 ([#928](https://github.com/badlogic/pi-mono/pull/928) by [@ferologics](https://github.com/ferologics)) - 技能、提示词模板和主题的发现机制现在使用设置和 CLI 路径数组，替代了旧版过滤器 ([#645](https://github.com/badlogic/pi-mono/issues/645)) ### 修复 - 扩展 `agent_start` 处理程序中的 `setWorkingMessage()` 调用现在可正常工作；此前由于加载动画尚未创建，消息被静默忽略 ([#935](https://github.com/badlogic/pi-mono/issues/935)) - 修复了包自动发现功能，使其尊重加载器规则、配置覆盖和强制排除模式 - 修复了 `/reload` 在重载后恢复正确编辑器的问题 ([#949](https://github.com/badlogic/pi-mono/pull/949) by [@Perlence](https://github.com/Perlence)) - 修复了分布式主题导致 `/export` 失效的问题 ([#946](https://github.com/badlogic/pi-mono/pull/946) by [@mitsuhiko](https://github.com/mitsuhiko)) - 修复了启动提示，以明确思考级别选择并扩展思考指导 - 修复了 SDK 初始模型解析，使其使用 `findInitialModel`，并为 Anthropic 模型默认设为 Claude Opus 4.5 - 修复了无模型警告，使其包含 `/model` 指令 - 修复了身份验证错误消息，使其指向身份验证文档 - 修复了 bash 输出提示行，使其按终端宽度截断 - 修复了自定义编辑器，使其遵循 `paddingX` 设置 ([#936](https://github.com/badlogic/pi-mono/pull/936) by [@Perlence](https://github.com/Perlence)) - 修复了系统提示词工具列表，使其仅显示内置工具 - 修复了包管理器，使其在使用缓存副本前检查 npm 包版本 - 修复了包管理器，使其在克隆包含 `package.json` 的 Git 仓库后运行 `npm install` - 修复了扩展提供商注册，使其在模型解析前生效 - 修复了编辑器多行插入处理及 `lastAction` 跟踪 ([#945](https://github.com/badlogic/pi-mono/pull/945) by [@Perlence](https://github.com/Perlence)) - 修复了编辑器自动换行，以预留光标列 ([#934](https://github.com/badlogic/pi-mono/pull/934) by [@Perlence](https://github.com/Perlence)) - 修复了编辑器自动换行，使其使用单次回溯处理空白字符 ([#924](https://github.com/badlogic/pi-mono/pull/924) by [@Perlence](https://github.com/Perlence)) - 修复了 Kitty 图像 ID 的分配与清理，以防止图像 ID 冲突 - 修复了终端调整大小后覆盖层保持居中显示的问题 ([#950](https://github.com/badlogic/pi-mono/pull/950) by [@nicobailon](https://github.com/nicobailon)) - 修复了流式分发，使其使用模型 API 类型而非硬编码的 API 默认值 - 修复了 Google 提供商，使其在省略工具调用参数时默认使用空对象 - 修复了 OpenAI Responses 流式处理，使其在 OpenAI 兼容端点上处理 `arguments.done` 事件 ([#917](https://github.com/badlogic/pi-mono/pull/917) by [@williballenthin](https://github.com/williballenthin)) - 修复了共享 Responses 重构后 OpenAI Codex Responses 的工具严格性处理 - 修复了 Azure OpenAI Responses 流式处理，使其在内容部分前保护增量，并修正元数据和交接门控 - 修复了连续工具结果后 OpenAI 补全工具结果图像批处理的问题 ([#902](https://github.com/badlogic/pi-mono/pull/902) by [@terrorobe](https://github.com/terrorobe)) - 修复了 bash 输出“更早行数”计数中的差一错误，该错误由将间距换行符计为隐藏内容引起 ([#921](https://github.com/badlogic/pi-mono/issues/921)) - 用户包过滤器现在叠加在清单过滤器之上，而非替换它们 ([#645](https://github.com/badlogic/pi-mono/issues/645)) - 自动重试现在可处理 Codex API 流中断时产生的“已终止”错误 - 后续队列（Alt+Enter）现在发送完整的粘贴内容，而非 `[paste #N ...]` 标记 ([#912](https://github.com/badlogic/pi-mono/pull/912) by [@aliou](https://github.com/aliou)) - 修复了 Alt-Up 无法恢复压缩期间排队消息的问题 ([#923](https://github.com/badlogic/pi-mono/pull/923) by [@aliou](https://github.com/aliou)) - 修复了通过 `--session` 标志加载空会话文件或无效会话文件时导致的会话损坏问题 ([#932](https://github.com/badlogic/pi-mono/issues/932) by [@armanddp](https://github.com/armanddp)) - 修复了扩展在使用 `setEditorComponent()` 时快捷键无法触发的问题 ([#947](https://github.com/badlogic/pi-mono/pull/947) by [@Perlence](https://github.com/Perlence)) - 会话“修改”时间现在使用最后一条消息的时间戳而非文件修改时间，因此重命名不会打乱最近列表的顺序 ([#863](https://github.com/badlogic/pi-mono/pull/863) by [@svkozak](https://github.com/svkozak))

### New Features - Pi packages for bundling and installing extensions, skills, prompts, and themes. See [docs/packages.md](docs/packages.md). - Hot reload (`/reload`) of resources including AGENTS.md, SYSTEM.md, APPEND_SYSTEM.md, prompt templates, skills, themes, and extensions. See [README.md#commands](README.md#commands) and [README.md#context-files](README.md#context-files). - Custom providers via `pi.registerProvider()` for proxies, custom endpoints, OAuth or SSO flows, and non-standard streaming APIs. See [docs/custom-provider.md](docs/custom-provider.md). - Azure OpenAI Responses provider support with deployment-aware model mapping. See [docs/providers.md#azure-openai](docs/providers.md#azure-openai). - OpenRouter routing support for custom models via `openRouterRouting`. See [docs/providers.md#api-keys](docs/providers.md#api-keys) and [docs/models.md](docs/models.md). - Skill invocation messages are now collapsible and skills can opt out of model invocation via `disable-model-invocation`. See [docs/skills.md#frontmatter](docs/skills.md#frontmatter). - Session selector renaming and configurable keybindings. See [README.md#commands](README.md#commands) and [docs/keybindings.md](docs/keybindings.md). - `models.json` headers can resolve environment variables and shell commands. See [docs/models.md#value-resolution](docs/models.md#value-resolution). - `--verbose` CLI flag to override quiet startup. See [README.md#cli-reference](README.md#cli-reference). Read the fully revamped docs in `README.md`, or have your clanker read them for you. ### SDK Migration Guide There are multiple SDK breaking changes since v0.49.3. For the quickest migration, point your agent at `packages/coding-agent/docs/sdk.md`, the SDK examples in `packages/coding-agent/examples/sdk`, and the SDK source in `packages/coding-agent/src/core/sdk.ts` and related modules. ### Breaking Changes - Header values in `models.json` now resolve environment variables (if a header value matches an env var name, the env var value is used). This may change behavior if a literal header value accidentally matches an env var name. ([#909](https://github.com/badlogic/pi-mono/issues/909)) - External packages (npm/git) are now configured via `packages` array in settings.json instead of `extensions`. Existing npm:/git: entries in `extensions` are auto-migrated. ([#645](https://github.com/badlogic/pi-mono/issues/645)) - Resource loading now uses `ResourceLoader` only and settings.json uses arrays for extensions, skills, prompts, and themes ([#645](https://github.com/badlogic/pi-mono/issues/645)) - Removed `discoverAuthStorage` and `discoverModels` from the SDK. `AuthStorage` and `ModelRegistry` now default to `~/.pi/agent` paths unless you pass an `agentDir` ([#645](https://github.com/badlogic/pi-mono/issues/645)) ### Added - Session renaming in `/resume` picker via `Ctrl+R` without opening the session ([#863](https://github.com/badlogic/pi-mono/pull/863) by [@svkozak](https://github.com/svkozak)) - Session selector keybindings are now configurable ([#948](https://github.com/badlogic/pi-mono/pull/948) by [@aos](https://github.com/aos)) - `disable-model-invocation` frontmatter field for skills to prevent agentic invocation while still allowing explicit `/skill:name` commands ([#927](https://github.com/badlogic/pi-mono/issues/927)) - Exposed `copyToClipboard` utility for extensions ([#926](https://github.com/badlogic/pi-mono/issues/926) by [@mitsuhiko](https://github.com/mitsuhiko)) - Skill invocation messages are now collapsible in chat output, showing collapsed by default with skill name and expand hint ([#894](https://github.com/badlogic/pi-mono/issues/894)) - Header values in `models.json` now support environment variables and shell commands, matching `apiKey` resolution ([#909](https://github.com/badlogic/pi-mono/issues/909)) - Added HTTP proxy environment variable support for API requests ([#942](https://github.com/badlogic/pi-mono/pull/942) by [@haoqixu](https://github.com/haoqixu)) - Added OpenRouter provider routing support for custom models via `openRouterRouting` compat field ([#859](https://github.com/badlogic/pi-mono/pull/859) by [@v01dpr1mr0s3](https://github.com/v01dpr1mr0s3)) - Added `azure-openai-responses` provider support for Azure OpenAI Responses API. ([#890](https://github.com/badlogic/pi-mono/pull/890) by [@markusylisiurunen](https://github.com/markusylisiurunen)) - Added changelog link to update notifications ([#925](https://github.com/badlogic/pi-mono/pull/925) by [@dannote](https://github.com/dannote)) - Added `--verbose` CLI flag to override quietStartup setting ([#906](https://github.com/badlogic/pi-mono/pull/906) by [@Perlence](https://github.com/Perlence)) - `markdown.codeBlockIndent` setting to customize code block indentation in rendered output - Extension package management with `pi install`, `pi remove`, `pi update`, and `pi list` commands ([#645](https://github.com/badlogic/pi-mono/issues/645)) - Package filtering: selectively load resources from packages using object form in `packages` array ([#645](https://github.com/badlogic/pi-mono/issues/645)) - Glob pattern support with minimatch in package filters, top-level settings arrays, and pi manifest (e.g., `"!funky.json"`, `"*.ts"`) ([#645](https://github.com/badlogic/pi-mono/issues/645)) - `/reload` command to reload extensions, skills, prompts, and themes ([#645](https://github.com/badlogic/pi-mono/issues/645)) - `pi config` command with TUI to enable/disable package and top-level resources via patterns ([#938](https://github.com/badlogic/pi-mono/issues/938)) - CLI flags for `--skill`, `--prompt-template`, `--theme`, `--no-prompt-templates`, and `--no-themes` ([#645](https://github.com/badlogic/pi-mono/issues/645)) - Package deduplication: if same package appears in global and project settings, project wins ([#645](https://github.com/badlogic/pi-mono/issues/645)) - Unified collision reporting with `ResourceDiagnostic` type for all resource types ([#645](https://github.com/badlogic/pi-mono/issues/645)) - Show provider alongside the model in the footer if multiple providers are available - Custom provider support via `pi.registerProvider()` with `streamSimple` for custom API implementations - Added `custom-provider.ts` example extension demonstrating custom Anthropic provider with OAuth ### Changed - `/resume` picker sort toggle moved to `Ctrl+S` to free `Ctrl+R` for rename ([#863](https://github.com/badlogic/pi-mono/pull/863) by [@svkozak](https://github.com/svkozak)) - HTML export: clicking a sidebar message now navigates to its newest leaf and scrolls to it, instead of truncating the branch ([#853](https://github.com/badlogic/pi-mono/pull/853) by [@mitsuhiko](https://github.com/mitsuhiko)) - HTML export: active path is now visually highlighted with dimmed off-path nodes ([#929](https://github.com/badlogic/pi-mono/pull/929) by [@hewliyang](https://github.com/hewliyang)) - Azure OpenAI Responses provider now uses base URL configuration with deployment-aware model mapping and no longer includes service tier handling - `/reload` now re-renders the entire scrollback so updated extension components are visible immediately ([#928](https://github.com/badlogic/pi-mono/pull/928) by [@ferologics](https://github.com/ferologics)) - Skill, prompt template, and theme discovery now use settings and CLI path arrays instead of legacy filters ([#645](https://github.com/badlogic/pi-mono/issues/645)) ### Fixed - Extension `setWorkingMessage()` calls in `agent_start` handlers now work correctly; previously the message was silently ignored because the loading animation didn't exist yet ([#935](https://github.com/badlogic/pi-mono/issues/935)) - Fixed package auto-discovery to respect loader rules, config overrides, and force-exclude patterns - Fixed /reload restoring the correct editor after reload ([#949](https://github.com/badlogic/pi-mono/pull/949) by [@Perlence](https://github.com/Perlence)) - Fixed distributed themes breaking `/export` ([#946](https://github.com/badlogic/pi-mono/pull/946) by [@mitsuhiko](https://github.com/mitsuhiko)) - Fixed startup hints to clarify thinking level selection and expanded thinking guidance - Fixed SDK initial model resolution to use `findInitialModel` and default to Claude Opus 4.5 for Anthropic models - Fixed no-models warning to include the `/model` instruction - Fixed authentication error messages to point to the authentication documentation - Fixed bash output hint lines to truncate to terminal width - Fixed custom editors to honor the `paddingX` setting ([#936](https://github.com/badlogic/pi-mono/pull/936) by [@Perlence](https://github.com/Perlence)) - Fixed system prompt tool list to show only built-in tools - Fixed package manager to check npm package versions before using cached copies - Fixed package manager to run `npm install` after cloning git repositories with a package.json - Fixed extension provider registrations to apply before model resolution - Fixed editor multi-line insertion handling and lastAction tracking ([#945](https://github.com/badlogic/pi-mono/pull/945) by [@Perlence](https://github.com/Perlence)) - Fixed editor word wrapping to reserve a cursor column ([#934](https://github.com/badlogic/pi-mono/pull/934) by [@Perlence](https://github.com/Perlence)) - Fixed editor word wrapping to use single-pass backtracking for whitespace handling ([#924](https://github.com/badlogic/pi-mono/pull/924) by [@Perlence](https://github.com/Perlence)) - Fixed Kitty image ID allocation and cleanup to prevent image ID collisions - Fixed overlays staying centered after terminal resizes ([#950](https://github.com/badlogic/pi-mono/pull/950) by [@nicobailon](https://github.com/nicobailon)) - Fixed streaming dispatch to use the model api type instead of hardcoded API defaults - Fixed Google providers to default tool call arguments to an empty object when omitted - Fixed OpenAI Responses streaming to handle `arguments.done` events on OpenAI-compatible endpoints ([#917](https://github.com/badlogic/pi-mono/pull/917) by [@williballenthin](https://github.com/williballenthin)) - Fixed OpenAI Codex Responses tool strictness handling after the shared responses refactor - Fixed Azure OpenAI Responses streaming to guard deltas before content parts and correct metadata and handoff gating - Fixed OpenAI completions tool-result image batching after consecutive tool results ([#902](https://github.com/badlogic/pi-mono/pull/902) by [@terrorobe](https://github.com/terrorobe)) - Off-by-one error in bash output "earlier lines" count caused by counting spacing newline as hidden content ([#921](https://github.com/badlogic/pi-mono/issues/921)) - User package filters now layer on top of manifest filters instead of replacing them ([#645](https://github.com/badlogic/pi-mono/issues/645)) - Auto-retry now handles "terminated" errors from Codex API mid-stream failures - Follow-up queue (Alt+Enter) now sends full paste content instead of `[paste #N ...]` markers ([#912](https://github.com/badlogic/pi-mono/issues/912)) - Fixed Alt-Up not restoring messages queued during compaction ([#923](https://github.com/badlogic/pi-mono/pull/923) by [@aliou](https://github.com/aliou)) - Fixed session corruption when loading empty or invalid session files via `--session` flag ([#932](https://github.com/badlogic/pi-mono/issues/932) by [@armanddp](https://github.com/armanddp)) - Fixed extension shortcuts not firing when extension also uses `setEditorComponent()` ([#947](https://github.com/badlogic/pi-mono/pull/947) by [@Perlence](https://github.com/Perlence)) - Session "modified" time now uses last message timestamp instead of file mtime, so renaming doesn't reorder the recent list ([#863](https://github.com/badlogic/pi-mono/pull/863) by [@svkozak](https://github.com/svkozak))