椰羊cocogoat：原神圣遗物自动管理终极指南

【免费下载链接】cocogoat-clientA toolbox for Genshin Impact to export artifacts automatically. 支持圣遗物全自动导出的原神工具箱，保证每一行代码都是熬夜加班打造。项目地址: https://gitcode.com/gh_mirrors/co/cocogoat-client

椰羊cocogoat是一款专为《原神》玩家设计的智能工具箱，通过圣遗物自动识别和智能切换功能，帮助玩家高效管理装备资源。这个基于TypeScript、Vue.js和Electron开发的开源工具，能够自动识别游戏中的圣遗物属性，并实现一键导出到各大伤害计算平台，大幅提升游戏体验。

🚀 项目核心功能速览

椰羊cocogoat提供三大核心功能，完美解决《原神》玩家在圣遗物管理上的痛点：

椰羊cocogoat的地图悬浮窗功能，支持高分辨率游戏地图实时显示

📖 5分钟快速上手指南

第一步：环境准备与安装

1. 系统要求：Windows 7及以上系统（Windows 7需开启Aero透明效果）
2. 游戏设置：将《原神》分辨率调整为16:9比例（推荐1920x1080或1600x900）
3. 权限配置：以管理员身份运行cocogoat程序，确保模拟点击功能正常

重要提示：程序需要管理员权限才能正常模拟鼠标点击和滚轮操作，否则无法实现自动切换功能。

第二步：基础功能配置

进入程序后，首先配置以下核心模块：

• OCR识别设置：在src/ArtifactView/中配置识别参数
• 导出格式选择：支持莫娜占卜铺、Mingyulab、genshin-optimizer三种格式
• 自动切换开关：根据需求开启/关闭圣遗物自动切换功能

椰羊cocogoat能够准确识别各类圣遗物，包括海染之花等高级装备

🔍 常见问题场景化解决方案

场景一：窗口背景显示异常

问题现象：程序窗口背景显示为白色，而非预期的透明效果。

快速排查步骤：

1. 检查操作系统是否为Windows 7
2. 打开"控制面板" → "外观和个性化" → "更改桌面背景"
3. 在"个性化"设置中，选择"窗口颜色"
4. 确保"启用透明效果"选项已勾选
5. 保存设置并重启程序

根本原因：Windows 7系统默认未开启Aero透明效果，导致Electron窗口无法正常显示透明背景。

场景二：圣遗物识别不准确

问题现象：OCR识别结果错误或无法识别圣遗物属性。

解决方案清单：

1. ✅ 确认游戏语言设置为中文（目前仅支持中文识别）
2. ✅ 调整游戏窗口分辨率至推荐值
3. ✅ 检查游戏字体是否被修改
4. ✅ 确保游戏界面亮度适中，避免反光或过暗
5. ✅ 更新PaddleOCR模型文件到最新版本

技术原理：程序使用专门针对《原神》游戏字体训练的PaddleOCR模型，在src/plugins/opencv/中实现图像处理逻辑。

场景三：自动切换功能失效

问题现象：圣遗物自动切换功能无法正常工作，或点击位置不准确。

分步调试方法：

1. 权限检查：右键点击程序图标，选择"以管理员身份运行"
2. 游戏分辨率验证：确保游戏窗口为16:9比例
3. ViGEm驱动确认：检查ViGEm虚拟手柄驱动是否正常安装
4. OpenCV检测测试：运行src/ArtifactSwitch/中的测试脚本

进阶技巧：如果遇到特定分辨率问题，可以手动调整src/ArtifactSwitch/imageProcess.ts中的坐标检测参数。

⚡ 进阶配置与性能优化

数据存储与便携模式

椰羊cocogoat默认将配置数据保存在%appdata%/cocogoat/config目录。如需便携使用（如放入U盘），只需在程序exe文件同级目录创建cocogoat文件夹，程序启动时会自动识别并使用该目录。

多语言支持配置

虽然当前版本主要支持中文识别，但程序已内置多语言界面框架：

性能优化建议

1. 内存管理：定期清理识别缓存，避免内存占用过高
2. 识别速度：调整OCR识别区域，减少不必要的图像处理
3. 稳定性：关闭不必要的后台程序，确保系统资源充足

📚 社区支持与资源获取

获取最新版本

项目已迁移至全新重构版本cocogoat-web，建议用户关注新版本发布。如需获取当前版本：

git clone https://gitcode.com/gh_mirrors/co/cocogoat-client cd cocogoat-client yarn install yarn electron:serve

问题反馈渠道

遇到技术问题时，建议按以下顺序排查：

1. 查看已知问题：阅读项目README中的常见问题解答
2. 检查配置文件：验证src/config.ts中的设置是否正确
3. 查看日志文件：程序运行日志位于数据目录的log文件夹中
4. 社区交流：加入开发者QQ群933468075获取实时支持

开发贡献指南

椰羊cocogoat采用模块化架构设计，主要功能模块分布：

🎯 下一步行动建议

新手用户

1. 下载最新版本程序，以管理员身份运行
2. 按照快速指南完成基础配置
3. 先试用圣遗物识别功能，熟悉操作流程
4. 逐步开启自动切换和地图悬浮窗功能

进阶用户

1. 探索src/plugins/中的扩展模块
2. 根据个人需求调整识别参数
3. 参与多语言翻译贡献
4. 关注新版本cocogoat-web的开发进展

开发者

1. 阅读src/typings/中的类型定义
2. 理解Electron + Vue.js的架构设计
3. 贡献代码前先运行yarn electron:serve测试
4. 遵循项目的MIT开源协议

椰羊cocogoat作为《原神》玩家的得力助手，通过智能化的圣遗物管理方案，让装备整理变得简单高效。无论是新手玩家还是资深开发者，都能在这个开源项目中找到适合自己的使用方式。

【免费下载链接】cocogoat-clientA toolbox for Genshin Impact to export artifacts automatically. 支持圣遗物全自动导出的原神工具箱，保证每一行代码都是熬夜加班打造。项目地址: https://gitcode.com/gh_mirrors/co/cocogoat-client