侧边线程 LeoAndJellyfish/DeepSeek-Harness-Threads

DeepSeek Harness Threads

DeepSeek Harness（DSH）侧边线程对话插件，提供独立回复面板和可选的 Slack 风格聊天界面。点任意一轮回答下的「回复」，就能在右侧栏继续追问。

当前版本：0.13.8 · 包名：dsh-threads · 版本下载 · 问题反馈

安装

Web 版（dsh web）

从 GitHub 安装固定版本：

dsh plugin --profile web add github:LeoAndJellyfish/DeepSeek-Harness-Threads#v0.13.8

安装完成后重启 dsh web，刷新浏览器。在一轮已完成的回答下确认「回复」入口，在对话标题栏确认「线程」按钮和 Slack 样式开关。

安装开发分支当前版本：

dsh plugin --profile web add github:LeoAndJellyfish/DeepSeek-Harness-Threads

官方桌面客户端

在 DSH 桌面端会话中发送以下指令，由宿主内置的 plugin_manager 安装到当前桌面 profile：

请使用当前桌面端内置的 plugin_manager 安装 github:LeoAndJellyfish/DeepSeek-Harness-Threads#v0.13.8。
先检查当前 profile 和已安装的同名插件，已有安装时核对来源与版本；通过工具支持的安装或更新操作完成，并报告实际安装版本和重启要求。

桌面端使用宿主管理的 desktop profile；上面的 --profile web 命令用于独立 Web 版。安装后按宿主提示重启，然后检查回复入口。

离线资源包

下载 Release 中的 dsh-threads-0.13.8.tgz，在文件所在目录执行：

dsh plugin --profile web add ./dsh-threads-0.13.8.tgz

也可下载 ZIP，解压后用包含 package.json 的目录绝对路径：

dsh plugin --profile web add "file:D:/Plugins/dsh-threads"

Release 附带 SHA256SUMS，可用 Get-FileHash <文件路径> -Algorithm SHA256 核对下载文件。

更新与卸载

更新时使用原安装来源和目标版本，优先走宿主插件管理界面的更新入口。早期本地开发包名为 @local/dsh-threads，迁移到公开包前，先通过对应 profile 的插件管理入口移除旧注册，再安装 dsh-threads。线程和文字草稿存放在 $DSH_HOME/dsh-threads/store.json，迁移前可备份该文件。

Web 版卸载：

dsh plugin --profile web remove dsh-threads

运行条件

插件使用 DSH 的会话分叉、右侧栏、聊天节点插槽和 Markdown 模块。客户端声明为 web，由 DSH Web 界面加载；官方桌面端通过内置 Web 界面加载。宿主版本升级可能调整这些接口。

功能

- 独立线程面板：会话分叉、归档恢复、工具审批、Markdown 和数学公式。
- 线程导航：回复条数、运行状态、未读提示、最近更新时间。
- 消息输入：文字草稿持久化、粘贴和拖拽图片、线程结论引用。
- 可选 Slack 样式：头像和作者、日期分隔、悬停操作条、折叠插话。
- Host 持久化：线程索引、文字草稿和界面偏好在重启后保留。

用法

1. 刷新页面（安装/升级后需要一次）。
2. 把鼠标移到任意一条已完成回答的底部动作行，点气泡图标「回复」。
3. 右侧栏出现「线程」页签：顶部引用被回复的那条回答，下面是回复流和输入框。
4. 第一次发送时才真正创建线程——它是一条从该轮分叉出来的子会话，继承到该轮为止的上下文。
5. 线程存在后，该轮下方会常驻一行「N 条回复」，点它随时回到线程。

它是怎么实现的

| Slack | DSH |
| Channel | 会话（Session） |
| 一条消息 | 一轮对话（用户提问 + 助手回答） |
| Thread | 从该轮 fork 出的子会话（parentSession 指向主会话） |
| Thread 面板 | 右侧栏 thread 页签 |

