跳转到内容

用户指南

从 ShinkiEMU Releases 下载符合平台和架构的 Manager 产物。桌面包完整解压到可写目录后,运行 shinki-emu-manager(Windows 为 .exe)。保留同包依赖、许可证和资源。桌面命令 shinki-emu-manager --help 显示帮助;不带子命令启动图形界面。

只下载 Release 中实际存在的附件。构建情况见核心目录。Android 的 debug 签名 CI APK 是测试包;iOS 真机和模拟器产物需要区分,库文件也不是可安装的 IPA。

首次启动时,请阅读中英双语防倒卖提示,并勾选“我已阅读 / I have read this”。提示累计可见八秒后才能继续。阅读确认及提示文本的 SHA-256 摘要保存在本机;提示更新后需要重新确认。ShinkiEMU 是免费开源软件,请从官网或 GitHub Releases 下载;如果你为软件付了钱,请申请退款并举报卖家。设置中的“关于”页面也可查看提示。

双语提示由 Rust 栅格化成图片,显示在引导和“关于”的图片槽中。只有完整图片以可读尺寸显示在滚动区域内时,阅读时间才会累计;隐藏、尺寸不足、被裁切或窗口最小化时暂停计时。窄窗口可增加高度,或滚动到能完整看到提示的位置。删除 UI 图片不会绕过 Rust 的完成校验,引导仍无法完成。

提示图片会跟随当前浅色或深色主题及其背景、文字颜色,自定义主题色也会同步。切换主题后图片会重新栅格化,已累计的阅读时间保留。

Manager 提供简体中文、英文和日文界面,在“设置 → 外观 → 语言”中切换。选择“跟随系统”时按操作系统语言决定:中文环境显示简体中文,日文环境显示日文,其他环境显示英文。切换立即生效,并随其他设置一起保存。Manager 自带中文和日文字体,系统没有安装 CJK 字体也能正常显示。日文界面下汉字使用日文字形,其他界面使用简体中文字形。

游戏标题、简介和补丁说明来自元数据。Manager 优先显示当前语言的内容;没有日文时显示英文,英文也没有时显示简体中文。防倒卖提示始终是中英双语。

允许联网后,Manager 每次启动会在后台检查一次自身版本,不阻塞启动,检查失败不弹窗。“设置 → 更新”提供“立即检查”,手动检查失败时显示原因。更新来自 Project-Shinkirou/ShinkiEMU 的 GitHub Releases,按 manager-v<semver> 比较;核心更新和商店游戏更新仍使用各自的入口。

可以选择接收预发布版本;首次使用预发布 Manager 时默认开启。发现新版本后会显示版本号、发布说明和当前平台的下载入口,点击后由系统浏览器打开。Manager 不自动下载或安装。选择忽略某个版本会保存到本机,之后不再提示该版本;“稍后”只隐藏本次会话的提示。离线时不发送更新请求。

在设置中添加合法取得的游戏安装目录,再扫描游戏库。选择游戏后,确认识别到的核心和游戏专用配置,再启动会话。探测命中只说明格式得到识别;加密资源仍可能需要私有配置,密钥应始终留在本机。

核心更新后,已移除的设置会自动从已保存的配置中清除。

先在设置中允许联网,再同步元数据或下载核心。进入核心管理页,刷新目录,选择当前平台的核心进行安装或更新。目录记录版本、ABI、下载地址和哈希。更新涉及已加载的库时,先结束会话,再按界面提示重启 Manager。保留完整核心目录中的 core.json、依赖、可选的 Resources/ 和许可证;单独复制 DLL 不构成完整安装。

在设置中允许联网后,打开“添加游戏 → 商店下载”。编译进多个商店时,先选择商店,再按它提供的方式登录。Steam 支持扫码、账号密码与 Steam Guard 验证,以及桌面客户端登录导入;DLsite 和 DMM/FANZA 在 Manager 内打开商店自己的登录页。Cookie 和刷新 token 只存入系统密钥库,不写入安装记录或日志;退出登录会删除对应商店保存的登录。

**网页登录(DLsite、DMM/FANZA):**点击“打开登录页”,Manager 会用系统网页组件显示商店官方登录页:Windows 用 WebView2,macOS 和 iOS 用 WKWebView,Linux 弹出 WebKitGTK 窗口,Android 在应用上方显示系统 WebView。在页面里正常登录,CAPTCHA 和两步验证也在这里完成。商店跳到登录后的页面并带上账号会话后,Manager 直接从网页组件读取该商店的 Cookie(包括 HttpOnly Cookie),关闭页面并完成登录,不需要复制或粘贴任何内容。网页组件每次都从空的私有 Cookie 存储开始,关闭后不留下数据;只有商店登录凭据保存在系统密钥库中。点“取消”、关闭窗口、在 Android 上返回,或离开商店页面,都会放弃这次登录。Windows 需要 Microsoft Edge WebView2 运行时(Windows 11 已自带),Linux 需要 WebKitGTK 4.1(libwebkit2gtk-4.1)。

**Steam 登录:**可用账号密码登录,再按提示输入邮箱或手机令牌验证码、在手机上确认;也可用 Steam 手机应用扫描本地生成的二维码。桌面版还可导入 Steam 客户端的缓存登录,手机版使用密码或扫码登录。密码不会保存;刷新 token 只存入系统密钥库:Windows 凭据管理器、Linux Secret Service、macOS/iOS 钥匙串,或 AndroidKeyStore 加密的应用私有存储。退出登录会清除已保存的登录凭据。

选择“扫码登录”后,无需输入账号密码即可向 Steam 请求新的登录二维码。Steam 响应后显示二维码,在手机应用中确认才会完成登录;取消会停止等待,不会完成登录。

