v0.3.1

[0.3.1] - 2026-10-24

安装与更新

npm install -g pi-flash@latest   # 首次安装与更新同命令
pi-flash

需要 Node.js ≥ 22.19。也可直接下载 zip 绿色包，解压后双击 pi-flash.exe 即用。仅提供 Windows x64 版本。

修复

• 修正 PF 插件中心错误：0.3.0 中通过插件中心安装的插件无法正常加载，本版修复。

[0.3.1] - 2026-10-24

Install & update

npm install -g pi-flash@latest
pi-flash

Requires Node.js ≥ 22.19. Or download the zip portable build and double-click pi-flash.exe. Windows x64 only.

Fixed

• Fixed PF plugin center error: plugins installed from the plugin center failed to load in 0.3.0.

v0.3.0

[0.3.0] - 2026-10-24

本版关键更新 Pi 1.4核心；
上线「Pi-Flash 插件市场」,并附带第一个「快捷面板」插件；
另修一批稳定性与 UI 问题。

安装与更新

npm install -g pi-flash@latest   # 首次安装与更新同命令
pi-flash

需要 Node.js ≥ 22.19。
也可直接下载 zip 绿色包，解压后双击 pi-flash.exe 即用，无需 Node。
仅提供 Windows x64 版本。

新增

• Pi-Flash 插件市场（090-4）：顶栏菜单新增「Pi-Flash 插件」页——浏览与安装 Pi-Flash 插件；【所有插件 | 已安装】页签切换，已安装页支持详情、卸载确认、行内启停开关（停用后状态栏/文件树/分发立即隐身）。(e3d62a2, 1454b4d, d6293d3, 9545e84, 1f73360, e1311a5, ff98d1a)
• 新增「快捷面板」功能

修复

• PF icon 任务栏固定随更新失效：AUMID + 开始菜单稳定入口 + 死链自愈。(efa5394)
• 保存 API Key 后模型列表刷不出的静默死角：空目录占位区 + 常驻获取按钮 + 探查 Failed 态。(7a7b2dd)
• 会话内代码块两处：切换主题后滞留旧语法高亮；补 1px 代码框。(be6b17b, ad94775)
• 状态栏 tab hover 在 light 主题下激活卡变暗。(936c3b7)
• 左面板两处滚动条联动串扰：A 面板拖滚动条 B 面板跟着走。(4ee6512)
• 「设置→扩展」子菜单与主菜单间隙漂移（长文案撑宽主卡时）。(72fe285)

改进

• 内置 pi 1.3.0 → 1.4.0。(7a838ff)
• 分隔线统一规范：常驻 1px、hover/拖拽 4px 强调色覆盖线（内容区左缘 / 左 dock 分区 / 插件面板三处共用同一条实现），感应厚度定稿 12px。(c451b62, e58755c, c8743ec)

[0.3.0] - 2026-10-24

This release updates the bundled pi core to 1.4;
ships the "Pi-Flash Plugins" market along with the first "Quick Panel" plugin;
plus a batch of stability and UI fixes.

Install & Update

npm install -g pi-flash@latest   # same command for first install and updates
pi-flash

Requires Node.js ≥ 22.19.
You can also download the zip, unzip it and double-click pi-flash.exe — no Node needed.
Windows x64 only.

New

• Pi-Flash plugin market (090-4): a new "Pi-Flash Plugins" page in the top-bar menu — browse and install Pi-Flash plugins; "All plugins | Installed" tab switch; the Installed tab shows details, uninstall confirmation and an inline enable/disable switch (a disabled plugin disappears from the status bar / file tree / distribution immediately). (e3d62a2, 1454b4d, d6293d3, 9545e84, 1f73360, e1311a5, ff98d1a)
• New "Quick Panel" feature

Bug fixes

• The PF icon pinned to the taskbar broke after updates: stable AUMID + Start Menu entry with dead-link self-healing. (efa5394)
• Model list silently not refreshing after saving an API key: empty-catalog placeholder + a persistent fetch button + a Failed probe state. (7a7b2dd)
• Two code-block fixes in sessions: stale syntax highlighting after switching themes; add the missing 1px code frame. (be6b17b, ad94775)
• Status-bar tab hover darkened the active card in light theme. (936c3b7)
• Scrollbar cross-talk between the two left-panel areas: dragging one scrollbar moved the other. (4ee6512)
• Gap drift between the "Settings → Extensions" submenu and its parent menu (when long labels widen the card). (72fe285)

Improvements

• Bundled pi 1.3.0 → 1.4.0. (7a838ff)
• Divider specification unified: 1px resting line, 4px accent hover/drag overlay line (one shared implementation behind the content-area left edge / left dock split / plugin panel), hover hit thickness settled at 12px. (c451b62, e58755c, c8743ec)

v0.2.3

[0.2.3] - 2026-10-22

本版上线「Pi 扩展市场」：在 PF 内直接浏览、搜索、安装 pi 的扩展；
另修复 markdown 表格窄列折行，输入面板 MCP 胶囊改版。

安装与更新

npm install -g pi-flash@latest   # 首次安装与更新同命令
pi-flash

需要 Node.js ≥ 22.19。
也可直接下载 zip 绿色包，解压后双击 pi-flash.exe 即用，无需 Node。
仅提供 Windows x64 版本。

新增

• Pi 扩展市场（040-2）：移植 pi.dev 的 Package Catalog 页面——浏览与搜索 npm 上的 pi 扩展，按最多下载 / 最近更新 / 名称排序，分页浏览；入口在顶栏「菜单」。(768da6e, 5f3f634, c16607a)

修复

• 会话里的 markdown 表格窄列折行：列宽纯比例分配、没有最小宽度，宽列会把窄列挤到把 002068 这样的长数字断成 00206 / 8；表格列加像素地板（最小宽度），并留安全系数吸收排版与绘制的步进差。(7c4f13e, 53b3e65)

改进

