Seelen-UI 插件实战指南：4 步接管你的 Windows 桌面-迪斯科星球

Seelen-UI 插件实战指南：4 步接管你的 Windows 桌面

【免费下载链接】Seelen-UIThe Fully Customizable Desktop Environment for Windows 10/11.项目地址: https://gitcode.com/GitHub_Trending/se/Seelen-UI

Seelen-UI 是面向 Windows 10/11 的完全可定制桌面环境，它的插件系统让你逐个替换任务栏、开始菜单与窗口管理，让整个桌面按你的习惯运转。

它是什么 🧩

Seelen-UI 替代的是整个 Windows 桌面外壳，而不是一套主题包：任务栏、dock、应用启动器、平铺窗口管理器、通知面板都能替换、改样式、扩展。

插件在这里是纯声明文件——一个id、一个target、一份plugin数据负载，本身没有任何逻辑。真正解析并执行这些数据的是被指向的 widget：工具栏负责跑沙箱里的 JS 片段，窗口管理器负责遍历布局树，dock 负责渲染图标。说白了，你写的不是"插件系统"，而是给某个具体 widget 的说明书。

最短上手路径 🚀

装好程序：winget install --id Seelen.SeelenUI，或直接从 Microsoft Store 下载。
确认系统装有 WebView 运行时和 Edge（Windows 11 自带；Windows 10 的setup.exe安装包会附带运行时）。
首次启动会进入设置向导，勾选你要的基础组件：工具栏、dock、平铺管理器。
在设置界面把窗口管理器的布局插件换成@default/wm-bspwm，立刻看到布局变化。
打开工具栏插件列表，添加@default/power，点击图标会直接打开 Windows 电源设置页。

winget install --id Seelen.SeelenUI

功能版图 🗺️

按"常用 / 进阶 / 生态"三层梳理，入口路径均指仓库内位置：

层级	功能	入口路径	一句话说明
常用	工具栏小部件插件	`src/static/plugins/tb_*`	电源、CPU、内存、磁盘、网络速度的即时读数
常用	平铺布局插件	`src/static/plugins/wm_*`	grid、bsp、rows、monocle 等静态布局树
常用	dock 插件	`src/static/plugins/weg_*`	开始菜单、回收站、显示桌面等 dock 入口
进阶	工具栏插件开发	documentation/toolbar-plugins.md	scopes + template + onClick 的沙箱 JS 写法
进阶	窗口布局定制	documentation/wm-layouts.md	为 window-manager 声明自定义布局
生态	主题引擎	`src/static/themes/`	CSS/JSON 双格式，覆盖全部 shell 表面
生态	桌面组件	`src/static/widgets/`	时钟、监控、媒体控制直接铺在壁纸层

场景实战 🎯

纯键盘平铺工作区

目标：彻底摆脱用鼠标拖窗口。

用到哪些模块：@seelen/window-managerwidget，外加src/static/plugins/下的wm_bsp、wm_columns、wm_grid布局插件。

具体做法：启用平铺管理器后，在设置中把布局插件从默认的@default/wm-grid切换为@default/wm-bspwm；布局插件的plugin.structure字段声明的是静态布局树，改一个文件就换一种排布。再给高频应用设置按应用规则，固定到指定工作区。

预期效果：新窗口自动归位，缩放、交换、导航全靠快捷键，手不离开键盘。

一目了然的工具栏

目标：系统状态和快捷动作都在工具栏上，点一次就到位。

用到哪些模块：@seelen/fancy-toolbarwidget，以及tb_cpu_usage、tb_memory_usage、tb_network_usage、tb_default_power等工具栏插件。

具体做法：工具栏的插件槽位可以直接填已安装插件的id。以电源插件为例，它的template读取Powerscope 注入的电量数据渲染图标，onClickV2则调用open("ms-settings:powersleep")直达系统设置页——整个行为就写在声明文件里。

预期效果：CPU 占用、网速、电量常驻视野，点图标零层级直达功能页。

桌面即信息板

目标：不打开任何应用，关键信息就在眼前。

用到哪些模块：@seelen/wegdock、weg_show_desktop与weg_start_menu插件、apps-menu启动器。

具体做法：启用 weg 后，dock 上会出现一组由插件驱动的入口：显示桌面、开始菜单、电源、回收站。按快捷键唤起apps-menu，模糊搜索几毫秒内列出应用、文件和命令。

预期效果：从"找程序"变成"喊程序"，常用入口全部收进 dock 一层。

配置速查 ⚙️

插件声明文件的必填字段只有id、target、plugin三个，其余按需加：

id: "@default/power" icon: PiBatteryMediumFill target: "@seelen/fancy-toolbar" plugin: scopes: [Power]

配置项	作用	示例值
`id`	插件唯一标识，工具栏槽位靠它引用	`"@default/power"`
`target`	指定数据交给哪个 widget 消费	`"@seelen/fancy-toolbar"`
`scopes`	声明注入哪些系统数据到脚本作用域	`[Power]`、`[Cpu]`、`[NetworkStatistics]`
`template`	内容脚本的函数体，必须`return`渲染结果	`!include plugin/template.js`
`onClickV2`	点击动作脚本，可`open()`/`invoke()`/`trigger()`	`open("ms-settings:powersleep")`

顺带提一句：onClickV2只是onClick的旧写法别名，两者等价。

避坑指南 🛠️

现象：装完打开是白屏或黑屏。原因：系统 WebView 运行时缺失，或 Windows 版本过旧。解法：走 Windows Update 更新系统后重启；Windows 10 用户务必用setup.exe安装以获得运行时。

现象：自建工具栏插件不显示。原因：必填三字段缺了，或target没指向@seelen/fancy-toolbar。解法：对照插件规范文档补齐id、target、plugin；widget 只路由给它认识的target。

现象：图标在、内容空。原因：template脚本没有return，或所需数据没在scopes里声明。解法：内容脚本必须返回值才渲染；用哪个变量就先声明对应 scope。

现象：Store 版很久没更新。原因：商店更新要过 1–3 个工作日的审核。解法：换 winget 渠道或 Releases 的.msix/.exe包，发版即得；新插件上线前也建议先核对版本兼容性与资源占用。

插件只是声明，widget 才是行为，想深入就照抄src/static/plugins/里现成的metadata.yml起步。下一步：选一个你想常驻工具栏的系统指标，照着tb_cpu_usage的结构写出你的第一个@yourname/xxx插件。

【免费下载链接】Seelen-UIThe Fully Customizable Desktop Environment for Windows 10/11.项目地址: https://gitcode.com/GitHub_Trending/se/Seelen-UI

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析