安装

pi install npm:@juicesharp/rpiv-todo

安装后重启 Pi 会话，再运行 /todos 确认扩展已经加载。

快速开始

增加一个带测试的 repository 层，并用 todos 跟踪工作。
/todos

模型调用 todo 工具后，输入框上方会出现实时面板。默认按 Ctrl+Shift+T 折叠或展开；/todos 随时打印按状态分组的完整列表。

你会获得什么

• 面板持续显示任务状态、当前执行项，以及已完成数与总数。
• 每次工具调用携带修改后的完整快照，列表能从会话分支重放，因此可跨 /reload 和压缩恢复。
• 完成项在当前 turn 内保留，下一个 turn 开始时移除；列表清空后面板自动消失。
• 超出行数预算时优先隐藏完成项，最后才截断未完成项，并明确提示隐藏数量。
• blockedBy 依赖在写入前验证，拒绝悬空依赖、自依赖和循环依赖。
• 并行会话按 session 隔离，子会话不能读取或覆盖前台列表。
• 安装可选的 @juicesharp/rpiv-i18n 后可使用九种本地化界面。

配置

可选配置文件位于 ~/.config/rpiv-todo/config.json，或 $XDG_CONFIG_HOME/rpiv-todo/config.json。扩展只读取该文件，不会自动写入。

{
  "maxWidgetLines": 8,
  "collapseKey": "alt+t"
}

要求

• 不需要 API 密钥、指定模型或原生依赖。
• 交互式会话会显示面板与 /todos；无界面运行仍可使用 todo 工具，但不渲染 UI。
• 配置文件缺失或格式错误时回退到默认值。
• 修改快捷键或 guidance 后需要执行 /reload。

参考资料

• todo 工具参考 ↗todo 的参数、状态机、响应结构与错误行为。
• 配置参考 ↗配置文件查找顺序、选项验证和快捷键语法。
• Overlay 与 /todos ↗面板生命周期、状态图标、溢出策略、命令输出与本地化。

相关扩展

• @juicesharp/rpiv-i18n ↗为本扩展的 UI 文案提供本地化，并增加 `/languages` 语言选择器。
• @juicesharp/rpiv-pi ↗一次安装 rpiv-todo 及其同系列扩展的整合包。

许可

采用 MIT License。