搜索已拥有的游戏,选择内容仓库和分支,再选择可写的游戏库目录。默认勾选 Windows 内容仓库,手机版也一样;语言仓库可单独勾选。下载完成后,Manager 自动添加游戏并探测兼容核心。能下载游戏不代表已有核心支持它的引擎。

“检查更新”会比较本地和 Steam 上的仓库清单;再次下载会复用未变化的本地内容,执行增量更新。“校验并修复”检查并修复已安装文件。取消操作会等待正在进行的写入结束,并保留中断标记;重试时继续复用通过校验的本地块。请保留游戏目录中的 .DepotDownloader,其中记录安装清单和增量更新所需信息。

只下载当前账号已拥有的 PC 下载版。仅限 Play、串流或浏览器的作品会显示不可下载原因。Manager 不移除或绕过 DRM、启动 token 和许可证检查。分支、内容仓库和校验选项只在商店支持时出现。新安装位于 <游戏库目录>/.shinki/store/<商店>/installs/,暂存和缓存位于 <Manager 数据目录>/.shinki/store/<商店>/。旧 Steam 安装记录与密钥库引用会迁移一次,游戏文件不搬动。

商店无法确定已安装版本时,Manager 以普通状态显示 Update status unavailable,不显示更新操作;刷新游戏库可再次查询。部分下载是压缩包或安装程序,下载完成后会显示 Downloaded archives need manual extraction or installer run,并提供“打开下载目录”。请自行解压或运行官方安装程序,再把实际可运行的游戏目录加入 Manager;Manager 不绕过安装程序或 DRM。

DLsite 使用上面的网页登录,从 DLsite Play 的登录页开始;DLsite 带着 __DLsite_SID 账号会话回到 Play 时登录完成。会话只保存在系统密钥库中。库列表来自 DLsite Play 的已购作品;只有 DLsite 为账号提供原版 PC 下载时,Manager 才会下载游戏文件,不会把 Play 阅读器或媒体优化文件当作 PC 游戏安装。ZIP 会经过路径安全检查后解压。RAR 和自解压安装包保留原样,需要手动解压或安装;Manager 不会运行下载的可执行文件。目前查到的 DLsite 接口没有可靠的本地构建标识,因此更新状态显示为未知。

如果作品无法解析出下载计划,请在已登录的浏览器中重现,并导出包含响应内容的 HAR。记录从 https://play.dlsite.com/api/v3/download?workno=<已购作品编号> 开始,直到重定向及 /home/download、/home/serial 或分卷列表请求结束。分享前删除 Cookie、序列号和签名 URL token。不要提交 HAR 文件。

默认元数据源为:

https://project-shinkirou.github.io/data/shinkiemu/v1/

设置页提供联网许可和手动同步。损坏或未通过校验的快照不会覆盖有效缓存。查看报告时,应同时匹配 VNDB 发行版 rID、核心、平台、架构及 desktop/device/simulator 变体。其他平台或架构的结论不能套用到当前环境。可通过 issue 表单提交可复现的观察。

从在线补丁选择已审查的 Luau 补丁,或用**加载本地补丁…**打开 .luau 脚本或 ZIP。未绑定目录的本地脚本标记为未经审核。在线补丁绑定具体发行版本,写入前核对文件指纹。脚本只有在用户明确选择后才运行;脚本下载使用 HTTPS,核对声明的大小和 SHA256 后缓存到 <game>/.shinki/patch/,在线条目只允许其声明的下载。

补丁页默认采用新目录模式,原游戏保持不变,不复制存档。原位覆盖先写入私有暂存区,将修改或删除的原文件备份至 <game>/.shinki/backup/<id>/,并用 manifest.json 记录哈希。“还原最近一次补丁”不会覆盖用户后来修改的文件。原位回执位于 <game>/.shinki/patch-result.json。资源补丁不能新增或修改 EXE。贡献方式见 Metadata。

Windows、macOS 和 Linux 的新目录模式使用文件夹选择器。点击“选择输出”后,选择存放转换结果的父目录,也可以用系统的文件夹操作在其中新建文件夹。Manager 会显示最终输出的完整路径:父目录下的 localized-output;名称已被占用时,改用 localized-output-1、localized-output-2 等。开始前请核对这个路径。选择操作不会创建转换目录,转换成功后才发布结果;取消选择会保留原来的路径。已有文件和目录不会被覆盖,选择后才被其他程序占用的输出路径也会被拒绝。输出不能与游戏或补丁输入目录重叠。原位覆盖不使用输出目录选择。iOS 会在选中的父目录下创建新的 localized-output 子目录;Android 使用新的应用私有导出目录。

新 Musica 补丁要求 Musica 核心 beta.5 或更高版本;Yorino 需要 256 和 512 两个能力位。RFVP 原生脚本补丁要求脚本存档隔离与配置字体优先。Manager 在导入和启动前检查实际加载的核心;如果提示更新,请先更新再重试,版本名称不能代替能力检查。旧 Manager 继续读取保留的 v1 目录和旧脚本。

ShinkiEMU 使用新的平台应用数据目录,可从设置中打开。桌面可用 SHINKI_EMU_DATA_DIR 指定绝对路径;Android 使用应用私有目录。更名前的应用数据库、缓存和产品自有存档不自动导入。此次切换不改动原游戏安装和原商业存档。

存档规则由核心决定。Musica 在 <game>/.shinki/musica/minori/<title>/ 下使用原版 eden/Perseus 的 .sav 和 .png。旧 beta 的 .asav 不兼容,不读取、不改动,也不提供转换。ReMinori 使用单独的存档目录。备份数据或交换兼容的原版格式文件前,先结束活动会话。