# auto-paper-digest
**Repository Path**: feng20068/auto-paper-digest
## Basic Information
- **Project Name**: auto-paper-digest
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-20
- **Last Updated**: 2026-01-20
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# ๐ Auto Paper Digest (APD)
่ชๅจ่ทๅ AI ๅๆฒฟ่ฎบๆ โ ไธ่ฝฝ PDF โ ็ๆ่ง้ข่ฎฒ่งฃ โ ๅๅธๅฐ HuggingFace/ๆ้ณ โ ้จๆท็ฝ็ซๅฑ็คบ
๐ฅ ๅจ็บฟไฝ้ช๏ผ https://huggingface.co/spaces/brianxiadong0627/paper-digest
๐ฑ ๅ
ณๆณจๆ้ณ๏ผ่ทๅๆๆฐ AI ่ฎบๆ่งฃ่ฏป่ง้ข๏ผ
๐ฅ ๆๆฐAI่ฎบๆ๏ผๆฏๅจๆดๆฐ
ๆซ็ ๅ
ณๆณจ๏ผ็ฌฌไธๆถ้ด่ทๅ็ฒพๅฝฉๅ
ๅฎน
|
---
## โจ ๅ่ฝไบฎ็น
| ๅ่ฝ | ่ฏดๆ |
|------|------|
| ๐ **่ฎบๆ่ทๅ** | ่ชๅจๆๅ Hugging Face ๆฏๅจ็ญ้จ AI ่ฎบๆ๏ผๆฏๆๅจ URL๏ผ |
| ๐ **PDF ไธ่ฝฝ** | ไป arXiv ไธ่ฝฝ่ฎบๆ PDF๏ผๅน็ญๆไฝ๏ผSHA256 ๆ ก้ช๏ผ |
| ๐ฌ **่ง้ข็ๆ** | ้่ฟ NotebookLM ่ชๅจ็ๆ่ฎบๆ่ง้ข่ฎฒ่งฃ |
| ๐ค **่ชๅจๅๅธ** | ไธไผ ่ง้ขๅฐ HuggingFace Dataset |
| ๐ฑ **ๆ้ณๅๅธ** | ่ชๅจๅๅธ่ง้ขๅฐๆ้ณๅไฝ่
ๅนณๅฐ |
| ๐ **้จๆท็ฝ็ซ** | Gradio ้จๆท็ฝ็ซ๏ผๅจ็บฟๆญๆพ่ง้ข |
| ๐พ **ๆญ็น็ปญไผ ** | SQLite ็ถๆ่ฟฝ่ธช๏ผๆฏๆไธญๆญๅ็ปง็ปญ |
| ๐ **็ปๅฝๅค็จ** | Google/ๆ้ณ็ปๅฝ็ถๆๆไน
ๅ๏ผไธๆฌก็ปๅฝ้ฟๆไฝฟ็จ |
---
## ๐ ๆถๆ่ฎพ่ฎก
```
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Auto Paper Digest โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โ
โ Phase 1: Upload Phase 2: Download Phase 3: Publish โ
โ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โ
โ โ HF โโโโโถโ arXiv โโโโโถโ NotebookLM โโโโโถโ HuggingFace โ โ
โ โ Papers โ โ PDFs โ โ Videos โ โ Dataset โ โ
โ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โ
โ โ โ โ โ โ
โ โผ โผ โผ โผ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ SQLite Database โ โ
โ โ (status: NEW โ PDF_OK โ NBLM_OK โ VIDEO_OK) โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ โโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโ โ
โ โผ โผ โผ โ
โ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โ
โ โ Portal Website โ โ Douyin โ โ Other โ โ
โ โ (HF Spaces) โ โ Creator โ โ Platforms โ โ
โ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
```
---
## ๐ ๅฟซ้ๅผๅง
### 1. ๅฎ่ฃ
```bash
# ๅ
้ไปๅบ
git clone https://github.com/brianxiadong/auto-paper-digest.git
cd auto-paper-digest
# ๅฎ่ฃ
ไพ่ต
pip install -e .
# ๅฎ่ฃ
ๆต่งๅจ
playwright install chromium
```
### 2. ้
็ฝฎ็ฏๅขๅ้
```bash
# ๅคๅถ้
็ฝฎๆจกๆฟ
cp .env.example .env
# ็ผ่พ .env ๅกซๅ
ฅ HuggingFace ้
็ฝฎ
# HF_TOKEN=hf_xxx
# HF_USERNAME=your-username
# HF_DATASET_NAME=paper-digest-videos
```
### 3. ้ฆๆฌก็ปๅฝ Google
```bash
apd login
```
> ๆต่งๅจไผๆๅผ NotebookLM ็ปๅฝ้กต้ข๏ผๅฎๆ Google ็ปๅฝๅ๏ผไผ่ฏๅฐ่ขซไฟๅญใ
---
## ๐ ไธ้ถๆฎตๅทฅไฝๆต
### Phase 1: ไธไผ ๅนถ่งฆๅ่ง้ข็ๆ
```bash
apd upload --week 2026-01 --headful --max 10
```
่ฏฅๅฝไปคไผ๏ผ
- โ
่ทๅ HuggingFace ๆฌๅจ่ฎบๆ๏ผไฝฟ็จ `/week/YYYY-WXX` URL๏ผ
- โ
ไธ่ฝฝ arXiv PDF๏ผๆฏๆ็ผๅญ๏ผๅทฒไธ่ฝฝ็่ทณ่ฟ๏ผ
- โ
ไธไผ ๅฐ NotebookLM
- โ
่งฆๅ่ง้ข็ๆ๏ผไธ็ญๅพ
ๅฎๆ๏ผ
### Phase 2: ไธ่ฝฝ็ๆ็่ง้ข
็ญๅพ
ๅ ๅ้ๅ๏ผ่ง้ข็ๆ้่ฆๆถ้ด๏ผ๏ผ่ฟ่ก๏ผ
```bash
apd download-video --week 2026-01 --headful
```
ๆฏๆ็ผๅญ๏ผๅทฒไธ่ฝฝ็่ง้ขไผ่ชๅจ่ทณ่ฟ๏ผไฝฟ็จ `--force` ๅผบๅถ้ๆฐไธ่ฝฝใ
### Phase 3: ๅๅธๅฐ HuggingFace
```bash
apd publish --week 2026-01
```
่ฏฅๅฝไปคไผ๏ผ
- โ
ไธไผ ่ง้ขๅฐ HuggingFace Dataset
- โ
ๆดๆฐ metadata.json
- โ
็ๆ Markdown ๆ่ฆ
### Phase 3b: ๅๅธๅฐๆ้ณ๏ผๅฏ้๏ผ
้ฆๆฌกไฝฟ็จ้่ฆๅ
็ปๅฝๆ้ณ๏ผ
```bash
apd douyin-login
```
> ๆต่งๅจไผๆๅผๆ้ณๅไฝ่
ไธญๅฟ็ปๅฝ้กต้ข๏ผไฝฟ็จๆ้ณ APP ๆซ็ ็ปๅฝ๏ผ็ปๅฝ็ถๆๅฐ่ขซไฟๅญใ
็ถๅๅๅธ่ง้ขๅฐๆ้ณ๏ผ
```bash
apd publish-douyin --week 2026-01 --headful
```
่ฏฅๅฝไปคไผ๏ผ
- โ
่ชๅจไธไผ ่ง้ขๅฐๆ้ณๅไฝ่
ๅนณๅฐ
- โ
ๅกซๅ่ง้ขๆ ้ข๏ผ่ฎบๆๆ ้ข๏ผ
- โ
ๆทปๅ ่ฏ้ขๆ ็ญพ๏ผAIใ่ฎบๆ่งฃ่ฏป็ญ๏ผ
- โ
่ชๅจ็นๅปๅๅธ
> ๐ก **ๆ็คบ**๏ผ้ฆๆฌกไฝฟ็จๅปบ่ฎฎๆทปๅ `--headful` ๅๆฐ่งๅฏๅๅธ่ฟ็จ๏ผ็กฎ่ฎคๆ ่ฏฏๅๅฏๅปๆ่ฏฅๅๆฐใ
---
## ๐
ๆๆฅๅค็๏ผๅฏ้๏ผ
้คไบๆๅจๅค็ๅค๏ผไนๆฏๆๆๆฅๆๅค็่ฎบๆ๏ผ
```bash
# ่ทๅๆๅฎๆฅๆ็่ฎบๆ
apd fetch --date 2026-01-08 --max 10
# ไธไผ ๅนถ็ๆ่ง้ข
apd upload --date 2026-01-08 --headful --max 10
# ไธ่ฝฝ่ง้ข
apd download-video --date 2026-01-08 --headful
# ๅๅธๅฐๆ้ณ
apd publish-douyin --date 2026-01-08 --headful
```
> โ ๏ธ **ๆณจๆ**๏ผๅจๆซๅ่ๅๆฅๆฒกๆ่ฎบๆ๏ผ็ณป็ปไผๆ็คบ้่ฏฏ่้็ปง็ปญๅค็ใ
### ๆไปถๅคน็ปๆ
ๆๆฅๅๆๅจ็ๆฐๆฎๅๅผๅญๆพ๏ผ
- `data/pdfs/weekly/2026-01/` - ๆๅจๅค็็ PDF
- `data/pdfs/daily/2026-01-08/` - ๆๆฅๅค็็ PDF
- `data/videos/weekly/2026-01/` - ๆๅจๅค็็่ง้ข
- `data/videos/daily/2026-01-08/` - ๆๆฅๅค็็่ง้ข
---
### ๐ ้จๆท็ฝ็ซ
่ง้ขๅๅธๅ๏ผๅฏๅจ HuggingFace Spaces ้จๆท็ฝ็ซ็ดๆฅ่ง็๏ผ
```
https://huggingface.co/spaces/your-username/paper-digest
```
---
## ๐ ๅฝไปคๅคงๅ
จ
| ๅฝไปค | ่ฏดๆ |
|------|------|
| `apd login` | ๆๅผๆต่งๅจๅฎๆ Google ็ปๅฝ๏ผNotebookLM๏ผ |
| `apd douyin-login` | ๆๅผๆต่งๅจๅฎๆๆ้ณ็ปๅฝ |
| `apd fetch` | ไป
่ทๅ่ฎบๆๅ่กจ๏ผไธไธ่ฝฝ๏ผ |
| `apd download` | ไป
ไธ่ฝฝ PDF๏ผๆฏๆ็ผๅญ๏ผ |
| `apd upload` | **Phase 1**๏ผ่ทๅ + ไธ่ฝฝ + ไธไผ + ่งฆๅ็ๆ |
| `apd download-video` | **Phase 2**๏ผไธ่ฝฝๅทฒ็ๆ็่ง้ข๏ผๆฏๆ็ผๅญ๏ผ |
| `apd publish` | **Phase 3**๏ผๅๅธๅฐ HuggingFace |
| `apd publish-douyin` | **Phase 3b**๏ผๅๅธๅฐๆ้ณๅไฝ่
ๅนณๅฐ |
| `apd digest` | ็ๆๆฌๅฐๅจๆฅ |
| `apd run` | ๅฎๆดๆต็จ๏ผไธ้ฎๆง่ก๏ผ้็ญๅพ
่ง้ข็ๆ๏ผ |
| `apd status` | ๆฅ็่ฎบๆๅค็็ถๆ |
### ๅธธ็จๅๆฐ
```bash
--week, -w ๆๅฎๅจ ID๏ผๅฆ 2026-01๏ผ๏ผ้ป่ฎคๅฝๅๅจ
--max, -m ๆๅคง่ฎบๆๆฐ้
--headful ๆพ็คบๆต่งๅจ็ชๅฃ๏ผ่ฐ่ฏๆถไฝฟ็จ๏ผ
--force, -f ๅผบๅถ้ๆฐๅค็๏ผๅฟฝ็ฅ็ผๅญ๏ผ
--debug ๅผๅฏ่ฐ่ฏๆฅๅฟ
```
---
## ๐ ็ฎๅฝ็ปๆ
```
auto-paper-digest/
โโโ apd/ # ไธป็จๅบๅ
โ โโโ cli.py # ๅฝไปค่กๅ
ฅๅฃ
โ โโโ config.py # ้
็ฝฎๅธธ้
โ โโโ db.py # SQLite ๆฐๆฎๅบ
โ โโโ hf_fetcher.py # HF ่ฎบๆๆๅ๏ผๆฏๆๅจ URL๏ผ
โ โโโ pdf_downloader.py # PDF ไธ่ฝฝๅจ
โ โโโ nblm_bot.py # NotebookLM ่ชๅจๅ
โ โโโ douyin_bot.py # ๆ้ณๅไฝ่
ๅนณๅฐ่ชๅจๅ
โ โโโ publisher.py # HuggingFace ๅๅธ
โ โโโ digest.py # ๅจๆฅ็ๆ
โ โโโ utils.py # ๅทฅๅ
ทๅฝๆฐ
โโโ portal/ # HuggingFace Spaces ้จๆท
โ โโโ app.py # Gradio ๅบ็จ
โ โโโ requirements.txt
โ โโโ README.md
โโโ data/
โ โโโ apd.db # SQLite ๆฐๆฎๅบ
โ โโโ .douyin_auth.json # ๆ้ณ็ปๅฝ็ถๆ
โ โโโ pdfs/ # ไธ่ฝฝ็ PDF๏ผๆๅจๅ็ฎๅฝ๏ผ
โ โโโ videos/ # ็ๆ็่ง้ข๏ผๆๅจๅ็ฎๅฝ๏ผ
โ โโโ digests/ # ๅจๆฅๆไปถ
โ โโโ profiles/ # ๆต่งๅจ้
็ฝฎ๏ผๅซ็ปๅฝๆ๏ผ
โโโ .env.example # ็ฏๅขๅ้ๆจกๆฟ
โโโ pyproject.toml
```
---
## ๏ฟฝ ็ผๅญๆบๅถ
### PDF ็ผๅญ
- ๅทฒไธ่ฝฝ็ PDF ้่ฟ SHA256 ๆ ก้ช
- ็ธๅๆไปถ่ชๅจ่ทณ่ฟ
### ่ง้ข็ผๅญ
- ไฝฟ็จๆไปถๅๅ็ผๅน้
๏ผ`{paper_id}_*.mp4`๏ผ
- ๆฏๆๆฐ็ๅฝๅๆ ผๅผ๏ผ`{paper_id}_{video_title}.mp4`
- ไฝฟ็จ `--force` ๅผบๅถ้ๆฐไธ่ฝฝ
### ๅๅธ็ผๅญ
- metadata.json ไธญ่ฎฐๅฝๅทฒๅๅธ็่ฎบๆ
- ้ๅคๅๅธ่ชๅจ่ทณ่ฟ
---
## ๐ ็ถๆ่ฟฝ่ธช
```
NEW โ PDF_OK โ NBLM_OK โ VIDEO_OK
โ โ
โโโโโโโโโ ERROR โโโโโโโโโโโโ
```
| ็ถๆ | ๅซไน |
|------|------|
| `NEW` | ่ฎบๆๅทฒๆๅ๏ผๅพ
ๅค็ |
| `PDF_OK` | PDF ๅทฒไธ่ฝฝ |
| `NBLM_OK` | ๅทฒไธไผ ๅฐ NotebookLM๏ผ่ง้ข็ๆไธญ |
| `VIDEO_OK` | ่ง้ขๅทฒไธ่ฝฝ |
| `ERROR` | ๅค็ๅคฑ่ดฅ๏ผไผ่ชๅจ้่ฏ๏ผ |
ๆฅ็็ถๆ๏ผ
```bash
apd status --week 2026-01
apd status --week 2026-01 --status ERROR
```
---
## ๐ง ๆ
้ๆ้ค
### ็ปๅฝ้ฎ้ข
```bash
apd login
```
### NotebookLM ็้ขๅๅ
ๆฅ็ๆชๅพ๏ผ
```bash
ls data/profiles/screenshots/
```
### ่ง้ขๆช็ๆ
่ง้ข็ๆ้่ฆๅ ๅ้ๆถ้ด๏ผ่ฏท็จๅ้่ฏ๏ผ
```bash
apd download-video --week 2026-01 --headful
```
### HuggingFace Token ้ฎ้ข
็กฎไฟ `.env` ๆไปถ้
็ฝฎๆญฃ็กฎ๏ผ
```bash
cat .env
# ๆฃๆฅ HF_TOKEN ๅ HF_USERNAME
```
---
## ๐ค ๆๆฏๆ
- **Python 3.11+** - ๆ ธๅฟ่ฏญ่จ
- **Playwright** - ๆต่งๅจ่ชๅจๅ
- **SQLite** - ็ถๆๆไน
ๅ
- **Click** - CLI ๆกๆถ
- **Requests + BeautifulSoup** - ็ฝ้กตๆๅ
- **huggingface_hub** - HF API
- **Gradio** - ้จๆท็ฝ็ซ
- **python-dotenv** - ็ฏๅขๅ้็ฎก็
---
## ๐ License
MIT License ยฉ 2026