黄奕彬

外部精选

Pi 1.0.1

本文来自外部来源,不是黄奕彬的原创文章。本站提供原文入口,并在采集端生成 AI 结构化摘要、解读与中文翻译(如有),一切以原文为准。

阅读原文(pi.dev)
来源
Pi Changelog ↗
作者 / 署名
未标注
发布日期
本站收录时间
原文域名
pi.dev

以上时间均为北京时间;来源更新时间由来源提供,不代表首次发布时间。

结构化摘要 AI 生成

背景与问题

本文是 Pi 1.0.1 的版本发布说明,面向已在使用 Pi(一款可通过 npm、pi.dev 安装器安装的 CLI 工具)的用户,回答『这个版本新增了什么、改了什么、修了什么』。发布说明标注日期 Oct 3, 2026(来源日期换算为北京时间 2026-10-03 08:00)。

方法或内容

按 New Features / Added / Changed / Fixed / Removed 五节逐项列出变更,多数条目附 GitHub issue/PR 编号及文档链接(Install pi、Configure servers、Authenticate with OAuth、Tool rendering、Use classifier models)。

内容覆盖安装方式、MCP 项目级覆盖、OAuth 客户端识别、工具渲染器、分类器模型接入,以及多项 bug 与安全修复。

关键发现 / 结果

  • 新增 Nix flake(macOS/Linux):nix run github:earendil-works/pi/stable 运行最新版,nix profile add github:earendil-works/pi/stable 安装。
  • 项目级 MCP 覆盖:.pi/mcp. 无 command/url 的条目仅设置 enabled、exposure、toolExposure,/mcp 可按项目启停服务器。
  • oauth.clientRegistration: "cimd":授权服务器可按 pi.dev 上的 Client ID Metadata Document URL 放行 pi,替代动态客户端注册。
  • pi.registerToolRenderer():自定义工具调用的绘制方式,含未注册工具(如恢复会话中的 MCP 工具)。
  • Cloudflare Clef 分类器 @cf/cloudflare/clef、@cf/cloudflare/clef-flash 可在 codemode 脚本与扩展中使用。
  • 安全修复:固定 brace-expansion 5.0.12(此前安装可能解析到有漏洞的 5.0.9,对应 GHSA-q2hr-2g5m-vwhr 等)。
  • codemode 循环打印导致内存耗尽崩溃:输出超 16 Mi 字符或 100000 项即令脚本失败。
  • Bedrock 272k 以上输入 token 计费档修正;AI Gateway Claude 模型改用连字符 ID(claude-opus-5-5 而非 claude-opus-5.5)修复 404。
  • 默认 NVIDIA 模型改为 nvidia/nemotron-3-ultra-550b-a55b(原 nvidia/nemotron-3-super-120b-a12b 已不再提供)。
  • OAuth 登录界面新增复制键 app.message.copy(默认 ctrl+x)复制登录 URL。
  • 移除发布包中的 npm-shrinkwrap.:npm 安装不再固定传递依赖,库使用者可自行覆盖。

结论与意义

该版本为功能加维护型发布:扩展安装渠道(Nix)、细化 MCP 项目级配置、以 CIMD 简化 OAuth 放行,并修复一项依赖漏洞与多项兼容性问题。pi update 现建议全局 npm 用户迁移到 pi.dev 管理安装以固定全部依赖。适用边界:仅针对 Pi 1.0.1;provider 相关修复依赖对应厂商发布当时的行为。

AI 解读 AI 生成

方法:按「时空变量」分析(时间 / 空间 / 变量,严格区分包含、相关与因果),对象包括原文作者、署名人员与关键技术及其实际原理;结论用「元反空」(元思考、反思考、空思考、综合)整理。

时间:何时发生,现在是否仍成立

所有变更随 Pi 1.0.1 一次性发布,发布说明日期为 2026-10-03(来源日期,北京时间 2026-10-03 08:00)。内容是该时点的快照;是否现在仍成立原文未说明。

其中依赖外部服务的条目(NVIDIA 默认模型、Together 模型名、Bedrock 定价档、AI Gateway 模型 ID)随上游厂商变动最易过期。

空间:谁的环境 / 场景

适用于 Pi 1.0.1 用户,覆盖多种部署/使用形态:npm 全局安装、pi.dev 管理安装器、macOS/Linux 上的 Nix。

使用场景包括:MCP 服务器配置与 OAuth 登录、codemode 脚本与扩展、扩展通过 Image 渲染 JPEG/GIF/WebP 图片(终端涉及 Kitty、Ghostty、WezTerm、Warp),以及模型提供方 Anthropic、Cloudflare Workers AI、Cloudflare AI Gateway、Amazon Bedrock、Together、NVIDIA。

