侧边分叉聊天 s11phere/dsh-btw-sidebar

dsh-btw-sidebar

像 Codex 的 /btw：把当前会话在最后一个完成轮次处分叉出一条会话，开在 DSH 原生右侧栏里继续聊。
官方会话界面与工具能力、真实副作用；主会话不被打断，主对话日志也不被污染。

/btw 这里为什么用 fork 而不是 spawn？
↓
右栏当前格出现标签页「侧边聊天 · 这里为什么用 fork…」，里面就是普通会话（输入框/工具/审批都在） ↓ 主会话继续跑；关掉面板 → 这条会话重新归档，从左侧列表消失

支持范围

| DSH | 0.1.7 系列。本仓库在 0.1.7-rc.2 上验证：Linux/WSL 端到端实际使用；Windows 验证到「安装 + 加载」（脚本、47/47 单测、dsh --dump-config 组合正常），面板交互建议自测一次 /btw。不做跨版本兼容 |
| Profile / App | web：需要原生右侧栏与客户端模块（dsh.client.platform = "web"，其他 app 下客户端半部不会加载）。headless / desktop profile 不适用 |
| Node | >= 22.5（engines；实测 v24） |
| OS | Linux / WSL ✅；Windows ✅（检出与 $DSH_HOME 跨盘符时必须用脚本，见下） |
| 可选依赖 | dsh-away-notify：装了才有「看着面板不打扰 + 点通知切回原会话并回到它的右栏那个 tab」。缺席时 /btw 照常可用，通知走默认行为（见 docs/notifications.md） |

安装

Linux / WSL（检出与 $DSH_HOME 同盘时普通 link 即可）：

dsh plugin --profile web add /mnt/f/project/tools/plugin/dsh-btw-sidebar

Windows：profile 默认在 C:\Users\\.dsh，检出若在别的盘（例如 F:），不要直接
dsh plugin add F:\...——pnpm 会装出一个解析不到的 junction，dsh plugin 只给一条误导性的
declares no dsh.bundle 警告且退出码仍是 0，插件重启后根本不加载；而且之后任何一次
pnpm install / dsh plugin add 都会把已经装好的插件弄坏。用脚本：

powershell -NoProfile -ExecutionPolicy Bypass -File scripts\install-windows.ps1
-Profile web 指定 profile（默认 web） -SkipInstall 只修不装（依赖已在 package.json 里时用） -WhatIfOnly 只报告，不改任何文件 -PluginDir 脚本是通用的：装/修别的插件也可以

原因、脚本行为与镜像目录说明见 docs/windows.md。

装完需要重启 dsh web（dsh.profile.bundles 只在启动时读取）；只改客户端半部时刷新页面即可。
cordis.patch.yml 的 insert: 行由 dsh plugin add 自动追加进 bundles，不要手写同 id 条目（会报 duplicate loader entry id）。

卸载：

dsh plugin --profile web remove dsh-btw-sidebar

用法

/btw 刚才那个 config 文件叫什么名字？

- 输入框立刻清空，右侧栏当前格出现「侧边聊天 · …」标签页，问题作为首条消息发出。
- 之后就在面板里正常聊天：工具调用、审批、附件、模型切换、停止，全部是官方行为。
- 关掉标签页 → 会话归档、从左侧列表消失；在左侧「已归档」视图里可以恢复它。

配置

在 profile 的 cordis.patch.yml 里按 id 覆盖（改配置需要重启 dsh web）：

- id: dsh-btw-sidebar
config:
titlePrefix: '侧边聊天' # 会话/标签页标题前缀 suppressNotifications: true # 面板显示在右栏且你正看着 dsh 时静音（默认开） debug: false # 打印诊断日志

suppressNotifications: false 只是不声明抑制规则（通知照弹），「点通知回到右栏 tab」不受影响。
语义、判定依据与降级行为见 docs/notifications.md。

文档

| 文档 | 内容 |
| docs/development.md | 三版实现的取舍与两次否决、架构、DSH 契约上的坑、测试与验收状态 |
| docs/limitations.md | 已知限制与平台硬约束 |
| docs/notifications.md | 与 dsh-away-notify 的集成：抑制/揭示语义、可选依赖的降级、开关 |
| docs/windows.md | Windows 跨盘符安装的坑、install-windows.ps1 行为、镜像目录 |
| docs/troubleshooting.md | 排障：页面起不来、踩过的三次 UI 事故、日志位置 |

开发

node --test # 47 项，全部离线：不碰网络、不读真实 home 目录、不调真实模型