前言¶
DeepSeek Harness(DSH)的设置面板默认固定在 800×800。在大屏上留白多,在 1366×768 的笔记本上又显得挤。社区里常见的做法是用本地插件注入 CSS,把宽高写死成例如 1360×1000;以后想改尺寸,还得动代码。
dsh-tweakit 把「设置窗口有多大」收进 DSH 自带的设置里:选模式、拖滑杆、实时看效果,偏好走官方 settings 服务持久化。下面介绍它做什么、怎么装、三种尺寸模式分别怎么算。
这是什么¶
dsh-tweakit 是维护者 zhanganmv 发布的 客户端 类 DSH 插件(npm 包名 dsh-tweakit,当前仓库版本 0.2.0,许可证 MIT)。它在 设置 中增加 界面调整 tab,作为后续各类界面 tweak 的统一入口;当前第一个能力是调整设置对话框的尺寸:默认、全屏、自定义 三种模式,带实时预览与自动保存,重启后仍生效。
社区插件目录见 SkillHub 条目;源码与文档在 GitHub:zhanganmv/dsh-tweakit。
核心功能¶
仓库 README 中写明的行为如下,安装前可与文档核对。
-
三种尺寸模式
-default:不注入样式,保持 DSH 原生 800×800。
-full:尽量铺满视口,边距 0–64px 可调。
-custom:自定宽、高与边距;超出视口时自动收缩。 -
实时预览:在 tab 里拖动滑杆,设置面板尺寸立刻变化,无需刷新页面。
-
持久化:通过 DSH 官方 settings 服务写入插件命名空间
dsh-tweakit;换端口或重启应用后配置仍在。 -
可逆:切回「默认」或卸载插件后,注入的样式节点会移除,界面恢复 DSH 原样。
-
作用范围:仅针对设置面板选择器
[role="dialog"][data-shortcut-modal="settings"]注入尺寸相关样式;不 patch DSH 源码,不使用网络请求、不读取凭证、不写业务文件。 -
扩展定位:配置字段为声明式;路线图将字号、圆角、侧栏宽度等列为候选能力(非承诺),设置窗口尺寸在 0.1.0 已标记完成。
首装默认约为 custom / 1360×1000 / margin 24;点「恢复默认」会清空用户层配置并回到该组默认值。
安装与启用¶
插件在 当前 DSH 进程权限 下运行;安装前应查看仓库源码与 MIT 许可证,确认符合你的环境策略。README 写明 DSH 0.2.1-rc.3 在 web 与 desktop profile 实测通过;运行时需 Node ≥ 22.6、pnpm 9。
若曾安装其它强制设置面板尺寸的插件,建议先卸载:它们多靠 !important 竞争同一面板,并存会互相覆盖。
Web profile¶
在 profile 目录为 pnpm workspace root 时,-w 不能省略:
dsh plugin --profile web add -w dsh-tweakit
Desktop¶
桌面端的 desktop profile 由应用独占。请在应用内 插件 页安装 npm 包 dsh-tweakit;不要在桌面应用运行的同时用 CLI 改该 profile。
安装后打开 设置 → 界面调整;若 tab 未出现,重启一次 dsh 进程。
升级与卸载¶
# 升级(缓存命中时可加 --force)
dsh plugin --profile web add -w dsh-tweakit@latest --force
# 卸载
dsh plugin --profile web remove dsh-tweakit
典型用法¶
在 界面调整 tab 中选择模式并调节参数即可;行为与 README 表格一致。
| 模式 | 行为 | 实际尺寸 |
|---|---|---|
default |
完全不接管,保持 DSH 原生 800×800 | 不注入任何样式 |
full |
全屏,保留自定义边距 | w = 100vw - 2·margin;h = 100vh - 2·max(margin, overlayTop) |
custom |
自定义宽、高、边距;超出视口自动收缩 | w = min(width, 100vw - 2·margin);h = min(height, 100vh - 2·max(margin, overlayTop)) |
overlayTop 为 macOS 交通灯按钮预留的顶部安全区;边距为 0 时面板也不会顶到标题栏下。当窗口宽度 小于 768px 时插件不接管尺寸,交给 DSH 自带的移动布局。
经过上面的步骤,日常在 web 或 desktop 上改设置面板大小,不必再维护一份写死宽高的 CSS 插件。
适用场景与注意¶
适合谁:经常在 DSH 里开设置、且希望大屏更舒展或笔记本更紧凑的开发者;也希望用官方 settings 持久化、而不是本地改 CSS 的用户。
兼容与限制(来自 README):
- 只使用公开扩展点:
settings.section槽位、ctx.configForms、ctx.locale。 - 依赖设置面板的
data-shortcut-modal="settings"标记;若未来 shell 更名,tab 可能提示「未检测到设置面板标记」,需等插件跟进适配。 - 更早于 0.2.1-rc.3 的 DSH 版本未在文档中验证。
DSH 生态主张「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系,安装来源以你信任的目录与 npm 包为准。
结尾¶
dsh-tweakit 把设置窗口尺寸从「改 CSS 插件」变成设置里可预览、可保存的三档模式,并预留同一 tab 承载更多界面调整。需要安装命令与模式公式时,以仓库 README 为准。
- 目录页:https://www.skillhub.cn/plugins/zhanganmv/dsh-tweakit
- GitHub:https://github.com/zhanganmv/dsh-tweakit