# SoL-Pi 发布验收记录

更新时间：2026-09-13。

本文是当前 checkout 的证据索引，不是“所有计划完成”的签字。未运行的场景保留为未测，局部合同测试不能替代真实宿主、自然任务、正式安装或发布验收。

## 1. 源码与包门禁

当前 checkout 的基础门禁命令：

```bash
npm ci --ignore-scripts
npm run check
npm audit --audit-level=high
node scripts/check-pi-compat.mjs
npx vitest run tests/all-mechanisms.test.ts
```

当前记录：

| 门禁 | 状态 | 证据边界 |
| --- | --- | --- |
| Node/npm 版本 | 通过 | Node `v22.19.0`、npm `10.9.3` |
| `npm ci --ignore-scripts` | 通过 | 使用 lockfile，不代表正式安装 scope 已完成 |
| `npm run check` | 通过 | 类型、完整测试和 `npm pack --dry-run`；不证明真实模型质量 |
| `npm audit --audit-level=high` | 通过阈值 | 仍有 2 个 moderate Vitest advisory；未越出锁定范围强制升级 |
| `check-pi-compat.mjs` | 通过 | 当前开发依赖解析到 Pi 0.85.1，peer range 为 `0.84.2 || 0.85.1` |
| `all-mechanisms.test.ts` | 通过 | 四机制公共扩展注册合同；不证明真实宿主或自然触发 |

## 2. 宿主与版本证据

| 宿主/场景 | 结果 | 不能据此证明 |
| --- | --- | --- |
| Pi 0.85.1 公共 API/export | 通过 | 未覆盖的宿主接口和第三方扩展组合 |
| Pi 0.85.1 真实启动 smoke | 通过 | `docs/host-smoke-0851.md` 记录 TUI、print、JSON 启动；print/JSON 观察到真实 provider 回复，不是无成本 stub 证据 |
| Pi 0.85.1 确定性 host/stub-provider | 通过 | 固定 `write + then_run` 参数、执行和回执；不等于真实模型主动选择 |
| Pi 0.85.1 HUD PTY/模式定向测试 | 通过 | 3 个文件、7 个测试通过；自动显示、完成、取消、命令、resize 和输出模式边界已测；完整持久恢复仍未完成 |
| Pi 0.84.2 隔离版本矩阵 | 有界通过 | 同一固定 `write + then_run` 夹具通过；不等于完整 0.84.2 宿主发布支持 |
| Pi 0.84.2/0.85.1 packed-install | 通过 | 临时 prefix 安装同一打包产物，1 个测试文件、1 个测试通过；确认没有从源码 checkout 解析 |
| 上游 Pi 修改/内置源码 | 未发现 | 仍需在实际安装目标上复核 source path 和 scope |

详细版本边界见 [compatibility-matrix.md](compatibility-matrix.md) 和 [compatibility.md](compatibility.md)。

## 3. T02 成对真实任务基准

T02 已完成执行器基础设施，不是实际基准结果：

- `benchmarks/workloads.ts` 定义 12 类普通工作负载和四类条件：原生 Pi、上游 SoL-Pi 固定配置、改造版固定配置、改造版 balanced；
- `benchmarks/run.ts` 默认只 dry-run，支持 baseline reset、随机运行顺序、超时、取消、工作区 revision、脱敏日志和 SHA-256；
- `benchmarks/analyze.ts` 计算条件级 p50/p95 和成对差值；缺失 quality/usage/recall 字段保持 `N/A`；
- 本轮没有执行 `--execute`，没有产生真实质量、成本、延迟或自然采纳结论。

未执行原因是当前没有已选定的目标项目、干净 checkout、真实 provider/model 和授权成本范围。后续真实任务必须使用普通提示，不能强制模型调用 `then_run` 来夸大采用率；固定夹具、dry-run 或旧录屏都不能替代该证据。

## 4. HUD-A01 至 HUD-A16

