前言¶
DSH 的插件生态可以把控制台界面和常用操作做成可插拔模块。对日常使用 DeepSeek Harness Web GUI 的人来说，常见问题是：余额状态不够直观、文档路径需要手动贴入输入框、插件开关缺少二次确认。
Sidor_UI 是 AKI2253 维护的 DeepSeek Harness Web GUI 主题皮肤仓库。它提供 SIDOR 星野主题、余额提示、文档路径附加、插件管理按钮，以及附属插件扩展位。
这是什么¶
Sidor_UI 的定位是：DeepSeek Harness Web GUI 的 SIDOR 星野主题皮肤，以独立仓库分发。
它主要解决几件事：
- 给 Web GUI 增加星野主题与开屏动画。
- 把余额徽章、低余额警告放进界面。
- 在输入框附近提供「文档」路径附加，供 agent 工具读取。
- 在设置页插件列表中注入关闭、启用、卸载按钮。
- 为附属插件提供设置页和侧边栏扩展位。
本仓库整体以 MIT 发布。SIDOR 品牌标识归本项目所有。署名与使用边界见各皮肤 NOTICE / LICENSE。
核心功能¶
主题与状态提示¶
Sidor_UI 包含以下界面能力：
- 开屏粒子动画（1/50 红色太阳风暴彩蛋）
- 常驻星野
- 余额徽章
- 设置页流光特效
- 低余额四重红色警告
这些能力主要服务于 Web GUI 的状态展示，让余额和皮肤效果更直观。
文档路径附加¶
Sidor_UI 提供输入框文档路径附加能力。
使用方式是：
- 点击「文档」按钮。
- 选择或输入文件、文件夹路径。
- 将路径贴入输入框。
- 由 agent 工具直接读取。
静态插件形态下，文件落盘到工作区不是主要方式，因此路径选择是主要方式。动态插件形态额外保留上传到工作区 .sidor-uploads/ 的能力，文件落盘后可贴相对路径。
插件管理按钮¶
在官方「设置 → 插件」列表中，Sidor_UI 会为插件卡片注入「关闭 / 启用 / 卸载」按钮。
流程是：
- 进入设置页的插件列表。
- 点击插件卡片上的「关闭 / 启用 / 卸载」按钮。
- 弹出二次确认菜单。
- 确认后由当前会话 agent 执行。
确认后的操作可能包括修改 cordis.patch.yml 或删除包。需要权限时，DSH 会弹出授权。完成后重启 DSH 生效。
动态插件能力¶
Sidor_UI 的全功能形态使用动态插件。
关键标识和文件如下：
pluginId：sidf-4- Client 代码：
src/sidor-fx-client.js - Host 代码：
src/sidor-fx-host.js
动态插件支持 host curl 查询和文件落盘，并额外保留上传到工作区 .sidor-uploads/ 的能力。
需要注意：动态插件进程重启后，需要在 Cordis 面板重新运行。
附属插件扩展位¶
Sidor_UI 按可扩展平台设计。
它提供以下扩展能力：
- 官方插槽的
list型插槽支持多插件共存。 - 附属插件可接入设置页
settings.section。 - 附属插件可接入侧边栏
sidebar.footer.action。 - 附属插件可复用余额数据。
目前资料中给出的附属插件是 Sidor_box，包名为 sidor-box，用于设置页「工具箱」分区，当前状态是选页先行，功能待填入。
安装与启用¶
懒人版¶
把 DSH 打开后，可以直接让助手执行安装。
将下面内容发送给 DSH 助手：
安装一下这个皮肤包：https://github.com/AKI2253/Sidor_UI
说明：DSH 助手会 git clone / 读取该仓库并自动完成安装。仓库自带 sidor-install 技能，会自动询问确认、交代许可后再安装。
本地版（PowerShell，无需 GitHub）¶
如果你已经在本地拿到仓库，可以用 PowerShell 脚本安装或卸载。
先切到仓库目录：
cd <Sidor_UI 仓库路径>
安装：
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1
卸载：
powershell -ExecutionPolicy Bypass -File .\scripts\install.ps1 -Remove
命令版（需 pnpm）¶
命令版需要提前具备 pnpm。
先切到 Harness 目录：
cd <harness 目录>
再添加插件：
dsh plugin --profile web add <Sidor_UI 仓库路径>
全功能版（动态插件）¶
全功能版对应动态插件形态。
关键项是：
pluginId: sidf-4
Client: src/sidor-fx-client.js
Host: src/sidor-fx-host.js
它支持 host curl 查询和文件落盘，并额外保留上传到工作区 .sidor-uploads/ 的能力。
进程重启后，需要在 Cordis 面板重新运行。
典型用法¶
使用「文档」按钮¶
「文档」按钮用于把文件或文件夹路径加入输入框。
使用步骤：
- 点击「文档」按钮。
- 选择文件或文件夹，或直接输入路径。
- 将路径贴入输入框。
- 由 agent 工具直接读取。
静态插件形态下，路径选择是主要方式。动态插件形态额外保留上传到工作区 .sidor-uploads/ 的方式，文件落盘后可贴相对路径。
管理插件¶
进入 DSH 设置页的插件列表后，可以在插件卡片上执行：
- 关闭
- 启用
- 卸载
点击后会弹出二次确认。确认后，操作指令会发送给当前会话 agent 执行，例如修改 cordis.patch.yml 或删除包。需要权限时，DSH 会弹出授权。完成后重启 DSH 生效。
接入附属插件¶
附属插件可以基于 Sidor_UI 的扩展位接入。
已给出的示例是：
- 插件：
Sidor_box - 包名：
sidor-box - 位置：设置页「工具箱」分区
- 当前状态：选页先行，功能待填入
附属插件可接入 settings.section、sidebar.footer.action，并复用余额数据。
适用场景与注意¶
适合以下使用方式：
- 想让 DeepSeek Harness Web GUI 使用 SIDOR 星野主题。
- 想在界面上看到余额徽章和低余额警告。
- 想让 agent 读取输入框中附加的文档路径。
- 想在设置页插件列表中直接关闭、启用或卸载插件。
- 想为后续附属插件保留设置页和侧边栏扩展位。
使用前注意：
- 命令版需要
pnpm。 - 静态插件形态无法把文件落盘到工作区，文档路径附加主要通过路径选择完成。
- 动态插件进程重启后，需要在 Cordis 面板重新运行。
- 该皮肤会随当前 DSH 进程权限运行；需要权限时，DSH 会弹出授权。
- 安装前应检查仓库源码与许可证。
- 完成后通常需要重启 DSH 生效。
结尾¶
Sidor_UI 的价值在于把主题、余额提示、文档路径、插件管理和附属插件位放在同一个 Web GUI 皮肤仓库里，适合作为 DSH 控制台的可扩展皮肤使用。
GitHub 仓库：
https://github.com/AKI2253/Sidor_UI
插件线索中的目录页：
https://www.skillhub.cn/plugins/AKI2253/Sidor_UI
