简介：ExBSA提取工具是一款面向BISHOP社GALGAME爱好者与开发者的解包软件，用于解析游戏中的BSA（BISHOP Archive）打包档案，提取剧本、图片、音乐等素材，便于分析、修改与备份。资源包共6个文件，以3个exe可执行程序、2个cpp源代码和1个txt说明文档为主，压缩包约36KB，体积轻巧。其中exbsa_v1.exe与exbsa_v2.exe为不同版本解包程序，后者可能修复了前版问题或增加新特性；exbsa.cpp为开源源码，读者可借此理解BSA头部结构与解包原理，并进行二次开发；merge_sm相关文件可用于合并或整理提取出的剧本内容，readme.txt则提供使用说明与注意事项。目前已有2466人学习下载。对于希望欣赏原始CG、研究游戏资源管理机制，或进行本地化与MOD制作的读者，这份开源工具兼具实用性与学习价值，可帮助深入理解游戏开发背后的资源打包与解包流程。
1. 拿到一个 exbsa 提取工具，先别急着双击
如果你手头正好有一批.exbsa后缀的文件，又找不到能正常打开它们的入口，那你大概率已经体会过那种“文件明明在、就是读不出来”的憋屈。exbsa 提取工具就是冲着这个场景来的：它把封装在 exbsa 容器里的资源重新拆出来，还原成可读、可编辑、可二次处理的原始文件。我第一次接触这类工具时也踩过坑，以为它只是个解压器，结果发现它更像一把“定向钥匙”——你得先搞清楚容器里装的是什么，再决定用哪种提取模式。它适合三类人：手里有 exbsa 资源需要还原的前端/逆向方向从业者、做素材归档的内容处理人员，以及想研究容器格式本身的技术爱好者。下面我按“先看懂结构、再动手提取、最后避开雷区”的顺序，把这份工具拆开讲透。
2. exbsa 容器结构与提取原理：为什么不能当普通压缩包处理
2.1 exbsa 的文件布局长什么样
exbsa 不是 zip、不是 tar，也不是常见的资源打包格式。它更像一种“带索引的二进制容器”：文件头记录魔数和版本，紧接着是一张偏移表，表里每一项指向一个资源块的起始位置和长度，资源块本身可能是明文、可能是轻量编码、也可能是分片存储。很多人第一次用十六进制编辑器打开 exbsa，看到开头几个字节对不上常见压缩包的签名，就误以为文件损坏了——其实那只是容器自己的标识。
我一般会先用工具自带的inspect模式把结构打印出来，而不是直接提取。因为一旦容器里存在分片或嵌套，盲目提取只会得到一堆半截文件。下面这段命令是我常用的结构探查方式，工具本身提供了对应的子命令：
# 查看 exbsa 容器头部信息与资源索引表 exbsa-tool inspect --input ./assets/main.exbsa --show-index # 输出示例（节选）： # magic: EXBS # version: 2 # entry_count: 37 # index_offset: 0x0040 # [0] name=config.json offset=0x0120 size=2048 codec=raw # [1] name=logo.png offset=0x0920 size=15360 codec=deflate # [2] name=app.js offset=0x4510 size=98304 codec=chunked这里有几个参数值得盯住：codec决定单个资源块要不要二次解码，chunked表示该资源被切成多段存储，offset和size是提取时的定位依据。逻辑上，工具先读索引表，再按 codec 分派到不同的解码器，最后按 name 还原目录结构。如果你跳过 inspect 直接 extract，遇到 chunked 条目就可能只拿到第一段。
2.2 提取模式的选择：全量、按名、按类型
工具通常提供三种提取粒度，选错了要么浪费时间，要么漏文件。全量提取适合容器不大、你想一次性拿到所有资源的场景；按名提取适合你只关心某几个配置或脚本；按类型提取则适合批量处理同类资源，比如只导出所有图片做素材归档。
我自己的习惯是：先 inspect 看条目数量和总体积，超过 200MB 或条目超过 500 个，就先按类型提取，确认关键资源没问题再决定要不要全量。下面是对应的命令写法：
# 全量提取到指定目录 exbsa-tool extract --input ./assets/main.exbsa --output ./out/full --mode all # 只提取指定名称的资源（支持通配） exbsa-tool extract --input ./assets/main.exbsa --output ./out/partial --mode name --pattern "*.json" # 按类型提取，type 可选 image/script/config/binary exbsa-tool extract --input ./assets/main.exbsa --output ./out/images --mode type --type image参数说明：--mode是提取策略，--pattern只在 name 模式下生效，--type只在 type 模式下生效。逻辑上，工具会先加载索引表，再根据 mode 过滤条目，最后逐条解码写出。注意--output目录如果已存在同名文件，默认行为是跳过而不是覆盖，想强制覆盖要加--overwrite。这个默认值救过我一次——有回我误操作指向了源码目录，幸好它没直接覆盖。
2.3 解码器与编码参数：raw、deflate、chunked 的差别
exbsa 里最常见的三种 codec 是 raw、deflate、chunked。raw 就是原样存储，提取时直接拷贝；deflate 是标准压缩流，需要 inflate 解码；chunked 则是把一个大资源切成固定大小的段，每段可能独立压缩，提取时要按顺序拼接再解码。很多人遇到“提取出来的图片打不开”，十有八九是 chunked 条目只处理了第一段。
工具内部对这三种 codec 有对应的处理链，但你可以通过参数干预。比如遇到 chunked 条目时，可以指定--chunk-merge强制合并所有段再输出；遇到 deflate 条目解码失败，可以加--fallback-raw先导出原始字节，再用外部工具排查。下面这段是我处理一个混合 codec 容器的实际命令：
# 对 chunked 条目强制合并，对 deflate 失败时回退为原始字节 exbsa-tool extract --input ./assets/main.exbsa --output ./out/safe \ --mode all --chunk-merge --fallback-raw --log-level debug--chunk-merge会遍历同一资源的所有分片并按序拼接，--fallback-raw在解码器抛异常时改为直接写出未解码数据，--log-level debug会打印每个条目的处理路径。逻辑上，这相当于给提取过程加了一层“保险”：能解的就解，解不了的原样保留，至少不丢数据。我一般会在处理来源不明的 exbsa 时默认加上这两个参数，宁可后面手动修，也不要中途断掉。
3. 从零跑通一次完整提取：环境、命令与结果校验
3.1 环境准备与工具安装
这份工具通常是命令行形态，依赖一个运行时环境。常见做法是直接用预编译二进制，省去编译链的麻烦；如果你需要改源码或适配特殊平台，才走源码编译。我一般会先确认系统架构和运行时版本，再决定用哪种方式。
# 确认系统架构 uname -m # 方式一：使用预编译二进制（推荐新手） chmod +x exbsa-tool ./exbsa-tool --version # 方式二：从源码构建（需要对应语言工具链） # 假设工具是 Python 实现 python3 -m venv venv source venv/bin/activate pip install -r requirements.txt python setup.py build参数说明：--version用来确认工具版本和内置解码器列表，不同版本对 chunked 的支持程度可能不同。逻辑上，预编译二进制已经打包了常用解码器，源码构建则允许你按需裁剪。注意如果你在源码构建时缺了某个压缩库，deflate 条目会直接报错，这时候要么补依赖，要么改用预编译版。
3.2 一次标准提取的完整命令序列
我习惯把提取拆成三步：先 inspect 摸清结构，再试提取少量条目验证解码链，最后全量提取并校验。这样即使中间出错，也能快速定位是索引问题还是解码问题。
# 第一步：探查结构，输出索引表到文件备查 exbsa-tool inspect --input ./assets/main.exbsa --show-index > index.txt # 第二步：试提取一个 config 和一个 image，验证解码链 exbsa-tool extract --input ./assets/main.exbsa --output ./out/test \ --mode name --pattern "config.json" --overwrite exbsa-tool extract --input ./assets/main.exbsa --output ./out/test \ --mode type --type image --overwrite # 第三步：全量提取，开启合并与回退，记录日志 exbsa-tool extract --input ./assets/main.exbsa --output ./out/full \ --mode all --chunk-merge --fallback-raw --log-file extract.log逻辑说明：第一步的索引表是后续排查的“地图”，哪个条目在哪个偏移、用什么 codec，一目了然。第二步只取两类代表性资源，config 通常是 raw 或 deflate，image 可能是 chunked，能覆盖大部分解码路径。第三步全量提取时开日志，出问题直接翻extract.log找对应条目。参数上，--log-file会把每个条目的处理结果写文件，比终端滚动输出靠谱。
3.3 提取结果校验：怎么确认没丢没坏
提取完不是看一眼文件数量就完事。我一般会做三层校验：数量对得上、大小对得上、关键文件能正常打开。工具本身可能带verify子命令，没有的话就用系统命令凑。
# 统计提取出的文件数量 find ./out/full -type f | wc -l # 对比索引表中的 entry_count（假设 inspect 输出里有） grep "entry_count" index.txt # 检查是否有零字节文件（常见于解码失败的残留） find ./out/full -type f -size 0 # 对关键图片做完整性检查（以 png 为例） file ./out/full/images/*.png | grep -v "PNG image"逻辑上，零字节文件往往意味着解码器中途失败但没报错，--fallback-raw在这种情况下会写出原始字节而不是零字节，所以如果你看到零字节，说明连回退都没触发，得回去看日志。file命令能快速筛出扩展名与实际格式不符的文件，这类文件通常是 chunked 没合并完整。我一般会把这三条命令串成一个校验脚本，每次提取完跑一遍，省得手动翻。
4. 避坑与排查：exbsa 提取中最容易翻车的五个点
4.1 现象：提取出的图片能打开但下半部分花屏
原因：该图片是 chunked 存储，工具默认只解了第一段，后续段没合并。解决：提取时加--chunk-merge，或者先 inspect 确认该条目的 codec 是否为 chunked，再单独对该条目重新提取。我遇到过一张 logo 上半部分正常、下半部分全是噪点，就是这个问题。
4.2 现象：deflate 条目解码报错，提示“invalid distance”
原因：容器里的 deflate 流可能用了非标准窗口大小，或者数据在写入时被截断。解决：加--fallback-raw先导出原始字节，再用外部工具（如 Python 的 zlib）手动尝试不同窗口参数解码。如果原始字节本身就不完整，那说明容器在传输或拷贝时已经损坏，只能找原始来源。
4.3 现象：按名提取时通配符不生效，一个文件都没出来
原因：不同工具对通配符的支持范围不同，有的只支持*不支持?，有的要求 pattern 必须匹配完整路径而非文件名。解决：先用 inspect 确认条目的实际 name 字段，再调整 pattern。我一般会先用--pattern "*"试一次，确认能匹配到条目，再逐步收窄。
4.4 现象：提取到一半进程卡住，日志停在某个条目
原因：该条目可能是一个超大 chunked 资源，合并时内存占用飙升，或者解码器陷入死循环。解决：加--max-entry-size限制单条目处理上限，超过就跳过并记录；或者改用按类型提取，避开该条目。我一般会在处理未知容器时先设一个保守的上限，比如 50MB，跑通后再放开。
4.5 现象：提取出的 js 文件能读但运行报错，提示语法错误
原因：该 js 可能被轻量编码过（比如字符串替换或异或），工具按 raw 直接导出了，没有做二次还原。解决：inspect 时留意 codec 字段是否标注了额外编码，如果有，需要找对应的解码插件或手动处理。这类情况在 exbsa 里不算少见，尤其是脚本类资源，提取出来只是第一步，还原编码才是真正的活。
5. 进阶技巧：批量处理与自定义解码插件的写法
当你手里不止一个 exbsa，而是几十个甚至上百个时，单条命令逐个跑就太慢了。我一般会写一个批处理脚本，把 inspect、extract、verify 串起来，遇到异常条目自动记录并跳过。下面是一个 bash 版的批量处理骨架：
#!/usr/bin/env bash # 批量提取当前目录下所有 exbsa 文件 set -euo pipefail INPUT_DIR="./exbsa_files" OUTPUT_DIR="./extracted" LOG_DIR="./logs" mkdir -p "$OUTPUT_DIR" "$LOG_DIR" for f in "$INPUT_DIR"/*.exbsa; do base=$(basename "$f" .exbsa) echo "处理: $base" # 先探查结构 exbsa-tool inspect --input "$f" --show-index > "$LOG_DIR/$base.index.txt" 2>&1 || { echo "inspect 失败: $base" >> "$LOG_DIR/failures.txt" continue } # 提取，开启合并与回退 exbsa-tool extract --input "$f" --output "$OUTPUT_DIR/$base" \ --mode all --chunk-merge --fallback-raw \ --log-file "$LOG_DIR/$base.extract.log" || { echo "extract 失败: $base" >> "$LOG_DIR/failures.txt" continue } # 校验零字节文件 if find "$OUTPUT_DIR/$base" -type f -size 0 | grep -q .; then echo "存在零字节文件: $base" >> "$LOG_DIR/warnings.txt" fi done echo "批量处理完成，失败记录见 $LOG_DIR/failures.txt"这段脚本的逻辑很直白：遍历、探查、提取、校验，任何一步失败就记录并继续，不中断整批。参数上，set -euo pipefail让脚本在管道出错时也能捕获，--log-file保证每个文件都有独立日志。我一般会把 failures.txt 和 warnings.txt 单独留着，处理完一批后统一看，比在终端里翻滚动条高效得多。
如果你需要处理工具本身不支持的编码，可以写一个自定义解码插件。常见做法是继承工具提供的解码器基类，实现decode方法，然后通过--decoder-plugin加载。下面是一个 Python 插件的骨架：
# custom_decoder.py from exbsa.decoder import BaseDecoder class XorDecoder(BaseDecoder): """处理被异或编码的资源块""" name = "xor" def __init__(self, key=0x5A): self.key = key def decode(self, data: bytes) -> bytes: # 对每个字节做异或还原 return bytes(b ^ self.key for b in data) # 注册方式：exbsa-tool extract --decoder-plugin ./custom_decoder.py ...逻辑上，工具在遇到 codec 为xor的条目时会查找已注册的解码器，找到就调用decode。参数key可以从索引表的扩展字段读取，也可以硬编码。我一般会先把原始字节 dump 出来，用几个常见 key 试一遍，确认异或规律后再写插件。注意插件加载顺序会影响同名解码器的覆盖，如果你同时加载多个插件，后加载的会生效。
最后说个我自己的习惯：每次处理新的 exbsa 来源，我都会先拿一个最小样本跑通 inspect → 试提取 → 校验这条链，确认解码器匹配后再上批量。有回我图省事直接批量跑，结果那批容器用了新版本格式，索引表偏移对不上，白白跑了一晚上。从那以后我每次拿到新来源的 exbsa，都强制先走一遍最小样本验证。希望这些能帮到你，少走点弯路。
本文还有配套的精品资源，点击获取