变量:实际改变了什么

  • 安装:新增 Nix flake;发布包移除 npm-shrinkwrap.,npm 安装从『固定传递依赖』变为『不固定、可由库使用者覆盖』。
  • MCP:新增项目级覆盖维度(enabled/exposure/toolExposure)。
  • OAuth:新增 cimd 注册路径;登录界面新增 app.message.copy(默认 ctrl+x)。
  • 行为:Anthropic 会话中重定义同名工具改为内联定义以保留 prompt cache;pi update 对全局 npm 安装改为推荐迁移管理安装。
  • 依赖与外部引用:brace-expansion 固定为 5.0.12;AI Gateway Claude 模型 ID 改连字符写法;默认 NVIDIA 模型更换;Together 模型适配新名 deepseek-ai/DeepSeek-V4-Pro-0813。

区分:包含 ≠ 相关 ≠ 因果

有明确因果证据的:固定 brace-expansion 5.0.12 以修复漏洞(附 GHSA 编号);--models 尾随逗号导致循环中多出一个模型;codemode 循环打印导致内存耗尽崩溃,改为超限即失败;带连字符模型 ID 修复 AI Gateway 404;回调端口被占用导致『OAuth state mismatch』,现改为直接报端口占用错误。

属包含/范围而非因果的:Clef 分类器『可用于 codemode 脚本与扩展』是可用范围声明;Nix flake 仅是新增安装途径;移除 shrinkwrap 与『建议迁移管理安装』是并存的政策变化,其动机原文未说明。

对象:作者/署名与关键技术原理

作者/署名:结构化作者字段为空,原文未标注署名(个别条目附贡献者 GitHub 账号:@ndisidore、@RealAlexandreAI、@cv)。关键技术及原文描述:- MCP 服务器配置:用户级配置可被项目级 .pi/mcp. 覆盖。

  • Client ID Metadata Document(cimd):以 pi.dev 上的文档 URL 标识 pi,替代动态客户端注册,使授权服务器可按 URL 放行。- pi.registerToolRenderer():决定工具调用如何绘制,包括尚未注册的工具。- Nix flake(github:earendil-works/pi/stable):macOS/Linux 的运行与安装途径。
  • codemode 脚本与扩展:可调用 cloudflare-workers-ai 的 Clef 分类器模型。

元反空综合结论

元:这条内容本质是给 Pi(AI CLI 工具)用户的版本差异清单,解决『升级到 1.0.1 会遇到什么变化、为什么』的信息问题。

反:最可能失效或有边界的部分是依赖外部厂商的条目——NVIDIA 默认模型指向、Together 重命名后的模型名、Bedrock 定价档、AI Gateway 模型 ID——上游一变即过期;『建议迁移管理安装』是推荐而非强制,政策可能再变;移除 shrinkwrap 对期望固定依赖树的 npm 用户是行为回退。

空:去掉叙事后剩下的必要事实是——Pi 1.0.1 于 2026-10-03 发布,新增 Nix 安装、MCP 项目级覆盖、CIMD 注册、通用工具渲染器、Clef 分类器接入,修复 brace-expansion 漏洞及多项 bug,并从发布包移除 npm-shrinkwrap.。

综合结论:这是一次能力扩展加稳健性修复的常规版本,核心增量在安装灵活性与 MCP/OAuth 配置粒度;依赖固定依赖树的 npm 用户应关注行为变化并按原文建议改用 pi.dev 安装器。

中文译文 AI 生成

变更日志 发布说明 2026年10月3日 Pi 1.0.1 GitHub release npm

新功能

  • Nix flake —— nix run github:earendil-works/pi/stable 运行最新版本,nix profile add github:earendil-works/pi/stable 安装该版本。参见 Install pi。
  • MCP 服务器的项目级覆盖 —— .pi/mcp.json 和 /mcp 可以针对单个项目启用、禁用或更改某个用户级服务器的暴露方式。参见 Configure servers。
  • MCP Client ID Metadata Documents —— oauth.clientRegistration: "cimd" 让授权服务器可以通过其文档 URL 允许 pi,而非动态注册。参见 Authenticate with OAuth。
  • 任意工具的工具渲染器 —— pi.registerToolRenderer() 可以绘制对尚未注册工具的调用,例如恢复会话中的 MCP 工具。参见 Tool rendering。
  • Cloudflare Clef 分类器 —— @cf/cloudflare/clef 和 @cf/cloudflare/clef-flash 可在 codemode 脚本和扩展中使用。参见 Use classifier models。

