BrownDust II 资源文件管理工具使用指南

最后更新：2026年2月13日

一、核心概念与路径说明

在开始操作前，请先理解以下两个关键目录：

1. 清单列表目录 (a_dir)
   - 作用：存放游戏资源的索引文件（file.json如 manifest.json）
   - 路径：此路径工具可自动检测，通常您只需确认即可
   - C:\Users\<您的用户名>\AppData\LocalLow\Gamfs\BrownDust II\com.unity.addressables

2. 资源文件目录 (b_dir / target_dir)
   - 作用：存放游戏实际的资源文件（如贴图、音频等）
   - 路径：此路径取决于您的游戏安装方式，需要您手动查找和确认

   ①--配置选0，②--配置选1

   默认安装（C盘）:
   ①- C:\Users\<您的用户名>\AppData\LocalLow\Unity\Gamfs_BrownDust II
   ②- 提示：对应于D盘路径，应有包含 StreamingAssets\aa 等子文件夹的路径，请尝试查找
   
   自定义安装（如D盘）:
   ①- D:\Neowiz\Browndust2\Browndust2_10000001\BrownDust II_Data\Addressable
   ②- D:\Neowiz\Browndust2\Browndust2_10000001\BrownDust II_Data\StreamingAssets\aa

二、工具指令详解

请根据您的需求，选择对应的工具和指令：

工具1: bd2.py
适用场景：从零开始备份与整理（适合首次使用或游戏大版本更新后）
 - 如使用 bd2精简版.py，指令对应修改就行，如遇到中文无法执行就自行修改文件名称
 - bd2精简版.py 终端输出信息更简短，功能应该没有差异

指令：
- 基本使用: python bd2.py
  双击文件运行或命令行执行，跟随指引完成配置后（①选0，②选1），再次双击文件运行或在命令行执行

- 进入配置模式: python bd2.py --set
  手动设置 a_dir 和 b_dir 路径

- 修改清单配置: python bd2.py --set-list
  调整文件列表的处理方式

工具2: bd2_fix.py
适用场景：增量整理与校验（适合已备份，或仅需整理部分文件）

指令：
- 基本整理: python bd2_fix.py
  基于现有文件进行整理

- 完整性校验: python bd2_fix.py --check
  检查已整理文件的完整性

工具3: fileHash.py
适用场景：文件查找与哈希计算（无整理功能，用于诊断或查找特定文件）
指令：
- 计算当前目录哈希: python fileHash.py --a_dir "/path/to/a_dir"

- 计算指定目录哈希: python fileHash.py --a_dir "/path/to/a_dir" --target_dir "/path/to/target_dir"

工具4: clean_manifest.py
适用场景：把当前的file.json放置到脚本存储目录运行指令，清理manifest.json的旧文件记录
指令：
- 计算当前目录哈希: python clean_manifest.py

三、常见问题解答 (Q&A)

Q0: 如何运行 .py 文件？
A0: 推荐方法：在文件资源管理器地址栏输入 cmd 或 powershell 并回车，打开命令行窗口后输入相应指令（如 python bd2.py）
备选方法：
注意：虽然 bd2.py 尝试支持双击运行，但成功率取决于系统设置。命令行是最可靠的方式

Q1: 工具提示"找不到文件目录"或"需要配置"怎么办？
A1: 
1. 请确认您运行的是PC版游戏客户端
2. 确保您已正确执行过 python bd2.py 并完成了初始配置
3. 检查路径中的 <您的用户名> 是否已替换为您的实际Windows用户名（即环境变量 %USERNAME% 的值）

Q2: 如何只整理部分指定的文件？
A2: 有两种方式：
方式一（文件层面）：在资源文件目录(b_dir)中，手动删除不需要整理的文件，然后运行 python bd2_fix.py
方式二（列表层面）：编辑游戏启动器生成的 file.json 文件，只保留需要处理的文件条目，然后运行 python bd2.py

Q3: 不小心删除了 manifest.json 文件怎么办？
A3: 
如果游戏版本未变：直接再次运行 python bd2.py，程序会尝试根据 file.json 修复 manifest.json
如果游戏版本已更新：请从之前版本的输出备份目录中恢复 manifest.json。如果没有备份，只能重新运行 python bd2.py 来生成新的清单

Q4: 我可以自行修改这些 .py 脚本吗？
A4: 可以，但前提是您清楚修改可能带来的后果。如果您有定制需求，建议先将脚本文件重命名为（如 bd2.py.txt），然后借助AI助手来分析代码和实现修改，这通常更安全高效

Q5: 未来会增加 b_dir 的自动配置功能吗？
A5: 不会。由于资源目录的安装路径可变性太大，为保证准确性，本项目不考虑移除 b_dir 的手动配置环节或增加其自动检测功能

重要声明：
本文档及工具由作者提供，本文档基于作者原稿经AI重写生成。使用过程中遇到问题，请优先阅读本文档并尝试利用AI助手解决。向他人求助时，请保持耐心和礼貌。您的实践是解决问题的关键，不要因惧怕未知而却步。