当前版本 v1.3.5 · Apache-2.0 开源

探索视觉小说世界的
现代 Flutter 客户端

VNDB Client 是一款基于 Flutter 与 Material Design 3 构建的 VNDB(Visual Novel Database)非官方客户端,完整复刻网站功能,支持深色模式、多语言与个性化主题,让浏览视觉小说数据库变得优雅而高效。

12+
API 端点
20+
功能页面
3
支持语言
2
移动平台
M3
设计语言
项目概览

为视觉小说爱好者打造的一站式浏览体验

VNDB Client 基于 VNDB Kana API v2 构建,通过原生 Flutter 应用完整呈现视觉小说数据库的全部内容。从首页聚合视图到沉浸式详情页,每一个细节都经过精心设计。

应用在覆盖 API 全部能力的同时,通过内嵌 WebView 衔接论坛、数据库编辑、账号创建等 API 尚未支持的功能,做到能力不打折、体验更流畅。

采用 Material Design 3 设计语言,支持种子色调色板、深浅色主题、自定义壁纸与 NSFW 内容模糊,让每位用户都能打造属于自己的浏览界面。

核心功能

覆盖视觉小说数据库的方方面面

从数据浏览到收藏管理,从个性化主题到智能推荐,每一项功能都为提升浏览体验而生。

首页聚合视图

九宫格快捷菜单、数据库统计、最近变更、猜你喜欢、今日生日角色、即将发售与刚刚发售作品,一目了然。

统一搜索

支持 VN、角色、制作商、制作人员、发行版本、标签、特质 7 种目标切换,配合高级筛选面板精准定位。

沉浸式详情页

毛玻璃顶栏、4 个标签页(概况 / 角色 / 版本 / 人员)、贝叶斯排名、简介翻译、剧透控制与截图全屏浏览。

个人列表管理

加入列表、1-10 分投票评分、愿望单 / 已玩 / 已弃等标签管理,列表条目状态图标清晰直观。

关注制作商

关注喜欢的制作商,启动或刷新时后台检测新作品,消息中心红点提醒,不再错过任何新作。

浏览历史

自动记录浏览过的视觉小说,去重并保留最近 100 条,支持单条删除与一键清空。

随机 VN 抽取

独立配置页支持按语言、平台、标签、评分、年份、开发商、R18、免费、引擎多维筛选随机抽取作品。

个性化主题

12 种预设种子色 + 自定义调色、深 / 浅 / 跟随系统、内置星空壁纸 + 自定义相册图片、作品名罗马音 / 日文原名切换。

多语言本地化

简体中文、English、日本語三语完整支持,界面与内容无缝切换,简介支持英译中机器翻译。

技术栈

现代 Flutter 工程实践

采用业界主流且活跃维护的 Flutter 生态组件,保证应用的性能、可维护性与开发效率。

Flutter 3.x
跨平台 UI 框架
Riverpod 2
状态管理
Go Router
声明式路由
Dio
网络请求
Cached Network Image
图片缓存
Freezed
数据模型代码生成
JSON Serializable
JSON 序列化
Flutter Secure Storage
安全存储
InAppWebView
应用内浏览器
Flutter SVG
矢量图形渲染
Infinite Scroll
分页滚动加载
Material 3
设计系统
API 接口

完整覆盖 VNDB Kana API v2

应用基于官方 Kana API 构建并扩展,涵盖视觉小说数据库的全部公开数据接口,并实现 searchrank 安全校验与多级嵌套过滤。

端点 方法 说明
/vnPOST视觉小说查询:按 ID、搜索、随机、按标签、按制作人员、最近入库
/characterPOST角色:按 ID / VN / 特质 / 生日查询与列表
/releasePOST发行版本:按 ID / VN 查询、即将发售、刚刚发售
/producerPOST制作商:按 ID、搜索、列表
/staffPOST制作人员:按 ID、搜索、列表(强制 ismain)
/tagPOST标签:按 ID、搜索、分类筛选列表
/traitPOST特质:按 ID、搜索、列表
/quotePOST语录:随机语录、按 VN 查询
/userGET用户查找(批量 / 单个,按 ID 或用户名)
/ulistPOST用户 VN 列表查询(按标签 / 用户)
/ulist/<id>PATCH创建 / 更新列表条目(评分 / 备注 / 标签)
/ulist/<id>DELETE删除列表条目
/ulist_labelsGET用户列表标签定义
/rlist/<id>PATCH发行版本列表状态更新
/statsGET数据库统计(VN / 角色 / 制作商等数量)
/authinfoGET校验 API Token 并返回用户信息

速率限制:200 次请求 / 5 分钟,单请求最长 3 秒。认证方式:Authorization: Token <your-token>

获取应用

立即开始你的视觉小说之旅

支持 Android 与 iOS 双平台。Android 通过 GitHub Releases 获取 APK,iOS 通过 Actions 构建未签名 IPA 侧载安装。

下载 VNDB Client v1.3.5

免费、开源、无广告。选择与你的设备匹配的平台与架构。

前往 GitHub Releases

Android APK · 三架构分发

arm64-v8a
主流现代 64 位 ARM 设备(推荐)
armeabi-v7a
32 位 ARM 老旧设备
x86-64
模拟器 / Chromebook / Intel 平板

iOS 未签名 IPA · 需侧载

iOS 13.0+
最低系统版本要求
未签名 IPA
通过 GitHub Actions 手动触发构建
侧载安装
需使用 AltStore / Sideloadly 等工具自签名

iOS 版本通过 build-ios.yml 工作流手动触发构建,产物为未签名 IPA,下载后需自行侧载签名安装。