新增

  • 为 /login、/mcp 和 /mcp login 中的 OAuth 登录界面添加了复制键(app.message.copy,默认 ctrl+x),在无法打开浏览器或无法选中所包裹的链接时复制登录 URL。
  • 为 MCP 服务器添加了 oauth.clientRegistration: "cimd",让 pi 通过其在 pi.dev 上的 Client ID Metadata Document 标识自身,而非动态客户端注册,从而授权服务器可以按 URL 允许 pi(#10302)
  • 为用户级 MCP 服务器添加了项目级覆盖:不含 command 或 url 的 .pi/mcp.json 条目仅设置用户级服务器的 enabled、exposure 和 toolExposure,/mcp 可以为当前项目启用或禁用某个服务器(#10277)
  • 向 cloudflare-workers-ai 添加了 Cloudflare 的 Clef 和 Clef Flash 分类器模型,可在 codemode 脚本和扩展中使用(#10316 由 @ndisidore,#10322 由 @RealAlexandreAI)
  • 添加了 pi.registerToolRenderer(),用于选择工具调用的绘制方式,包括未注册的工具(#10285)
  • 为 macOS 和 Linux 添加了 Nix flake:nix run github:earendil-works/pi/stable 运行最新版本,nix profile add github:earendil-works/pi/stable 安装该版本。参见 Install pi(#9137)

变更

  • 全局 npm 安装上的 pi update 现在会建议迁移到 pi.dev 安装器提供的托管安装,后者固定所有依赖。
  • 在对话中途添加或重新定义的 Anthropic 工具现在会在对话中内联定义,因此以同名重新定义工具会保留 prompt cache,而不是重新发送完整工具列表。

修复

  • 通过将 brace-expansion 5.0.12 固定为直接依赖,修复了安装会解析到存在漏洞的 brace-expansion 5.0.9 的问题(GHSA-q2hr-2g5m-vwhr、GHSA-qhr7-859c-m2p7、GHSA-6j4f-fj2g-mc7p)(#10288)
  • 修复了 --models 中的尾部逗号会向模型循环添加多余模型的问题(#10334)
  • 修复了循环打印的 codemode 脚本因内存耗尽导致 pi 崩溃的问题:脚本输出超过 16 Mi 字符或 100000 项后即失败(#10283)
  • 修复了扩展通过 Image 渲染的 JPEG、GIF 和 WebP 图像在 Kitty、Ghostty、WezTerm 和 Warp 中不显示的问题(#10292)
  • 修复了恢复会话和 HTML 导出中的 MCP 工具调用在服务器连接前一直完全展开渲染、若服务器始终未连接则永久展开的问题(#10285)
  • 修复了全屏 Kitty 图像在 WezTerm 中滚动后折叠为单行条带的问题(#10319)
  • 修复了 Selected model is at capacity 提供商错误导致终止回合而不是重试的问题(#10278)
  • 修复了 Cloudflare AI Gateway Claude 模型返回 404 失败的问题,方法是使用带连字符的模型 ID(claude-opus-5-5 而非 claude-opus-5.5)
  • 修复了 Sign in with ChatGPT 在其回调端口被另一次登录占用时仍继续的问题,该问题会使浏览器显示 OAuth state mismatch;现在会以端口被占用的错误失败(#10265)
  • 修复了 Amazon Bedrock OpenAI 模型对超过 272k 输入 token 的请求按短上下文费率计费的问题;Bedrock 模型现在包含 models.dev 上列出的定价层级(#10326)
  • 修复了 Amazon Bedrock Claude 请求在系统提示或工具更改后以 Invalid signature in thinking block 失败的问题(#10324)
  • 修复了 Together DeepSeek V4 Pro 在 Together 将其重命名为 deepseek-ai/DeepSeek-V4-Pro-0813 后丢失 thinking 级别控制的问题(#10336 由 @cv)
  • 修复了默认 NVIDIA 模型指向 nvidia/nemotron-3-super-120b-a12b(NVIDIA 已不再提供该模型)的问题;默认值现为 nvidia/nemotron-3-ultra-550b-a55b

移除

  • 从发布的包中移除了 npm-shrinkwrap.json。npm 安装不再固定传递依赖,库使用者现在可以覆盖这些依赖。如需固定依赖的安装,请使用 pi.dev 安装器(#5653)
展开原文提取正文(采集端自动提取,可能有缺失)

ChangelogRelease notesOct 3, 2026Pi 1.0.1GitHub releasenpmNew Features

Nix flake — nix run github:earendil-works/pi/stable runs the latest release, and nix profile add github:earendil-works/pi/stable installs it. See Install pi. Project overrides for MCP servers — .pi/mcp.json and /mcp can enable, disable, or change the exposure of a user-level server for one project. See Configure servers. MCP Client ID Metadata Documents — oauth.clientRegistration: "cimd" lets authorization servers allow pi by its document URL instead of dynamic registration. See Authenticate with OAuth. Tool renderers for any tool — pi.registerToolRenderer() draws calls to tools that are not registered yet, such as MCP tools in resumed sessions. See Tool rendering. Cloudflare Clef classifiers — @cf/cloudflare/clef and @cf/cloudflare/clef-flash are usable from codemode scripts and extensions. See Use classifier models.

Added

Added a copy key (app.message.copy, default ctrl+x) to OAuth sign-in screens in /login, /mcp, and /mcp login, which copies the sign-in URL when the browser cannot be opened or the wrapped link cannot be selected. Added oauth.clientRegistration: "cimd" for MCP servers, which identifies pi with its Client ID Metadata Document on pi.dev instead of dynamic client registration, so authorization servers can allow pi by URL (#10302) Added project overrides for user-level MCP servers: a .pi/mcp.json entry without command or url sets only enabled, exposure, and toolExposure of the user-level server, and /mcp can enable or disable a server for the current project (#10277) Added Cloudflare's Clef and Clef Flash classifier models to cloudflare-workers-ai, usable from codemode scripts and extensions (#10316 by @ndisidore, #10322 by @RealAlexandreAI) Added pi.registerToolRenderer(), which chooses how calls to a tool are drawn, including tools that are not registered (#10285) Added a Nix flake for macOS and Linux: nix run github:earendil-works/pi/stable runs the latest release, and nix profile add github:earendil-works/pi/stable installs it. See Install pi (#9137)

Changed

pi update on global npm installations now recommends migrating to the managed installation from the pi.dev installer, which pins all dependencies. Anthropic tools added or redefined mid-conversation are now defined inline in the conversation, so redefining a tool under the same name keeps the prompt cache instead of resending the full tool list.

Fixed

Fixed installations resolving vulnerable brace-expansion 5.0.9 by pinning brace-expansion 5.0.12 as a direct dependency (GHSA-q2hr-2g5m-vwhr, GHSA-qhr7-859c-m2p7, GHSA-6j4f-fj2g-mc7p) (#10288) Fixed a trailing comma in --models adding an extra model to the model cycle (#10334) Fixed a codemode script that prints in a loop crashing pi by running out of memory: a script fails once its output passes 16 Mi characters or 100000 items (#10283) Fixed JPEG, GIF, and WebP images rendered by extensions through Image not appearing in Kitty, Ghostty, WezTerm, and Warp (#10292) Fixed MCP tool calls in resumed sessions and HTML exports rendering fully expanded until their server connected, or for good if it never did (#10285) Fixed fullscreen Kitty images collapsing to a one-row strip after scrolling in WezTerm (#10319) Fixed "Selected model is at capacity" provider errors ending the turn instead of being retried (#10278) Fixed Cloudflare AI Gateway Claude models failing with a 404 by using dashed model IDs (claude-opus-5-5 instead of claude-opus-5.5) Fixed Sign in with ChatGPT continuing when its callback port is taken by another login, which made the browser show "OAuth state mismatch"; it now fails with a port-in-use error (#10265) Fixed Amazon Bedrock OpenAI models costing requests above 272k input tokens at the short-context rate; Bedrock models now include the pricing tiers listed on models.dev (#10326) Fixed Amazon Bedrock Claude requests failing with "Invalid signature in thinking block" after the system prompt or tools changed (#10324) Fixed Together DeepSeek V4 Pro losing its thinking level controls after Together renamed it to deepseek-ai/DeepSeek-V4-Pro-0813 (#10336 by @cv) Fixed the default NVIDIA model pointing at nvidia/nemotron-3-super-120b-a12b, which NVIDIA no longer serves; the default is now nvidia/nemotron-3-ultra-550b-a55b

Removed

Removed npm-shrinkwrap.json from the published package. npm installations no longer pin transitive dependencies, and library consumers can now override them. Use the pi.dev installer for pinned installations (#5653)

原文入口

阅读原文(pi.dev)

原文将在新窗口打开。收录时间不是内容更新时间;正文、译文与解读的版权归原作者/来源所有,本站仅作个人阅读辅助并保留原文入口;页面时间均为北京时间。

作者/署名来自原文结构化字段(Atom/RSS/HTML meta/JSON-LD;GitHub release 显示的是发布者账号),未经模型补充。

了解来源批准与收录规则