Dự án/MH-Dowsampl.Extension
DevelopmentChrome ExtensionLocal-firstWindows

MH-Dowsampl.Extension

Lớp thu thập âm thanh local-first trong hệ sinh thái công cụ MH.

Giai đoạn phát triển. Công cụ được xây dựng trước hết cho quy trình thu thập sample của Minh Hiếu. Chưa phát hành trên Chrome Web Store và chưa được tuyên bố là bản ổn định cho mọi website.

Vì sao dự án này tồn tại

Trong quá trình làm nhạc, việc mở từng trang, tìm đúng đường dẫn âm thanh rồi tải và kiểm tra từng file làm mất nhiều thời gian. Công cụ này rút ngắn phần việc lặp lại đó:

  • Nhận liên kết do người dùng chủ động cung cấp
  • Tìm các đường dẫn âm thanh công khai trên trang
  • Tải file về máy local mà không ghi đè file đã có
  • Hiển thị tiến trình và kết quả ngay trong popup
  • Giữ quá trình thu thập tách biệt với bước quản lý và sử dụng sample

Mục tiêu là giảm thao tác kỹ thuật để Minh Hiếu dành nhiều thời gian hơn cho công việc sản xuất âm nhạc.

Cách hoạt động
Dán liên kếtNgười dùng
Chrome ExtensionGửi yêu cầu
Local API127.0.0.1:8765
Tìm audioScan public links
Tải vềLưu local

Extension không tự tải âm thanh khi người dùng chưa bấm nút. Backend chỉ lắng nghe trên địa chỉ loopback 127.0.0.1:8765 — không mở dịch vụ ra ngoài mạng.

Khả năng hiện có
Nhập nguồn

Nhận một liên kết HTTP/HTTPS do người dùng dán vào popup

Tìm âm thanh

Đọc Splice public sample page hoặc trang có đường dẫn audio công khai

Tải file

Tải file gốc / preview tìm thấy về máy local

Xử lý nhóm

Tối đa 200 đường dẫn / nhóm, tải đồng thời tối đa 4 file

Chống ghi đè

Tự thêm (2), (3) khi tên file đã tồn tại

An toàn khi tải

Ghi vào .part trước, chỉ đổi thành file chính sau khi tải xong

Theo dõi

Hiển thị trạng thái server, quá trình tìm link, tiến trình tải và kết quả

Tiếp tục theo dõi

Lưu job gần nhất trong chrome.storage.local để popup mở lại vẫn xem được

Những khả năng trên mô tả source hiện có, không thay thế việc nghiệm thu trên máy Windows thật và nguồn dữ liệu thật.

Cài đặt trên Windows

Yêu cầu

  • Windows 10 hoặc Windows 11
  • Python 3
  • Google Chrome hoặc Chromium hỗ trợ Manifest V3
  • Repository đã được clone hoặc tải về máy

Thiết lập lần đầu

  1. 01Chạy SETUP.cmd để tạo môi trường Python local.
  2. 02Chạy START-SERVER.cmd và giữ cửsa sổ server mở trong lúc sử dụng.
  3. 03Chạy INSTALL-EXTENSION.cmd để mở trang quản lý extension và thư mục cần nạp.
  4. 04Tại chrome://extensions/, bật Chế độ dành cho nhà phát triển.
  5. 05Chọn Tải tiện ích đã giải nén.
  6. 06Chọn thư mục extension trong repository này.

Khi source được cập nhật, kéo code mới về máy rồi bấm Tải lại trên thẻ extension.

Hướng dẫn sử dụng
  1. 01Khởi động START-SERVER.cmd.
  2. 02Mở popup MH-Dowsample Extension trên thanh công cụ Chrome.
  3. 03Kiểm tra trạng thái Server kết nối.
  4. 04Dán liên kết Splice hoặc liên kết audio trực tiếp.
  5. 05Bấm Quét và tải âm thanh.
  6. 06Theo dõi số file đã tìm thấy, đã tải và lỗi tải.
  7. 07Bấm Mở thư mục tải khi công việc hoàn tất.

Có thể đóng popup trong lúc backend đang tải. Mở lại popup để tiếp tục xem job gần nhất.

Nơi lưu file

Có ổ J:

J:\MH-Audio-Downloads

Không có ổ J:

Downloads\MH-Audio-Downloads

Đổi thư mục gốc bằng biến môi trường MH_AUDIO_DOWNLOAD_DIR trước khi mở server.

An toàn và quyền riêng tư
  • Backend chỉ lắng nghe tại 127.0.0.1, không mở dịch vụ ra mạng LAN hoặc Internet.
  • Extension chỉ được cấp quyền lưu trạng thái local và gọi local API tại cổng 8765.
  • File đang tải dùng đuôi .part để tránh xem file chưa hoàn chỉnh như kết quả cuối.
  • File đã tồn tại không bị ghi đè.
  • Người dùng tự kiểm tra quyền sử dụng, điều khoản nguồn và license trước khi phân phối.
  • Không nên dán liên kết chứa token, thông tin đăng nhập hoặc dữ liệu riêng tư.
Giới hạn hiện tại
  • Chưa kiểm thử trên mọi website và mọi kiểu trình phát âm thanh.
  • Ưu tiên Splice public sample pages và liên kết audio trực tiếp.
  • Không vượt qua đăng nhập, paywall, DRM hoặc cơ chế bảo vệ của nguồn.
  • Chưa phát hành trên Chrome Web Store.
  • Chưa có security audit độc lập.
  • Chưa có bộ cài tự động hoàn chỉnh cho người dùng cuối.
  • Kết quả phụ thuộc cấu trúc trang và việc nguồn có cung cấp đường dẫn audio công khai hay không.
Vị trí trong hệ sinh thái MH

Các dự án mang tiền tố MH là những lớp liên kết trong cùng một quy trình, không phải các repository rời rạc. MH-Dowsampl.Extension là lớp thu thập.

01

MH Quantum Inspector

Quan sát và làm rõ

02

MH-Dowsampl.Extension

Thu thập âm thanh

← bạn đang ở đây
03

MH FileOS

Tổ chức và bảo vệ

04

MH Sample FL

Tìm, nghe và sử dụng

05

MINH HIEU STUDIO

Ghi lại và chia sẻ

Nguyên tắc phát triển
  1. 1.Bắt đầu từ nhu cầu thật trong quy trình làm nhạc.
  2. 2.Người dùng quyết định nguồn, phạm vi và thời điểm tải.
  3. 3.Dữ liệu và tiến trình hiển thị phải đến từ backend thật, không dùng số giả.
  4. 4.Không ghi đè file đã tồn tại.
  5. 5.Không mô tả mockup, build hoặc source chưa nghiệm thu như sản phẩm hoàn thiện.
  6. 6.Không bắt buộc cloud, API key hoặc gói trả phí cho workflow cốt lõi.
  7. 7.README phải nói rõ vị trí trong hệ sinh thái MH, cách dùng, giới hạn và trách nhiệm của người dùng.
← Quay lại danh sách dự án