前言¶

在 DeepSeek Harness（DSH）Web UI 中，如果希望不进入设置页、直接在会话标题栏调整对话内容区宽度，magicOF2/dsh-chat-width-customizer 提供了一个标题栏按钮。它用于循环切换宽度档位，并让对话消息区、底部输入框（Composer）、用户气泡同步加宽。

下面介绍插件定位、核心功能、安装启用和典型用法。

插件定位¶

插件名称为：

magicOF2/dsh-chat-width-customizer

维护者为 magicOF2，许可证为 MIT。它面向 DSH Web UI，在会话标题栏的工具区增加宽度切换按钮。根据已核实资料，插件注册在以下槽位：

conversation.session.header.utilities

这是纯增量添加。

核心功能¶

下面列出已核实的功能点：

• 点击标题栏按钮循环切换宽度档位，档位范围为 748 → 1600 px，无需进入设置页。
• 对话消息区、底部输入框（Composer）、用户气泡同步加宽。
• 宽度为全局状态，跨会话保持一致。
• 跨标签页通过 storage 事件实时同步。
• 实际宽度按视口自动钳制，钳制规则为视口宽度减 24px，下限为 320px；窗口缩放时实时重算，按钮仍显示所选档位。
• 选择写入 localStorage，刷新页面或重新打开浏览器后恢复。
• 使用 DSH 主题 CSS 变量，浅色/深色模式自动适配。
• 注册在 conversation.session.header.utilities 槽位，属于纯增量添加。

默认宽度档位¶

默认档位为：

[748, 896, 1024, 1152, 1280, 1440, 1600]

单位为 px。若要自定义宽度档位，需要编辑以下文件顶部的 PRESETS 常量：

lib/client.js

安装与启用¶

先使用 GitHub 安装命令：

dsh plugin --profile web add https://github.com/magicOF2/dsh-chat-width-customizer.git

安装后需要重启：

dsh web

并在浏览器里执行强制刷新：

Ctrl+Shift+R

经过上面的步骤，插件随 GUI 自动加载，无需任何手动启用。

典型用法¶

1、打开任意会话，点击标题栏右侧的「宽度 · NNNpx」按钮。

2、每点一次循环到下一档：

748 → 896 → 1024 → 1152 → 1280 → 1440 → 1600 → 748 …

3、切换会话时，宽度与按钮显示保持一致。

4、刷新页面后，自动恢复上次选择的宽度。

兼容性与运行边界¶

已核实兼容以下环境：

DeepSeek Harness 0.1.0-rc.6 及以上（开发环境验证版本）
Cordis 4.x

package.json 中声明的 peerDependencies 为：

{
  "@deepseek-ai/cordis": "^4.0.1",
  "react": "^18.2.0"
}

该插件数据仅写入 localStorage，不依赖 API Key，无数据上传。作为 DSH 插件，插件以当前 dsh 进程权限运行；安装前应检查源码与 MIT 许可证，确认符合你的使用环境。

链接¶

社区目录页：

https://www.skillhub.cn/plugins/magicOF2/dsh-chat-width-customizer

GitHub：

https://github.com/magicOF2/dsh-chat-width-customizer