Private Sekai

项目简介

本项目用于模拟游戏 初音未来 -歌姬计划- （初音ミク -プロジェクト ディーヴァ-，Hatsune Miku: Project DIVA） 游戏测试服务端，供个人技术研究、协议分析、逆向学习等用途。所有功能仅限于本地测试，严禁用于任何形式的公开传播、开服或商业用途。

游戏介绍

​ 《初音未来 -歌姬计划-》系列（繁体中文：初音未来 -名伶计划-系列，日文：初音ミク -Project DIVA- シリーズ）是由SEGA主导开发的音乐节奏游戏系列。游戏初登场于PSP平台，后来在PSV、PS3、街机、PS4、Switch、PC等平台不断推出新作。系列后来扩展为SEGA feat. HATSUNE MIKU Project。

​ 此系列首款游戏《初音未来 -歌姬计划-》发布于2009年7月2日，由DINGO和SEGA共同开发，几年后DINGO破产，游戏变为由世嘉独立主导开发。

​ 游戏名称中“DIVA”是歌剧中的女主唱的意思，并且游戏以Crypton Future Media株式会社旗下的虚拟歌手初音未来命名。该游戏系列的绝大多数曲目均由VOCALOID虚拟歌手初音未来、镜音铃·连、巡音流歌、MEIKO和KAITO演唱。

——引自萌娘百科

使用协议与禁止条款

1. 禁止传播

   • 严禁在任何地区以任何公共或私有平台上传、分享或宣传本项目的源码、编译文件、部署教程、截图、演示视频等相关内容。
   • 若发现违规传播行为，作者有权采取封禁、公开拉黑等措施。

2. 禁止开服与部署测试

   • 严禁使用本项目进行任何形式的私服搭建，包括但不限于公网开服、内网搭建、测试服部署、局域网部署、云端部署、容器化部署、远程服务器部署等。
   • 严禁以任何目的、任何方式将本项目进行本地或远程部署测试。
   • 无论是否收费、是否开放给他人使用，均视为违反本协议。
   • 一经发现，作者将永久停止支持，并可能公开违规行为及其责任人信息。

3. 禁止商业用途

   • 本项目仅供学习用途**，严禁**用于任何商业活动，包括但不限于盈利、广告、推广、变现等。

4. 禁止二次分发

   • 严禁将本项目的全部或部分内容进行二次分发、转载、打包、出售或以其他方式传播。

5. 禁止逆向传播

   • 严禁以本项目为基础进行逆向传播、破解、绕过官方保护措施等行为。

6. 使用时限

   • 请于下载或获取本项目后24小时内删除所有相关文件。

7. 版权与敏感信息说明

   • 由于版权及安全原因，项目内不会包含任何官方密钥、token、加密材料或其他敏感信息。
   • 禁止任何形式的测试，严禁在任何场合传播任何敏感数据。

8. 其他说明

   • 作者保留随时修改、终止本项目及协议的权利。
   • 作者有权在任何时刻停止本项目的开源。
   • 作者有权公开违反本条例的用户信息。
   • 如有疑问请勿使用本项目。

9. 免责声明

   • 因违反上述协议造成的任何法律责任、经济损失、账号封禁等后果，均由使用者本人承担，项目作者不负任何责任。

已实现的功能和未实现但计划内的功能

更新：2026-10-09。✓ 已接入表中所述范围，△ 部分实现，— 待实现；✓ 不代表所有边界均已通过官方验证。Server 为服务端业务，Client 为协议调用及场景工具，不指游戏客户端。具体接口与证据见 API 审计记录。

本次同步至私人入房协议与玩家资料来源审计。最新进展如下：

进展	当前状态	下一步缺口
私人房间准备	Client 已官方实测：认证、UDP 连接、预留、分配房号、设置大厅、Suite 回读	实时入房、同步玩家、退出和多人演出；Server 实时服务尚未实现
私人创建与入房协议	已静态确认创建 3070、加入 3080 的独立分支、请求结构和玩家资料来源；尚未接入可执行流程	编队总力、称号及服装等资料的完整构造，创建／入房同步与退出状态处理
普通演出奖励	评分及曲目成就按 master 泛化；C 档经验专项对拍通过	B 档已确认漏发经验，A／S 档及随机掉落规则仍不完整
挑战演出	开局可用，阶段、经验、任务及部分活动奖励已有业务回放	完整 HTTP 结算入口、后续出勤、跨日及高档奖励

当前可用范围

