企业官网建设流程全解析

一条命令完成3DS游戏格式转换：把.3ds卡带镜像变成能安装的.cia

【免费下载链接】3dsconvPython script to convert Nintendo 3DS CCI (".cci", ".3ds") files to the CIA format项目地址: https://gitcode.com/gh_mirrors/3d/3dsconv

朋友上个月翻出吃灰多年的老3DS，刷好自制系统后想重温卡带游戏。他用GodMode9把卡带转储成一张.3ds镜像，结果拷到机器里怎么也装不上——因为自制系统只认CIA格式的安装包。这正是3dsconv要解决的痛点：把任天堂3DS的CCI（.3ds / .cci）卡带镜像转换成能直接安装的CIA文件，全程一条命令，不用跟十六进制编辑器打交道。

它到底是什么：一台"格式翻译机"

如果把卡带镜像比作光盘的完整照片，那CIA就是安装包——照片再清晰也不能放进光驱直接"运行"，必须先重做成安装包。

3dsconv就是这条重做流水线。最麻烦的部分在于：很多卡带镜像是加密的。3dsconv会先读卡带头部一个字节的"加密标志位"，自动判断文件是未加密、原始NCCH加密还是zerokey加密，该解密的解密，该原样搬运的原样搬运，你完全不用自己判断。

最省事的第一次上手

整个上手过程只有三步，先在终端里把工具和依赖装好：

git clone https://gitcode.com/gh_mirrors/3d/3dsconv cd 3dsconv pip install pyaes

然后找到一张未加密的镜像（比如自制软件游戏），直接开转：

python3 3dsconv/3dsconv.py my_game.3ds

跑完当前目录就会多出一个my_game.cia。工具运行时会显示实时进度条，转换完会打印Done converting 1 out of 1 files.，看到这句话就说明成了。

一个完整的实战小任务：把加密正版镜像转成CIA

未加密镜像只是热身，大多数人的镜像其实是加密的。完整流程如下：

第1步：准备钥匙。加密文件需要一份ARM9 bootROM（boot9.bin）。在已刷boot9strap的机器上，开机时按住START+SELECT+X，会转储出sdmc:/boot9strap/boot9.bin，把它拷到当前目录。

第2步：转换。加上--boot9=明确指定钥匙路径，再加--verbose看详细过程：

python3 3dsconv/3dsconv.py game.3ds --boot9=./boot9.bin --verbose

第3步：验证。日志里会显示该游戏的 Title ID，并打印每个分区的SHA-256哈希——这些哈希就是工具自动完成的完整性校验。转换完把game.cia拷进SD卡，用FBI就能正常安装了。

内部原理的通俗版

三把锁的识别：文件头部有一个字节专门记录加密状态，就像门上的三道锁。3dsconv只读这一个字节，就能判断当前是"没锁门"（未加密）、"锁了普通锁"（原始NCCH加密）还是"锁了万能钥匙也打不开的锁"（zerokey加密），然后走不同的处理分支。

boot9.bin就是钥匙串：原始NCCH加密需要从受保护的ARM9启动固件里提取主密钥。3dsconv找到 boot9.bin 后会先做一次哈希校验，确认不是损坏或错误的文件才继续——这就避免了拿错钥匙白转一场。

拆包重装：转换时它会读取卡带镜像的NCSD头部，定位出游戏主程序（CXI）、说明书（Manual）和下载游玩（Download Play）等分区，再把它们连同游戏图标一起按CIA规范重新拼装，连证书链和票据都自动补齐。整个过程就像把行李箱拆开，按新箱子的尺寸重新装好，连贴纸都不落下。

新手避坑手册

坑1：报错Error: bootROM not found现象：加密镜像转不动。原因：没找到boot9.bin。解法：把boot9.bin放到当前目录，或用--boot9=/完整路径/boot9.bin指定。

坑2：提示This file may be corrupt (invalid ExtHeader hash)现象：明明未加密却报"文件可能损坏"。原因：部分未加密镜像头部的加密标志没被清掉，被误判成加密文件。解法：确定文件未加密就直接加--ignore-encryption；拿不准的话用--ignore-bad-hashes继续转。

坑3：提示already exists现象：重跑命令时被拒绝。原因：输出文件已存在，工具默认不覆盖。解法：加--overwrite强制覆盖。

进阶玩法：一条命令批量转换

3dsconv天然支持通配符和多个输入文件，一次跑完整个目录：

python3 3dsconv/3dsconv.py 游戏库/*.3ds --output=./cia --overwrite

批量场景下可以用环境变量预设钥匙路径，省得每次手敲：

export BOOT9_PATH="/path/to/boot9.bin"

另外，Windows用户可以把.3ds文件直接拖到打包好的3dsconv.exe上松开手，连命令行都不用打开。如果处理的是开发者版专用镜像，记得加--dev-keys并准备好certchain-dev.bin。

收尾行动清单

照着做一遍，十分钟内你就能拥有自己的CIA游戏库：

✅git clone https://gitcode.com/gh_mirrors/3d/3dsconv拉取项目 ✅pip install pyaes装好加密依赖 ✅ 准备一张镜像和（如需要）boot9.bin ✅ 跑一次转换命令并看到进度条走完 ✅ 用--overwrite重跑一次，验证流程可重复

完整的参数说明和密钥校验哈希写在项目根目录的README.md里，核心转换逻辑都在3dsconv/3dsconv.py这个单文件内，想研究细节随时可以打开看。

一张吃灰卡带，一条命令，一个能装进机器的CIA文件。3dsconv不追求花哨，就是把"转格式"这件麻烦事做到你不再需要关心它。

【免费下载链接】3dsconvPython script to convert Nintendo 3DS CCI (".cci", ".3ds") files to the CIA format项目地址: https://gitcode.com/gh_mirrors/3d/3dsconv