推理应用、板端管理页、打包与包管理脚本全部开源（Apache-2.0，可商用、可二次分发）。仓库里目前是 人脸检测、人脸识别打卡、通用物体检测三款应用，RV1103 与 RK3568 各一套适配——同一份应用代码，按芯片各编一档包。加一个新模型＝在 apps/ 下加一个目录，打包脚本自动扫描，不用改任何构建逻辑。

Gitee 源码仓库 → 投稿指南（把你的应用放进官方仓库）

两条路都行：会写代码的 ./scripts/bootstrap.sh 一键挂到幸狐官方 SDK 或 Rockchip 官方 BSP 上编译；不想碰编译的，直接把 .ek 包发到群里也能装。你自己的应用可以投稿进来——审核通过后出现在所有板子的 edgekit list 里，并标注作者署名。

常见问题

一块板怎么跑多个模型？

RK3566/3568 与 RV1103 基础镜像都内置 edgekit 包管理器：edgekit list 查看本板可用模型，edgekit install 安装，edgekit run 切换，多个模型共存于 /opt/edgekit/models/ 互不覆盖。模型包按 NPU 架构分档——RK3566/3568 同构一个包通用，RV1103 与 RV1106 同代 NPU、源码一份各编一档，RK3588 是独立旗舰档（可跑本地 LLM）。

两块已上线的板子出厂都预装 RetinaFace 人脸检测、开机即跑。RK3568 内存宽裕（4/8GB），装模型即装即用；RV1103 只有 64MB，装上网络共享后同样可以联网安装（edgekit install mobilefacenet 加装人脸识别打卡、edgekit install Yolov5s-coco 加装 COCO 通用物体检测），但同一时刻只有一个模型驻留 NPU（检测→识别这类先后流水线仍可行）。想自己编译打包也可以——应用层源码已开源在 Gitee。

镜像和模型真的免费吗？为什么要卖启动卡？

镜像与模型包永久免费下载，功能与启动卡 100% 相同。启动卡卖的是 A2 级好卡（帮你避开扩容假卡）、烧录实测、包装说明与坏了包换的售后——是省心，不是内容付费。装模型、进社群与免费用户完全同权。

为什么用网盘下载？下载太慢怎么办？

镜像体积较大（RV1103 整卡镜像 490MB），网盘是目前成本最低的分发方式，需要登录百度账号并使用下载区显示的提取码。

提速建议：① 用百度网盘客户端下载，别用网页端；② 一次只下一个文件；③ 慢不影响完整性，但下载完务必核对 SHA256——校验不过请重新下载，不要带着半个文件去烧卡，这是「烧完黑屏」最常见的原因。

后续会视情况补充免登录的直链下载，届时一键即可。

板子怎么联网？为什么 edgekit list 拉不到模型列表？

RV1103 是用 USB 虚拟网卡（RNDIS）跟电脑通信的，出厂状态只连着你这台电脑、本身没有出口网络——所以 edgekit list 只会列出板内已有的模型。想让板子联网（拉取云端模型列表、在线更新模型），必须在电脑上把网络共享给这块 USB 网卡。

Windows：设置 → 网络和 Internet → 高级网络设置 → 更多网络适配器选项 → 右键「Remote NDIS based Internet Sharing Device」→ 属性 → 共享 → 勾选「允许其他网络用户通过此计算机的 Internet 连接来连接」→ 确定。

开启后这块网卡的地址会被系统自动设成 192.168.137.1，板子是 192.168.137.10——同一网段，板子即刻能上外网，edgekit list 就能拉到完整列表了。

macOS / Linux：在系统里开启「Internet 共享」（macOS：系统设置 → 通用 → 共享 → 互联网共享），把来源设成你上网的接口、目标设成 RNDIS 网卡，并把该网卡地址填 192.168.137.1，效果相同。

三个常见坑：① 电脑自己得先能上网；② 开着 VPN 时共享经常失效，先断开 VPN 再试；③ 开了共享仍不通，检查防火墙有没有拦这块网卡。不联网也完全能用——预装模型开机即跑，画面照样看。

怎么进到板子里面？（进阶）

