企业官网建设流程全解析

1. 从一场工作坊的策划说起：为什么选开源掌机做载体

第一次动念做这个工作坊，是因为连续几次在创客空间里看到同一个场景：有人抱着一台树莓派和一块屏幕，想拼一台掌机，结果卡在供电、外壳、按键映射这三件事上，折腾两周最后不了了之。开源掌机这个方向看起来门槛不高，实际上横跨结构、电子、系统、交互四个领域，任何一个环节掉链子都跑不起来。而工作坊这种形式，恰好能把四个领域的知识压缩到一两天内，让参与者在动手过程中把整条链路走通一遍。

所谓开源游戏掌机，指的是硬件设计文件（结构件、PCB、原理图）、软件系统（引导、系统镜像、模拟器前端）全部公开，任何人都可以自行复刻、修改、再分发的掌机方案。它和市面上买来即用的成品掌机最大的区别在于：你拿到的不只是一台机器，而是一整套可以拆开、改掉、重新组合的工程资料。这一点对学习者来说价值极高，因为成品掌机是黑盒，你只能玩；开源掌机是白盒，你可以改。

工作坊的目标人群我设定得很明确：有基础电子或编程经验、想完整走一遍硬件产品从设计到落地流程的人。不需要你会画 PCB，但至少要能看懂原理图；不需要你会写驱动，但至少要能在 Linux 下敲命令。这个门槛设置是有意为之的，因为掌机项目涉及的知识面太宽，如果连基础都没有，两天时间只够听讲座，动不了手。

关键词里提到的 Vibe Coding、AI 硬件、端侧 AI 硬件部署这几个词，其实和开源掌机有很自然的结合点。掌机本身就是一个带屏幕、带按键、带电池的嵌入式终端，把端侧模型塞进去做语音助手、做游戏内 NPC 对话、做离线翻译，都是很现实的玩法。工作坊里我专门留了一个下午做这个方向的扩展，后面会详细讲。

提示：工作坊的定位决定了内容深度。如果是面向纯新手的体验课，建议砍掉 PCB 设计环节，直接用现成开发板；如果是面向有经验者的进阶课，则应该把结构设计和系统裁剪做深。定位不清是工作坊翻车的头号原因。

2. 掌机方案选型：三条技术路线的取舍逻辑

2.1 树莓派派系：生态最全但体积和功耗是硬伤

树莓派 Zero 2 W 是很多人的第一选择，理由很直接：GPIO 文档齐全、社区案例多、系统镜像现成。我实测过一套基于 Zero 2 W 的方案，跑 RetroPie 玩到 PS1 级别的游戏基本流畅，但问题也很明显。整机厚度压不下来，因为 Zero 2 W 加上 USB 声卡、充电管理板、屏幕驱动板叠起来至少 20mm；续航也一般，2000mAh 电池实际游戏时间两小时出头。

更麻烦的是开机时间。树莓派系系统启动到进入前端界面，优化得再好也要 15 秒以上，这个体验对掌机来说是很劝退的。我在工作坊里会把这条路线作为"快速出成果"的选项，适合第一天就想看到画面的人，但不建议作为最终成品方向。

2.2 全志/瑞芯微派系：性价比和功耗的平衡点

全志 H3、瑞芯微 RK3326 这类芯片是国产开源掌机的主力，市面上大量百元级掌机用的就是这套方案。它们的优势在于：芯片本身集成了显示、音频、充电管理，外围电路简单；功耗控制得好，同样电池容量能多跑一两个小时；启动速度可以优化到 5 秒以内。

代价是资料相对分散。芯片原厂的 SDK 文档动辄几百页，社区移植的镜像质量参差不齐，遇到问题需要自己啃 datasheet。工作坊里我会提供一份已经验证过的核心板加底板方案，参与者只需要关注底板上的按键矩阵和扩展接口，把难度控制在可接受范围内。

2.3 单片机派系：极致低功耗但性能天花板明显

ESP32-S3 这类带 LCD 接口的单片机，最近两年被大量用于自制掌机。它的好处是启动几乎瞬时、待机功耗极低、成本可以压到几十块。但性能上限摆在那里，能跑的游戏基本停留在 FC、GB、GBA 这个级别，再往上就吃力了。

这条路线适合两类人：一是想做超低功耗便携设备的人，二是想深入学单片机图形编程的人。工作坊里我会把它作为"轻量级选项"，配套一套基于 LVGL 的菜单系统和几个开源模拟器核心，让参与者在一天内做出一个能玩的成品。

选型这件事没有标准答案，关键是想清楚你要什么。要生态就牺牲体积，要续航就牺牲性能，要性能就牺牲成本。工作坊里我会让每个人先填一张需求表，把"最看重什么"排个序，再对应选路线，而不是一上来就推荐某个方案。

3. 结构设计：3D 打印外壳背后的尺寸链计算

