BubbleChat

---

截图 / Screenshots

_{完整交互（约 11 秒）：选中一段文字 → 开分支 → 在气泡里提问 → 回答生成 → 收起后留下 ⑂N 锚点。
Full interaction (~11s): select text → open a branch → ask in the bubble → the answer arrives → collapsing leaves an ⑂N anchor.}

---

中文

这是什么

BubbleChat（分支对话）是 DeepSeek Harness 的客户端插件。它把「追问」变成一次就地操作：

1. 在对话里选中任意一段文字（AI 回答或你的提问都可以）；
2. 点浮出的「⑂ 开分支」；
3. 右侧弹出气泡面板，围绕这段文字提问；
4. 回答出现在气泡里，主对话的阅读线不被打断。

分支不是新建会话：问题会以「引用 + 你的问题」的形式回到同一个会话，所以模型拥有完整的上下文，回答能准确接上文；生成完成后，插件把回答的渲染结果复制进气泡，并把主转录里这次分支的轮次隐藏起来。

它解决什么问题

• 不想开新会话重讲一遍上下文：分支复用主对话的全部记忆，不需要把前文复制过去。
• 不想打断阅读线：直接在主对话里追问，回答会插在正文中间，之后回看原文很痛苦。分支把问答收到气泡里。
• 一段内容想从多个角度讨论：「为什么这样设计」「有没有反例」「换成 PyTorch 怎么写」可以分别挂在同一段文字上，互不干扰。
• 想随时回到原文：锚点标签留在原文旁边，一键定位，不靠翻聊天记录找。

功能一览

快速开始

环境要求

• DeepSeek Harness 0.2 预览版（桌面端或 Web 客户端）
• 能安装第三方插件（「插件」面板可管理 profile 时即可）

安装方式 A：图形界面（推荐）

1. 打开 DeepSeek Harness，左侧进入「插件」；
2. 点「添加插件」；
3. 输入本仓库地址 https://github.com/makima-coder/BubbleChat，或本地目录的绝对路径；
4. 安装完成后启用 dsh-client-ui-branch-chat，按提示重启应用；
5. 对话输入框右下角出现蓝色 ⑂ 悬浮按钮即安装成功。

安装方式 B：命令行

# 从 Git 仓库安装
dsh plugin add https://github.com/makima-coder/BubbleChat

# 或从本地目录安装
dsh plugin add C:\path\to\BubbleChat

安装后重启 DeepSeek Harness。当前 DSH 版本不支持插件自动更新，升级时需要先卸载再安装新版本。

安装方式 C：手动写入 profile（排查问题时可参考）

编辑 ~/.dsh/profiles/desktop/package.json：

{
  "dependencies": {
    "dsh-client-ui-branch-chat": "link:C:/path/to/BubbleChat"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "dsh-client-ui-branch-chat"
      ]
    }
  }
}

lib/index.js 只是宿主侧的空插件，真正的界面在 lib/client.js，由 package.json 里的 dsh.client 声明自动注入浏览器侧。

使用

1. 在任意对话里选中一段文字，点「⑂ 开分支」；
2. 在气泡输入框里提问，Enter 发送，Shift + Enter 换行；
3. 回答出现在气泡中，主对话里对应的提问与回答轮次会被隐藏；
4. 点气泡右上角 × 收起；原文旁的 ⑂N 标签可随时重新打开；
5. 气泡里点 ⌂ 重置窗口位置与尺寸；点圆形「定位」按钮跳回原文并高亮；
6. 左侧列表可切换不同分支，× 删除某条分支（含其对话内容）。

工作原理

1）锚点 = 文本 + 位置指纹

创建锚点时不只记录文字本身，还记录：所在轮次（data-chat-turn）、该轮文本总长、选区起始字符偏移、这段文字在该轮中第几次出现、以及前后各 20 字的上下文指纹。恢复位置时按「前后指纹 → 前指纹 → 后指纹 → 偏移 → 第 N 次出现 → 首次出现」依次尝试，最后用 Range.toString() 严格校验还原出来的文本是否就是原文；不一致就返回失败，宁可不跳也不跳错。

2）分支消息

发送时把问题包装成带隐藏标记的消息回到同一会话：

⟦分支·<anchorId>⟧关于「<选中原文>」

<你的问题>

anchorId 让插件之后能认出「哪一轮是我这条分支」。注意：这一步是真实写入会话上下文的，所以分支回答拥有完整记忆；「主对话里看不到」只是显示层的隐藏。

