资讯动态

YaeAchievement 原神成就导出实战教程:从下载、启动到椰羊/Seelie/CSV 多端导入全流程

发布时间:2026/10/5 1:56:02 来源:尧图企业网站定制
桌面应用CLI【免费下载链接】YaeAchievement更快、更准的原神数据导出工具项目地址https://gitcode.com/gh_mirrors/ya/YaeAchievement点击查看免费下载YaeAchievement 是一款面向《原神》玩家的成就数据导出工具能够在游戏启动的瞬间截获本地成就协议数据并将其转换为椰羊、胡桃工具箱、Paimon.moe、Seelie、寻空等多种第三方工具可识别的格式。本教程以 docs/Tutorial.md 为骨架结合仓库源码逐步骤讲解从下载、运行、游戏内采集到各目标工具导入的完整闭环读完即可独立完成一次成就导出与迁移。一、工具能力概览在开始操作前先明确 YaeAchievement 的核心能力见 README.md支持导出所有类别的成就包括活动、任务、世界、神瞳等全部分类同时支持官服、渠道服与国际服客户端没有窗口大小、游戏语言等要求启动流程全自动。整个工具的运行逻辑是用户启动工具 → 工具自动拉起原神 → 游戏运行时在本地完成成就数据采集 → 原神退出 → 用户选择导出目标。整个过程不需要任何手动抓包或文件定位。二、第一步下载正确的可执行文件以 2.4.1 版本为例操作步骤如下进入项目 Releases 页面即各版本发布页浏览该版本下附带的资产文件列表点击资产列表中名为YaeAchievement.exe的文件浏览器会自动开始下载建议将下载得到的YaeAchievement.exe保存到桌面或其它易于寻找的文件夹内。注意后续导出的 JSON / CSV 文件会生成在YaeAchievement.exe所在目录因此请务必记住存放位置。另外不要把工具与游戏主程序放在同一目录详见文末常见问题。三、第二步启动主程序并触发游戏内采集3.1 启动与原神正在启动提示双击上一步下载的YaeAchievement.exe程序成功打开后会显示终端界面并提示**原神正在启动**。这一提示的背后是程序自动接管了游戏进程的启动。从 AppConfig.cs 的源码可以看到工具会按以下优先级解析游戏可执行文件路径命令行参数启动时若传入第一个参数且该路径下文件存在则直接使用AppConfig.Load(args.ElementAtOrDefault(0) ?? auto)本地缓存读取CacheFile中保存的genshin_impact_game_path_v2并校验路径对应的文件哈希是否一致防止路径失效Unity 输出日志从%USERPROFILE%\AppData\LocalLow\miHoYo\原神(output_log.txt)或Genshin Impact(output_log.txt)中正则匹配GenshinImpact_Data/YuanShen_Data目录反推主程序路径进程查找若以上均失败则进入等待用户手动打开游戏的循环通过进程快照找到游戏主进程后取其可执行文件路径并结束该进程。拿到路径后工具通过 GameProcess.cs 以CREATE_SUSPENDED挂起方式创建游戏进程随后把钩子动态库注入游戏进程并恢复主线程从而在游戏内部直接捕获成就协议消息——这就是原神正在启动的真正含义游戏其实是被工具拉起并挂接了采集钩子的。3.2 进入游戏并等待数据采集等待原神启动完成后点击进入游戏即可进入游戏后原神会自动退出工具随即进入导出目标选择界面。这里的自动退出不是异常游戏在启动阶段即已完成本地成就数据下发采集完成后工具主动结束了游戏进程。从 Program.cs 可看到工具在启动时即注册了三个协议处理回调AchievementAllDataNotify、PlayerStoreNotify、PlayerPropNotify并在数据接收完毕后调用AchievementAllDataNotify.OnFinish()退出。小技巧如果距离上次导出不超过 60 分钟工具会询问是否直接复用缓存的成就数据CacheFile.GetLastWriteTime(achievement_data).AddMinutes(60)选择是即可跳过再次启动游戏直接进入导出选择。四、第三步选择导出目标工具原神退出后工具会弹出导出目标选择列表。一般推荐导出至[0] 椰羊以及[4] 表格文件(.csv)前者便于云端同步与网页查看后者适合本地归档与二次处理。从 Export.cs 的源码可以看到完整的导出目标映射表括号内为终端中显示的序号序号导出目标实现方式0椰羊上传至椰羊云端返回cocogoat.work/achievement?memo...链接1胡桃工具箱Snap.Hutao检测hutao://协议后复制数据到剪贴板并唤起应用2Paimon.moe生成export-时间戳-paimon.json文件3Seelie.me生成export-时间戳-seelie.json文件4表格文件 (.csv)生成achievement-时间戳.csv并自动打开资源管理器定位5寻空Xunkong检测xunkong://协议后复制数据到剪贴板并唤起应用6原魔工具箱微信小程序导出源码中该分支默认被注释禁用7TeyvatGuide检测teyvatguide://协议后复制数据并唤起应用8UIAF JSON 文件生成符合 UIAF v1.1 标准的uiaf-时间戳.json文件如果你在命令行带参数启动YaeAchievement.exe [游戏路径] [导出序号]第二个参数传入序号即可跳过交互选择直接执行对应导出未传参时ExportTo为默认值114514此时进入交互式菜单。4.1 椰羊推荐选择椰羊后工具会将成就数据 POST 至椰羊的 memo 接口随后在终端输出一个形如https://cocogoat.work/achievement?memo...的链接并自动用默认浏览器打开。你只需在打开的网页中确认数据即可完成同步。4.2 表格文件 .csv推荐选择 CSV 后工具会在 exe 所在目录生成achievement-时间戳.csv并自动打开所在文件夹。从 Export.cs 的ToCSV实现可以看出其输出规范文件以UTF-8 带 BOM编码写入\uFEFF前缀Excel 可直接打开不乱码表头为ID,状态,特辑,名称,描述,当前进度,目标进度,完成时间行数据按成就 ID 排序并附带特辑分组名称已完成的成就额外输出本地时区的完成时间格式yyyy/MM/dd HH:mm:ss内部维护了一张废弃成就过滤表如 ID84517这些成就不会出现在 CSV 中。4.3 Snap.Hutao胡桃工具箱选择后工具会先检查系统是否注册了hutao://协议即判断胡桃工具箱是否安装。若已安装则自动将 UIAF 格式数据复制到剪贴板并唤起应用的成就导入界面若未安装会提示需要更新并引导前往 Microsoft Store 安装。4.4 Paimon.moe工具在 exe 所在目录生成export-时间戳-paimon.json。从 Paimon.cs 可见该文件按特辑分组→ 成就 ID两层字典组织只包含已完成成就可在 Paimon.moe 网站通过导入功能上传。4.5 Seelie.me选择 Seelie 后工具提示成就数据已导出请在保存YaeAchievement.exe的文件夹内找到名称形如export-20xxxxxxxxxxxx-seelie.json的文件时间戳为导出时刻打开 Seelie 官网进入设置Settings页面选择导入Import功能在文件选择框中选中上述export-20xxxxxxxxxxxx-seelie.json文件当页面弹出导入成功提示时即表示数据已写入此时点击左侧栏的成就Achievement即可查看已导入的成就数据。Seelie 导出文件由 Seelie.cs 生成内容基于 UIAF 数据模型序列化。4.6 寻空Xunkong与胡桃工具箱类似若检测到xunkong://协议已注册即已安装寻空则自动将 UIAF 数据复制到剪贴板并唤起xunkong://import-achievement?callerYaeAchievementfromclipboard完成导入未安装时引导前往 Microsoft Store。4.7 其它导出目标原魔工具箱序号 6面向 iOS/App Store 环境的微信小程序数据同步方案当前仓库源码中对应分支被注释禁用需留意版本差异TeyvatGuide序号 7通过teyvatguide://import_uiaf?appYae协议唤起应用导入要求 TeyvatGuide 进程已在运行UIAF JSON序号 8生成符合 UIAF v1.1 规范的uiaf-时间戳.jsoninfo段记录导出应用名、版本号、导出时间戳与 UIAF 版本list段记录每条成就的 ID、状态、当前进度与完成时间戳。该格式是社区通用中间格式其它支持 UIAF 的工具均可直接读取。五、常见问题与排查5.1 原神启动时报错数据异常(31-4302)原因工具与游戏主程序放在了同一目录导致游戏启动时校验文件环境异常。解决办法把YaeAchievement.exe移到其它文件夹如桌面或独立目录后再运行。5.2 找不到导出的 JSON / CSV 文件导出文件一律生成在YaeAchievement.exe所在目录请回到该目录查找文件名带有导出时刻的时间戳如export-20261004021533-seelie.json、achievement-20261004021533.csv。5.3 导出后想再次导出其它目标只要上次导出的数据缓存未超过 60 分钟重新启动工具后选择使用上次数据即可跳过游戏启动直接进入导出选择或者直接带参数运行YaeAchievement.exe auto 00 换成目标序号实现一键导出。六、小结完整流程可归纳为下载 exe → 双击运行 → 等待原神被自动拉起 → 进入游戏完成数据采集 → 原神自动退出 → 选择导出目标推荐椰羊或 CSV→ 按目标工具的导入方式完成迁移。对于 Seelie 用户核心产物就是export-...-seelie.json文件及其在官网设置页的导入操作对于需要本地归档的用户CSV 提供了带 BOM 的 UTF-8 编码与完整字段。若在安装使用中遇到31-4302错误请先检查是否误将工具与游戏放在同一目录。更多配置与命令行参数细节可参考 Program.cs 与 Export.cs 源码。赞分享桌面应用CLI【免费下载链接】YaeAchievement更快、更准的原神数据导出工具项目地址https://gitcode.com/gh_mirrors/ya/YaeAchievement点击查看免费下载相关推荐YaeAchievement 使用教程原神全成就数据一键导出到椰羊、Seelie、胡桃工具箱等 9 大工具的完整操作指南YaeAchievement 使用教程原神全成就数据一键导出到椰羊、Seelie、胡桃工具箱等 9 大工具的完整操作指南 YaeAchievement 是一款桌面应用CLI解锁原神全成就YaeAchievement一键导出完整教程解锁原神全成就YaeAchievement一键导出完整教程 还在为原神成就统计发愁吗 想要轻松管理你的游戏成就数据今天就来体验这款让成就管理变得超级简桌面应用CLICleanflight硬件选择指南如何挑选最适合的飞行控制器板Cleanflight硬件选择指南如何挑选最适合的飞行控制器板 为你的无人机选择正确的飞行控制器飞控是确保飞行性能和稳定性的关键。Cleanflight作嵌入式上一篇Vue后台框架高效开发企业级管理系统的前端模板解决方案下一篇如何用TaskbarX打造个性化任务栏超详细实战指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