pi-workpanel v0.2.75 发布说明 / Release Notes

中文 (Chinese)

概述

pi-workpanel v0.2.75 是一次专注于**空间利用率、视觉层级与高度自适应信息密度（Panel Density Adaptive Layout）**的体验革新版本。

在严格保持面板原生尺寸（默认占用终端 30% 宽度、DEFAULT_RESERVE_ROWS = 5、浮层 minWidth = 28）的前提下，全面梳理了各子模块（Workpanel、Taskboard、Projectboard、Tokenboard）的信息呈现与排版契约。

核心改进与特性

1. 视觉层级重构（不增加面板宽高）：
   • 移除原先冗余的深色/全宽高亮色块与双行分隔线，改用细线轨道、轻量加粗与状态短标签着色。
   • 统一模块间 1 行极简分隔线，辅以低对比度灰色边框与次级指示，大幅提升信息阅读舒适度。
2. Token 监控单图双模平滑切换：
   • 默认采用 Braille 2×4 字符级子像素绘制的高清折线图，连线更平滑直观；
   • 点击模块标题旁的 [切换] 按钮，即可在折线图与柱状图之间无缝切换；
   • 保留零基线、三档 Y 轴刻度、响应式 X 轴非碰撞日期标签以及所选点（◆）精确数值指示；支持点击 X 轴日期/月份原地钻取。
3. 高度自适应信息密度（Panel Density Adaptive Layout）：
   • 引入高度密度感知分档（<8 行极简摘要、8~14 行紧凑视图、>=15 行完整视图）。
   • Tokenboard 防饥饿保障：安全将模块最小高度下调至 7 行；矮视口优先显示周期/模型、总用量、缓存读写比、端到端吞吐（含等待）与首响应等关键指标，图表紧随其后且随时可通过滚轮平滑滚动查阅。
   • Taskboard 今日任务预览：依视口高度自适应展现 1 / 2 / 5 条最优先的进行中/待办任务，窄宽下优先保障任务标题可见度。
   • 全局项目双击稳定性：全局多项目列表保持严格固定的单行几何坐标映射，彻底杜绝单次单击导致列表跳动重排、破坏双击启动会话终端的问题。

English

Overview

pi-workpanel v0.2.75 brings significant visual hierarchy refinement, unified Token line/bar chart toggling, and panel density adaptive layout without altering panel dimensions.

Key Highlights

1. Refined Compact Visual Hierarchy:
   • Streamlined title rails, subtle borders, and short foreground status badges replacing heavy full-width backgrounds and redundant spacer lines.
   • Clean 1-row separators between sections, maximizing usable rows within the fixed 30% terminal pane.
2. Unified Token Chart with Instant Toggle:
   • High-resolution 2×4 Braille sub-pixel line chart by default.
   • Instant in-place toggle between Line and Bar modes via the header [切换] action.
   • Zero baseline, responsive non-overlapping X-axis labels, and exact selected-point indicators with date/month drill-down.
3. Height-Adaptive Information Density:
   • Three distinct density tiers (<8 summary, 8-14 compact, >=15 full).
   • Safe minimum height budgeting down to 7 lines prevents module starvation in short terminals.
   • Core metrics (usage, throughput with waiting, TTFT) are prioritized first, with charts and detailed logs seamlessly accessible via scroll wheel.
   • Kanban focus queue adapts to 1, 2, or 5 active tasks based on height.
   • Stable row geometry in global projects view protects double-click Konsole session switching from layout reflows.

pi-workpanel Suite v0.2.71

中文

• 项目隔离修复：普通子目录不再继承家目录中的项目文档，防止误显示 pi-workpanel-suite。自动注册使用真实文档根目录，并清理无效项目记录。
• tok/s 计算修复：主指标采用有效实时输出 Token 总和除以对应调用总耗时，按时间加权，包含等待与思考，不包含后续工具执行。
• 可靠采样：首响应由真实非空文本、思考或工具参数增量触发；流式速率只作客户端观测估算，排除单次/突发接收与不可观测的隐藏推理。取消、错误和零耗时响应不计性能。
• 持久化与并发保护：修复消息 ID 关联时序，支持历史扫描先于实时性能入库，读改写全程加锁。
• 安全迁移：旧性能统计备份至 tokens.json.before-performance-v2.bak 后重置，保留历史 Token、缓存与去重记录。

升级说明：安装后重启所有 Pi 会话（退出后运行 pi -c）。没有可靠时间数据的历史速率显示 -，随后由实时调用重新累积；/tokens rescan 不能还原历史流式时间。

