pi-trellis-kanban

在 pi coding agent 的 TUI 中查看当前目录下的 Trellis 任务看板。参考 dsh-trellis-kanban（DeepSeek Harness 插件）实现，数据模型对齐 Trellis Card 的核心看板。

功能

• /trellis-kanban：全屏四泳道看板 —— 规划 / 动手 / 收束 / 完结（阻塞任务归入「动手」并标红）
• 扫描范围：当前工作目录 + 下两级目录中所有包含 .trellis/tasks 的项目（跳过 node_modules、.git、dist 等）
• 任务卡：状态 + 优先级 + 细粒度阶段（含「规范注入未配」警告态）+ 进度条 + 待办进度 + 批次（父子）徽标 + 产物徽标（PRD/DESIGN/IMPL/调研/报告）+ 会话归属
• 项目筛选：多项目时顶部 chips，0/数字键或 [ ] 切换
• 详情翻页：Enter 打开任务详情 —— 说明 / 子任务 / 批次 / 产物 / 会话 + 全部文档（PRD / DESIGN / IMPLEMENT / 验收报告 / research）可切换阅读，滚动浏览
• 自动刷新：看板打开期间每 10s 静默重扫，R 手动刷新
• trellis_board 工具：把看板快照以文本形式交给 LLM（与命令互补）
• 纯只读，不修改任何 Trellis 文件；样式全部走 pi TUI 语义色（亮暗主题自适应）

安装

方式一：npm 安装（推荐，随 pi 包机制管理）

pi install npm:pi-trellis-kanban

安装后 /reload 生效，输入 /trellis-kanban 即可。也可用 pi -e npm:pi-trellis-kanban 临时试用；pi remove npm:pi-trellis-kanban 卸载。

方式二：本地链接（开发）

cd /Users/szy/workspace/pi-trellis-kanban
npm run install:local   # 链接到 ~/.pi/agent/extensions/trellis-kanban

在 pi 中执行 /reload 生效，然后输入 /trellis-kanban。

也可以手动链接：

mkdir -p ~/.pi/agent/extensions
ln -s "$(pwd)" ~/.pi/agent/extensions/trellis-kanban

使用

/trellis-kanban                 # 看板（当前目录）
/trellis-kanban ~/other/proj    # 看板（指定目录）

按键

按键	说明
↑ / ↓	上 / 下选择卡片
← / → / Tab / Shift+Tab	切换泳道
Enter	打开任务详情
R	手动刷新
[ / ] / 0-9	切换项目筛选
Q / Esc / Ctrl+C	退出

详情视图内：↑↓ 滚动、PageUp/PageDown 翻页、←→ 或数字键切换文档、Esc 返回看板。

结构

src/index.ts    扩展入口：注册 /trellis-kanban 命令与 trellis_board 工具
src/scanner.ts  Trellis 扫描器：项目发现 / task.json 解析 / 会话归属 / 文档收集
src/kanban.ts   TUI 看板组件：四泳道渲染、卡片导航、详情翻页（Component 接口）

开发

npm run test:scan     # 扫描器冒烟测试（真实 Trellis 项目）
npm run test:render   # 看板组件渲染测试（多宽度不超宽 + 导航/详情流程）

修改后 /reload 即可热加载（扩展位于自动发现目录，package.json 声明 pi.extensions 入口）。

发布到 npm

npm login                 # 首次需要，登录 npm 账号
npm version patch          # 版本 +0.0.1（发布前先更新）
npm publish               # 发布（包名未被占用，keywords 含 pi-package 可被 pi.dev 图库收录）
git push --tags && git push

包内 src/ 随包发布，scripts/ 测试不进包；运行时依赖（@earendil-works/pi-tui、typebox 等）由 pi 捆绑提供，声明在 peerDependencies 中不打进 tarball。

License

MIT