dsh-ui-enhancer

DSH UI Enhancer

面向 DeepSeek Harness Web 的桌面体验增强插件。它保留官方 UI 的会话和槽位契约，在其上组合成熟社区能力，并补充统一的个性化和文件引用体验。

[!IMPORTANT] 这是由社区独立维护的非官方插件，不隶属于 DeepSeek，也不代表其审核、认可或推荐。安装第三方插件前请核验代码来源、依赖和权限边界，并自行评估使用风险。

功能

• 左侧栏沿用官方会话栏，保留新会话、搜索、工作区分组、历史会话、收起和设置，并增加更接近桌面客户端的视觉处理。
• 右侧工作区使用 @linxin666/dsh-client-ui-aionui-panel，支持可缩放文件树、Git 变更，以及 Markdown、代码与 Diff、CSV、PDF、图片、HTML 和 URL 浏览器预览。
• 壁纸支持本地图片和 URL、填充方式、位置、模糊、遮罩、界面透明度，以及基于图片亮度的自适应文字和边框颜色。
• 桌面宠物使用 @linxin666/dsh-pet，内置鲸鱼娘，并支持发现符合 pet.json 契约的自定义形象；可命名、拖动、隐藏/召唤，并有会话状态动画、摸头、投喂、亲密度和小鱼干库存。
• 在输入框键入 @ 可搜索当前会话工作区中的文件，并插入结构化文件引用。

右侧工作区、宠物和它们的设置兼容桥由本包的 bundle patch 自动组合。若 Web profile 已经安装 @linxin666/dsh-web-ui-all，它们会通过社区插件的 mount-once 机制复用，不会重复挂载。

安装

要求 DeepSeek Harness 0.1.0-rc.6 和 Node.js 22.19+ 或 24+。

dsh plugin --profile web add dsh-ui-enhancer
dsh web

安装后需要让正在运行的 Web profile 重新加载。插件设置中的一级“个性化”页面用于调整壁纸；右侧面板和宠物各自的完整设置页由对应社区插件提供。

从源码开发

git clone https://github.com/AlexYin-Tongji/dsh-ui-enhancer.git
cd dsh-ui-enhancer
pnpm install
pnpm build
dsh plugin --profile web add link:$(pwd)

修改源码后运行 pnpm build 并刷新页面即可。

安全边界

• 文件 API 只接受 Harness 已注册的工作区根目录。
• 所有相对路径在读取前都会做 realpath 校验，拒绝目录穿越、逃逸符号链接和 .git 路径。
• JSON API 和原始文件预览仅接受 loopback 请求。
• 文件搜索有目录、深度、扫描量和结果数上限；文本读取有 200,000 字符上限。
• 本地壁纸保存在浏览器 IndexedDB 中，不上传到外部服务。

开发检查

pnpm typecheck
pnpm test
pnpm build

Host 入口是 src/index.ts，浏览器入口是 src/client/index.ts，共享协议位于 src/core/contracts.ts。

社区与许可

问题和建议请提交到 GitHub Issues。参与开发前请阅读 CONTRIBUTING.md。

右侧工作区、设置兼容桥和桌面宠物来自 dsh-web-ui 社区项目。本插件自身以 MIT 许可发布；组合依赖继续遵循各自的许可证。