StarPie主题工作室完全指南:5套美术风格定制与主题导入导出10分钟上手
StarPie主题工作室完全指南:5套美术风格定制与主题导入导出10分钟上手
StarPie 主题工作室让这款 Windows 鼠标轮盘手势系统的外观随心而变:一键切换 5 套内置美术风格,也能自定义 12 项配色、字体与材质,还能通过 JSON 文件导入导出你的专属主题。本指南带你 10 分钟完成全部上手。
本手册内容 📖:
- 5 套内置美术风格总览
- 3 步一键切换风格
- 从零创建自定义主题
- 主题文件的导入与导出
- 常见问题
5 套内置美术风格总览
打开设置控制台,进入「外观样式」页面,顶部就是「主题工作室」。五套内置风格各自定义了界面与轮盘的完整视觉语言:
| 风格 | 视觉特点 |
|---|---|
| 纸感极简 Paper | 暖纸底色、细线、小圆角与红棕强调色 |
| 曜石科技 Obsidian | 深色底、青绿高亮与轨道装饰 |
| 森林柔和 Grove | 鼠尾草配色、柔圆卡片与哑光轮盘 |
| 冰川玻璃 Glacier | 冰蓝配色、半透明轮盘与细刻度 |
| 复古像素 Pixel | 方角卡片、粗线、硬阴影与像素刻度 |
每张卡片都带缩略轮盘与色板,当前使用的风格会标注「使用中」。
如何一键切换轮盘美术风格
切换风格只需 3 步,全程无需重启:
- 在「主题工作室」中点击任意风格卡片,选中它;
- 点击「应用风格」,设置窗口、已打开的宿主弹窗与轮盘立即更新;
- 完成 ✅ —— 选择会自动保存,下次启动继续使用。
小技巧:卡片下方的「轮盘跟随整体风格」开关控制整体主题是否作用于轮盘。关闭后,轮盘继续使用原来的独立配色设置;独立二级轮盘配色与每扇区的文字颜色、字体覆盖始终优先。
如何创建自定义主题:复制、调色与保存
想拥有只属于你的风格?整个编辑过程在草稿中进行,保存前当前主题不受任何影响:
- 创建草稿:选中内置风格后点「复制并编辑」,或直接点「新建」。内置风格始终保留、不受影响;
- 输入主题名称,再调整 12 项配色 —— 支持
#RRGGBB或#AARRGGBB色值,也可以点击色点打开选色器; - 点「保存并应用」,主题即刻创建并生效。「取消」放弃草稿,「撤销本次修改」恢复进入编辑时的值。
右侧的实时画布会随草稿同步刷新,所见即所得。自定义主题还支持重命名、删除和导出,单次最多可保存 128 个。
12 项配色与进阶参数说明
十二项配色分别对应界面的不同区域:界面背景、卡片与输入框、侧边栏、正文与辅助文字、强调色、界面边框,以及扇区底色、轮盘描边、扇区高亮、轮盘文字与高亮文字。编辑器会实时检查正文对比度,对比度不足时给出提示。
展开「进阶:字体、线条与材质」还能调整字体(填写已安装字体名称,可用逗号指定回退字体)、深色基底、圆角、描边、阴影、轮盘不透明度与装饰强度:
| 参数 | 取值范围 |
|---|---|
| 圆角 | 0–24 |
| 描边粗细 | 0.5–3 |
| 阴影柔和度 / 位移 | 0–30 / 0–6 |
| 阴影强度 | 0–0.5 |
| 轮盘不透明度 | 0.6–1 |
| 装饰强度 | 0–1(0 表示关闭装饰) |
如何导入导出主题文件
- 导出:生成
.starpie-theme.json文件; - 导入:同样支持
.json。每次导入都会生成新的主题标识,不会覆盖已有主题;导入后选中卡片并点击应用即可。
主题文件只包含外观参数,不携带动作、插件或个人配置,可以放心分享。文件上限 64 KiB,格式版本固定为 1;无效颜色、越界数值或未知格式版本会在写入配置前被明确拒绝,绝不影响当前主题。
themes/ 目录提供 5 份可直接导入的完整示例(如 themes/paper.starpie-theme.json),格式如下:
{
"schemaVersion": 1,
"theme": {
"id": "paper",
"name": "Paper",
"isDark": false,
"colors": {
"background": "#F5F1E8",
"surface": "#FFFCF5",
"sidebar": "#EDE7DA",
"text": "#252820",
"muted": "#626458",
"accent": "#B54735",
"border": "#D2CCBE",
"wheelBackground": "#FFFCF5",
"wheelBorder": "#858373",
"wheelHighlight": "#B54735",
"wheelText": "#252820",
"wheelHighlightText": "#FFFFFF"
},
"fontFamily": "Microsoft YaHei UI, Segoe UI",
"cornerRadius": 4,
"strokeWidth": 1,
"shadowBlur": 8,
"shadowDepth": 2,
"shadowOpacity": 0.1,
"wheelOpacity": 0.96,
"decoration": "Paper",
"decorationStrength": 0.5
}
}
装饰类型支持 Paper、Orbit、Soft、Glass、Pixel 五种。
常见问题(FAQ)
Q:换主题会影响我的扇区动作和手势吗?
不会。主题只调整材质、字体与装饰,不改变轮盘尺寸、扇区角度、命中区域、动作映射和触发距离。
Q:原来手动配的轮盘配色还在吗?
在。完整配置导入/导出包含主题选择、自定义主题和轮盘跟随开关;关闭「轮盘跟随整体风格」后,原来的轮盘配色与自定义配色预设继续生效,不会被删除。
Q:删除正在使用的主题会怎样?
自动回退到「纸感极简」,并给出提示,其余自定义主题数据不受影响。
Q:找不到的主题会破坏配置吗?
不会。选中主题缺失或无效时,系统以纸感极简安全回退并显示提示。
延伸阅读
- 主题工作室官方说明:docs/art-style-themes.md
- 五份可导入主题示例:themes/(README)
- 主题模块源码:WinPieGestures/ArtStyles/(核心入口 ArtStyleService.cs、工作室界面 ThemeStudio.xaml)
- 设计文档:docs/superpowers/specs/2026-10-05-customizable-art-styles-design.md

