话题线索悬浮窗 Celebrate-W/dsh-topic-trail

dsh-topic-trail

会话工作线索悬浮窗 —— 把和 AI 的每一次长对话，实时提炼成看得见的「线索」。

dsh-topic-trail 是 dsh（DeepSeek Harness）的插件。它在 Web UI 里挂一个可拖动的悬浮窗，一边对话一边把内容整理成话题（线索）→ 进度步骤 → 阶段历程，让你随时知道「这件事做到哪了」。

长会话最常见的困扰是「刚才那段结论在哪儿」。这个插件让线索自己浮出来，点一下就能跳回对话里的那一条。

界面预览

特性

线索组织

- 三级网络：全部工作区 → 工作区 → 会话 → 线索 → 步骤，逐层下钻
- AI 实时提炼：用 DeepSeek 把会话流总结成线索（标题 / 摘要 / 状态 / 阶段历程）
- 规则模式兜底：不调用模型也能用；模型不可用时自动回退，零成本运行
- 阶段历程：每条线索自动标注演进阶段（提案 / 探索 / 受阻 / 突破 / 完成）；没有 AI 历程时用步骤推断一个基础历程
- 手动整理：拖拽合并线索、重命名、锁定（锁定后自动总结不会改动它）、删除

交互

- 点击跳转：点线索 / 步骤 / 历程中的任意一条，打开对应对话并滚动定位、高亮那条消息
- 导航下拉 + 搜索：按工作区 / 会话筛选，或直接搜线索标题
- 悬浮窗：可拖动、可折叠；收起后是一个会眨眼的小球，大小可调
- 主动展示：收起状态下偶尔冒出一句融合了最近线索的「碎碎念」气泡；间隔可在设置里调（默认 30 秒），话术会主动避开最近说过的内容
- 状态点三档：线索前的小圆点按最后活动时间着色——10 分钟内亮绿、一天内暗绿、更久变灰，避免停手不做的线索一直亮着绿灯
- 随手记：内置便签与画笔工具；画笔存的是笔画路径（非位图），支持撤销、缩放不糊，内容存在服务端而非仅浏览器
- 多皮肤：内置经典皮肤与 DeepSeek 主题，两套皮肤的头像、话术、气泡样式各自独立
- 跟随 dsh：在 dsh 里删除的工作区、归档的对话会自动从列表隐藏（可在设置里展示已删除项）

工程

- 零构建：client 半是纯 React + h()，直接由 dsh 提供，改完刷新即生效
- 快照缓存 + 分块折叠：会话很多时列表接口从数十秒降到毫秒级
- 子代理过滤：按血缘（origin / delegationDepth）识别并排除子代理会话，不与主会话混在一起
- 省 token：总结前先比对内容指纹跳过无变化的调用，并设最小间隔（默认 20 秒）；可在设置里看估算用量（气泡与总结分开统计），并提供一键「轻简模式」

安装

指向你自己的 dsh 安装目录（下面用 $DSH_HOME 表示） $env:PATH = "$DSH_HOME\tools\node_modules\.bin;" + $env:PATH
dsh plugin --profile web add file:C:/path/to/dsh-topic-trail

然后重启 dsh。

也可以把本目录放进 $DSH_HOME/plugins/，再用 cordis.patch.yml 的 insert 段注册。

配置

设置页里的选项会持久化到 $DSH_HOME/data/topic-trail/config.json，覆盖 cordis.patch.yml 里的基线值。

| 键 | 说明 | 默认 |
| summarize | 总结方式：auto（优先 AI，失败回退规则）/ llm（强制 AI）/ rule（仅规则，不调模型） | auto |
| provider / model | 总结用的 provider 与模型，留空则自动探测 dsh 的当前配置 | 自动 |
| pollMs | 前端轮询间隔（毫秒） | 3000 |
| bufferSize | 送给模型的上下文窗口大小 | 40 |
| followSession | 切换对话时自动跟随到该对话 | true |
| learnFromModifications | 记住你手动合并 / 整理的习惯，后续总结时参考 | true |
| preserveTopics | 总结时保留已有线索，只追加新线索 | true |
| workspaceMemory | 记住每个工作区的项目结构与总结偏好 | true |
| workspaceViewMode | 工作区视图：merge（相似线索聚类）/ bySession（按对话分块） | bySession |
| skin | 皮肤：default（经典蓝球）/ deepseek（DeepSeek 娘） | default |
| ballScale | 收起小球的大小倍率（0.6 ~ 1.6） | 1 |
| bubbleIntervalSec | 主动展示气泡的间隔秒数（5 ~ 300，实际有 0.7~1.5 倍随机抖动） | 30 |
| showRemovedItems | 展示在 dsh 里已删除的工作区 / 已归档的对话（默认隐藏） | false |
| leanMode | 轻简模式（省 token）：总结间隔拉到 90 秒、不喂推理内容、气泡间隔翻倍 | false |
| topicOrder | 线索排序：llm（AI 组织顺序）/ created（按创建时间倒序，最新在上） | llm |
| eyeAnimation | 收起小球跟随鼠标的数字瞳孔、眨眼动画 | false |
| proactiveDisplay | 主动展示气泡 | true |
| enabled | 插件总开关（关闭后隐藏悬浮窗、停止记录） | true |

使用

- 点线索标题：展开阶段历程；步骤收在「显示步骤（N 步）」按钮后面，避免上千步的流水账把脉络淹没
- 点历程 / 步骤：跳转到对话里的对应位置
- 右键线索：重命名 / 删除 / 合并
- 拖拽线索到另一条上：合并（可走 AI，也可走规则）
- 右键工作区：重新生成该工作区的全部线索
- Esc：逐层关闭浮层（右键菜单 → 画笔菜单 → 导航下拉 → 搜索 → 便签 → 展开的线索）

工作原理

1. host 半订阅 dsh 的会话事件流，把事件归一化成「步骤」，按规则即时聚成线索
2. 累积到一定量后把上下文交给 DeepSeek 总结，产出线索、阶段历程与摘要
3. client 半轮询快照渲染悬浮窗；步骤正文按需拉取（展开时才请求）

几个值得一提的实现细节：

- 事件序号是全局的：step.seq 跨会话递增（可到百万级），所以跳转定位必须用会话内的相对位置 (seq - min) / (max - min)，不能拿步骤条数当分母
- 时间戳来自事件本身：每个 dsh 事件都带 time，host 直接采用它；若用「插件处理这一刻」代替，历史重放会让成千上万条步骤的时间挤在同一秒，定位就失效了
- 重新生成有保护：读不到事件日志时不清空；结果为空或缩水到不足原来的 1/3 时整体回滚；已锁定与手动合并过的线索重建后会放回

已知限制

- 旧线索的定位精度：早期版本生成的线索里，步骤时间记的是「导入时刻」而非真实时间，只能按事件序号比例估算位置（±几条消息）。重新生成该会话的线索即可修正
- 主动展示气泡依赖浏览器的定时器；标签页长时间后台时可能被节流，间隔会变长

开发

- lib/index.js — host 半：路由、事件处理、规则聚类、LLM 总结、持久化
- lib/client.js — client 半：悬浮窗 UI（零构建，纯 h()）
- cordis.patch.yml — dsh 插件注册与基线配置

改完 host 需要重启 dsh；只改 client 的话刷新浏览器即可。

许可

代码采用 MIT 许可证。

内置的皮肤头像（DeepSeek 娘 / 鲸鱼娘）是社区二创作品，不随 MIT 授权，版权归各自权利人所有。
它源自「溟月」（作者：上善无形，以 CC BY-NC-SA 4.0 开放二创），DeepSeek 版由 B 站用户 ZipZipPipe 二次创作。
使用时请遵循 署名 / 非商用 / 相同方式共享 三条要求；商业用途需先取得权利人许可。

详见 第三方素材说明。

本项目由人机协作开发：需求、验收与产品判断由人类给出，实现与排查由 AI 完成。