3）回答捕获

插件轮询会话运行状态，等本轮生成结束后，在主转录里按标记找到该分支对应的回答容器，克隆其 DOM，移除过程性噪声（data-step-process、代码块按钮等），再注入气泡。因此气泡里的回答与主对话中渲染完全一致。

4）隐藏主对话里的分支轮次

插件只创建并维护一个自己独占的 <style id="branch-chat-hide">，内容是：

[data-chat-turn="N"]:not(:has([data-chat-turn])) { display: none !important; }

只隐藏「叶子轮次」，避免误伤包含多轮的祖先容器；用户提问轮次还要确认确实包含本条分支的标记才会被隐藏。清空这条样式即可立刻恢复，主转录的 DOM 从未被改写。

5）窗口与状态

面板位置/尺寸、输入区高度、左栏宽度、悬浮按钮位置、锚点与全部对话都持久化在 localStorage；刷新页面或重启应用后原样恢复。

项目结构

BubbleChat/
├── lib/
│   ├── index.js          # 宿主侧入口（空实现，仅为加载占位）
│   └── client.js         # 全部 UI 与逻辑（浏览器侧，单文件）
├── cordis.patch.yml      # bundle patch：单独安装时插入本插件
├── package.json          # DSH 插件清单（dsh.bundle / dsh.client）
├── docs/images/          # README 截图
├── LICENSE
└── README.md

已知限制

• 依赖 DSH 客户端的 DOM 约定（data-chat-turn、data-turn-process-answer、data-chat-group-part 等）。DeepSeek Harness 大版本升级可能改动这些标记，届时需要适配。
• 只测过 Web 客户端（dsh.client.platform = "web"，桌面端渲染的也是 Web 客户端）。
• 分支问答真实占用会话上下文：隐藏是显示层的，长对话里开很多分支仍会累积 token。
• 回答捕获依赖主会话空闲：插件会等主会话本轮结束再抓取；若抓取失败会提示「回答已生成，但未能捕获（可点『定位』）」，此时该轮分支内容会留在主对话中可见。
• 状态存在浏览器本地：localStorage 按浏览器/设备存储，不跨设备同步；清空站点数据会丢失锚点与分支对话。
• 暂不支持分支导出、分享或重命名。

开发与调试

• 没有构建步骤：lib/client.js 是被宿主直接加载的浏览器端模块，改完重启应用即可生效。
• 启动日志：浏览器控制台会打印 [branch-chat] 已加载。
• 本地状态：localStorage 的 dsh-branch-chat/v5，调试时可手动清空以重置全部锚点。
• 改动建议集中在一个文件里，保持「不修改主转录 DOM」的约束；隐藏一律通过插件独占的 <style>。
• 提交前的手动测试清单：选区开分支 → 提问 → 回答渲染 → 收起后锚点标签 → 点击定位 → 刷新页面后状态恢复 → 删除分支。

兼容性

贡献

欢迎 Issue 与 PR。由于插件依赖 DSH 的客户端 DOM 约定，提交前请说明你测试所用的 DSH 版本与场景；改动尽量小而聚焦，方便 review。

License

MIT © 2026 makima-coder

---

English

What it is

BubbleChat is a client plugin for DeepSeek Harness that turns follow-up questions into an in-place gesture:

1. Select any passage in a conversation — the assistant's answer or your own message;
2. Click the floating “⑂ 开分支” button;
3. A bubble panel opens on the right, anchored to that passage;
4. Your follow-up Q&A lives inside the bubble, and the main transcript stays untouched.

A branch is not a new session. The question is sent back to the same conversation as a quoted, marker-tagged message, so the model keeps the complete context. Once the answer finishes, the plugin clones its rendered output into the bubble and hides the branch turns in the main transcript.

Why

• No context re-explaining — branches reuse the main conversation's memory; nothing needs to be pasted again.
• No broken reading flow — asking directly in the main thread inserts the answer in the middle of the transcript. Branches keep Q&A out of the reading line.
• Multiple angles on the same passage — “why this design?”, “any counterexample?”, “how would this look in PyTorch?” can each hang off the same quote independently.
• Always find the source again — an anchor badge stays next to the quoted text; one click locates it.

Features

Quick start

Requirements

• DeepSeek Harness 0.2 preview (desktop app or web client)
• Ability to install third-party plugins (an installable/managed profile)

Install, option A — in the app (recommended)

