Repolode
提交项目
dbachelder

dbachelder/pi-btw

为 pi 添加 /btw 旁路对话功能，在主代理忙碌时并行运行带编码工具的子会话。

在 GitHub 查看
Star
218
Fork
60
未关闭 Issue
0
最近提交
4天前

这是什么？

pi-btw 是 pi 编码代理的一个扩展，新增 /btw 命令用于旁路对话。主代理仍在执行任务时，你可以直接提问，回答由一个独立的 pi 子会话给出，该子会话可以使用 read、bash、edit 和 write 工具。

旁路对话线程会在会话中保留，其内容以隐藏状态存储，不会进入主代理的上下文。用户可以在带上下文的普通线程、不继承上下文的 /btw:tangent，以及仅开放 read、grep、find、ls 的只读模式 /btw:ask 之间切换。还支持仅对 BTW 生效的模型和思考级别覆盖，并可通过 /btw:inject 或 /btw:summarize 把线程内容（或摘要）交还给主代理。

弹窗自带输入框和对话记录，可用快捷键在 BTW 与主编辑器之间切换焦点。通过 btw.json 可按用户或项目启用网页搜索等扩展工具，也支持 SSH 工作区模式。

核心功能

  • 01在独立的 pi 子会话中运行旁路对话，不打断主代理。
  • 02通过 /btw、/btw:tangent、/btw:ask 提供普通、无上下文和只读三种线程模式。
  • 03旁路对话内容不进入主代理后续上下文，但会在重载后保留。
  • 04可将完整线程或摘要注入回主代理。
  • 05支持仅对 BTW 生效的模型和思考级别覆盖。
  • 06可通过配置文件按需启用扩展工具，并支持 SSH 工作区。

适用场景

  • 主代理执行任务时，顺带追问代码库中的细节。
  • 单独探讨一个方案，确定后把结论注入主会话。
  • 在不冒修改风险的前提下，只读地审查近期改动。
  • 把某次有价值的问答保存为会话中可见的笔记。

快速上手

  1. 1

    通过 pi 从 npm 安装该扩展

    pi install npm:pi-btw
  2. 2

    在 pi 中重新加载以载入扩展

    /reload
  3. 3

    使用 /btw 命令提出旁支问题

    /btw what file defines this route?

使用前须知

  • 需要 pi 编码代理，它是 pi 扩展，无法独立运行。
  • 仅支持 Pi 0.85.1 至 1.x 版本。
  • 为 BTW 启用的扩展属于受信任代码，且未经沙箱隔离。
  • Super+/ 聚焦快捷键需要支持 Kitty 键盘协议的终端。

收录于专题

AI 编程助手与编码 Agent

标签

#ai#coding-agent#pi-extension#llm#typescript#developer-tools#side-conversation

常见问题

pi-btw 是什么？
为 pi 添加 /btw 旁路对话功能，在主代理忙碌时并行运行带编码工具的子会话。 pi-btw 是 pi 编码代理的一个扩展，新增 /btw 命令用于旁路对话。主代理仍在执行任务时，你可以直接提问，回答由一个独立的 pi 子会话给出，该子会话可以使用 read、bash、edit 和 write 工具。
pi-btw 可以免费使用吗？用的什么许可证？
pi-btw 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
pi-btw 还在维护吗？
活跃维护中。pi-btw 最近一次提交是在 2026年11月3日。
pi-btw 适合用来做什么？
主代理执行任务时，顺带追问代码库中的细节。 单独探讨一个方案，确定后把结论注入主会话。 在不冒修改风险的前提下，只读地审查近期改动。 把某次有价值的问答保存为会话中可见的笔记。
pi-btw 怎么安装和运行？
通过 pi 从 npm 安装该扩展: pi install npm:pi-btw 在 pi 中重新加载以载入扩展: /reload 使用 /btw 命令提出旁支问题: /btw what file defines this route?
在哪里获取 pi-btw？
源代码和安装说明在 GitHub 上：https://github.com/dbachelder/pi-btw

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目