Repository navigation
PiForge v0.12.0
PiForge v0.12.0 — 项目归用户管 · 数字与开关说真话
发布日期:2026-11-04
本次把 v0.11.3、v0.11.4 两次未公开发布的版本一并带上线(上一个公开版本是 v0.11.2),
再加上新的开发护栏与完整的 README / 发布说明重写。
亮点
项目归你自己管
左栏项目行悬停 ⋯ 或右键 → 「重命名项目」/「从侧栏移除」。
- 只改左栏显示名与可见性,磁盘目录与会话归属都不动;
- 只写一条本地偏好(
pi-sidebar-projects-v1),不删会话、不碰目录; - 以后用「新建项目」选回同一目录即自动恢复显示;改成空或改回文件夹原名 = 恢复默认。
用量先说真话
- 费用只报真实
usage累计,去掉流式阶段的估算叠加:没收到usage就不显示数字。 - 实时用量按会话隔离,别的会话在跑不再累加到当前这条用量条。
- 千以上缩写:< 1000 精确整数,≥ 1000 一位小数(
2.9K/69.8K),≥ 999,950 进位1.0M。 - 流式事件按帧合并、工具卡秒表 tick 局部化、打字 / 切会话 / 切面板的重渲染剪枝。
注入开关先说默认
- AGENTS.md / CLAUDE.md 注入:可按「跟随全局 / 开 / 关」三态控制,全局 + 项目级都可设,默认开。
- HANDOFF.md 接续注入:项目根或
docs/下的 HANDOFF.md 可注入系统提示词,默认关。 - 压缩摘要:固定中文、更简洁,默认只接管摘要正文。
看门狗看得懂长活
- 停滞阈值默认 20s → 90s,且 90s 就是最低档(运行期传更小的值会被钳住),上限仍 10min。
- 下拉预设改为 90 / 120 / 300 / 600 秒;扫描周期仍 5s、连续 2 次超阈值升级,即默认约 100s
无有效进展才亮红灯。 - 依然零 Token、零 prompt 注入:只在程序层看有没有有效进展。
Pi 核心 1.5.0
- 三个
@earendil-works/pi-*包精确锁定到1.5.0(传递依赖新增pi-schema)。 - 上游工具参数校验改由
pi-schema执行;PiForge 的工具全是普通 JSON Schema,
唯一适配是 MCPclientRegistration类型放宽到"auto" | "dcr" | "cimd"。
开发体验
dev:electron新增前置护栏:out/比源码旧时直接报错并提示npm run build:static,
不再让你对着旧 UI 调半天。PIFORGE_SKIP_STATIC_FRESHNESS=1可降级为警告。- 调用预算从「次数」改成「批次」:简单 1 批 / 普通 2–3 批 / 调研 3–4 批,单批并行 ≤ 12;
到顶先交付可验证结论,剩余待办留给下一轮。
默认行为变化(升级必读)
| 项目 | v0.11.2 | v0.12.0 |
|---|---|---|
| 看门狗停滞阈值 | 默认 20s,最低 5s | 默认 90s,最低 90s(预设 90/120/300/600s) |
| 新会话思考等级 | low | medium(均衡) |
| 点窗口关闭 | 静默隐藏 | 询问「最小化到托盘 / 退出程序」,可记住 |
| 项目名 / 可见性 | 固定 | 可重命名、可从侧栏移除 |
| 用量显示 | 含流式估算 | 只报真实 usage;千以上缩写 |
| 上下文文件注入 | 固定开启 | 可关(默认开),全局 + 项目三态 |
| HANDOFF.md 注入 | 无 | 可选,默认关 |
不变的:三进程边界、零内部端口、文件先授权再 IO、codemode 默认 only、主题与三栏布局。
安装与兼容
- 安装包由 CI 构建:Windows NSIS(含 ZIP)、macOS Universal DMG + ZIP、Linux
.deb,
并对每个平台执行打包后的启动冒烟。 - Windows 安装包未代码签名,可能出现 SmartScreen 提示。
- macOS 安装包未签名、未公证,首次打开可能出现 Gatekeeper 提示。
- Linux
.deb未做 debsig:自动更新通过dpkg -i/apt --allow-unauthenticated安装,
需要 root 授权;下载完整性由latest-linux.yml的 SHA512 校验,漏传该文件则收不到自动更新。 - 自动更新走 electron-updater 既有链路(检查 → 确认 → 下载 → 重启安装),更新源在构建期固定。
- 与终端 CLI 同时运行仍共享
~/.pi/agent;同一 session 两端同时写入仍不受支持。
验证
npm run lint→ 0 error / 8 warning(既有的未使用变量与 hook 依赖告警)。NODE_OPTIONS=--max-old-space-size=6144 npx tsc --noEmit→ 通过。npm test→ 1599 项,1595 通过 / 0 失败 / 4 跳过。- 三平台打包在
.github/workflows/desktop-packages.yml内完成,含smoke-packaged-layout、
smoke-packaged-static、smoke-packaged-standalone三层冒烟。
逐条变更见仓库内 CHANGELOG.md。