Workpanel & Taskboard Suite (v0.2.0)

专为终端 AI Coding Agent 打造的可视化工作显示区、四列任务看板与项目规范备忘套件。

📌 项目介绍

在当下以终端交互为主的 AI Coding Agent（如 pi-agent、OpenCode、DeepSeek Harness、Codex 等）开发实践中，开发者往往面临“黑盒盲跑”、缺乏待办看板、会话间协同断层以及核心架构决策容易丢失等痛点。

Workpanel & Taskboard 套件 为解决这些问题而设计：通过纯文件驱动、轻量终端视口分割与独立伴侣窗口，在不依赖复杂重型 UI 库的前提下，为开发者与 AI Agent 之间构建起透明、高效、高颜值的交互工作流。

✨ 项目核心功能

1. 终端右侧 30% 持久工作面板 (Workpanel)

• 视口自适应分割：在终端右侧划分 30% 独立视口，自动适配左侧聊天区宽度，防止输入框折行重叠；
• 零 Emoji 极简工业风：采用 ANSI 粗体高对比度色彩与 Box-drawing 制表符，专业清晰；
• 智能避让与折叠：Agent 正在工作（Working）时面板自动收起，完成时平滑恢复；
• 虚拟视口滚轮滚动：独创 applyScrollView 虚拟滚动视口，完整支持鼠标滚轮上/下翻页与 [▲/▼] 交互式按钮。

2. 四列任务看板 (Taskboard)

• 全生命周期流转：支持 TODO ➔ DOING ➔ BLOCKED ➔ DONE 四列看板状态；
• 任务与工时追踪：支持优先级（P1~P4）、标签、预估工时、实际耗时累加与阶段性工作日志；
• 双模访问权限隔离：项目模式（当前项目）Agent 可随时主动查阅与编辑；全局模式严格需要用户明确授权。

3. 项目规范与架构备忘看板 (Projectboard)

• 单一真理来源 (panel-project.md)：统一维护项目规格、当前版本、Git 脏状态与未发布开发日记；
• 重要架构备忘录 (NOTES)：持久化记录核心设计决策（design）、架构规范（arch）与避坑指南（notice）；
• 跨会话工作日志 (Session Tracker)：工作前强制登记分支与涉及文件，结项前填写最终总结与多次修复反馈；
• 双击无缝切终端：双击会话条目联动 Konsole 自动聚焦或新开终端标签页。

4. 伴侣独立终端 (Companion Terminal)

• GUI / Web 模式伴侣：针对不支持终端分屏渲染的环境（如 Web 端或桌面端），通过 bin/panel-tui.mjs 在独立终端窗口展示看板；
• 毫秒级双向同步：通过 fs.watch 实时监听数据文件，Agent 无论在任何客户端操作，伴侣终端看板瞬间跳动刷新；
• 零性能损耗：独立终端进程运行，完全不占用 GUI 的 DOM 渲染管线。

🌐 适用范围

1. 终端 AI Coding Agent：
   • pi-agent：官方原生扩展支持，终端右侧 30% 视口无缝切分与全手势交互；
   • OpenCode：支持通过服务端插件注册 18 项 AI 工具、提示词规范注入与伴侣独立终端展示；
   • DeepSeek Harness (dsh) / Codex CLI / Claude Code：支持通过标准 Stdio MCP 服务或原生工具契约直接接入底层数据。
2. 终端与操作系统环境：
   • Linux / macOS / Windows (WSL)；
   • 支持主流现代终端模拟器（Konsole、Alacritty、Kitty、iTerm2、WezTerm、Windows Terminal 等）。
3. 交互形态：
   • 纯 TUI 沉浸式终端：右侧 30% 视口分割；
   • GUI / 桌面端协同：主界面聊天 + 伴侣独立终端看板分屏展示。

📥 安装与下载方式

方式一：直接下载发布包 (Server Release)

您可以在本站右侧或下方的 Releases (版本) 栏目直接下载由服务器托管的官方发布包：

• 版本号：v0.2.0
• 安装包文件：pi-workpanel-v0.2.0.tar.gz (151 KB)
• SHA-256 校验和：e67fc2b69af9ddb7cedbb3cba3c43f4a7a00f1551a9925df1d62229639c22834

安装步骤：

# 1. 解压至本地插件目录
mkdir -p ~/.pi/agent/plugins/pi-workpanel
tar -xzf pi-workpanel-v0.2.0.tar.gz -C ~/.pi/agent/plugins/pi-workpanel

# 2. 运行一键安装配置
cd ~/.pi/agent/plugins/pi-workpanel
node scripts/install.mjs