PowerCleanX/ChroniconSaveEditor

# Chronicon 存档编辑器 Chronicon 的非官方粉丝制作的桌面存档编辑器。 - https://www.gog.com/en/game/chronicon_complete Chronicon Save Editor 是一个开源的桌面应用程序，用于检查和编辑 Chronicon 存档文件，其重点是进行安全、最小的修补，而不是盲目地重写整个文件。 最新版本的快速下载链接： [github.com/PowerCleanX/ChroniconSaveEditor/releases/latest](https://github.com/PowerCleanX/ChroniconSaveEditor/releases/latest) ## 功能介绍 当前的公开版本专注于一小部分经过确认的安全编辑： - 角色等级 - 自由技能点 - 自由专精点 - 已映射装备物品的已装备物品数值词缀编辑 当您打开存档时，该应用程序会自动创建一个带时间戳的备份，并在将修补后的存档写回磁盘之前对其进行验证。 ## 存档发现 在 Windows 上，当 `%LOCALAPPDATA%\Chronicon\save` 文件夹存在时，文件选择器会从该目录开始。 如果未找到默认的 Chronicon 存档文件夹，该应用程序将回退到常规文件选择器。上次打开的文件夹会被记住，以便在下次会话中使用。 ## 便携版 Windows .exe 如果您正在使用便携版发布构建： 1. 下载 `ChroniconSaveEditor.exe`。 2. 直接运行该可执行文件。 3. 打开您的 `*.char` 存档文件。 4. 该应用程序将在加载存档之前自动创建备份。 便携版可执行文件使用与源代码版本相同的 Editor 和 Inspector 工作流程。 ## 从源代码运行 ``` py -3.11 -m venv .venv .venv\Scripts\Activate.ps1 python -m pip install --upgrade pip python -m pip install -e .[dev] python -m chronicon_save_editor ``` ## 构建便携版 .exe 使用随附的构建脚本： ``` .\scripts\build_windows_portable.ps1 ``` 该脚本会打包： - PySide6 运行时 - 捆绑的应用程序数据，例如 `field_map.json` 输出： ``` dist\ChroniconSaveEditor.exe ``` 如果您更喜欢直接使用 PyInstaller 命令： ``` .venv\Scripts\python.exe -m PyInstaller ` --noconfirm ` --clean ` --name ChroniconSaveEditor ` --windowed ` --onefile ` --collect-all PySide6 ` --collect-data chronicon_save_editor ` src\chronicon_save_editor\__main__.py ``` ## 使用方法 1. 打开一个 `*.char` 存档文件。 2. 让应用程序创建其自动备份。 3. 使用 `Editor` 选项卡进行常规编辑。 4. 使用 `Apply Character Changes` 保存角色更改。 5. 使用 `Save Affix` 保存已装备词缀的更改。 6. 每次保存后查看成功或失败消息。 主窗口还会保留简短的最近更改摘要，以便轻松确认更新了哪些内容。 ## 检查器模式 `Inspector` 是一个次要的高级视图，供希望低级别查看存档结构的用户使用。 它包括： - 原始部分浏览器 - 原始 JSON token 视图 - 十六进制视图 - ASCII 预览 - 可打印字符串提取 在主窗口中明确启用 `Advanced Mode` 之前，Inspector 将保持禁用状态。 ## 备份 每次您打开存档时，应用程序都会在加载文件之前在同级 `backups\` 文件夹中创建一个带时间戳的备份。 这种备份行为是自动的，旨在使测试编辑更加安全。 ## 已知限制 当前版本尚不支持： - 货币编辑 - 物品栏注入或复制 - 专精等级编辑 - 宝石或插槽编辑 - 仓库编辑 如果某个字段没有被清晰地映射并且可以安全修补，则有意将其保留为不支持状态。 ## 截图 ### 短期计划 - 更好的发布完善和 UI 改进 - 之前/之后差异视图 - 额外的安全确认的标量字段 - 更好的错误消息和恢复流程 ### 后期计划 - 在自信地映射全局/共享存储后支持货币编辑 - 更广泛的社区维护的字段映射 - 在映射得到强力验证后支持更多物品编辑 ## 测试 ``` .venv\Scripts\python.exe -m pytest ``` ## 项目布局 ``` src/chronicon_save_editor/ data/ Community-maintained mapping files parser/ Save parsing and exact-byte patch helpers services/ Backup and save-location helpers ui/ PySide6 desktop UI tests/ Parser and service tests scripts/ Build helpers ``` ## 警告 此工具是非官方的，如果使用不当可能会损坏存档。 请始终手动备份您的原始存档文件。 使用风险自负。 ## 法律 / 免责声明 - 非官方粉丝制作的项目 - 与 Chronicon 开发者无关联 - 仅供个人使用、实验以及存档检查/编辑 ## 支持 如果此工具为您节省了时间，并且您希望支持开发，您可以在这里请我喝杯咖啡： **Buy Me a Coffee:** [buymeacoffee.com/powerclean](https://buymeacoffee.com/powerclean)

标签：Chronicon, PyInstaller, PySide6, Python, 便携版, 备份恢复, 存档编辑器, 开源, 技能点, 数值修改, 文件解析, 无后门, 桌面应用, 游戏修改器, 游戏辅助, 漏洞挖掘, 物品属性, 逆向工具