Lịch sử phiên bản
Cập nhật lần cuối:
Thảo luậnMục lục
20-06-2026
Phát hành
vnstock_pipelinephiên bản 2.3.1 cấu trúc lại toàn bộ kiến trúc lưu trữ dữ liệu, giới thiệu file cấu hình tập trungpipeline.tomlvà cải tiến mạnh mẽ CLI hỗ trợ quản trị cơ sở dữ liệu chứng khoán hiệu quả.
⚠️ Thay Đổi Mang Tính Phá Vỡ
- Gỡ bỏ
DuckDBProcessor&FirebaseProcessor: Cấu trúc mới tập trung gom dữ liệu thô lưu trữ định dạng Parquet/CSV hiệu suất cao. Người dùng tự quản lý Data Warehouse (DuckDB/Supabase) theo nhu cầu. Thay đổi này ít tác động tới người dùng vì cách dùng này không được giới thiệu chính thức. - Tự động hoá tham số
base_path: Không cần truyềnbase_pathkhi khởi tạoExportertrong các pipeline tùy biến; đường dẫn sẽ tự động lấy từ cấu hình tập trung. - Công cụ di chuyển dữ liệu cũ: Bổ sung lệnh CLI
python -m vnstock_pipeline.cli storage migrate-legacyhỗ trợ người dùng chuyển đổi kho dữ liệu cũ sang cấu trúc phân lớp tập trung mới một cách an toàn.
✨ Tính Năng Nổi Bật
- Kiến Trúc Lưu Trữ Tập Trung (
pipeline.toml): Quản lý thiết lập đường dẫn (base_path), chế độ lưu mặc định (parquet/csv/excel) và cơ chế ghi đè định dạng (format_overrides) cho từng nhóm dữ liệu ngay tại~/.vnstock/config/pipeline.toml. - Linh Hoạt 2 Chế Độ Phân Cấp Thư Mục:
- Flat Layout (Mặc định): Thân thiện cho người dùng cá nhân (ví dụ:
~/stock_db/ohlcv/ACB.parquet). - Nested Layout: Phân cấp chuẩn mực (
[layer]/[domain]/...), tối ưu cho người dùng chuyên sâu và AI Agent.
- Flat Layout (Mặc định): Thân thiện cho người dùng cá nhân (ví dụ:
- Bảo Vệ An Toàn Cấu Trúc Dữ Liệu: Tự động so sánh dữ liệu mới tải với cấu trúc chuẩn (
Baseline Schema). Cách ly an toàn các file lỗi hoặc thay đổi cấu trúc nghiêm trọng vào.tmp/.quarantine/nhằm bảo vệ CSDL chính. - Xử Lý Lỗi & Khôi Phục Thông Minh: Tự động sinh file
error_log.csvghi nhận mã lỗi do rớt mạng hoặc thiếu dữ liệu. Cung cấp cờ--retry-errorsđể tải bù nhanh những mã thất bại thay vì chạy lại từ đầu. - Công Cụ Quản Trị Bằng Dòng Lệnh (CLI): Cung cấp hàng loạt lệnh mới tiện dụng như kiểm toán CSDL (
storage audit), đổi định dạng (set-format), dọn rác định kỳ (cleanup), trích xuất cấu trúc nhanh (storage preview). - Khởi Tạo Rổ Thanh Khoản (Universe): Lệnh
universe build-liquiditygiúp quét và xếp hạng tính thanh khoản các cổ phiếu qua đa khung thời gian để sinh ra tệp theo dõi lưu mặc định vào cấu hìnhliquidity_auto. - Template Pipeline Tích Hợp Sẵn: Tự động hoá các tác vụ phức tạp như gom 5 bảng báo cáo tài chính vào Multi-sheet Excel, thu thập tin tức chống trùng lặp qua bộ đệm Streaming, và cập nhật sự kiện doanh nghiệp liền mạch.
- Trích Xuất Chuẩn Amibroker: Tích hợp module quét Local Database với DuckDB, xuất cực nhanh toàn bộ dữ liệu ra định dạng
.csvchuẩn tương thích Amibroker bằng một dòng lệnh.
19-05-2026
Cập nhật và sửa lỗi cho vnstock_pipeline phiên bản 2.2.3
- Sửa
ceiling_price: Khắc phục lỗi cột giá trần (ceiling_price) bị gắn sai giá trị các cờ màu sắc (nhưe,d) do nhầm lẫn ánh xạ với trườngca(color_average) từ WebSocket. - Thêm thông tin giá: Tách và trích xuất chính xác giá trị số cho giá trần (
ceiling_actual), giá sàn (floor_price), và giá tham chiếu (reference_price) cho cả cổ phiếu cơ sở và phái sinh. - Sửa
market_idcho Phái sinh: Tự động chuẩn hóa và gán cứng sàn giao dịch thànhHNXcho tất cả dữ liệu hợp đồng tương lai phái sinh (stockps).
18-05-2026
Phiên bản vnstock_pipeline 2.2.2 mang đến nhiều nâng cấp quan trọng giúp bạn xây dựng hệ thống quản lý tải dữ liệu và kết nối dữ liệu thời gian thực hiệu quả và đơn giản hơn bao giờ hết. Các cập nhật mới nhất giúp cải thiện độ tương thích của các thư viện trong hệ sinh thái Vnstock với chuẩn Unified UI mới nhất.
Cảnh báo giao dịch & Dữ liệu thời gian thực
Hệ thống luồng dữ liệu được tối ưu hoá với redis, cung cấp sẵn các kịch bản thường dùng trong giao dịch và theo dõi tín hiệu, giúp bạn:
- Nhận cảnh báo tức thì: Tự động phát hiện các tín hiệu mua/bán (giao cắt MACD, quá mua/bán RSI, đột biến dòng tiền...) và gửi tín hiệu về kênh Discord của bạn qua Webhook.
- Hoạt động bền bỉ 24/7: Thuật toán kết nối mới giúp hệ thống ổn định. Tự động phục hồi ngay lập tức nếu rớt mạng, đảm bảo bạn không bỏ lỡ bất kỳ biến động nào trong giờ giao dịch.
- Mở rộng không giới hạn: Cung cấp sẵn giải pháp giúp bạn chia sẻ luồng dữ liệu real-time từ máy chủ đến nhiều ứng dụng khác (Web, phần mềm riêng) mà không lo quá tải.
Phân tích dữ liệu siêu tốc không cần mở trình soạn thảo
Công cụ dòng lệnh tích hợp mới (vnstock_pipeline) giúp bạn tiết kiệm tối đa thời gian:
- Xem nhanh tổng quan, dung lượng và cấu trúc của bất kỳ tệp dữ liệu chứng khoán nào chỉ với các lệnh CLI đơn giản mà AI Agent có thể sử dụng như một công cụ.
- Lọc, tìm kiếm (ví dụ: lọc các mã có giá > 50) và xem thống kê dữ liệu ngay trên cửa sổ lệnh mà không cần phải khởi động các phần mềm phân tích nặng nề.
Quản lý chất lượng & độ toàn vẹn dữ liệu
- Kiểm định chất lượng tự động: Hệ thống tự động quét, phát hiện và cảnh báo mọi khoảng trống hay lỗi bất thường trước khi lưu trữ.
- Trực quan & Dễ tích hợp: Toàn bộ tên mã chứng khoán và định dạng báo cáo tài chính đều được chuẩn hóa thống nhất, cực kỳ dễ đọc và dễ dàng đưa vào phần mềm riêng của bạn.
29-08-2025
Phát hành phiên bản Vnstock Pipeline 2.0.1 nâng cấp cơ chế tải dữ liệu Intraday và Streaming dữ liệu thời gian thực.
Để cài đặt bản cập nhật, vui lòng chạy lại chương trình cài đặt của Vnstock tại đây.
- Bổ sung tài liệu hướng dẫn tuỳ biến chương trình
- Cải thiện trải nghiệm sử dụng: tuỳ chọn địa điểm lưu file khi streaming, lọc dữ liệu mong muốn thay vì tự lưu toàn bộ.
- Cải thiện khả năng truy cập dữ liệu intraday liên tục trong phiên giao dịch và ghép nối thông minh hơn.
- Bổ sung tính năng Data Manager cho phép quản lý cấu trúc dữ liệu lưu trữ khoa học và chặt chẽ
- Bổ sung khả năng lưu trữ dữ liệu định dạng parquet, nén dữ liệu ~75% so với CSV và tăng hiệu năng xử lý.
Thảo luận