| 编号 | 当前结论 | 证据和边界 |
| --- | --- | --- |
| HUD-A01 | 通过（0.85.1） | 真实 PTY 启动即观察六行命名 HUD，不需要先运行诊断命令 |
| HUD-A02 | 部分通过 | view model、渲染和机制合同覆盖主要状态；真实 PTY 尚未逐项覆盖全部状态 |
| HUD-A03 | 部分通过 | 真实 Action Fusion 覆盖完成更新；验证失败和更多组合仍主要是合同测试 |
| HUD-A04 | 部分通过 | 召回/回退状态和隐私合同通过；真实 Pi 尚未制造全部召回故障 |
| HUD-A05 | 部分通过 | Reducer receipt 核对合同通过；真实 Pi 0.85.1 未驱动远程提取全链路 |
| HUD-A06 | 部分通过 | 真实 PTY 覆盖 Fusion 取消；OCC 取消/续跑主要由隔离状态机测试覆盖 |
| HUD-A07 | 通过（合同） | 未解决故障在无关成功后仍保留 |
| HUD-A08 | 部分通过 | 单位、来源、未知和负值合同通过；自然任务数字口径未完成 |
| HUD-A09 | 部分通过 | generation、分支和迟到回调隔离通过；持久重启后的历史重建未完成 |
| HUD-A10 | 部分通过 | 多列宽纯渲染和真实 resize 通过；20 行、输入保持和全部主题组合未完整验收 |
| HUD-A11 | 通过（合同/0.85.1 基础） | 只清理 `sol-pi-hud`，不调用 `setFooter`；第三方组合矩阵未完成 |
| HUD-A12 | 通过（已测模式） | 0.85.1 print/JSON 无 ANSI，RPC 使用 widget 协议；完整外部组合未完成 |
| HUD-A13 | 通过（合同/真实显示） | `hide` 不关闭优化，`/sol off` 保留证据可读 |
| HUD-A14 | 通过（合同） | render 无 IO/模型调用，有界事件和 timer 清理通过；无独立性能基准报告 |
| HUD-A15 | 通过（合同） | 控制字符和疑似 token/password/authorization 值脱敏 |
| HUD-A16 | 部分通过 | 0.85.1 PTY 覆盖自动显示、完成、取消、resize、稳定退出；持久恢复、输入保持全场景和外部原始记录仍缺 |

HUD 说明见 [hud.md](hud.md)。HUD 通过不代表四机制都执行，也不代表成本或质量收益。

## 5. 正式安装证据

| 安装关口 | 当前状态 | 缺口 |
| --- | --- | --- |
| `sol_pi_root`、分支、提交 | 已在源码 checkout 中可记录 | 每次安装报告仍需记录实际 SHA |
| Pi 版本 | 当前开发/主宿主为 0.85.1 | 0.84.2 只能按隔离矩阵回归 |
| `target_project` | 未选择 | 不能猜测目标项目 |
| install scope | 未选择 | project-local 与 user-wide 不能同时注册同一 checkout |
| `pi list --approve` | 未在选定目标项目完成 | 缺少实际 source path 和 scope 证据 |
| effective `sol-pi.json` | 未捕获正式安装文件 | 缺少四机制全开、provider/model 和 ratio 的实际路径/校验输出 |
| `--require-all-enabled` | 脚本和合同通过 | 只检查配置字段，不检查凭据、backend、真实模型或收益 |
| packed-install 隔离 prefix | 已通过 | 证明打包产物在两个 Pi 版本中可加载，不替代目标项目 scope |
| `pi --offline --approve` 无 prompt 启动 | 0.85.1 源码 smoke 已通过 | 不是选定 scope 的完整安装验收 |
| 上游 Pi 未修改 | 当前 checkout 未 vendoring/修改 | 正式安装后仍需复核 |
| 发布/部署/cutover | 未执行 | 本轮没有外部发布动作 |

Canonical procedure: [agents-install.md](../agents-install.md)。未完成上述关口时，不能把当前结果称为“正式安装成功”或“完整发布通过”。

## 6. 仍开放的发布关口

- Pi 0.84.2 的真实 TUI/RPC/print/JSON、HUD 和 widget/footer 组合；
- 0.85.1 第三方扩展、替代 edit/write、SSH/container backend 和完整 stdout 组合；
- 持久 session 重启、分叉、树导航、模型切换和 HUD 历史恢复；
- H13/H14 原始 PTY 记录归档、输入保持和更广 resize/主题场景；
- 四机制 16 组合的正式独立验收；
- 真实模型普通任务的自然采用、质量、usage、成本和延迟；
- 目标项目、安装 scope、有效配置和回滚后的真实 Pi 复核。

## 发布判定

当前可以称为：**SoL-Pi 源码门禁通过，Pi 0.85.1 HUD 基础和确定性宿主路径已有证据，Pi 0.84.2 保留有界兼容证据。**

当前不能称为：完整发布通过、无损节省、确定成本下降、真实模型自然采用率达标，或所有计划任务完成。发布说明、兼容范围和排错路径必须继续保持这一边界。