3.1 从屏幕和电池反推整机尺寸

很多人做外壳的顺序是错的：先画个好看的造型，再往里塞零件，结果发现塞不下。正确的顺序是反过来的，先确定屏幕和电池这两个"不可压缩"的部件，再往外扩展。

以一块 3.5 寸 IPS 屏幕为例，模组尺寸通常是 85mm x 56mm x 3mm，可视区域 73mm x 49mm。电池选 2000mAh 的软包电芯，尺寸约 60mm x 50mm x 8mm。这两个部件决定了整机的最小宽度是 85mm（屏幕宽度），最小长度是 85mm（屏幕长度）加上两侧握持区各 15mm，约 115mm。厚度方向，屏幕 3mm 加主板 1.6mm 加电池 8mm 加前后壳各 2mm，约 17mm。

这个计算看起来简单，但实际做的时候要考虑装配间隙、排线弯折半径、按键行程。我一般会在每个维度上留 1.5mm 到 2mm 的余量，宁可外壳厚一点，也不要装不进去。

3.2 按键布局的人机工程学细节

按键布局是掌机手感的核心。十字键和 ABXY 键的位置，直接决定了长时间游戏会不会手酸。我参考了几款经典掌机的布局，总结出一个比较舒服的参数：十字键中心距离屏幕左边缘约 20mm，ABXY 键中心距离屏幕右边缘约 20mm，两组按键的中心高度与屏幕中心对齐或略低 3mm 到 5mm。

摇杆的位置更讲究。如果只做一个摇杆，通常放在左侧十字键下方；如果做双摇杆，右侧摇杆放在 ABXY 键下方。摇杆帽的直径建议 18mm 到 20mm，太小了拇指按不住，太大了容易误触。

肩键（L/R）的行程和手感经常被忽略。我试过几种方案，最后觉得微动开关加 3D 打印摆臂的组合最靠谱，行程 1.5mm 左右，反馈清晰又不费力。直接用轻触开关做肩键的话，手感偏硬，长时间按会累。

3.3 3D 打印材料与后处理

外壳材料我一般推荐 PETG 或 ABS，PLA 虽然好打印但耐温性差，夏天放车里容易变形。PETG 韧性好、层间结合强，适合做需要卡扣的结构；ABS 可以丙酮抛光，表面质感更接近注塑件，但打印时气味大，需要通风环境。

打印参数方面，层高 0.2mm 是精度和速度的平衡点，壁厚至少 1.2mm（三层），填充率 20% 到 30% 足够。如果外壳有卡扣结构，卡扣部位的填充率要提到 50% 以上，否则容易断。

后处理这一步很多人省掉，但做了之后质感提升明显。砂纸从 400 目打到 2000 目，再用抛光膏擦一遍，表面能接近磨砂质感。如果要上色，先喷一层底漆，再喷面漆，最后喷哑光或亮光保护漆。我自己的机器用的是哑光黑加橙色按键，看起来比纯黑有层次。

注意：3D 打印的尺寸公差通常在 ±0.2mm 左右，设计卡扣和螺丝柱的时候要把这个公差算进去。螺丝柱内径要比螺丝外径小 0.3mm 左右，才能保证拧紧后不滑丝。

4. 电子部分：从原理图到 PCB 的完整链路

4.1 电源管理：充电、升压、电量检测三件套

掌机的电源部分通常包含三个功能模块：锂电池充电管理、系统供电升压/降压、电量检测。充电管理芯片我用得比较多的是 IP5306 和 TP4056，前者集成度高、外围元件少，后者便宜但需要自己加保护电路。

升压部分要看系统需求。树莓派 Zero 2 W 需要 5V 供电，峰值电流能到 1.5A，所以要选输出能力 2A 以上的升压芯片，比如 TPS61088。全志和瑞芯微的方案通常需要多路电压（3.3V、1.8V、1.2V），这时候用一颗 PMIC 比用多颗 LDO 更合适，效率和体积都占优。

电量检测有两种做法：一种是直接用带电量计的芯片，比如 MAX17048，精度高但成本也高；另一种是用 ADC 采电池电压，通过电压曲线估算电量，成本低但精度差。工作坊里我会两种都讲，让参与者根据自己的需求选。

4.2 按键矩阵与 IO 扩展

掌机上的按键数量通常在 12 到 16 个之间（十字键 4 个、ABXY 4 个、肩键 2 个、Start/Select 2 个、功能键 2 到 4 个）。如果主控的 GPIO 够用，直接一对一接最简单；如果 GPIO 紧张，就要用按键矩阵或者 IO 扩展芯片。

按键矩阵的原理是把按键排成行列，通过扫描确定哪个键被按下。比如 4x4 的矩阵可以支持 16 个按键，只需要 8 个 GPIO。代价是需要软件做扫描和消抖，而且同时按多个键时可能出现"鬼键"问题。解决办法是在每个按键上串一个二极管，但这样会增加焊接工作量。

