dsh-side-chat-plus-plus

Codex 式多标签侧聊增强 —— 从 @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 的状态自动切换——侧栏关闭时主会话为 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=包名）

构建

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 安装（推荐）：

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

或从 GitHub 安装：

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

本地开发

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

验证清单（0.1.2）

主会话生成中选中已输出文本 → 「添加到对话 / 引用到侧聊」立即出现，引用到侧聊发送后无需等待立即开工；
连续添加多轮引用并重启 DSH → 引用批注与侧聊标签恢复；关闭侧聊或归档主会话 → 对应生命周期状态同步更新；
同时添加引用、图片和文件 → 附件在输入框上方按正常流排列，不重叠；
导出侧聊日志 → 文件附件桥确认接收时使用会话绑定 token，桥缺失或未确认时保留 DSH 原生引用回退；导出路径不允许通过符号链接或 junction 逃逸；
打开 dsh-better-sidebar → 侧聊浮于其上、主会话保持满宽不被挤压；折叠侧栏 → 主会话恢复让位；
消息结束后选中、批注 marker、导出/升级等原有功能不受影响。

License

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

dsh-side-chat-plus-plus

설치

README

dsh-side-chat-plus-plus

与原版的差异

目录结构

构建

安装

本地开发

验证清单（0.1.2）

License

관련 플러그인

dsh-web-ui (dsh-chat-recovery)

dsh-synapse

dsh-plugin-bridge

dsh-chat-import