Hướng dẫn gói quyền sử dụng
Chuyển dự án sang thế hệ 6
Từ ngày 10/11/2026, các thư viện thế hệ 5, vnstock 4.x và vnstock_data 3.x ngừng xác thực và không thể sử dụng được nữa. Bạn chỉ cần dán một lời nhắc để trợ lý AI tự dò phiên bản đang dùng, đối chiếu kết quả rồi cập nhật mã sang thế hệ 6 trên nhánh riêng.
01 · Chuyển đổi
Chuyển bằng một lời nhắc
Trợ lý AI tự kiểm tra môi trường hiện tại, rà soát mã nguồn và trình kế hoạch để bạn duyệt một lần trước khi sửa.
1
Mở trợ lý AI bạn đang dùng
Mở trợ lý lập trình ngay trong thư mục dự án để trợ lý tự đọc mã nguồn và chạy đối chiếu.
Ứng dụng trò chuyện
Claude, ChatGPT, Antigravity
Chạy lệnh trên máy
Claude Code, Codex, VS Code, Antigravity IDE
Trợ lý lập trình như Claude Code hoặc Antigravity có thể tự chạy các bước cài đặt. Ứng dụng trò chuyện thông thường sẽ đưa từng lệnh để bạn tự chạy.
2
Dán lời nhắc chuyển đổi
Nếu đã mở trợ lý ngay tại thư mục dự án, bạn chỉ cần sao chép lời nhắc bên dưới. Ba ô thông tin là tuỳ chọn; khoá Vnstock có sẵn trên máy sẽ được thế hệ 6 dùng lại.
Lời nhắcHãy giúp tôi chuyển đổi dự án Python đang dùng vnstock sang vnstock thế hệ 6 trên máy macOS. Dự án nằm ở thư mục bạn đang mở. - Tôi chưa rõ dự án đang chạy bằng môi trường Python nào và cài phiên bản vnstock nào: hãy tự động kiểm tra (Python hệ thống, ~/.venv, môi trường ảo trong dự án, conda, kernel Jupyter) và cho tôi biết căn cứ xác định. - Trước khi thực hiện bất kỳ thao tác nào, hãy đọc kỹ skill chuyển đổi chính thức của Vnstock và làm đúng theo mục "START HERE": https://vnstocks.com/api/skills/migration-assistant/content, cùng quy trình đối chiếu tại https://vnstocks.com/api/skills/migration-assistant/reference/contract-check.md. Các script kiểm tra và đối chiếu tải tại https://vnstocks.com/api/skills/migration-assistant/script/<tên script> (đọc nội dung trước khi chạy). Chỉ nạp thêm skill pipeline-cli nếu dự án có dùng vnstock_pipeline, và vnstock-bootstrap nếu gặp vướng mắc về cài đặt hoặc môi trường. Tất cả các đường dẫn này đều đọc được trực tiếp mà không cần cài đặt trước. - Thực hiện tuần tự các bước: kiểm tra môi trường và lập báo cáo rà soát (môi trường dự án đang chạy, gói quyền sử dụng của tôi qua vnstock status, các thư viện và lệnh gọi vnstock trong mã nguồn) → báo cáo những điểm thay đổi khi lên thế hệ 6 (lớp, hàm, tham số, cột, kiểu dữ liệu, thư viện ngừng hỗ trợ, phạm vi gói của tôi mở được) kèm kế hoạch thực hiện → chờ tôi duyệt một lần → sao chép mã sang thư mục tạm vnstock-migration và chạy lưu dữ liệu mốc bằng môi trường cũ → cài thế hệ 6 vào môi trường riêng → chạy cùng tập lệnh gọi trên cả hai môi trường để đối chiếu từng cột, kiểu dữ liệu, đơn vị, múi giờ, thứ tự dòng và giá trị → chỉnh sửa trên bản sao cho tới khi xử lý hết các điểm không tương thích → áp dụng vào dự án trên nhánh Git riêng và gửi báo cáo tổng kết. - Trước khi tôi duyệt kế hoạch: không cài đặt gói mới, không chỉnh sửa bất kỳ tệp nào của dự án; chỉ được thêm vnstock-migration/ vào .gitignore, tạo thư mục đó và chạy các script kiểm tra ở chế độ chỉ đọc. - Sau khi tôi duyệt, hãy thực hiện trọn kế hoạch mà không hỏi lại từng lệnh, rồi báo kết quả ngắn gọn. Chỉ dừng lại hỏi khi gặp việc ngoài kế hoạch, lỗi cần đổi cách làm, hoặc lệnh có thể làm mất dữ liệu của tôi. - Từ ngày 10/11/2026, các thư viện bản cũ ngừng xác thực và không thể sử dụng được nữa. Vì vậy dữ liệu mốc chỉ lưu được trước ngày 10/11/2026 khi bản cũ còn chạy được: hãy thực hiện bước này đầu tiên ngay sau khi tôi duyệt kế hoạch. - Ưu tiên giữ tính tương thích: giữ cấu hình cột chuẩn v5 trong quá trình chuyển đổi và chỉnh sửa tối thiểu để luồng phân tích hiện tại giữ nguyên kết quả; mọi điểm thay đổi gây lỗi phải được xử lý hoặc được tôi xác nhận phương án. - Tôi chưa chuẩn bị khoá ở nguồn dữ liệu nào: hãy cứ hoàn thành báo cáo rà soát, kế hoạch và cập nhật mã nguồn với vị trí khai báo nguồn tập trung, tạm dừng trước bước chạy thử trên thế hệ 6 và hướng dẫn tôi trang đăng ký khoá. Không tự chọn nguồn thay tôi. - Máy này đã lưu sẵn khoá tài khoản Vnstock từ phiên bản trước và thế hệ 6 sẽ tự động dùng lại. Hãy kiểm tra bằng lệnh vnstock status trong môi trường thế hệ 6; chỉ khi chưa nhận diện được gói mới hướng dẫn tôi tự chạy vnstock login. - Khoá tài khoản Vnstock và khoá nguồn dữ liệu là thông tin bảo mật của tôi: tuyệt đối không đọc, không hiển thị và không yêu cầu tôi gửi qua khung chat. Các lệnh cần nhập khoá hoặc mã OTP phải để tôi tự chạy trong Terminal/PowerShell. - Không tắt hoặc bỏ qua cảnh báo SchemaChangeWarning và không tự ý viết hàm thay thế cho tính năng đã ngừng. Báo cáo tổng kết cuối cùng gồm: kết quả rà soát môi trường, tóm tắt đối chiếu và cách xử lý từng điểm thay đổi, các mục chưa có tương đương, danh sách tệp đã cập nhật và lệnh chạy dự án mới. - Cập nhật khối hướng dẫn vnstock cũ trong tệp AGENTS.md của dự án sang khối thế hệ 6 (mục G9 tại https://vnstocks.com/files/vibe-onboarding.md), kèm nội dung dự kiến để tôi xem khi duyệt kế hoạch. Nếu thấy tệp hướng dẫn nằm ngoài thư mục dự án, chỉ liệt kê để tôi biết chứ không tự ý sửa.
Chuyển đổi trên máy tính mới chưa từng cài Vnstock?Lấy lệnh lưu khoá
Đăng nhập để lấy lệnh lưu khoá cho máy mới.
Trợ lý sẽ làm
5 bước · duyệt kế hoạch một lần
- 01
Rà soát hiện trạng
Phiên bản đang cài, gói quyền sử dụng và các hàm trong mã
- 02
Trình kế hoạch
Báo cáo điểm thay đổi, chờ bạn duyệt một lần
- 03
Tạo bản sao & lưu mốc
Giữ nguyên mã gốc, lưu kết quả từ bản đang dùng
- 04
Đối chiếu hai bản
Chạy cùng lệnh gọi, so sánh từng cột và kiểu dữ liệu
- 05
Áp dụng vào nhánh riêng
Sửa trên bản sao tới khi khớp, rồi đưa vào nhánh Git
Đích đến: Dự án chạy trên thế hệ 6 kèm báo cáo đối chiếu chi tiết
02 · Cơ chế an toàn
Sửa trên bản sao, đối chiếu trước khi áp dụng
Trợ lý không sửa thẳng vào mã đang chạy mà làm việc trên bản sao riêng, chạy thử cả hai phiên bản để đo từng điểm khác biệt.
- 01
Giữ nguyên mã gốc của dự án
Mọi chỉnh sửa diễn ra trên bản sao trong thư mục vnstock-migration. Dự án chính chỉ cập nhật ở bước cuối trên nhánh Git riêng, sau khi đối chiếu đã khớp.
- 02
Đối chiếu bằng dữ liệu chạy thật
Khi chuyển đổi trước ngày 10/11/2026 (lúc bản cũ còn sử dụng được), cùng một tập lệnh gọi hàm được chạy ở cả hai phiên bản để so sánh từng tham số, tên cột, kiểu dữ liệu, đơn vị và giá trị. Sau mốc này, bản cũ ngừng xác thực và không còn chạy được nên trợ lý đối chiếu qua tệp kết quả đã lưu sẵn.
- 03
Báo trước phần cần bạn quyết định
Hàm hoặc thư viện chưa có ở thế hệ 6 được liệt kê kèm phương án ngay trong báo cáo đầu tiên để bạn chọn. Trợ lý không tự ý viết hàm thay thế.
- Cần xử lýThứ tự dòng đảo chiều — lưu ý nếu mã đang lấy iloc[0]
Vnstock().stock().quote.history - Cần xử lýTham số dropna đổi thành drop_empty
Finance().balance_sheet - Cần xử lýChưa có ở thế hệ 6 — chờ bạn chọn phương án
Finance().ratio - Thay đổi nhẹCột time thêm múi giờ; cột volume đổi int64 sang Int64
Vnstock().stock().quote.history
03 · Lưu ý chuyển đổi
Những phần đổi cách dùng ở thế hệ 6
Nếu dự án có dùng các mục bên cạnh, trợ lý sẽ liệt kê ngay trong báo cáo đầu tiên để bạn chọn hướng xử lý trước khi sửa mã.
- Bảng chỉ số tài chính tính sẵn
ratio()Tính bằng vnstock_quant.fa từ ba báo cáo tài chính (52/55 mã chỉ số giữ nguyên tên).
- Phân tích & chỉ báo kỹ thuật
vnstock_taChuyển sang vnstock_quant 1.0, giữ nguyên tên các hàm chỉ báo.
- Biểu đồ
vnstock_ezchart, PlotterDùng vnstock_chart: đổi import, giữ tên hàm. Chỉ tự vẽ bằng matplotlib hay seaborn khi cần tuỳ biến mà vnstock_chart chưa có.
- Sàng lọc & thống kê thị trường
Screener, InsightsTổng hợp từ dữ liệu giá lịch sử (OHLCV) của danh sách mã bạn theo dõi, hoặc tạm lược bỏ.
- Chỉ số định giá
AnalyticsTính qua vnstock_quant.fa kết hợp với giá và khối lượng cổ phiếu lưu hành bạn truyền vào.
- Vĩ mô, giá vàng, thuyết minh BCTC
Macro, Retail, note(), filing()Chưa hỗ trợ ở thế hệ 6. Tách riêng các lệnh gọi này để phần còn lại của dự án chạy bình thường.
- Theo dõi tin tức
vnstock_newsKhông phát hành bản thế hệ 6. Tách riêng phần đọc tin khỏi luồng phân tích chính.
- Tải và lưu dữ liệu theo lô
vnstock_pipeline 2.x, 3.xNâng cấp lên vnstock-pipeline 4.0 (từ cấp Golden); chuyển dữ liệu cũ bằng lệnh migrate-legacy.
04 · Hỏi đáp
Câu hỏi thường gặp
Những điều thường gặp trước và trong khi chuyển đổi dự án.
Chưa thấy câu trả lời bạn cần?
Mở kênh hỗ trợTôi đang dùng bản 4.x hoặc vnstock_data 3.x thì có cần nâng cấp qua thế hệ 5 trước không?
vnstock 4.x, vnstock_data 3.x hay thế hệ 5, trợ lý AI đều hỗ trợ chuyển thẳng lên thế hệ 6. Nếu dự án đã ở thế hệ 5, việc chuyển đổi càng nhẹ nhàng hơn: bạn chỉ cần khai báo nguồn dữ liệu một lần và lược bỏ một vài tham số hoặc cột không còn sử dụng.Chưa có khoá kết nối (Open API) từ nguồn dữ liệu thì tôi có bắt đầu chuyển đổi được không?
vnstock keys set <nguồn> rồi nhờ trợ lý chạy nốt bước đối chiếu. Xem danh sách nguồn hỗ trợ và hướng dẫn lấy khoá tại tài liệu kết nối Open API (lưu ý: gói quyền sử dụng Vnstock không bao gồm tài khoản hay khoá tại nguồn dữ liệu).Trợ lý AI có đọc được khoá truy cập của tôi không?
Vì sao tôi nên thực hiện chuyển đổi trước ngày 10/11/2026?
vnstock 4.x, vnstock_data 3.x) và thế hệ 5 ngừng xác thực — đồng nghĩa với việc không thể sử dụng được nữa và mã nguồn gọi bản cũ sẽ dừng hoạt động. Chuyển đổi trước mốc này giúp dự án của bạn không bị gián đoạn, đồng thời trợ lý AI còn chạy được bản cũ để lấy số liệu mốc đối chiếu trực tiếp với thế hệ 6. Nếu thực hiện sau ngày 10/11/2026, bạn vẫn chuyển được mã sang thế hệ 6 để dự án chạy lại, nhưng chỉ đối chiếu được với các tệp kết quả đã lưu sẵn từ trước.Cần hỗ trợ thêm khi chuyển đổi?
Gửi kèm báo cáo tổng kết của trợ lý AI và nguyên văn thông báo lỗi để được kiểm tra, hỗ trợ nhanh nhất.