- 线程索引（主会话 + 锚点 seq → 子会话）和文字草稿持久化在 Host 侧 $DSH_HOME/dsh-threads/store.json，浏览器 localStorage 提供运行内兜底。对话内容存在子会话日志中；草稿发送成功后清空。
- 助手回复用宿主自己的 Markdown 渲染器（@deepseek-ai/dsh-client-ui-primitives 的 MarkdownText，web shell 静态模块表提供），和聊天区同一套：CommonMark、KaTeX 数学公式、代码块高亮/复制、脚注。引用卡片也用同一渲染器。
- 每条发进线程的消息都会带一段 <dsh-thread> 前缀，告诉分叉出来的 agent「你在侧边线程里，回复只有线程面板能看到」。面板渲染时会把这段前缀剥掉；如果直接用「打开子会话」进主界面，会看到原始前缀。
- 子会话会以缩进形式出现在左侧栏，标题沿用分叉时的递增标题。
- 线程会话在左侧栏被归档后，面板会禁用输入框、显示「已在左侧栏归档」提示，并给一个「恢复会话」按钮；草稿保留，恢复后可直接继续。
- 线程里的 Agent 请求工具确认时，面板底部直接出现审批卡片（工具名、理由、「允许一次 / 拒绝」），和主界面审批 UI 读的是同一份 PendingApproval 状态。
- 对话标题栏的「线程」按钮打开本会话的线程列表（按最近更新排序，点一行跳到对应线程页签）。
- 线程页签标题是动态的：显示被回复回答的前 18 个字，同时开几条时能分清。
- 线程面板的「带回主对话」把线程最后一条回答以引用块写进主对话输入框（不直接发送，你自己决定发不发、改不改）。
- 线程输入框支持粘贴/拖拽图片，按宿主默认限制：最多 20 张、单张 20 MB；超过 2048px 长边或 4 MP 的图会先在浏览器里缩放（WebP，透明底转白）再发送。
- 线程子会话继承父会话的 Agent 预设（Host 半边在子会话创建、Agent 尚未产生时写入 agent-preset/selected；注册表重建 Agent 读的正是这个投影，因此不受 agentPresets.select() 的「已开始」限制）。
- 左侧栏里属于线程的子会话行前会显示线程小图标，和普通分支会话区分开。
- 对话标题栏的 Slack 开关（胶囊 + 滑动方块，role="switch"）切换消息行样式：Slack 模式下 user、assistant-step、steering 换成头像 + 作者 + 时间的 Slack 行，其余节点仍由宿主渲染；随时可切回原生。
- Slack 行悬停出现整行高亮和浮动操作条（复制、回复进线程、从这个回答分支）。
- Slack 模式下按天插入日期分隔（「今天」「昨天」或「10 月 8 日 星期四」，跨年带年份）；首条消息也显示。
- 用户消息恢复文件卡片（名称/类型/大小）、引用摘要（referenceLabels）与技能名（skillNames）。
- 中途插入的消息（steering）渲染成单行「插话」折叠行，点击展开，不再撑成一条完整消息。
- 线程卡片显示运行中圆点（脉冲）、未读圆点，并在线程完成时刷新条数与最后回复时间。
- 线程输入框可勾选「同时发到主对话」，把这条线程消息以 [来自线程] 前缀也发进父会话（会触发父 Agent 回复）。
- 线程面板头部显示最后回复时间与参与者头像，失败时提供「重试」。
- 图片点击打开灯箱（点背景或 Esc 关闭）；正文链接、引用块、代码块使用爵士配色。
- 工具与过程行保留宿主富卡片，只通过 data-chat-flow-kind 把外壳缩进对齐到 Slack 正文（Slack 模式下生效）。

已知边界

- 线程继承锚点之前的完整上下文，每次回复的输入 token 会变大（前缀缓存可抵消一部分）。
- 「带回主对话」只写草稿，不会自动发送；主对话输入框原有的文字会被保留并接在后面。
- 面板只渲染用户/助手文本（助手部分走完整 Markdown），工具调用折叠成一行，不渲染完整工具卡与轨迹。
- 审批卡片只支持宿主的临时决定（允许一次 / 拒绝）；持久权限策略仍由宿主侧处理。
- 图片只支持图片类型、只存在内存里（切换/重载后需重新粘贴；文字草稿仍然持久化），不支持文件上传。
- 线程列表和索引、草稿、皮肤偏好统一存在 Host 侧 $DSH_HOME/dsh-threads/store.json（经 /dsh-threads/store 读写，和页面同一套来源/身份校验），端口变化和重启都不丢；localStorage 只是同一次运行内的兜底。
- 皮肤偏好与线程索引一起持久化在 Host store；目前替换了 user / assistant-step / steering 三类节点，工具卡、过程行仍由宿主渲染；被替换的行暂未提供宿主原有的编辑/重发交互（复制、回复、分支已补）。
- 有插话的轮次过程组会被宿主强制展开（hasInterleavedInput），无法从节点渲染器改变；要改需接管 conversation.chat.flow，暂缓。
- 深色模式的对比度只做了静态检查的一部分：亮色下 #14ADFF 对白底仅 2.48，已改用深一档的 --sk-azure-ink 承担文字；深色块的 token 解析仍未验证。
- Markdown 渲染器来自宿主的静态模块表（dsh.client.external 声明）；宿主大版本改名时这里需要跟着改，缺省会退化为纯文本。

文件

- client.js — 全部客户端逻辑：线程索引、回复入口、右侧面板、Slack 皮肤。
- index.js — Host 半边：/dsh-threads/store 持久化路由 + 线程子会话的 Agent 预设继承。
- cordis.patch.yml — 安装入口。