如何3步快速上手Duplicity：缺氧游戏存档修改终极方案

如何3步快速上手Duplicity：缺氧游戏存档修改终极方案

【免费下载链接】oni-duplicityA web-hosted, locally-running save editor for Oxygen Not Included.项目地址: https://gitcode.com/gh_mirrors/on/oni-duplicity

你是否曾经在《缺氧》游戏中遇到资源短缺、复制人属性不理想，或者想尝试不同游戏风格却受限于存档限制？Duplicity存档编辑器正是为解决这些问题而生的强大工具。这个基于Web技术的开源项目让你能够直接在浏览器中深度修改游戏存档，无需安装任何额外软件，实现完全本地化的存档编辑体验。

为什么选择Duplicity而不是传统修改方式？

传统修改方法的局限性

在Duplicity出现之前，玩家修改《缺氧》存档通常面临几个痛点：

1. 技术门槛高：需要手动编辑复杂的JSON或二进制文件
2. 风险不可控：一个错误的修改可能导致存档损坏
3. 效率低下：每次修改都需要反复备份和测试
4. 功能有限：只能进行基础的数据修改

Duplicity的技术优势

Duplicity通过现代化的Web技术栈彻底改变了存档编辑体验：

核心功能模块深度解析

复制人编辑系统：从基因到技能全面掌控

在src/pages/DuplicantEditorPage/目录中，Duplicity实现了完整的复制人编辑体系。这个系统不仅仅是简单的数值修改，而是提供了多层次的可视化编辑体验：

属性调整模块(src/pages/DuplicantEditorPage/components/DuplicantEditor/components/Attributes/)

• 力量、建造、挖掘等基础属性的可视化滑块控制
• 实时计算属性间的相互影响关系
• 提供推荐值范围，避免过度修改破坏游戏平衡

技能管理系统(src/pages/DuplicantEditorPage/components/DuplicantEditor/components/Skills/)

• 技能等级和经验值的精细调整
• 支持批量技能修改操作
• 技能树可视化展示，清晰显示技能依赖关系

特质编辑组件(src/pages/DuplicantEditorPage/components/DuplicantEditor/components/Traits/)

• 特质库的完整展示和搜索功能
• 特质冲突检测和兼容性提示
• 自定义特质组合保存和加载

存档数据处理架构：安全与性能的完美平衡

Duplicity的核心技术亮点在于其创新的数据处理架构。传统的Web应用在处理大型游戏存档时往往面临性能瓶颈，而Duplicity通过以下设计解决了这个问题：

Web Worker并行处理(src/services/oni-save/save-serializer.worker.ts)

// 存档序列化在独立线程中执行 const worker = new Worker("save-serializer.worker.ts");

这种设计确保了即使处理数百MB的存档文件，用户界面也能保持流畅响应。工作线程负责所有复杂的解析和序列化操作，主线程专注于UI渲染和用户交互。

Redux Saga异步流程管理(src/services/oni-save/saga/)

• load-onisave.ts: 处理存档加载的完整异步流程
• save-onisave.ts: 管理存档保存的状态转换
• import-behaviors.ts: 控制行为数据导入的副作用

多语言国际化框架：全球玩家的无障碍体验

Duplicity的国际化系统设计体现了现代Web应用的最佳实践：

模块化翻译管理(src/services/i18n/)

• 按功能域分离翻译文件：common.json和oni.json
• 支持运行时语言切换，无需页面刷新
• 提供完整的翻译贡献流程

语言包组织结构(src/translations/)

translations/ ├── en/ # 英语 - 默认语言 ├── zh/ # 中文 - 完整支持 ├── es/ # 西班牙语 ├── ru/ # 俄语 └── cs/ # 捷克语

每个语言包都包含完整的界面翻译和游戏术语本地化，确保不同语言玩家都能获得一致的编辑体验。

3步快速上手：从零开始使用Duplicity

第一步：环境准备与项目获取

克隆项目到本地

git clone https://gitcode.com/gh_mirrors/on/oni-duplicity cd oni-duplicity

安装依赖并启动开发服务器

npm install npm start

开发服务器启动后，在浏览器中访问http://localhost:8080即可开始使用编辑器。

第二步：定位游戏存档文件

根据你的操作系统，存档文件位于以下位置：

• Windows系统:C:\Users\[用户名]\Documents\Klei\OxygenNotIncluded\save_files\
• macOS系统:~/Library/Application Support/unity.Klei.Oxygen Not Included/save_files/

找到想要编辑的.sav文件，直接拖拽到Duplicity编辑器中，或者使用文件选择按钮加载。

第三步：开始你的第一次存档编辑

基础编辑操作流程：

1. 加载存档：点击左上角的加载按钮选择存档文件
2. 导航界面：使用左侧边栏在不同编辑页面间切换
3. 修改数据：在相应的编辑器中调整数值
4. 保存修改：点击保存按钮生成新的存档文件
5. 测试验证：在游戏中加载修改后的存档进行测试

快速编辑技巧：

• 使用Ctrl+Z撤销最近的操作
• 批量选择多个复制人进行统一修改
• 利用搜索功能快速定位特定游戏对象

高级功能与进阶技巧

行为模式复制粘贴系统

在src/components/DuplicantMenu/components/目录中，Duplicity实现了强大的行为模式管理系统：

复制粘贴工作流程：

1. 在复制人列表中选择源复制人
2. 点击"复制行为"按钮
3. 选择目标复制人
4. 点击"粘贴行为"完成传输

这个功能特别适合批量修改多个复制人的行为模式，或者将优秀复制人的行为配置应用到新角色上。

