Repository navigation
PiForge v0.11.1
PiForge v0.11.1
发布日期:以 tag v0.11.1 的 CI 产出为准(Windows NSIS + ZIP,Linux deb,macOS universal)。
本版是 0.11.0 之上的修 bug + 一个新开关,没有改调用预算与工具默认值:贴图不再卡主线程、
工具卡秒表不再一直跳、事件流断了会明说,另加一个默认关闭的「项目隔离」。
版本口径:
v0.11.0的 tag 打在release/v0.11.0分支上,main的package.json
还停在 0.10.0。本版把v0.11.0合并回来(调用预算、工具开销压缩、codemode 变更全都在),
再做 0.11.1 的四处改动 —— 从 0.11.0 升级你会拿到同样内容再加下面这些,不会退回 0.10.0。
贴图不再卡住输入框
截图贴进输入框时明显停顿,来源是三处都在主线程干的活:
- 缩放:以前把 4K 原图
drawImage进 1568px canvas(几十到上百毫秒同步)。现在用
createImageBitmap(file, { resizeWidth, resizeHeight, resizeQuality: "high" }),解码 + 重采样跑在
工作线程,主线程只搬一张已经缩好的小图(lib/image-attachment.ts)。 - 编码:剪贴板截图都是
image/png、名字也不含 screenshot,以前一律重编码 PNG(1.5MP PNG 编码又要
一两百毫秒)。现在 24×24 抽样探测 alpha,只有真透明才走 PNG,其余 JPEG(0.92);GIF/SVG 原样发送。 - 预览:贴图条的 56px 缩略图以前直接挂原图 object URL(要解码整张 4K)。现在额外生成 160px 缩略图
(previewUrl),大图查看器改用降采样整图的fullUrl;ImageBitmap显式close()。
交互侧:粘贴后先同步出现「处理中」占位,多图串行处理、每张让出一帧;处理中 canSend 为 false,
避免 Enter 把还没转换完的图默默丢掉;移除/发送/卸载时两个 object URL 一并 revoke。
工具卡秒表以 tool_execution_end 为准
工具卡耗时完成即冻结,不再跟着「最新一次调用」继续数(lib/tool-clock.ts + components/Transcript.tsx)。
同时修掉 DevEnvironmentConfig 里同一模式的计时残留。
事件流断了不再假装在思考
以前的失败形态是:连接断了,界面停在「PiForge 正在思考…」,用户不点停止就看不到已经产出的内容。
新增 hooks/agent-session/stream-health.ts(纯函数,可单测)区分三种故障:
reconnecting:连接反复失败,可重试;failed:重连耗尽;stalled:连上了但 30 s 没有任何真实增量(服务端缓冲 / 订阅没接上)。
界面用 components/StreamHealthBanner.tsx 明确告知,而不是让用户猜。
新开关:项目隔离(默认关)
常规设置 → 运行 →「项目隔离」。开启后一个项目只能读写自己目录内的文件,别的项目一律
AccessDenied;关着的时候行为与以前完全一致(所有会话 cwd 都放行)。
- 策略仍在 Host:
agent-host/allowed-roots.ts的authorizePath(target, op, scope?)多一道检查,
隔离开启时路径必须落在「当前项目」(scope优先,其次 Next 上报的 activeScope)内;
拿不到当前项目就 fail-closed,不会退化成「全世界可读」。 - 当前项目来源:
Workbench在活动会话 cwd 变化时 POST/api/files/scope→ Hostfiles.setScope
(contract/methods.ts已声明)。file-index/git/statusline/processes各自把 cwd 当 scope 传。 - 开关有 2 s 缓存,改完几秒内生效。
- 已知边界:开启后 worktree/scratch 目录(在项目外)与
~/.pi/**这类路径会被拒,
需要跑 worktree 协作时先关掉。
验证
| 项 | 命令 | 结果 |
|---|---|---|
| 类型检查 | NODE_OPTIONS=--max-old-space-size=6144 npx tsc --noEmit |
exit 0 |
| 项目隔离 | node --test agent-host/project-isolation.test.ts |
4/4(默认关不受影响 / 跨项目拒 / 无范围 fail-closed / activeScope 兜底) |
| 既有授权与设置 | node --test agent-host/allowed-roots.test.ts lib/desktop-settings.test.ts |
16/16 |
| 图片处理 | node --test lib/image-attachment.test.ts |
8/8(纯函数部分;主线程耗时需真机体验) |
| Lint | npx eslint <改动文件> |
0 error |
未在本版覆盖:打包版贴图端到端耗时没有做自动化采样(只保证主线程不再有全尺寸绘制与 PNG 编码);
三平台产物以 CI 为准。
产物
NSIS + ZIP + latest.yml(含 SHA-256)、Linux deb、macOS universal dmg/zip 由
desktop-packages.yml 在 push v0.11.1 tag 后于 CI 构建,本地不重复构建。
Windows 安装包未代码签名,SmartScreen 会提示「未知发布者」;macOS 包未签名未公证,首次打开需
右键 → 打开(或 xattr -dr com.apple.quarantine);Linux deb 未做 debsig,安装时需 root 授权,
完整性由 latest-linux.yml 的 SHA512 校验。
迁移与升级
- 从 0.11.0 / 0.10.0 升级都无需迁移:会话与设置分别在
~/.pi与%APPDATA%\piforge。 - 新开关默认关;只有主动打开「项目隔离」才会改变文件访问范围。