Applesaber的小站

国服中二节奏成绩导入MuNET

Sat, 21 Mar 2026 16:00:00 GMT

::github{repo="MuNET-OSS/chunithm-data-converter"}

:::important 该转换器功能现已原生集成至 MuNET 中！可以在MuNET的中二节奏数据导出/导入页面中使用 :::

将落雪查分器 (Lxns) 或水鱼查分器 (Diving-Fish) 的 Chunithm (中二节奏) 成绩数据，转换为 MuNET 兼容的 JSON 导入格式。

目前该工具已经支持三种使用方式：基于 Vue 的纯前端网页、基于 Flask 的纯净本地 Web 接口，以及Python 命令行 CLI。

快速体验：https://www.applesaber.site/chunithm-data-converter/

特点

部署方式多：提供 Python Web 端、Python 命令行端以及 workflow 部署版
模式多：深度适配落雪查分器个人/开发者模式，水鱼查分器个人/开发者模式，同时支持从 CSV 离线导入
更好看的UI：前端风格为 "简约现代亚克力" 风格，配合 Naive UI 组件库（使用Gemini 3.1 Pro 润化）
解决跨域问题：针对水鱼 API 严格的 CORS 安全策略，workflow 内置了 Cloudflare Worker 代理节点；本地部署版则通过 Python 直接向 API 发起请求

使用指南与数据源支持

:::note 工具不会保存、上传你的任何成绩与凭证信息。所有的解析和请求都是纯本地或受信任的环境中完成的，尽可放心使用。 :::

模式	适用场景	认证凭证
落雪个人	获取自己的成绩	个人访问 Token
落雪开发者	获取任意好友成绩	开发者 Token + 对方的好友码
水鱼个人	获取自己的成绩	水鱼 Import-Token
水鱼开发者	获取特定玩家成绩	Developer-Token + 对方用户名
CSV 上传	API 死了或只想离线转换	落雪/水鱼导出的 CSV 文件

GH-Pages 部署版

最简单的方式，直接打开网站，无需环境配置。页面由 Vue 3 + TypeScript + Vite 构建。

进入网页，选择你拥有的数据源
填入对应的 Token（开发者令牌已在系统后台静默配置，无需用户填写）
点击“开始转换”，随后下载 JSON 文件。
将文件导入至 MuNET。

:::tip 前端编译说明（开发者）

推荐使用 npx 运行 vite 编译指令：

cd web
npm install
npx vite build

:::

Python 命令行版

# 安装依赖
pip install -r requirements.txt

# 1. API 模式 - 水鱼个人查分
python main.py api --mode shuiyu --shuiyu-import-token 你的Token -o my_data.json

# 2. CSV 本地文件模式
python main.py csv --input scores.csv --username 玩家名

本地 Web 接口 (web.py)

web.py 和 workflow版有什么区别

该方案将 chunithm_api_converter 与 convert_chunithm_scores 这两个核心 Python 模块直接导入

没有 CORS 影响：Python 后端作为独立服务去请求第三方 API，根本不受浏览器跨域安全策略影响

部署方法

# 1. 编译前端界面 (Web 目录下的静态资源)
cd web
npm install
npx vite build
cd ..

# 2. 安装 Python 核心及 Web 依赖
pip install -r requirements.txt

# 3. 设定您的环境私钥 （非必须项）
export LXNS_DEVELOPER_TOKEN="你的开发者落雪Token"
export SHUIYU_DEVELOPER_TOKEN="你的开发者水鱼Token"
export PORT="5000"

# 4. 启动！
python web.py

:::important 关于环境变量与安全

LXNS_DEVELOPER_TOKEN 和 SHUIYU_DEVELOPER_TOKEN：千万不要将这些开发者 Token 暴露给用户或者写死在公开代码里。正确做法是在启动 web.py 前通过终端的 export 或根目录配置 .env 文件来静默注入，后端在处理请求时会自动从服务器环境中读取这些凭证，以此保障你的开发者安全。
对于本文提到的 GH-Pages 部署版，此机制则是通过 GitHub Actions 的 Repository Secrets 功能实现的，部署流水线会在编译时将这些 Token 隐藏起来。 :::

现在访问 http://localhost:5000 ，你就能看到页面了同时它还提供了对外的 POST API：

POST /api/convert
POST /api/convert/csv

如果觉得帮助到你记得给我项目点个 star⭐ 谢谢喵

