v1.0.7

中文

基于 v1.0.6..v1.0.7 的提交整理。

新增

• 模型目录缓存优先
  • 内置 OAuth/API-key：默认读磁盘缓存（light），仅 ?fresh=1 /「刷新模型」走 heavy ModelRuntime
  • 首次空缓存才自动拉一次；之后仅手动刷新，避免反复打开 Models 打满 heavy/网络
  • free / custom：列表留在 models.json；仅首次无模型或用户点刷新时 discover
• 按 provider 流式填充 Settings 模型列表（慢的一个不再挡住其它行）
• 批量禁用 provider 模型 API（disabled-models 等本地路径）
• 去掉 models.dev 在线目录依赖，内置/本地数据源为主
• Nous / MiniMax 等订阅/provider 集成与图标
• Pi SDK 0.84.0（含 telemetry/protocol/client）
• 抽取 lib/markdown、slash-commands 辅助与测试

性能

• 会话打开不再因 models.dev / context-window 起 ModelRuntime 而卡住
• 从 Settings 返回：transcript soft-cache + 不误 remount ChatWindow
• 重选当前会话不再 router.replace / sessionKey 抖动
• Agent 角色下拉在 enable/disable 后 ?fresh=1 静默刷新
• free provider 列表并行拉取

修复

• 右键菜单：无关滚动不关闭；删除会话用 pending tombstone 防中途插回
• 右键菜单去掉图标（纯文字 + danger 样式）
• 移除 Network 设置页（代理/旁路/CA/连通性测试）；打开设置时清理残留 proxy/CA，避免静默毒化 OAuth/模型
• 打包态 OAuth：SDK bundle 注册 static OAuth loaders；disconnect 用 createRequire/lock 回退
• macOS 全屏 traffic-light padding；API key 登录可中止

内部

• 新增：builtin-provider-models-cache、provider-live-models、subscription-oauth-shared、menu-dismiss、coding-agent-bundle-entry 等
• 删除：model-catalog*、models-dev-catalog、network/test 路由
• 版本：@ct-jyjntc/pi-web@1.0.7

安装说明

macOS

• 附件：Pi-Web-1.0.7-arm64.dmg（Apple Silicon，~170MB）
• 签名：electron-builder 真实 ad-hoc（未 Apple 公证）
• Gatekeeper：右键打开，或 xattr -cr "/Applications/Pi Web.app"

Windows

• 附件：Pi-Web-1.0.7-x64.exe（Windows x64 NSIS，~143MB）
• 双击安装，可自定义安装目录；安装后会创建桌面与开始菜单快捷方式
• SmartScreen：更多信息 → 仍要运行

---

English

Prepared from commits in v1.0.6..v1.0.7.

Added

• Cache-first built-in model catalogs; first-time auto-fetch only; per-provider refresh
• Stream per-provider catalogs into Settings as each finishes
• Bulk local disabled-models path; drop models.dev-centric catalog stack
• Nous / MiniMax providers; Pi SDK 0.84.0
• Shared markdown + slash-command helpers

Perf

• Session open no longer stalls on models.dev / ModelRuntime for context ring
• Instant reopen after Settings (transcript soft-cache; no remount thrash)
• Silent agent-model list refresh after enable/disable

Fixed

• Context-menu scroll dismiss + session delete tombstones
• Remove Network/proxy settings (clear leftover proxy/CA on open)
• Packaged OAuth loaders + resilient disconnect
• Fullscreen traffic-light padding

Assets

• Pi-Web-1.0.7-arm64.dmg (~170MB, arm64, ad-hoc, not notarized)
• Pi-Web-1.0.7-x64.exe (~143MB, Windows x64 NSIS)
• SmartScreen: More info → Run anyway

v1.0.6

中文

基于 v1.0.5..v1.0.6 的当前 main 重新打包（覆盖此前误推的 v1.0.6 产物）。

架构： 桌面为 app:// + 双 IPC 运行时（light / heavy）。UI 静态资源经 app 协议加载；API 走 Electron IPC，不再默认 HTTP daemon + Next。安装包 prune Next；Agent SDK 单文件打包；ESM 预编译。

新增 / 架构

• app:// 桌面 UI + dual IPC agent runtimes（light 永不加载 SDK，heavy 管 session/tools）
• electron/app-protocol.js、runtime-host.js；daemon/ipc-host.mjs + dispatch.mjs
• 打包：预编译 app/api + lib 为 ESM；bundle-pi-sdk 折叠 agent SDK；平台原生裁剪
• 资源管理器文件操作 + Composer/Session 右键菜单
• 全局快捷键 + 帮助对话框
• 权限策略 / agent mode 中心化
• session-reader 与 session-entries 拆分

性能

• 会话打开路径去 rpc-manager 冷启动（project-trust / sessions GET 毫秒级）
• 打包态 native import 加载 ESM（非 jiti 全图）
• light/heavy 路由分流；设置面板走 light，不阻塞 SDK
• 模型禁用 light 路由即时切换；双进程缓存 ?fresh=1 消除滞后
• free provider 列表并行拉取

修复

• macOS codesign：sanitize-bundle-symlinks + verbatimSymlinks（修复 invalid destination for symbolic link）
• 模型设置 thrash / force-refresh 卡顿
• 会话删除与 model picker 跨 runtime 缓存不一致
• typecheck / 构建小修

资产

• Pi-Web-1.0.6-arm64.dmg（~171MB，arm64，ad-hoc，未公证）
• Gatekeeper：右键打开，或 xattr -cr "/Applications/Pi Web.app"
• Pi-Web-1.0.6-x64.exe（~143MB，Windows x64 NSIS）
• SmartScreen：更多信息 → 仍要运行

---

English

Rebuilt from current main for v1.0.5..v1.0.6 (replaces prior v1.0.6 asset).

Architecture: Desktop app:// + dual IPC runtimes (light never loads agent SDK; heavy owns sessions/tools). Next pruned from the installer; SDK single-file bundle; precompiled ESM routes.

Added

• app:// UI, dual IPC hosts, explorer ops, shortcuts, permission/mode centralization, session-entries split

Perf

• Fast session-open GETs; native ESM import; light settings routes; fresh=1 dual-cache; parallel free models

Fixed

• Codesign symlink sanitization; models settings thrash; cross-runtime cache lag

Assets

• Pi-Web-1.0.6-arm64.dmg (~171MB, arm64, ad-hoc, not notarized)
• Pi-Web-1.0.6-x64.exe (~143MB, Windows x64 NSIS)
• SmartScreen: More info → Run anyway

v1.0.5

中文

基于 v1.0.4..v1.0.5 的提交整理。

新增

• 统一 Agent 模式

  • Ask / Auto / Plan / Full(yolo) 四档访问模式
  • 全局持久化：模式跨会话共享，新会话自动应用
  • 模式变化时同步到所有 live wrapper
  • ChatInput 模式选择菜单

• 文件编辑工具（Monaco）

  • 内置 Monaco 编辑器（FileEditor）
  • 编辑 / 保存 / 格式化（format-file）
  • LSP / 命令查询 API（/api/lsp/query、/api/commands）
  • 自定义用户命令（user/project 级，commands.ts）

• 细粒度权限策略

  • allow / ask / deny 三级策略文档（permission-policy）
  • 设置页权限面板（PermissionsSettingsPanel）
  • 项目初始化流程（project-init）
  • 兼容旧 permission-mode 迁移

• 工作区回合日志（Workspace Turn Journal）

  • 每回合文件变更记录（edit/create/delete）
  • undo / redo 工作区回合
  • edit-from-here：从指定消息叶回退工作区回合
  • 会话导航支持（session-nav-store）
  • Context 面板 journal 刷新控件

