{"id":20523008,"url":"https://github.com/isharryh/ark-unpacker","last_synced_at":"2026-02-06T07:24:02.538Z","repository":{"id":41463244,"uuid":"507541814","full_name":"isHarryh/Ark-Unpacker","owner":"isHarryh","description":"Arknights Game AB Assets Batch Unpacker | 明日方舟游戏资源批量解包器","archived":false,"fork":false,"pushed_at":"2026-01-09T19:36:36.000Z","size":74157,"stargazers_count":481,"open_issues_count":0,"forks_count":22,"subscribers_count":2,"default_branch":"v4.x","last_synced_at":"2026-01-12T18:34:43.929Z","etag":null,"topics":["arknights","spine","unity"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/isHarryh.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-06-26T10:21:54.000Z","updated_at":"2026-01-12T06:42:24.000Z","dependencies_parsed_at":"2024-02-11T14:30:43.660Z","dependency_job_id":"c2c5dfcf-675f-4b6f-8b88-8270ea27bb18","html_url":"https://github.com/isHarryh/Ark-Unpacker","commit_stats":{"total_commits":252,"total_committers":2,"mean_commits":126.0,"dds":0.0357142857142857,"last_synced_commit":"a661b3cc4f9f59850d0be514d7a7c2ced919162e"},"previous_names":[],"tags_count":34,"template":false,"template_full_name":null,"purl":"pkg:github/isHarryh/Ark-Unpacker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isHarryh%2FArk-Unpacker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isHarryh%2FArk-Unpacker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isHarryh%2FArk-Unpacker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isHarryh%2FArk-Unpacker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/isHarryh","download_url":"https://codeload.github.com/isHarryh/Ark-Unpacker/tar.gz/refs/heads/v4.x","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/isHarryh%2FArk-Unpacker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29154167,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T07:18:23.844Z","status":"ssl_error","status_checked_at":"2026-02-06T07:13:32.659Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arknights","spine","unity"],"created_at":"2024-11-15T22:37:34.502Z","updated_at":"2026-02-06T07:24:02.500Z","avatar_url":"https://github.com/isHarryh.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- 欢迎阅读 Ark-Unpacker 说明文档 --\u003e\n\u003c!-- 仓库：https://github.com/isHarryh/Ark-Unpacker --\u003e\n\n\u003c!--suppress HtmlDeprecatedAttribute --\u003e\n\u003cdiv align=\"center\" style=\"text-align:center\"\u003e\n   \u003ch1\u003e Ark-Unpacker \u003c/h1\u003e\n   \u003cimg alt=\"ArkUnpacker icon\" width=\"64\" src=\"https://raw.githubusercontent.com/isHarryh/Ark-Unpacker/v3.x/ArkUnpacker.ico\"/\u003e\n   \u003cp\u003e\n      Arknights Assets Unpacker | 明日方舟游戏资源批量解包器 \u003cbr\u003e\n      \u003ccode\u003e\u003cb\u003e v4.5 \u003c/b\u003e\u003c/code\u003e\n   \u003c/p\u003e\n   \u003cp\u003e\n      \u003cimg alt=\"GitHub Top Language\" src=\"https://img.shields.io/github/languages/top/isHarryh/Ark-Unpacker?label=Python\"\u003e\n      \u003cimg alt=\"GitHub License\" src=\"https://img.shields.io/github/license/isHarryh/Ark-Unpacker?label=License\"/\u003e\n      \u003cimg alt=\"Code Factor Grade\" src=\"https://img.shields.io/codefactor/grade/github/isHarryh/Ark-Unpacker?label=CodeFactor\"\u003e\n      \u003cimg alt=\"GitHub Actions\" src=\"https://github.com/isHarryh/Ark-Unpacker/actions/workflows/build.yml/badge.svg\"\u003e\n      \u003cimg alt=\"GitHub Downloads\" src=\"https://img.shields.io/github/downloads/isHarryh/Ark-Unpacker/total?label=Downloads\"\u003e\n   \u003c/p\u003e\n   \u003csub\u003e\n      \u003ci\u003e This project only supports Chinese docs. If you are an English user, feel free to contact us. \u003c/i\u003e\n   \u003c/sub\u003e\n\u003c/div\u003e\n\n## 介绍 \u003csub\u003eIntro\u003c/sub\u003e\n\n### 终止更新预告\n\n本项目正在逐步升级和迁移到 [ArkStudio](https://github.com/isHarryh/Ark-Studio)，敬请关注。\nArkStudio 是正在开发阶段的，功能更加强大的《明日方舟》游戏资源集成式管理平台，开发完成后，当前项目将由于生命周期结束而终止更新，感谢各位一直以来的支持和喜爱。\n\n### 实现的功能\n\n1. 批量解包《明日方舟》Unity AssetBundle(AB) 文件中的游戏资源对象。\n   1. 支持游戏版本 v2.5.04 及以上的特殊解压算法；\n   2. 解包时可对基建小人、动态立绘和战斗小人的 Spine 模型文件进行区分；\n   3. 解包时可以将文件按源 AB 文件的名称分目录存放。\n2. 批量合并 RGB 通道图和 Alpha 通道图。\n3. 批量解码 FlatBuffers 数据文件。\n4. 既提供交互式命令行界面进行操作，也支持直接通过命令行运行。\n\n### 支持的类型\n\n| 类型      | 描述           | 导出格式  |\n| :-------- | :------------- | :-------- |\n| Sprite    | 精灵图         | PNG 图片  |\n| Texture2D | 二维纹理图     | PNG 图片  |\n| AudioClip | 音频剪辑       | WAV 音频  |\n| TextAsset | 文本或字节数据 | 未指定    |\n| Mesh      | 3D 模型        | OBJ 文件  |\n| TypeTree  | 对象结构       | JSON 文件 |\n\n### 相关文档\n\n- 更新日志 \u003e [点击查看](./CHANGELOG.md)\n- 配置文件指引 \u003e [点击查看](docs/ConfigFile.md)\n- 游戏资源查找指南 \u003e [点击查看](docs/AssetsGuide.md)\n\n## 使用方法 \u003csub\u003eUsage\u003c/sub\u003e\n\n### 1.资源准备\n\n无论您是想要使用我们的发行版本还是源代码来解包明日方舟的游戏资源，您都需要先获取到明日方舟的资源文件。明日方舟是基于 Unity 开发的游戏，它的游戏资源会全部打包到一种 **AssetBundle文件**（后缀名 `.ab`，下简称“AB文件”，但少数情况下后缀名是 `.bin`）中。\n\n下面将以 **Android 安卓系统** 为例讲述**如何获取到明日方舟的 AB 文件**。明日方舟的游戏资源有 **2 个部分**：\n\n- 一部分是通过**安装包**（`.apk`）提供的，从明日方舟[**官网**](https://ak.hypergryph.com)将其下载到本地后，使用压缩文件查看工具打开（后缀名改成 `.zip` 后打开），然后把里面的 `assets/AB/Android` 文件夹解压出来；\n- 另一部分是通过**热更新**提供的，首先确保您的安卓手机上的明日方舟更新到了最新版本，然后（推荐使用 USB 数据线）将手机存储的 `Android/data/com.hypergryph.arknights/files/Bundles` 文件夹（一般情况下是这个路径）复制到电脑上（重命名为 `Android(2)`）。至此，我们的目录结构大致如下：\n\n\u003e **你的目录**  \n\u003e ├─Android  \n\u003e └─Android(2)\n\n最后，将 `Android(2)` 文件夹里的内容复制到 `Android` 中，并**覆盖**同名文件，就能得到完整的游戏资源。在这之后，您就可以使用我们的程序来解包其中的游戏资源了。\n\n当然，您也可以将 `Android` 里的部分文件夹复制出来进行处理，以解包特定的资源。为了便于您找到特定资源的 AB 文件位置，我们整理并列出了各个子目录储存的资源的内容，浏览[此文档](docs/AssetsGuide.md)以查看详情。\n\n### 2.下载 ArkUnpacker\n\n为了方便一般用户使用，我们推出了适用于 Windows 64位操作系统（暂不支持其他操作系统）的可执行文件。\n\n请进入 Releases 页面下载 exe 文件 `ArkUnpacker-vx.x.x_x64.exe`：[前往下载](https://github.com/isHarryh/Ark-Unpacker/releases)\n\n### 3.必备知识\n\n在正式地使用本程序前，您最好对以下内容有初步了解：\n\n- [RGB 通道图和 A 通道图](docs/Essentials.md#rgb通道图和a通道图)\n- [Spine 动画小人](docs/Essentials.md#spine动画小人)\n\n### 4.示例用法\n\n一个最简单的用法是，将需要解包的文件夹（可以是多个）放到程序文件所在的目录中。至此，我们的目录结构大致如下：\n\n\u003e **你的目录**  \n\u003e ├─Android (解包整个目录需要很久)  \n\u003e ├─charpack (可以选择解包部分文件夹)  \n\u003e └─ArkUnpacker.exe\n\n然后直接运行程序，弹出交互式命令行界面如下，依据其提示操作即可：\n\n```\n欢迎使用ArkUnpacker\n====================\n模式选择：\n1: 一键执行\n2: 自定义资源解包\n3: 自定义图片合并\n5: 自定义Spine模型导出\n6: 自定义Criware USM音视频提取\n7: ArkModels提取与分拣工具\n8: ArkVoice提取与分拣工具\n0: 退出\n输入序号后按回车即可，如果您不清楚以上功能的含义，强烈建议您先阅读使用手册(README)\n```\n\n此外，运行程序后，工作目录会生成配置文件 `ArkUnpackerConfig.json` 与日志文件 `ArkUnpackerLogs.log`。有关配置文件的字段说明，请参阅[此文档](docs/ConfigFile.md)了解详情。\n\n### 5.各模式的功能概述\n\n#### 一键执行\n\n直接解包程序所在目录中的文件，并执行图片合并。解包出的文件默认导出到 `Unpacked_xxxx` 文件夹，合并完成的图片默认导出到 `Combined_xxxx` 文件夹。\n\n#### 自定义资源解包\n\n解包指定路径的游戏资源，并导出到指定目录。可以选择需要解包哪些资源类型。\n\n#### 自定义图片合并\n\n合并指定路径中的 RGB 图和 Alpha 图，并将合并的结果导出到指定目录。\n\n#### 自定义文本数据解码\n\n解码指定目录中的数据文件，并将解码结果导出到指定目录。具体的原理，请参阅[此文档](docs/TextAssetsDecoding.md)了解详情。\n\n#### 自定义 Spine 模型导出\n\n解包指定路径中的游戏资源，并将其中包含的 Spine 动画小人模型导出到指定目录。\n\n#### 自定义 Criware USM 音视频提取\n\n解包指定路径中的 Criware USM 文件（通常包含过场动画），并将其中包含的音视频文件导出到指定目录。\n\n#### ArkModels 提取与分拣工具\n\n此为定制功能，请参阅[此文档](docs/ArkModelsRepoKit.md)了解详情。\n\n#### ArkVoice 提取与分拣工具\n\n此为定制功能，请参阅[此文档](docs/ArkVoiceRepoKit.md)了解详情。\n\n### 6.命令行用法\n\n除了上述示例用法展示的**交互式**命令行界面外，程序还支持**直接**通过命令行来运行，以便熟悉命令行调用的用户使用。相关参数如下：\n\n```\nusage: ArkUnpacker [-h] [-v] [-m {ab,cb,fb,sp,cu}] [-i INPUT] [-o OUTPUT] [-d]\n                   [--image] [--text] [--audio] [--spine] [--mesh] [--typetree] [-g]\n                   [--no-video] [--no-audio] [-l {0,1,2,3,4}]\n\nArknights Assets Unpacker. Use no argument to run to enter the interactive CLI mode.\n\noptions:\n  -h, --help            show this help message and exit\n  -v, --version         show a version message and exit\n  -m {ab,cb,fb,sp,cu}, --mode {ab,cb,fb,sp,cu}\n                        working mode, ab=resolve-ab, cb=combine-image, fb=decode-flatbuffers, sp=resolve-spine, cu=resolve-usm\n  -i INPUT, --input INPUT\n                        source file or directory path\n  -o OUTPUT, --output OUTPUT\n                        destination directory path\n  -d, -delete           delete the existed destination directory first\n  --image               in resolve ab mode: export image files\n  --text                in resolve ab mode: export text or binary files\n  --audio               in resolve ab mode: export audio files\n  --spine               in resolve ab mode: export spine asset files\n  --mesh                in resolve ab mode: export mesh resources\n  --typetree            in resolve ab mode: export typetree JSON files\n  -g, --group           in resolve ab mode: group files into separate directories named by their source ab file\n  --no-video            in resolve usm mode: skip video processing\n  --no-audio            in resolve usm mode: skip audio processing\n  -l {0,1,2,3,4}, --logging-level {0,1,2,3,4}\n                        logging level, 0=none, 1=error, 2=warn, 3=info, 4=debug\n```\n\n运行 `ArkUnpacker -h` 命令可以显示此帮助信息。如果您使用的命令不带任何 `mode` 参数，那么程序会以交互式命令行界面的模式启动。\n\n## 注意事项 \u003csub\u003eNotice\u003c/sub\u003e\n\n1. 使用一键执行模式时，不会解包直接位于程序所在目录中的 AB 文件，只会解包子文件夹里的 AB 文件。\n2. 程序会根据设备 CPU 核心数自动调整多线程策略，并且对设备性能（尤其是 CPU 和硬盘性能）有一定要求，配置过低的电脑在运行时可能会缓慢。\n3. Windows 命令行基本常识：\n   1. 快捷键 `Ctrl+C` 用于强行终止程序，若想复制文本，请用鼠标选取文本后再按此快捷键。\n   2. 左键单击小黑窗会进入“文本选取”模式，此时主程序会暂停执行。\n   3. 右键单击小黑窗可以粘贴文本，也可用于退出“文本选取”模式。\n   4. 拖放文件到小黑窗可以快速粘贴其路径。\n4. 如果您希望了解更多细节或参与贡献，请[查看开发者指引](docs/ForDevelopers.md)。\n\n## 许可证 \u003csub\u003eLicensing\u003c/sub\u003e\n\n本项目基于 **BSD-3 开源协议**。任何人都可以自由地使用和修改项目内的源代码，前提是要在源代码或版权声明中保留作者说明和原有协议，且不可以使用本项目名称或作者名称进行宣传推广。\n\n-----\n\n\u003cdiv align=\"center\"\u003e\n    \u003cp\u003e\u003ci\u003eGitHub 历史星标图\u003c/i\u003e\u003c/p\u003e\n    \u003ca href=\"https://starchart.cc/isHarryh/Ark-Unpacker\"\u003e\n       \u003cimg alt=\"Stars Chart\" src=\"https://starchart.cc/isHarryh/Ark-Unpacker.svg?variant=adaptive\"\u003e\n    \u003c/a\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fisharryh%2Fark-unpacker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fisharryh%2Fark-unpacker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fisharryh%2Fark-unpacker/lists"}