Skip to content

djkcyl/arkstage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

84 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

方舟剧场(Arkstage)

方舟剧场是一个明日方舟(Arknights)剧情的离线演出回放器。它把 PRTS Wiki 的原版演出引擎(ScenarioSimulator)搬进一个跨平台应用里运行,呈现与游戏内一致的立绘、背景、配音与对话动画,并支持预下载后在无网或计费网络环境下完全离线播放。支持 Android 与桌面(Windows / macOS / Linux)。


⚠️ 免责声明

  • 本项目是非官方的同人 / 学习性质作品,与上海鹰角网络(Hypergryph)及 PRTS Wiki 没有任何隶属或合作关系。
  • 剧情文本、立绘、音频、背景等素材均来自 PRTS Wiki,版权归《明日方舟》/ 鹰角网络所有。本应用自身不存储或分发这些素材,只在运行时从 PRTS 获取并缓存到本地,供个人离线查阅。
  • 请合理使用,控制下载频率以免对 PRTS 源站造成压力,勿用于任何商业用途。
  • 剧情内容的准确性、立绘是否缺失等取决于上游 PRTS Wiki,本应用对此不作担保。

✨ 功能特性

  • 原版演出还原:直接运行 PRTS Wiki 的 ScenarioSimulator 引擎,呈现与网页端一致的背景、立绘、对话与配音。引擎代码与字体已内置在安装包内,无需联网预缓存。
  • 电子书式书架:以游戏内 StoryLine「曲谱 / 乐章」原图作封面,按 主线 / 支线 / 活动 / 联动 / 集成战略 / 生息演算 / 特殊 等分类陈列。长按卡片可进入多选批量下载,缓存与已读状态用圆点标识。
  • 真离线播放:预下载后断网也能完整播放,运行时资源一律走本地。在线浏览时缺失的资源会自动拉取并缓存。
  • 按范围预下载:可按单个剧情 / 章节 / 分类批量下载,通过引擎自身的资源清单精确获取所需文件。
  • 内容寻址去重:跨章节复用的立绘、音乐等相同资源只下载与存储一份,节省空间。
  • 更新检测:首页显示当前版本号,检测到新版本时高亮闪烁「检测到更新」,点击直接跳转到发布页下载。
  • 博士昵称:替换剧情文本中的 {@nickname} 占位符为自定义昵称。

📦 下载与安装

前往 Releases 下载对应平台的安装包:

平台 文件 说明
Android *-android-arm64-v8a.apk 64 位机型,侧载安装(需在系统里允许安装未知来源应用)
Windows *-setup.exe 中文安装向导
macOS .dmg 区分 Apple Silicon 与 Intel
Linux .deb / .rpm 按发行版选择

🚀 使用说明

首次启动需要联网一次,从 PRTS 拉取剧情目录(之后以缓存优先、后台静默刷新)。播放引擎与字体已内置在安装包内,打开即用,无需任何预缓存步骤。

在线观看

  1. 首页点 「浏览剧情」 进入书架。
  2. 选择分类与章节,点开任意剧情即可在线播放。播放过程中用到的资源会自动缓存,供之后离线复看。

离线下载

想在断网或计费网络下观看,先在不限量网络下预下载资源:

  • 在播放器内点 「预下载本剧情资源」 下载当前这部;
  • 或在书架里 长按 封面卡片 / 章节进入多选,勾选后用底栏的 「⬇ 下载」 批量获取。

下载完成后即可断网流畅播放已缓存的剧情。

下载机制说明

应用通过引擎自身的资源清单精确知道每部剧情需要哪些文件,按内容寻址存放到本地;跨剧情复用的素材只存一份。下载受设置里的全局并发数与限速约束,可后台进行、断点续传。


⚙️ 设置详解

  • 博士昵称:填入后会替换剧情文本中的 {@nickname} 占位符。
  • 下载设置(并发与限速)
    • 并发数:同时下载的文件数,数值越大越快、对源站压力越大,默认 4。
    • 限速(KB/s):全局下载速度上限,填 0 表示不限速。
  • 播放器返回按钮:控制播放器左上角是否显示返回按钮。隐藏后仍可用系统返回手势 / 按键退出播放器。
  • 调试控制台:开启后在应用内显示一个日志控制台,用于排查问题,一般用户保持关闭即可。
  • 资源目录(桌面端):剧情图片 / 音频、引擎文件与缓存的存放位置,可改到容量更大的磁盘。Android 端固定在应用私有外部目录,不显示此项。
  • 缓存管理
    • 显示已缓存剧情数量与占用总大小;
    • 缓存全部剧情:一次性下载所有剧情资源(占用较大,慎用);
    • 清除所有缓存:删除已下载的剧情媒体与剧情索引。内置的引擎与字体不受影响,也不会被清除。
  • 关于:查看版本号、免责声明、开源许可、上游软件声明,以及项目主页与 PRTS Wiki 链接。
  • 环境信息:汇总运行环境(系统、WebView 版本等),反馈问题时一并提供有助于定位。

❓ 常见问题

首次打开必须联网吗? 需要联网一次以获取剧情目录。之后目录会被缓存,断网也能浏览;只有观看未下载过的剧情才需要再次联网。

安装包为什么有十几 MB? 播放引擎(jQuery / PreloadJS 等)与中文字体都内置在安装包内,这样下载剧情后无需任何额外联网即可离线播放。

某部剧情的立绘 / 图片缺失或显示异常? 演出资源来自上游 PRTS Wiki,个别素材的缺失或错位通常是上游数据的问题,应用本身只是如实呈现。

怎么更新到新版本? 首页底部显示当前版本号。检测到新版本时版本号会变红并闪烁「检测到更新」,点击即跳转到 GitHub 发布页,下载对应平台安装包覆盖安装即可。

Android 上为什么是横屏 / 侧滑返回? 仅播放器锁定横屏并隐藏系统栏以获得沉浸式演出体验,其余页面保持竖屏并显示系统栏。各级页面逐级返回,根页面再返回才退出应用。

清除缓存会把引擎也删掉吗? 不会。「清除所有缓存」只删除剧情媒体与剧情索引,内置的引擎与字体始终保留。


💬 反馈与建议

遇到问题或有功能建议,欢迎在 GitHub 提交 Issue:

https://github.com/djkcyl/arkstage/issues

提交时附上 设置 → 环境信息 里的内容、复现步骤与截图,能帮助更快定位问题。


📜 开源与许可

本应用使用并致谢以下上游:ScenarioSimulator 演出引擎(PRTS Wiki)、jQuery、PreloadJS / CreateJS、Tauri、React、React Router、Noto Sans CJK 字体。各组件许可证全文见应用内 设置 → 关于 → 开源许可

项目源码托管于 GitHub:https://github.com/djkcyl/arkstage 。仓库当前尚未指定开源许可证,在补充 LICENSE 之前默认保留所有权利。


🛠 参与开发

构建、调试、项目结构、CI / 发版等开发者文档见 docs/DEVELOPMENT.md

About

PRTS 剧情阅读器 - 明日方舟剧情离线阅读器 (Tauri v2)

Resources

Stars

6 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors