Vnstock Logo

Hướng dẫn người tài trợ

Cài đặt & gỡ lỗi

Hướng dẫn thiết lập trọn bộ Vnstock thế hệ 5 và các thư viện mở rộng theo cấp tài trợ của bạn. Tiện lợi nhất là để trợ lý AI tự động thực hiện; bạn cũng có thể chuyển sang chế độ thủ công nếu muốn tự kiểm soát từng dòng lệnh.

Sổ tra lỗi4 nhóm lỗi

Bạn đưa vào · đúng dòng bạn thấy

error: externally-managed-environment

Sổ tra trả về · 01 mục

Môi trường bị hệ thống khoá

cài bằng Python của môi trường ~/.venv, không cài vào Python hệ thống

Phạm vimacOS · Linux · Windows · Google Colab

01 · Cài đặt

Một lệnh lưu khoá, một lời nhắc

Khoá truy cập được bảo mật ngay trên máy tính của bạn và không bao giờ xuất hiện trong khung chat với trợ lý AI, giúp đảm bảo an toàn tuyệt đối.

Hệ điều hành

Yêu cầu môi trường: Phiên bản Python từ 3.10 trở lên; thư viện cài vào môi trường ảo cố định ~/.venv (Windows: $HOME\.venv). Tải về từ python.org. Lưu ý đối với Windows: tránh sử dụng bản cài từ Microsoft Store để hạn chế xung đột đường dẫn (xem chi tiết tại mục 3.1 của trang gỡ lỗi). Nếu bạn đang duy trì dự án dùng vnstock_data 3.x cũ, vui lòng xem Hướng dẫn cài bản cũ.

Trạng thái tài trợ
  1. 01

    Lưu khoá truy cập vào máy

    Đang tải khoá truy cập của bạn…

  2. 02

    Mở trợ lý AI bạn đang dùng

    Trên máy tính, bản ứng dụng hay trợ lý dòng lệnh đều được.

    Ứng dụng trò chuyện

    • Claude
    • ChatGPT
    • Antigravity

    Chạy lệnh trên máy

    • Claude Code
    • Codex
    • VS Code
    • Antigravity IDE

    Các trợ lý lập trình chuyên dụng (như Cursor, Claude Code, Antigravity) có thể tự động cài đặt thay bạn. Với ứng dụng trò chuyện thông thường, trợ lý sẽ cung cấp từng lệnh chuẩn xác để bạn thực thi.

  3. 03

    Dán lời nhắc vào trợ lý AI

    Trợ lý cho bạn xem từng lệnh và chờ bạn đồng ý rồi mới chạy.

    Lời nhắc
    Hãy giúp tôi thiết lập thư viện Python vnstock thế hệ 5 cùng các gói mở rộng theo cấp tài trợ của tôi trên máy macOS, tuân thủ tài liệu hướng dẫn tại https://vnstocks.com/files/vibe-onboarding.md
    - Trước khi thực hiện bất kỳ lệnh nào, hãy giải thích rõ và chờ tôi xác nhận đồng ý.
    - Cài vào môi trường ảo cố định ~/.venv (tạo mới nếu chưa có), trừ khi tôi yêu cầu chỗ khác; trên Google Colab hay GitHub Codespaces thì cài thẳng vào môi trường của phiên, không tạo môi trường ảo.
    - Trước khi cài, kiểm tra môi trường đó đang có gì. Nếu đã có vnstock 4.x, vnstock_data hoặc vnai, hãy dừng lại và hỏi tôi: cài đè sẽ làm hỏng bản cũ và không khôi phục được. Khi đó hãy đề xuất cài thế hệ 5 vào ~/.venv5x.
    - Khoá truy cập đã được tôi lưu sẵn trên máy an toàn. Bạn tuyệt đối không tìm cách đọc, in hay yêu cầu tôi gửi khoá qua khung chat. Sau khi cài đặt, hãy kiểm tra trạng thái bằng lệnh `vnstock status`; nếu cần đăng nhập lại hãy hướng dẫn tôi tự chạy `vnstock register`. Sau đó cài đặt các gói mở rộng được phép bằng lệnh `vnstock install`.
    - Không tự ý ghi đè hay thay đổi các tệp cấu hình trợ lý AI (AGENTS.md, CLAUDE.md...) nếu chưa có yêu cầu.
    - Khi hoàn tất cài đặt, hãy chạy một truy vấn mẫu lấy thông tin hợp đồng tương lai VN30F1M để kiểm tra tính sẵn sàng, đồng thời gợi ý cho tôi 3 bài toán nghiên cứu đầu tiên để bắt đầu trải nghiệm ngay.

Sau khi bạn dán lời nhắc · Quy trình gồm 6 bước, trợ lý luôn hỏi ý kiến trước mỗi lệnhQuy trình 6 bước tự động

  1. 01

    Nhận diện hệ thống và Python

    tự động kiểm tra phiên bản (yêu cầu từ Python 3.10)

  2. 02

    Cài đặt Vnstock thế hệ 5

    cài đặt nhanh qua pip, không cần phần mềm cài đặt rời

  3. 03

    Xác thực cấp quyền tài trợ

    kiểm tra trạng thái bằng vnstock status, bảo mật tuyệt đối khoá

  4. 04

    Cài đặt thư viện mở rộng

    tự động cài các gói phân quyền tương ứng qua vnstock install

  5. 05

    Cấu hình chỉ dẫn trợ lý AI

    ghi nhớ quy tắc vào tệp cấu hình dự án (mặc định tắt)

  6. 06

    Chạy thử nghiệm & chẩn đoán

    chạy truy vấn thực tế hoặc dùng vnstock doctor nếu cần

  7. Kết quả đạt được

    Toàn bộ thư viện mở rộng theo cấp tài trợ đã sẵn sàng

Nếu gặp sự cố trong quá trình cài đặt, lệnh `vnstock doctor` sẽ giúp bạn chẩn đoán ngay nguyên nhân, hoặc bạn có thể chuyển sang chế độ cài thủ công.

Cách cài bằng tay
Thành viên

Vẫn chưa chạy được?

Kênh hỗ trợ kỹ thuật trực tiếp dành riêng cho người tài trợ. Khi gửi yêu cầu, bạn vui lòng đính kèm thông tin hệ điều hành, phiên bản Python và toàn bộ thông báo lỗi để đội ngũ hỗ trợ nhanh chóng nhất.

Mở kênh hỗ trợ