前言¶
在 DeepSeek Harness（DSH）NEXT 上，模型连接、网络权限和对话归档分散在宿主自带界面里；若还想换壁纸、磨砂面板、桌宠或启动动画，往往要另找方案或改零散配置。Beelli X UI（仓库 beellix-dev/beellix-dsh-ui，npm 包名 @beellix-ai/dsh-web-gui）通过原生 Bundle 替换设置页与侧栏入口，把上述能力收进同一套可搜索的设置结构，并在本插件命名空间里保管皮肤、宠物与动效相关配置。
这是什么¶
Beelli X UI 面向 Windows 上的 DSH NEXT，由维护者 Beellix-dev 发布，当前资料记载版本 0.1.1，许可证 MIT。它不负责替代宿主的模型请求与计费逻辑，而是通过公开服务接口读写 DSH 原有的模型、网络、权限等设置；外观类能力（主题、皮肤、字体、吉祥物、启动效果）使用插件自有配置，媒体文件落在所属 DSH 环境的 DSHWebGui/ui/media 路径下。
社区目录将其归类为「趣味换装」；GitHub 公开星标数为 1（以目录页与仓库页面为准）。
设置界面怎么组织¶
安装并启用后，左栏选分类，顶部标签在同一大类下切换子页。窗口较窄时可用下拉选择分类。「查找设置」支持按分类、子页或设置项名称定位。
| 左栏入口 | 右侧内容 |
|---|---|
| 常规 | 常规、对话与输入、快捷键、通知 |
| 外观 | 主题、皮肤、字体、吉祥物、效果 |
| 模型 | 已添加连接、厂商预设或自定义连接；其他插件提供的模型配置会出现在「插件模型」标签 |
| 网络、权限、数据 | 进入对应 DSH 设置 |
| 维护 | 诊断与维护、运行环境、关于与更新 |
| 插件配置 | 已加载插件配置及插件提供的设置入口 |
| 已归档的聊天 | 按原工作区查看归档，支持搜索、恢复和删除 |
同一页还可切换、添加插件市场目录；已安装的官方与第三方插件分开展示，侧栏控件可按需显隐和排序。
核心功能¶
皮肤¶
路径：设置 → 外观 → 皮肤。可预览内置插画，或将图片、MP4 导入「我的皮肤」。在壁纸设置中勾选覆盖左侧栏、聊天区、右侧工作台中的哪些区域；在「主题」中调整配色、磨砂与透明度，并将搭配保存为皮肤方案。皮肤采用共享背景与独立面板，支持静态图、MP4 与 CSS 磨砂；资料记载三款内置插画原生尺寸为 1672×941。本插件不提供 Wallpaper Engine Scene/Web 渲染引擎。
桌宠（吉祥物）¶
路径：设置 → 外观 → 吉祥物。上传动态 WebP（100 MB 以内）或 GIF（20 MB 以内）即可添加宠物，该动图为默认动作。可保留多只、选择一只显示，并为每只添加额外动作。右键桌宠可选动作，播放一轮非默认动作后会回到默认循环。
启动效果¶
路径：设置 → 外观 → 效果。可启用内置启动动画，或上传 MP4、GIF。时长可选 1、2、3 或 5 秒；设置内可预览，启用后于下次启动播放，播放过程中可跳过。
模型连接¶
路径：设置 → 模型。可选用 DeepSeek、OpenAI、Anthropic 等厂商预设，或填写自定义服务地址与接口协议。配置后可从服务拉取型号并勾选，亦可手动填写模型 ID。模型目录来自实际服务接口；连接是否可用取决于厂商地址、凭据与模型权限，请求与费用由所选厂商处理。
归档聊天¶
在「已归档的聊天」中按原工作区分组浏览与搜索；取消归档会恢复到原工作区。确认删除会清理本地聊天记录（日志、归档标记、工作区关联及对应缓存），支持单条与批量删除。资料记载该删除流程已在 Windows DSH NEXT 默认 desktop Profile 与标准本地会话存储上验证；工作区目录内的项目文件删除后仍保留。其他组件持有写入锁时，对应对话会保留并提示原因。
安装与启用¶
本插件以 DSH 进程权限运行，安装前建议阅读仓库源码与 MIT 许可证。官方 README 给出两种方式，勿使用未在文档中出现的 dsh plugin add github:... 拼接命令。
预构建包：从 GitHub Release v0.1.1 下载 beellix-dsh-ui-0.1.1.tgz，在 DSH 的「插件 → 添加插件」中导入。
npm：在 DSH「添加插件」中输入：
@beellix-ai/dsh-web-gui
若镜像源找不到包，在安装源中改用 npm 官方注册表 https://registry.npmjs.org/，或改用上述预构建包。
宿主提示重启时，先保存当前工作再正常重启。资料建议同一时间只启用一个接管设置页或侧栏的界面插件，以免入口冲突。
兼容与边界¶
实机验收基线为 Next 2.0.21-next、Harness / frontend 0.2.1-rc.4、Windows。package.json 声明 engines.dsh 为 >=0.2.1-rc.4 <0.3.0，该范围不表示每个中间版本或其他操作系统均完成验收。
配置使用独立命名空间 dsh-web-gui；停用或卸载后宿主恢复原生入口，用户媒体与设置保留，DSH 会话、工作区文件与模型凭据仍由宿主管理。需要清除导入媒体时，请在卸载前从素材库移除。加载异常时，可从宿主恢复页面停用本包后重启。
环境模块最多显示三个已注册项；资料记载当前内置真实环境模块仅为工作区，环境贡献接口只转交呈现与新会话操作，不提供环境后端或数据隔离。
典型操作路径¶
下面按 README 中的演示路径归纳，便于在已安装插件后复现。
- 换肤：设置 → 外观 → 皮肤 → 选内置或导入素材 → 外观 → 主题 调磨砂与配色 → 保存方案。
- 加桌宠：设置 → 外观 → 吉祥物 → 上传 WebP/GIF → 选择显示中的一只 → 右键桌宠切换动作。
- 启动动画：设置 → 外观 → 效果 → 选时长并预览 → 启用 → 下次启动生效。
- 接模型：设置 → 模型 → 选预设或自定义 endpoint → 拉取或手填模型 ID。
- 管归档：设置 → 已归档的聊天 → 按工作区搜索 → 恢复或批量删除（删除不可从插件侧恢复会话数据）。
适用场景与注意¶
适合在 Windows 上长期使用 DSH NEXT、希望设置集中检索，并需要壁纸、磨砂、桌宠、启动动效与模型页同一入口的用户。不适合依赖 Wallpaper Engine 场景渲染、或非 Windows 且未自行验收 engines.dsh 范围的环境。
插件安装与卸载由 DSH 管理；不会对 Beellix 企业目录做自动迁移。壁纸文字采样不能保证任意复杂图像上所有文字均清晰可读。
