Switch主题定制指南：打造个性化wiliwili体验

在Switch平台上，wiliwili作为第三方B站客户端，不仅提供丰富的视频内容，还支持通过大气层主题系统实现界面个性化。本文将系统介绍如何利用wiliwili的主题资源，为不同使用场景选择合适的皮肤方案，从基础安装到高级定制，助你打造专属的Switch界面体验。

夜间使用方案：低蓝光深色主题推荐

长时间在昏暗环境下使用Switch容易导致视觉疲劳，低蓝光深色主题通过降低屏幕亮度和调整色彩对比度，有效减轻眼部压力。该主题采用深灰底色配合蓝色系强调元素，既保持界面层次感又避免强光刺激。

图：低蓝光深色主题在视频浏览场景下的显示效果，突出内容主体同时降低背景亮度

主题配置入口：[scripts/switch-forwarder/wiliwili.json]，可通过修改"background_color"和"text_color"字段调整色彩参数。

小贴士：配合Switch的自动亮度调节功能，可实现环境光感应下的主题亮度自适应。

日常通勤方案：轻量高效默认主题

对于频繁在掌机模式下使用wiliwili的用户，官方默认主题提供了最佳的操作效率。其简洁的布局设计减少视觉干扰，图标与文字保持适中大小，确保在移动场景下的操作准确性。

图：默认主题的多窗口布局，适合快速切换视频内容与评论区

主题资源路径：[scripts/switch-forwarder/source/main.c]，包含主题渲染的核心逻辑实现。

小贴士：通过组合L/R键与方向键，可快速切换主题预设方案，无需进入设置界面。

家庭娱乐方案：沉浸模式主题

在电视模式下使用wiliwili时，沉浸模式主题能提供影院级观看体验。该主题自动隐藏冗余控件，扩大视频显示区域，并优化远距离操作的交互逻辑，适合多人共享观看场景。

图：沉浸模式下的视频播放界面，控件自动隐藏以提供更大视野

功能实现路径：[scripts/build_switch.sh]，编译参数中添加"--enable-immersive-mode"即可启用该功能。

小贴士：配合Pro手柄的体感操作，可通过挥动控制器快速调整主题显示模式。

主题安装实施指南

1. 环境准备

   • 确保Switch已安装大气层0.19.1以上版本
   • 格式化SD卡为FAT32格式（簇大小32KB）
   • 备份原有主题文件：SD卡/atmosphere/contents/

2. 主题部署

   git clone https://gitcode.com/GitHub_Trending/wi/wiliwili
   cd wiliwili/scripts/switch-forwarder
   make install THEME=dark
   

3. 系统应用

   • 重启Switch进入大气层系统
   • 按住音量+键同时开机进入主题选择界面
   • 选择"wiliwili_theme"并按A键应用

小贴士：主题安装后建议运行[scripts/switch-forwarder/pack.sh]验证完整性，避免资源文件缺失导致界面异常。

主题定制进阶技巧

色彩方案调整

通过修改[scripts/switch-forwarder/wiliwili.json]中的color_scheme字段，可自定义主题配色：

"color_scheme": {
  "primary": "#FF4757",
  "secondary": "#2ED573",
  "background": "#1E1E1E"
}

图标资源替换

1. 准备128x128像素PNG格式图标
2. 替换[scripts/switch/icons/256x256/]目录下对应文件
3. 执行[scripts/linux/gen_icons.sh]重新生成图标缓存

布局自定义

修改[scripts/switch-forwarder/source/main.c]中的UI布局常量：

#define NAV_BAR_HEIGHT 64
#define CARD_SPACING 12
#define FONT_SIZE_TITLE 24

小贴士：自定义主题建议使用[scripts/switch-forwarder/README.md]中的校验工具，确保符合大气层主题规范。

风险提示与解决方案

风险类型	预防措施	恢复方案
系统启动失败	安装前备份atmosphere文件夹	重启时按住Vol-键进入安全模式
主题显示异常	严格遵循1080p分辨率设计	删除SD卡/atmosphere/contents/下对应主题文件
性能下降	避免使用超过5层的嵌套控件	简化主题布局，减少动画效果

小贴士：重大版本更新前，建议通过[scripts/ns_debug.sh]生成系统快照，便于故障恢复。

主题效果投票

你最喜欢哪种wiliwili主题方案？

• [ ] 低蓝光深色主题
• [ ] 轻量高效默认主题
• [ ] 沉浸模式主题
• [ ] 自定义主题

问题反馈

如在主题使用过程中遇到问题，请提供以下信息反馈至项目issue：

1. 大气层系统版本
2. 主题安装方式
3. 问题复现步骤
4. 错误截图（建议使用相册功能拍摄）

可通过[scripts/switch-forwarder/pack.sh --report]生成系统信息报告，帮助开发团队快速定位问题。