loster12520/dsh-btw

dsh-btw

⚠️ 仍在开发中（WIP）

本项目处于活跃开发阶段，尚未发布稳定版本（v0.1.0 以下）。API、命令行为、RPC 契约与 面板 UI 均可能随时变化；可能存在未修复的缺陷或未验证的边界情况。请勿用于生产环境， 升级前请阅读提交记录与 README 变更。欢迎提交 Issue 与 Pull Request 参与共建。

DSH 旁路问答插件：/btw <问题> 命令 + 居中弹窗面板。在独立会话分支中回答你的问题——分支可以查看主对话历史（创建时 seed + 每次提问注入增量），但只有只读 + web 搜索权限（write/edit/bash/pwsh/ssh_* 等写类工具全部下掉），问答内容不进入主对话上下文。对齐 Claude Code /btw 的旁路问答语义，并扩展了多轮对话、主对话增量同步、一键清空与每会话独立的居中弹窗面板。

功能

• /btw <问题> 命令：输入框直接旁路提问，命令系统消化（log-only 记录），不触发主模型；自动打开居中 BTW 面板并展示回答。
• /btw 无参命令：仅打开面板并聚焦输入框，不做其他事、不输出提示。
• 居中弹窗面板：类似 antd Modal，半透明遮罩覆盖右侧内容区（排除左侧侧边栏）；点击遮罩或 ✕ 关闭；多轮对话、问题/答案气泡、Ctrl+Shift+K 或「清空」按钮一键重置当前会话分支。
• 无常驻入口：不再有会话标题栏 BTW 按钮，面板只能通过 /btw 命令打开。
• 只读分支：分支通过 agents.create 创建为「裸 agent」，不注册进 subagent registry（GUI 不显示为子代理，不出现在子代理目录）；工具白名单 read / glob / grep / read_image / web_search，其余全局工具（写文件、执行命令、SSH 等）全部不可见。
• 查看主对话历史：分支创建时以主对话已完成 turn 为 seed；每次提问注入主对话增量（自上次同步水位之后的新消息），所以主对话的进展会持续同步到分支。
• 每会话独立分支：每个主会话各自维护独立的 btw 分支、历史、同步水位与串行队列；不同对话的 btw 问答完全隔离、互不污染。
• 统一问答历史：Host 维护 {id, role, text} 历史，面板轮询 btw/state 增量同步——命令路径的问答也会出现在面板，主对话命令卡片只显示一行提示。
• 不污染主上下文：分支是独立 Session，主对话的 LLM 上下文不含任何 btw 问答。

安装与使用

方式一：dsh plugin 一键安装（推荐）

前置：本机已安装 dsh CLI（dsh plugin 是 pnpm 的薄转发器，需 pnpm 在 PATH 上）。

在任意目录执行（路径用你的本仓库路径，绝对/相对均可）：

dsh plugin --profile web add <本仓库路径>

# 或从 GitHub 安装
dsh plugin --profile web add git+https://github.com/loster12520/dsh-btw.git

然后重启 dsh web（Host 半区改动需要重启；之后仅 Client 改动浏览器硬刷新即可）。

打包原理（对本仓库的配置说明）：

• dsh plugin --profile web add <路径> 等价于在 ~/.dsh/profiles/web 里执行 pnpm add <路径>， 随后按「已安装依赖的 package.json 是否声明 dsh.bundle.patch」自动把包加入 profile 的 bundle 层（dsh.profile.bundles），无需手动改任何配置。
• 本仓库 package.json 的声明：
  • dsh.bundle.patch: "./cordis.patch.yml" —— bundle 层，挂载插件行 {id: dsh-btw, name: dsh-btw}（等价于在 profile 的 cordis.patch.yml 手写该行）；
  • dsh.client: { platform: "web" } + exports["./client"]（dist/client.js）—— Client 半区由 client-modules 扫描并注入浏览器；
  • main: src/host.js —— Host 半区，注册 /btw 命令与 /api/dsh-btw/* HTTP 路由（带浏览器信任围栏）。
• 手动静态挂载（agent preset 插件行）同理可用：- id: dsh-btw / name: dsh-btw，详见 cordis.yml。