1. Open DeepSeek Harness → Plugins in the sidebar;
2. Click Add plugin;
3. Enter this repository's URL https://github.com/makima-coder/BubbleChat, or the absolute path to a local clone;
4. After installation, enable dsh-client-ui-branch-chat and restart the app;
5. A blue ⑂ floating button appears at the bottom-right of the composer when it is active.

Install, option B — CLI

dsh plugin add https://github.com/makima-coder/BubbleChat   # from Git
dsh plugin add C:\path\to\BubbleChat                        # from a local folder

Restart DeepSeek Harness afterwards. The current DSH release does not auto-update plugins — uninstall and reinstall to upgrade.

Install, option C — profile manifest (useful when debugging)

Edit ~/.dsh/profiles/desktop/package.json:

{
  "dependencies": {
    "dsh-client-ui-branch-chat": "link:C:/path/to/BubbleChat"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "dsh-client-ui-branch-chat"
      ]
    }
  }
}

lib/index.js is an empty host-side half; the real UI is lib/client.js, injected into the browser half by the dsh.client field in package.json.

Usage

1. Select text in any conversation and click “⑂ 开分支”;
2. Ask in the bubble input: Enter sends, Shift + Enter inserts a newline;
3. The answer appears in the bubble, and the corresponding question/answer turns are hidden from the main transcript;
4. Click × to collapse the bubble; the inline ⑂N badge reopens it later;
5. In the bubble, ⌂ resets the window position/size, and the round locate button jumps back to the original passage with a highlight;
6. The left list switches between branches; × deletes a branch and its thread.

How it works

1) An anchor is text plus a positional fingerprint. Besides the quote, an anchor stores its data-chat-turn, the turn's text length, the selection's character offset, the occurrence index of the quote inside the turn, and 20 characters of context before and after. Resolution tries full context → leading context → trailing context → recorded offset → Nth occurrence → first occurrence, then validates the reconstructed range with Range.toString(). A mismatch fails closed — no “close enough” jumps.

2) Branch messages. The prompt is sent back to the same session behind an internal marker:

⟦分支·<anchorId>⟧关于「<quoted text>」

<your question>

This is a real write into the session context, so the branch answer has full memory; hiding it in the main transcript is purely presentational.

3) Capturing the answer. The plugin polls the session's running state, then finds the answer container for that turn by marker, clones its DOM, strips process noise (data-step-process, code-block buttons) and injects it into the bubble — so the bubble renders exactly like the main transcript.

4) Hiding branch turns. The plugin owns a single <style id="branch-chat-hide"> with [data-chat-turn="N"]:not(:has([data-chat-turn])) { display: none !important; }, hiding only leaf turns (never ancestor containers); a user turn is hidden only after it is confirmed to contain this plugin's marker. Clearing the style restores everything; transcript DOM is never rewritten.

5) Window and state. Panel geometry, input height, list width, floating-button position, anchors and threads are persisted in localStorage and restored across reloads.

Project layout

BubbleChat/
├── lib/
│   ├── index.js          # host-side entry (empty placeholder)
│   └── client.js         # all UI and logic (browser half, single file)
├── cordis.patch.yml      # bundle patch so the plugin loads standalone
├── package.json          # DSH plugin manifest (dsh.bundle / dsh.client)
├── docs/images/          # README screenshots
├── LICENSE
└── README.md

Known limitations

• Depends on DSH client DOM contracts (data-chat-turn, data-turn-process-answer, data-chat-group-part, …). Major DSH upgrades may change them and require adaptation.
• Only the web client is tested (dsh.client.platform = "web"; the desktop app renders the web client).
• Branch Q&A really consumes context. Hiding is presentational; many long branches still add tokens.
• Capture depends on the main session going idle. If capture fails you will see “answer generated but not captured (use Locate)”, and that branch's turns remain visible in the main transcript.
• State is per browser. localStorage is not synced across devices; clearing site data loses anchors and threads.
• No branch export/share/rename yet.

Development

• No build step: lib/client.js is loaded directly by the host; restart the app after edits.
• The browser console prints [branch-chat] load status.
• Local state key: dsh-branch-chat/v5 (clear it to reset all anchors).
• Keep the constraint of never modifying the main transcript DOM; hide only through the plugin-owned <style>.
• Manual test checklist before submitting: select → create branch → ask → render → collapse (badge) → locate → reload and restore → delete branch.

Compatibility

Contributing

Issues and PRs are welcome. Since the plugin relies on DSH's client DOM contracts, please mention the DSH version and scenario you tested; keep changes small and focused for review.

License

MIT © 2026 makima-coder