# Pi 1.1.0 集成基线

pi-kit 使用 **Pi / pi-tui 1.1.0** 开发和验收。宿主提供的包按 Pi 包规范声明为 `"*"` peer dependencies，开发依赖固定为 1.1.0。

## 工具与 codemode

- 使用 `registerToolRenderer()` 注册基础工具和 codemode 展示。
- codemode 的注册、激活、执行、sandbox、输出限制与计费由 Pi 负责；脚本 reasoning 指引通过选中工具的 prompt section 注入。
- 工具完成耗时使用宿主 `durationMs`；运行估时使用共享刷新器。模型调用使用原生 codemode records 的 `durationMs` 和 `cost`。
- 卡片边距使用宿主 `outputPad`，组件复用时同步更新。
- 嵌套调用快照保存在工具结果元数据中，用于历史回放和 HTML 导出。

## 标题与图片

- 标题以 `agent_settled` 为结束边界，使用其 `aborted` 字段识别取消；重试和续跑期间保持任务状态。
- OSC 7501 状态由 Pi 发送，pi-kit 只维护终端标题。
- `generate_image` 使用 Pi 原生模型运行时，转发取消信号与 usage，返回结构化文件路径。
- 图片文件随机命名、独占创建，权限为 0600。
- 模型认证、provider、工具选择、MCP、Markdown 和终端图片显示由 Pi 处理。

## 验收

```bash
npm run check
npm test
npm run test:pack
npm run test:host-smoke
npm run test:tui
```

host smoke 使用真实加载器、原生工具和 codemode worker，模型与图片 provider 使用离线替身，不产生模型费用。TUI smoke 使用隔离配置，验证 regular/fullscreen 卡片、展开、鼠标交互、设置刷新、reload 和退出。

可选 FFF 的固定版本、安装和验收见 [FFF 文档](pi-fff.md)；命令与配置见 [README](../README.md)。