资源管理的高级策略

材料编辑页面(src/pages/MaterialsPage/)

• 按类别筛选和排序游戏材料
• 批量修改资源数量
• 删除无用或过多的松散材料

地热喷口管理(src/pages/GeysersPage/)

• 修改喷口类型和参数
• 调整喷发周期和产量
• 可视化喷口状态和位置信息

原始数据编辑模式

对于高级用户，Duplicity提供了原始数据编辑界面 (src/pages/RawEditorPage/)，允许直接访问和修改存档的底层数据结构：

原始编辑器功能特点：

• 树形结构展示存档数据
• 实时JSON数据验证
• 撤销/重做操作支持
• 数据类型智能提示

技术架构深度剖析

状态管理的艺术：Redux在Duplicity中的应用

Duplicity的状态管理系统是项目架构的核心，位于src/store/和src/state/目录中：

状态持久化机制(src/store/persist.ts)

• 自动保存用户设置到本地存储
• 选择性持久化关键状态数据
• 版本兼容性处理和迁移策略

选择器优化系统(src/services/oni-save/selectors/)

• 使用Reselect库实现高效的状态派生
• 避免不必要的重新计算
• 支持复杂的数据转换和过滤

组件设计模式：容器与展示组件的完美分离

Duplicity采用了React社区推崇的容器-展示组件模式：

容器组件职责：

• 数据获取和状态管理
• 业务逻辑处理
• Redux连接和Action分发

展示组件特点：

• 纯粹的UI渲染
• 通过Props接收数据
• 无状态或仅管理UI状态

这种设计模式使得组件更容易测试、维护和复用，也便于团队协作开发。

常见问题与解决方案

兼容性问题处理

版本兼容性检查： Duplicity当前支持《缺氧》存档版本7.15（Recreation Pack）。如果遇到兼容性问题：

1. 检查游戏版本是否匹配
2. 尝试在最新版游戏中重新保存存档
3. 关注项目更新，获取最新兼容性修复

存档损坏预防：

• 编辑前始终备份原始存档文件
• 避免一次性进行过多大幅度修改
• 使用"原始编辑器"时谨慎操作

性能优化建议

大型存档处理技巧：

1. 优先使用分类编辑页面，而不是原始编辑器
2. 批量操作时使用"撤销"功能逐步验证
3. 定期清理浏览器缓存，释放内存

浏览器兼容性：

• 推荐使用Chrome或Firefox最新版本
• 确保浏览器启用JavaScript和本地存储
• 对于超大存档，考虑增加浏览器内存限制

扩展应用与二次开发

自定义功能开发指南

Duplicity的模块化架构使得功能扩展变得简单：

添加新的编辑页面：

1. 在src/pages/创建新的页面目录
2. 实现对应的React组件
3. 在src/routes.tsx中添加路由配置
4. 在侧边栏导航中添加链接

集成新的游戏数据解析器：

1. 扩展src/services/oni-save/中的解析逻辑
2. 添加对应的Redux action和reducer
3. 实现UI组件展示和编辑功能

社区贡献与翻译支持

翻译贡献流程：

1. 复制src/translations/en/中的JSON文件
2. 翻译为目标语言内容
3. 提交翻译文件到项目仓库
4. 在src/services/i18n/i18n.ts中注册新语言

代码贡献指南：

• 遵循项目的TypeScript编码规范
• 为新功能添加相应的单元测试
• 确保修改不影响现有功能
• 提交清晰的提交信息和文档更新

最佳实践与安全建议

存档编辑的安全准则

1. 定期备份原则：每次重大修改前创建存档备份
2. 渐进修改策略：小幅度逐步修改，每次修改后测试
3. 版本控制意识：记录重要修改的版本和目的
4. 社区验证：在修改不确定时参考社区经验

性能优化配置

开发环境优化：

• 使用npm start启动开发服务器
• 启用热重载加快开发迭代
• 利用Redux DevTools调试状态变化

生产环境构建：

npm run build

构建过程会生成优化后的静态文件，适合部署到任何Web服务器。

未来发展与技术展望

技术架构的演进方向

Duplicity的技术栈代表了现代Web应用开发的最佳实践，未来可能的发展方向包括：

1. TypeScript全面强化：更严格的类型检查和更好的类型推断
2. React Hooks迁移：逐步替换Class组件为函数组件
3. WebAssembly集成：使用WASM提升存档处理性能
4. PWA功能增强：更好的离线体验和安装便捷性

功能扩展路线图

基于社区反馈和技术可行性，未来可能添加的功能包括：

• 存档比较和差异分析工具
• 修改历史记录和版本回滚
• 预设配置库和社区分享功能
• 自动化修改脚本支持

结语：重新定义游戏存档编辑体验

Duplicity不仅仅是一个存档编辑器，它代表了开源游戏工具开发的新范式。通过将复杂的游戏数据解析与现代Web技术结合，它为《缺氧》玩家提供了前所未有的编辑自由度和操作便捷性。

无论你是想微调游戏平衡性的普通玩家，还是希望深入理解游戏数据结构的开发者，Duplicity都能满足你的需求。其开源特性确保了项目的透明性和可持续性，而活跃的社区贡献则为工具的不断完善提供了动力。

现在就开始使用Duplicity，释放《缺氧》游戏的无限可能性，创造属于你自己的完美殖民地体验！

【免费下载链接】oni-duplicityA web-hosted, locally-running save editor for Oxygen Not Included.项目地址: https://gitcode.com/gh_mirrors/on/oni-duplicity