Vnstock Migration Assistant

Người dùng Vnstock đang ở một trong hai chỗ: vnstock 4.x cùng bản Mở rộng vnstock_data 3.x và các gói đi kèm, hoặc vnstock thế hệ 5 cùng các thư viện của nó; có dự án trộn cả hai. Thế hệ 4 và 5 ngừng hoạt động từ ngày 10/11/2026, nên mọi dự án đều cần chuyển sang thế hệ 6, và mỗi điểm xuất phát có những chỗ thay đổi riêng.

Kỹ năng Trợ lý chuyển đổi (migration-assistant) cho trợ lý AI một quy trình cố định: tự dò máy và dự án để lập bảng khám, trình bày kế hoạch để bạn duyệt một lần, chép mã sang một thư mục con, cài thế hệ 6 ở môi trường riêng, chạy cùng các lời gọi ở cả hai môi trường để đo khác biệt, rồi mới sửa và áp lại vào dự án.

Cách dùng nhanh nhất: lấy lời nhắc dựng sẵn ở trang Chuyển đổi sang thế hệ 6 và dán vào trợ lý AI.

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

• Bảng khám ban đầu. Trợ lý tự tìm mọi môi trường Python có vnstock trên máy (toàn máy, ~/.venv, môi trường ảo trong dự án, conda, kernel Jupyter), xác định dự án chạy ở đâu, gói quyền sử dụng của bạn mở những thư viện nào, và mã đang gọi những lớp, hàm, tham số nào. Bạn chỉ cần chỉ thư mục dự án.
• Đi thẳng lên thế hệ 6. Từng tệp được xử lý theo thế hệ mà nó được viết, kể cả khi dự án trộn lẫn; không phải cài thế hệ 5 làm bước trung gian.
• Đối chiếu đến từng cột. Bốn script đi kèm chạy cùng một bộ lời gọi ở môi trường cũ và thế hệ 6, rồi xếp từng khác biệt theo mức: tham số không còn nhận, cột mất, kiểu dữ liệu, đơn vị, múi giờ, thứ tự dòng, giá trị nhãn, con số trên cùng ngày.
• Mã gốc không bị đụng tới cho đến cuối. Mọi chỉnh sửa diễn ra trên bản sao trong thư mục vnstock-migration/; chỉ khi đối chiếu sạch mới áp lại vào dự án trên một nhánh Git riêng.
• Giữ mốc đối chiếu. Trước ngày 10/11/2026, trợ lý chạy mã cũ và lưu kết quả mẫu, để sau khi chuyển có thứ so sánh.
• Một chỗ khai báo nguồn. Thế hệ 6 đọc dữ liệu bằng khoá của chính bạn ở nguồn bạn chọn. Trợ lý hỏi bạn dùng nguồn nào, đặt nguồn ở một chỗ duy nhất trong mã và không bao giờ đọc khoá của bạn.
• Những gì thế hệ 6 chưa có. Bảng chỉ số tính sẵn, bộ lọc cổ phiếu, số liệu vĩ mô, vnstock_news… được liệt kê riêng kèm các phương án (ví dụ tự tính chỉ số bằng vnstock_quant), để bạn quyết từng mục.
• Dọn hướng dẫn cũ. Khối hướng dẫn thế hệ cũ trong AGENTS.md, CLAUDE.md khiến trợ lý tiếp tục viết theo cú pháp cũ; trợ lý chỉ ra và thay khi bạn đồng ý.

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

• Khi bạn có mã, Notebook hoặc ứng dụng đang chạy với vnstock 4.x và vnstock_data 3.x, hoặc với vnstock thế hệ 5.
• Khi mã báo VNSTOCK_INPUT_SOURCE, VNSTOCK_ROUTE_UNSUPPORTED, SchemaChangeWarning, hoặc No module named vnstock_data sau khi cài thế hệ 6.
• Khi trợ lý AI cứ gợi ý cú pháp cũ như Vnstock().stock(...) hay trình cài vnstock_installer.

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

• Cấp quyền lợi cần có: Cộng đồng (miễn phí), đọc được cả khi máy chưa cài thư viện.

Tài liệu tham khảo

• Trang chuyển đổi và lời nhắc dựng sẵn: https://vnstocks.com/onboard-member/migration
• Chuyển mã từ thế hệ 5 và thế hệ 4: https://vnstocks.com/docs/vnstock/v6/chuyen-doi/tu-the-he-5
• Cài đặt thế hệ 6 và khoá nguồn: https://vnstocks.com/docs/vnstock/v6/cai-dat
• vnstock_quant từ bản 0.5: https://vnstocks.com/docs/vnstock_quant/v1/chuyen-doi/tu-ban-0-5
• vnstock-pipeline từ bản 3.x: https://vnstocks.com/docs/vnstock-pipeline/v6/chuyen-doi/tu-ban-3x

Lịch sử cập nhật

• [3.0.0] - Quy trình chung sang thế hệ 6 bắt đầu bằng bảng khám; bốn script dò môi trường, quét lời gọi và đối chiếu hai môi trường; sửa trên bản sao; đường thẳng từ dòng cũ lên thế hệ 6; dọn hướng dẫn trợ lý AI cũ.
• [1.5.0] - Bổ sung hướng dẫn chuyển đổi bước cài đặt ban đầu và cấu hình triển khai máy chủ, Docker, 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 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.
• [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.