pi-todo (英语)

A 类 轻型原子待办工具 Pi 编码代理。 。 。 . 模型用一个电话写完整的任务计划,而不是发布一个 create 调用每个任务.

它故意很小——只是基本的计划维持核心,没有 依赖性或设置菜单,没有倒塌/扩展,而且完全是一个轻量级 提醒( 前端调和微分, 参见 特征) (中文(简体) ). 现场计划 将 Pi 输入框上方作为只读的部件,当主机为 pi - agent - 桌面 也出现了 在桌面上 左向侧边栏 零额外配置的待办事宜面板 (桌面支持即将到来——见 桌面集成) (中文(简体) ).

特征

• 一次性制定完整的计划(snapshot语义)
• 三种状态: pending, (中文(简体) ), in_progress, (中文(简体) ), completed
• 稳定任务密钥; 基于省略的删除( 否) cancelled 或者说 archived 状态)
• baseVersion 禁止同时/不定期更新 stale-write
• 最多一个 in_progress 一次任务
• 原子验证——一个失败的书写永远不会变异状态
• 完成的待办事宜从不自动删除; 模型会浏览( 省略) 一旦全部工作内容完成
• 国家坚持工具成果细节和生存 /reload 财务报告和审定财务报表 /tree
• Pi 输入框上方的仅读部件, 使用 mark- down- style glyphs (单位:千美元)[ ] 待定, [-] 进取, [x] ;无倒塌/扩展
• 运行端调节提醒( 隐形): 当转弯时 (单位:千美元)agent_settled) 任务还在 in_progress,扩展记录 a 提醒并注入到 下一回合的系统提示 通过 before_agent_start。请提醒模型标记它们 completed 若为 实际工作已经完成—— 没有可见的聊天信息, 没有额外的代理运行, 无需切换。每转弯最多发射一次,然后跳过 计划没有 in_progress 任务,且无法循环(没有向导消息可读) - 继续.
• 当由 pi- agent-desktop 主持时, 即时计划也会在桌面上制作 左向侧边栏 待办事宜面板(桌面拥有) pi-agent-desktop:todo 部件扩展点)——不需要额外配置

安装

此扩展注册 todo 工具。 删除任何其他扩展名 拥有同样的 todo 安装前的工具名称,例如:

pi remove <the-other-todo-extension>
pi install npm:@capdiem/pi-todo

在不安装的情况下尝试 :

pi -e ./extensions/pi-todo/index.ts

工具计划

这个 todo 工具接受完整权威的任务列表. 现有任务可能省略未修改的字段;需要新密钥 subject 财务报告和审定财务报表 status中省略的任何当前密钥 tasks 永久删除 :

todo({
  baseVersion?: number,
  tasks: Array<{
    key: string,
    subject?: string,
    status?: "pending" | "in_progress" | "completed",
  }>,
})

示例

{
  "baseVersion": 0,
  "tasks": [
    { "key": "inspect", "subject": "Inspect the existing implementation", "status": "in_progress" },
    { "key": "implement", "subject": "Implement the optimized protocol", "status": "pending" },
    { "key": "verify", "subject": "Verify the implementation", "status": "pending" }
  ]
}

要手动工作, 包含每个当前键, 但只发送已更改的字段 :

{
  "baseVersion": 1,
  "tasks": [
    { "key": "inspect", "status": "completed" },
    { "key": "implement", "status": "in_progress" },
    { "key": "verify" }
  ]
}

主题从上一个快照继承;两个状态变化都承诺 解剖论.

要取消或删除工作, 请在下一个完整计划中省略其密钥 . 删除是永久的状态去除——没有 cancelled 状态或 存档记录.

语义

• key 是任务特性,而任务仍在计划中.
• 已存在的密钥继承了先前状态中省略的字段 .
• 新密钥需要 subject 财务报告和审定财务报表 status。 。 。 .
• 每张密钥 tasks 保留在计划中;省略当前键为 永久删除.
• 已完成的任务仍然可见( 穿透) , 直至模型完成 一旦全部工作内容完成,则省略其密钥.
• tasks: [] 清除计划.
• baseVersion如果提供,则拒绝 stale 写作.
• 最多一个任务是 in_progress 在一个时候.
• 校验为全- 或- 无; 失败的写不突变状态 .
• 使计划不变的写作不会打乱版本.

每一个成功的结果包括目前的版本和完整的计划.

渲染

任务列表以 Pi 输入框上方的只读部件提供 。 总是这样 显示完整列表( 不崩溃/ 扩展): 进度头加每个任务 标志下式状态格莱弗. in_progress 标签为粗体并已完成的标签 被击中通过。 部件只在计划存在时出现 .

桌面集成

由 pi - agent - 桌面 (单位:千美元) rpc 模式),在桌面中创建的活式计划 左向侧边栏 待办事宜面板 — 保留在视图中的聊天旁边的持久复选框列表 当你工作的时候.

计划被推到桌面上 待办部件扩展点 (由 pi- agent-desktop 定义;参见其 lib/todo-state.ts 财务报告和审定财务报表 docs/todo-widget.md(单位:千美元) setWidget 使用桌面保留密钥请求 "pi-agent-desktop:todo"一个JSON TodoTask 每个线。 桌面路线 直接进入它的侧边栏待办事宜面板。 火和忘却; 当桌面打开会话时, 此扩展名是 session_start 恢复 重现当前计划, 因此面板显示最新的快照 。 图瓦卢 保留其自己的组件部件(见渲染)并保持不变.

状态: 桌面侧面板即将到来 . 待办小组的支持 目前居住在 pi-agent-desktop 的地物分支上,没有 合并成一个发布. @capdiem/pi-todo 已经符合 pi-agent-desktop:todo 部件协议,所以一旦面板 船你得到 侧边栏渲染 零额外配置。 。 。 .

持久性

写入存储于工具结果 details打开 session_start 财务报告和审定财务报表 /tree 导航,扩展从活动方恢复最新的有效状态条目 树枝。 (对于后向相容性,它也承认隐藏的遗产) 自动删除的旧版本发布的自定义消息快照 任务。)

此最小扩展名确实 没有 处理收紧检查站:如果收紧 减少每个 todo 工具来自分支,计划重排为空( 模式本身的背景仍然包含计划文本). 添加压缩处理从 适合您工作流程的全功能待办事宜扩展.

许可证

麻省理工学院