Vnstock Migration Assistant

Khi nâng cấp lên vnstock thế hệ 5, nhiều người dùng bản Mở rộng (vnstock_data 3.x) hoặc bản Cộng đồng (vnstock 3.x/4.x) thường băn khoăn từ ngay bước cài đặt đầu tiên — vì trước kia phải cài qua trình cài riêng (vnstock_installer hoặc vnstock-cli-installer.run) kèm vnai, vnii, còn nay mọi cấp tài khoản đều dùng chung một gói vnstock duy nhất. Bên cạnh đó, những chỗ thay đổi tinh tế về tham số (như độ dài length hay định dạng bảng báo cáo tài chính) cũng có thể làm kết quả trả về khác trước dù mã không báo lỗi cú pháp.

Kỹ năng Trợ lý chuyển đổi mã nguồn (migration-assistant) giúp trợ lý AI rà soát toàn bộ dự án hiện tại của bạn — từ câu lệnh cài đặt, tệp requirements.txt, Dockerfile cho tới từng dòng mã Python — để chỉ ra chính xác những chỗ cần cập nhật và hướng dẫn chuyển đổi từng bước mà không làm hỏng môi trường đang chạy ổn định.

Kỹ năng này giúp gì cho bạn?

• Đơn giản hoá bước cài đặt ban đầu (không còn vnstock_installer): Giải thích rõ và chuyển đổi quy trình cài đặt từ trình cài riêng của dòng cũ (vnstock_installer, vnstock-cli-installer.run, vnai, vnii trên kho /api/simple) sang lệnh pip install -U --extra-index-url https://vnstocks.com/api/packages vnstock kết hợp vnstock register và vnstock install trên thế hệ 5.
• Giữ nguyên môi trường cũ để bạn luôn có mốc đối chiếu: Hướng dẫn tách riêng môi trường ảo cho thế hệ 5 (~/.venv5x) thay vì cài đè lên môi trường cũ (~/.venv), giúp bạn có thể chạy song song hai phiên bản để kiểm tra số liệu trước khi chuyển hẳn.
• Chuyển đổi chuẩn xác cấu hình triển khai máy chủ, Docker và Streamlit Cloud: Tự động rà soát requirements.txt, Dockerfile, docker-compose.yml và script khởi động để bỏ các bước chạy vnstock-cli-installer.run cũ, chuyển sang xác thực không tương tác (vnstock register --stdin hoặc vnstock.login(api_key)), dùng ảnh nền glibc (python:3.12-slim) và gắn named volume cho VNSTOCK_HOME để giữ cố định mã thiết bị của container.
• Đổi cú pháp gọi dữ liệu về một chuẩn thống nhất: Thế hệ 5 hợp nhất cả bản Cộng đồng (vnstock 4.x) và bản Mở rộng (vnstock_data 3.x) vào một thư viện vnstock duy nhất. Kỹ năng giúp trợ lý AI chuyển các dòng lệnh cũ sang các lớp dữ liệu chuẩn (Market, Reference, Fundamental, Macro, Insights, Analytics) mà không phải viết lại logic phân tích của bạn.
• Phát hiện những điểm đổi hành vi dễ gây lệch số liệu: Tự động nhắc và sửa những điểm thay đổi tinh tế như cách truyền khoảng thời gian ("30d", "3M", "1Y" thay vì số nguyên đếm theo nến), tên cột thời gian chuẩn hoá và múi giờ đi kèm.
• Chuyển tiếp mượt mà các thư viện bổ sung: Hướng dẫn đổi từ vnstock_ta sang vnstock_quant (giữ nguyên tên hàm chỉ báo quen thuộc) và nâng cấp cấu hình, thư mục dữ liệu của vnstock_pipeline từ bản 2.x lên 3.x mà không phải tải lại dữ liệu lịch sử đã lưu.
• Chỉ sửa mã khi bạn đồng ý: Trợ lý AI luôn lập bảng liệt kê những tệp và dòng lệnh dự kiến thay đổi để bạn duyệt trước khi áp dụng.

Khi nào bạn nên dùng?

• Khi bạn đang dùng bản Mở rộng (vnstock_data 3.x) hoặc vnstock 4.x và muốn nâng cấp kịch bản Python, Jupyter Notebook hoặc ứng dụng trên máy chủ (Docker, Streamlit Cloud, Linux VM) lên vnstock thế hệ 5.
• Khi các công cụ AI lập trình (như ChatGPT, Claude, Cursor) vẫn quen gợi ý cú pháp vnstock cũ hoặc trình cài vnstock_installer cũ và bạn cần một bộ quy tắc chuẩn để AI cập nhật đúng theo thế hệ 5.

Thông tin kỹ thuật & Tệp đi kèm

• Cấp quyền lợi cần có: Cộng đồng (Free)

Tài liệu tham khảo

• Cài đặt & triển khai trên máy chủ (Streamlit Cloud, Docker, Non-Interactive): https://vnstocks.com/docs/vnstock/cai-dat
• Đăng nhập, dòng lệnh CLI & cài thư viện bổ sung (vnstock install): https://vnstocks.com/docs/vnstock/cau-hinh-va-dong-lenh
• Chuyển từ vnstock_data 3.x (bản Mở rộng): https://vnstocks.com/docs/vnstock/chuyen-doi/tu-vnstock-data-3x
• Chuyển từ vnstock 4.x: https://vnstocks.com/docs/vnstock/chuyen-doi/tu-vnstock-4x
• Nâng cấp vnstock_pipeline từ bản 2.x: https://vnstocks.com/docs/vnstock-pipeline/chuyen-doi/nang-cap-tu-ban-2x

Lịch sử cập nhật

• [1.5.0] - Bổ sung hướng dẫn chuyển đổi bước cài đặt ban đầu (bỏ vnstock_installer / vnstock-cli-installer.run, vnai, vnii) và cấu hình triển khai máy chủ, Docker (VNSTOCK_HOME volume, glibc), Streamlit Cloud sang thế hệ 5.
• [1.4.0] - Bổ sung bảng đối chiếu chi tiết cho vnstock thế hệ 5, xử lý ngoại lệ phân loại (VnstockError, EntitlementError, InputError, NetworkError) và hướng dẫn tách môi trường ảo theo thế hệ.
• [1.2.0] - Viết lại mô tả theo luồng chuyển chính sang thế hệ 5 (vnstock 4.x, vnstock_data 3.x, vnstock_ta, vnstock_pipeline 2.x).
• [1.1.0] - Hợp nhất hướng dẫn chuyển đổi thư viện lõi và vnstock_pipeline vào cùng một kỹ năng.