dsh-cot-peek · 思考小窗

在 DSH Web 界面里悬浮一个置顶小窗，实时显示当前会话的思考过程（reasoning）， 可收起，点一下按钮就翻成中文。

上面是示意图（按插件真实布局/配色渲染），不是截图。

位置：shell.overlay 顶层浮层，position: fixed，自由拖动时被限制在对话列里： 它从输入框的数据座量出对话列的左右边界，宽度不会超出；侧边栏一打开，对话列变窄， 小窗自动跟着缩，侧边栏收起后也会恢复您原本设的大小（用户尺寸单独记着，不被压缩掉）。 可拖动（按住标题栏）、可调大小（拖右下角），位置尺寸存在 localStorage （最小 320×140，最大 960×800）。

贴边与边缘抽屉：把小窗拖到屏幕左右边缘附近松手，它会吸附到那一侧； 收起时窗体整体滑出视口，只留一枚边缘箭头（左右自动换朝向）：

• 箭头挂在窗体外面（不压正文），收起时正好停在屏幕边缘
• 箭头做透明度呼吸动画（只有透明度变化，大小不变）
• 悬停或点击箭头 → 窗体平滑滑入，完整显示文本框
• 鼠标离开 1.5 秒后自动滑回去（再进入会取消）
• 滑入/滑出是 380ms 的缓动位移，不弹跳；prefers-reduced-motion 时箭头不呼吸
• 拖离边缘松手 → 解除吸附，回到对话列内自由漂浮

数据来自 conversation.input.dock 里的隐藏数据座（那里才有当前 Session 的 Chat 快照）。

它做什么

• 从 Chat 快照里直接读当前正在流式输出的 reasoning（不额外请求、不跑二次流）
• 自动翻译（默认开）：每 2.5 秒检查一次有没有新思考，有就把新增的已完结句子送翻， 整段不会重翻；标题栏「自动」按钮可随时关掉
• 手动翻译：标题栏的「翻译」按钮，点一下立刻把当前整段翻完（没写完的尾巴也一起送）
• 英文思考 → 中文译文：代码块、行内代码、URL、文件名、术语先打成占位符，翻完原样还原
• 相同片段缓存，多句串行翻译（不冲垮免费翻译接口）
• 翻译失败自动退回原文，标题栏给出状态
• 手动模式下思考继续长时按钮会变成「再译」，提醒译文已经落后一截
• 对话结束 3 秒后自动滑出视口，只留边缘箭头；中途又跑起来会取消
• 下一轮开始时，自动收起的小窗会自己滑回来；您手动收起的则保持收起
• 切换对话时边缘抽屉自动收回，并且不会自动翻译切过去的历史思考 （只把切换后新到达的文字算作新内容，避免白烧翻译额度）
• 可切换「译文 / 原文」
• 翻译服务不可用时，鼠标悬停标题栏的「翻译未启用」会显示具体卡在哪一步 （服务未挂载 / 插件未启用 / 设置不可用 / 服务报错）

自定义翻译端点（本地模型 / 任意 OpenAI 兼容网关）

窗口标题栏的 ⚙ 可以配置一个 OpenAI 兼容端点，配好后优先走它，官方翻译包只作为回退。 常见地址：

| 跑什么 | base URL | | --- | --- | | LM Studio | http://127.0.0.1:1234/v1 | | Ollama（OpenAI 兼容） | http://127.0.0.1:11434/v1 | | 任意网关 | https://your-gateway/v1 |

• 模型可以留空（服务端只有一个模型时），留空就不传 model 字段
• API Key 可选，填了就带 Authorization: Bearer …
• 配置存在 localStorage，不进仓库；发送前同样会做代码 / URL / 术语占位保护
• 标题栏出现 「本地」 小标签表示当前走自定义端点
• 点「改用官方」清空配置，回到 Bing / Google / DeepSeek

CORS / 宿主代理（0.3.2+）：本地和内网地址（127.0.0.1、10.x、192.168.x、172.16-31.x） 会先走 DSH 宿时代理（/api/dsh-cot-peek/translate），由宿主进程转发 —— 完全不受 CORS 限制， 像 dsh-our-free-model 那种自带 127.0.0.1:8326 网关、但不发 CORS 头的插件也能直接接。 公网 https 地址仍由浏览器直连，需要对方允许跨域；宿主不存在时会自动回退到直连。

设置页（0.3+）

插件会把自己注册进 DSH 的插件设置页：设置 → 插件 → 思考小窗 · 翻译设置。 在那里可以：

• 选翻译引擎：官方（Bing / Google / DeepSeek，走官方实验包）或 自定义 OpenAI 兼容端点
• 填端点地址、模型（可选）、API Key（可选）
• 点「保存」立即生效；点「改用官方」清空端点
• 页面上会提示 CORS 要求和隐私说明（发送前已对代码 / URL / 术语做占位保护）

窗口标题栏的 ⚙ 是同一个配置的快捷入口，两边读写同一份 localStorage。

自动 / 手动两种模式

• 自动（默认）：每 2.5 秒看一眼思考有没有变长，变了就只翻新增的完结句子。 整段不重翻、未写完的半句留原文，所以流式输出不会被翻译卡住。 标题栏点「自动」可关掉，选择记在 localStorage。
• 手动：关掉自动后，「翻译」按钮点一次翻整段（也就是把没写完的尾巴也送出去）。 两者不冲突：自动开着时点「翻译」，会立刻把整段补齐，之后又回到增量模式。

