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.
Bạn đưa vào · đúng dòng bạn thấy
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
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.
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ũ.
01
Lưu khoá truy cập vào máy
Đang tải khoá truy cập của bạn…
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.
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ắcHã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
- 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)
- 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
- 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á
- 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
- 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)
- 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
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 tay02 · Hướng dẫn
Tài liệu hướng dẫn tiếp theo
Tham khảo chi tiết nếu bạn muốn tự tay thao tác từng bước hoặc đang cần giải quyết một mã lỗi cụ thể.
Tự làm từng bước
4 trang- Thế hệ 5
Cài đặt, đăng nhập và nâng cấp
Hướng dẫn cài đặt, kích hoạt khoá truy cập trên máy chủ/notebook và cập nhật phiên bản mới.
- Thế hệ 5
Mã lỗi & Cách khắc phục
Tra cứu mã lỗi chi tiết và tận dụng vnstock doctor để tự động chẩn đoán môi trường.
- Gỡ lỗi
Xử lý lỗi môi trường Python
Khắc phục lỗi externally-managed-environment, xung đột môi trường Windows hay thư viện trên Jupyter/Colab.
- Bản cũ
Duy trì phiên bản 4.x
Hướng dẫn thiết lập môi trường ảo và sử dụng trình cài đặt cho vnstock_data 3.x.
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.