前言¶
DeepSeek Harness (DSH) 采用随机端口运行,这导致浏览器 localStorage 在重启后会失效,从而无法保存用户对 UI 的定制记录。dsh-simplify 插件通过将移除记录写入文件系统,解决了这一问题,确保界面配置在重启后依然生效。
插件简介¶
dsh-simplify 是 DeepSeek Harness 的界面简化插件,由开发者 Anna-la 维护,采用 MIT 许可证。
其核心价值在于:进入清理模式后,可以通过右键移除页面上的冗余元素,并利用文件系统持久化这些记录。用户可以在「设置 → 简化」中查看交互式预览,并将被移除的元素原样恢复。
核心功能¶
1. 清理模式¶
- 入口:首页左下角、设置按钮上方有一个「简化」图标按钮(无文字),点击可进入或退出清理模式。
- 操作:进入模式后,鼠标悬浮在页面元素上会显示红色描边。对元素单击右键即可将其移除,左键点击、拖拽等操作不受影响。
- 退出:按
Esc键或再次点击「简化」图标即可退出模式。
2. 记录持久化与防复活¶
- 跨重启保留:移除记录会跨重启持久化,写入
~/.dsh-simplify/records.(或通过环境变量DSH_SIMPLIFY_DATA_DIR指定的目录)。 - 实时防复活:插件使用
MutationObserver实时扫描页面变化。只有与移除时完全相同的元素才会被重新清除,页面重排或位置漂移的相邻元素不会被误删。 - 兜底机制:浏览器
localStorage仅作为本地镜像与离线兜底,重启后记录依然有效。
3. 设置与恢复¶
- 查看记录:在设置页侧栏新增「简化」页,列出所有被移除的元素。
- 交互预览:每条记录带有行内预览区,点击预览可体验元素原本的操作(如切换设置页),但不会还原位置。
- 刷新兼容:即使刷新页面,被移除的元素依然可交互,插件会自动收养重建的等价元素。
- 恢复操作:支持对单条记录「恢复」,或勾选多条后「批量恢复」。
安装与启用¶
使用 DSH 命令行工具安装:
dsh plugin --profile web add github:Anna-la/dsh-simplify
安装完成后重启 Harness(或刷新 Web 页面)即可生效。
典型用法¶
- 点击左侧底部设置按钮上方的「简化」图标进入清理模式。
- 移动鼠标,对不需要的元素单击右键进行移除。
- 按
Esc或再次点击图标退出清理模式。 - 打开「设置 → 简化」,在侧边栏查看已移除列表。点击预览测试功能,或勾选元素进行批量恢复。
适用场景与注意¶
- 适用场景:需要定制 DSH 界面,移除不必要的导航栏、广告位或干扰信息的用户。
- 数据路径:移除记录默认写入
~/.dsh-simplify/records.。 - 环境变量:可通过
DSH_SIMPLIFY_DATA_DIR修改数据目录。 - 权限要求:插件以当前 DSH 进程的权限运行,安装前建议检查源码与许可证。
- 侧边栏适配:当侧边栏折叠时,页脚按钮会与其它插件统一排成一列,互不冲突。