๐ค ็ฑ OpenClaw Agent ๅฎๅ จ่ชไธปๅผๅ็้ณไนๅบ่ชๅจๅ็ฎก็ๅทฅๅ ท
ๅ่ MoviePilot ๆถๆ๏ผ้็จ Chain + Module + Plugin ไธๅฑๆถๆ๏ผๆไพๅผบๅคง็ๆฉๅฑ่ฝๅใ
ๅ่ฝ็นๆง โข ๅฟซ้ๅผๅง โข ๆๆฏๆถๆ โข ๅผๅ่ฎกๅ
โ ๏ธ ๅ ่ดฃๅฃฐๆๆฌ้กน็ฎไป ็จไบๅญฆไน ไบคๆตไฝฟ็จ๏ผ่ฏทๅฟๅจไปปไฝๅ ฌๅผๅนณๅฐๅฎฃไผ ่ฏฅ้กน็ฎใ
ๆฌ้กน็ฎไธๆไพไปปไฝ้ณไนๅ ๅฎน็ๅญๅจใๅๅๆไผ ๆญๆๅกใ็จๆทไฝฟ็จๆฌ้กน็ฎๆ็ดขใไธ่ฝฝๆๆด็็้ณไน่ตๆบ๏ผๅๆฅ่ช็จๆท่ช่ก้ ็ฝฎ็่ตๆบ็ซ็นใๅผๅ่ ไธๅฏน่ตๆบ็็ๆๅๆณๆงใๅ ๅฎน่ดจ้ๆๅฎๅ จๆง่ด่ดฃใ
็จๆทไฝฟ็จๆฌ้กน็ฎๆไบง็็ไธๅๅๆ็ฑ็จๆท่ช่กๆฟๆ ๏ผๅ ๆฌไฝไธ้ไบ๏ผ
- ๅ ไธ่ฝฝๆไผ ๆญๅ็ๆไฟๆค็้ณไนๅ ๅฎน่ๅฏผ่ด็ๆณๅพ็บ ็บท
- ๅ ไฝฟ็จ่ตๆบ็ซ็น่ๅฏผ่ด็่ดฆๅทๅฐ็ฆๆๅ ถไปๅๆ
- ๅ ไฝฟ็จๆฌ้กน็ฎ่ไบง็็ไปปไฝ็ดๆฅๆ้ดๆฅๆๅคฑ
ๅผๅ่ ไธๆฟๆ ไปปไฝ่ดฃไปป๏ผไบฆไธๅฏน็จๆท็่กไธบ่ฟ่ก็ๆงๆๅนฒ้ขใ
่ฏท็จๆท่ช่ง้ตๅฎ็ธๅ ณๆณๅพๆณ่งๅ็ๆ่งๅฎ๏ผๅฐ้็ฅ่ฏไบงๆใ
MusicPilot ็่ฏ็ๆบไบไธไธชๅคง่็ๆณๆณ๏ผ่ฝๅฆ่ฎฉ AI ๅฎๅ จ่ชไธปๅผๅไธไธชๅฎ็จ็้ณไนๅบ็ฎก็ๅทฅๅ ท๏ผ
็ป่ฟๆทฑๅ ฅๅๆ MoviePilot ็ๆถๆๅไปฃ็ ๏ผๅ่ๅ ถ Chain + Module + Plugin ไธๅฑๆถๆๆจกๅผ๏ผMusicPilot ๅบ่ฟ่็ใ
ๆไปฌ็็ฎๆ ๏ผ
- ๐ฏ ่็ฆๆ ธๅฟ้ๆฑ๏ผ่ตๆบๆ็ดขใ่ชๅจไธ่ฝฝใๅ ๆฐๆฎๅฎๅ
- ๐ ่ชๅจๅไผๅ ๏ผไปๆ็ดขๅฐไธ่ฝฝๅฐๆด็๏ผๅ จ็จ่ชๅจๅ
- ๐ ๆฉๅฑๆงๅผบ๏ผๆไปถ็ณป็ปๆฏๆ็ฌฌไธๆนๆฉๅฑ
- ๐จ ็้ขๅๅฅฝ๏ผๅบไบ Vue 3 + Naive UI ็็ฐไปฃๅ็้ข
็็น 1๏ผ้ณไน่ตๆบๅๆฃ๏ผๆ็ดขๅฐ้พ
- ไธๅ็่ตๆบ็ซ็นๆไธๅ็ๆ็ดขๆฅๅฃ
- ๆฏไธช็ซ็น้่ฆๆๅจ็ปๅฝใๆ็ดขใไธ่ฝฝ
- ไธ่ฝฝๅ่ฟ้่ฆๆๅจๆด็ๆไปถๅๅฎๅๅ ๆฐๆฎ
็็น 2๏ผ้ณไนๅบ็ฎก็็น็
- ้ณไนๆไปถๆฃ่ฝๅจๅคไธช็ฎๅฝ
- ๅ ๆฐๆฎไธๅฎๆด๏ผๅฐ้ข็ผบๅคฑ
- ้่ฆๆๅจๆด็ๅๅฎๅ๏ผ่ๆถ่ๅ
็็น 3๏ผ่ชๅจๅ็้ๆฑ
- ่ฎข้ ็่บๆฏๅฎถๅๅธไบๆฐไธ่พ๏ผๅธๆ่ฝ่ชๅจไธ่ฝฝ
- ไธ่ฝฝๅ็ๆไปถ่ฝ่ชๅจๆด็ๅฐๆญฃ็กฎ็็ฎๅฝ
- ๅ ๆฐๆฎ่ฝ่ชๅจๅฎๅๅ่กฅๅ จ
- ๅค็ซ็นๆฏๆ๏ผๆฏๆ็ฎก็ๅคไธช้ณไน่ตๆบ็ซ็น
- ็ซ็น้ ็ฝฎ๏ผ็ซ็นๅฐๅใCookie/PasskeyใUser-Agentใไปฃ็็ญ
- ็ซ็นๆต่ฏ๏ผไธ้ฎๆต่ฏ็ซ็น่ฟๆฅ็ถๆ
- ไผๅ ็บง่ฎพ็ฝฎ๏ผ่ฎพ็ฝฎ็ซ็นๆ็ดขไผๅ ็บง
- ๅ ณ้ฎ่ฏๆ็ดข๏ผๆฏๆ่บๆฏๅฎถใไธ่พใๆฒ็ฎๅ ณ้ฎ่ฏๆ็ดข
- ้ซ็บง่ฟๆปค๏ผๅคงๅฐใๆ ผๅผใ็ผ็ ใๅ ่ดน็ถๆ็ญ่ฟๆปค
- ็ซ็น่ๅด๏ผๅฏๅจๆๆ็ซ็นๆๆๅฎ็ซ็นๆ็ดข
- ๆ็ดข็ปๆ๏ผๆพ็คบ็ซ็นใๆ ้ขใๅคงๅฐใๅ็ง/ไธ่ฝฝใๅๅธๆถ้ดใๅ ่ดน็ถๆใHR ็ญไฟกๆฏ
- ไธ้ฎไธ่ฝฝ๏ผ็นๅปๅณๅฏไธ่ฝฝ็งๅญๆไปถ
- ไธ่ฝฝๅจ้ๆ๏ผๆฏๆๆจ้ๅฐ qBittorrent / Transmission
- ไธ่ฝฝ็ฎก็๏ผๆพ็คบไธ่ฝฝ่ฟๅบฆ๏ผๆฏๆๆๅ/ๆขๅค/้่ฏ
- ไธ่ฝฝๅๅฒ๏ผ่ฎฐๅฝๆๆไธ่ฝฝๅๅฒ
- ๆไปถ่ฏๅซ๏ผ่ชๅจ่ฏๅซไธ่ฝฝ็ๆไปถ๏ผ่บๆฏๅฎถ/ไธ่พ/ๆฒ็ฎ๏ผ
- ๅ ๆฐๆฎๅฎๅ๏ผ่ชๅจๆฅ่ฏข MusicBrainz ่ทๅๅ ๆฐๆฎ
- ๆไปถๆด็๏ผๆ่งๅๆด็ๆไปถ๏ผArtist/Album/Track.flac๏ผ
- ๆ ็ญพๅๅ ฅ๏ผ่ชๅจๅๅ ฅๅ ๆฐๆฎๆ ็ญพ๏ผID3v2/Vorbis๏ผ
- ๅฐ้ขไธ่ฝฝ๏ผ่ชๅจไธ่ฝฝไธ่พๅฐ้ขๅพ็
- ๆฐๆฎๅบๆดๆฐ๏ผ่ชๅจๆดๆฐๆฐๆฎๅบ่ฎฐๅฝ
- ๆต่ง้ณไนๅบ๏ผๆ่บๆฏๅฎถใไธ่พใๆฒ็ฎๆต่ง
- ๆ็ดขๅ่ฝ๏ผๅฟซ้ๆ็ดข้ณไน
- Web ๆญๆพๅจ๏ผๅบไบ Howler.js ็ๅจ็บฟๆญๆพๅจ
- ๆญๆพๅ่กจ๏ผๅๅปบๅ็ฎก็ๆญๆพๅ่กจ
| ๆๆฏ | ็ๆฌ | ่ฏดๆ |
|---|---|---|
| Web ๆกๆถ | FastAPI 0.115+ | ็ฐไปฃๅผๆญฅ Web ๆกๆถ๏ผ่ชๅจ็ๆ API ๆๆกฃ |
| ORM | SQLAlchemy 2.0+ | Python ๆๆต่ก็ ORM๏ผๆฏๆๅผๆญฅ |
| ๆฐๆฎๅบ | SQLite / PostgreSQL | ๅผๅ็จ SQLite๏ผ็ไบง็จ PostgreSQL |
| ไปปๅก่ฐๅบฆ | APScheduler 3.10+ | Python ไปปๅก่ฐๅบฆๅบ |
| ้ ็ฝฎ็ฎก็ | Pydantic Settings 2.0+ | ็ฑปๅๅฎๅ จ็้ ็ฝฎ็ฎก็ |
| ้ณ้ขๅค็ | mutagen 1.47+ | ๅผบๅคง็้ณ้ขๅ ๆฐๆฎๅค็ๅบ |
| Python | 3.12+ | ๆๆฐ Python ็ๆฌ |
| ๆๆฏ | ็ๆฌ | ่ฏดๆ |
|---|---|---|
| ๆกๆถ | Vue 3.4+ | ๆธ่ฟๅผ JavaScript ๆกๆถ |
| ๆๅปบๅทฅๅ ท | Vite 5.0+ | ไธไธไปฃๅ็ซฏๆๅปบๅทฅๅ ท |
| UI ็ปไปถ | Naive UI 2.38+ | Vue 3 ็ปไปถๅบ๏ผ่ฎพ่ฎก็ฒพ็พ |
| ็ถๆ็ฎก็ | Pinia 2.1+ | Vue ๅฎๆนๆจ่็็ถๆ็ฎก็ |
| ่ทฏ็ฑ | Vue Router 4.2+ | Vue ๅฎๆน่ทฏ็ฑ |
| HTTP ๅฎขๆท็ซฏ | Axios 1.6+ | Promise based HTTP ๅฎขๆท็ซฏ |
| ้ณ้ขๆญๆพ | Howler.js 2.15+ | ๅผบๅคง็ HTML5 ้ณ้ขๆญๆพๅบ |
| Node | 20.12.1+ | Node.js ๆๆฐ LTS ็ๆฌ |
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๅ็ซฏ (Vue 3) โ
โ โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ โ
โ โ ่ตๆบ็ซ็น โ โ ๆ็ดข โ โ ้ณไนๅบ โ โ ๆญๆพๅจ โ โ
โ โ ็ฎก็ โ โ ่ตๆบ โ โ ๆต่ง โ โ โ โ
โ โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ RESTful API
โโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ FastAPI ๅ็ซฏ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ API ๅฑ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโ โ
โ โ Chain ๅฑ โ โ
โ โ TorrentsChain | TorrentsChain โ โ
โ โ MetadataChain | TransferChain โ โ
โ โ PlaylistChain | PlaybackChain โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโ โ
โ โ Module Manager โ โ
โ โ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โ โ
โ โ โMusicBrainzโโ ่ตๆบ็ซ็น โโ ไธ่ฝฝๅจ โ ... โ โ
โ โ โ ๆจกๅ โโ ๆจกๅ โโ ๆจกๅ โ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๆฐๆฎๅฑ (SQLAlchemy) โ
โ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โ
โ โ Artist โ โ Album โ โ Track โ โPlaylistโ โ
โ โ ๆจกๅ โ โ ๆจกๅ โ โ ๆจกๅ โ โ ๆจกๅ โ โ
โ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ SQLite (ๅผๅ) / PostgreSQL (็ไบง) โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
ๅค้จ้ๆ๏ผ
โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ
โ ่ตๆบ็ซ็น โโMusicBrainzโโ qBittorrentโโTransmissionโ
โ API โโ API โโ API โโ API โ
โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ โโโโโโโโโโโโ
- Python 3.12+
- Node.js 20.12.1+
- Git
# ๅ
้้กน็ฎ
git clone https://github.com/hhyo/MusicPilot.git
cd MusicPilot
# ๅ็ซฏ
cd backend
pip install -r requirements.txt
python -m app.main
# ๅ็ซฏ๏ผๅฆๅผ็ป็ซฏ๏ผ
cd frontend
npm install
npm run dev
# ่ฎฟ้ฎ
# ๅ็ซฏ๏ผhttp://localhost:5173
# ๅ็ซฏ API๏ผhttp://localhost:3001/docs# ๅฏๅจๆๆๆๅก
docker-compose up -d
# ่ฎฟ้ฎ
# ๅ็ซฏ๏ผhttp://localhost:3000
# ๅ็ซฏ API๏ผhttp://localhost:3001- โ ๆฏๆ็ฎก็ๅคไธช้ณไน่ตๆบ็ซ็น
- โ ็ซ็น้ ็ฝฎ๏ผๅฐๅใCookie/PasskeyใUser-Agentใไปฃ็
- โ ็ซ็นๆต่ฏ๏ผไธ้ฎๆต่ฏ่ฟๆฅ็ถๆ
- โ ไผๅ ็บง่ฎพ็ฝฎ๏ผ่ชๅฎไนๆ็ดขไผๅ ็บง
- โ ๅ ณ้ฎ่ฏๆ็ดข๏ผ่บๆฏๅฎถใไธ่พใๆฒ็ฎ
- โ ้ซ็บง่ฟๆปค๏ผๅคงๅฐใๆ ผๅผใ็ผ็ ใๅ ่ดน็ถๆ
- โ ็ซ็น่ๅด๏ผๆๆ็ซ็นๆๆๅฎ็ซ็น
- โ ๆ็ดข็ปๆ๏ผ่ฏฆ็ปไฟกๆฏๅฑ็คบ
- โ ไธ้ฎไธ่ฝฝ็งๅญๆไปถ
- โ ไธ่ฝฝๅจ้ๆ๏ผqBittorrent / Transmission
- โ ไธ่ฝฝ็ฎก็๏ผ่ฟๅบฆใๆๅใๆขๅคใ้่ฏ
- โ ไธ่ฝฝๅๅฒ่ฎฐๅฝ
- โ ๆไปถ่ฏๅซ๏ผ่ชๅจ่ฏๅซ่บๆฏๅฎถ/ไธ่พ/ๆฒ็ฎ
- โ ๅ ๆฐๆฎๅฎๅ๏ผMusicBrainz API
- โ ๆไปถๆด็๏ผๆ่งๅๆด็ๆไปถ
- โ ๆ ็ญพๅๅ ฅ๏ผID3v2/Vorbis
- โ ๅฐ้ขไธ่ฝฝ๏ผ่ชๅจไธ่ฝฝๅฐ้ข
- โ ๆฐๆฎๅบๆดๆฐ
- โ ๆต่ง้ณไนๅบ๏ผ่บๆฏๅฎถใไธ่พใๆฒ็ฎ
- โ ๆ็ดขๅ่ฝ๏ผๅฟซ้ๆ็ดข
- โ Web ๆญๆพๅจ๏ผๅจ็บฟๆญๆพ
- โ ๆญๆพๅ่กจ๏ผๅๅปบๅ็ฎก็ๆญๆพๅ่กจ
| ้็จ็ข | ็ๆฌ | ๅจๆ | ็ฎๆ | ็ถๆ |
|---|---|---|---|---|
| M1 | v0.1.0 | Week 1-2 | ๅ ๆฐๆฎ้พ | โ ๅทฒๅฎๆ |
| M2 | v0.2.0 | Week 3-4 | ๆญๆพๅ่กจ | โ ๅทฒๅฎๆ |
| M3 | v0.3.0 | Week 5-6 | ๅชไฝๅบ็ฎก็ | โ ๅทฒๅฎๆ |
| M4 | v0.4.0 | Week 7-8 | ่ตๆบ็ซ็นๅไธ่ฝฝๅจๅฏนๆฅ | โ ๅทฒๅฎๆ |
| M5 | v0.5.0 | Week 9-10 | ่ฎข้ ๅ่ฝ | โ ๅทฒๅฎๆ |
| M6 | v0.6.0 | Week 11-12 | ๆญๆพๅจ็้ข | โ ๅทฒๅฎๆ |
| M7 | - | Week 13 | CI/CD ไฟฎๅค | โ ๅทฒๅฎๆ |
| M8 | - | Week 14 | ไปฃ็ ไธๆถๆๅฎกๆฅ | โธ๏ธ ๅพ ๅผๅง |
| M9 | - | Week 15-16 | ๆต่ฏ่ฆ็ๆๅ | โธ๏ธ ๅพ ๅผๅง |
| M10 | - | Week 17 | ไบงๅ้ชๆถ | โธ๏ธ ๅพ ๅผๅง |
| M11 | v1.0.0 | Week 18 | ๅๅธๅๅค | โธ๏ธ ๅพ ๅผๅง |
| M12 | v1.1.0 | Week 19-20 | ๆไปถ็ณป็ปๅฎๅ | โธ๏ธ ๅพ ๅผๅง |
่ฏฆ็ปไปปๅกๆ่งฃ๏ผ่ฏฆ่ง ไปปๅกๆธ ๅ
- ้กน็ฎๅๅ๏ผGUIDELINES.md
- ้ๆฑๅๆ๏ผrequirements.md
- ๆๆฏ่ฎพ่ฎก๏ผtech-design.md
- ็ ๅๆต็จ๏ผflow.md
ๆฌข่ฟ่ดก็ฎ๏ผ่ฏทๆฅ็ ่ดก็ฎๆๅใ
MIT License
ๆฌ้กน็ฎๆทฑๅไปฅไธ้กน็ฎๅฏๅ๏ผ
- MoviePilot - ๆถๆๅ่
- MusicBrainz - ๅ ๆฐๆฎๆฅๆบ
- FastAPI - ๅ็ซฏๆกๆถ
- Vue 3 - ๅ็ซฏๆกๆถ
- Naive UI - UI ็ปไปถๅบ
โญ ๅฆๆ่ฟไธช้กน็ฎๅฏนๆจๆๅธฎๅฉ๏ผ่ฏท็ปไธไธช Star๏ผ