my-pi-agent v0.2.0: Terminal-Bench 2.1 83.53% 胜率、Pi 1.0 架构对齐、全链路极简重构与多模态图片管线

What's New in v0.2.0

v0.2.0 是 my-pi-agent 的里程碑版本，标志着项目在权威真实环境 Linux 编码基准 Terminal-Bench 2.1 中取得历史性突破（斩获 71 胜 / 83.53% 胜率，全面超越原厂 Pi），并完成了 Pi 1.0 极简架构规范对齐、全盘拔除历史兼容垫片、TUI 交互巨石类模块化重构、以及端到端多模态图片资产管线与安全加固。

🌟 核心特性与架构演进

1. Terminal-Bench 2.1 终局战报定格 (71胜 / 83.53% 胜率)：

   • 严谨剔除原厂 Pi 72 胜中的自研 Agent 误统计胜场，校准原厂基准为 59 胜 / 66.29%（有效分母 85）；
   • 自研 MyPiAgent 斩获 71 胜 / 83.53% 胜率（底座大模型：DeepSeek-V4.1-Flash），攻克 gpt2-codegolf (1614万 Tokens)、torch-pipeline-parallelism、compile-compcert、fix-ocaml-gc 等地狱级题目；
   • 真实核算前缀缓存命中率：实测 build-cython-ext 复杂编译任务斩获 96.7% Prompt Cache Hit Rate；
   • 在 README 中集成 15 篇架构与实战长文专栏导航、九大实战暗坑归纳与可视化战报资产。

2. 端到端多模态图片处理与资产管线 (src/my_coding_agent/image_processing.py)：

   • 支持本地图片 (read 工具) 与远程图片自动下载、校验与元数据提取 (宽、高、MIME、格式)；
   • 智能超限自适应缩放（双线性插值降采样与 WebP/JPEG 智能压缩，防炸模型上下文）；
   • 会话持久化与资产溢出管理：大图自动转存至 .pi/agent/sessions/<id>/assets/ 物理目录，转录本记录轻量 asset 引用；
   • 兼容纯文本 LLM 与 Vision-Language 模型透明协议桥接。

3. 彻底拔除历史兼容垫片与死代码，架构极简重构：

   • 依照 Pi/Tau 核心规范与《代码简化与反模式消除指南》，全盘拔除所有历史兼容别名与过渡垫片；
   • 移除 _provider_context、make_task_tools 残留垫片与 6 个空壳结果子类，统一收敛为 StringCompatibleToolResult；
   • 移除 edit 工具已废弃的扁平 old_text/new_text 兼容入参；
   • 移除 CompactionEntry 伪装成 Message 的鸭子类型属性，条目回归纯净 summary；
   • 消除 ModelChangeEntry 与 SessionInfoEntry 镜像冗余字段，由单一规范字段驱动；
   • 拔除 rpc_server.py::__all__ 历史重导出别名，彻底收敛为 __all__ = ["RpcServer"]。

4. TUI 交互巨石类模块化解耦与声明式分发 (my-pi-tui/)：

   • 将 1938 行巨石类 interactive-mode.ts 解耦拆分为 selector-manager.ts、history-renderer.ts 与 event-dispatcher.ts 三大独立自治领域；
   • 将 500 行 switch 阶梯的 slash-commands.ts 重构为声明式 COMMAND_DISPATCH: Record<string, SlashCommandHandler> 分发表模式；
   • 统一全量 14 类核心生命周期事件与 fork 选择器支持。

5. 核心安全与并发加固：

   • 命令链注入防护：转义分号、管道符与反引号，阻断任意命令注入风险；
   • 宏文件路径穿越防御：强制白名单检验与绝对路径限制；
   • AuthManager 引入跨线程/进程细粒度 FileLock，保障凭据读写并发安全；
   • 彻底清除评测与样例脚本中的敏感 API 凭据，引入标准 MIT LICENSE。

---

📦 安装与升级方式

1. npm / npx（推荐）：