• 输入面板 MCP 胶囊改版：由「MCP」字样改为服务图标 + 已启用数量（如 [2]），与扩展按钮同款；数量为 0 时也常驻显示。(52ccd42)

[0.2.3] - 2026-10-22

This release ships the Pi Extension Market: browse, search and install pi extensions without leaving PF;
it also fixes markdown table narrow-column wrapping and revamps the input panel's MCP capsule.

Install & Update

npm install -g pi-flash@latest   # same command for first install and updates
pi-flash

Requires Node.js ≥ 22.19.
You can also download the zip, unzip it and double-click pi-flash.exe — no Node needed.
Windows x64 only.

New

• Pi Extension Market (040-2): a port of pi.dev's Package Catalog page — browse and search pi extensions on npm, sort by most downloads / recently updated / name, with paged browsing; the entry lives in the top-bar "Menu". (768da6e, 5f3f634, c16607a)

Bug fixes

• Markdown tables in sessions could wrap long tokens in narrow columns: column widths were purely proportional with no minimum, so a wide column squeezed narrow ones until a number like 002068 broke into 00206 / 8; table columns now have a pixel floor (minimum width) plus a safety margin absorbing layout-vs-paint stepping differences. (7c4f13e, 53b3e65)

Improvements

• Input-panel MCP capsule revamped: the "MCP" label is replaced by a server icon + enabled count (e.g. [2]), matching the extensions button; it stays visible even when the count is 0. (52ccd42)

v0.2.2

[0.2.2] - 2026-10-21

这个版本我自己很喜欢 ——
1、增加了文件树可运行文件的运行功能，现在我可以通过文件右键菜单运行bat ps1 py js等脚本了，超级方便，哈哈哈，这下pf真的成了我的项目管理器了
2、大幅优化了搜索功能

安装与更新

npm install -g pi-flash@latest   # 首次安装与更新同命令
pi-flash

需要 Node.js ≥ 22.19。
也可直接下载 zip 绿色包，解压后双击 pi-flash.exe 即用，无需 Node。
仅提供 Windows x64 版本。

新增

• 项目搜索重做（083）：文件名 + 全文内容搜索，无索引低延迟；结果面板照 Zed 复刻：文件头圆角卡片、组头、行号右对齐动态列宽、命中高亮底色；空态 landing page、打开即聚焦、补滚动条；旧搜索弹窗退役。(bb00f49, ca86852, f54db1d, afd6179, 6fcbe25, 37b8d89, 3c1beb7, 1cc44db, e9f3474, 7d4f788)
• 会话查询改版（013）：与文件搜索同版式的查询面板（只查询、无替换）；升级为全量跨项目搜索——所有项目的会话都能搜到，结果组头显示所属项目与会话名（按会话归并、副标题为绝对时间）。(66c3832, 6c3fdfb, e68722c, fec5ffd, d60635e)
• 文件树右键【执行】（021）：脚本文件一键在 PF 内置终端新标签页执行；扩展名配方表 exe/bat/ps1/js/py/sh，py 走「项目 venv → py.exe → PATH」探测链（跳过 WindowsApps 假别名）、sh 找 bash；菜单项显示解释器名，解析失败置灰并给出原因。(2a8d285)
• 模型选择菜单四条：菜单加宽 40px（模型名与星标不再贴边）；内容超高时右缘常显滚动条；↑/↓ 选中行自动滚进可视区；标星默认模型置顶。(295d149)
• 文件树「搜索文件」tooltip 附键位 chip（Ctrl+L）。(4d8de11)

修复

• 会话改名后侧栏标题「改回去」：改名条目被 1MB 尾窗扫描窗口扫丢（15MB 大会话必中招，真机 8 个改名会话 4 个中招）——名字扫描改搭消息计数流式扫描便车，覆盖整个会话文件，与 pi 自身口径一致。(d3cbc89)
• 编辑器：有终端/搜索 tab 留存时，关掉最后一个文档 tab 直接回会话页，不再落进空白落单提示页。(d2c2258)
• 会话「滚到底」悬浮按钮去虚影，加大一号（32→36px）更易点中。(9124b14)

改进

• 「部分操作隐藏」开关覆盖面扩大：psp 控制栏与文件树操作栏的两颗最大化钮也纳入悬停显影。(e3831f7)
• 会话面板搜索入口降级为小图标并入右侧按钮组，同样受自动隐藏控制。(1b95258, d051780)
• 主题「厨房笔记」更名为「秋叶」。(af81ffc)

[0.2.2] - 2026-10-21

I'm quite fond of this release myself —

1. Added a Run action for runnable files in the file tree: bat/ps1/py/js scripts can now be launched right from the file context menu. Super handy, haha — PF has truly become my project manager.
2. Search has been greatly improved.

Install & Update

npm install -g pi-flash@latest   # same command for first install and updates
pi-flash

Requires Node.js ≥ 22.19.
You can also download the zip, unzip it and double-click pi-flash.exe — no Node needed.
Windows x64 only.

New

• Project search overhaul (083): file name + full-text content search, low-latency with no index. The results panel mirrors Zed: rounded file-header cards, group headers, right-aligned line numbers with dynamic column width, match highlight background; landing page for the empty state, focus on open, scrollbar added; the old search dialog is retired. (bb00f49, ca86852, f54db1d, afd6179, 6fcbe25, 37b8d89, 3c1beb7, 1cc44db, e9f3474, 7d4f788)
• Session search rebuild (013): a query panel sharing the file-search layout (search only, no replace); upgraded to full cross-project search — sessions from all projects are searchable, with results grouped per session showing the owning project and session name (absolute-time subtitles). (66c3832, 6c3fdfb, e68722c, fec5ffd, d60635e)
• File-tree context-menu Run (021): run script files in a new built-in terminal tab with one click. An extension recipe table covers exe/bat/ps1/js/py/sh; Python resolves via project venv → py.exe → PATH (skipping WindowsApps fake aliases), sh finds bash; menu items show the interpreter name and are greyed out with a reason when resolution fails. (2a8d285)
• Model picker, four fixes: menu widened 40px (model names no longer crowd the star); scrollbar appears when content overflows; ↑/↓ selection auto-scrolls into view; starred default model pinned to top. (295d149)
• The file-tree "search files" tooltip now shows a keybinding chip (Ctrl+L). (4d8de11)