• 基础账号与日常操作：已接入注册登录、引导、引继、编队、卡牌培养、商店、剧情、任务、好友及资料编辑；各功能的限制见下表。
• 普通单人演出：已有开局、结算、成绩保存、曲目成就及部分任务联动；奖励仍不完整，高分结算可能漏发经验或掉落。
• 挑战演出：已有首次解锁、单／双卡手动开局及多项结算业务组件；尚不能通过完整 HTTP 流程完成挑战结算。
• 实时通信与私人房间：协议客户端已连接官方 multi UDP，完成握手、clientKey 确认、加密 Ping、三次 Echo、普通规则私人空房间预留、分配房号及大厅设置；入房和多人演出尚未接入，服务端尚无对应实时服务。

功能明细

功能	Server	Client	备注
注册、登录	✓	✓
用户注销	✓	—
新手引导	✓	✓
引继设置与继承	✓	✓
suitemasterfile	✓	✓	服务端分包读取；Client 支持按认证返回的版本与分包路径下载
会话鉴权	△	✓	服务端待完善
普通编队保存与切换	✓	✓
卡牌练习、Master Lesson、卡面切换	✓	✓
技能升级、特训	△	✓	特训卡面与角色任务已对拍；材料、技能券升级均存在官方拒绝与本地成功的差异
材料兑换	△	✓	无刷新、无限量的材料换练习券已对拍；周期限量及其他奖励待补
活动兑换	△	✓	技能券、体力道具、无限金币与售罄状态已对拍；任务达成及其他奖励待补
Gacha、兑换	△	✓	基础抽取、卡牌发放和兑换已接入；额外奖励、特殊消耗及保底规则仍需审计
Presents 邮箱	△	✓	返回细节待完善
Solo Live	△	✓	开局、结算、成绩和部分任务联动已接入；经验、随机掉落及返回的每日剩余次数仍不完整
实时认证（Diarkis）	—	✓	multi 官方认证及随后 Suite 请求已成功；其他类型、有效期和错误行为待验证
实时 UDP 收发与分片	—	△	官方握手、clientKey 确认、加密 Ping 和三次 Echo 已成功；重传、分片和内附通知由本地检查验证；保活依赖调用方持续推进收发，迁移及自动重连未实现
私人房间预留	—	△	普通规则预留已获官方成功响应和 RoomID，前后 Suite 读取成功；TTL 从 clientConfigs 读取；自定义规则仅有编码与本地检查，房间到期行为未验证
私人房号与大厅设置	—	△	实时预留→POST分配房号→PATCH设置大厅→Suite回读已官方实测；只覆盖普通规则自由大厅，尚未入房
私人房间入房、同步与退出	—	—	已审计入房命令及玩家资料来源、退出发送链；资料计算、完整同步及退出回包仍待补齐，尚无可执行入口和官方实测
多人／Cheerful Live	—	△	已有通信及私人房间前置流程；实时入房、开局及结算尚未接入，Cheerful 完整流程未验证
每日 Live P 加成	△	—	已确认多人／Cheerful 通关触发；发放、扣次和跨日状态未实现，当前剩余次数误用体力消耗
评分与曲目成就奖励	✓	✓	按歌曲参考谱面查全档评分门槛；成就与奖励按 master 发放，覆盖跨档和重复领取；高档边界主要由本地检查验证
打歌经验、玩家升级、体力恢复	△	✓	普通演出仅部分 D／C 档经验，B／A／S 缺失；玩家跨级奖励与升级恢复已接入，自然恢复待补
每日挑战 Live 开局	△	✓	首次解锁、编队保存、手动单／双卡开局与重开已接入；更多槽位、Auto 和跨日待补
每日挑战 Live 结算	△	△	阶段、角色经验、高分奖励、首次出勤、D／C 经验及部分活动奖励已有业务回放；完整 HTTP 结算未接入
CD Shop	✓	✓
区域道具升级	△	✓	业务待完善
主线、卡牌与特殊剧情	△	✓	奖励及解锁联动待完善
剧情书签	✓	✓	增删改查与缩略图
剧情收藏	△	✓	槽位管理已实现
新手任务、Live 任务领奖	△	✓	多类进度、批量领奖和临时达成提示已接入；好友刷新计数、三槽称号已对拍；总任务按 master 实现，最终达成及领奖仍缺官方样本
荣誉任务、收集门槛	△	✓	部分演出任务与领奖已对拍；贴图、服装、Vocal 收集按 master 多门槛处理，收集门槛仍缺官方样本
角色任务领奖	△	✓	服装、档案语音、卡牌收集、卡牌前后篇、区域道具、Live 次数、休息室任务及合并领取已对拍；其他类型待补
登录奖励	△	✓	首次普通／新手／限时奖励入邮箱及重复刷新保护已对拍；后续日次、跨日和活动边界待补
主页、公告与已读记录	✓	✓
名片、个性名片	△	✓	基础编辑已实现
普通称号穿戴	△	✓	槽位保存、清空及三槽新手任务已对拍；羁绊称号、更高持有等级和其他类别待补
好友与在线状态	△	✓	申请、接受、删除及基础资料已接入；部分关系转换、数量上限和扩展资料仍有限制
歌曲列表、MV、服装与贴图	△	✓	列表保存／重置、MV 记录、服装制作／更换、贴图收藏及部分任务联动已接入；未覆盖全部关联规则