• 快照感知 Hashline 编辑

  • 持久化 hashline 快照（hashline-snapshots）
  • stale-tag 恢复 + 每路径锁
  • 编辑后等待格式化完成
  • 语法守卫覆盖加强（edit-syntax-guard）

• AtomGit / AtomCode 网关

  • AtomGit Provider（OAuth + 模型列表）
  • AtomCode v1 请求签名（atomgit-signing + 回归测试）
  • gateway headers / user-agent 对齐签名要求

• Radius Provider

  • 新增 Radius provider 集成与图标

• 按模型 Thinking 等级设置

  • 每个 agent 角色 / utility 模型可配 thinking level
  • 会话标题生成沿用配置
  • 模型切换保留偏好；provider 目录刷新联动

• 模型目录与配置扩展

  • 共享 catalog 加载、内置 provider 元数据（builtin-provider-models）
  • 模型覆盖（model-overrides）、thinking-level maps
  • 降级刷新报告；ModelsConfig / free-model 富化重构

修复 / 改进

• 安装包瘦身（平台原生依赖裁剪）

  • node-pty 只保留目标平台 prebuilds
  • clipboard 裁掉非目标平台包（9 个）
  • tree-sitter-bash 精简为 wasm-only
  • DMG 体积 190M → 172M

• 文件访问与会话生命周期加固

• 移除 Lean review 工作流（policy/hard gate/review 相关代码），保留设置骨架

• 深层模型配置 API 与 UI 统一（model detail / provider / builtin 面板）

内部调整

• 新增：agent-mode、global-agent-mode、atomgit-provider、atomgit-signing、workspace-turn-journal、permission-policy、project-init、hashline-snapshots、format-file、commands、thinking-level-map、model-overrides、builtin-provider-models 等
• 依赖新增：monaco-editor / @monaco-editor/react
• 版本：@ct-jyjntc/pi-web@1.0.5

安装说明（本 Release 附件）

macOS

• 附件：Pi-Web-1.0.5-arm64.dmg（Apple Silicon）
• 签名：electron-builder 真实 ad-hoc（identity: "-"，未 Apple 公证）
• 若 Gatekeeper 拦截：

# 方式 1：右键 App → 打开 → 打开
# 方式 2：
xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• 附件：Pi-Web-1.0.5-x64.exe（Windows x64 NSIS 安装包）
• 双击安装，可自定义安装目录；安装后会创建桌面与开始菜单快捷方式。
• 如 SmartScreen 提示「Windows 已保护你的电脑」：点击「更多信息」→「仍要运行」。

---

English

Prepared from commits in v1.0.4..v1.0.5.

Added

• Unified agent modes

  • Ask / Auto / Plan / Full (yolo)
  • Persisted globally across sessions; applied to new sessions
  • Synced to live wrappers on change
  • Mode selector in ChatInput

• Monaco file editing

  • Built-in Monaco editor (FileEditor)
  • Edit / save / format (format-file)
  • LSP query + command APIs (/api/lsp/query, /api/commands)
  • Custom user commands (user/project scope)

• Fine-grained permission policies

  • allow / ask / deny policy document (permission-policy)
  • Settings permission panel
  • Project init flow (project-init)
  • Legacy permission-mode migration

• Workspace turn journal

  • Per-turn file mutations (edit/create/delete)
  • Undo / redo workspace turns
  • edit-from-here: rollback through a given message leaf
  • Session navigation support (session-nav-store)
  • Journal refresh controls in Context panel

• Snapshot-aware hashline editing

  • Persisted hashline snapshots (hashline-snapshots)
  • Stale-tag recovery + per-path locking
  • Await formatting after edits
  • Stronger syntax guard coverage

• AtomGit / AtomCode gateway

  • AtomGit provider (OAuth + model listing)
  • AtomCode v1 request signing (atomgit-signing + regression tests)
  • Gateway headers / user-agent aligned with signing requirements

• Radius provider integration + icon

• Per-model thinking levels

  • Configurable thinking per agent role / utility model
  • Applied to session title generation
  • Preferences preserved across model changes; catalog refresh on updates

• Model catalog & config expansion

  • Shared catalog loading, built-in provider metadata
  • Model overrides, thinking-level maps
  • Degraded refresh reporting; unified ModelsConfig / free-model enrichment

Fixed / Improved

• Install size slimming (platform native pruning)

  • node-pty keeps only target-platform prebuilds
  • clipboard drops non-target platform packages (9)
  • tree-sitter-bash slimmed to wasm-only
  • DMG 190M → 172M

• Hardened file access + session lifecycle

• Removed Lean review workflow (policy/hard-gate/review code), kept settings skeleton

• Unified deep model config APIs/UI (detail / provider / builtin panels)

Internal

• New modules: agent-mode, global-agent-mode, atomgit-provider, atomgit-signing, workspace-turn-journal, permission-policy, project-init, hashline-snapshots, format-file, commands, thinking-level-map, model-overrides, builtin-provider-models, etc.
• New deps: monaco-editor / @monaco-editor/react
• Version: @ct-jyjntc/pi-web@1.0.5

Install Notes

macOS

• Asset: Pi-Web-1.0.5-arm64.dmg (Apple Silicon)
• Signing: electron-builder real ad-hoc (identity: "-", not Apple notarized)
• If Gatekeeper blocks:

xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• Asset: Pi-Web-1.0.5-x64.exe (Windows x64 NSIS installer)
• Run the installer; you can choose the install directory. Desktop and Start Menu shortcuts are created.
• If SmartScreen says "Windows protected your PC": click "More info" → "Run anyway".

v1.0.4

中文

基于 v1.0.3..v1.0.4 的提交整理。

新增

• 系统托盘（System Tray）

  • Windows / Linux / macOS 托盘支持
  • 关闭窗口可最小化到托盘（跨平台 hide-on-close）
  • 托盘点击恢复窗口；托盘菜单退出
  • 适配菜单栏图标尺寸

• Electron 启动闪屏

  • Splash 直至 AppShell 发出 ui-ready
  • 侧边栏优先加载，ChatWindow 延后挂载
  • Windows 冷启动参数与更快的就绪探测
  • /api/health 轻量健康检查

• Lean Mode（可选精益模式）

  • 产品级防膨胀策略：会话启动注入 portable anti-bloat policy
  • 强度档位：off / review / hard（默认 off）
  • 编辑后 high-signal lean review（/api/lean-review + LeanReviewCard）
  • Hard 强度：大文件净增行硬门禁（edit growth gate）
  • 审查范围限定为本次 touched paths（避免脏工作区误报）
  • 手动「检查精简度」入口移入 composer 溢出菜单
  • 项目级 .pi-web.json 覆盖 UI + /api/lean-project
  • leanMode 变更时重置空闲 RPC 会话
  • 客户端安全 defaults（lean-mode-settings，无 Node fs）
  • smoke-lean-mode 验收脚手架

• 内置扩展预打包

  • first-party 扩展（todo / ask-user）纯模块注册
  • 重型扩展（permission / subagents / mcp-adapter）预打包为 .pi-web-bundle
  • 迁移遗留 packages 设置并 prewarm factories
  • bundle:extensions + Electron 打包复制 prebundle
  • 避免启动时 jiti / 运行时 npm 安装

• 薄 RPC 注册表

  • rpc-registry / rpc-running / rpc-session-start / rpc-session-wrapper 拆分
  • 列表/running API 不再强拉完整 SDK 图
  • 迟到 agent 事件保留；provider 凭据存储加固

