wiliwili主题定制指南：打造个性化Switch界面

wiliwili作为一款专为手柄控制设计的跨平台B站客户端，不仅支持多设备运行，还提供了丰富的主题定制功能。通过本文的主题特色解析、快速部署指南和个性化定制方案，即使是零基础用户也能轻松打造属于自己的Switch界面风格。

主题挑选攻略：三类风格满足不同场景需求

wiliwili提供了多种主题风格，覆盖日常使用的不同场景，用户可根据使用习惯和偏好选择合适的主题。

官方默认主题：简洁高效的原生体验

官方默认主题采用简约设计语言，界面元素排布合理，色彩搭配中性，适合长期使用。主题文件位于scripts/switch-forwarder/wiliwili.json，保持了与应用功能的高度一致性，是初次使用的理想选择。

深色主题：夜间使用的护眼方案

深色主题通过深灰底色与高对比度文字组合，有效降低夜间使用时的视觉疲劳。主题中视频卡片采用悬浮设计，突出内容主体，相关图标资源可在scripts/switch/icons目录下获取。

动漫风格主题：个性化视觉表达

动漫风格主题以热门IP角色为设计元素，通过丰富的色彩和角色形象提升界面活力。该主题特别适合动漫爱好者，配置模板可参考scripts/switch-forwarder/CMakeLists.txt中的资源引用方式。

安全安装流程：三步完成主题部署

准备工作：系统环境检查

1. 确认Switch已安装大气层破解系统，系统版本需在12.0.0以上
2. 准备容量不少于1GB的SD卡，建议格式化为FAT32文件系统
3. 下载主题兼容性检测工具：scripts/switch-forwarder/pack.sh

安装步骤：零基础操作指南

1. 克隆项目资源
   在电脑终端执行以下命令获取主题文件：
   git clone https://gitcode.com/GitHub_Trending/wi/wiliwili

2. 主题文件部署
   将下载的主题包解压后，复制到SD卡的themes目录下，完整路径应为：
   SD卡根目录/themes/wiliwili-theme/

3. 系统设置应用
   在Switch主界面进入「设置」→「主题」→「选择主题」，找到wiliwili主题并应用

个性化定制方案：从基础修改到深度定制

图标替换：快速改变视觉风格

1. 准备128x128像素的PNG图标文件，建议使用透明背景
2. 替换scripts/switch/icons/256x256目录下对应图标
3. 执行scripts/switch-forwarder/gen_icons.sh生成多分辨率图标集

布局调整：自定义界面元素

通过修改scripts/switch-forwarder/source/main.c可调整以下元素：

• 调整视频卡片大小和间距
• 修改导航栏位置和透明度
• 自定义字体样式和大小

高级定制：CSS样式修改

进阶用户可通过编辑主题CSS文件实现更精细的界面调整，主要修改方向包括：

• 调整颜色方案：修改主色调、强调色和背景色
• 添加动画效果：为按钮和卡片添加过渡动画
• 优化字体显示：调整字体大小和行间距

风险提示与解决方案

常见问题处理

1. 主题不显示
   检查主题文件夹命名是否正确，确保目录结构为themes/主题名称/

2. 系统崩溃
   按住电源键10秒强制重启，进入安全模式后删除不兼容主题

3. 图标显示异常
   使用scripts/switch-forwarder/update_gamecontrollerdb.sh工具修复图标缓存

安全注意事项

• 安装前备份SD卡中的themes和atmosphere目录
• 仅使用来自官方仓库的主题资源，避免第三方修改版
• 系统更新前暂时切换回默认主题，防止兼容性问题

主题资源汇总

资源类型	路径	用途
主题配置模板	scripts/switch-forwarder/	基础主题结构定义
图标资源	scripts/switch/icons/	多分辨率应用图标
安装工具	scripts/build_switch.sh	主题打包与部署
帮助文档	scripts/switch-forwarder/README.md	详细配置说明

你最心仪哪类主题风格？欢迎在评论区分享你的定制成果！无论是极简风、动漫风还是自定义设计，wiliwili主题系统都能满足你的个性化需求。