Skip to content

Steam 补丁注入 ​

Steam 补丁功能用于为本机已安装的 Steam 正版 Galgame 匹配并注入汉化、音声、剧情或额外内容补丁。服务端维护补丁索引,客户端扫描本机 Steam 库并执行下载解压。

使用流程 ​

  1. 在服务端补丁目录放置 .zip、.rar、.7z、.tar、.gz、.xz 等压缩包。
  2. 打开客户端 Steam 补丁页,切到「补丁配置」Tab(切到「补丁注入」Tab 时会自动刷新匹配)。
  3. 点击「扫描补丁」,先选择扫描模式:合并刷新(保留规则/名称/锁定,补新删失)、仅清空元数据(保留规则与锁定,重新解析 AppID/名称/标签/类型)、清空重扫(完全按磁盘重建);扫描过程会显示进度。
  4. 服务端尝试从文件名、父目录名或 Steam Store 搜索识别 AppID,并解析到基础游戏。
  5. 如有必要,手动编辑 AppID、补丁类型、patch_dir 或 target_dir。
  6. 切到「补丁注入」Tab,扫描本机 Steam steamapps。
  7. 客户端按 AppID 匹配补丁,点击「注入」下载并解压到游戏目录。

搜索与编辑 ​

  • 两个 Tab 顶部都有搜索框:注入页按游戏 / 补丁过滤,配置页按补丁 / AppID 过滤
  • 配置列表每行可以展开查看详情;编辑弹窗分「元数据 / 配置」两段,可以分别保存,并提供「打开目标文件夹」
  • 窄窗口下,从本地库面板到最后一项匹配结果可以连续向下滚动;宽窗口保留双栏。
  • 管理员在注入页点击「规则待配置」,可直接为当前游戏的这份补丁选择「智能配置」或「手动配置」。普通用户需等管理员保存规则后才能注入,服务端也会校验下载权限。
  • 智能配置需要启用智能体、选择模型,且客户端游戏安装目录真实可读。若补丁在服务端本地目录,服务端直接列出压缩包目录,客户端只传游戏内的相对路径;若是 OpenList 网盘,客户端先下载或复用补丁,再回传包内相对路径和指纹。服务端按双方目录推导复制位置并让已配置的模型审核;结果不唯一或包内含安装器时,保持待配置,可直接转手动。保存规则后仍需点击「注入」才会安装。
  • 手动配置直接打开当前补丁的规则编辑窗口,可填写补丁源目录、游戏内目标目录,不要求本机安装游戏;本机目录可读时,也可从目录中选择目标。
  • 注入时如果压缩包需要解压密码,会提示输入密码重试(也可以在下载管理器中重试)

补丁目录与索引 ​

默认容器内补丁目录为 /steam_patch:

bash
docker run -d \
  --name sena-repo \
  -p 11451:11451 \
  -v /path/to/data:/data \
  -v /path/to/steam_patches:/steam_patch \
  --restart unless-stopped \
  404gcross/sena-repo:latest

如果游戏库和补丁库都来自 OpenList,仍建议将 SENA_PATCH_DIR 指向持久化目录,例如 /data/steam_patch,用于保存补丁压缩包。

补丁索引与类型关键词位于数据目录的 steam_patch_index/,只要 /data 持久化即可保留:

text
steam_patch/                      ← 补丁压缩包目录
├── 游戏1_Steam_Chinese_Patch.7z
└── 游戏2_Steam_Voice_Patch.rar

data/steam_patch_index/           ← 索引目录,位于数据目录内
├── patches.json                  ← 自动生成,记录所有补丁与匹配规则
└── patch_type_keywords.json      ← 补丁类型识别关键词配置

下载与注入 ​

补丁下载与游戏下载共用同一条管线:客户端先通过 POST /api/steam/patches/{key}/link 取一次带时效的签名直链,优先交给内置 aria2 多连接下载,失败再回退分片/流式;网盘来源的补丁会按来源类型使用浏览器 UA 和分片降级重试。链接过期时客户端会自动换取新链接继续下载。

AppID 识别 ​

优先级从高到低:

  1. 文件名中的纯数字,例如 123456.zip。
  2. 父目录名中的纯数字,例如 123456/patch.zip。
  3. 从文件名提取游戏名,调用 Steam Store 搜索,并把结果解析到基础游戏。
  4. 仍失败则 app_id: null,需要在客户端手动填写。

重新刮削与名称来源 ​

  • 编辑补丁时的「重新刮削」只解析并填充弹窗里的 AppID / 游戏名,点「保存元数据」后才写入;不保存直接关闭不会改动补丁。「批量刮削 ID」是执行动作,会直接写入。
  • NextMoe 模式下可以选补丁名称来源(客户端「刮削设置 → NextMoe」):默认直接用 NextMoe 名称;开启「补丁名称用 Steam 名称」后,先解析出 AppID,再取 Steam 商店名称,取不到时回退 NextMoe。该开关同时作用于自动扫描、重新刮削和修改 AppID 后的名称刷新。

补丁类型 ​

类型默认关键词
translation_Steam_Chinese_Patch
voice_Steam_Voice_Patch
story_Steam_Story_Patch
extra_Steam_Extra_Patch
misc无关键词匹配时

关键词文件位于数据目录的 steam_patch_index/patch_type_keywords.json,可在客户端 Steam 补丁页的「关键词匹配」中编辑,也可以直接改这个文件。文件名(统一转小写)包含任一关键词即归为该类型,按类型顺序取第一个命中的;misc 不参与匹配。文件只在不存在时写入默认值,之后以文件内容为准,升级服务端不会覆盖你改过的词。

patch_dir / target_dir ​

字段作用
patch_dir解压后从临时目录中的哪个子目录取文件;为空表示从压缩包根目录复制,保留下面的文件夹层级
target_dir将补丁文件复制到 Steam 游戏目录下的哪个子路径;为空表示游戏根目录

示例:压缩包内结构为 汉化v2/data/patch.xp3,配置 patch_dir="汉化v2"、target_dir="",最终会把 data/patch.xp3 合并到游戏根目录。

压缩包结构没有要求,按下面选择即可:

压缩包内结构建议配置
根目录直接是补丁文件(如 patch.xp3、data/...)patch_dir 留空
单一顶层目录(如 汉化v2/data/...)patch_dir="汉化v2",服务端分析压缩包时会提示该目录
多个顶层目录并列(如 文档/、补丁/)手动指定要取用的那个目录

target_dir 决定补丁复制到游戏目录的哪个位置:多数补丁填根目录即可;如果补丁包要求覆盖到子目录(例如 data),再填写对应子路径。

元数据锁定 ​

服务端 Tab 里每行右侧可以锁定元数据:锁定后,自动扫描与「重新刮削 AppID」都不会改动该补丁的 AppID、游戏名、标签、类型与注入规则;文件大小、来源路径这类文件事实仍会随扫描更新。再点一次即可解锁。

备份与恢复 ​

补丁匹配规则(含锁定状态)、类型关键词与补丁库目录会随服务端备份一起导出;--scope patch 还会带上这些目录依赖的 OpenList 文件源,换机后按文件源名称重新绑定并重写 source_id / patch_id:

bash
senacli backup --scope patch
senacli restore sena-backup-20260915-153000.zip

备份格式只接受当前版本,旧备份需用当前版本重新导出。完整说明见 服务端 CLI 与 备份与恢复。

Released under the AGPL v3 License.