Vnstock Logo

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.

Máy của bạn
  1. 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. 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ắc
    Hã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

  1. 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ã

  2. 02

    Trình kế hoạch

    Báo cáo điểm thay đổi, chờ bạn duyệt một lần

  3. 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

  4. 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

  5. 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.

  1. 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.

  2. 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.

  3. 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ế.

Ví dụ báo cáo đối chiếu tự động
4 cần xử lý7 thay đổi nhẹ8 khớp hoàn toàntrên 19 lệnh gọi hàm trong dự án
  • Cần xử lýVnstock().stock().quote.history
    Thứ tự dòng đảo chiều — lưu ý nếu mã đang lấy iloc[0]
  • Cần xử lýFinance().balance_sheet
    Tham số dropna đổi thành drop_empty
  • Cần xử lýFinance().ratio
    Chưa có ở thế hệ 6 — chờ bạn chọn phương án
  • Thay đổi nhẹVnstock().stock().quote.history
    Cột time thêm múi giờ; cột volume đổi int64 sang Int64

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ẵnratio()

    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ậtvnstock_ta

    Chuyển sang vnstock_quant 1.0, giữ nguyên tên các hàm chỉ báo.

  • Biểu đồvnstock_ezchart, Plotter

    Dù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ườngScreener, Insights

    Tổ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áAnalytics

    Tí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 BCTCMacro, 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ứcvnstock_news

    Khô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.x

    Nâ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?
Không cần. Dù dự án đang viết cho 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?
Hoàn toàn được. Trợ lý AI vẫn có thể rà soát dự án, lập kế hoạch và cập nhật sẵn mã nguồn cho bạn, chỉ tạm dừng trước bước chạy thử dữ liệu trên thế hệ 6. Sau khi chuẩn bị xong khoá, bạn lưu vào máy bằng lệnh 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?
Không. Lời nhắc trên trang không bao giờ chứa khoá, đồng thời có chỉ dẫn rõ để trợ lý không đọc, không hiển thị và không yêu cầu bạn gửi khoá qua khung trò chuyện. Mọi thao tác nhập khoá hoặc mã xác thực (OTP) đều do bạn tự thực hiện trực tiếp trong cửa sổ Terminal hoặc PowerShell trên máy tính.
Vì sao tôi nên thực hiện chuyển đổi trước ngày 10/11/2026?
Từ ngày 10/11/2026, các thư viện thế hệ 4 (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.
Thành viên

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.

Mở kênh hỗ trợ