Vnstock Logo

Mức độ hoàn thiện và lưu ý vận hành

Cộng đồngvnstock_mcp v1.0.0

Mục lục

Trang này cho biết các tính năng bản Cộng đồng của 1.0.0 đã có hay đang thử nghiệm, và cần điều kiện gì để dùng. Bản này chạy cùng vnstock 6.0, vnstock-oapi 0.1 và vnstock_quant 1.0.

  • Có: đã có trong bản phát hành, dùng được khi đủ điều kiện ở cột bên cạnh.
  • Thử nghiệm: đã có nhưng còn mang nhãn thử nghiệm; cách gọi hoặc cấu trúc kết quả có thể còn đổi ở các bản sau.
  • Chưa có: chưa mở trong bản này.

Các công cụ quant_* theo mức ổn định của nhóm hàm tương ứng trong vnstock_quant 1.0 bản Cộng đồng: chỉ báo kỹ thuật đã ổn định, các nhóm còn lại đang thử nghiệm.

1. Bảng mức hoàn thiện

Tính năngMứcĐiều kiện dùng và ghi chú
Bản dựng sẵnCómacOS Apple Silicon (arm64), macOS Intel (x86_64), Linux (x86_64, aarch64), Windows (x86_64), Python 3.10–3.13.
Nạp bảng dữ liệu riêng (research_import)CóKhông cần khóa nguồn. Đọc CSV có số và ngày viết kiểu Việt Nam, nối thẳng sang quant_ta, quant_backtest.
Nhật ký phiên và kịch bản Python (research_journal, research_save, research_datasets)CóKhông cần khóa nguồn. Kịch bản xuất ra tự chèn vnstock.compat.use("v6").
BCTC PDF (research_pdf, research_bctc, research_vas)CóCần vnstock-mcp[pdf]. Từ điển VAS ở bản Cộng đồng chỉ gồm chỉ tiêu cấp 1 của ba báo cáo chính, không có thuyết minh.
Chỉ báo kỹ thuật (quant_ta)Có10 chỉ báo, trong lượt dùng thử của ngày.
Chỉ số tài chính (quant_fa)Thử nghiệm10 chỉ số, tối đa 3 mã mỗi lần, trong lượt dùng thử. Cần khóa của nguồn hỗ trợ BCTC; nhóm định giá báo MISSING_MARKET nếu chưa bật estimate_shares=true.
Chạy thử chiến lược một mã (quant_backtest: run_backtest, eval_rule_dsl, detect_limit_events, deflated_sharpe_ratio)Thử nghiệmBảng quy tắc dsl dùng 10 chỉ báo của quant_ta; số lần chạy trong ngày có giới hạn, đếm riêng.
Tài sản mã hóa (market_crypto)CóKhông cần khóa; hiện ở hồ sơ full hoặc data.
Lịch sử giá, khớp lệnh và các tuyến dữ liệu khác (reference_*, market_*, macro_*, retail_metal)CóTừng công cụ và method chỉ hiện khi nguồn bạn đã lưu khóa hỗ trợ tuyến đó. Đầu ra theo chuẩn compat="v6".
Báo cáo tài chính (fundamental_equity)Thử nghiệmvnstock 6 còn đánh dấu BCTC ở mức thử nghiệm. Cần khóa của nguồn hỗ trợ BCTC; ở bản Cộng đồng trả các chỉ tiêu cấp 1 rút gọn.
Bảo vệ khóa nguồnCóKhóa không xuất hiện ở đầu ra dòng lệnh, hướng dẫn hệ thống, kết quả JSON, thông báo lỗi, nhật ký hay tệp lưu ra đĩa.
Trình cài --setup cho 8 ứng dụng AI và chế độ HTTP nội bộCóTạo cấu hình và sao lưu tệp cũ (.bak) trước khi ghi.
Các tầng insights, analytics và Tin tứcChưa cóCác công cụ này được ẩn khỏi danh sách trong bản này.

2. Lưu ý khi vận hành

  1. Lưu khóa vào kho khóa thay vì tệp .env: ứng dụng AI khởi chạy máy chủ từ thư mục của chính nó, nên khóa trong .env của dự án thường không được nhận. Dùng vnstock keys set <nguồn> (xem Lưu khóa nguồn).
  2. Thời hạn bản phát hành: bản chính thức 1.0.0 dùng được 365 ngày, bản thử nghiệm (rc) 30 ngày kể từ ngày đóng gói. Thấy lời nhắc trong kết quả thì cập nhật lên bản mới nhất.
  3. Lượt dùng thử định lượng làm mới lúc 00:00 giờ Việt Nam: tính nhiều chỉ báo trên cùng một mã thì lấy bảng giá một lần rồi truyền data="c1"; xem lượt còn lại bằng quant_entitlement.
  4. Lời gọi có thể quá 60 giây: gặp StillRunning, trợ lý gọi lại với đúng bộ tham số vừa dùng; máy chủ chờ chính tác vụ đang chạy mà không gửi thêm yêu cầu tới nguồn.
  5. Giới hạn tần suất do nguồn đặt: tải BCTC nhiều mã liên tiếp có thể bị nguồn tạm từ chối. Đợi một lúc rồi gọi lại, và tải từng mã thay vì cả rổ.