dsh-side-chat-plus-plus
v0.1.3
Published
Codex 式多标签侧聊增强 —— 从 @ahggg/dsh-side-chat fork 的破坏式客户端重写
Downloads
487
Maintainers
anzhaofengReadme
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.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，上游许可证见 LICENSE。