# bookworm.loongzero.com

**Repository Path**: shencanlong/bookworm.loongzero.com

## Basic Information

- **Project Name**: bookworm.loongzero.com
- **Description**: 书虫
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-31
- **Last Updated**: 2026-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 书虫

牛津书虫系列听读 App。uni-app x + Vue 3 + UnoCSS。用 **HBuilderX** 运行到浏览器（H5）。

## 如何运行

1. 用 **HBuilderX** 打开本项目根目录
2. 运行到浏览器（不要另开 CLI 抢 5173）

H5 白屏 / 挂载补丁见 `TECH_DESIGN.md` § H5 启动。

导入/更新一本书：

```powershell
node scripts/import-book.mjs --book {bookId} --src "源目录" --txt "整本txt"
$env:HF_ENDPOINT = "https://hf-mirror.com"
$env:HF_HUB_DISABLE_XET = "1"
python scripts/align-audio.py --book {bookId}
python scripts/validate_chapter.py --book {bookId}
python scripts/enrich-grammar-tree.py --book {bookId}
npm run upload-books -- --book {bookId}
```

加工目录：`content/books/`（gitignore）。细节见 `TECH_DESIGN.md` § 新书内容流水线。

## 目录摘要

| 路径 | 作用 |
|------|------|
| `pages/` | 书桌、我的、详情、阅读器 |
| `components/` | 立书搁板、句卡、播放条 |
| `composables/` | 音频、阅读进度 |
| `content/books/` | 临时加工（gitignore） |
| `scripts/data/catalog-seed.json` | 书目灌库种子 |
| `scripts/_archive/` | 一次性/已禁用脚本 |
| `DESIGN.md` | UI 规范 |
| `TODO.md` | 未完成进度 |
| `CHANGELOG.md` | 已完成流水 |

## 规范

详细规则见 `AGENTS.md`。实现 UI 前必须读 `DESIGN.md`。仓库精简见 `TECH_DESIGN.md` § BW-D-002。

## 文档索引

- `RESEARCH.md` / `PRD.md` / `TECH_DESIGN.md` / `DESIGN.md` / `TODO.md` / `CHANGELOG.md`