Skip to content

Sena Repo 客户端使用说明书 ​

Sena Repo 客户端用于连接 Sena Repo 服务端,浏览游戏库、下载并解压游戏、导入 Steam 非 Steam 游戏,以及注入 Steam 汉化补丁。当前支持 Windows、Android 和 Linux。

目录 ​

其他页面:


安装 ​

从 GitHub Releases 下载对应平台的客户端:

平台文件说明
Windows.exe 安装包 / .zip 便携版推荐安装版;便携版解压后直接运行
Android.apk需要授予文件访问权限
Linux.AppImage适合桌面 Linux / 掌机系统

Windows 和 Linux 客户端内置 7zip-zstd 解压组件。Android 使用应用内下载与解压流程,不显示 Steam 相关功能。


首次启动 ​

客户端首次启动时会弹出免责声明,同意后进入本机设置:

  • 游戏下载目录 — 下载的游戏压缩包和解压后文件存放位置
  • Steam steamapps 目录 — 用于 Steam 补丁匹配,填写 Steam 库的 steamapps 文件夹路径
  • Steam 用户 ID — Steam 好友代码,也可在 Steam 安装目录 userdata 文件夹中找到纯数字目录名

这些设置保存在本设备,不写入服务端。之后可在登录/服务器选择界面右上角的齿轮按钮修改,或在「设置 → 下载设置」中更改。


连接服务器 ​

新增登录配置 ​

在服务器选择界面点击「新增登录配置」,在弹出的对话框中填写:

  • 配置名称
  • 服务器地址(IP 或域名)
  • 端口(默认 11451)
  • 是否使用 HTTPS
  • 用户名和密码

保存后作为一条服务器配置显示在列表中。每条配置右侧的三点菜单可编辑或删除;编辑服务器地址、协议、用户名或密码后相当于重新登录该配置。

第三方账号登录 ​

服务端开启对应 OAuth 时(默认开启),服务器选择界面会显示「使用 NextMoe·未萌 账号登录」和「使用 Hikarinagi 账号登录」:

  • 点击后在系统浏览器完成授权,客户端自动回调登录,无需输入密码
  • NextMoe 需要管理员先在「设置 → 用户管理」里填好你的 NextMoe 用户 ID;未添加的账号会提示联系管理员
  • Hikarinagi 不自动建号:管理员可预填你的 Hikarinagi 数字用户 ID,首次授权即可完成绑定并登录;也可先创建带本地密码的账号,再在「我的 → 个人信息」自行绑定
  • 已绑定账号可以直接免密登录,也可以继续使用用户名密码登录
  • 同一 Sena 账号可以同时绑定 NextMoe 与 Hikarinagi

个人绑定、重新授权与解绑在「我的 → 个人信息」中管理,详见 第三方账号绑定。

自动登录 ​

客户端启动时会优先尝试自动登录上次使用的服务器配置。启动时会请求 /api/auth/profile/me 检查保存的 token 是否仍然有效:

  • token 有效 → 直接进入游戏库
  • token 过期或服务端已重置 → 弹出重新登录或初始化流程
  • 连接异常 → 弹窗提示连接失败,不会静默失败

退出登录 ​

在「我的」界面点击「退出登录」,回到服务器选择界面。退出只清除当前激活会话,不删除已保存的服务器配置。


首次初始化服务端 ​

连接到未初始化的服务端时,客户端会进入服务端初始化向导:

第零步:选择初始化方式

  • 新建服务端 — 走下面的三步向导,从零开始配置
  • 导入备份 — 选择 senacli backup 导出的 .zip(或 --json-only 导出的 .json)上传,服务端会恢复游戏库、补丁规则、账号和封面图片。导入完成后用备份里的账号登录,向导直接结束

第一步:创建管理员 填写首个管理员的用户名和密码。

第二步:配置目录与刮削

  • 游戏库目录(可添加多个,支持本地路径或 OpenList 源)
  • Steam 补丁库目录
  • 批量刮削字段来源配置(封面用哪个源、简介用哪个源等)
  • 自动扫描开关与间隔
  • 管理员账号可以选择绑定 NextMoe 或 Hikarinagi 账号(可选,用于免密登录)

第三步(可选):本地配置 确认客户端本机的下载目录和 Steam 目录。

初始化完成后,服务端会在后台自动触发首次扫描和刮削。

OpenList 文件源 ​

在第二步配置目录时,游戏库目录和 Steam 补丁库目录都可以选择本地路径或 OpenList 文件源:

  1. 添加 OpenList 服务器,填写地址、用户名和密码;留空时使用 OpenList 访客模式。
  2. 填写 OpenList 地址,例如 http://192.168.1.100:5244。如果遗漏协议,服务端会尝试补 http://。
  3. 添加游戏库目录或 Steam 补丁目录时选择该 OpenList 服务器。
  4. 填写 OpenList 内部路径,例如 /115/Games/GalGame/Library。
  5. 选择目录结构 / 游戏目录深度。

OpenList 地址必须同时能被 Sena 服务端和客户端设备访问;只在服务端可访问会导致扫描成功但客户端下载失败。服务端侧的部署方式和下载链路见 文件源接入。

Released under the AGPL v3 License.