板子开机就带着 SSH，命令行一条命令连进去：ssh root@192.168.137.10，密码 edgekit。

Windows 10/11 自带 ssh——按 Win+R 输入 cmd 回车，敲上面那行即可；想用图形化工具，MobaXterm（自带文件传输）或 PuTTY 都行；macOS / Linux 打开终端，同一条命令。

首次连接会问 yes/no，输 yes；输密码时屏幕上一个字符都不显示，这是正常的，打完直接回车。前提是上一步那块的「Remote NDIS」网卡地址已经配好，否则连不上。

进去后常用两条：edgekit list 看本板可用模型，edgekit install <模型名> 装模型（需先按上一条把网络共享开好）。

balenaEtcher 里看不到 TF 卡 / 写到一半报权限错误？

多半是没用管理员方式打开。Windows 上请右键 balenaEtcher 图标 → 「以管理员身份运行」——向物理磁盘写数据需要管理员权限，用普通方式打开可能根本列不出 TF 卡，或者写到一半才报错。

顺便确认卡没被别的程序占用：关闭资源管理器里打开的卡窗口、退出其他写卡工具；换过读卡器或 USB 口之后，重启一次 Etcher 再刷新。

macOS 上不需要手动提权：首次写卡会弹出系统授权框，输入开机密码即可。

写卡之后电脑提示 TF 卡容量变小 / 出现多个分区？

正常现象。镜像是整卡扇区级镜像（dd 格式），电脑只按分区显示容量。想恢复卡的原始容量，用写卡工具里的恢复功能或重新格式化即可，不影响镜像本身。

我自己随便买张卡烧录行不行？

行，但建议认准 A2 级、正规渠道 32GB 以上。市面上大量扩容卡与速度虚标卡会导致烧录失败或系统极慢——如果烧录报错、启动黑屏或帧率异常，先换卡再排查镜像。这也是启动卡存在的原因之一。

拨码开关拨错了会怎样？

BootROM 会去 eMMC/SPI 找引导程序，TF 卡里的镜像完全不会被读取，表现为黑屏或进入旧系统。启动卡随卡附赠的说明卡片上印有拨码示意，对准 SD Card 档即可。

我能自己改代码 / 换个模型上去吗？

可以，而且大多数情况根本不用碰代码。

① 只想换个模型：模型与基础镜像解耦，把新的 .rknn 配一份 edgekit.app 配方（十几行配置：模型名、输入尺寸、进程名、目标芯片）重新打包，板端 edgekit install 装上即可，一行 C 代码都不用改。

② 想改推理逻辑、加功能：应用层代码（推理应用、板端管理页、打包与包管理脚本）已开源在 Gitee · renliangrong/edgekit-apps，Apache-2.0 许可——可自由修改、可商用、可二次分发，当前仓库里是人脸检测、人脸识别打卡与 COCO 通用物体检测三款应用，RV1103（Buildroot / armhf）与 RK3568（Ubuntu / aarch64）各一套适配配方与完整构建脚本。编译基于幸狐官方 SDK luckfox-pico 或 Rockchip 官方 BSP 与自带交叉编译工具链，仓库里提供一键编译脚本，不用自己啃环境。

③ 不想折腾：把模型和场景发过来，按需定制交付。

口径说明：镜像、模型包与应用代码都免费，收费只落在定制交付与教学支持上。

我的板子会被支持吗？模型多久上新？

已上线两款板型：幸狐 Pico（RV1103 · 64MB · ¥60 级入门档）与正点原子 ATK-DLRK3568（RK3568 · 4/8GB · 主力档）——基础镜像、烧录教程、模型库都是照着这两块实测出来的，出厂都预装 RetinaFace 人脸检测。

适配中：幸狐 Pico Mini / Plus（与 Pico 同芯同内存，共用同一份镜像）与 Pico Max / Ultra（RV1106 档）；Orange Pi 3B（RK3566）与正点原子同构、共用 RK356x 模型包，排在下一批；RK3588 旗舰档在规划表上。

模型包每月上新，QQ 群可点播，点赞最高的优先排期；每适配好一款板型都会在群里通知。