Vnstock Logo

Lịch sử phiên bản

Cộng đồng

Mục lục

13-11-2026

vnstock_mcp (v1.0.0rc4)

Hoàn thiện gói cài đặt 5 nền tảng và chuẩn hóa đầu ra v6

  • Phát hành gói biên dịch sẵn trên cả 5 nền tảng: Xuất bản các bản dựng wheel cho macOS Apple Silicon (arm64), macOS Intel (x86_64), Linux (x86_64 và aarch64) và Windows (x86_64) trên Python 3.10–3.13, hoạt động đồng bộ cùng vnstock 6.0.0, vnstock-oapi 0.1.1 và vnstock_quant 1.0.0.
  • Đồng nhất chuẩn dữ liệu compat="v6": Tự động kích hoạt hồ sơ đầu ra v6 của vnstock 6 trên toàn phiên làm việc (giá cổ phiếu, ETF, chứng quyền ở market_*, reference_* tính theo nghìn VND; chỉ số theo điểm; cột _percent theo điểm phần trăm; thứ tự thời gian tăng dần) và ghi rõ vnstock.compat.use("v6") khi kết xuất kịch bản Python qua research_journal.
  • Thông báo lỗi có cấu trúc và nhận diện bảng nội bộ (builtin): Trả về mã MCP_INVALID_ARGUMENT (kèm danh sách tham số hợp lệ) và MCP_CHOICE_NOT_OPEN (phân biệt rõ trường hợp thiếu khóa nguồn Open API trên máy với quyền hạn tài khoản); ghi nhận rõ nguồn gốc cho các bảng danh mục có sẵn trong vnstock 6 không gọi mạng và gắn ghi chú hướng dẫn chuyển đổi cho các bộ dữ liệu lưu từ bản 0.x trong research_datasets.

06-11-2026

vnstock_mcp (v1.0.0rc1)

Bản thử nghiệm đầu tiên cho thế hệ 6

  • Chạy trên vnstock 6: dữ liệu qua Open API của nguồn, bằng khoá bạn đăng ký ở từng nguồn. Mọi tool dữ liệu nhận source; bỏ trống thì theo quy tắc nguồn bạn đã lưu. Tool dữ liệu hiện theo khoá nguồn trên máy, không theo cấp. Tài liệu: Vnstock MCP v1.
  • Tính toán và chạy thử: thêm quant_backtest (một mã, danh mục, dò tham số, walk-forward, Monte Carlo, Sharpe đã hiệu chỉnh), quant_returns, quant_prices, quant_micro; các bước nối nhau bằng data và refs, đi cùng vnstock_quant 1.0.0rc1.
  • Nghiên cứu: thêm research_sources, research_import (nhập tệp CSV, Excel, Parquet, JSON trên máy), research_pdf, research_bctc, research_vas (báo cáo tài chính dạng PDF); bỏ research_normalize, research_benchmark, research_universe.
  • Dòng lệnh: lệnh onboard, status, doctor, setup, sources, tools, call, workspace, serve và giao diện tương tác khi chạy trong terminal.
  • Kết quả: thêm warnings mang cảnh báo của thư viện; lời gọi lâu báo StillRunning và lần gọi lại chờ đúng phép tính đang chạy.
  • Hạn chế: ở bản rc1 mới có bản dựng cho macOS chip Apple; bản thử nghiệm dùng được 30 ngày. Chuyển từ bản 0.5: hướng dẫn.

12-10-2026

vnstock_mcp (v0.4.0)

Bản đầu tiên có tài liệu

  • Cầu nối chạy cục bộ: Trợ lý AI trên máy bạn khởi chạy tiến trình vnstock-mcp từ môi trường Python cá nhân; không có máy chủ trung gian đứng giữa.
  • Kết nối bằng một lệnh: vnstock-mcp --setup <ứng dụng> in sẵn cấu hình cho Claude Desktop, ChatGPT desktop, Gemini Tasks, Claude Code, Codex, Antigravity, VS Code và Cursor; thêm --write để ghi thẳng vào tệp cấu hình.
  • Mã tham chiếu và mã Python tái lập: Mỗi kết quả lưu trong không gian làm việc cục bộ kèm mã call_id (c1, c2...) và ghi vào nhật ký phiên. research_journal(method="script") xuất các bước đã chạy thành một tệp Python độc lập.
  • Công cụ nghiên cứu: research_normalize chuẩn hoá bảng về cột chuẩn của Vnstock, research_benchmark đối chiếu số liệu, research_universe tra danh mục chỉ tiêu VAS. Các mô-đun vnstock_quant gọi được trên bảng đã chuẩn hoá qua data="c1".
  • Lọc công cụ theo hồ sơ và quyền: Trợ lý AI chỉ thấy công cụ khả dụng với tài khoản và hồ sơ (--profile) bạn chọn.
  • Số công cụ và dùng thử: Bản Cộng đồng mở 29 công cụ (hồ sơ full) hoặc 21 (hồ sơ research), kèm 30 lượt dùng thử định lượng mỗi ngày.