Bundle

dsh-side-chat-plus-plus

Codex 式多标签侧聊增强 —— 从 @ahggg/dsh-side-chat fork 的破坏式客户端重写

Source: anzhaohao
stars: 2 stars
License: MIT
Updated: Updated 13 days ago

Readme

# dsh-side-chat-plus-plus

Codex 式多标签侧聊增强 —— 从 [`@ahggg/dsh-side-chat`](https://github.com/AHGGG/dsh-side-chat) fork 的破坏式重写。



https://github.com/user-attachments/assets/5fefe33f-b4e8-42c5-adac-4d728fccfc0d



在原版「选中文字 → 侧聊追问」的基础上，做这些改进：

- **整条消息引用（Codex 式）**：鼠标悬停到任意一条历史消息，右上角出现「引用到侧聊」按钮，无需先选中文字，直接把整条消息作为引用上下文开一个新侧聊。
- **多标签侧聊**：每个侧聊是一个独立标签页，可同时保留多个、切换、关闭，互不干扰（原版同一时间只能有一个侧聊）。
- **生成中选中引用（零等待）**：主会话回复还在生成时，就能选中已输出的文本呼出「添加到对话 / 引用到侧聊」。引用到侧聊立即开工——fork 历史切在「用户问题之后、回复之前」（A3 中回合切点），引文随首条消息注入，不必等模型打完字；若宿主无法在流式回合中切点，会自动等待回合完成后再重试一次。
- **多轮引用与重启恢复**：主会话中的引用批注会随输入状态恢复；侧聊父子关系由 host 持久化，活动标签由浏览器会话状态记录，DSH host 重启后可继续使用；关闭或归档时同步清理生命周期状态。
- **附件不再互相遮挡**：引用胶囊、图片预览和文件附件统一进入输入框上方的正常文档流，按顺序排列，不依赖绝对定位叠放。
- **安全导出与兼容回退**：导出日志由 host 写入受控目录；兼容的文件附件桥可返回绑定当前会话的不透明 token，桥不可用或未确认接收时退回 DSH 原生文件引用。
- **双模式 dock**：右侧停靠布局随 [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 的状态自动切换——侧栏关闭时主会话为 dock 让位、内容完整可读；侧栏打开时侧聊作为最高图层只覆盖不让位，主会话保持满宽。
- **最高图层**：整个浮层 portal 到 `<body>`，脱离 DSH AppFrame 的 z-index 20 层，稳定盖过 dsh-better-sidebar 等 body 级浮层（z-index 40）。
- **去掉 More details**：删除原版选中工具栏里的「More details」按钮及其内联 prompt，只保留「Add to chat」（主会话引用）与「Ask in side chat」（侧聊追问）。

外观仍保留原版的右下角吸附浮层样式（`.dsh-side-chat-panel` 的 `position: fixed` 定位与主题 token）。

## 与原版的差异

| 维度 | `@ahggg/dsh-side-chat`（原版） | 本插件 |
| --- | --- | --- |
| host | 自带 `ArchivedForkSideChatService`（`sideChatArchived` RPC） | **自带 host**：`DshSideChatPlusPlusPlugin` 重新实现同一 `remote.sideChatArchived` RPC，不依赖官方插件 |
| 侧聊数量 | 单实例（打开新侧聊前必须先关旧的） | 多标签（N 个 `SideChatController`） |
| 引用入口 | 选中文字 → `More details` / `Ask in side chat` | 整条消息悬停按钮 + 选中文字工具栏 |
| 生成中选中 | 不允许（需等消息打完） | 允许，fork 走 A3 中回合切点零等待，失败自动等待重试 |
| 图层 | 依赖 DSH `shell.overlay` 槽位（z-index 20 层内） | portal 到 `<body>`，最高图层，覆盖 better-sidebar |
| 与 better-sidebar 共存 | 相互挤压 | 双模式：侧栏开→侧聊覆盖不让位；侧栏关→相互让位 |
| More details | 有 | 已删除 |

> Typert 描述符刻意保留上游的 wire 命名空间 `sideChatArchived` 与 RPC 方法名（`createArchived` / `selectArchivedModel` / `closeArchived`），但包 id 改为 `dsh-side-chat-plus-plus`（`src/typert.ts` 的 `TYPERT.package`），Cordis 服务键改为 `sideChatPlusPlus`，避免与官方 `sideChat` 服务冲突。

## 目录结构

```
src/
  client/           客户端（多标签 + 整条消息引用 + 生成中选中引用 + 双模式 dock）
    rc6/Rc6SideChatOverlay.tsx  多标签外壳 + 引用按钮注入（portal 到 body）
    side-chat-controller.ts     单个侧聊状态机（每个 tab 一个实例）
    panel/side-chat-layout.ts   双模式 dock 布局（detect better-sidebar 开关）
    selection/                 选中捕获、normalizer（生成中放行）、工具栏、批注 marker
  host/             自带 host（从上游 host 复制）
    archived-fork-service.ts    ArchivedForkSideChatService（fork/archive 会话，A3 中回合切点）
  shared/           共享类型与 wire schema
  index.ts          host 入口（Cordis 插件，重新实现 sideChatArchived RPC）
  remote.ts         Typert remote 贡献（客户端挂载面）
  typert.ts         Typert host 面（wire schema）
scripts/build.mjs   esbuild 编译 host + typert + remote + client
cordis.patch.yml    insert 声明（id=side-chat-plus-plus, name=包名）
```

## 构建

```powershell
npm run build
```

生成 4 个产物：

- `src/index.js` —— host（ESM，`@deepseek-ai/*` 与 `node:*` 保持 external，由 DSH host 解析）
- `src/typert.js` / `src/remote.js` —— Typert host/客户端面（`zod` 打进 bundle）
- `src/client.js` —— 浏览器 bundle（`window.__ModuleLoader__.load` 包裹，`react` 与 `@deepseek-ai/*` 客户端运行时 external）

`zod` 会从当前 DSH profile 探测并打进 bundle（见 `scripts/build.mjs` 的 `resolveZodEntry`）。

## 安装

从 npm 安装（推荐）：

```powershell
dsh plugin --profile web add dsh-side-chat-plus-plus
```

或从 GitHub 安装：

```powershell
dsh plugin --profile web add github:<owner>/dsh-side-chat-plus-plus
```

### 本地开发

```powershell
dsh plugin --profile web add "D:\Postgraduate_JilinUniversity\03_Sundries\02_DevLab\20260822-dsh-side-chat++"
# 修改源码后重新构建，再重启 dsh web
npm run build
```

### 验证清单（0.1.3）

- 选中文字 → 添加到对话 → 输入框**无占位行、无增宽**，Ctrl+A **看不到** `@__dsh_side_chat_annotations__`；引用只以胶囊卡片出现，正文不残留占位符；
- 发送后模型收到带 `<selected_context>` 的消息，气泡上引用胶囊正常显示，composer 胶囊清空；发送失败时引用保留不丢；
- 加引用后不发送、重启 DSH → 引用批注恢复；
- 点击「N 条引用」胶囊 → 悬浮卡片内长文本/URL 在边框内换行，超高出滚动条；
- 连续添加多轮引用并重启 DSH → 引用批注与侧聊标签恢复；关闭侧聊或归档主会话 → 对应生命周期状态同步更新；
- 同时添加引用、图片和文件 → 附件在输入框上方按正常流排列，不重叠；
- 导出侧聊日志 → 文件附件桥确认接收时使用会话绑定 token，桥缺失或未确认时保留 DSH 原生引用回退；导出路径不允许通过符号链接或 junction 逃逸；
- 打开 dsh-better-sidebar → 侧聊浮于其上、主会话保持满宽不被挤压；折叠侧栏 → 主会话恢复让位；
- 消息结束后选中、批注 marker、导出/升级等原有功能不受影响。

## License

MIT。本项目是 `@ahggg/dsh-side-chat`（MIT）的派生作品，归属说明见 [NOTICE](NOTICE)，上游许可证见 [LICENSE](LICENSE)。

Install

dsh plugin --profile web add github:anzhaohao/dsh-side-chat-plus-plus

Profile: web

This package builds from source on install. pnpm will ask you to allow its build script — that is permission to run the package’s code on your machine, outside the agent sandbox. Only allow sources you trust.
This source has no pinned commit, so a later push upstream changes what installs. Prefer pinning a commit.

Source