聊天缩放 YangShen-SWE/dsh-plugin-chat-zoom

DSH Chat Zoom · 缩放

DeepSeek Harness（DSH）聊天区域缩放插件。只缩放聊天消息和输入区，不动侧栏、设置页或全局弹窗。

- 插件名称：缩放
- 软件包 / 仓库名称：dsh-plugin-chat-zoom
- 首个 GitHub 发布版本：v0.1.0
- 许可证：MIT

下载 v0.1.0 · 报告问题

补充文档：隐私说明 · 贡献与维护 · 市场投稿与合并注意事项。这些文档后补于 main；既有 v0.1.0 安装包与 tag 保持不变。市场投稿不等于已收录。

功能

- 文字、代码、图片和输入控件一起缩放布局。
- 默认 100%，范围 80%–200%；快捷键和放大 / 缩小按钮每次调整 10 个百分点。
- 在设置页选择倍率、放大、缩小、恢复默认或清除倍率记忆。
- 操作后显示倍率提示，最后一次操作 5 秒后自动隐藏；聊天区没有常驻缩放工具栏。
- 同一页面的聊天面板共用倍率；按浏览器的网站来源保存偏好，刷新后可恢复。
- 尽量保留当前阅读位置，不强制跳到聊天顶部或底部。

运行要求

这是 DSH 插件，不是 Chrome / Edge 扩展，也不是能独立运行的网站。

需要 DSH 提供客户端模块加载器、React 共享模块和 settings.section 插槽，浏览器还要支持 CSS zoom。适配依据为 DSH 0.2.0-rc.2 的内部聊天 DOM 属性；不保证其他宿主版本兼容。v0.1.0 是本插件的版本，不是 DSH 的版本。

发布包已包含可运行的客户端文件，无需自行构建或安装独立 React。插件界面目前使用中文；本文档提供中英双语说明。

安装

方法一：在 DSH 插件页安装（推荐）

1. 在 v0.1.0 发布页 下载 dsh-plugin-chat-zoom-0.1.0.tgz。不要把 GitHub 自动生成的源码 ZIP 当作插件安装包。
2. 打开 DSH 侧边栏的 插件 页面，进入安装外部插件 / 组合包的入口。
3. 将下载文件的完整绝对路径作为安装来源，例如：C:/Downloads/dsh-plugin-chat-zoom-0.1.0.tgz。这里的路径只是示例，请换成实际下载位置。该路径必须能被运行 DSH 的电脑访问；远程浏览器本地的文件不一定对 DSH 主机可见。
4. 确认安装，并检查 dsh-plugin-chat-zoom 已启用。若入口支持 HTTP(S) 压缩包来源，也可直接填写下方下载地址。
5. 刷新 DSH 页面，再打开 设置 → 缩放。如果仍不出现，请完整退出并重启 DSH，而不是只关闭网页。

安装包直链：

https://github.com/YangShen-SWE/dsh-plugin-chat-zoom/releases/download/v0.1.0/dsh-plugin-chat-zoom-0.1.0.tgz

方法二：使用 DSH CLI

如果已配置 dsh 命令，桌面版可运行：

dsh plugin --profile desktop add "dsh-plugin-chat-zoom@https://github.com/YangShen-SWE/dsh-plugin-chat-zoom/releases/download/v0.1.0/dsh-plugin-chat-zoom-0.1.0.tgz" --ignore-scripts

离线安装已下载的文件，例如在 Windows 上：

dsh plugin --profile desktop add "dsh-plugin-chat-zoom@file:C:/Downloads/dsh-plugin-chat-zoom-0.1.0.tgz" --offline --ignore-scripts

请把文件路径和 desktop 替换为实际下载位置与当前 profile（配置档案）。不确定 profile 或没有 dsh 命令时，使用插件页安装。这些命令由用户执行，本仓库不会自动修改 DSH 配置。 插件自身没有安装脚本。

方法三：安装仓库目录

也可下载并解压 GitHub 源码，或克隆仓库，然后在 DSH 插件页将包含 package.json 的目录绝对路径作为安装来源。不要直接选择 lib 子目录。

使用

设置页

进入 设置 → 缩放：

| 控件 | 作用 |
| 聊天倍率 | 选择 80%–200% 的倍率 |
| 缩小 / 放大 | 每次调整 10 个百分点 |
| 恢复 100% | 恢复默认倍率，并保存该值 |
| 清除倍率记忆 | 恢复 100%，删除本插件保存的倍率记录 |

修改立即生效。清除倍率记忆不会删除聊天、输入草稿或其他设置。

快捷键

| 操作 | 效果 | 使用位置 |
| Ctrl + 滚轮向上 / 向下 | 放大 / 缩小 | 鼠标位于聊天消息或输入区 |
| Ctrl + + / - | 放大 / 缩小 | 输入区有焦点；或没有其他控件焦点且鼠标悬停聊天区 |
| Ctrl + 0 | 恢复 100% | 与上述键盘快捷键相同 |

加号支持 Ctrl + =、Ctrl + Shift + =；也支持小键盘加减号。普通滚轮与 Ctrl+C/V/Z 等编辑快捷键不会被接管。

