共享节奏，无缝畅玩

注意

该文档站正在积极建设中，部分内容可能尚未完成或存在错误。感谢您的理解与支持！

---

关键特性

Osynic 是一个功能强大的 osu! 谱面管理生态系统，为玩家和开发者提供无缝的体验。

✨ Osynic 核心功能

同步您的谱面

在多个设备之间智能同步您的 osu! 谱面库，无论您在哪里游玩，您的收藏始终保持最新。支持增量同步，超快速度。

管理谱面与合集

强大的谱面管理工具，帮助您组织、分类和维护您的谱面合集。完整的元数据支持，灵活的筛选和搜索。

分享您的合集

轻松将您精心制作的谱面合集分享给朋友。一键分享，朋友可直接导入，建立社区。

开源 MIT 许可

完全开源项目，采用 MIT 许可证，欢迎参与贡献和二次开发。透明的代码，信任的保证。

---

🏗️ 完整的技术生态系统

核心库

Osudb 📚 高性能的 osu! 数据库解析库，快速读取和处理 osu!.db 文件

Osuapi 🔌 osu! API v2 的高性能 Rust 实现，提供完整的 API 封装

Serializer ⚡ 高性能序列化库与 CLI 工具，用于 osu!.db 的读写操作

Downloader 📥 高性能谱面下载库与 CLI 工具，快速获取您需要的谱面

服务器

OauthServer 🔐 OAuth 认证服务器，安全处理 osu!api v2 OAuth 流程

CorsServer 🌐 CORS 代理服务器，无缝处理 osu!web 跨域请求

---

🎯 为什么选择 Osynic？

闪电般的性能

采用 Rust 和 Deno 等高性能技术栈，提供闪电般的速度和稳定性。毫秒级响应时间。

完全开源透明

完全开源的设计，您可以查看源代码、参与贡献、自由定制。社区驱动的开发模式。

跨平台支持

支持 Windows、macOS、Linux 等多个平台，轻松管理您的谱面，无缝切换。

生态系统完善

从核心库到服务器组件，Osynic 提供完整的生态系统，满足玩家和开发者的各种需求。

---

🚀 快速开始指南

1. 安装 Osynic 访问 入门指南 选择适合您的安装方式

2. 导入您的谱面 Osynic 会自动检测您的 osu! 安装目录并导入现有谱面

3. 创建您的合集 使用直观的界面组织和分类您的谱面

4. 开始同步 启用云同步，随时随地访问您的谱面

5. 分享给朋友 一键生成分享链接，让朋友也能体验

---

💻 开发者快速开始

Rust

// Beatmapset Get
use osynic_osuapi::error::Result;
use osynic_osuapi::v2::client::request::client::OsynicOsuApiV2Client;
use osynic_osuapi::v2::interface::beatmapsets::IBeatmapsets;
use osynic_osuapi::v2::model::oauth::structs::o_token::OToken;

#[tokio::main]
async fn main() -> Result<()> {
    dotenvy::dotenv().ok();
    let access_token = std::env::var("ACCESS_TOKEN").expect(
        "Please set the ACCESS_TOKEN environment variable to a valid osu! API v2 access token",
    );
    let client = OsynicOsuApiV2Client::new(OToken {
        access_token,
        refresh_token: None,
        expires_in: 86400,
        token_type: "Bearer".to_string(),
    });
    let beatmapset = client.beatmapsets.get_beatmapset(2105932).await?;
    println!("{:?}", beatmapset);

    Ok(())
}

CLI

cargo install osynic_downloader

# 原生模式（ID列表）
osynic-dl --beatmapsets json/sets.json -o ./osu_maps -c 8
# Osynic模式（歌曲元数据）
osynic-dl --osynic-songs json/songs.json --output ./music

Web

import { OsynicOsuApiV1GlooClient } from '@osynicite/osynic-osuapi';
import type { GetBeatmapsParams, BeatmapV1 } from '@osynicite/osynic-osuapi';

const client = new OsynicOsuApiV1GlooClient("YOUR_API_KEY_HERE");
client.setProxyUrl("http://localhost:8000/");

const result = await client.getBeatmaps(params);

---

📦 项目结构

• 文件夹osynic/

  • 文件夹osynic_osudb/ Rust

    • 数据库解析库
  • 文件夹osynic_osuapi/ Rust

    • API 实现
  • 文件夹osynic_serializer/ Rust

    • 序列化工具
  • 文件夹osynic_downloader/ Rust

    • 下载工具
  • 文件夹deno_osynic_oauth/ TypeScript

    • OAuth 服务器
  • 文件夹deno_osynic_cors/ TypeScript

    • CORS 代理

---

🎨 核心特性对比

特性	Osynic	其他工具
性能	⚡⚡⚡ 极速	⚡ 普通
开源	是	部分
跨平台	完全支持	有限
社区	活跃	中等
文档	完整	基础

---

💬 社区与支持

加入我们的社区

无论您是 osu! 玩家还是开发者，我们都欢迎您的加入！

完整文档

深入了解 Osynic 的每一个功能和特性

报告问题

在 GitHub Issues 中报告 Bug 或提出功能建议

分享想法

在 Discussions 中分享您的使用经验和创意

参与贡献

发送 Pull Request，成为 Osynic 的贡献者

---

准备好了吗？

选择适合您的方式开始使用 Osynic：

• 首次使用者 → 查看入门指南
• 开发者 → 阅读 API 文档
• 想要贡献 → 访问 GitHub 仓库
• 需要帮助 → 查看常见问题

---

Osynic — 让每一个 osu! 玩家都能优雅地管理和分享他们的谱面 🎮✨

Made with ❤️ by the Osynic Community