更新日志

完整更新日志请查看 GitHub 上的 CHANGELOG.md。

未发布

Windows 适配与脚本跨平台化

• 前后端补强 Windows 兼容性：
  • 路径分隔符统一支持 / 与 \（会话树、看板/仪表板项目显示、搜索插件等）
  • 项目过滤和路径匹配支持 Windows 大小写不敏感语义
  • 终端检测支持 PATH/PATHEXT 下的 powershell.exe / pwsh.exe / cmd.exe / bash.exe
  • 导出命令支持 pi / pi.cmd / pi.exe 的跨平台查找
• 构建与测试脚本全面去 Bash：
  • 仓库内 .sh 脚本全部迁移为 .mjs
  • 新增 scripts/script-utils.mjs 统一脚本工具能力
  • 文档站后处理脚本迁移为 website/scripts/postbuild.mjs
  • build:cli 保持 Node 跨平台入口（scripts/build-cli.mjs）

更新检查

• 新增基于 GitHub Releases 的更新检测流程
• 默认每天自动检测一次（无干扰）
• 新增 设置 → 更新，支持手动“立即检查更新”
• 新增右下角可关闭更新提示弹窗
• 新增更新说明弹窗，支持 Markdown 渲染

版本来源准确性

• 更新比较使用的应用版本改为构建期注入的 __APP_VERSION__
• 构建优先从 CI/tag 上下文与 git tag --points-at HEAD 获取版本，并提供 package 版本兜底
• 避免源码 package.json 与实际发布 tag 不一致导致的误报

会话视图滚动性能与稳定性

• 将虚拟滚动状态更新下沉到消息面板，避免滚动时触发父层级频繁重渲染
• 重构后通过 ref 桥接保留工具栏滚动能力（scrollToTop / scrollToBottom）
• 将消息虚拟列表 overscan 从 12 调整为 8，并对关键查看器组件增加 memo 化
• 优化动态高度测量与底部边沿触发加载更多行为，提升长会话滚动流畅度
• 修复缓存高度重复计入消息间距的问题，并回退“滚动中跳过测量”导致的文字叠层回归

子代理会话查看器

• 内联查看完整子代理对话，可点击卡片显示代理名称、模型、时长、Token 用量
• 带缩放+淡入动画的模态窗口渲染完整子代理 JSONL 会话
• 支持单次、并行、链式和管理操作模式
• 嵌套子代理支持——堆叠模态窗口，递增 z-index
• 主视图和子代理工具栏均支持思考/工具切换按钮（Cmd/Ctrl + T / Cmd/Ctrl + O）

Pi 配置设置面板

• 资源标签页：扫描和管理扩展、技能、提示词、主题，按作用域分组
• 设置标签页：与 Pi 源码完全对齐——5 个分组中的 25+ 项设置
• 版本历史作为独立标签页，带预览/恢复界面
• 渐进式模型加载，提供商/模型下拉菜单

统一搜索过滤栏

• 可复用的搜索 + 标签过滤栏，在列表、项目和看板视图间共享
• 桌面端侧边栏：始终可见；移动端：紧凑布局带切换按钮

i18n 清理

• 修复了 19 个组件文件中约 50 处硬编码的中英文字符串
• 为设置、仪表板、查看器、子代理和终端添加了缺失的翻译键

单端口架构（CLI）

• API、WebSocket（/ws）和嵌入式前端全部在端口 52131 上提供
• 远程访问只需一个隧道/代理

远程访问

• 非 localhost 访问的认证网关，支持 API Token 管理
• 通过 URL 参数进行远程配置（?server=、?token=、?transport=）
• SSE 传输，适合移动端的实时更新

移动端适配

• 完整响应式支持，适配 < 768px 屏幕
• 底部导航栏，5 个标签页
• 长按右键菜单、滑动切换看板、安全区域适配

其他亮点

• 连接状态横幅（断开/重连指示器）
• 基于差异的增量会话扫描和前端更新
• HTTP 传输 + SSE 作为 WebSocket 替代方案
• 可配置的绑定地址，控制网络暴露
• 会话内容 LRU 缓存，加速回退导航
• 终端恢复命令（Cmd/Ctrl + R）
• 基于 React Flow 的流程图可视化
• 多路径会话目录
• 带父子关系的层级标签
• 看板体验优化（项目过滤、右键菜单、未标记列）

---

v0.1.0 — 2026-01-30

包含核心功能的初始版本：

会话管理

• 从 ~/.pi/agent/sessions/ 扫描会话列表
• 使用 Pi HTML 模板的会话查看器
• 删除、导出（HTML/Markdown/JSON）和重命名会话

搜索与分析

• 跨用户和 AI 消息的全文搜索
• 统计仪表板（总会话数、消息数、热门项目）
• 搜索结果匹配数量徽章

用户体验

• 快捷键（Cmd/Ctrl + R、Cmd/Ctrl + F、Cmd/Ctrl + Shift + S、Esc）
• 深色模式界面
• 大型会话列表的虚拟滚动

技术基础

• Tauri 2 + Rust 后端，集成 SQLite 和 Tantivy
• React 18 + TypeScript + Vite 前端
• 导出、统计和搜索模块