Skip to content
| Marketplace
Sign in
Visual Studio Code>Other>AvatarNew to Visual Studio Code? Get it now.
Avatar

Avatar

NAL Vietnam

|
45 installs
| (0) | Free
Avatar cho VSCode — CHỈ dùng được với tài khoản Google @nal.vn. Cập nhật pack/CLI, xem trạng thái workspace, chèn slash command. Không mở Terminal.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

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

  1. Tải avatar-<version>.vsix ở tab Releases.
  2. Trong VSCode: Cmd/Ctrl+Shift+P → Extensions: Install from VSIX… → chọn file vừa tải.
  3. 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

Cuối view "Lệnh Avatar" có nhóm Phiên bản gồm 4 dòng: Pack · CLI (luôn kèm nguồn setting / global / nhúng) · DataHub · AvatarCodi hoặc VS Code. Kênh nào có bản mới thì hiện đang cài → mới nhất và icon màu cảnh báo. Từ 0.7.42 version không còn hiện trên thanh trạng thái.

Khi pack hoặc CLI lệch bản mới nhất:

  • Toast Avatar có bản mới: … (nút Cập nhật ngay) hiện ở activate và mỗi lần cửa sổ lấy lại focus. Cùng cặp version thì nhắc lại sau 24 giờ nếu còn lệch; đổi cặp version thì báo ngay. Mốc nhớ theo từng workspace, không có timer.
  • Icon Avatar ở activity bar có badge số 1 (tooltip nêu các kênh lệch), ở lại tới khi hết lệch.
  • Kiểm hỏng (pack: không lấy được token hoặc get-pack lỗi; CLI không nhúng: npm view lỗi) mà chưa biết có bản mới nào: nhóm Phiên bản ghi không kiểm được bản mới, không popup. Bấm tay Kiểm tra bản mới lúc đó hiện cảnh báo nêu kênh hỏng, không nói "mới nhất". CLI nhúng không có npm là bình thường, không tính là hỏng.

Đã đ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.

Quota claude.ai trên thanh trạng thái

Ba thước 5h · 7d · 7d <model> (vd 7d Fable): đồng hồ cát (cát chảy từ bầu trên xuống bầu dưới theo % đã dùng) rồi con số % đã dùng (khớp panel "Account & Usage" của Claude Code), màu chữ xanh → vàng → đỏ theo phần còn lại; cửa sổ vừa bị 429 thì nền đỏ. 5h và 7d kèm thời gian còn lại tới lúc mở lại (làm tròn xuống) và giờ mở lại; 7d kèm thêm thứ (vd 5h [đồng hồ cát] 21% · Reset in 3h (1:35AM), 7d [đồng hồ cát] 32% · Reset in 4d (Mon 12:00PM)). 7d <model> không kèm vì mở lại cùng mốc với 7d. Bấm vào thước = ↻ hỏi lại ngay.

  • Nguồn chính (mặc định bật): extension đọc token đăng nhập Claude Code của chính bạn (macOS Keychain, hoặc file credentials của Claude Code trên Linux/Windows) và gọi usage endpoint của Anthropic — cùng đường panel Claude Code dùng, không gọi model nên không tốn quota. Token chỉ nằm trong bộ nhớ, không ghi, không log, Avatar không tự gia hạn (hết hạn thì mở Claude Code). Không gọi dày hơn 60 giây; làm mới khi cửa sổ lấy focus, khi transcript của workspace đổi, khi bấm ↻.
  • Ghi chú điều khoản: Anthropic ghi token này dành cho Claude Code và app của Anthropic. Tắt bằng setting avatar.claudeQuota.useClaudeCodeToken nếu bạn không muốn Avatar dùng nó — gate CI G20 giữ dấu chân đọc token trong đúng 3 file và cấm đụng refresh token.
  • Nguồn dự phòng: statusline của Claude Code (hook của pack ghi ~/.avatar/state/claude-rate-limits.json) — chỉ khi chạy claude ở terminal, chỉ có 5h · 7d. Số đo cũ hơn 1 giờ thì bỏ màu; cũ hơn 24 giờ thì hiện Claude — kèm lý do trong tooltip.

Tiến độ Autopilot

Lệnh Avatar: Mở tiến độ Autopilot (palette, nút 🚀 trên view "Trạng thái", hoặc bấm mục 🛫 trên thanh trạng thái) mở tab editor "Autopilot · " cạnh tab chat — kéo thả/tách cửa sổ như mọi tab, reload cửa sổ vẫn còn. Panel chỉ hiển thị, không điều khiển mission (duyệt/dừng vẫn qua chat hoặc CLI):

  • 🙋 Bạn cần làm — gate chờ duyệt, câu decision, escalation, chạm trần chi phí, kèm lệnh CLI tương đương.
  • ① Hành trình — G0 → G1 → Survey → Plan → G2 → Thực thi → Integration/MR → G3 → Release (✅/▶/🙋/⛔/○, tooltip ghi nguồn suy ra trạng thái). Trước init: các bước /avatar:startbuild theo dòng mốc 🧭 Startbuild · <bước> · <nhãn> trong chat.
  • ② Ticket theo slice — agent/skill/playbook, lượt N (run đã xong), lỗi x/y (trần là lỗi được tính), giờ, chi phí, verdict cuối.
  • ③ Đang làm gì — 20 hoạt động gần nhất của lượt đang chạy, đọc từ transcript worker trên máy (tool, đích rút gọn, ✗ khi lỗi, Skill/Agent tô riêng, model); chuỗi giống secret bị che, không gửi gì ra ngoài máy.

Dữ liệu: avatar autopilot status --json (khối progress, CLI ≥ 3.41.0 — CLI cũ hơn chỉ có bảng ticket tối giản) + transcript local. Cập nhật theo sự kiện file (debounce 750 ms, không chồng tiến trình), không poll: không file nào đổi thì không spawn CLI, trừ 1 lần lúc mở cửa sổ và 1 lần mỗi lần focus khi supervisor đang sống (để phát hiện supervisor chết bằng SIGKILL — trong lúc cửa sổ giữ focus liên tục, đồng hồ "hoạt động gần nhất N giây trước" là tín hiệu duy nhất).

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.
  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft