使用文档
完整的功能说明与操作指引，涵盖所有模块的使用方法与注意事项。
快速开始
系统要求
最低要求
- Windows 10 22H2 及以上
- .NET 10 运行时
- Windows App SDK 1.7
- 4 GB 内存
- 200 MB 可用磁盘空间
推荐配置
- Windows 11 23H2 及以上
- 8 GB 及以上内存
- 已安装原神客户端
- 有效的米哈游账号
- 稳定的网络连接
依赖与环境
ky3 Launcher 依赖以下运行时组件，安装程序会自动检测并引导安装缺失项。若手动部署，请确保以下依赖均已就绪：
.NET 10 Desktop Runtime
WinUI 3 应用的核心运行时，提供 CLR 托管环境与基础类库
≥ 10.0.0
Windows App SDK
WinUI 3 UI 框架运行时，提供 XAML 渲染引擎、窗口管理与系统通知 API
≥ 1.7
WebView2 Runtime
内置浏览器组件，用于米游社/HoYoLAB 网页登录与公告图片展示
Evergreen
Visual C++ Redistributable
C++ 注入模块（MinHook）的运行时依赖，帧率解锁/FOV 修改等功能必需
≥ 2022 (x64)
SQLite
本地数据存储引擎，存放账号凭据、祈愿记录、成就数据等，随应用打包无需单独安装
自动打包
winget install Microsoft.DotNet.DesktopRuntime.10
winget install Microsoft.WindowsAppSDK.1.7
winget install Microsoft.EdgeWebView2Runtime
winget install Microsoft.VCRedist.2015+.x64
提示Windows 11 22H2 及以上系统已预装 WebView2 Runtime。若使用 ky3 Launcher 安装程序（Setup.exe），所有依赖会在安装过程中自动检测并引导安装，无需手动执行上述命令。
安装步骤
下载安装包
前往 版本发布 页面，或直接通过 阿里云 OSS 直链 下载最新版本的 ky3Launcher_Setup.exe。
运行安装程序
双击安装包，选择安装目录（默认 C:\Program Files\ky3Launcher），点击安装。安装完成后会自动启动软件。
登录账号
首次启动后，点击左下角用户区域，登录米游社扫码或手机号码验证，支持其他方式添加账号，即可开始使用全部功能。如遇问题，请查看 常见问题。
配置游戏路径
在启动游戏页面中指定原神的安装目录，软件将自动识别国服、B服或国际服版本。
注意部分功能（成就管理、注入选项）需要以管理员权限运行 ky3 Launcher。如遇到功能无法使用的情况，请右键软件图标选择"以管理员身份运行"。
账号管理
ky3 Launcher 支持同时管理多个米哈游账号，账号数据以加密形式存储在本地 SQLite 数据库中，不会上传至任何服务器。
添加账号
点击界面左侧底部的用户头像区域，在弹出的账号面板中点击"添加账号"。支持以下方式登录：
扫码，手机号码验证或Cookie 登录（国服 · 推荐）
在 ky3 Launcher 内置浏览器中打开米游社网页，系统自动提取 Cookie 完成登录。全程无需手动复制粘贴，数据来源可信。
B 站账号登录（国服 B 服）
通过内置 Bilibili 授权流程登录，支持 B 站账号下绑定的原神角色查询、便笺与签到功能。
HoYoLAB 登录（国际服）
通过 HoYoLAB 网页授权登录，支持国际服角色数据查询、便笺监控与 HoYoLAB 每日签到。
切换当前账号
在账号面板中点击任意账号行即可将其设为当前活跃账号。所有数据拉取、签到、便笺等操作均以当前账号为准。点击"以当前账号登录游戏"可在启动原神时自动注入登录凭据，无需手动在游戏内切换账号。
启动游戏
ky3 Launcher 提供一站式游戏启动体验，集成服务器切换、注入选项与账号快捷登录功能。点击主页的「开始游戏」按钮即可一键启动原神，已开启的注入选项与启动配置会自动生效。
基础配置
首次使用时，需在启动游戏页面指定原神的安装目录，软件将自动识别当前安装的服务器版本。
游戏路径
指向原神安装目录，软件自动检测国服/B服/国际服版本
以当前账号登录游戏
启动时自动注入 auth ticket，跳过游戏内账号切换步骤（仅国服米哈游账号有效）
自定义启动参数
向游戏传入额外命令行参数，满足进阶使用需求
附加程序
游戏启动时自动运行指定的外部程序（最多 3 个），游戏退出后自动关闭
服务器切换
ky3 Launcher 支持在国服（米哈游渠道）、国服 B 服（Bilibili 渠道）与国际服（HoYoverse）之间一键切换，自动完成 SDK 文件替换与配置管理。
确保原神已完全关闭（包括米哈游启动器）再进行切换操作。
在启动游戏页面选择目标服务器版本，点击「切换」。
软件将自动下载所需差量文件包（Sophon 协议，并发分块下载），完成后提示切换成功。
注意从国服切换至国际服（或反向）需要下载较大的差异文件包（约数百 MB），请确保磁盘空间充足且网络稳定。已下载的文件会缓存在 ServerCache 目录中，二次切换无需重复下载。
注入选项
注入选项基于自研 MinHook C++ 模块实现，在游戏运行时动态 Hook 目标函数，无需修改游戏文件。所有选项均可在游戏运行期间实时开关，无需重启游戏。
帧率V1模式
突破 60fps 上限，支持 30–1000 自定义目标帧率
帧率V2模式
第二套帧率解锁方案，与 V1 可选其一使用，支持 30–1000 自定义值
视野热开关（FOV）
调整第三人称摄像机视野角度，范围 30°–120°，支持实时调节
禁用垂直同步
关闭游戏垂直同步，配合帧率解锁使用可释放更高帧率
移除迷雾
关闭场景中的体积雾与大气散射，改善远景可见度
禁用角色渐隐
关闭角色靠近时的渐隐动画效果
隐藏游戏内 UID
隐藏游戏画面中的 UID 水印，适合直播与录屏场景
隐藏菜单 UID
隐藏菜单界面中的 UID 显示，进一步保护隐私
隐藏地图卡片
隐藏地图上的任务追踪卡片横幅，保持界面简洁
移除队伍配置进度条
移除队伍配置界面中的进度条显示
移除Q动画播放
跳过角色元素爆发的镜头动画，加快战斗节奏
移除战斗伤害数字
关闭战斗中的浮动伤害数字显示，减少画面杂乱
可合成重定向
将合成操作重定向到指定入口，简化合成流程
随身合成台
启用便携合成台功能，随时随地进行合成操作
重载配置热键
自定义快捷键组合（修饰键 + 键码），在游戏中实时重载注入配置
手机端模式
模拟触屏设备输入模式，启用移动端 UI 布局
注意注入选项在游戏启动后方可生效。通过 ky3 Launcher 的「开始游戏」按钮启动时，已开启的注入选项会自动随游戏一同注入，无需手动操作。首次启用注入功能需要确认风险提示。
签到福利
签到福利页面对接米游社/HoYoLAB 每日签到活动，可查看当月签到奖励日历、已签天数、漏签天数，并支持手动签到与补签操作。
签到方式
手动签到
进入签到页面，点击「签到」按钮即可领取当天奖励（原石、摩拉等）
补签
对漏签日期进行补签，消耗补签次数（每月/每日限额）
自动签到
开启后，系统在每日凌晨 4:00 自动执行签到任务，软件未运行时下次启动自动补签
提示自动签到由内置 Quartz.NET 调度器驱动。签到结果会通过 Windows 系统通知告知，包括签到成功的奖励名称或失败原因。
成就管理
ky3 Launcher 内置 Yae 内存扫描引擎，通过向游戏进程注入 YaeAchievementLib.dll 直接读取 Protobuf 数据，实现零误差的成就全量提取，导出结果符合 UIAF v1.1 标准。
使用步骤
先启动原神，等待角色可以正常移动后（即进入游戏场景），再回到 ky3 Launcher。
在左侧导航点击「成就管理」，进入成就页面，点击「导入成就」按钮。
软件将自动完成注入、数据读取与解析，通常在 0.5 秒内完成全部 1,677 条成就同步。
同步完成后，可在成就列表中按分类筛选查看，也可点击「导出 UIAF」将数据导出为 JSON 文件，导入至其他支持 UIAF 标准的工具。
> 定位 Protobuf PlayerStoreNotify 偏移量...
> 解析成就数据包...
> 1,677 条成就已同步，耗时 0.12s
注意成就导入需要管理员权限，且仅支持原神 PC 版（国服/国际服）。B 站账号游戏客户端同样支持，但需保证 ky3 Launcher 以管理员权限运行。
祈愿记录
ky3 Launcher 可从米游社/HoYoLAB API 拉取完整的祈愿记录，并以符合 UIGF v4.0 标准的格式在本地存储，支持离线查看与跨工具导出。
获取方式
软件支持两种方式获取祈愿记录：
URL 自动抓取（推荐）
在游戏内打开祈愿历史页面后，软件自动从日志文件中提取 AuthKey URL，无需手动操作。支持国服/B服/国际服。
UIGF 文件导入
支持导入符合 UIGF v4.0 标准的 JSON 文件，可从其他工具导出后合并到本地。
刷新记录
进入「祈愿」页面，点击「刷新」按钮。软件会自动从当前账号拉取所有卡池（角色活动、武器活动、常驻、新手）的历史记录，增量更新至本地数据库，已有记录不会重复拉取。
统计面板
刷新完成后，统计面板将显示各卡池的关键数据：
90
保底计数
1.6%
五星出率
324
总抽次数
5
五星数量
导出与导入
点击「导出 UIGF」将当前账号的祈愿记录导出为 JSON 文件，可导入至其他支持 UIGF v4.0 的工具。也可通过「导入」功能将其他工具导出的 UIGF 文件合并到本地数据库。
实时便笺
实时便笺功能对接米游社/HoYoLAB 便笺 API，实时展示原粹树脂、每日/周任务完成情况、洞天宝钱、参量质变仪等关键游戏数据，并在树脂满溢前推送系统通知。
数据项说明
刷新机制
软件每 8 分钟自动刷新一次便笺数据（符合 API 访问频率限制）。进入便笺页面时会立即触发一次刷新。
注意便笺 API 需要有效的 cookie_token。若数据显示"获取失败"，请尝试在账号设置中重新刷新 Cookie，或重新登录账号。
UP计时
UP 计时功能基于祈愿历史记录，自动追踪所有限定 UP 角色与武器的复刻周期。通过分析卡池元数据与历史活动时间，展示每个角色/武器距上次 UP 已过去的天数，帮助规划抽卡策略。
数据展示
五星限定角色
按距今天数排序，显示每个角色上次 UP 的卡池版本与结束日期
四星限定角色
追踪四星 UP 角色的复刻周期，包含历史出现次数统计
五星限定武器
展示限定五星武器的复刻间隔与上次出现版本
四星限定武器
追踪四星 UP 武器的历史出现记录与复刻天数
提示UP 计时数据来源于在线元数据服务，首次进入页面时需要联网加载卡池历史信息。常驻祈愿池角色/武器不在追踪范围内。
深境螺旋
深境螺旋页面通过米游社/HoYoLAB GameRecord API 拉取当前与历史深渊战绩数据，并存储在本地数据库中支持历史回溯。同时提供社区统计数据对比功能。
功能说明
战绩概览
展示最深抵达层数、获得总星数、战斗次数等关键指标
战斗统计
最强一击、最多击破、最多承伤、最多元素战技/元素爆发角色排行
分层详情
逐层逐间展示上下半阵容、获得星数与地脉异常详情
历史归档
自动归档每期深渊记录，支持切换查看往期数据
社区统计
查看全服通过率、满星率与各层角色使用率排行
提示点击「刷新」可从服务器拉取最新数据并上传至社区数据库。米游社 API 仅保留当期与上期数据，ky3 Launcher 会在本地归档所有历史记录。
幻想真境剧诗
幻想真境剧诗（Imaginarium Theater）是原神的周期性挑战玩法。ky3 Launcher 支持拉取每期剧诗战绩，记录通关幕数、阵容配置、增益选择等详细数据。
功能说明
通关概览
展示难度等级、最高通关幕数、总战斗时长与纹章评级
阵容详情
记录初始阵容、候补角色、特邀角色（试用）与每幕选用角色
增益记录
记录每幕选择的奇妙助益卡牌与华彩增益效果
社区统计
查看全服角色候补出场率与社区数据对比
幽境危战
幽境危战是原神的高难度周期性挑战模式。ky3 Launcher 支持拉取战绩数据，记录挑战进度与阵容选择。
功能说明
挑战概览
展示当期挑战进度、最高通关难度与角色配队
角色热度
查看全服热门角色使用排行与社区统计数据
角色资料
角色资料功能通过米游社/HoYoLAB GameRecord API 拉取当前账号下所有角色的详细面板数据，包括装备、天赋、命座与圣遗物属性。
数据内容
角色列表
展示账号下所有已拥有角色，按元素/稀有度/等级筛选排序
面板属性
查看角色等级、命座、好感度、生命值/攻击力/防御力等详细属性
装备详情
武器等级/精炼、圣遗物各部位的词条信息与套装效果
天赋等级
普攻、元素战技、元素爆发的当前天赋等级与升级状态
公告系统
ky3 Launcher 内置公告系统，用于推送软件更新通知、重要提醒与功能说明。公告每 5 分钟自动轮询一次，进入公告页面时会立即强制刷新。
通知行为
当有新公告时，软件会在界面顶部弹出 InfoBar 通知。若当前窗口未激活（处于后台），通知将在窗口重新获得焦点后延迟推送，避免遗漏重要信息。
图片公告
公告中的图片链接可点击，图片将以自适应大小的弹窗形式在软件内展示，无需跳转浏览器。
设置
设置页面集中管理 ky3 Launcher 的全局配置，包括更新检查、数据存储、自动化行为等。
自动更新
ky3 Launcher 内置更新检查机制，启动时自动对比本地版本与服务器最新版本，如有新版本可用将在界面顶部弹出更新提示。
点击更新提示中的「立即更新」按钮。
软件下载最新安装包，完成后自动运行安装程序并退出当前版本。
安装程序完成覆盖安装后，自动重新启动 ky3 Launcher，整个过程约 30 秒。
数据存储
所有数据均存储在本地 SQLite 数据库中，不会上传至任何第三方服务器。
账号凭据
Cookie、auth ticket 等登录凭据以 AES 加密存储在本地数据库
祈愿记录
以 UIGF v4.0 标准格式存储，支持增量更新与跨工具导入导出
成就数据
Protobuf 解析后的结构化数据，支持 UIAF v1.1 格式导出
深境螺旋 / 幻想真境剧诗 / 幽境危战
各期战绩数据归档存储，支持历史回溯查询
软件配置
用户偏好设置、注入选项开关状态、游戏路径等
数据备份与迁移
仅需备份 Userdata.db 单个文件即可完成全量数据备份。该文件位于 %LOCALAPPDATA% 对应的应用目录下。迁移至新电脑时，将该文件放回相同位置即可恢复所有数据。
注意数据库文件在软件运行时处于锁定状态，请在关闭 ky3 Launcher 后再进行备份操作，以避免数据损坏。更新软件不会影响任何已有数据。
常见问题
成就导入时提示"注入失败"怎么处理？
请确保：① ky3 Launcher 以管理员权限运行；② 原神游戏已完全启动并进入场景（不在登录界面或加载画面）；③ 未运行其他可能冲突的注入类工具。
服务器切换后游戏无法启动？
切换完成后，若游戏无法正常启动，可尝试：① 重新运行一次服务器切换（验证文件完整性）；② 检查 ServerCache 目录下是否有对应版本的 config.ini；③ 以管理员权限运行 ky3 Launcher 后重试。
便笺数据获取失败 / 显示错误代码 -5003？
错误代码 -5003 表示 cookie_token 已过期。请进入账号管理，选择对应账号，点击"刷新 Cookie"重新获取有效凭据。若刷新失败，需重新通过内置浏览器登录账号。
帧率解锁后游戏帧率未变化？
请检查：① 显示器是否支持目标刷新率；② 游戏内图形设置中的帧率上限是否已手动修改（应保持默认）；③ NVIDIA/AMD 驱动控制面板中是否有额外帧率限制。注入成功后，游戏内帧率上限设置会被软件接管。
"以当前账号登录游戏"对 B 站账号无效？
这是预期行为。B 站账号使用 Bilibili 自有 SDK 登录体系，不支持米哈游 auth ticket 接口，游戏会使用 B 站客户端自身的登录机制启动，功能正常使用不受影响。
安装时提示缺少 .NET Runtime 或 Windows App SDK？
请参考文档「依赖与环境」章节，通过 winget 或微软官网手动下载安装 .NET 10 Desktop Runtime 和 Windows App SDK 1.7。使用安装程序（Setup.exe）安装通常会自动处理依赖。
如何完全卸载 ky3 Launcher？
通过系统设置 > 应用 > 已安装的应用中找到 ky3 Launcher 卸载即可。卸载后若需彻底清除用户数据，手动删除安装目录下的 Data/ 文件夹。
数据可以迁移到其他工具吗？
可以。祈愿记录支持导出为 UIGF v4.0 JSON 文件，成就数据支持导出为 UIAF v1.1 JSON 文件，均可导入至其他第三方工具。