Bug fixes

• Renamed sessions reverted to their old sidebar title: rename entries were dropped by the 1MB tail-window scan (15MB sessions always hit; 4 of 8 renamed sessions on real machines). Name scanning now rides the streaming message-count scan, covering the entire session file, matching pi's own semantics. (d3cbc89)
• Editor: with terminal/search tabs still open, closing the last document tab now returns to the chat page instead of a blank placeholder. (d2c2258)
• Chat "scroll to bottom" floating button: ghost shadow removed and enlarged (32→36px) for easier clicking. (9124b14)

Improvements

• The "auto-hide actions" toggle now also covers the two maximize buttons in the panel control bar and file-tree action bar. (e3831f7)
• Session panel search entry demoted to a small icon merged into the right-side button group, subject to auto-hide. (1b95258, d051780)
• Theme "厨房笔记" (Kitchen Notes) renamed to "秋叶" (Autumn Leaves). (af81ffc)

v0.2.1

[0.2.1] - 2026-10-20

本版聚焦各种崩溃bug性能优化：
中文 markdown 编辑「进程瞬间消失」崩溃修死；
terminal录入exit导致崩溃；
会话发送排队体系上线：运行中发言「排队 / 插话」两档可配；
内存占用优化；
超大文件目录打开卡顿修复。

安装与更新

npm install -g pi-flash@latest   # 首次安装与更新同命令
pi-flash

需要 Node.js ≥ 22.19。
也可直接下载 zip 绿色包，解压后双击 pi-flash.exe 即用，无需 Node。
仅提供 Windows x64 版本。

新增

• 会话发送排队体系：Agent 运行中再发消息不再「总是插队、冲进当前任务」——默认排队档进入本地队列，本轮结束自动发出；排队卡挂在输入面板上方，支持拖拽重排、铅笔撤回编辑、「立即」打断、垃圾桶删除；缓冲栏已有排队消息时禁止继续入队；停止按钮同步撤回排队消息；ESC 叫停排队；微信远程发送走同一漏斗。设置「其他」页新增「运行中发送方式」两档：排队（默认）/ 插话。(aa5c4fc, 551fa2b, edc23ce, 8f6a1cf, 14e6059, 3367977)
• 运行中「插话 / 立即」改打断语义：立即中止当前回复并重新下达指令，被打断的回复保留半截内容，新指令带着上文继续。(edc23ce)
• 会话 / 文件树操作栏不常用图标自动隐藏，悬停操作栏才显影；设置「界面」页新增「部分操作隐藏」开关（默认开，关掉恒显、即切即生效）。(98cbd72, 4bf8673)

修复

• 中文 markdown 编辑进程瞬间消失：编辑中文文章时窗口无报错直接消失（真机连崩三例，自动保存救回内容）——vendor 编辑器层 tree-sitter 高亮回调裸切片，脏偏移落在汉字（3 字节）中间时 panic 无法跨界 unwind 直接 abort；根因是 IME 组合更新（替换已标记文本）时选区基准错加旧替换区间末尾。回调加字符边界守卫 + 选区基准改正。(6e9af0e)
• 运行中打断一批：思考中插话把整屏消息拽到屏幕下半部分（打断只退役跟尾期锚点）；发言钉顶改按「是否真打断」决定；回显不补刀；stream_cut 残包并回旧回复。(92ff894, 0343a22)
• 思考强度换挡后胶囊仍显示旧档（真机怎么换都停在 high）。(3ae6f31)
• 终端两处：终端区变矮瞬间按旧行列数越界绘制崩溃；终端里裸敲 exit 回车不再连锁退出上级 shell，改为关闭当前终端标签页。(faf8987, c4d0aa1)
• 图片气泡不再显示 [Image: original …] 坐标标注。(5947554)
• 以子目录打开的仓库文件树展开卡死：git status / numstat 路径钉定仓库根并重定基。(0eefea6)
• 上下文用量弹窗加宽 40px（420 → 460），英文界面底部三钮不再溢出。(2a73342)
• 扩展详情状态行不再打印更新检测的原始错误串；「扩展」设置页导航项恢复（市场页上线时被误藏）。(bd21660, 6d26f83)
• 空闲会话发送不再误入排队缓冲；会话列表「回到最新」按钮在跟尾期不再失灵。(b2a56a3, 6a1dfb1)

改进

• 内存占用优化：解码位图缓存延迟驱逐（图片多的大会话内存只涨不降的根治）；空闲回收连 runtime 实体一起退役。(1f66410, b655602)
• 模型页与「添加 Provider」相关文案补齐繁中 / 英文翻译。(2042423, 271b653, 2cb104a)
• 快捷键页版式精简：去掉行内注释说明，只留标题与键帽。(af86124, 65fe2da)
• 会话内容宽度设置去掉「复位」按钮。(d64e64e)

[0.2.1] - 2026-10-20

This release focuses on crash fixes and performance:
the Chinese markdown editor "process vanishes instantly" crash is fixed;
crashes caused by typing exit in the terminal are gone;
the session send-queue system ships — "Queue / Steer" modes configurable while the agent runs;
memory usage optimizations;
and lag when opening very large file directories is fixed.

Install & Update

npm install -g pi-flash@latest   # same command for first install and updates
pi-flash

Requires Node.js ≥ 22.19.
A zip portable build is also available: download, unzip, double-click pi-flash.exe — no Node needed.
Windows x64 only.

New

