Skip to content

wakaka6/SlaySP2Manger

Repository files navigation

SlaySP2Manager Logo

SlaySP2Manager

Slay the Spire 2 桌面端 Mod 管理器
基于 Rust + Tauri + React 构建 — 快速、安全、全自动化管理。

GitHub release Build Status GitHub stars GitHub forks GitHub watchers License

中文文档 | English


🖥️ 演示

demo.mp4

🎯 我们解决了什么问题

给《杀戮尖塔 2》装 Mod 很麻烦——我自己也经历过:

  • 🔍 游戏目录在哪? 第一次装 Mod 的玩家常常花 20 分钟寻找游戏路径和存档路径。
  • 🔀 浏览器和文件夹来回切。 在 Nexus Mods 上找到想装的 Mod,下载、解压、复制到不知对不对的目录,再祈祷游戏不崩。
  • 💥 悄无声息的冲突。 两个 Mod 覆盖同一个文件,没有任何提示,游戏直接挂了,却不知道问题出在哪。
  • 💾 存档焦虑。 想体验一次模组玩法,却害怕原版存档被覆盖,进退两难。
  • 🔙 没有撤销。 更新出错之后,没有简单的回滚方式。

SlaySP2Manager 把上面这些焦虑场景,变成一个安静、专注、一窗搞定的操作流程。


🆕 0.9.0 更新亮点

  • 🃏 原生卡牌图鉴:新增《杀戮尖塔 2》图鉴页,支持画廊浏览、详情查看、升级态切换与本地化文本展示。
  • 🎨 游戏内卡面资源提取:直接从本地游戏提取卡图、边框、横幅、能量图标与标题字体,卡面表现更贴近游戏内原始资源。
  • 🔄 本地化刷新链路:刷新资源时会从本地游戏重新生成图鉴快照并缓存,不再依赖仓库内置的静态 card-metadata 文件。
  • 🧭 图鉴浏览体验优化:新增吸顶筛选栏、折叠筛选区和回到顶部按钮,长列表浏览更顺手。
  • 💾 Profiles 自动保存:编辑现有配置档时,模组选中变更会自动持久化,减少反复手动保存。

✨ 功能概览

📦 模组库

  • 扫描并展示本地已安装的所有 Mod,一目了然
  • 单击即可启用 / 禁用 / 卸载 Mod
  • 从 ZIP 安装 — 拖拽文件或手动选择;应用读取 manifest、检测冲突,在写入之前显示预览
  • 冲突检测 — 在问题发生前高亮显示 Mod 之间的文件级冲突
  • 操作日志 — 每次安装、更新、卸载都有清晰的记录

🔍 发现(Nexus Mods 集成)

  • 在应用内搜索 Nexus Mods 上的 STS2 Mod,无需切换浏览器
  • Mod 详情面板 — 描述、作者、版本、点赞数、标签
  • 多语言友好 — 支持在应用内翻译 Mod 描述,消除阅读障碍
  • 在 Nexus 中打开 — 需要时可直接跳转到完整的 Nexus 页面
  • 下载队列 — 全程可见,切换页面后不会消失
  • 需要免费的 Nexus Mods API Key(应用内有获取引导教程)

🗂️ 预设

  • 创建 多套本地 Mod 预设(例如"原版兼容""全力混乱")
  • 安全切换预设 — 应用在切换前会自动校验完整性
  • 支持复制、重命名预设
  • Profiles 自动保存 — 编辑现有配置档时,模组选中变更会自动持久化
  • 整合包分享:将预设连同所有关联 Mod 打包为 .zip 整合包(含 .spm 清单),一键分享给好友
  • 整合包导入:点击按钮或拖拽整合包到窗口即可导入,自动检测冲突并提供逐 Mod 的「跳过 / 替换」选择
  • 在模组库页面 一键保存当前启用的 Mod 为新预设

🃏 图鉴

  • 原生卡牌图鉴 — 画廊式浏览《杀戮尖塔 2》卡牌,支持详情查看、升级态切换与本地化文本展示
  • 游戏资源直出 — 从本地游戏提取卡图、边框、横幅、能量图标与标题字体,展示更贴近游戏内卡面
  • 本地生成与缓存 — 刷新资源时根据已识别的游戏路径重建图鉴元数据和原生资源缓存
  • 长列表浏览优化 — 提供吸顶筛选栏、折叠筛选区和回到顶部按钮,筛卡更顺手

💾 存档管理

  • 清晰区分原版存档槽位模组存档槽位
  • 原版与模组存档之间双向复制(操作前显示将覆盖哪些内容)
  • 存档配对同步 — 将任意原版槽位与模组槽位关联,开启自动同步后根据修改时间双向同步(类似 rsync),支持跨槽位配对
  • 卡片之间可视化连线,清晰展示配对关系;点击连线中间的 × 按钮即可解除
  • 高风险操作前自动备份 — 不会悄悄覆盖任何东西
  • 备份列表与恢复 — 浏览历史备份,一键恢复

☁️ Steam 云存档同步

  • 自动发现当前 Steam 账号的云存档目录,无需手动配置
  • 一键上传至云端(本地 → Cloud)或下载至本地(Cloud → 本地),原版与模组存档全量同步
  • 每次云端操作前自动创建完整备份,确保数据安全
  • 支持直接打开云存档文件夹,方便手动查看和管理

⚙️ 设置与诊断

  • 首次启动自动检测游戏目录
  • 可配置下载目录和 Nexus API Key
  • 应用内教程:引导获取 API Key,无需离开应用
  • 诊断页面:校验游戏路径、存档路径和 Mod 目录健康情况

🚀 下载与安装

  1. 前往 Releases 页面
  2. 下载最新的 .msi 安装包
  3. 运行安装程序,无需额外配置
  4. 启动 SlaySP2Manager,指向你的 STS2 游戏目录

系统要求: Windows 10/11(x64)。无需安装任何运行时依赖。


🛠️ 本地开发

环境要求

工具 版本要求
Node.js 18+
Rust stable(通过 rustup 安装)
Windows 10/11(构建目标)

cargo 未加入 PATH,需将 %USERPROFILE%\.cargo\bin 添加到系统环境变量。

启动开发模式

# 安装前端依赖
npm install

# 启动 Tauri 开发模式(热重载)
npm run tauri:dev

构建发布包

npm run tauri:build
# 产物目录:src-tauri/target/release/bundle/msi/

🤝 参与贡献

欢迎提交 Bug 报告、功能建议和 Pull Request!

  1. Fork 本仓库
  2. 创建你的分支:git checkout -b feat/my-feature
  3. 提交改动:git commit -m 'feat: 新增某功能'
  4. 推送并发起 Pull Request

提交信息请遵循 Conventional Commits 规范。


📄 许可证

MIT License — 详见 LICENSE


用❤️为《杀戮尖塔 2》社区打造

About

一款杀戮尖塔2 多预设mod管理器,集成nexusmod, 支持自动双向同步mod版与原版存档 | A Slay the Spire Modern Mod Manager (Support Nexusmod Search)

Topics

Resources

License

Stars

Watchers

Forks

Packages