隐私与卸载

插件自身不发送网络请求、不上传聊天、不收集遥测，不写入服务端设置。只有倍率保存在当前浏览器的网站来源下，记录键为 dsh-plugin-chat-zoom:v1:percent；不跨设备同步，也不按会话分别保存。
如需移除记录，先点击 设置 → 缩放 → 清除倍率记忆，再到插件页禁用或卸载插件。正常停用会移除插件自有监听器、倍率标记、提示和样式；可能需要刷新或重启。默认停用保留倍率记录，不要为了清理倍率而清空整个 localStorage。

安装包的下载和 DSH 插件管理器自身可能使用网络；上面的隐私说明仅描述本插件运行时。

已知限制与排查

- 设置中看不到“缩放”：确认插件已安装并启用，刷新页面，必要时完整退出并重启 DSH。
- 所有网页元素一起放大：可能是浏览器或桌面宿主先截获了快捷键。先用设置中的倍率控件；插件不能保证拦截宿主已处理的按键。
- 输入法或内嵌工具中不响应：中文输入法组合输入、全局模态弹窗、聊天内嵌编辑器、终端和画布优先，插件有意避免抢占这些操作。
- 触控板捏合也触发缩放：部分浏览器会将捏合报告为 Ctrl 滚轮，插件无法可靠区分。
- 升级 DSH 后不响应：插件依赖宿主内部 DOM 属性，不匹配时不会对整个页面强制缩放；可能需要更新适配。
- 保存倍率失败：浏览器可能限制本地存储，本次缩放仍可生效，但无法保证刷新后恢复。

本次发布检查涵盖 JavaScript 语法、包内引用和客户端模块注册；不代表已完成所有 DSH 版本、物理鼠标操作或真实输入法的实机验证。

仓库内容与重新打包

本仓库只包含可分发的插件文件及本文档，不包含私人聊天、缓存、安装配置备份、迁移工具或开发测试记录。lib/client.js 为完整、可读的预构建客户端实现；本仓库未提供原始拆分源码和构建工具。

| 文件 | 用途 |
| package.json | 包版本、入口与 DSH 元数据 |
| index.js | 宿主入口；功能在浏览器客户端运行 |
| cordis.patch.yml | DSH 插件注册配置 |
| lib/client.js | 完整客户端逻辑与设置界面 |
| README.md | 中英双语使用说明 |
| LICENSE | MIT 许可证 |

维护者可在仓库根目录使用 Node.js / npm 重新打包：

npm pack --ignore-scripts

生成的 .tgz 安装包不提交到源码仓库，而是上传到 GitHub Releases。发布包包含本文档和许可证，不包含 Git 元数据。

DSH Chat Zoom changes the size of chat messages and the input area in DeepSeek Harness (DSH). It does not zoom the sidebar, settings pages, or global dialogs.

- Display name: 缩放 (Zoom)
- Package / repository: dsh-plugin-chat-zoom
- First GitHub release: v0.1.0
- License: MIT

Download v0.1.0 · Report an issue

Additional documents: Privacy · Contributing · Market and merge notes. These documents were added on main after release; the original v0.1.0 tag and archive remain unchanged. Submission does not mean admission.

Features

- Zoom text, code, images, and input controls together using layout zoom.
- Default: 100%. Range: 80%–200%. Keyboard shortcuts and zoom buttons change the value by 10 percentage points.
- Change the zoom level, reset it, or clear the saved preference in settings.
- Show a small zoom hint after an action. It disappears 5 seconds after the last action. There is no permanent zoom toolbar in the chat.
- Share one zoom level across chat panels on the same page. Save the preference locally for the current browser origin.
- Try to keep the current reading position instead of jumping to the top or bottom.

Requirements

This is a DSH plugin, not a Chrome / Edge extension or a standalone website.

It requires DSH's client module loader, shared React module, and settings.section slot, plus a browser that supports CSS zoom. The adapter targets internal chat DOM attributes from DSH 0.2.0-rc.2. Compatibility with other DSH versions is not guaranteed. v0.1.0 is the plugin version, not the DSH version.
包里已经带了可直接运行的客户端，你不用自己构建，也不用另外装一份 React。插件界面目前是中文，这份 README 是中英双语的。

安装

方式一：用 DSH 插件页面（推荐）

1. 从 v0.1.0 release 下载 dsh-plugin-chat-zoom-0.1.0.tgz。GitHub 自动生成的源码 ZIP 不是插件安装包。
2. 打开 DSH 侧边栏里的 Plugins，选择外部插件 / bundle 安装入口。
3. 填入下载文件的绝对路径，例如 C:/Downloads/dsh-plugin-chat-zoom-0.1.0.tgz。把示例换成你的真实路径。文件必须能被运行 DSH 的那台电脑访问到；文件放在远程浏览器所在的电脑上，DSH 主机可能访问不到。
4. 确认安装，检查 dsh-plugin-chat-zoom 已启用。如果安装入口接受 HTTP(S) tarball URL，你也可以直接用下面的直链。
5. 刷新 DSH，然后打开 Settings → 缩放 (Zoom)。如果找不到这一节，完全退出 DSH 再重启，只刷新浏览器页面不行。