English

• Project isolation: Ordinary subdirectories no longer inherit home-directory project documents. Automatic registration uses the actual document root and prunes invalid records.
• Corrected tok/s: The primary metric is time-weighted sampled output tokens divided by end-to-end call time, including waiting and reasoning but excluding subsequent tool execution.
• Reliable probes: First-response latency uses real non-empty text, thinking, or tool-argument deltas. Streaming rates are client-observed estimates, excluding single/burst deliveries and unobservable reasoning. Failed, aborted, and zero-duration responses do not contribute performance samples.
• Persistence and concurrency: Fixed finalized message-ID association, independent performance deduplication, and locked read-modify-write transactions.
• Safe migration: Legacy performance aggregates are backed up to tokens.json.before-performance-v2.bak and reset; historical token usage, cache counts, and deduplication records remain intact.

Upgrade: Restart all Pi sessions after installation (exit, then run pi -c). Historical records without timing show -; new live calls rebuild performance samples. /tokens rescan cannot reconstruct historical streaming timings.

Verification / 验证

npm test passes, including weighted throughput, migration, stream probes, finalized-message lifecycle and eight concurrent writers. Full-workspace type checking still reports existing errors outside the Token files; this release does not claim a clean whole-project type check.

pi-workpanel Suite v0.2.7

中文更新

• Token 历史统计修正：按会话记录去重，支持确定性全量重建；修正重复扫描导致的用量膨胀。
• 清晰的 XY 趋势图：日/月柱状图与折线图均显示 Token Y 轴刻度、日期 X 轴和范围标签，并保留周期点击下钻。
• 最近使用模型优先：模型用量与速率按最近使用时间排序，展示最近活动时间。
• 工作台完善：持续改进全局项目看板、面板折叠停靠与交互稳定性。

English

• Accurate token history: Deduplicates session entries and supports deterministic rebuilds, preventing inflated totals from rescans.
• Readable XY charts: Daily/monthly bar and line charts now show labeled token and date axes, with clickable period drill-down.
• Recently used models first: Model usage and performance groups are ordered by latest activity and show the last-used time.
• Workspace refinements: Further improvements to the global project board, panel docking, and interaction stability.

🌟 v0.2.5 更新亮点 (Highlights)

中文 (Chinese)

• 默认极简菜单：所有大区板块全面支持折叠，启动时默认以极简色带呈现，清爽不占地；
• 展开自动置底：展开某个长列表时自动排到最下方展开，上方导航菜单始终稳当好点，阅读顺畅自然；
• 全新双边框盒：在顶部呈现浅蓝色单线的“项目信息”与“今日任务队列”，信息一览无余；
• 视觉纯净化：彻底去除了所有多余的操作提示文字，板块间加入呼吸间隔，色彩温润不刺眼；
• 会话交互优化：全面修复了会话双击切终端与展开日志，自动过滤无对话的空白碎片文件。

English

• Default Minimalist Menu: All board sections are now collapsible and collapsed by default into an ultra-clean navigation stack;
• Sinking Expanded Units: Expanding a section automatically moves it to the bottom so reading flows naturally downward while top menus remain steady;
• Dual Bordered Info Boxes: Added crisp, light-blue single-line boxes for high-level project metadata and today's task queue;
• Clean & Calming Visuals: Purged distracting action hints and added breathing line margins between sections for a pleasant reading feel;
• Session Experience Refinement: Perfected double-click terminal switching and log expansion, automatically filtering out empty startup fragments.

Workpanel & Taskboard 套件 v0.2.1

• 新增列表过长自动按 10 单元收缩为组列表；
• 点击组列表展开/折叠该组内容；
• 覆盖 SESSIONS、LOGS、NOTES、KANBAN 任务与全局 PROJECTS。

Workpanel & Taskboard 套件 v0.2.0 发布

• 终端右侧 30% 持久工作面板 (Workpanel)
• 四列任务看板 (Taskboard, TODO / DOING / BLOCKED / DONE)
• 项目规范与架构备忘看板 (Projectboard, panel-project.md)
• 跨会话工作日志与工时统计 (Session Tracker)
• 零 Emoji 高对比度 ANSI 视觉设计
• 虚拟视口滚轮滚动与双击切终端标签页
• GUI 伴侣独立终端看板 (Companion Terminal)
• 跨 Agent 统一规范文档 (v1.0.0)