修复

• 扩展包根路径避免动态 require.resolve（Turbopack 友好，resolve-npm-package-root）
• Lean Mode 默认值客户端安全（不把 Node fs 打进浏览器包）
• esbuild JS API + CLI 回退；Windows 原生二进制与 shell 解析
• 迟到 agent 事件不丢；provider credentials 持久化
• Lean Hard 文案与实际 edit gate 行为对齐

重构 / 改进

• 巨型 UI 模块化

  • AppShell / ChatInput / ChatWindow / MessageView / ModelsConfig / SessionSidebar / SettingsPage 拆分为子模块
  • 消息块、composer 菜单、extension panels、process rail 等独立文件
  • 统一 Icon 组件替换内联 SVG

• Agent 会话热路径拆分

  • useAgentSession 事件/流式/合并/扩展 UI 抽到 agent-session-* 模块
  • 共享类型与 model cost 工具归一

• AI 编码约束与 declutter 蓝图文档（AGENTS.md + superpowers specs）

内部调整

• 新增：lean-*、builtin-extensions、first-party/*、rpc-registry、rpc-running、rpc-session-*、resolve-npm-package-root、Icon、tray.js、LeanReviewCard 等
• package.json 增加 bundle:extensions；build:electron 先打包扩展
• 版本：@ct-jyjntc/pi-web@1.0.4

安装说明（本 Release 附件）

macOS

• 附件：Pi-Web-1.0.4-arm64.dmg（Apple Silicon）
• 签名：electron-builder 真实 ad-hoc（identity: "-"，未 Apple 公证）
• 若 Gatekeeper 拦截：

# 方式 1：右键 App → 打开 → 打开
# 方式 2：
xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• 附件：Pi-Web-1.0.4-x64.exe（Windows x64 NSIS 安装包）
• 双击安装，可自定义安装目录；安装后会创建桌面与开始菜单快捷方式。
• 如 SmartScreen 提示「Windows 已保护你的电脑」：点击「更多信息」→「仍要运行」。

---

English

Prepared from commits in v1.0.3..v1.0.4.

Added

• System tray

  • Tray support on Windows / Linux / macOS
  • Close-to-tray hide across platforms
  • Click tray to restore; quit from tray menu
  • Menu-bar-appropriate icon sizes

• Electron splash screen

  • Splash until AppShell signals ui-ready
  • Eager sidebar, deferred ChatWindow mount
  • Windows cold-start flags + faster readiness probing
  • Lightweight /api/health

• Lean Mode (opt-in anti-bloat)

  • Portable anti-bloat policy inject on session start
  • Intensities: off / review / hard (default off)
  • High-signal post-edit lean review (/api/lean-review + LeanReviewCard)
  • Hard intensity large-file net-growth edit gate
  • Review scoped to touched paths only
  • Manual “Check leanness” in composer overflow menu
  • Per-project .pi-web.json override UI + /api/lean-project
  • Reset idle RPC sessions when leanMode changes
  • Client-safe defaults (lean-mode-settings, no Node fs)
  • smoke-lean-mode acceptance scaffolding

• Bundled builtin extensions

  • First-party todo / ask-user pure modules
  • Heavy extensions prebundled as .pi-web-bundle
  • Legacy packages migration + factory prewarm
  • bundle:extensions + Electron packaging copies
  • No runtime jiti / npm install at session start

• Thin RPC registry

  • Split rpc-registry / rpc-running / rpc-session-start / rpc-session-wrapper
  • List/running APIs avoid pulling full SDK graph
  • Preserve late agent events; stronger provider credential storage

Fixed

• Extension package roots without dynamic require.resolve (resolve-npm-package-root)
• Lean Mode defaults stay client-safe (no fs in browser bundle)
• esbuild JS API + CLI fallback; Windows binary/shell resolution
• Late agent events preserved; provider credentials persisted
• Lean Hard copy matches live edit-gate behavior

Refactors / Improvements

• Giant UI modularization

  • AppShell / ChatInput / ChatWindow / MessageView / ModelsConfig / SessionSidebar / SettingsPage split into focused modules
  • Message blocks, composer menus, extension panels, process rail extracted
  • Shared Icon component replaces inline SVGs

• Agent session hot-path split

  • Event/stream/merge/extension UI moved into agent-session-* modules
  • Shared types + model cost utility normalization

• AI coding constraints + declutter blueprint docs

Internal

• New modules: lean-*, builtin-extensions, first-party/*, rpc-registry, rpc-running, rpc-session-*, resolve-npm-package-root, Icon, tray.js, LeanReviewCard, etc.
• bundle:extensions script; build:electron bundles extensions first
• Version: @ct-jyjntc/pi-web@1.0.4

Install Notes

macOS

• Asset: Pi-Web-1.0.4-arm64.dmg (Apple Silicon)
• Signing: electron-builder real ad-hoc (identity: "-", not Apple notarized)
• If Gatekeeper blocks:

xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• Asset: Pi-Web-1.0.4-x64.exe (Windows x64 NSIS installer)
• Run the installer; you can choose the install directory. Desktop and Start Menu shortcuts are created.
• If SmartScreen says "Windows protected your PC": click "More info" → "Run anyway".

v1.0.3

中文

基于 v1.0.2..v1.0.3 的提交整理。

新增

• Electron 43 + macOS ad-hoc 签名链路

  • Electron 37.10.3 → 43.2.0
  • 打包默认 mac.identity: "-"（真实 ad-hoc，非 linker-signed）
  • macos-adhoc-sign / ensure-electron-adhoc-sign 开发态签名脚本
  • smoke:electron / smoke:electron-notify 冒烟测试
  • 未签名构建的通知失败处理

• TokenRhythm Provider

  • 完整认证、模型列表、凭据管理
  • createConfiguredModelRuntime() 统一模型运行时初始化
  • 支持 OAuth + API Key 双鉴权
  • ModelsConfig 集成与 i18n
  • /api/models-config/provider-models 拉取 provider 模型

• 后台记忆审查 + 双作用域记忆

  • 每 10 次用户回合后台 memory review（utility 模型）
  • project / user 双作用域事实库，独立字符预算
  • 原子 operations[] 批处理（add/replace/remove）
  • 每轮 prompt 注入 recall 上下文（去重）
  • /api/memory-review 与设置页 Memory 联动

• Hermes 风格 Process Rail

  • 多步助手回合过程轨（工具/思考步骤）
  • 展开/收起时固定切换按钮，避免 stick-to-bottom 把按钮顶飞
  • 工具运行动画、live tail 虚拟化改进

• 滚动跟随重做

  • 自定义 scroll-follow 替换为 use-stick-to-bottom
  • 与 process rail / 输入区高度变化协同更好

• 运行中会话轮询

  • 移除 long-lived running SSE
  • 改为 /api/agent/running 轮询，降低多窗口连接成本

重构 / 改进

• 抽取 agent-live-state 统一 agent 状态读取
• 抽取 api-cwd / api-response：cwd 校验与错误响应复用
• 抽取 provider listing + credential store 独立模块
• UI 模式提取：ComposerPalette、useFileWatch、TopBarChromeWidgets（auto-name）
• TodoAtoms 与 todo-from-transcript 支持从 transcript 解析 todo
• model-scope 模型可见/作用域逻辑
• 删除废弃 /api/sessions/[id]/export 与相关死代码
• 去掉 tailwind.config.ts 等无用配置
• 模态 flex 布局，溢出内容更稳

依赖 / 内部

• Pi SDK 相关路径随 Electron 43 与 runtime 初始化一并更新
• 新增模块：tokenrhythm-provider、memory-review、memory-context、provider-listing、provider-credential-store、agent-live-state、model-scope、todo-from-transcript、atomic-file 等
• 版本：@ct-jyjntc/pi-web@1.0.3

安装说明（本 Release 附件）

macOS

• 附件：Pi-Web-1.0.3-arm64.dmg（Apple Silicon）
• 签名：electron-builder 真实 ad-hoc（identity: "-"，未 Apple 公证）
• 若 Gatekeeper 拦截：

# 方式 1：右键 App → 打开 → 打开
# 方式 2：
xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• 附件：Pi-Web-1.0.3-x64.exe（Windows x64 NSIS 安装包）
• 双击安装，可自定义安装目录；安装后会创建桌面与开始菜单快捷方式。
• 如 SmartScreen 提示「Windows 已保护你的电脑」：点击「更多信息」→「仍要运行」。

---

English

Prepared from commits in v1.0.2..v1.0.3.

Added

• Electron 43 + macOS ad-hoc signing pipeline

  • Electron 37.10.3 → 43.2.0
  • Packaged builds use mac.identity: "-" (real ad-hoc, not linker-signed)
  • Dev helpers: macos-adhoc-sign, ensure-electron-adhoc-sign
  • Smoke scripts: smoke:electron, smoke:electron-notify
  • Notification failure handling for unsigned macOS builds

• TokenRhythm provider

  • Full auth, model listing, credential management
  • createConfiguredModelRuntime() for consistent runtime init
  • Dual OAuth + API-key auth support
  • ModelsConfig integration + i18n
  • /api/models-config/provider-models

• Background memory review + dual-scope memory

  • Every-10th-turn background review via utility model
  • Project + user fact stores with separate char budgets
  • Atomic operations[] batch (add/replace/remove)
  • Per-prompt recall injection with dedupe
  • /api/memory-review + Settings Memory wiring

• Hermes-style process rail

  • Multi-step assistant turn process track
  • Pin expand/collapse control so stick-to-bottom does not fling it
  • Tool-run animations + live-tail virtualization polish

• Scroll-follow rewrite

  • Replace custom follow logic with use-stick-to-bottom
  • Better cooperation with process rail / composer height changes

• Running-session polling

  • Drop long-lived running SSE
  • Poll /api/agent/running instead (cheaper multi-window)

Refactors / Improvements

• Shared agent-live-state for agent state reads
• Shared api-cwd / api-response validation + errors
• Dedicated provider listing + credential store modules
• UI extractions: ComposerPalette, useFileWatch, TopBarChromeWidgets (auto-name)
• TodoAtoms + todo-from-transcript
• model-scope visibility helpers
• Remove dead /api/sessions/[id]/export and unused config
• Flex-based modal layouts for overflow stability

Internal

• New modules: tokenrhythm-provider, memory-review, memory-context, provider-listing, provider-credential-store, agent-live-state, model-scope, todo-from-transcript, atomic-file, etc.
• Version: @ct-jyjntc/pi-web@1.0.3

Install Notes

macOS

• Asset: Pi-Web-1.0.3-arm64.dmg (Apple Silicon)
• Signing: electron-builder real ad-hoc (identity: "-", not Apple notarized)
• If Gatekeeper blocks:

xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• Asset: Pi-Web-1.0.3-x64.exe (Windows x64 NSIS installer)
• Run the installer; you can choose the install directory. Desktop and Start Menu shortcuts are created.
• If SmartScreen says "Windows protected your PC": click "More info" → "Run anyway".

v1.0.2

中文

基于 v1.0.1..v1.0.2 的提交整理。

新增

• 模型过滤与目录发现

  • 模型数 > 8 时，ChatInput 显示过滤输入框
  • 模型目录（catalog）与发现（discover）API：/api/models-config/catalog、/api/models-config/discover
  • 目录匹配 / 价格推荐 / 搜索（model-catalog）
  • 发现鉴权（model-discovery-auth）
  • ModelsConfig 集成目录导入与 UI
  • 相关 i18n 与单元测试

• 应用内更新提示

  • 共享 app-update-store（检查 / 缓存 / 自动轮询）
  • 顶栏更新通知 chip
  • 设置页与更新状态联动

• 会话侧边栏时间分组

  • 按时间桶（今天 / 昨天 / 更早等）分组
  • 会话项更紧凑的布局

• 全屏图片预览

  • 可复用 PreviewableImage 组件
  • Markdown 图片与输入区缩略图统一支持全屏预览

• 用量统计 UI 重做

  • 热力图、趋势图、模型拆分布局重设计
  • 去掉冗余手动刷新按钮（依赖缓存 / 预取）

• 共享设置 store

  • web-settings-store 客户端缓存与订阅
  • 设置读取 / 补丁 / 失效 / 带模型列表拉取

• Diff 视图组件

  • 新增 DiffView，供文件 / Git 差异展示复用

• Context 标签徽章

  • ContextTabBadge 展示上下文相关状态

修复

• 网络测试用真实轻量端点替换占位域名
• 侧边栏下拉：dropdownRef 挂到父行；New / Refresh 时正确关闭
• 背景色从 oklch 改为 hex，提升兼容性

改进

• SSE 性能

  • 合并 / 投影 message_update，降低带宽与重渲染
  • 非 update 事件前 flush，保证顺序
  • 会话 header 用轻量 readSessionHeader()，少开完整 SessionManager

• 会话读取优化

  • session-reader 增强 header / context / export 路径
  • 多条 API 复用更轻量的会话文件读取

• Thinking 等级标签与下拉文案简化

• Chat / Minimap / MessageView / Markdown 渲染与展示逻辑整理

• Git 变更解析与展示能力扩展

• LSP health 信息补充

• 协作 live 会话能力增强

内部调整

• 新增模块：model-catalog、model-discovery、model-discovery-auth、app-update-store、web-settings-store、PreviewableImage、DiffView、ContextTabBadge
• 覆盖 rpc-manager、useAgentSession、session-reader、git-changes、collab-live 等核心路径
• 版本：@ct-jyjntc/pi-web@1.0.2

安装说明（本 Release 附件）

macOS

• 附件：Pi-Web-1.0.2-arm64.dmg（Apple Silicon）
• 签名：ad-hoc（未 Apple 公证）
• 若 Gatekeeper 拦截：

# 方式 1：右键 App → 打开 → 打开
# 方式 2：
xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• 附件：Pi-Web-1.0.2-x64.exe（Windows x64 NSIS 安装包）
• 双击安装，可自定义安装目录；安装后会创建桌面与开始菜单快捷方式。
• 如 SmartScreen 提示「Windows 已保护你的电脑」：点击「更多信息」→「仍要运行」。

---

English

Prepared from commits in v1.0.1..v1.0.2.

Added

• Model filtering & catalog discovery

  • Filter box in ChatInput when more than 8 models are available
  • Catalog + discover APIs: /api/models-config/catalog, /api/models-config/discover
  • Match / price recommend / search via model-catalog
  • Discovery auth helper
  • ModelsConfig catalog import UI
  • i18n + unit tests

• In-app update notification

  • Shared app-update-store (check / cache / auto-poll)
  • Top-bar update chip
  • Settings page wired to update state

• Sidebar time buckets

  • Group sessions by today / yesterday / older
  • More compact session row layout

• Full-screen image preview

  • Reusable PreviewableImage
  • Markdown images + composer thumbnails open full-screen

• Usage stats UI revamp

  • Redesigned heatmap, trend, model split
  • Dropped redundant manual refresh (cache / prefetch)

• Shared web-settings store

  • Client cache + subscribe (web-settings-store)
  • get / patch / invalidate / fetch-with-models

• DiffView component for shared file/Git diffs

• ContextTabBadge for context status in tabs

Fixed

• Network test uses a real lightweight endpoint instead of a placeholder domain
• Sidebar dropdown: ref on parent row; close on New/Refresh
• Replace oklch background colors with hex for broader compatibility

Improved

• SSE performance

  • Project + coalesce message_update events
  • Flush before non-update events for ordering
  • Lightweight readSessionHeader() instead of full SessionManager opens

• Session read path

  • Stronger header / context / export handling in session-reader
  • More APIs reuse lighter session file reads

• Simpler thinking-level labels / dropdown

• Chat / minimap / message / markdown display cleanup

• Broader git-changes parsing/display

• Richer LSP health reporting

• Stronger collab live session handling

Internal

• New modules: model-catalog, model-discovery, model-discovery-auth, app-update-store, web-settings-store, PreviewableImage, DiffView, ContextTabBadge
• Touched core paths in rpc-manager, useAgentSession, session-reader, git-changes, collab-live
• Version: @ct-jyjntc/pi-web@1.0.2

Install Notes

macOS

• Asset: Pi-Web-1.0.2-arm64.dmg (Apple Silicon)
• Signing: ad-hoc (not Apple notarized)
• If Gatekeeper blocks:

xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• Asset: Pi-Web-1.0.2-x64.exe (Windows x64 NSIS installer)
• Run the installer; you can choose the install directory. Desktop and Start Menu shortcuts are created.
• If SmartScreen says "Windows protected your PC": click "More info" → "Run anyway".

v1.0.1

中文

基于 v1.0.0..v1.0.1 的提交整理。

新增

• 模型角色（Model Roles）

  • 支持 default / smol / plan 角色
  • 与设置页、Git Review、Advisor 等流程联动

• Git Review

  • /api/git/review 生成审查提示
  • ReviewSummaryCard 渲染结构化审查结果
  • Git 面板集成审查入口

• Git 高级操作

  • commit-split（拆分提交）
  • conflict 处理
  • merge API
  • Git 面板能力扩展

• 项目记忆（Project Memory）

  • retain / recall / reflect
  • 启发式与可选模型合成
  • 设置页 Memory 分区
  • agent 工具与系统提示注入

• Advisor

  • /api/advisor 顾问审查能力
  • 设置页 Advisor 分区

• Checkpoints

  • 会话检查点 API，支持命名回看

• 协作分享（Collab）

  • 生成只读分享链接
  • /collab/[token] 查看页 + SSE 事件
  • Context 面板分享按钮
  • CollabViewer 未读计数与跳转最新

• Debug 面板

  • 源码位置导航、堆栈展示
  • FileViewer focusLine 行级跳转
  • Debug 工作区标签

• LSP 健康与代码智能

  • LSP catalog + PATH 发现 + 安装提示
  • /api/lsp 健康检查
  • agent 侧 LSP / 代码智能工具
  • TypeScript 内置服务回退

• GitHub 薄封装

  • gh CLI 只读封装
  • 虚拟路径 pr://N、pr://N/diff、issue://N
  • /api/github + agent github 工具

• Hashline-first 编辑

  • 优先 omp 风格 hashline patch
  • classic edit 仍兼容
  • 失败时 kind/excerpt 恢复提示

• 用量统计（Usage）

  • UsagePanel：热力图、趋势、模型拆分
  • /api/usage 聚合会话文件
  • 按文件缓存 + soft TTL
  • 设置页加载/悬停预取

• 免费 Provider 与模型禁用

  • 托管 free provider（仅开关，不可改字段）
  • 模型 disabled 标志：从选择器隐藏但保留配置

• 设置页重组

  • 导航分组：App / Agent / Integrations
  • Agent / Memory / Network 子分区
  • Manage providers 入口、项目记忆提示
  • 切换分区时主面板滚回顶部

• 浮动输入区（Floating Composer）

  • 输入区浮在 transcript 上
  • 动态 underlay + ResizeObserver 同步 padding
  • 移动端「回到底部」随高度调整

• 网络测试

  • /api/network/test 连通性检测

• 文档落地页

  • docs/index.html 明暗主题落地页
  • macOS / Windows 下载按钮（从 GitHub latest release 拉版本与体积）
  • 截图压缩、favicon、动效与 attribution

修复 / 改进

• Composer shell 圆角与阴影精修，尾部 padding 收紧
• 代码块去掉嵌套 pre 样式与 drop shadow
• Focus ring 软化：全局 :focus-visible 仅作用于按钮/链接；输入框统一柔和边框
• Tab/工具栏容器查询响应式折叠
• Settings UI 组件与样式收敛
• Debug 面板样式与 Context 面板统一
• Chat 顶栏 Pi 符号改为图标图片
• 包描述更新，README/LICENSE 补充上游 attribution

内部调整

• 大量新模块：project-memory、model-roles、github、lsp-health/lsp-client、hashline-edit、advisor、collab-live、usage、free-providers、disabled-models、git-review、git-commit-split、git-conflict、node-inspector 等
• agent 扩展工具：memory / github / edit / code-intel / debug / advanced
• 版本：@ct-jyjntc/pi-web@1.0.1

安装说明（本 Release 附件）

macOS

• 附件：Pi-Web-1.0.1-arm64.dmg（Apple Silicon）
• 签名：ad-hoc（未 Apple 公证）
• 若 Gatekeeper 拦截：

# 方式 1：右键 App → 打开 → 打开
# 方式 2：
xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• 附件：Pi-Web-1.0.1-x64.exe（Windows x64 NSIS 安装包）
• 双击安装，可自定义安装目录；安装后会创建桌面与开始菜单快捷方式。
• 如 SmartScreen 提示「Windows 已保护你的电脑」：点击「更多信息」→「仍要运行」。

---

English

Prepared from commits in v1.0.0..v1.0.1.

Added

• Model roles

  • default / smol / plan roles
  • Wired into settings, Git Review, Advisor, and related flows

• Git Review

  • /api/git/review prompt builder
  • ReviewSummaryCard for structured results
  • Git panel entry point

• Advanced Git

  • commit-split
  • conflict handling
  • merge API
  • expanded Git panel actions

• Project memory

  • retain / recall / reflect
  • heuristic + optional model synthesis
  • Settings Memory section
  • agent tools + system-prompt injection

• Advisor

  • /api/advisor review endpoint
  • Settings Advisor section

• Checkpoints

  • named session checkpoint API

• Collab sharing

  • read-only share links
  • /collab/[token] viewer + SSE
  • share button in Context panel
  • unread badge + jump-to-latest in CollabViewer

• Debug panel

  • source locations + stack traces
  • FileViewer focusLine navigation
  • dedicated Debug workspace tab

• LSP health & code intelligence

  • catalog + PATH discovery + install hints
  • /api/lsp health endpoint
  • agent LSP / code-intel tools
  • TypeScript built-in service fallback

• GitHub thin layer

  • read-only gh CLI wrapper
  • virtual refs pr://N, pr://N/diff, issue://N
  • /api/github + agent github tool

• Hashline-first edit

  • prefer omp-style hashline patches
  • classic edit still supported
  • kind/excerpt recovery on failure

• Usage statistics

  • UsagePanel: heatmap, trend, model breakdown
  • /api/usage session-file aggregation
  • per-file cache + soft TTL
  • settings load/hover prefetch

• Free providers & model disable

  • managed free providers (toggle-only)
  • disabled model flag keeps config but hides from pickers

• Settings reorganization

  • nav groups: App / Agent / Integrations
  • Agent / Memory / Network sub-panels
  • Manage providers + project-memory hints
  • scroll-to-top on section change

• Floating composer

  • docks over the transcript
  • dynamic underlay + ResizeObserver padding sync
  • mobile jump-to-bottom tracks composer height

• Network test

  • /api/network/test connectivity check

• Docs landing page

  • docs/index.html with light/dark theme
  • macOS/Windows download cards from latest GitHub release
  • compressed screenshots, favicon, motion, upstream attribution

Fixed / Improved

• Composer shell radius/shadow polish; tighter end padding
• Remove nested pre styling and code-block drop shadows
• Softer focus rings; inputs use unified border-only focus
• Container-query collapse for tabs/toolbars
• Settings UI consolidation
• Debug panel styling aligned with Context panel
• Chat header uses icon image instead of Pi glyph
• Package description + README/LICENSE attribution updates

Internal

• New modules for memory, roles, GitHub, LSP, hashline edit, advisor, collab, usage, free providers, git review/split/conflict, node inspector, etc.
• Expanded agent tool surface (memory / github / edit / code-intel / debug / advanced)
• Version: @ct-jyjntc/pi-web@1.0.1

Install Notes

macOS

• Asset: Pi-Web-1.0.1-arm64.dmg (Apple Silicon)
• Signing: ad-hoc (not Apple notarized)
• If Gatekeeper blocks:

xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• Asset: Pi-Web-1.0.1-x64.exe (Windows x64 NSIS installer)
• Run the installer; you can choose the install directory. Desktop and Start Menu shortcuts are created.
• If SmartScreen says "Windows protected your PC": click "More info" → "Run anyway".

v1.0.0

中文

基于 v0.8.2..v1.0.0 的提交整理。首个 1.0.0 正式版桌面客户端。

新增

• Hermes 风格 Bash 工具

  • 前台 / 后台执行分流（background 参数）
  • 拒绝误用的前台长任务调用
  • bash-command-classification 前台护栏逻辑
  • 主动触发 subagent 委托语言（ensure-subagent-delegation）
  • PTY 会话 kill 改为进程组信号，清理更彻底

• Todo Widget 可见性开关

  • 设置项 showTodos 控制 todo 扩展面板显示
  • 按最新 turn 使用情况过滤
  • 兼容 rpiv-todo 格式解析

• 通知体验增强

  • 完成音与桌面通知独立开关
  • 切换时请求系统通知权限并展示样例
  • Electron 通知支持点击聚焦窗口
  • 可见性变化时重载通知偏好（无需整页重挂载）

• Git 面板批量操作

  • 一键 Stage All / Discard All
  • 空路径保护，避免误调用 API

• 草稿迁移

  • 新会话草稿 new:<cwd> 可转移到真实 session id
  • 首次发送后输入框内容不再被清空

修复

• SSE / 会话生命周期

  • 事件流连接超时、中止与完整清理
  • 发送失败时回滚乐观消息（不限于连接错误）
  • 启动超时中销毁终端会话
  • extension binding 失败后可重试
  • wrapper 销毁时中止进行中操作并发送 session_destroyed
  • SSE 重连指数退避（最多 6 次），避免 tight reconnect 循环
  • 丢弃迟到的 SSE / loadSession 结果，防止旧 run 复活流式气泡
  • 分支切换时丢弃过期 context 响应

• 会话并发与持久化

  • 拒绝并发 prompt（多标签 / 重叠 POST）
  • busy 时禁止 fork
  • 已销毁 wrapper 不再重置 idle timer
  • 首条助手消息前也确保 .jsonl 落盘，避免 idle 销毁后 ghost session id
  • 删除会话级联 reparent 前先销毁子 wrapper，并用原子 rename 写回

• 配置安全

  • models.json 损坏时返回 500 + corrupt，防止 UI 用空配置覆盖
  • models.json 原子写入（tmp + rename）
  • skill 的 disable-model-invocation 切换先剥离旧 key，避免 YAML 重复键
  • 文件内容加载增加 request id，快速切换路径时不串数据

改进

• 设置页通用 / 外观 / MCP 分区滚动与 overflow 修复
• UI 圆角统一；去掉设置输入框硬编码 borderRadius: 0
• 移除废弃的 /api/cwd/exec、旧 SettingsConfig 弹层及相关死代码
• ChatWindow 用户输入提取对非数组 content 更稳健
• MessageView / FileViewer / ModelsConfig 加载与错误路径加固

内部调整

• 新增：bash-command-classification、ensure-subagent-delegation 及测试
• 强化 rpc-manager、useAgentSession、draft-store、session-reader
• 版本：@ct-jyjntc/pi-web@1.0.0

安装说明（本 Release 附件）

macOS

• 附件：Pi-Web-1.0.0-arm64.dmg（Apple Silicon）
• 签名：ad-hoc（未 Apple 公证）
• 若 Gatekeeper 拦截：

# 方式 1：右键 App → 打开 → 打开
# 方式 2：
xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• 附件：Pi-Web-1.0.0-x64.exe（Windows x64 NSIS 安装包）
• 双击安装，可自定义安装目录；安装后会创建桌面与开始菜单快捷方式。
• 如 SmartScreen 提示「Windows 已保护你的电脑」：点击「更多信息」→「仍要运行」。

---

English

Prepared from commits in v0.8.2..v1.0.0. First 1.0.0 stable desktop release.

Added

• Hermes-style bash tool

  • Foreground / background execution split (background param)
  • Reject misused long-running foreground calls
  • Foreground guardrails via bash-command-classification
  • Proactive subagent-delegation language (ensure-subagent-delegation)
  • PTY kill uses process-group signals for cleaner teardown

• Todo widget visibility toggle

  • showTodos setting controls extension todo panels
  • Filter by latest-turn usage
  • Parse rpiv-todo format

• Notification UX

  • Separate completion-sound and desktop-notification toggles
  • Request permission + sample notification on enable
  • Electron notifications click-to-focus the window
  • Reload prefs on visibility change without remount

• Git bulk actions

  • Stage All / Discard All
  • Empty-path guards

• Draft transfer

  • Promote new:<cwd> drafts onto the real session id
  • Keeps typed text after the first send

Fixed

• SSE / session lifecycle

  • Proper stream cleanup, abort, and connect timeout handling
  • Roll back optimistic messages on any send failure
  • Destroy terminal sessions on startup timeout
  • Retryable extension binding after failure
  • Abort in-flight work and emit session_destroyed on wrapper teardown
  • Exponential SSE reconnect backoff (max 6 attempts)
  • Drop late SSE / loadSession results from older runs
  • Drop stale context responses during rapid branch switches

• Session concurrency & persistence

  • Reject concurrent prompts (multi-tab / overlapping POSTs)
  • Block fork while busy
  • Never revive idle timers on destroyed wrappers
  • Persist .jsonl before the first assistant message (no ghost session ids after idle destroy)
  • Destroy child wrappers before cascade reparent; atomic rename writes

• Config safety

  • Corrupt models.json returns 500 + corrupt instead of empty overwrite bait
  • Atomic models.json writes (tmp + rename)
  • Skill toggle strips existing disable-model-invocation key first (no duplicate YAML keys)
  • File content loads use request ids to avoid path-switch races

Improved

• Settings page scrolling/overflow for general, appearance, MCP
• Consistent border-radius tokens; remove hardcoded zero radii on settings inputs
• Remove dead /api/cwd/exec, legacy SettingsConfig, and related code
• More robust ChatWindow user-text extraction for non-array content
• Hardened load/error paths in MessageView / FileViewer / ModelsConfig

Internal

• New modules: bash-command-classification, ensure-subagent-delegation (+ tests)
• Hardened rpc-manager, useAgentSession, draft-store, session-reader
• Version: @ct-jyjntc/pi-web@1.0.0

Install Notes

macOS

• Asset: Pi-Web-1.0.0-arm64.dmg (Apple Silicon)
• Signing: ad-hoc (not Apple notarized)
• If Gatekeeper blocks:

xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• Asset: Pi-Web-1.0.0-x64.exe (Windows x64 NSIS installer)
• Run the installer; you can choose the install directory. Desktop and Start Menu shortcuts are created.
• If SmartScreen says "Windows protected your PC": click "More info" → "Run anyway".

v0.8.2

中文

基于 v0.8.1..v0.8.2 的提交整理。

新增

• 全屏设置页（SettingsPage）

  • 分区导航：通用 / 外观 / 模型 / 技能 / MCP
  • 嵌入 ModelsConfig、SkillsConfig、McpConfig 面板
  • 支持分段控件与完整中英文本地化

• 外观设置

  • 主题模式：浅色 / 深色 / 跟随系统
  • UI 字号调节（布局条高度保持固定）
  • 代码高亮主题（亮色 / 暗色分别配置）
  • 代码行号开关、自动换行、代码字号
  • 代码主题实时预览（appearance store 即时生效）

• 网络设置（Electron 读取，重启生效）

  • HTTP(S) 代理
  • 代理旁路（NO_PROXY）
  • 自定义 CA 证书（NODE_EXTRA_CA_CERTS）

• 桌面 / 通知

  • 完成提示音开关
  • 桌面通知（agent 运行结束）
  • 通知声音独立开关
  • Electron 原生 Notification IPC

• Agent 默认行为

  • 新会话默认 thinking level
  • 默认展开 thinking 块
  • 默认显示 todo widgets

• 终端偏好

  • 自定义终端字体
  • 继承 login shell 环境（PATH / 代理等）

• Electron 高级选项

  • 禁用硬件加速（GPU）
  • 后台自动检查更新

• MCP 配置管理

  • 新增 /api/mcp 与 McpConfig UI
  • 支持 agent / 全局 / 项目级 MCP 服务列表
  • 增删改、禁用状态、适配器状态展示

• 项目信任流（Project Trust）

  • 首次打开项目时信任确认对话框
  • 未信任项目限制敏感资源访问
  • 技能 / 文件访问检查加固

• 上下文用量（Context Usage）

  • 估算会话 token 用量与上下文窗口
  • 输入区用量环可打开 Context 面板
  • 冷启动会话也能显示上下文估算
  • Compact 控件迁入上下文工作区

• PTY 会话增强

  • 来源追踪、命令元数据
  • 列表 / 过滤端点
  • 终端面板布局与指标改进
  • agent bash 与 PTY 联动（agent-bash-pty）

• 自定义窗口控件

  • 用渲染进程 caption 按钮替代系统 titleBarOverlay
  • Win/Linux 标题栏留白与平台样式修复

修复

• 恢复 Electron locales，避免打包后语言包缺失
• 完善 Windows 打包（dist:win、NSIS、locale 别名）
• 修复 Win/Linux 标题栏被系统按钮遮挡
• 请求安全校验增强（project trust / 资源边界）

改进

• 包名与仓库归属迁移到 @ct-jyjntc/pi-web / ct-jyjntc/pi-web
• appId 调整为 com.ct-jyjntc.pi-web
• README 重写：功能总览、徽章、安装说明简化，去掉上游 fork 说明
• 设置项统一落盘到 ~/.pi/agent/pi-web.json，Electron 启动时读取网络 / GPU 相关项
• 主题系统支持 system 模式，并与外观设置双向同步
• 代码高亮与文件预览跟随外观设置（主题 / 字号 / 行号 / 换行）

内部调整

• 新增模块：appearance-store、mcp-config、project-trust、context-usage、compact-action-store、agent-bash-pty
• 扩展 web-settings schema 与 /api/web-settings 读写
• Electron main/preload 增加通知、主题同步、网络环境注入
• 发布版本：@ct-jyjntc/pi-web@0.8.2

安装说明（本 Release 附件）

macOS

• 附件：Pi-Web-0.8.2-arm64.dmg（Apple Silicon）
• 签名：ad-hoc（未 Apple 公证）
• 若 Gatekeeper 拦截：

# 方式 1：右键 App → 打开 → 打开
# 方式 2：
xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• 附件：Pi-Web-0.8.2-x64.exe（Windows x64 NSIS 安装包）
• 双击安装，可自定义安装目录；安装后会创建桌面与开始菜单快捷方式。
• 如 SmartScreen 提示「Windows 已保护你的电脑」：点击「更多信息」→「仍要运行」。

---

English

Prepared from commits in v0.8.1..v0.8.2.

Added

• Full-screen Settings page

  • Sections: General / Appearance / Models / Skills / MCP
  • Embeds Models, Skills, and MCP panels
  • Segmented controls + full EN/ZH i18n

• Appearance settings

  • Theme mode: light / dark / system
  • UI font size (chrome heights stay fixed)
  • Separate light/dark code themes
  • Line numbers, soft wrap, code font size
  • Live preview via appearance store

• Network settings (Electron, restart required)

  • HTTP(S) proxy
  • Proxy bypass (NO_PROXY)
  • Custom CA cert path (NODE_EXTRA_CA_CERTS)

• Desktop / notifications

  • Completion sound toggle
  • Desktop notifications on agent end
  • Separate notification sound toggle
  • Electron native Notification IPC

• Agent defaults

  • Default thinking level for new sessions
  • Expand thinking blocks by default
  • Show todo widgets by default

• Terminal preferences

  • Custom terminal font
  • Inherit login-shell environment

• Electron advanced options

  • Disable hardware acceleration
  • Background auto update checks

• MCP configuration management

  • /api/mcp + McpConfig UI
  • Agent / global / project server lists
  • Create/update/remove/disable + adapter status

• Project trust flow

  • Trust dialog on first open
  • Gate sensitive resources until trusted
  • Hardened skills/file access checks

• Context usage

  • Token / window estimates for sessions
  • Usage ring opens Context panel
  • Cold-open estimation support
  • Compact controls moved into context workspace

• PTY session enhancements

  • Source tracking + command metadata
  • List/filter endpoints
  • Terminal panel layout/metrics improvements
  • Agent bash ↔ PTY integration

• Custom window controls

  • Renderer caption buttons instead of system titleBarOverlay
  • Win/Linux titlebar padding / platform chrome fixes

Fixed

• Restore Electron locales after packaging
• Windows packaging polish (dist:win, NSIS, locale aliases)
• Prevent caption buttons from covering titlebar chrome
• Stronger request-security boundaries with project trust

Improved

• Package/repo ownership moved to @ct-jyjntc/pi-web / ct-jyjntc/pi-web
• appId → com.ct-jyjntc.pi-web
• README rewrite (feature overview, badges, simpler install, no fork notice)
• Settings persisted in ~/.pi/agent/pi-web.json; Electron reads network/GPU on startup
• System theme mode with bidirectional appearance sync
• Code highlighting / file preview follow appearance settings

Internal

• New modules: appearance-store, mcp-config, project-trust, context-usage, compact-action-store, agent-bash-pty
• Expanded web-settings schema + /api/web-settings
• Electron main/preload: notifications, theme sync, network env injection
• Release version: @ct-jyjntc/pi-web@0.8.2

Install Notes

macOS

• Asset: Pi-Web-0.8.2-arm64.dmg (Apple Silicon)
• Signing: ad-hoc (not Apple notarized)
• If Gatekeeper blocks:

xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• Asset: Pi-Web-0.8.2-x64.exe (Windows x64 NSIS installer)
• Run the installer; you can choose the install directory. Desktop and Start Menu shortcuts are created.
• If SmartScreen says "Windows protected your PC": click "More info" → "Run anyway".

v0.8.1

中文

基于 v0.8.0..v0.8.1 的提交整理。

桌面客户端

• 新增完整 Electron 桌面应用（主进程 / preload / 打包脚本）。
• macOS arm64 DMG / Windows x64 安装包内置 Node 运行时与 pi CLI，用户无需本机预装 Node。
• 打包时完整叠加 @earendil-works/* 依赖树与 node-pty 原生预构建，避免动态导入失败。
• 修复 macOS 路径、环境变量与子进程 PATH，保证 npm / pi 在桌面端可用。
• 按平台适配标题栏 / 侧边栏样式（含 macOS traffic lights 区域）。

新增

• 设置面板：统一主题、语言、会话标题模型等偏好（SettingsConfig + /api/web-settings）。
• 会话标题模型可配置：支持指定 utility model，自动命名失败时有回退策略。
• Git 工作区面板：分支、stage / unstage、commit、pull / push、discard、diff 全流程。
• AI / 启发式提交信息：空提交时用启发式；支持「生成」走 AI 草稿（可含 unstaged 上下文）。
• 内置终端（PTY）：cwd 下交互终端，支持 resize / 输入 / SSE 事件流。
• 命令执行 API：/api/cwd/exec 在受控 cwd 内执行命令。
• 目录选择器：DirectoryPicker + /api/cwd/browse，便于选择工作目录。
• 图片输入：模型支持图像附件，聊天输入与附件链路同步更新。
• 权限模式：ask / full 权限切换与相关 UI widgets。
• 扩展 Widgets：todo 列表、subagent、通用扩展面板展示。
• 插件管理增强：npm 注册表搜索、安装面板布局与检索优化。
• 中英本地化：界面、技能、agent 消息、权限与设置文案 i18n。
• 消息展开：长用户消息可折叠 / 展开。
• 上下文面板：会话上下文查看（ContextPanel）。
• 应用更新检查：/api/app-update + 版本追踪。
• 安全加固：上传体积限制、bounded form data、路径安全校验、请求安全检查。
• 内置包自动安装：permission / subagents / todo / ask-user 等 first-party 包引导安装。

修复

• 修复会话自动命名 streamFn 参数键错误，避免 auto-name 500。
• 锁定并升级 Pi SDK（到 0.82.1），减少运行时不兼容。
• 改善模型运行时错误向上游 API 透出。
• 会话 key 使用 UUID，降低碰撞风险。
• 默认监听地址改为 127.0.0.1，降低误暴露风险。

改进

• 大量 UI 重构：ChatWindow / ChatInput / ModelsConfig / SkillsConfig 模态与菜单溢出处理。
• 隐藏消息列表原生滚动条，优化顶部栏与输入区响应式布局。
• 设计 token 统一：圆角 / 阴影 / 状态色走 CSS 变量。
• 主题跟随系统深色模式偏好。
• 流式更新节流、语法高亮共享、助手片段缓存，降低重渲染。
• 文件浏览器 Git 状态标记与 diff 视图联动增强。
• Markdown 渲染与代码高亮体验优化。
• README 中英文更新，并补充明暗主题截图。
• 新增 scripts/verify.mjs 与多项单元测试（路径安全、上传限制、目录浏览等）。

依赖 / 内部

• Pi 相关包升级至 @earendil-works/*@^0.82.1。
• Electron 打包链路：prepare-electron-standalone、bundle-runtime-node、bundle-pi-cli、electron-after-pack。
• package.json 增加 engines.node >= 22.19.0、verify 脚本与 postinstall pty 权限修复。
• 发布 npm 版本标记：@agegr/pi-web@0.8.1（本仓库桌面产物版本）。

安装说明（本 Release 附件）

macOS

• 附件：Pi-Web-0.8.1-arm64.dmg（Apple Silicon）
• 签名：ad-hoc（未 Apple 公证）
• 若 Gatekeeper 拦截：

# 方式 1：右键 App → 打开 → 打开
# 方式 2：
xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• 附件：Pi-Web-0.8.1-x64.exe（Windows x64 NSIS 安装包）
• 双击安装，可自定义安装目录；安装后会创建桌面与开始菜单快捷方式。
• 如 SmartScreen 提示「Windows 已保护你的电脑」：点击「更多信息」→「仍要运行」。

---

English

Prepared from commits in v0.8.0..v0.8.1.

Desktop Client

• Full Electron desktop app (main / preload / packaging scripts).
• macOS arm64 DMG / Windows x64 installer ships a portable Node runtime + pi CLI (no system Node required).
• Packaging overlays full @earendil-works/* trees and node-pty prebuilds for dynamic imports.
• PATH / env fixes so npm and pi work inside the desktop app.
• Platform-aware title bar / sidebar chrome (including macOS traffic-light inset).

Added

• Settings panel for theme, locale, and session title model preferences.
• Configurable title model with utility-model resolution and fallbacks.
• Git workspace panel: branches, stage/unstage, commit, pull/push, discard, diff.
• AI + heuristic commit messages (heuristic on empty; AI via Generate, optional unstaged context).
• Built-in PTY terminal under cwd with resize/input/SSE.
• Cwd command exec API (/api/cwd/exec).
• Directory picker + browse API for choosing working directories.
• Image input support for multimodal models.
• Permission modes (ask / full) and extension widgets (todo / subagent / generic).
• Plugin management improvements (registry search, layout, install UX).
• EN/ZH i18n across UI, skills, agent messages, permissions, settings.
• Message expand/collapse for long user messages.
• Context panel for session context inspection.
• App update check endpoint and version tracking.
• Security hardening: upload limits, bounded form data, path/request security checks.
• Builtin package bootstrap for first-party pi packages.

Fixed

• Session auto-name streamFn key mismatch (HTTP 500).
• Pi SDK pin/upgrade path to 0.82.1.
• Better model runtime error propagation.
• UUID-based session keys to reduce collisions.
• Default bind host 127.0.0.1 to reduce accidental exposure.

Improved

• UI refactors for chat, model/skills modals, overflow menus, responsive chrome.
• Hidden native chat scrollbar; cleaner top bar / input layout.
• Shared design tokens (radius/shadow/status colors).
• System dark-mode following theme.
• Streaming throttle, shared syntax highlighter, assistant fragment caching.
• File explorer Git markers + diff integration.
• Markdown / highlighting polish.
• README (EN/ZH) + light/dark screenshots.
• verify script and additional unit tests.

Internal / Dependencies

• @earendil-works/* → ^0.82.1.
• Electron packaging pipeline expanded (standalone prepare, runtime Node, pi CLI, afterPack).
• engines.node >= 22.19.0, postinstall pty perms fix.
• Version bump to 0.8.1.

Install Notes

macOS

• Asset: Pi-Web-0.8.1-arm64.dmg (Apple Silicon)
• Signing: ad-hoc (not Apple notarized)
• If Gatekeeper blocks:

xattr -cr "/Applications/Pi Web.app"
open "/Applications/Pi Web.app"

Windows

• Asset: Pi-Web-0.8.1-x64.exe (Windows x64 NSIS installer)
• Run the installer; you can choose the install directory. Desktop and Start Menu shortcuts are created.
• If SmartScreen says "Windows protected your PC": click "More info" → "Run anyway".