DSH 生态强调插件化,Web Profile 是重要的开发入口。但在默认的 Web 界面中,缺乏桌面客户端的视觉质感与交互细节。dsh-ui-enhancer 是一个面向 Web Profile 的桌面体验增强插件,它保留官方 UI 的会话和槽位契约,在此基础上叠加成熟的文件管理、个性化壁纸与桌面宠物功能。
该插件由社区开发者 AlexYin-Tongji 维护,以 MIT 许可证发布。它不隶属于 DeepSeek,安装前需核验代码来源与权限边界。
核心功能¶
桌面化左侧栏
沿用官方会话栏,保留新会话、搜索、工作区分组、历史会话、收起和设置等功能,并增加更接近桌面客户端的视觉处理。
增强右侧工作区
集成 @linxin666/dsh-client-ui-aionui-panel,支持文件树、Git 变更,以及 Markdown、代码、Diff、CSV、PDF、图片、HTML 和 URL 浏览器预览。
个性化壁纸
支持本地图片和 URL,可调节填充方式、位置、模糊、遮罩、透明度,以及基于图片亮度的自适应文字和边框颜色。
桌面宠物
提供独立的宠物功能,支持命名、拖动、隐藏/召唤、缩放、查看会话状态、互动和投喂。上传 PNG、JPEG、WebP、GIF 或 AVIF 形象后,浏览器会自动提取主体(去背景),并以透明形式保存于 IndexedDB,不上传外部服务。宠物会根据对话状态触发气泡对话,并在下方展示活动详情面板。
文件引用
在输入框键入 @ 可搜索当前会话工作区中的文件,并插入结构化文件引用。
界面修复
修复了运行时样式桥导致的文件栏中“最大化/还原”按钮与“折叠”按钮重叠、误触的问题。
安装与配置¶
前置要求
DeepSeek Harness 0.1.0-rc.6 和 Node.js 22.19+ 或 24+。
安装插件
使用官方插件管理命令添加插件:
dsh plugin --profile web add dsh-ui-enhancer
启动服务
安装后需要让正在运行的 Web profile 重新加载。
配置调整
在插件设置中:
* “个性化”页面用于调整壁纸。
* “宠物”页面用于设置桌面伙伴、上传形象和管理投喂。
升级插件
发布新版本后,执行以下命令更新:
dsh plugin --profile web update dsh-ui-enhancer
安全边界¶
- 文件访问控制:文件 API 只接受已注册的工作区根目录,相对路径在读取前会做 realpath 校验,拒绝目录穿越、逃逸符号链接和
.git路径。 - 请求限制:JSON API 和原始文件预览仅接受 loopback 请求。
- 数据存储:本地壁纸和形象库保存在浏览器 IndexedDB 中,不上传。
典型用法¶
- 在对话输入框输入
@,系统会列出当前工作区的文件,选择后可插入引用。 - 在插件设置中进入“宠物”页面,上传一张图片作为宠物形象,随后可在桌面与宠物互动。
结语¶
该插件通过组合社区能力(如 dsh-web-ui)与独立实现(宠物渲染),为 Web Profile 提供了接近桌面端的体验。适合希望增强 DeepSeek Harness Web 端视觉与交互细节的开发者。
链接
* GitHub: https://github.com/AlexYin-Tongji/dsh-ui-enhancer
* 目录: https://www.skillhub.cn/plugins/AlexYin-Tongji/dsh-ui-enhancer