Cyberpunk 2077 存档编辑器 - Mac版

一个专为Mac平台开发的Cyberpunk 2077存档编辑器，可以修改角色等级、属性、技能等。

✨ 功能特性

• ✅ 修改角色等级（1-60）
• ✅ 修改街头声望（1-50）
• ✅ 修改属性点（力量、智力、反应、技术、镇定）
• ✅ 修改技能等级（手枪、突击、爆破等11种技能）
• ✅ 自动备份原始存档
• ✅ 友好的图形界面
• ✅ 支持所有存档类型（自动存档、手动存档、快速存档）

📋 系统要求

• macOS 10.15 或更高版本
• Python 3.10 或更高版本
• Cyberpunk 2077 游戏（已安装）

🚀 快速开始

方法1：使用启动脚本（推荐）

cd ~/cyberpunk-save-editor
./run.sh

方法2：手动启动

1. 进入项目目录

   cd ~/cyberpunk-save-editor

2. 激活虚拟环境

   source venv/bin/activate

3. 运行程序

   python3 main.py

首次安装

如果是首次使用，需要先安装依赖：

cd ~/cyberpunk-save-editor
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

然后就可以使用上面的方法启动程序了。

📖 使用说明

1. 启动程序

   • 运行 python3 main.py
   • 程序会自动扫描存档目录

2. 选择存档

   • 在左侧列表中点击要编辑的存档
   • 右侧会显示存档详细信息

3. 修改数据

   • 切换到"基础属性"或"技能等级"标签页
   • 修改想要更改的数值

4. 保存修改

   • 点击"💾 保存修改"按钮
   • 原始文件会自动备份为 .backup 文件

5. 创建备份

   • 点击"📦 创建备份"按钮
   • 会在存档目录创建完整备份

⚠️ 注意事项

1. 使用前请备份存档

   • 虽然程序会自动备份，但建议手动备份整个存档文件夹

2. 关闭游戏后再编辑

   • 确保游戏完全关闭后再使用编辑器
   • 编辑后重新启动游戏

3. 数值限制

   • 等级: 1-60
   • 街头声望: 1-50
   • 属性点: 3-20
   • 技能等级: 0-20

4. 存档位置

   ~/Library/Application Support/CD Projekt Red/Cyberpunk 2077/saves/
   

🔧 技术细节

• 编程语言: Python 3.14
• GUI框架: PyQt6
• 存档格式: JSON (metadata.9.json)
• 支持版本: Cyberpunk 2077 2.31 及以上

📝 项目结构

cyberpunk-save-editor/
├── main.py              # 主程序入口
├── gui.py               # GUI界面
├── save_parser.py       # 存档解析器
├── requirements.txt     # 依赖列表
└── README.md           # 说明文档

🐛 故障排除

问题：找不到存档

• 确认游戏已安装并至少运行过一次
• 检查存档目录是否存在

问题：保存失败

• 确认有写入权限
• 关闭游戏后再尝试
• 检查磁盘空间

问题：程序无法启动

• 确认Python版本 >= 3.10
• 重新安装依赖: pip3 install -r requirements.txt

📄 许可证

本项目仅供学习和个人使用。请勿用于商业目的。

🙏 致谢

• 参考了开源项目 CyberCAT-SimpleGUI
• 感谢 CD Projekt Red 开发的精彩游戏

⚖️ 免责声明

• 本工具仅修改本地存档文件，不涉及游戏本体
• 使用本工具造成的任何问题，开发者不承担责任
• 建议仅在单机模式下使用