IO 扩展芯片我用得比较多的是 TCA9535 和 PCF8574，I2C 接口，一颗芯片能扩展 16 个或 8 个 IO。好处是不占主控 GPIO，坏处是 I2C 通信有延迟，按键响应不如直连快。如果对响应速度要求高，还是建议直连或者用矩阵。

4.3 PCB 布局布线的几个关键点

PCB 设计这块，工作坊里我不会讲太深，但有几个点必须强调。第一是电源走线要粗，电池到充电芯片、充电芯片到升压芯片的走线，宽度至少 1mm，否则大电流下压降明显。第二是模拟部分和数字部分要分开，电量检测的 ADC 走线远离升压电感和开关节点，否则采样值会跳。第三是屏幕的 FPC 接口附近不要走高频信号，避免干扰。

层数方面，双层板基本够用，但如果要做双摇杆加震动马达加音频功放，建议上四层板，中间两层做电源和地平面，信号完整性会好很多。四层板的打样成本现在也不高，工作坊里我会提供一份四层板的参考设计。

5. 系统与软件：让掌机真正跑起来

5.1 系统镜像的选择与裁剪

系统镜像这块，树莓派系直接用 RetroPie 或者 Lakka 就行，开箱即用。全志和瑞芯微的方案通常需要自己编译，基于 Buildroot 或者 Yocto 做裁剪。Buildroot 上手快，配置菜单直观，适合工作坊这种时间有限的场景；Yocto 更灵活但学习曲线陡，不建议在两天内碰。

裁剪的核心是去掉不需要的组件。一个完整的 Linux 系统动辄几百兆，但掌机只需要内核、驱动、前端界面和模拟器核心，裁完可以压到 100MB 以内。启动速度的优化主要靠三点：内核裁剪掉无关驱动、用 initramfs 替代完整的根文件系统、前端界面用轻量级的而不是基于浏览器的。

5.2 模拟器前端的配置与汉化

前端界面我用得比较多的是 EmulationStation 和它的衍生版本。配置主要是三件事：扫描游戏 ROM 的路径、设置每个模拟器核心的启动参数、调整界面主题。汉化方面，EmulationStation 支持中文字体，但需要自己替换字体文件并修改主题配置，否则中文会显示成方块。

模拟器核心的选择也有讲究。同一个平台可能有多个核心可选，比如 GBA 有 mGBA 和 VBA-M，前者精度高、后者性能好。在性能有限的掌机上，通常优先选性能好的核心，牺牲一点精度换取流畅度。

5.3 按键映射与系统级快捷键

按键映射是掌机软件部分最容易出问题的地方。Linux 下按键事件通过 evdev 上报，每个按键对应一个键码。如果按键矩阵是自定义的，需要写一个内核模块或者用户态程序把矩阵扫描结果转换成标准键码。

系统级快捷键我一般会设置几个：电源键短按锁屏、长按关机；音量键加功能键调节亮度；Start+Select 组合键退出当前游戏。这些快捷键的实现方式因系统而异，RetroPie 下可以通过配置文件搞定，自己编译的系统则需要改前端源码。

提示：按键消抖参数很关键。机械按键的抖动时间通常在 5ms 到 20ms 之间，消抖时间设太短会误触发，设太长会感觉按键迟钝。我一般从 10ms 开始调，根据实际手感微调。

6. 端侧 AI 扩展：把模型塞进掌机的现实路径

6.1 端侧模型选型：参数量与算力的匹配

端侧 AI 硬件部署这个词最近很热，但真正落到掌机上，能选的模型其实不多。掌机的主控算力有限，RK3326 这种芯片连 NPU 都没有，只能跑纯 CPU 推理。这种情况下，模型参数量要控制在 100M 以内，量化到 int8 之后，推理速度才勉强能用。

我实测过几个方向：语音唤醒用 Porcupine 或者 Snowboy，模型只有几百 KB，CPU 跑毫无压力；语音识别用 Vosk 的小模型，50M 左右，识别一句话大概 1 到 2 秒；对话生成用 TinyLlama 或者 Qwen 的 0.5B 版本，量化后 300M 左右，生成一句话要 5 秒以上，体验就比较勉强了。

如果主控带 NPU，比如 RK3566 或者 RK3588，情况会好很多。RK3588 的 NPU 算力有 6 TOPS，跑 1B 到 3B 的模型可以做到接近实时。但这类芯片的功耗和成本都上去了，掌机的续航和价格都会受影响。

6.2 Vibe Coding 在掌机项目中的实际用法

Vibe Coding 这个概念最近被讨论得很多，我的理解是：用自然语言描述需求，让 AI 生成代码，人负责审查和调试。在掌机项目里，这个方式特别适合处理那些"我知道要什么但不想查文档"的环节。

