# MD阅读器

**Repository Path**: lxcsGit/md-reader

## Basic Information

- **Project Name**: MD阅读器
- **Description**: MD阅读，语音阅读器
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MD 阅读器

基于 Electron 的 Markdown 文档阅读器，支持 **CosyVoice2 离线高质量语音朗读**、情感音色、倍速播放、文字高亮同步，以及最近打开目录记录。

## 功能

- **目录树浏览** — 打开文件夹，左侧展示 Markdown 文件目录树
- **双击播放** — 双击 `.md` 文件即可打开并开始朗读
- **CosyVoice2 离线朗读** — 自然韵律、标点停顿、情感表达
- **多音色风格** — 自然 / 平静 / 讲故事 三种中文女声
- **倍速播放** — 0.5x ~ 3x，通过 instruct 控制语速
- **文字高亮** — 朗读时自动高亮当前句子
- **最近目录** — 记录最近打开的工作目录

## 快速开始

```bash
# 1. 安装 Node 依赖
npm install

# 2. 安装 CosyVoice2（约 2GB 模型 + PyTorch，首次需 15-30 分钟）
npm run setup:cosyvoice

# 3. 启动
npm run dev
```

## 系统要求

| 项目 | 要求 |
|------|------|
| Python | 3.10+（推荐 3.10） |
| 磁盘 | 约 5GB（模型 + 依赖） |
| 内存 | 建议 8GB+ |
| GPU | 可选，有 GPU 合成更快 |

> 首次启动应用后，CosyVoice2 模型加载需要 **1-3 分钟**，请耐心等待顶部状态提示变为「已就绪」。

## CosyVoice2 说明

安装脚本 `npm run setup:cosyvoice` 会自动：

1. 克隆 [FunAudioLLM/CosyVoice](https://github.com/FunAudioLLM/CosyVoice) 仓库
2. 创建 Python 虚拟环境并安装依赖
3. 下载 `CosyVoice2-0.5B` 模型（支持 hf-mirror 镜像）
4. 下载参考音频 `zero_shot_prompt.wav`

文件位于 `resources/cosyvoice/` 目录。

## 技术栈

- Electron 34 + React 18 + Vite 6
- marked（Markdown 渲染）
- CosyVoice2-0.5B（离线 TTS，instruct2 模式）

## 使用说明

1. 运行 `npm run setup:cosyvoice` 完成一次性安装
2. 运行 `npm run dev`，等待 CosyVoice2 模型加载完成
3. 打开 Markdown 目录，双击文件开始朗读
4. 底部播放器可切换音色风格、倍速