• Session send-queue: messages sent while the agent is running no longer "always cut in line" — by default they enter a local queue and go out automatically when the current turn ends; the queue card sits above the input panel and supports drag-to-reorder, pencil recall-to-edit, "Send now" interrupt, and trash delete; sending is blocked while the buffer already holds a queued message; the stop button recalls queued messages too; ESC cancels the queue; WeChat remote sends go through the same funnel. Settings → Other adds "Send behavior while running" with two modes: Queue (default) / Steer. (aa5c4fc, 551fa2b, edc23ce, 8f6a1cf, 14e6059, 3367977)
• "Steer / Send now" now means interrupt: the current reply is aborted immediately and re-issued as a new instruction; the half-finished reply stays on screen and the new message continues with that context. (edc23ce)
• Infrequently used icons in the session / file-tree action bars auto-hide and reveal on hover; Settings → Interface adds an "Auto-hide icons" switch (on by default; turn it off to keep icons always visible, effective immediately). (98cbd72, 4bf8673)

Bug fixes

• Chinese markdown editing killed the process instantly: the window vanished with no error while editing Chinese articles (three real-machine crashes in a row; autosave saved the content) — the vendored editor's tree-sitter highlight callback sliced raw bytes, and a dirty offset landing inside a 3-byte Han character panicked across an extern "C" boundary (cannot unwind → abort); the root cause was the IME composition update computing its selection base from the wrong end of the replaced range. Fixed with a char-boundary guard in the callback plus the corrected selection base. (6e9af0e)
• Interrupts while running: an interjection during thinking dragged the whole message screen into the lower half (interrupts now only retire the tail-follow anchor); pinned-to-top is now decided by "was it a real interrupt"; echoes no longer double-post; stray stream_cut fragments merge back into the old reply. (92ff894, 0343a22)
• The thinking-level capsule kept showing the old level after switching (on real machines it always showed high). (3ae6f31)
• Terminal: painting right after the terminal area shrank read stale row counts and crashed; a bare exit + Enter no longer kills the parent shell — it now closes the terminal tab. (faf8987, c4d0aa1)
• Image bubbles no longer show the [Image: original …] coordinate caption. (5947554)
• File tree froze when expanding a repo opened via a subdirectory: git status / numstat paths are now anchored to the repo root. (0eefea6)
• The context-usage popup is 40px wider (420 → 460), so the bottom three buttons no longer overflow in English. (2a73342)
• Extension detail status no longer prints raw update-check error strings; the "Extensions" settings nav item is back (it was hidden when the market page shipped). (bd21660, 6d26f83)
• Idle sends no longer wrongly enter the send queue; the "back to latest" button in the chat list no longer fails while tail-following. (b2a56a3, 6a1dfb1)

Improvements

• Memory usage: decoded-bitmap cache entries are now evicted lazily (root fix for image-heavy long sessions where memory only grew); idle reclamation now retires runtime entities too. (1f66410, b655602)
• Completed Traditional Chinese / English translations for the model page and "Add Provider" texts. (2042423, 271b653, 2cb104a)
• Shortcuts page simplified: inline explanatory notes removed, leaving titles and keycaps. (af86124, 65fe2da)
• Removed the "Reset" button from the session content width setting. (d64e64e)

v0.2.0

本版聚焦：性能大版本——巨大会话卡顿根治（688 条消息会话每帧成本 O(轮)→O(视口)、composer 打字不再每键整窗重绘、发送即冻死修复）；会话置顶、Pi 扩展更新检测、会话自动清理三大新特性；topbar 自由 tab 拖拽（Zed 同款）；RPC 中途停止不再静默。

安装与更新

npm install -g pi-flash@latest   # 首次安装与更新同命令
pi-flash

需要 Node.js ≥ 22.19。
也可直接下载 zip 绿色包，解压后双击 pi-flash.exe 即用，无需 Node。
仅提供 Windows x64 版本。

0.1.11 及以后可以直接用应用内更新（设置 → 检查更新）。仍在 0.1.10 及更早的必须走上方 npm 命令（旧版应用内 updater 是坏的，装不上新版）。

新增

• 会话置顶（020）：会话行悬停出 pin 槽、右键卡 pin 钮，置顶组居列表首位（folder-bookmark 组头行）；原项目组按 pin 清单过滤，不重复显示。(c1f811f, d68112d, 42eaaf9, f652ad0)
• Pi 扩展更新检测与更新（082）：扩展管理页检测可用更新、一键全部更新；详情卡【更新】按钮仅在有可用更新时显示。(4fe2aeb, f3e860c, 02bb266)
• 会话自动清理（052）：设置「其他」页新增天数步进（0/5/…/100，默认 0 = 关闭），后台任务把超期会话移入回收站。(609924e, d5451eb, 15799c7)
• 会话内容宽度可调：消息列 + composer 胶囊单一内容列宽（封顶 1200 / 步进 20）。(041bdee, a258cd0)
• topbar 自由 tab 拖拽换位（Zed pane parity）：文件 tab 自由拖动重排（会话 tab 固定段禁拖）；标签条跟随激活 tab 滚动；标签区伸展至最小化钮左侧；拖拽幽灵带文件类型图标、抓取手型光标。(4b6596a, 46497cc, ac3b2ef, b2a5996, 801db0a, c5a394d)
• panic 落盘（diag）：崩溃后有据可查。(e06c777)
• 全部 UI 文案迁入多语言表：26 文件硬编码文案清零。(1702292)

修复

• 巨大会话卡顿根治：688 条消息会话每帧渲染成本 O(轮) → O(视口)；composer 打字去掉每键 O(n) 与每帧重复计算、不再整窗重绘，输入崩溃一并修复；发送即冻死（主线程 O(会话大小) 扫描）修复；输入历史上限兜底。(89ac76e, 3b326ec, e06c777, 3540725)
• RPC：会话中途停止不再静默——EOF 补全轮终语义 + 会话事件全量解析。(775150e)
• 单一语义回归：当前项目 ≡ 活跃会话的项目；撤销 send 门兜底判断。(ff29615, 12544df)
• 注册项目零会话不再建空组——psp 不显示「无会话」占位项目。(2d1a5c0)
• tab 拖拽「黏连」根因 = tab 元素 id 不唯一（zed pane.rs 移植）。(258185a, bf58439)
• 快捷键页还原居中索引版式（2 组 9 条）、页签挪至「关于」之后；新会话页通知带贴底定位 + 分隔线 + 卡片化、扩展更新卡片 0 宽变形等验收返工一批。(f85eb3a, 928763d, b8f962b, 3eef399, 4a3ef19, 294a712)
• 窗口最小高度放宽到 600（还原尺寸与最小尺寸拆成四常量）。(1cfbd1b)

