元数据刮削
Sena Repo 支持为游戏补充封面、背景、简介、会社、开发商、发售日、标签、别名、游玩时长和外部资料 ID。刮削由服务端统一处理,客户端负责选择来源、展示候选结果和逐字段对比。
支持来源
| 来源 | 认证 | 说明 |
|---|---|---|
| VNDB | 可选 Token | 含平均游玩时长数据 |
| Bangumi | 可选 Token | 中文元数据丰富 |
| Steam | 免认证 | 封面、背景、简介 |
| Hikarinagi | OAuth 用户令牌 / Client ID + Secret | 中文 Galgame 资料站 |
| NextMoe | 应用密钥或 OAuth 用户令牌 | 聚合六源;独立模式,开启后禁用其他刮削源;含游戏时长(仅单条目详情) |
NextMoe 是独立的刮削模式:在客户端「扫描设置 → 刮削源」中开启后,其余刮削源会自动关闭并禁用,单条目和批量刮削都只走 NextMoe。密钥在 https://developer.nextmoe.dev 控制台自助创建应用并勾选 catalog:read,免费额度为每分钟 60 次、每天 50000 次;关闭 NextMoe 后其余刮削源恢复可选。NextMoe 模式下还可以在客户端「刮削设置」选择补丁名称来源:默认直接用 NextMoe 名称,开启「补丁名称用 Steam 名称」后补丁会先解析 AppID、再取 Steam 商店名称(取不到时回退 NextMoe)。
游戏时长来自 NextMoe 详情接口的 playtimes 块(多上游并列,优先取 nextmoe 聚合行)。由于列表接口不返回该字段,只有单条目刮削(详情)会写入平均时长,批量刮削不会写入,也不会额外请求详情。
凭据配置
| 配置项 | 说明 |
|---|---|
SENA_BANGUMI_TOKEN | Bangumi API Token |
SENA_VNDB_TOKEN | VNDB API Token,可选 |
SENA_HIKARINAGI_CLIENT_ID / SENA_HIKARINAGI_CLIENT_SECRET | Hikarinagi 应用凭据(config.yaml 中为 scrapers.hikarinagi_*),用户未绑定时使用 |
SENA_NEXTMOE_API_KEY | NextMoe 应用密钥(nmk_live_…),未绑定 OAuth 时作为后备 |
SENA_OAUTH_ENABLED | 是否开启 NextMoe OAuth,默认 true |
SENA_OAUTH_CLIENT_ID | 覆盖默认的官方 OAuth 客户端 ID |
SENA_OAUTH_ISSUER / SENA_OAUTH_SCOPES | NextMoe OAuth 服务地址与 scope,通常无需修改 |
SENA_OAUTH_HIKARINAGI_ENABLED | 是否开启 Hikarinagi OAuth 登录、绑定与用户令牌刮削,默认 true |
SENA_OAUTH_HIKARINAGI_CLIENT_ID / SENA_OAUTH_HIKARINAGI_SCOPES | Hikarinagi public client ID 与 scope |
SENA_PROXY | 刮削代理,支持 HTTP / SOCKS5 等 httpx 可用代理格式 |
NextMoe 默认通过 OAuth 免密绑定:在服务器选择界面点「使用 NextMoe·未萌 账号登录」,或在初始化向导、「我的 → 个人信息」中绑定。绑定后单条目刮削使用该账号自己的授权;未绑定时回退到服务端配置的 SENA_NEXTMOE_API_KEY。
Hikarinagi 也可在「我的 → 个人信息」绑定。绑定后,服务端会加密保存该账号的 Hikarinagi 令牌并自动续期,单条目搜索和手动刮削使用用户自己的授权;未绑定时回退到 scrapers.hikarinagi_client_id / client_secret。用户授权失效时会提示重新授权,定时扫描仍使用服务端应用凭据。
服务端可以通过环境变量或 /data/config.yaml 配置这些项;客户端「设置 → 服务端 → 扫描设置」的「刮削源」区域可以保存 Bangumi / VNDB Token、配置代理、NextMoe 密钥与补丁名称来源,并设置批量自动刮削的字段来源规则(封面用哪个源、简介用哪个源等)。
别名自动填充
VNDB(aliases)、Bangumi(infobox「别名」)、Hikarinagi(aliases)和 NextMoe(title_kind=alias)会在刮削时提取别名,去重后以「、」拼接写入游戏别名(最多 5 条、200 字符)。「补全缺失」只填空,「覆盖」会替换已有别名;Steam 无别名数据。
单游戏刮削
在游戏详情页进入编辑界面后,可以:
- 选择刮削源。
- 输入关键词搜索,或使用已保存的外部资料 ID 精确匹配。
- 查看候选结果,展开后逐字段对比当前值与新值。
- 勾选要覆盖的字段;封面和背景可以从候选图中挑选(先选封面,再选背景)。
- 应用结果并保存游戏,图片由服务端下载并写入数据目录。
NextMoe 模式下,单条目刮削会优先使用当前账号绑定的 NextMoe 授权(未绑定则使用服务端密钥)。
批量刮削
批量刮削适合首次导入大量游戏后补齐元数据。可选模式包括:
| 模式 | 用途 |
|---|---|
missing | 只填补缺失字段 |
overwrite | 允许覆盖已有字段 |
metadata | 主要处理文本元数据 |
images | 主要补充封面和背景 |
字段来源规则在客户端「刮削设置」中配置;也可以通过客户端设置页或 senacli scan --scrape missing 触发扫描后的批量刮削。
平台分类与识别规则
扫描时按「分类管理」里的规则给每个压缩包归类:分类从上到下依次匹配,规则可以是关键词(文件名包含即命中)或正则(对完整文件名搜索);没有命中的默认归到 PC。PC 保留为默认分类,可编辑规则和调整顺序,其他分类可自由管理。规则页提供文件名测试;重命名分类会同步更新已有版本,删除分类需要先选替代分类,也可以用「按规则重新识别全部分类」重刷。详见客户端使用 → 分类管理。
建议
- 首次扫描后先确认游戏名、会社名和版本平台是否识别正确。
- 手工修过的条目优先使用单游戏逐字段对比,避免被批量覆盖。
- 需要平均游玩时长时使用 NextMoe 单条目刮削(详情),批量刮削不会写入。