v0.3.2

Xem docs/CHANGELOG.md mục 0.3.2: gitignore .zip/.mp4 + thư mục công cụ, tài liệu số đo Mac thật, Actions Node 24. Hành vi chạy không đổi.

v0.3.1

Chạy ổn trên Mac mini (máy embedded), Windows giữ nguyên.

• doctor dòng bgm-library giờ kiểm cả file nhạc: style khai trong bgm-library.json mà
  thiếu <style>.mp3 là [WARN] kèm tên style thiếu — trước đây chỉ kiểm file json, và pipeline
  chọn đúng style đó chết ở bước ghép sau khi đã tốn cả lượt tổng hợp. Repo không có lệnh sinh
  nhạc; cách tự sinh (và giấy phép CC-BY-NC của weights MusicGen) ở docs/bgm-generation.md.
• Tên profile so theo Unicode NFC: file tên có dấu ở dạng NFD (chép từ gói/máy khác) giờ khớp
  tên viết trong cấu hình; list_profiles() / get_default() trả tên NFC. Không đổi tên file nào.
• Luật cài package có thêm dòng máy embedded: giọng cài vào venv của repo video thì luôn
  pip install -e (trùng agent-video-studio/INSTALL.md mục 5b); bản sao chỉ dành cho xưởng
  Windows chạy lịch có trạm giọng riêng. docs/INSTALL.md mục 3.
• voice-studio init nhận ra khi voice_studio đang chạy từ venv của dự án khác (vd .venv của
  repo video): không còn bảo tạo <trạm>/omnivoice/.venv hay tải lại weights đã có trong cache.
• Tài liệu cài: macOS dùng python3.12 (không phải python3 = 3.9), ghi chú uv/pyenv; dung lượng
  tách theo máy — torch CUDA ~2,5 GB, macOS arm64 ~130 MB, weights ~3,3 GB.
• JSON của speak, narrate, doctor (và get_status của MCP) thêm khoá version = phiên bản
  package; voice_studio vẫn là phiên bản hợp đồng (API_VERSION, nay 1.1.0 vì thêm khoá —
  không phá khoá cũ). Bên gọi ghim theo voice_studio, truy lỗi theo version.

PR: #3 — mã MAC-REVIEW: P0-4, P1-4, P2-5, P2-6, P2-7, P2-8, P2-17.

v0.3.0

Cài đặt cho agent, hai hệ điều hành.

• INSTALL.md ở gốc repo: hướng dẫn dành cho AI agent (Windows và macOS) kèm prompt copy-dán
  tiếng Việt và tiếng Anh. Agent phải hỏi trước khi cài phần mềm, tải engine, hay chọn chỗ đặt trạm.
• START-HERE.md, AGENTS.md (+ CLAUDE.md, GEMINI.md trỏ về), hosts/ cho Claude Code, Codex,
  Antigravity, Claude Desktop; docs/troubleshooting.md; trang web /install/.
• Trạm mặc định là <repo>/workspace/ khi không đặt biến nào — không còn tự chọn ~/.voice.
  ~/.voice chỉ được dùng khi bạn đã chọn nó hoặc nó đã là một trạm. Cài dạng wheel mà chưa đặt
  VOICE_STATION: lệnh cần trạm dừng với mã 3 kèm cách đặt.
• Lệnh mới voice-studio uninstall: gỡ package và hook pre-commit, giữ trạm và giọng;
  --dry-run để xem trước.
• doctor có bốn trạng thái PASS / WARN / FAIL / NOT_CHECKED; JSON thêm mức
  not_checked và danh sách not_checked (các mức cũ giữ nguyên tên). Dòng mới samples và
  synthesis.
• samples/: một câu tiếng Việt ngắn ở dạng thô (4 bẫy phát âm đã đo) và dạng viết lại, cùng hình
  dạng JSON của speak --json. Doctor xác minh offline.
• Sửa: tài liệu từng bảo OMNIVOICE_ONLINE=1 voice-studio doctor để tải weights — doctor không
  bao giờ tải gì; lần tổng hợp đầu mới tải. Lệnh init in ra giờ đúng cú pháp PowerShell trên
  Windows.
• Phần phụ engine giữ transformers trong khoảng đã chạy thật (>=5.10.2,<5.18), không ghim
  cứng một số; cài engine bằng pip install "<repo>[engine]". Doctor in phiên bản transformers và
  [WARN] khi nó nằm ngoài khoảng.
• Cài package có một luật, ở docs/INSTALL.md mục 3: máy phát triển pip install -e, máy
  chạy lịch cài bản sao (không -e) để sửa hay git pull repo không đổi lượt đang chạy; có
  lệnh Windows và macOS. voice-studio update trên bản sao in lại lệnh cài để mã mới vào venv.

🤖 Generated with Claude Code

v0.2.0 — the engine moves into a package, and a clone actually runs

The voice engine leaves the station and becomes voice_studio, an installable
package with a CLI whose exit codes are a contract: 2 for a configuration
mistake, 3 for a missing engine, one JSON line last on stdout either way.

embedded is now the default mode, so cloning the repo and running it is the
normal path rather than a documented option. Where the station lives, where the
secrets live, and how to move either one are answered by voice-studio migrate
instead of by hand-editing paths.

Hardened on the way out: archive import refuses a member whose name carries a
drive letter on any segment, and checks again after resolving the real path;
export refuses anything that looks like a secret; three environment variables
can no longer quietly redirect the station.

Tested on Windows and macOS in CI.