前言¶
在 DeepSeek Harness（DSH）里跑带思考输出的对话时，思考内容往往嵌在聊天流里：折叠、滚动、被其它消息顶走，长段英文还要自己对照理解。更早的做法有人用 PowerShell + WPF 读磁盘会话日志，还要挂翻译插件，维护成本高。
下面介绍社区维护的客户端插件 dsh-think-overlay（维护者 hcycyxx）：从当前页面已渲染的思考行取数，在右下角提供置顶半透明窗口，逐字流式、绿灯跟速、可选英译中，并可弹出独立小窗。它是标准 DSH 客户端插件，装好即启用，零外部依赖，无须重建前端产物；TUI 不显示该界面。
- 插件目录：skillhub.cn/plugins/hcycyxx/dsh-think-overlay
- 源码与文档：github.com/hcycyxx/dsh-think-overlay
- 分类：客户端 · 许可证：MIT · 当前资料版本：0.2.0
这是什么¶
dsh-think-overlay 把 DSH Web 及使用同一界面的桌面版里、正在产生的思考内容，一个字一个字地流入屏幕右下角的悬浮窗。窗口可拖动、缩放、调透明度与字号，支持点击穿透；标题栏绿灯的呼吸频率随吐字速度变化，待机时缓慢明暗，思考越快闪得越急。英文思考可自动翻成中文，也可一键弹出与主窗同步的独立小窗。
取数范围明确：只读页面里已渲染的思考行（[data-variant="think"] / [data-chat-group-part="reasoning"]），不读磁盘会话日志、不依赖「思考过程机器翻译」插件、不额外加载历史。折叠的思考行能抓到摘要，展开后抓全文。
核心功能¶
逐字流式与绿灯跟速¶
思考内容按字往外吐，避免整段闪跳。主窗是唯一的「打字机」；独立小窗直接显示已吐出的片段，两边观感一致。左上角绿灯用连续相位驱动，频率随吐字速度平滑变化（资料记载：待机约 0.29 Hz，活跃最高约 1.8 Hz），改速度不会让动画相位重启。
自动英译中¶
英文思考默认尝试翻译为中文：优先走 DSH 自带翻译通道（本地 Node 侧）；失败则降级到公共翻译端点；仍失败则显示英文原文，并每 6～18 秒自动重试最多 4 次。标题栏 译 按钮可随时开关；关闭后已翻译内容退回原文。
开启英译中时，英文思考文本会发往翻译服务（降级时可能经过 Google / MyMemory 等公共端点）。介意联网翻译可在窗口或设置里关掉 译，此时以抓页面为主；除翻译外，插件不注册模型工具、不执行命令、不发送其它网络请求。
独立小窗与窗口操作¶
点 ⧉ 可弹出单独窗口，经消息通道与主窗同步逐字结果与绿灯状态；小窗可置顶盖在其它程序上。还支持：拖标题移动、拖四边四角缩放、透明度/字号滑杆、点击穿透、收起成小胶囊、清空、暂停跟随。默认布局（宽 428、高 380、透明度 0.9、字号 15 px、位置距边 28 px 的右下角等）及偏好保存在当前界面的 localStorage（键名 dsh-think-overlay.cfg.v1），卸载插件不会清除；DSH 设置里会出现 思考悬浮窗 一栏。
每条思考带工具名与时间；若 DSH 日后改动思考行 DOM 结构，窗口不会报错，只是暂时没有新内容。
安装与启用¶
当前验证过的安装路径以 README 为准；@latest 仅在 npm 已发布且可查询后才适用，不能当作当前唯一入口。
通过插件市场（推荐）¶
- 打开 插件 → 实验性插件，启用 自定义插件市场 / Custom plugin markets（部分版本为 Custom plugin indexes）。
- 进入 发现 / Discover → 添加索引源 / Add index source。
- 添加下列索引，搜索
dsh-think-overlay，确认来源为 Git 仓库hcycyxx/dsh-think-overlay后安装。
https://raw.githubusercontent.com/hcycyxx/dsh-think-overlay/main/market/index.json
按提示重启实例；桌面版可刷新网页。索引源按 profile 保存，各用户需自行添加。
命令行或离线包¶
从 Releases 下载 dsh-think-overlay-0.2.0.tgz 后，用实际路径安装到 Web profile 并重启：
dsh plugin --profile web add ./dsh-think-overlay-0.2.0.tgz
npm 发布确认可用后，也可安装固定版本或 latest：
dsh plugin --profile web add dsh-think-overlay@0.2.0
dsh plugin --profile web add dsh-think-overlay@latest
桌面版可在插件管理界面用 file: 路径安装 tgz，或指向含根目录 package.json 的仓库目录，例如：
file:C:/路径/dsh-think-overlay-0.2.0.tgz
file:C:/路径/dsh-think-overlay
安装插件会在当前 DSH 进程/界面内加载客户端脚本（client.js 注入 Web 平台）。安装前建议浏览仓库源码与 MIT 许可证，确认与自己对数据出境、翻译联网的接受程度一致。
典型用法¶
经过上面的步骤安装并重启后，无需额外配置即可使用：让模型回答一次会产生思考的任务，思考行出现后，右下角窗口即开始逐字流入。
| 按钮 | 作用 |
|---|---|
| 译 | 英译中开关 |
| ⧉ | 弹出独立小窗 |
| ◌ | 点击穿透 |
| Ⅱ | 暂停/继续跟随 |
| ⌫ | 清空当前内容 |
| — | 收起成小胶囊 |
需要盖住其它应用时：先 ⧉ 弹出小窗，再点 置顶；宿主未开放置顶接口时可能显示「置顶*」，可用系统窗口菜单或 PowerToys 等工具手动置顶，数据仍与主窗同步。开启穿透后，页面右下会出现退出穿透入口；独立小窗内按 Esc 也可退出穿透。
适用场景与注意¶
适合谁：经常在 DSH Web 或同界面桌面版里看模型思考过程、希望思考与主聊天区分离、又需要可选英译中的用户。
环境与验证：0.2.0 不按 DSH 版本号阻止安装；README 记载已在 Windows 桌面版（Electron，DSH 0.2.2-rc.1）实测安装与加载，Web profile 与 macOS、Linux 桌面版的持续运行属未验证范围。
权限与数据：插件以当前 DSH 客户端权限运行，只读取已显示聊天结构与本会话已加载的思考行；不注册模型工具、不执行 shell 命令。除可选翻译外不发起其它网络请求。
卸载：
dsh plugin --profile web remove dsh-think-overlay
重启对应实例即可，无须删除整个 DSH profile。
结尾¶
dsh-think-overlay 把页面内的实时思考收成一扇可拖拽、可穿透、可同步到小窗的 overlay，用逐字流式与绿灯跟速降低「看不见、跟不上」的摩擦。社区插件与 DeepSeek / 幻方无官方从属关系；索引与安装细节以仓库 README 与 Discover 说明 为准。
- 目录页：https://www.skillhub.cn/plugins/hcycyxx/dsh-think-overlay
- GitHub：https://github.com/hcycyxx/dsh-think-overlay