为什么自动要限频：免费接口（Bing）会被限流，逐句实时翻译又慢又容易被拒； 现在 2.5 秒一收，既跟得上，也不会把请求打爆。

翻译管线（为什么快、为什么不会硬翻术语）

1. 省

   • 增量：自动模式下只送新增的完结句子，同一句永远只翻一次
   • 手动触发：点「翻译」才整段翻（含未写完的尾巴）
   • 串行 + 合句：短句合并到 ≥28 字符再发，减少请求数
   • 缓存：同一句只翻一次（思考里重复很多）

2. 准

   • 送整句、不送碎片；合句后语义完整

3. 不硬翻专业术语

   • 发出前先用占位符把代码块、行内代码、URL、文件名、术语表里的词 替换成 ⟦1⟧ 这类标记，翻译引擎看不到它们，翻完再原样还原
   • 术语表在 client.js 的 KEEP_TERMS，默认保留英文： DSH / MCP / LLM / API / SDK / JSON / Session / Token / Prompt / Context / Slot / Plugin / Bundle / Agent / Tool / Stream / Markdown …

   想加词：往 KEEP_TERMS 里加一条即可。

装完就有翻译吗？

默认没有。 插件本体只负责显示思考 + 调用翻译入口，真正翻译需要二选一：

1. 官方翻译实验包（推荐，免配置）：安装 @deepseek-ai/dsh-experimental-cot-translation-bundle， 到「插件页 → 官方分组」启用「思考过程机器翻译」；默认走 Bing，免费
2. 自定义端点（0.3+）：设置 → 插件 → 思考小窗 → 选「自定义 OpenAI 兼容端点」， 填本地 LM Studio / Ollama / 任意网关地址

两者都没配时，窗口会显示「翻译未启用 · 装官方翻译包或配端点」，其余功能照常可用。

端点填完整 URL（以 /chat/completions 结尾）也能用，例如 http://127.0.0.1:8326/v1/chat/completions。

依赖

中文译文依赖官方实验包：

@deepseek-ai/dsh-experimental-cot-translation-bundle

它提供 Host 侧的 translator 服务和 Client 侧的 ctx.remote.cotTranslation。 不装也能用，只是小窗显示英文原文，标题栏标「翻译未启用」（悬停或点按钮能看到具体原因）。

本插件的 package.json 里 dsh.client.inject 必须声明 @deepseek-ai/dsh-api-remotes ——那是提供 remote 服务的客户端包；不声明的话 ctx.get('remote') 永远是 undefined， 表现就是「翻译未启用」。另外客户端 inject 数组里要有 remote（与官方翻译插件一致）， 读取嵌套命名空间用 ctx.get('remote.cotTranslation')：cordis 的 ctx.get(name) 是 绕过 inject 要求直接读服务仓的，这是最稳的一条路；ctx.inject(['remote.cotTranslation']) 作为第二条路兜底等待挂载。

翻译服务默认 Bing（免费、免登录），可在 「设置 → 插件 → 思考过程机器翻译」里换成 Google 或 DeepSeek（付费）。

实测：Google 的 translate.googleapis.com 在国内网络下连不通，Bing 的 edge.microsoft.com 是可用的，建议保持默认。

安装

从 npm 安装（推荐）：

dsh plugin --profile desktop add dsh-cot-peek

或者在 DSH「设置 → 插件市场」里加入下面的索引源，在「发现」页一键装：

https://gh-proxy.com/https://raw.githubusercontent.com/wunainana/dsh-cot-peek/main/market.json

本地目录链接（开发时）：

dsh plugin --profile desktop add link:<本目录的绝对路径>

从 GitHub 装（SSH，适合 HTTPS 到 GitHub 不通的网络）：

dsh plugin --profile desktop add "git+ssh://[email protected]:wunainana/dsh-cot-peek.git"

安装后重启 DSH 生效。

发布

• npm：已发布 [email protected] → https://www.npmjs.com/package/dsh-cot-peek

• 插件市场索引：仓库根目录的 market.json（格式 1，已通过 DSH 自带 @deepseek-ai/dsh-plugin-market-index 校验）。把它加进 「设置 → 插件市场 → 索引源」即可在「发现」页看到：

  https://gh-proxy.com/https://raw.githubusercontent.com/wunainana/dsh-cot-peek/main/market.json

  直连 GitHub 的网络也可以直接用 raw 地址：

  https://raw.githubusercontent.com/wunainana/dsh-cot-peek/main/market.json

• 发新版本：改 package.json 的 version → npm publish --access public → 更新 market.json 里该版本的 version 与 publishTimestamp → 提交推送。 npm 账户开了 2FA，发布需要 --otp=<6位码> 或 Bypass 2FA 的 granular token。

文件

package.json       bundle 清单（dsh.bundle.patch + dsh.client）
cordis.patch.yml   把 cot-peek 这一行插进 profile
index.js           Host 半身：空实现（功能全在浏览器）
client.js          全部逻辑：取 reasoning、分句、术语保护、手动翻译、UI
locale/zh.json     插件管理页里显示的中文标题/描述
locale/en.json     英文标题/描述
icon.svg           原创图标
market.json        插件市场索引（format 1）

已知限制

• 只显示「最后一段 assistant-step」的 reasoning；多 step 连续思考时会以最新 step 为准
• 手动翻译：翻完之后思考继续长，译文会落后，按钮变成「再译」提醒您
• 翻译走匿名接口，可能被限流或拒绝；失败时自动显示原文
• 改完 client.js 需要刷新页面（Client 插件重载）