比如写一个按键扫描的消抖逻辑，我可以直接描述"读取 GPIO 电平，连续三次采样一致才认为状态改变，采样间隔 5ms"，AI 生成的代码基本能用，我只需要检查一下边界条件。再比如写一个电量显示的 UI 组件，描述清楚布局和刷新逻辑，生成的 LVGL 代码改改就能跑。

但 Vibe Coding 不是万能的。涉及硬件时序、中断处理、内存管理这些底层逻辑，AI 生成的代码经常有隐藏 bug，必须自己逐行审查。我的经验是：应用层逻辑可以放心用 AI 生成，底层驱动和时序相关的代码还是自己写更靠谱。

6.3 一个具体的端侧 AI 玩法：离线语音助手

工作坊里我设计了一个小项目：用掌机的麦克风加端侧模型做一个离线语音助手，能识别"打开游戏""调节亮度""查看电量"这几条指令。实现路径是 Porcupine 做唤醒，Vosk 做识别，识别结果匹配预设指令，执行对应操作。

这个项目的难点不在模型本身，而在音频链路。掌机的麦克风和扬声器距离很近，容易产生回声和啸叫。解决办法是加一个音频编解码芯片做回声消除，或者用软件 AEC 算法。工作坊里我会提供一套验证过的音频电路，参与者只需要关注软件集成。

7. 工作坊现场：那些文档里不会写的坑

7.1 焊接环节的翻车重灾区

工作坊里最容易出问题的环节是焊接。FPC 连接器的引脚间距通常只有 0.5mm，新手很容易连锡。我的做法是提前把 FPC 连接器用热风枪吹好，参与者只需要焊接排针和按键这些间距大的元件。即便如此，每次还是有人把排针焊反或者虚焊。

按键矩阵的二极管方向也是高频错误点。二极管有正负极，焊反了按键就不响应。我在 PCB 丝印上加了明显的方向标记，但总有人不看。后来我干脆在焊接前加了一个五分钟的检查环节，让每个人对照图纸确认元件方向和位置，错误率降了一大半。

7.2 系统烧录与首次启动的排查链路

系统烧录看起来简单，实际上坑不少。TF 卡的质量参差不齐，有些卡写入速度慢到让人怀疑人生，有些卡在树莓派上能用但在全志方案上就是不识别。我的建议是统一采购一批验证过的卡，避免现场因为存储卡问题浪费时间。

首次启动黑屏是最常见的故障。排查顺序我总结成四步：先确认电源指示灯亮不亮，不亮查供电；再确认屏幕背光亮不亮，不亮查屏幕排线和背光电路；然后确认有没有启动画面，没有查系统镜像和启动配置；最后确认能不能进系统，不能查串口日志。这个顺序能覆盖 90% 以上的问题。

7.3 时间分配与节奏控制

两天的工作坊，时间分配我一般是这样的：第一天上午讲原理和选型，下午动手焊接和组装；第二天上午烧录系统和调试，下午做 AI 扩展和自由发挥。这个节奏的关键是第一天下午必须让每个人看到硬件成型，哪怕还不能跑，否则第二天就没有动力继续。

自由发挥环节我会有意留出比较大的空间，因为每个人想做的方向不一样。有人想加震动马达，有人想改外壳造型，有人想换更大的屏幕。我的角色从讲师变成技术支持，谁遇到问题就帮谁解决。这个环节往往能产出最有意思的成果。

8. 复刻与迭代：把工作坊成果变成长期项目

工作坊结束不代表项目结束。我会把所有设计文件整理成一份完整的复刻指南，包括 BOM 表、PCB 源文件、结构件 STL、系统镜像和配置脚本。参与者拿回去之后，可以自己打样、自己组装，遇到问题在群里讨论。

迭代方向上，我建议从三个维度考虑。硬件维度可以换更大的屏幕、加震动马达、加陀螺仪；软件维度可以换前端界面、加新的模拟器核心、做主题定制；AI 维度可以换更大的模型、加摄像头做视觉识别、做多模态交互。

我个人最看好的方向是端侧 AI 和掌机的结合。现在的掌机本质上还是"能玩老游戏的设备"，但如果加上离线语音助手、实时翻译、游戏内 AI 对话这些功能，它就有了新的使用场景。这个方向的技术门槛正在快速降低，一年前需要 6 TOPS 算力才能跑的模型，现在 1 TOPS 就能跑得不错。对于喜欢折腾硬件的人来说，现在入场正是时候。

最后分享一个我在多次工作坊里验证过的小技巧：让每个人在机器背面贴一张标签，写上自己的名字和制作日期。这看起来是个小事，但能显著提升参与者的成就感和项目完成度。很多人后来告诉我，那张标签是他们继续迭代这台机器的动力来源。