This release focuses on: performance — the giant-session lag is fixed at its root (a 688-message session drops from O(turns) to O(viewport) per frame, composer typing no longer repaints the whole window per keystroke, and the send freeze is gone); three major features — session pinning, Pi extension update detection, and session auto-cleanup; free tab drag & drop on the topbar (Zed-style); and mid-session RPC stops are no longer silent.

Install & Update

npm install -g pi-flash@latest   # same command for first install and updates
pi-flash

Requires Node.js ≥ 22.19.
Or download the zip portable build, extract and double-click pi-flash.exe — no Node needed.
Windows x64 only.

On 0.1.11 or later, the in-app updater works (Settings → Check for updates). If you are still on 0.1.10 or earlier, you must use the npm command above (the old in-app updater is broken and cannot install new builds).

New

• Session pinning (020): hover a session row for the pin slot, or use the pin button on the right-click card; pinned sessions form a group at the top (folder-bookmark header); the original project group filters by the pin list so entries never show twice. (c1f811f, d68112d, 42eaaf9, f652ad0)
• Pi extension update detection & updates (082): the extensions page detects available updates and updates all in one click; the detail card's [Update] button only appears when an update exists. (4fe2aeb, f3e860c, 02bb266)
• Session auto-cleanup (052): a day-based stepper in Settings → Other (0/5/…/100, default 0 = off); a background task moves expired sessions to the recycle bin. (609924e, d5451eb, 15799c7)
• Adjustable session content width: one content column for the message list and the composer capsule (capped at 1200 / step 20). (041bdee, a258cd0)
• Free tab drag & drop on the topbar (Zed pane parity): file tabs reorder freely (the pinned session-tab segment stays fixed); the tab strip follows the active tab; the tab area stretches to 20px left of the minimize button; drag ghosts carry file-type icons and grab-hand cursors. (4b6596a, 46497cc, ac3b2ef, b2a5996, 801db0a, c5a394d)
• Panic logs written to disk (diag): crashes leave evidence behind. (e06c777)
• All UI strings moved into the i18n tables: zero hardcoded strings across 26 files. (1702292)

Fixes

• Giant-session lag fixed at the root: a 688-message session drops from O(turns) to O(viewport) per frame; composer typing removes the per-keystroke O(n) passes and redundant per-frame work and no longer repaints the whole window, with the input crash fixed; the send freeze (two O(session-size) scans on the main thread) is gone; input history capped. (89ac76e, 3b326ec, e06c777, 3540725)
• RPC: stopping a session mid-run is no longer silent — EOF now completes turn-final semantics and session events are parsed in full. (775150e)
• Single-semantics regression: current project ≡ the active session's project; removed a vestigial send-gate check. (ff29615, 12544df)
• Registered projects with zero sessions no longer create empty groups — no "no sessions" placeholder projects in the panel. (2d1a5c0)
• Root cause of "sticky" tab drags: non-unique tab element ids (ported from zed pane.rs). (258185a, bf58439)
• Shortcuts page restored to the centered index layout (2 groups, 9 entries) with its tab moved after "About"; a batch of acceptance rework on the new-session page (notification strip bottom-anchoring, divider, card layout, zero-width extension card deformation, etc.). (f85eb3a, 928763d, b8f962b, 3eef399, 4a3ef19, 294a712)
• Minimum window height relaxed to 600 (restore size and minimum size split into four constants). (1cfbd1b)

v0.1.13

本版聚焦：启动落点体系重做——启动定位「最近活动项目」、应用不再捏造项目态；0.1.12 真机更新实测暴露的「更新交接 cwd 污染项目注册表」随之修死；新增「灰蓝 latte」主题；切项目崩溃与排队重复发送两处硬伤修复；文件树/dock 状态跨重启保存。

安装与更新

npm install -g pi-flash@latest   # 首次安装与更新同命令
pi-flash

需要 Node.js ≥ 22.19。
也可直接下载 zip 绿色包，解压后双击 pi-flash.exe 即用，无需 Node。
仅提供 Windows x64 版本。

0.1.11 及以后可以直接用应用内更新（设置 → 检查更新）。仍在 0.1.10 及更早的必须走上方 npm 命令（旧版应用内 updater 是坏的，装不上新版）。

新增

• 新增「灰蓝 latte」主题（Catppuccin Latte 移植，accent 对齐 Obsidian 雾紫罗兰 #5F5FAB）；删除 nord-light；未知主题名自动回退注册表第一个，不再白屏。(479b0d2, 606359f, e3916de)
• 文件树状态跨重启保存：展开/折叠记忆，Pin 收藏夹视图按项目恢复。(23a1f8a)
• dock 最大化态跨重启保存：文件树/会话列表最大化后关窗再开仍记住。(038d5dc)
• 设置组头总开关补「部分选中」中间态（技能/扩展/MCP）。(f1ed223)

修复