npx my-pi-agent
# 或者全局升级
npm install -g my-pi-agent@latest

2. 便携免安装包（Portable Release）：

直接下载下方 Release Assets 中的 .zip 或 .tar.gz 解压即用！

---

🧪 自动化测试验证

• 835 个 Python 核心/业务测试 + 80 个 Node.js TUI 测试 100% 绿灯全通（共 915 个自动化测试）。
• Pyright / TypeScript / Ruff 静态质量检查 0 错误、0 警告。

my-pi-agent v0.1.1: 大模型智能重试、TUI异常加固与凭据热重载

What's New in v0.1.1

v0.1.1 包含了对标 Pi 原厂的终端交互加固、大模型智能退避重试系统、凭据原地热更新以及彻底去除最大循环步数限制等多项核心重大演进。

🌟 核心特性与架构演进

1. 大模型智能退避重试体系 (my_agent_core/retry.py)：

   • 严格区分瞬时可恢复抖动（429 / 5xx / 传输断流与连接重置）与致命不可恢复错误（400 / 401 / 403 / 账号欠费配额超限）；
   • 采用带 Jitter 抖动的指数退避算法，并优先尊重服务端回传的 Retry-After / retry-after-ms 响应头；
   • 广播 AutoRetryStart 与 AutoRetryEnd 事实事件，TUI 顶部边框呈现实时重试倒计时（── ⠸ 重试中 (1/3) 2.0s 后继续 ──）并支持 Esc 毫秒级即时中断。

2. TUI 交互与异常防御全面加固 (my-pi-tui)：

   • 修复握手阶段模型鉴权失败（401 / 403）导致错误正文被中间层吞噬的问题，向用户直观展示 ⚠ Error code: 401...；
   • 修复 AssistantMessageComponent 接收 Array 或非字符串内容时调用 .trim() 抛出 TypeError 的崩溃漏洞；
   • interactive-mode.ts 在 agent_end 中引入 try...finally 强力终态保底，彻底杜绝输入框与底栏的旋转指示器（⠸）永久卡死。

3. 凭据热重载与原地无感刷新 (rpc_server.py)：

   • /reload 自动重新载入 AuthManager，并原地重新绑定当前活跃的 LLM 实例，外部修改 auth.json 或环境变量即可一键生效；
   • /login <provider> <key> 绑定凭据后，若当前正在使用该 Provider，当场原地热更新内存中的模型客户端，无需重启或切模型。

4. 彻底移除最大循环步数 (max_iterations) 限制：

   • 将 ReAct 微内核升级为真正的纯自主无界循环，由大模型自主决策停止或人类手动取消，支持复杂长任务自主推进。

5. 会话故障排查知识库沉淀：

   • 在 docs/coding/09-session-log-debugging-cases.md 中新增典型案例 4 与速查索引表。

---

📦 安装与升级方式

1. npm / npx（推荐）：

npx my-pi-agent
# 或者全局升级
npm install -g my-pi-agent@latest

2. 便携免安装包（Portable Release）：

直接下载下方 Release Assets 中的 .zip 或 .tar.gz 解压即用！

---

🧪 自动化测试验证

• 725 个 Python 核心/业务测试 + 71 个 Node.js TUI 测试 100% 绿灯全通（共 796 测试）。

my-pi-agent v0.1.0: Minimalist Pi-Style Coding Agent

What's Changed

• Pi-TUI Visual Parity: 100% pixel-level visual alignment with @earendil-works/pi-coding-agent.
• Zero Emoji Clutter: Eliminated wide-character and broken emoji rendering on Windows terminals.
• Header & Footer Hierarchy: Clean 4-tier viewport (Header -> Chat -> Editor -> Footer) with dual-line metrics footer.
• Three-Pillar Distribution:
  • npm / npx support (npx my-pi-agent)
  • PyPI / uvx support (uvx my-pi-agent)
  • Standalone installers (install.sh and install.ps1)
• Offline Test Suite: 651 unit tests passed with 100% coverage across core, coding, and LLM boundaries.