Mức độ hoàn thiện và lưu ý vận hành
Cộng đồngBản Cộng đồngvnstock_mcp v1.0.0Cập nhật
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ăng | Mức | Điều kiện dùng và ghi chú |
|---|---|---|
| Bản dựng sẵn | Có | 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ệm | 10 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ệm | Bả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ệm | vnstock 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ồn | Có | 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ức | Chư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
- 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.envcủa dự án thường không được nhận. Dùngvnstock keys set <nguồn>(xem Lưu khóa nguồn). - Thời hạn bản phát hành: bản chính thức
1.0.0dù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. - 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ằngquant_entitlement. - 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. - 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ổ.