• 切项目崩进程：Pin 收藏夹跟着换项目 + gitignore 匹配不再炸非前缀路径。(77aa69e)
• 排队发送重复发送根除：改走 prompt+streamingBehavior，滞留队列不再重放。(37919a1)
• 启动落点体系重做：启动定位「最近活动项目」而非全局最后会话（cwd 回归会话属性，应用永不捏造项目）；0.1.12 真机更新实测发现的「每次启动都凭空落进 payload 目录」根因——更新交接继承的 cwd 污染项目注册表——随之修死。(8cb95b4, 81aff88, 0be0ae6, f02bbf8, 452c91a)
• 技能页两个开关成摆设；SKILL.md frontmatter 每次写盘多长一行。(5944907)
• 技能路径不再带 Windows \\?\ verbatim 前缀。(8aff9a2)
• 导航面板两处：飞出面板下缘与输入面板底线对齐（拖到窗口底不再贴死）；飞出卡片区与总结栏背景色对齐功能面板。(516371c, 3a03336)

This release focuses on: a reworked startup targeting — the app opens on the "most recently active project" and no longer fabricates project state; the "update handover pollutes the project registry with the payload directory" issue exposed by real-machine testing of 0.1.12 is fixed for good; a new "latte" theme; two hard bugs fixed (project-switch crash and duplicate queued sends); file-tree and dock state now survive restarts.

Install & Update

npm install -g pi-flash@latest   # same command for first install and updates
pi-flash

Requires Node.js ≥ 22.19.
Or download the zip portable build, extract and double-click pi-flash.exe — no Node needed.
Windows x64 only.

On 0.1.11 or later, the in-app updater works (Settings → Check for updates). If you are still on 0.1.10 or earlier, you must use the npm command above (the old in-app updater is broken and cannot install new builds).

New

