StarPie主题工作室入门:5套风格与12项配色自定义,免费打造你的专属轮盘主题
StarPie主题工作室入门:5套风格与12项配色自定义,免费打造你的专属轮盘主题
StarPie 是一款现代化的 Windows 鼠标轮盘手势系统,而它的主题工作室(Theme Studio)则让你免费完成轮盘主题定制:在设置控制台里一键切换 5 套内置美术风格,再用 12 项配色加进阶参数打造专属配色方案,无需写一行代码。
主题工作室是什么?
打开 StarPie 的设置控制台 → 外观样式,顶部就是「主题工作室」。它把三件事做成了一套:
- 风格卡片:每张卡片带缩略轮盘、风格名与色板,当前生效的风格会标记「使用中」
- 实时预览:右侧画布会同步渲染控件样例与轮盘效果,改什么看到什么
- 管理操作:应用风格、复制并编辑、新建、重命名、删除、导入、导出,一排按钮全在这里
应用风格后,设置窗口、宿主弹窗、托盘提示框和轮盘会即时更新,选择会被保存,下次启动继续使用。
5 套内置风格,一键切换
内置风格在 WinPieGestures/ArtStyles/ArtStyleCatalog.cs 中定义,覆盖从极简到复古的完整光谱:
| 风格 | 视觉特点 | 适合场景 |
|---|---|---|
| 纸感极简 Paper | 暖纸底色、细线、小圆角与红棕强调色 | 默认风格,干净耐看 |
| 曜石科技 Obsidian | 深色底、青绿高亮与轨道装饰 | 夜间办公、暗色桌面 |
| 森林柔和 Grove | 鼠尾草配色、柔圆卡片与哑光轮盘 | 长时间使用不刺眼 |
| 冰川玻璃 Glacier | 冰蓝配色、半透明轮盘与细刻度 | 喜欢通透玻璃质感 |
| 复古像素 Pixel | 方角卡片、粗线、硬阴影与像素刻度 | 怀旧游戏氛围 |
操作流程非常简单:
- 点击任意风格卡片查看示例
- 点击「应用风格」立即生效(无需重启)
- 不满意?再点另一张卡片即可切换回来
12 项配色自定义:从内置风格变成「我的版本」
想完全个性化,就用卡片下方的「复制并编辑」——它会基于内置风格创建一份独立草稿,原风格始终保留、可随时恢复。
编辑区提供 12 个色点,对应界面的完整语义层:
- 界面层:界面背景、卡片与输入框、侧边栏、正文文字、辅助文字、强调色、界面边框
- 轮盘层:扇区底色、轮盘描边、扇区高亮、轮盘文字、高亮文字
每一项都可以:
- 直接输入
#RRGGBB或#AARRGGBB十六进制色值 - 点击色点打开系统选色器
- 参考 themes/ 目录下 5 份完整主题文件,比如 themes/glacier.starpie-theme.json 就是冰川玻璃的官方配色
编辑器右侧会即时显示草稿效果;当前主题在保存前不受影响。如果文字对比度不足,界面会给出提示;无效色值会直接禁用保存按钮,避免存下坏配置。
进阶参数:字体、圆角、阴影与装饰
展开「进阶:字体、线条与材质」,还能调整整套视觉的"质感":
| 参数 | 可调范围 | 作用 |
|---|---|---|
| 字体 | 已安装的字体名 | 支持逗号指定回退字体,如 Cascadia Mono, Consolas |
| 深色基底 | 开/关 | 标题栏与托盘是否走暗色 |
| 圆角 | 0–24 | 0 是直角,数值越大越圆润 |
| 描边粗细 | 0.5–3 | 线条轻细还是粗重 |
| 阴影柔和度 / 位移 | 0–30 / 0–6 | 控制投影的扩散与距离 |
| 阴影强度 | 0–0.5 | 0 即无阴影 |
| 轮盘不透明度 | 0.6–1 | 调低可获得半透明玻璃感 |
| 装饰风格与强度 | 5 种类型 / 0–1 | Paper、Orbit、Soft、Glass、Pixel;强度 0 可关闭装饰 |
调完点「保存并应用」即可创建或更新自定义主题;点「取消」放弃草稿,「撤销本次修改」则恢复到进入编辑时的值,不用担心改坏。
导入导出:把主题文件分享给朋友
自定义主题支持重命名、删除和导出:
- 导出生成
.starpie-theme.json文件(上限 64 KiB),只包含外观数据,不携带动作或个人配置 - 导入同样支持
.starpie-theme.json或普通.json,每次导入都会创建一个全新的独立主题,不会覆盖已有风格,选中后点应用即可
项目内置了 5 份可直接导入的官方示例主题,位于 themes/ 目录(themes/README.md 有简要说明):
- themes/paper.starpie-theme.json
- themes/obsidian.starpie-theme.json
- themes/grove.starpie-theme.json
- themes/glacier.starpie-theme.json
- themes/pixel.starpie-theme.json
单次最多可保存 128 个自定义主题。注意:删除后无法恢复,需要保留的主题建议先导出。
轮盘跟随整体风格:与旧设置的兼容开关
工作室里有一个「轮盘跟随整体风格」开关,它决定整体主题是否也应用到轮盘:
- 开启:设置窗口与轮盘共用同一套风格,视觉统一
- 关闭:轮盘继续使用原来的独立主题与配色设置,走「外观与形态」页的旧编辑器
即使开启跟随,独立二级轮盘的配色、每扇区自定义的文字颜色与字体仍然优先,不会丢失。风格只调整材质、字体与装饰,不改变轮盘尺寸、扇区角度、命中区域和动作映射。
常见问题
问:自定义主题最多能存多少个? 答:128 个。超出的话建议导出备份后删除不再使用的主题。
问:删除正在使用的主题会怎样? 答:会自动回退到默认的纸感极简 Paper,程序不会崩溃。
问:导入的主题文件格式不对会怎样? 答:主题文件在写入前会校验格式版本、颜色值与数值范围,未知格式或非法字段会被拒绝并提示,不会污染你的配置。
问:主题文件里能带什么? 答:只有 12 项配色、字体、圆角、描边、阴影、轮盘不透明度与装饰参数。动作配置、触发方式和程序方案都属于你自己的配置,不在主题文件中。
写在最后
StarPie 主题工作室把「整体风格」和「精细定制」分成了两步走:先 5 秒挑一套合眼缘的内置风格,再花 5 分钟把 12 项配色调成专属配色——从纸感极简到冰川玻璃,全程免费、全程无需写代码。完整说明可参阅 docs/art-style-themes.md,主题功能源码位于 WinPieGestures/ArtStyles/(核心组件包括 ThemeStudio.xaml 与 ArtStyleService.cs),供想深入了解实现细节的朋友查阅。


