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 文件源:
- 添加 OpenList 服务器,填写地址、用户名和密码;留空时使用 OpenList 访客模式。
- 填写 OpenList 地址,例如
http://192.168.1.100:5244。如果遗漏协议,服务端会尝试补http://。 - 添加游戏库目录或 Steam 补丁目录时选择该 OpenList 服务器。
- 填写 OpenList 内部路径,例如
/115/Games/GalGame/Library。 - 选择目录结构 / 游戏目录深度。
OpenList 地址必须同时能被 Sena 服务端和客户端设备访问;只在服务端可访问会导致扫描成功但客户端下载失败。服务端侧的部署方式和下载链路见 文件源接入。