前言¶

在 DSH Web UI 中，代码字号、表格样式、Git 状态、归档会话、MCP 服务器等细节会影响日常使用。dsh-ui-tweaks 是面向 DSH Web UI 的插件，把这些调整集中到设置面板中，并即时生效。它适合需要按工作流调整界面、并在会话内处理 Git、归档、MCP 和任务提醒的 DSH 使用者。

这是什么¶

dsh-ui-tweaks 是 DeepSeek Harness（DSH）Web UI 插件，维护者为 wlj521。它用于在设置面板中实时调整对话界面，包括代码字号、表格样式、GitBar、归档管理、MCP 管理、/init、鲸鱼指示器、任务提醒，以及将缓存命中率显示为两位小数。

DSH 的插件机制允许扩展 Web UI；社区目录是独立站点，不应理解为官方应用商店。

版本与依赖¶

• dsh-ui-tweaks v0.12.0 需要 DSH v0.1.2-alpha.1 及以上。
• 对话时间线和对话框宽度已由 DSH 原生提供；插件移除了自带的重复实现，也移除了消息字体大小与行高设置。
• 宿主暂未升级时，可指定旧版：dsh-ui-tweaks@0.11.2。
• package.json 要求 Node.js >=20。

安装¶

先执行安装命令，再重启一次 dsh web。bundle 插件在进程启动时扫描。

从 npm 安装：

npx -y @deepseek-ai/dsh plugin --profile web add dsh-ui-tweaks

从 GitHub 仓库安装：

npx -y @deepseek-ai/dsh plugin --profile web add github:wlj521/dsh-ui-tweaks

锁定 npm 版本：

npx -y @deepseek-ai/dsh plugin --profile web add dsh-ui-tweaks@0.11.2

锁定 git tag：

npx -y @deepseek-ai/dsh plugin --profile web add github:wlj521/dsh-ui-tweaks#v0.11.2

从 GitHub 安装时，pnpm 可能要求批准该包的构建脚本。把该包加入 profile 的 pnpm-workspace.yaml：

allowBuilds:
  dsh-ui-tweaks: true

然后重新执行 add。

若 pnpm 报符号链接或 hoist 相关错误，可在 profile 的 pnpm-workspace.yaml 中设置：

nodeLinker: hoisted

设置入口¶

设置入口：设置 → 界面调整。

同一份配置也可以在 YAML 中维护：

ui-tweaks:
  tableStyle: claude
  gitBarEnabled: true
  archiveManagerEnabled: true
  initCommandEnabled: true
  whaleIndicatorEnabled: true
  preciseCacheHitEnabled: true
  notificationsEnabled: true

其中 gitBarEnabled、archiveManagerEnabled、initCommandEnabled、whaleIndicatorEnabled、preciseCacheHitEnabled、notificationsEnabled 对应默认关闭的功能，设为 true 后开启。

核心功能¶

代码字号¶

支持 8–32 px，默认 13。作用于代码块，行内代码按比例跟随。旧版百分比配置 codeFontScale 仍兼容；一旦设置新的 px 值，以 px 值为准。

表格样式¶

可选默认样式，或 Claude Desktop 风格。

GitBar¶

GitBar 默认关闭。开启后，当会话工作目录是 git 仓库时，在输入框工具行内显示分支与差异胶囊。

• 分支胶囊支持分支切换、新建分支、拉取、推送和提交图谱。
• 差异胶囊打开差异面板，包含文件列表与逐文件 diff。
• 差异面板支持完整文件视图、拖动宽度，并可在面板内提交或提交并推送。

Git 操作通过服务端 execFile('git', …) 执行，无 shell 且带超时。

终端面板¶

提供真 PTY 终端，基于 xterm.js + WebSocket。终端宽度可拖动，也支持一键半屏。

打开项目¶

在会话头部菜单中，可以用资源管理器、VS Code、IDEA、GoLand、WebStorm、PyCharm 打开当前项目。

归档管理¶

归档管理默认关闭。开启后，设置中会出现「归档」页面，可以查看、恢复、彻底删除已归档会话，也支持全部恢复/全部删除。

归档删除是彻底删除且不可恢复；正在运行的会话会被拒绝删除。

MCP 管理¶

MCP 管理默认关闭。开启后，设置中会出现「MCP 管理」页面，可以添加、编辑、启用/停用、删除或重启 MCP 服务器。

/init¶

/init 默认关闭。开启后，在输入框键入 /init，选择中文或英文提示词后提交。它会分析当前项目，并提交生成 AGENTS.md 的引导提示词。

鲸鱼指示器¶

鲸鱼指示器默认关闭。开启后，输入框右上角会出现品牌小鲸鱼；模型工作时播放游泳动画。

任务提醒¶

任务提醒默认关闭。开启后，会话完成或需要交互时，可通过标签页标题闪烁、系统通知、提示音提醒。

系统通知需要浏览器通知权限；权限申请挂在设置开关的点击手势上。

缓存命中率两位小数¶

该功能默认关闭。开启后，将原生统计条中的缓存命中百分比改写为两位小数。

典型用法¶

开启常用功能¶

进入 设置 → 界面调整，或在 YAML 中配置：

ui-tweaks:
  tableStyle: claude
  gitBarEnabled: true
  archiveManagerEnabled: true
  initCommandEnabled: true
  whaleIndicatorEnabled: true
  preciseCacheHitEnabled: true
  notificationsEnabled: true

使用 GitBar¶

开启后，在输入框工具行显示分支与差异胶囊：

1. 点击分支胶囊，切换或新建分支，也可执行拉取、推送、查看提交图谱。
2. 点击差异胶囊，查看文件列表和 diff。
3. 在差异面板内提交或提交并推送。

使用 /init¶

1. 在输入框键入 /init。
2. 选择中文或英文提示词。
3. 提交到当前会话，用于生成 AGENTS.md 引导提示词。

管理归档¶

在设置「归档」页面，恢复或彻底删除已归档会话。删除前需要确认，因为删除后不可恢复。

管理 MCP¶

在设置「MCP 管理」页面，添加、编辑、启用/停用、删除或重启 MCP 服务器。

适用场景与注意¶

适合以下场景：

• 希望按工作习惯调整 DSH Web UI 的代码字号、表格样式和提示元素。
• 需要在输入框附近处理 git 分支、diff 与提交。
• 需要管理归档会话、MCP 服务器，或在会话完成或等待交互时收到提醒。

注意：

• 插件以当前 dsh 进程权限运行；安装前应检查源码与许可证。
• 本资料未明确许可证类型；package.json 的 files 中包含 LICENSE，但未给出许可证文本。
• GitBar、归档管理、MCP 管理、/init、鲸鱼指示器、任务提醒、缓存命中率两位小数默认关闭，需在设置中开启。
• 安装完成后需重启一次 dsh web。
• 归档删除不可恢复；正在运行的会话会被拒绝删除。
• 任务提醒的系统通知依赖浏览器通知权限。
• 从 GitHub 安装时，可能需要批准 pnpm 构建脚本，或调整 nodeLinker。

相关链接¶

• GitHub：https://github.com/wlj521/dsh-ui-tweaks
• 目录页：https://www.skillhub.cn/plugins/wlj521/dsh-ui-tweaks