文档

从导入第一首歌开始,了解 OFPlayer 的所有功能和开发细节。

使用指南

快速上手、导入音乐、播放控制、库与播放列表、歌词、主题、快捷键。

开发文档

架构设计、组件参考、主题系统、二次开发指南。

页面说明

文档 是 OFPlayer 本地优先音乐工作流的一部分。这个页面会先说明功能边界、适用场景和下一步入口,再交给网页播放器或工具页面完成具体操作。

OFPlayer 面向有个人音乐收藏的用户,重点放在本地文件播放、WebDAV 与 Subsonic/Navidrome 音乐库连接、歌词和音频工具、隐私优先的数据处理,以及足够克制的桌面式界面。

如果你只是想试用,可以从网页版开始导入本地音频;如果已经有 NAS、服务器或远程曲库,可以继续阅读教程,把 OpenList、WebDAV 或 Navidrome 接到同一套播放体验里。

页面内容会尽量说明真实可用的能力,不把尚未完成的方向包装成已经上线的功能。遇到部署、连接或格式问题时,可以顺着相关文档和工具逐步检查,而不是在播放器里反复猜配置。

对于搜索、分享或禁用脚本的访问场景,这份静态内容也会保留核心信息:页面主题、产品边界、相关入口和下一步操作都能被直接读取,不依赖前端应用完成后才出现。

每个入口都会尽量连接到相邻的说明页,避免只留下单点页面,内容也会随着产品发布持续更新。

从这里可以继续访问 快速上手、导入音乐、库与播放列表、主题系统。这些内部入口覆盖产品介绍、教程、文档、下载和实际工具,方便从了解能力一路走到部署、整理曲库和开始播放。

OFPlayer Main 分支技术文档

本文档为 OFPlayer Web 版(main 分支)的完整技术参考文档,面向开发者和二次开发人员。

文档目录

文档 内容
项目概述 项目简介、技术栈、核心特性
架构设计 分层架构、数据流、模块职责
组件文档 Vue 组件详解、Props/Emit 接口
状态管理 Store 设计、响应式状态、数据同步
服务层 业务服务、数据访问层、外部集成
数据模型 实体定义、字段规范、工厂函数
工具函数 通用工具库、解析器、构建器
主题系统 主题架构、CSS 变量、扩展指南
二次开发指南 扩展建议、最佳实践、注意事项

快速导航

我想…

技术栈概览

层级 技术
框架 Vue 3 (Composition API)
构建 Vite 8
路由 Vue Router 4
图标 lucide-vue-next
元数据 music-metadata
播放 HTMLAudioElement
持久化 IndexedDB / localStorage
样式 CSS Custom Properties

项目定位

OFPlayer 是一个本地优先的网页音乐播放器,核心设计原则:

  1. 无账号系统 - 所有数据存储在用户设备
  2. 无云同步 - 完全离线可用
  3. 极简依赖 - 仅 Vue + Vite + 两个辅助库
  4. 桌面级体验 - 通过 Tauri 支持原生桌面应用