已按规则泛化的部分

• 评分与曲目成就：按歌曲参考谱面查询全部评分门槛，遍历 master 成就条件和奖励；支持一次跨多档与重复结算去重。
• 任务门槛：贴图、服装、Vocal 收集及新手总任务按 master 定义处理多个门槛；部分最终达成和领奖仍缺官方样本。
• 成长与固定奖励：玩家跨级奖励按跨过的 master 等级处理；挑战高分固定奖励按角色和分数查表。最高等级、部分解锁奖励与随机掉落不在此完成范围内。
• 房间预留配置：普通／自定义规则按对应 clientConfigs 读取 TTL，属性编码支持不同设置、总力上下限及难度数组；官方实测目前只覆盖普通规则默认预留。

规则明确时覆盖未抓包的输入；规则不明时保留缺口。尤其不能把固定奖励查表等同于随机掉落池已还原，也不能把新增一个评分常量视为全档奖励已实现。

当前主要缺口

• 普通演出奖励仍有样本硬编码：评分掉落只覆盖两个谱面等级／评分组合，其余返回空；随机资源池和权重尚未还原。B 档官方对拍已确认漏发经验，不能把当前结算视为完整实现。
• 每日奖励和多人流程未完成：每日加成由多人／Cheerful 通关触发，普通单人不触发；当前剩余次数误用体力消耗，不能改为固定次数。基础实时通信、私人预留、房号分配及大厅设置已实测。入房还需完整构造编队总力、卡牌、称号、服装等玩家资料，处理同步及退出；可靠 ACK 或入房命令成功响应均不足以证明已经入房。
• 挑战循环未完成：阶段、角色升级、固定高分奖励、首次出勤、D／C 经验、生日奖励及部分 marathon 活动奖励已有业务实现和专项回放，但完整 HTTP 结算尚未接入。后续出勤、跨日、EX、Auto、更多编队槽位、高档经验及随机掉落仍待补齐。
• 兑换、资源与任务覆盖有限：材料兑换的周期和限量、部分活动奖励资源、称号升级、角色满级／解锁奖励及部分角色任务合并领奖仍有限制。
• 抽卡及扩展资料待审计：抽卡特殊消耗、额外奖励和保底规则未完整确认；部分好友关系转换及扩展资料仍会拒绝处理，不能视为全部兼容。
• 泛化与官方验证分开记录：评分和成就已使用完整 master 门槛；收集任务及新手总任务也已支持多门槛，但部分高门槛只有本地测试和逆向依据，尚无官方实测。

当前正在核对私人入房所需的玩家资料和编队总力计算；完成资料构造、入房同步及退出处理后，再验证完整私人房间流程。普通演出经验与掉落规则、多人每日奖励及挑战完整结算继续保留为主要待办，再逐步扩展兑换、资源和任务边界。

验证范围

以下为各项最近结果，分别来自不同迭代，不代表所有检查在同一轮重新执行：

验证方式	已有结果	尚不能证明
本地业务检查	最近通过 800 项	全部官方输入、奖励池及边界均兼容
客户端与协议检查	房号流程迭代通过 559 项客户端检查、Server 构建及协议检查	完整房间流程或长期联网稳定；现有模板仍有未映射字段提示
官方专项对拍	三槽称号六份专项对拍无差异；普通演出 C 档经验通过	B 档经验尚有已确认的漏发，高档奖励未补齐
官方实时通信	认证、握手、加密 Ping、首次及后续两次 Echo 成功	官方丢包重传、分片、通知、长期保活及掉线恢复
官方私人房间前置流程	普通规则预留返回 RoomID，POST分配房号及PATCH设置大厅均200，最后Suite回读成功	实时入房、自定义规则、到期回收及多人演出成功；Suite 可读不代表账号状态完全不变

---

本项目仅供个人学习和技术交流，严禁用于任何非法或违规用途。请自觉遵守相关法律法规和本协议内容。

Debug API

API	作用
GET /metamiku/debug/getUserList	获取全部 user 列表
GET /metamiku/debug/getUserSuiteData/<int:user_id>	获取指定 user 的 suite 数据