Pi 1.0.4

本文是 Pi 1.0.4 的官方发布说明（Changelog/Release notes），面向 Pi 的现有用户，回答『升级到 1.0.4 能得到什么、修复了什么』。

针对的背景是此前版本存在多类缺陷与能力缺口：工具过滤会误删 MCP 工具、codemode 脚本收不到图像、部分 MCP 服务器 OAuth 登录失败、脚本改写内建对象导致崩溃，以及缺少按模式批量选择工具和单次禁用 MCP 的开关。

发布 Pi 1.0.4，正文分三部分：

1. New Features：--tools/--exclude-tools 支持 * 模式，示例 --tools read,codemode,'mcp__radius__*' 可只保留一个 MCP 服务器的工具；--tools 改为保留 MCP 工具（除非条目以 mcp__ 开头）；新增 --no-mcp 单次禁用 MCP；codemode 的 tools.read() 读图像文件返回可由 image() 展示的图像块。
2. Added：上述两条 CLI 能力。
3. Fixed：8 项修复，覆盖语法高亮、codemode 图像、MCP OAuth、--tools 行为、MCP 会话关闭、隐藏工具提示、Bedrock 重试与内建对象冻结。发布渠道为 GitHub release 与 npm。

• 新增 * 模式：--tools/--exclude-tools 可用 --tools read,codemode,'mcp__radius__*' 之类写法
• 新增 --no-mcp：单次运行禁用内建 MCP
• 修复 fenced code block 中多行字符串/注释首行之后语法高亮掉色（#10143）
• 修复 codemode 收不到图像：tools.read() 对图像文件返回图像块，image() 可展示（#10251）
• 修复带 OpenID Connect client registration 的 MCP 服务器（如 mcp.modem.dev）OAuth 报 invalid_redirect_uri：改为注册 native client（#10493）
• 修复 --tools 误删 MCP 工具：现保留 MCP 工具，除非条目以 mcp__ 开头
• 修复 MCP 会话关闭在服务器仍在连接时提前返回、传输悬挂至应答或超时（#10249）
• 修复系统提示规则与 skills hint 点名被隐藏工具；隐藏工具不入规则，ToolLoadout 新增 getPromptGuidelines()（#10343）
• 修复 Bedrock 在 HTTP/2 停滞报 The pending stream has been canceled 时不自动重试（#10379）
• 修复 codemode 脚本改写内建对象（如 Array.prototype.toJSON）致 pi 崩溃：内建对象于脚本运行前冻结（#10444）

原文未给出显式结论或迁移建议。隐含意义：1.0.4 是以缺陷修复为主、附带工具过滤增强的维护性版本；其中 --tools 语义发生变更（默认保留 MCP 工具），是升级时需注意的行为变化。适用边界限于 Pi 1.0.4 及列出的具体场景，未涉及的其他平台与错误类型原文未说明。

发布日期为 2026 年 10 月 5 日（正文标注 Oct 5, 2026；结构化来源日期 2026年10月5日 08:00（北京时间），即北京时间 2026-10-05 08:00）。所述变更在 1.0.4 版本内为既成事实；其对后续版本是否仍成立，原文未说明，当前实际状态也无法从原文验证。

适用于 Pi 1.0.4 的下列场景：

1. 命令行工具过滤：--tools、--exclude-tools、--no-mcp。
2. 启用内建 MCP 支持并连接 MCP 服务器，含采用 OpenID Connect client registration 的服务器（如 mcp.modem.dev）。
3. codemode 脚本：读取/展示图像、以及可能改写内建对象的脚本。
4. 经 Bedrock 发请求并可能遭遇 HTTP/2 连接停滞的环境。
5. 使用 prepareLoadout 隐藏工具、依赖系统提示规则与 skills hint 的配置。

产品形态为经 npm 分发的 CLI 工具。

• 行为：--tools 由移除 MCP 工具改为保留（除非条目以 mcp__ 开头）；MCP 会话关闭不再在连接未完成时提前返回；Bedrock 对特定停滞错误自动重试；MCP OAuth 改注册为 native client；内建对象在 codemode 脚本运行前被冻结。
• 新增能力：* 通配符过滤、--no-mcp、tools.read() 返回图像块、ToolLoadout.getPromptGuidelines()。
• 提示结构：系统提示规则剔除隐藏工具；文件读取器被隐藏时 skills hint 不点名任何工具；codemode 随声明展示各工具的提示指南。
• 显示修复：fenced code block 多行内容语法高亮不再掉色。
• 价格及其他变量：原文未说明。

有明确因果证据（修复描述即因果链）：

1. codemode 脚本改写内建对象导致 pi 崩溃、工具调用未结算→冻结内建对象后补丁无效（#10444）。
2. HTTP/2 停滞引发 The pending stream has been canceled 且不重试→修复为自动重试（#10379）。
3. OAuth 非 native client 注册导致 invalid_redirect_uri→改为 native client（#10493）。

包含关系：mcp__ 前缀条目是 --tools 过滤逻辑的一部分；图像块是 tools.read() 对图像文件返回值的一部分。仅为相关、无因果解释：语法高亮掉色的根因（#10143）、MCP 会话关闭缺陷的深层机制（#10249）均只给出现象与修复结果，根因原文未说明。

作者/署名：原文未说明（结构化作者字段为空，正文无署名）。关键技术（原理按原文描述）：

1. MCP：pi 内建支持，可被 --no-mcp 单次禁用；MCP 工具以 mcp__ 前缀标识，可用 mcp__radius__* 之类模式匹配；会话关闭需等待服务器连接完成。
2. codemode：脚本环境，提供 tools.read() 与 image()；tools.read() 对图像文件解析为图像块；内建对象在脚本运行前冻结。
3. ToolLoadout：与 prepareLoadout 隐藏工具相关，新增 getPromptGuidelines() 用于获取工具提示指南。
4. OAuth/OpenID Connect：MCP 服务器登录机制，pi 以 native client 身份注册。
5. HTTP/2：Bedrock 请求传输层，停滞会触发 The pending stream has been canceled。

更深层实现原理原文未说明。

元：这是版本发布说明，本质在解决『变更透明化与升级决策』问题——告知用户 1.0.4 改了什么、哪些行为变化（尤其 --tools 语义）会影响既有用法。

反：最可能有边界或失效的主张：--tools 保留 MCP 工具依赖 mcp__ 前缀这一约定，属约定型行为，后续版本可再变；OAuth 修复仅覆盖『带 OpenID Connect client registration』的服务器（示例 mcp.modem.dev），其他服务器情形原文未说明；Bedrock 重试仅针对列出的特定错误消息；冻结内建对象意味着依赖运行时打补丁的 codemode 脚本将失效，这是修复附带的行为限制。

空：去掉发布叙事后剩下的必要事实：1.0.4 于 2026-10-05 发布，经 GitHub release 与 npm 分发；新增 * 模式过滤、--no-mcp 与 codemode 图像支持；修复 8 项缺陷（7 项带 issue 编号，1 项无编号）。

综合：这是一份以修复为主、信息粒度到 issue 级的维护版本记录；核心可执行结论是升级后 --tools 默认保留 MCP 工具及 MCP/codemode 稳定性提升，但一切结论仅限 1.0.4 与列出的场景，不应外推到其他版本或未列出的错误类型。