安装包直链：

https://github.com/YangShen-SWE/dsh-plugin-chat-zoom/releases/download/v0.1.0/dsh-plugin-chat-zoom-0.1.0.tgz

方式二：用 DSH 命令行

如果 dsh 命令可用，桌面端安装可以这样写：

dsh plugin --profile desktop add "dsh-plugin-chat-zoom@https://github.com/YangShen-SWE/dsh-plugin-chat-zoom/releases/download/v0.1.0/dsh-plugin-chat-zoom-0.1.0.tgz" --ignore-scripts

从已下载的 Windows 文件离线安装：

dsh plugin --profile desktop add "dsh-plugin-chat-zoom@file:C:/Downloads/dsh-plugin-chat-zoom-0.1.0.tgz" --offline --ignore-scripts

把路径和 desktop 配置档换成你实际的下载位置和当前配置档。如果你不知道配置档是什么，或者没有 dsh 命令，就用插件页面。这些命令由你自己运行；本仓库不会自动改动 DSH 设置。插件没有安装脚本。

方式三：安装仓库目录

下载并解压源码归档，或者克隆本仓库。在 DSH 插件页面里，把包含 package.json 的那个目录的绝对路径作为安装源。不要选 lib 子目录。

使用

打开 Settings → 缩放 (Zoom)：

| 中文界面标签 | 含义 |
| 聊天倍率 | 选择聊天缩放倍率，从 80% 到 200% |
| 缩小 / 放大 | 每次缩小 / 放大 10 个百分点 |
| 恢复 100% | 重置为 100% 并保存这个值 |
| 清除倍率记忆 | 重置为 100% 并删除本插件保存的偏好 |

改动立即生效。清除偏好不会删除聊天、草稿或其他设置。

| 快捷键 | 操作 | 生效位置 |
| Ctrl + 滚轮上 / 下 | 放大 / 缩小 | 指针位于聊天消息或输入区域上方时 |
| Ctrl + + / - | 放大 / 缩小 | 输入区获得焦点时；或指针悬停在聊天区域且没有其他控件获得焦点时 |
| Ctrl + 0 | 重置为 100% | 键盘焦点规则同上 |

加号快捷键也接受 Ctrl + = 和 Ctrl + Shift + =。支持小键盘的加号和减号。Ctrl+C/V/Z 这类常规滚动和编辑快捷键不会被拦截。

隐私与移除

插件本身不发起网络请求，不上传聊天内容，不收集遥测数据，也不写入服务器设置。只有缩放偏好会保存在本地，键名为 dsh-plugin-chat-zoom:v1:percent，作用于当前浏览器源。它不会跨设备同步，也不会按会话分别保存。

要移除该偏好，先在 Settings → 缩放 → 清除倍率记忆 中清除，再从 Plugins 页面禁用或卸载插件。正常清理会移除插件的监听器、缩放标记、提示和样式；可能需要刷新或重启。禁用时默认保留该偏好。不要为了移除缩放偏好就清空整个 localStorage。

下载包并使用 DSH 的插件管理器可能涉及网络请求。上面的隐私声明只描述本插件的运行时行为。

限制与故障排查

- 没有 Zoom 设置区： 检查安装和启用状态，刷新，必要时彻底重启 DSH。
- 整个页面都在缩放： 浏览器或桌面宿主可能先处理了快捷键。改用设置里的控件。对于宿主已经处理的按键，插件无法可靠拦截。
- 输入法组字期间或嵌入工具中无响应： 输入法组字、全局模态对话框、嵌入编辑器、终端和画布拥有更高优先级。这是有意为之。
- 触控板捏合触发缩放： 有些浏览器把捏合手势上报为 Ctrl 滚轮事件；插件无法可靠区分两者。
- DSH 更新后无响应： 内部 DOM 属性可能已变化。插件会避免退回到整页缩放，可能需要更新适配层。
- 偏好未保存： 浏览器可能阻止本地存储。缩放对当前页面仍可用，但刷新后可能无法恢复。

发布检查覆盖 JavaScript 语法、包引用和客户端模块注册。它们并不代表已在所有 DSH 版本、真实鼠标操作或实际输入法输入下做过真机测试。

仓库与打包

仓库只包含可分发的插件文件和文档。不包含私人对话、缓存、安装/配置备份、迁移工具和开发测试记录。lib/client.js 是完整、可读的预构建客户端实现；原始拆分源码和构建工具不在其中。

| 文件 | 用途 |
| package.json | 版本、入口点和 DSH 元数据 |
| index.js | 宿主入口；功能在浏览器客户端中运行 |
| cordis.patch.yml | DSH 插件注册 |
| lib/client.js | 完整客户端逻辑与设置界面 |
| README.md | 双语说明 |
| LICENSE | MIT 许可证 |

维护者可以在仓库根目录用 Node.js / npm 打包：

npm pack --ignore-scripts

把生成的 .tgz 上传到 GitHub Releases，不要提交到源码仓库。包里包含这份 README 和许可证，但不含 Git 元数据。