Avatar — VSCode Extension

⚠️ Công cụ nội bộ NAL Vietnam. Cài được, nhưng chỉ hoạt động với tài khoản Google @nal.vn — máy chủ phát pack chỉ cấp nội dung cho tài khoản NAL. Ngoài NAL cài về sẽ không tải được pack.

Dùng Avatar ngay trong VSCode: đăng nhập, tải pack, đồng bộ, xem trạng thái — không cần cài avatar CLI riêng. Bản CLI đã được nhúng sẵn trong .vsix.

Cài đặt

Tải avatar-<version>.vsix ở tab Releases.
Trong VSCode: Cmd/Ctrl+Shift+P → Extensions: Install from VSIX… → chọn file vừa tải.
Mở lại cửa sổ (Developer: Reload Window).

Yêu cầu: VSCode ≥ 1.90 · tài khoản Google @nal.vn (server chỉ phát pack cho tài khoản NAL).

Dùng gì được

Cmd/Ctrl+Shift+P rồi gõ tên lệnh — extension khai 12 lệnh:

Nhóm	Lệnh
Cài & đồng bộ	`Khởi tạo workspace` · `Đăng nhập` · `Đồng bộ ngay` · `Cập nhật ngay` · `Chọn version pack (ghim / stable)`
Xem & tra	`Xem trạng thái` · `Kiểm tra bản mới` · `Chạy status` · `Mở Output`
Pack	`Tìm trong pack` · `Nạp lại pack` · `Chèn slash command vào terminal`

Thanh trạng thái hiện version pack + version CLI, luôn kèm nguồn (setting / global / nhúng) để không bao giờ phải đoán đang chạy bản nào.

Đã đo được gì

Khởi động: 9 ms (ngân sách 200 ms).
Huỷ giữa chừng khi đang cài pack: không để lại rác trong .claude/.
Cảnh báo trước khi đồng bộ nếu đang có phiên Claude Code mở (đồng bộ sẽ ghi đè settings.json, block AVATAR:MANAGED, và swap nguyên khối .claude/pack).

Extension gửi gì lên Telemetry

Mỗi lần mở VSCode, extension gửi đúng 1 event extension_activated lên https://telemetry.nal.vn/api/telemetry (tối đa 1 lần/24h cho mỗi version) để dashboard biết ai đã cài. Nội dung: version extension, version VSCode lõi, tên + version IDE đang chạy (AvatarCodi lấy avatarCodiVersion từ product.json, VSCode lấy vscode.version), hệ điều hành, nguồn CLI (setting/global/nhúng). Không gửi email, đường dẫn máy hay nội dung workspace — danh tính do server suy từ token đăng nhập avatar. Chưa avatar login thì không gửi gì (không có token). Mọi lỗi gửi chỉ ghi vào Output "Avatar", không hiện popup.

Giới hạn đã biết — khai thẳng

Chỉ nghiệm thu trên macOS. Windows và Linux chưa ai chạy thử; nhánh taskkill, symlink/junction và xdg-open chưa có lượt chạy nào.
Máy chưa cài Node về lý thuyết vẫn chạy được (extension dùng Node của VSCode) nhưng chưa nghiệm thu trên máy trắng.
Không phát hành trên VSCode Marketplace — cài bằng .vsix từ Releases.