如何建立Sega游戏服务器

Sat, 23 Aug 2025 00:00:00 GMT

前言

很多地方都没有这个搭建教程，搭建服务器要有一定的技术

目前开源的服务器有 ARTEMIS 和 AquaDX

在这里我分享的文件均不能外传！

在使用请遵循每个服务器的开源协议

准备环境

ARTEMiS 服务端支持比较老的游戏版本，AquaDX支持比较新的游戏版本

具体支持版本请看每个仓库的自述文件 ARTEMIS AquaDX

然后来准备环境

	AquaDX	ARTEMIS
编译环境	Java	Python
其他环境	Docker	Docker

自行准备环境

选择好服务端后开始准备文件

AquaDX 配置和部署

部署的方式有两种

Docker 直接部署
编译成 Jar 后部署使用Docker更快更自动化，并且更好管理，这里我以Docker作为演示

主要是Java编译麻烦还容易出问题(x

Docker官方镜像

不过官方镜像默认是反代aquadx.net，建议用这个镜像，提取码为 aqua，解压密码为 AquaDX

这是我的一位朋友的镜像，他在我第一次部署服务器时给予了我很多帮助，在这里我感谢他

下载解压好镜像后就配置一下服务器

首先编辑 compose.yml 文件

找到

services:
  http:
    image: caddy
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile:ro
    ports:
      - 8080:8080

修改ports为自己的端口，避免 8080 这个端口冲突

然后打开 application.properties 文件

找到并修改 allnet.server.host allnet.server.redirect 和 aqua-net.email.webHost 项为自己的局域网IP

# IP统一不能为127.0.0.1
allnet.server.host=192.168.0.102
allnet.server.port=80      # 这里是ALL.NET服务器端口
...

allnet.server.redirect=http://192.168.0.102:8080    # 这里是真实的服务器IP,建议修改为compose.yml设置的端口

...

server.port=80 #这里是web端口

...

aqua-net.email.webHost=192.168.0.102

aqua-net.email.webHost 是email服务器地址，不过我们一般不用这个服务，你可以把里面的ip删掉留空

如果不配置文件出错或者不生效可以去 /AquaDX/config/application.properties 按照上面的方法继续设置

接着在服务器根目录打开终端输入

docker compose up

然后可以喝杯咖啡☕等待部署完毕

看到出现了 ⭐️ ALL PERFECT ⭐️ 表示你的服务器成功正常运行了

然后在浏览器打开你的局域网IP:ALL.NET端口

例如：

我显示的是 ALL.Net : Port 80 web的地址就为 192.168.0.102:80

或者输入 allnet.server.redirect 打开 192.168.0.102.8080

80这个端口是Http端口，可以直接输入ip不带端口进入web

最后进入web注册帐号，随便输入一个邮箱和用户名，点击注册

然后登录你刚刚输入的邮箱和密码即可进入web

注意：你不用去验证邮箱，可以直接登录，除非你开启了email验证，配置文件默认是关闭的

和你获取dns和狗号的操作去配置segatools.ini

享受你的本地服！

ARTEMIS 配置和部署

ARTEMIS 对于较老的游戏版本来说很友好

编译环境

首先请准备好Python环境，官方的建议Python版本至少为3.7，但是我建议用使用Python3.10，因为它更加稳定

请自行去下载 Python

当你配置好 Python 环境后，接下来要继续准备 MariaDB数据库

网络上有一堆教程，可以自己搜索配置

MySQL真的太烂了

接下来下载或者克隆仓库获取 ARTEMIS 源代码

可以通过git来获取

git clone https://gitea.tendokyu.moe/Hay1tsme/artemis.git

你也可以去存储库里下载源代码

然后进入 ARTEMIS 根目录

配置环境

打开终端，进入 MariaDB 命令行

新建一个 MariaDB 账户，username是你的账户，并将 <password> 换成这个账户的密码

CREATE USER 'username'@'localhost' IDENTIFIED BY '<password>';
CREATE DATABASE username;
GRANT Alter,Create,Delete,Drop,Index,Insert,References,Select,Update ON username.* TO 'username'@'localhost';

创建一个venv虚拟环境使Python更好管理和处理模块

python -m pip venv venv
# 或
pip venv venv

当您需要与 ARTEMiS 交互时，激活 venv 运行 venv\Scripts\activate.bat

安装 pip 模块

pip install -r requirements.txt

配置服务器

创建一个 config 文件夹并将 example_config 复制其中
编辑 core.yaml
- 将您刚刚创建的 MariaDB 账户和密码填入 database 部分
- 将您的 hostname 设置为游戏可以访问您的服务器的任何主机名或 IP 地址（不要输入127.0.0.1）
编辑其他游戏配置文件
- 添加keys、设置主机名、端口等。具体设置取决于游戏

更详细的可以看 Windows部署官方文档或者 Linux部署官方文档

创建一下数据库表格

python dbutils.py create

启动 ARTEMIS 服务端

python index.py

Docker环境

根据上面来设置，设置完成后在根目录打开终端

docker compose up -d

结尾

部署本地副总体来说比较简单，想要关闭服务器在终端输入

docker compose down

ARTEMIS的官方教程更全面，不过玩Perfotmai三音游直接这样像我这样配置就行了

之后有服务器开源我都会出教程的

但是请你不要拿着本地服去逃避在线服的封号，没有意义

也不要想着做这个收费技术支持，没什么技术含量的东西出去卖不嫌丢人

使用Github Action

Thu, 14 Aug 2025 19:00:00 GMT

什么是Github Action

GitHub Actions 是 GitHub 提供的持续集成和持续（CI/CD）交付平台

可以自动化构建、测试和部署流程，为编译测试提供了一些方便（比如又大又慢的臭Java）

其中术语了解一下：

Workflow (工作流): 一个可配置的自动化流程，由 YAML 文件定义
Job (作业): 工作流中的一组步骤，在同一个运行器上执行
Step (步骤): 可以运行命令或执行动作的任务单元，这步骤可以是
- Shell 命令（RUN）
- 调用预定义动作（USES）
- 自定义脚本
Action: 可重复使用的代码单元，可通过 GitHub Marketplace 获取现成动作
Runner (运行器): 执行工作流的服务器，可以是 GitHub 托管的或自托管的

Workflow文件存在仓库的 .github/workflows/ 路径下，文件后缀一般为 .yaml 或 .yml

文件结构示意

Project/
├── .github/
│   └── workflows/
│       ├── ci.yml      # 持续集成工作流
│       └── deploy.yml  # 部署工作流
└── src/

创建第一个工作流

我以一份 .NET C#的项目来演示

在仓库中创建 .github/workflows 目录
在该目录下创建 dotnet-desktop.yaml 文件（文件名随意，后缀必须为 yml 或者 yaml）

添加内容：

添加基本信息

name: .NET Core Desktop
on:
push:
    branches: [ "master" ]
pull_request:
    branches: [ "master" ]

解析：

1.工作流名称：".NET Core Desktop"

2.触发条件：推送到 master 分支或创建针对 master 分支的 PR 时触发

作业配置

jobs:
  build:
    strategy:
      matrix:
        configuration: [Debug, Release]
    runs-on: windows-latest
    env:
      Solution_Name: your-solution-name #  解决方案名称(.sln)
      Test_Project_Path: your-test-project-path #  指定测试项目的路径
      Wap_Project_Directory: your-wap-project-directory-name #  指定Windows应用程序打包项目(WAP)的目录
      Wap_Project_Path: your-wap-project-path #  指定.wapproj文件的完整路径

解析

1.使用矩阵策略构建 Debug 和 Release 配置
2.运行环境：Windows 最新版
3.环境变量定义了解方案和项目路径

设置任务单元

基础设置

steps:
- name: Checkout
  uses: actions/checkout@v4
  with:
    fetch-depth: 0  # 获取完整历史记录，对某些版本工具可能需要

- name: Install .NET Core
  uses: actions/setup-dotnet@v4
  with:
    dotnet-version: |
      8.0.x
      7.0.x  # 可添加多个.NET版本支持

构建和测试

- name: Setup MSBuild.exe
  uses: microsoft/setup-msbuild@v2

- name: Restore NuGet packages
  run: dotnet restore $env:Solution_Name

- name: Build solution
  run: dotnet build $env:Solution_Name --configuration ${{ matrix.configuration }} --no-restore

- name: Run unit tests
  run: dotnet test $env:Test_Project_Path --configuration ${{ matrix.configuration }} --no-build --verbosity normal

上传Release

- name: Upload MSIX package
  uses: actions/upload-artifact@v4
  with:
    name: MSIX-Package-${{ matrix.configuration }}
    path: ${{ env.Wap_Project_Directory }}\AppPackages
    retention-days: 7  # 设置Release保留天数

- name: Upload symbols
  if: matrix.configuration == 'Release'
  uses: actions/upload-artifact@v4
  with:
    name: Symbols-${{ matrix.configuration }}
    path: ${{ env.Wap_Project_Directory }}\**\*.pdb

完整工作流

name: .NET Core Desktop CI/CD

on:
  push:
    branches: [ "master" ]
  pull_request:
    branches: [ "master" ]

env:
  DOTNET_VERSION: '8.0.x'
  Solution_Name: YourSolution.sln
  Test_Project_Path: tests\YourTests.csproj
  Wap_Project_Directory: src\YourApp.Package
  Wap_Project_Path: src\YourApp.Package\YourApp.Package.wapproj

jobs:
  build:
    strategy:
      matrix:
        configuration: [Debug, Release]
    runs-on: windows-latest

    steps:
    - name: Checkout code
      uses: actions/checkout@v4
      with:
        fetch-depth: 0

    - name: Setup .NET
      uses: actions/setup-dotnet@v4
      with:
        dotnet-version: ${{ env.DOTNET_VERSION }}

    - name: Setup MSBuild
      uses: microsoft/setup-msbuild@v2

    - name: Restore dependencies
      run: dotnet restore ${{ env.Solution_Name }}

    - name: Build solution
      run: dotnet build ${{ env.Solution_Name }} --configuration ${{ matrix.configuration }} --no-restore

    - name: Run tests
      run: dotnet test ${{ env.Test_Project_Path }} --configuration ${{ matrix.configuration }} --no-build --verbosity normal

    - name: Decode signing certificate
      if: matrix.configuration == 'Release'
      run: |
        $pfx_cert_byte = [System.Convert]::FromBase64String("${{ secrets.Base64_Encoded_Pfx }}")
        $certificatePath = Join-Path -Path ${{ env.Wap_Project_Directory }} -ChildPath GitHubActionsWorkflow.pfx
        [IO.File]::WriteAllBytes("$certificatePath", $pfx_cert_byte)

    - name: Create app package
      run: |
        msbuild ${{ env.Wap_Project_Path }} `
          /p:Configuration=${{ matrix.configuration }} `
          /p:UapAppxPackageBuildMode=StoreUpload `
          /p:AppxBundle=Always `
          /p:AppxBundlePlatforms="x86|x64" `
          /p:PackageCertificateKeyFile=GitHubActionsWorkflow.pfx `
          /p:PackageCertificatePassword="${{ secrets.Pfx_Key }}"

    - name: Cleanup certificate
      if: matrix.configuration == 'Release'
      run: Remove-Item -path ${{ env.Wap_Project_Directory }}\GitHubActionsWorkflow.pfx -Force

    - name: Upload artifacts
      uses: actions/upload-artifact@v4
      with:
        name: AppPackage-${{ matrix.configuration }}
        path: ${{ env.Wap_Project_Directory }}\AppPackages
        retention-days: 7

注：工作流也可以在Github Action 创建编辑

进阶

密钥管理

- name: 安全部署应用
  env:
    API_TOKEN: ${{ secrets.API_KEY }}  # 使用仓库存储的机密凭证
  run: |
    curl -H "Authorization: Bearer $API_TOKEN" ...

使用 act 本地测试: 安装 act 在本地运行工作流

Applesaber的小站

国服中二节奏成绩导入MuNET

特点

使用指南与数据源支持

GH-Pages 部署版

Python 命令行版

本地 Web 接口 (web.py)

web.py 和 workflow版有什么区别

部署方法

如何建立Sega游戏服务器

前言

准备环境

AquaDX 配置和部署

ARTEMIS 配置和部署

编译环境

配置环境

配置服务器

Docker环境

结尾

相关文档

使用Github Action

什么是Github Action

创建第一个工作流

进阶

相关文档

Applesaber的小站

国服中二节奏成绩导入MuNET

特点

使用指南与数据源支持

GH-Pages 部署版

Python 命令行版

本地 Web 接口 (web.py)

web.py 和 workflow版 有什么区别

部署方法

如何建立Sega游戏服务器

前言

准备环境

AquaDX 配置和部署

ARTEMIS 配置和部署

编译环境

配置环境

配置服务器

Docker环境

结尾

相关文档

使用Github Action

什么是Github Action

创建第一个工作流

进阶

相关文档

web.py 和 workflow版有什么区别