• New "latte" theme (Catppuccin Latte port, accent aligned to the Obsidian misty-violet #5F5FAB); nord-light removed; unknown theme names now fall back to the first registry theme instead of a blank screen. (479b0d2, 606359f, e3916de)
• File-tree state survives restarts: expand/collapse memory, Pin favorites view restored per project. (23a1f8a)
• Dock maximized state survives restarts: a maximized file tree / session list stays maximized after reopening. (038d5dc)
• Settings group-header master toggles get a "partially selected" intermediate state (skills / extensions / MCP). (f1ed223)

Fixes

• Project-switch crash: Pin favorites follow the project switch, and gitignore matching no longer panics on non-prefix paths. (77aa69e)
• Duplicate queued sends eradicated: sends now go through prompt+streamingBehavior, so a stuck queue entry is never replayed. (37919a1)
• Startup targeting rework: the app opens on the "most recently active project" instead of the globally last session (cwd is a session attribute; the app never fabricates projects); root cause of "every startup lands in the payload directory" found during real-machine testing of 0.1.12 — the cwd inherited by the update handover polluted the project registry — is fixed. (8cb95b4, 81aff88, 0be0ae6, f02bbf8, 452c91a)
• Two dead switches on the skills page; SKILL.md frontmatter no longer grows an extra line on every write. (5944907)
• Skill paths no longer carry the Windows \\?\ verbatim prefix. (8aff9a2)
• Navigation panel: flyout panel bottom edge aligns with the input panel baseline (no longer sticks to the window bottom when dragged down); flyout card area and summary bar background now match the function panel. (516371c, 3a03336)

v0.1.12

本版聚焦：PF 项目注册表（打开过的项目即注册，零会话项目也常驻两面板）；082 快捷键三期四期修复（Ctrl+←/→ 连续切换、终端不再吞键、窗口控制钮全哑修复）；会话气泡滚轮与文件树交互修复一批；Windows 启动不再凭空弹终端窗口。

安装与更新

npm install -g pi-flash@latest   # 首次安装与更新同命令
pi-flash

需要 Node.js ≥ 22.19。
也可直接下载 zip 绿色包，解压后双击 pi-flash.exe 即用，无需 Node。
仅提供 Windows x64 版本。

0.1.11 及以后可以直接用应用内更新（设置 → 检查更新）：新的「版本化目录解压 + 启动交接」链路自 0.1.11 接管，本版即为该链路的第一个真机升级目标。仍在 0.1.10 及更早的必须走上方 npm 命令（旧版应用内 updater 是坏的，装不上新版）。

新增

• PF 项目注册表：打开过的项目自动注册（~/.pi-flash/projects.json），零会话项目也出现在功能栏项目面板与会话目录；项目不再依赖「有过会话」才可见。(ee82d0c)

修复

• 快捷键（082 三/四期）：Ctrl+←/→ 改 Zed Pane 模式——祖先上下文锚定 + 可聚焦锚点，连续切换不再卡死；切标签改为壳层专属，终端不再吞键，Markdown 预览键盘可用；窗口控制三钮（最小化/最大化/关闭）全哑修复（track_focus 锚点下移 content-main）。(8af1b26, 16fdfba, 47cbfcd)
• 会话滚轮一批：超高用户气泡「滚不动、只能整屏滚」（gpui List 滚轮注册时机）；气泡内滚到边界不再同帧穿透连动会话列表。(65d03ec, a238cb3)
• 文件树一批：行内新建/改名光标不闪（首发聚焦改走 InputState::focus）；新建条目与提交后的新行自动滚进视口。(5dbb6e8, 8e92ec1)
• Windows 启动不再凭空弹终端窗口。(3be6deb)
• tools 胶囊菜单改右对齐锚定，右缘贴按钮右缘。(f96ca70)

改进

• 文件树删除大目录转后台线程（trash 下沉 background_spawn），主线程不再卡死。(ff89733)
• 设置-界面移除「Markdown 所见即所得」开关项。(2732556)

This release focuses on: the PF project registry (opened projects are registered automatically, zero-session projects show up in both panels); keyboard shortcuts fixes round 3 & 4 (consecutive Ctrl+←/→ switching, terminal no longer swallows the keys, window control buttons fixed); a batch of session bubble scroll and file-tree interaction fixes; no more stray terminal window on Windows startup.

Install & Update

npm install -g pi-flash@latest   # same command for first install and updates
pi-flash

Requires Node.js ≥ 22.19.
Or download the zip portable build, extract and double-click pi-flash.exe — no Node needed.
Windows x64 only.

On 0.1.11 or later, the in-app updater works (Settings → Check for updates): the new "versioned directory extraction + startup handover" chain took over in 0.1.11, and this release is its first real-machine upgrade target. If you are still on 0.1.10 or earlier, you must use the npm command above (the old in-app updater is broken and cannot install new builds).

New

• PF project registry: opened projects are registered automatically (~/.pi-flash/projects.json); zero-session projects now appear in the function-panel project list and the session directory — projects no longer depend on having sessions to be visible. (ee82d0c)

Fixes

• Shortcuts (082 rounds 3/4): Ctrl+←/→ reworked to the Zed Pane model — ancestor-context anchoring + focusable anchor, so consecutive switching no longer stalls; tab switching is now shell-exclusive (the terminal no longer swallows the keys, Markdown preview is keyboard-reachable); window control buttons (minimize/maximize/close) fixed (track_focus anchor moved down to content-main). (8af1b26, 16fdfba, 47cbfcd)
• Session scrolling batch: very tall user bubbles were unscrollable (gpui List wheel registration timing); scrolling inside a bubble to its edge no longer bleeds through and moves the session list in the same frame. (65d03ec, a238cb3)
• File tree batch: inline create/rename caret no longer blinks off (initial focus now goes through InputState::focus); newly created entries and the committed row scroll into view. (5dbb6e8, 8e92ec1)
• Windows startup no longer pops a stray terminal window. (3be6deb)
• Tools capsule menu now right-anchored, right edge flush with the button. (f96ca70)

Improvements

• Deleting large directories in the file tree moved to a background thread (trash on background_spawn) — no more main-thread stalls. (ff89733)
• Settings → Interface: removed the "Markdown WYSIWYG" toggle. (2732556)

v0.1.11

本版聚焦：应用内更新落位改版——版本化载荷目录 + 启动交接（删掉 powershell swap），0.1.10 无限重下死循环根因修死；新增「厨房笔记」「松林」两套主题；会话秒开与切项目性能优化；快捷键页 Ctrl+L 全局搜文件。

安装与更新

npm install -g pi-flash@latest   # 首次安装与更新同命令
pi-flash

需要 Node.js ≥ 22.19。
也可直接下载 zip 绿色包，解压后双击 pi-flash.exe 即用，无需 Node。
仅提供 Windows x64 版本。

0.1.10 及更早版本的应用内更新是坏的，请务必走上方 npm 命令更新（或 zip 重下）：旧版自带的 updater 跑的是有缺陷的整目录 swap 方案，应用内「检查更新」装不上新版（0.1.10 实测无限重下死循环）；0.1.11 起才由新的「版本化目录解压 + 启动交接」链路接管，之后应用内更新恢复可用。zip 绿色包用户同样请 npm 重装或 zip 重下，勿依赖旧版应用内更新。

新增

• 应用内更新落位改版：下载后解压进版本化载荷目录，启动时交接自证（目录名版本必须等于进程版本，防 spawn 风暴）后拉起新版，powershell swap 整体删除；0.1.10 无限重下死循环根因（swap 撞上杀软扫描窗口）随之修死；从老版本升级的机器启动时自动清理老方案残留；解压成本改在安装期一次付清，并清掉无版本戳的半截载荷；真机更新链路脚本化进测试（含三条失败注入）
• 新增「厨房笔记 kitchen」主题（MiMo 014 奶油纸凸版质感移植）与「松林 pine」主题（Pine Forest Green 移植）；主题列表 kitchen 升首位、移除 ayu-light，淡色回归一行 5 槽
• 快捷键页：Ctrl+L 全局搜索文件
• 输入框压缩锁态提示前置转圈 spinner

修复

• 快捷键页内容上下居中真正生效（居中上移到 mc-body flex 层）
• 会话功能栏 icon 13→16 规范档位，与左侧控制栏小图标对齐
• 项目详情卡/搜索弹窗时间显示不再逐秒跳动（time_ago 最小粒度改到分钟）
• 轮次摘要用户发言第三行被拦腰截断（改 line_clamp(3)）
• 压缩锁态提示补 12px 左缩进，与 placeholder 同一对齐线
• 松林 accent 微调降刺眼（2ecc40 → 29a83c）

改进

• 会话秒开深度优化：leaf 全文重读/磁盘计数全部后台化
• 切项目 git 刷新后台化：主线程 190-313ms → 106-126ms

This release focuses on: a reworked in-app update staging — versioned payload directory + startup handover (powershell swap removed), fixing the root cause of the 0.1.10 endless redownload loop; two new themes ("kitchen" and "pine"); faster session open and project switching; Ctrl+L global file search on the shortcuts page.

Install & Update

npm install -g pi-flash@latest   # same command for first install and updates
pi-flash

Requires Node.js ≥ 22.19.
Or download the zip portable build, extract and double-click pi-flash.exe — no Node needed.
Windows x64 only.

In-app update is broken on 0.1.10 and earlier — please update via the npm command above (or re-download the zip): the updater shipped with those versions uses a flawed whole-directory swap and cannot install new builds (the 0.1.10 endless redownload loop was one symptom); only from 0.1.11 does the new "versioned directory extraction + startup handover" chain take over, and in-app updates work again from this release on. Zip portable users should likewise reinstall via npm or re-download the zip instead of relying on the old in-app updater.

New

• In-app update rework: after download the payload is extracted into a versioned directory; at startup a self-verifying handover (directory name version must equal the process version, preventing spawn storms) launches the new build, and the powershell swap is gone entirely; the 0.1.10 endless redownload root cause (the swap racing into antivirus scanning) is fixed for good; machines upgrading from older builds clean up legacy leftovers at startup; extraction cost is paid once at install time, and stampless half-extracted payloads are removed; the real-machine update pipeline is scripted into tests (with three failure injections)
• Two new themes: "kitchen" (MiMo 014 cream-paper letterpress feel) and "pine" (Pine Forest Green port); kitchen moves to the front of the theme list, ayu-light removed — light themes back to one row of 5
• Shortcuts page: Ctrl+L global file search
• The compaction locked-state hint now shows a spinner up front

Fixes

• Shortcuts page vertical centering actually works (centering moved up to the mc-body flex layer)
• Session toolbar icons 13→16 spec size, aligned with the left control bar small icons
• Detail cards / search popups no longer tick seconds (time_ago minimum granularity is now minutes)
• Turn-summary user lines no longer cut in half on the third line (line_clamp(3))
• Compaction locked-state hint gets a 12px left inset, aligned with the placeholder
• Pine accent toned down (2ecc40 → 29a83c)

Improvements

• Deep session open-time optimization: leaf full-text reread and on-disk counting fully backgrounded
• Project-switch git refresh backgrounded: main thread 190-313ms → 106-126ms

v0.1.10

本版聚焦：快捷键体系（082）落地、文件树 Pin 收藏夹与跨项目快切、项目标签拖拽排序、用量面板整合；npm 薄壳下载载荷前预取真实最新版本号（镜像滞后不再把老版本装给用户）；内置 pi 升级 1.3.0。仍在 ≤ 0.1.8 的老版本建议直接 npm 重装或 zip 重下，0.1.9 起应用内自更新链路已修复。

• 快捷键（082）：Alt+1 / Alt+2 最大化左/右子面板；Ctrl+←/→ 切到当前标签左/右邻视图；文件树 F2 重命名；设置新增「快捷键」说明页（居中索引版式，全部键位可查）
• 文件树：Pin 收藏夹——操作栏按钮 + 右键固定/取消固定，收藏夹为独立视图，按项目持久化；标题处项目下拉，树根跨项目快切（↑↓/Enter 键盘可操作）；激活文件标签即同步树的当前项目
• 项目拖拽：项目标签支持拖拽排序（排序持久化，拖拽中收起为标签）；自绘拖拽小手/握紧光标（vendored gpui 补齐 Windows OpenHand/ClosedHand 实现）
• 用量面板：系统提示词 / 会话工具集入口自功能栏迁入面板（与压缩同排等宽）；压缩按钮配双箭头图标，颜色随三态
• 其他新功能：总结栏改「icon+数字」四组统计（消息/用户/助手/工具）；功能栏新增「会话目录」按钮（资源管理器打开当前项目的会话组目录）；输入框 Enter 为唯一发送键，全部发送走排队；可用模型列表新增「只看 free」开关；Markdown 预览点击可回到编辑态；编辑器光标加粗、闪烁加快
• 自动更新链：npm 薄壳安装时先向 GitHub Releases API 预取真实最新版本号再拼载荷地址——镜像壳版本滞后不再传导成「装到老版本」；更新管线端到端自动化测试进常规门禁（0.1.6/0.1.8 历次实录场景全部钉死，不再依赖用户真机验证）
• 内置 pi 1.2.0 → 1.3.0：wire 协议逐字节一致复核通过；行为变化记入 pi-rpc.md（模型切换丢他模型 thinking、resume 保工具集、工具参数解析两处修复、重试名单扩大）
• 修复：编辑器点击可见行瞬间跳到屏底；文件标签改稳定打开顺序（去除「激活即挪到最前」）；pending_echoes 轮终不清导致堆积，改 64 条死信上限兜底；用量面板缓存命中率显示 ×100 纠正（97.2% 显示成 1.0%）；快捷键页修饰键键帽配色纠正（mix_rgb 参数顺序写反）；项目/会话右键详情卡加宽 338px、路径全量折行，删除入口收敛到详情卡

This release focuses on: the keyboard shortcuts system (082), file-tree Pin favorites and cross-project switching, drag-to-reorder project tabs, a consolidated usage panel; the npm shell now pre-fetches the real latest version before downloading the payload (registry mirror lag no longer ships old versions); built-in pi upgraded to 1.3.0. If you are still on ≤ 0.1.8, please reinstall via npm or the zip — the in-app update chain has been fixed since 0.1.9.

• Shortcuts (082): Alt+1 / Alt+2 maximize the left/right sub-panel; Ctrl+←/→ switch to the adjacent tab; F2 renames files in the file tree; a new "Shortcuts" settings page lists every binding in a centered index layout
• File tree: Pin favorites — toolbar button + right-click pin/unpin, favorites as a standalone view, persisted per project; project dropdown in the title for cross-project switching (↑↓/Enter keyboard navigable); activating a file tab syncs the tree to that project
• Project drag & drop: drag-to-reorder project tabs (order persisted; tabs collapse while dragging); hand-grab cursors drawn in-house (vendored gpui now implements Windows OpenHand/ClosedHand)
• Usage panel: system prompt / session tools entries moved into the panel (equally spaced with compact on one row); the compact button gets a double-arrow icon with tri-state coloring
• Other features: session summary bar now shows four icon+count stats (messages/user/assistant/tools); new "session directory" toolbar button (opens the project's session group in Explorer); Enter is the only send key and all sends go through the queue; "free only" filter for the model list; click Markdown preview to return to editing; bolder, faster-blinking editor caret
• Auto-update chain: the npm shell now resolves the true latest version from the GitHub Releases API before building payload URLs — mirror lag behind the shell version no longer installs outdated payloads; end-to-end pipeline tests for the updater are now part of the regular gates (every 0.1.6/0.1.8 incident is pinned; no more relying on real users as the test bench)
• Built-in pi 1.2.0 → 1.3.0: wire protocol verified byte-for-byte; behavior changes recorded in pi-rpc.md (model switch drops other-model thinking, resume keeps tools, two tool-arg parsing fixes, wider retry list)
• Fixes: editor jumping to the bottom when clicking a visible line; file tabs keep a stable open order (MRU reordering removed); pending_echoes no longer accumulates (64-entry dead-letter cap); usage-panel cache hit rate display ×100 corrected (97.2% showed as 1.0%); shortcut page modifier keycap colors fixed (swapped mix_rgb args); project/session context cards widened to 338px with full path wrapping, delete consolidated into the detail card