Bỏ qua tới nội dung
Ông T.vn

tick-stock-panel (TSP): bàn làm việc định lượng cổ phiếu A tự host — hướng dẫn cài đặt và dùng

12 phút đọcCập nhật
tick-stock-panel (TSP): bàn làm việc định lượng cổ phiếu A tự host — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

tick-stock-panel (TSP) là một ứng dụng web tự host dành cho định lượng cổ phiếu A Trung Quốc: viết chiến lược, quét thị trường, backtest, giám sát dị động và hỏi đáp bằng AI. Repo có Dockerfile và docker-compose.yml nên chạy được bằng một container, không cần cài cơ sở dữ liệu ngoài. Giao diện và tài liệu chủ yếu bằng tiếng Trung, nên người mới sẽ hơi vất vả ở bước đọc hướng dẫn.

tick-stock-panel (gọi tắt là TSP) là một ứng dụng web chạy trên máy của bạn, dùng để làm định lượng cổ phiếu A Trung Quốc: tự viết chiến lược, quét cả thị trường, backtest, theo dõi dị động và hỏi AI về dữ liệu. Tác giả mô tả nó là "tự host, không cần vận hành", vì mọi dữ liệu nằm ngay trong một container Docker, không cần cài thêm cơ sở dữ liệu nào.

Vấn đề nó giải quyết khá quen với ai từng tự làm quant bằng script rời rạc. Mỗi thứ một công cụ: kéo dữ liệu một nơi, backtest một nơi, theo dõi một nơi, rồi kết quả lệch nhau. TSP gom tất cả vào một dòng chảy chung: chiến lược, backtest, giám sát, rồi tổng kết cuối phiên đều dùng cùng một bộ dữ liệu.

Bạn nên đọc bài này nếu bạn là lập trình viên mới, người làm dữ liệu hoặc người đầu tư cá nhân muốn có một "phòng thí nghiệm" chiến lược chạy cục bộ. Điểm đáng giá nhất là kiến trúc mở: nguồn dữ liệu cắm thêm được, có API kèm token phân quyền và MCP server để nối với các AI client. Hiện repo có khoảng 7.700 sao và khoảng 1.900 fork, giấy phép MIT.

Một lưu ý quan trọng ngay từ đầu: tác giả nói rõ đây không phải phần mềm đầu tư hay xem bảng giá. Repo không đối thủ với các phần mềm xem giá thương mại và cũng không có tính năng "AI gợi ý mua" hay "dự đoán tăng trần". Nó chỉ dành cho học tập và nghiên cứu.

Ứng dụng

shy3130/tick-stock-panel

Bàn làm việc định lượng cổ phiếu A tự host bằng Docker: tự viết chiến lược, quét toàn thị trường, backtest, giám sát và hỏi AI, dữ liệu lưu ngay trên máy bạn.

★ 7.7kPythonMIT
Xem repo trên GitHub

I.TSP làm được gì

Dưới đây là các nhóm tính năng chính, mình giải thích theo lợi ích thực tế thay vì chép lại bảng của README.

A.Nghiên cứu dữ liệu và chiến lược

  • Định tuyến theo năng lực nguồn dữ liệu. Có 6 loại bộ dữ liệu, mỗi loại đi theo nguồn nào hỗ trợ nó. Bạn đổi nguồn mà chỉ số và kết quả backtest vẫn tính theo cùng một quy ước. Nhờ vậy bạn không phải viết lại code kéo dữ liệu mỗi lần đổi nhà cung cấp.
  • Luồng chỉ số. Hệ thống chỉ lưu 15 cột dữ liệu cơ bản và tính ra 68 cột chỉ số, tín hiệu khi cần, rồi ghi vào file Parquet. Cách này tiết kiệm dung lượng và giữ mọi chỗ dùng chung một nguồn.
  • Công cụ chiến lược. Bạn tự định nghĩa chiến lược, tín hiệu riêng, hoặc nhờ AI sinh chiến lược. README cho biết việc quét toàn bộ thị trường chỉ mất mức mili-giây.
  • Backtest. Có backtest theo nhân tố, theo chiến lược và theo phút, có tính quy tắc T+1, phí giao dịch và trượt giá. README cho biết backtest chạy trong tiến trình con riêng, nên đóng tab hay tải lại trang cũng không mất tác vụ.
  • Nền tảng nhân tố và khai thác nhân tố. Bạn tự định nghĩa nhân tố bằng DSL (ngôn ngữ mô tả riêng của repo), kiểm định và tìm tổ hợp ngoài mẫu.

B.Quan sát thị trường và giám sát

  • Môi trường thị trường: chu kỳ tâm lý 6 giai đoạn, xếp hạng chủ đề và ngành.
  • Giám sát dị động: dị động lúc đấu giá, trong phiên và lệch so với chuẩn, gói trong một trang.
  • Trung tâm giám sát: bốn loại quy tắc kết hợp AND/OR, có thông báo bằng giọng nói và đẩy tin sang Feishu (Lark).
  • Phân tích cổ phiếu: 9 loại mức giá then chốt và phân tích AI theo bốn chiều.
  • Bậc thang nhiều phiên tăng liên tiếp và tổng kết cuối phiên bằng AI.

C.Mở rộng và kết nối

  • API mở. Token có 6 mức quyền (đọc thị trường, đọc dữ liệu mở rộng, ghi dữ liệu mở rộng, đọc phân tích, chạy backtest, giao dịch giả lập). README nói có 65 điểm cuối API.
  • MCP server. 12 công cụ để đưa khả năng của bảng điều khiển cho một AI client bất kỳ.
  • Trợ lý hội thoại AI. Bạn hỏi bằng một câu, trợ lý đi lấy dữ liệu, mỗi bước lấy đều hiện ra để bạn kiểm tra lại.
  • Trang mở rộng và plugin trang. 11 trang chính thức thực ra là các phần mở rộng một file; xoá thư mục là gỡ, chép thư mục là nhập.

II.Cần chuẩn bị gì

Theo tư liệu, những thứ bạn cần biết như sau:

  • Docker. Repo có Dockerfile và docker-compose.yml, README mô tả là "một container, không cần cơ sở dữ liệu ngoài". Đây là đường cài dễ nhất cho người mới.
  • Python 3.11 trở lên và Node 20 trở lên. README ghi hai phiên bản này cho phần backend và frontend. Bạn chỉ cần đến chúng nếu chạy bản phát triển thay vì Docker. Repo có sẵn dev.sh và dev.ps1 cho việc này.
  • API key của TickFlow (không bắt buộc, tuỳ nguồn dữ liệu bạn chọn). Trong file mẫu .env.example có biến TICKFLOW_API_KEY. README liệt kê TickFlow, fuyao (REST của Tonghuashun) và TdxQuant (lượng hoá của Tongdaxin) là các nguồn dữ liệu. Bạn cần đọc tài liệu repo để biết nguồn nào cần tài khoản.
  • Khoá AI (không bắt buộc). Phần AI cần một dịch vụ tương thích OpenAI, vì trợ lý hội thoại dùng tính năng gọi công cụ. README nêu DeepSeek, Tongyi, Ollama làm ví dụ. File mẫu có các biến AI_PROVIDER, AI_BASE_URL, AI_API_KEY, AI_MODEL và AI_DAILY_TOKEN_BUDGET.
  • Phần cứng: README không nêu yêu cầu cụ thể về GPU hay RAM. Chỉ thấy nói bản dựng có hai nhân CPU (cũ và mới) tự dò khi chạy.
  • Đọc được tiếng Trung hoặc dùng công cụ dịch. README và các tài liệu như 操作说明书.md (sổ tay thao tác) đều bằng tiếng Trung.

TSP là công cụ nghiên cứu, không phải lời khuyên đầu tư. Hãy coi API key (dữ liệu và AI) như mật khẩu: chỉ điền vào file .env trên máy bạn, không đưa lên GitHub hay gửi cho người khác. Dịch vụ AI tính phí theo lượng dùng, nên đặt hạn mức với biến AI_DAILY_TOKEN_BUDGET.

III.Cài đặt từng bước

Phần README mình được xem chưa trích đoạn hướng dẫn cài đặt; mục "Quick Start" nằm ở phần cắt. Vì vậy các lệnh dưới đây chỉ gồm các lệnh phổ thông (tải mã nguồn, vào thư mục, chép file mẫu, chạy Docker Compose). Trước khi chạy, bạn hãy mở README gốc, thư mục docs/ và file 操作说明书.md để đối chiếu.

  1. Cài DockerCài Docker Desktop (Windows/macOS) hoặc Docker Engine
  2. Tải mã nguồnClone repo về máy rồi vào thư mục
  3. Tạo file cấu hìnhChép .env.example thành .env và điền khoá
  4. Khởi chạyDùng docker-compose.yml có sẵn trong repo
  5. Mở giao diệnTruy cập địa chỉ HOST:PORT theo cấu hình

A.Cài Docker

Bạn cài Docker Desktop nếu dùng Windows hoặc macOS, hoặc Docker Engine trên Linux. Sau khi cài, hãy mở Docker lên và chờ nó báo đang chạy. Nếu Docker chưa chạy, các lệnh ở bước sau sẽ báo lỗi kết nối.

B.Tải mã nguồn

Mở terminal (PowerShell trên Windows, Terminal trên macOS/Linux). Bạn cần đã cài Git.

Terminal
git clone https://github.com/shy3130/tick-stock-panel.git
cd tick-stock-panel

Lệnh đầu tải toàn bộ repo về một thư mục mới. Lệnh thứ hai đưa terminal vào thư mục đó. Người mới hay quên bước cd, rồi chạy các lệnh sau ở sai thư mục.

C.Tạo file cấu hình

Repo có file mẫu .env.example. Bạn chép nó thành .env, rồi mở bằng một trình soạn thảo để điền.

Terminal
cp .env.example .env

Trên PowerShell, bạn dùng Copy-Item .env.example .env. Trong file mẫu có các biến: TICKFLOW_API_KEY, AI_PROVIDER, AI_BASE_URL, AI_API_KEY, AI_MODEL, AI_DAILY_TOKEN_BUDGET, HOST, PORT, LOG_LEVEL, AUTH_PASSWORD, BACKEND_EXTRAS, DATA_DIR. Mình chỉ biết tên biến, README phần mình đọc không giải thích giá trị. Vì vậy hãy đọc chú thích trong chính file .env.example trước khi điền. Đừng chép giá trị lung tung.

Hai chỗ đáng để ý: AUTH_PASSWORD có vẻ là mật khẩu đăng nhập bảng điều khiển (README nói bảng điều khiển dùng phiên đăng nhập bằng mật khẩu), và DATA_DIR là nơi lưu dữ liệu. Đây là suy đoán từ tên biến, bạn nhớ kiểm tra lại trong tài liệu.

D.Khởi chạy

Repo có sẵn docker-compose.yml. Lệnh Docker Compose phổ thông để dựng và chạy nền là:

Terminal
docker compose up -d

Lần đầu Docker sẽ dựng ảnh theo Dockerfile (README nói là dựng hai giai đoạn: frontend được dựng rồi chép vào ảnh backend), nên có thể mất vài phút. Nếu README hay tài liệu của repo hướng dẫn lệnh khác, hãy làm theo tài liệu đó.

E.Mở giao diện

Mở trình duyệt và vào địa chỉ ứng dụng. Cổng nằm ở biến PORT trong .env (hoặc trong docker-compose.yml). Mình không biết giá trị mặc định, nên bạn hãy xem file đó. Nếu bạn đã đặt AUTH_PASSWORD, trang sẽ hỏi mật khẩu.

Nếu muốn chạy bản phát triển không dùng Docker, repo có dev.sh (macOS/Linux) và dev.ps1 (Windows). README ở phần mình xem chưa nói cách dùng chúng, nên hãy mở hai file đó và CONTRIBUTING.md để xem.

IV.Kiểm tra đã chạy được chưa

Cách đơn giản nhất là xem container có đang chạy không:

Terminal
docker compose ps

Bạn sẽ thấy dịch vụ ở trạng thái đang chạy. Sau đó mở địa chỉ trong trình duyệt. README nói bảng điều khiển có 19 trang, gồm Dashboard (Tổng quan), Screener (Chiến lược), Backtest, Mining (Khai thác), Monitor (Giám sát) và Regime (Môi trường thị trường). Nếu bạn vào được giao diện và thấy các trang này (hoặc đăng nhập được bằng AUTH_PASSWORD), cài đặt đã thành công.

Một điểm cần biết: README cho biết 11 trang mở rộng mặc định bị ẩn ở bản cài mới. Bạn bật chúng trong Cài đặt → Menu. Nên nếu thấy ít trang hơn dự kiến, đó có thể là chuyện bình thường.

Dữ liệu ban đầu sẽ trống cho đến khi bạn cấu hình nguồn dữ liệu và đồng bộ. Cách đồng bộ cụ thể chưa có trong phần README mình xem, bạn xem thêm docs/ và 操作说明书.md.

V.Dùng vào việc thật

Các tình huống dưới đây bám theo khả năng ghi trong README. Phần thao tác chi tiết trên giao diện tuỳ phiên bản, bạn đối chiếu với tài liệu của repo.

A.Người đầu tư cá nhân muốn kiểm tra một ý tưởng chiến lược

Bạn có một ý tưởng, ví dụ "mua khi cổ phiếu có tín hiệu A và thanh khoản đủ lớn". Bạn mở trang Chiến lược (Screener), tạo chiến lược riêng (hoặc nhờ AI sinh chiến lược từ mô tả), rồi quét toàn thị trường để xem những mã nào đang khớp. Sau đó qua trang Backtest để xem đường giá trị tài sản, mức sụt giảm và danh sách giao dịch, có tính T+1, phí và trượt giá. Vì mọi bước dùng chung một bộ dữ liệu, kết quả quét và kết quả backtest không lệch nhau.

Backtest và quét chiến lược dùng chung một đường chạy, nên bạn đỡ phải nghi ngờ số liệu hai nơi lệch nhau.

Ông T

B.Người theo dõi thị trường cần cảnh báo

Bạn làm việc văn phòng, không ngồi canh bảng giá cả ngày. Bạn vào Trung tâm giám sát, đặt quy tắc (kết hợp AND/OR) cho các mã trong danh sách theo dõi, và bật thông báo. README nói có cửa sổ cảnh báo tức thời, phát giọng nói và đẩy tin sang Feishu. Kết quả là khi một mã chạm điều kiện, bạn nhận cảnh báo thay vì phải tự nhìn màn hình.

C.Dev muốn nối AI client vào dữ liệu của mình

Bạn đang dùng một AI client hỗ trợ MCP. Trong thư mục mcp-server/ có MCP server với 12 công cụ, quyền được tính theo mức token. Bạn tạo token ở Cài đặt → Open API (README nói plaintext chỉ hiện một lần, nên hãy lưu lại ngay), rồi cấu hình client. Chi tiết cấu hình nằm trong mcp-server/ và docs/, vì README phần mình có không nêu lệnh cụ thể. Kết quả: bạn hỏi AI về dữ liệu thị trường ngay trong client quen thuộc của mình.

Về mạng: README nói kênh Token mặc định chỉ cho gọi từ máy bạn hoặc mạng nội bộ, truy cập từ Internet bị chặn 403. Muốn mở ra thì phải đặt biến rõ ràng, và README khuyên dùng đường hầm SSH cho truy cập từ xa.

D.Người thích nghiên cứu nhân tố

Bạn vào nền tảng nhân tố, viết nhân tố bằng DSL, kiểm định, rồi thử khai thác tổ hợp nhân tố ngoài mẫu. README nhấn mạnh kết quả khai thác chỉ được phát hành khi bạn làm rõ ràng và "không bao giờ tự lên sản xuất". Bạn dùng nó như một công cụ thử nghiệm, không phải máy in tiền.

VI.Lỗi hay gặp và cách xử lý

Dưới đây là các lỗi rất dễ gặp với loại ứng dụng Docker kết hợp cấu hình file .env. Đây là phần dựa trên kinh nghiệm chung, không phải danh sách lỗi chính thức của repo.

  • Lệnh Docker báo không kết nối được. Thường do Docker Desktop chưa mở. Mở Docker, đợi nó chạy xong rồi chạy lại lệnh.
  • Vào trang không được hoặc báo cổng bị chiếm. Có thể cổng đang dùng bởi chương trình khác. Hãy đổi PORT trong .env (hoặc phần cổng trong docker-compose.yml), rồi chạy lại.
  • Giao diện trống, không có dữ liệu. Bạn chưa cấu hình nguồn dữ liệu hoặc chưa điền TICKFLOW_API_KEY, hoặc gói tài khoản không đủ quyền với nguồn đó. Xem lại tài liệu về nguồn dữ liệu và nhật ký container bằng docker compose logs.
  • Tính năng AI không chạy. Kiểm tra AI_BASE_URL, AI_API_KEY và AI_MODEL. README nói trợ lý hội thoại cần dịch vụ tương thích OpenAI và có hỗ trợ gọi công cụ. Nếu mô hình bạn dùng không hỗ trợ, trợ lý sẽ lỗi.
  • Gọi API từ máy khác bị từ chối (403). Đây là thiết kế mặc định. Đừng vội mở ra Internet. Hãy dùng đường hầm SSH như README khuyên, hoặc chỉ gọi từ mạng nội bộ.

VII.Có nên dùng không

Điểm mạnh. TSP trọn gói một chuỗi việc: chiến lược, backtest, giám sát, tổng kết. Dữ liệu nằm hoàn toàn trên máy bạn (Parquet và DuckDB), chạy một container, giấy phép MIT. Nguồn dữ liệu cắm thêm được, có API và MCP. README còn nói có hơn 3.000 bài kiểm thử, và dự án vẫn được cập nhật trong vài tháng gần đây.

Giới hạn. Mục tiêu duy nhất là cổ phiếu A, nên nếu bạn quan tâm thị trường Việt Nam hay Mỹ thì nó không phải công cụ phù hợp. Tài liệu chủ yếu bằng tiếng Trung. Bạn có thể cần tài khoản hoặc khoá ở nhà cung cấp dữ liệu, và README ở phần mình xem chưa nêu chi phí. Tác giả cũng nói rõ không làm phần mềm xem bảng giá hay gợi ý đầu tư. Hệ thống khá lớn (19 trang, 65 điểm cuối API), nên người mới sẽ mất thời gian làm quen.

Khi nào chọn cách khác. Nếu bạn chỉ cần xem giá và biểu đồ thì dùng phần mềm bảng giá thông thường. Nếu bạn chỉ cần backtest nhanh một ý tưởng nhỏ thì một thư viện backtest bằng Python có thể gọn hơn. TSP đáng dùng khi bạn muốn một nền tảng đầy đủ, chạy cục bộ và mở rộng được.

4.5/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

tick-stock-panel có miễn phí không?

Mã nguồn dùng giấy phép MIT nên bạn dùng và sửa được. Tuy nhiên phần dữ liệu và AI có thể cần tài khoản hoặc khoá của nhà cung cấp bên ngoài (ví dụ biến TICKFLOW_API_KEY, AI_API_KEY trong .env.example). Tư liệu mình có chưa nêu giá của các dịch vụ đó.

Có cần GPU không?

README phần mình đọc không nêu yêu cầu GPU. Phần tính toán dùng Polars và DuckDB trên CPU, README chỉ nói có hai nhân CPU (cũ và mới) tự dò khi chạy. Phần AI dùng dịch vụ bên ngoài hoặc mô hình như Ollama, nên yêu cầu phần cứng tuỳ bạn chọn.

Chạy được trên Windows không?

Repo có Dockerfile, docker-compose.yml và cả dev.ps1 (script PowerShell), nên có vẻ hỗ trợ Windows. README ở phần mình xem chưa nói rõ về hệ điều hành, bạn nên kiểm tra tài liệu trong thư mục docs/.

Dữ liệu của tôi có an toàn không?

README nói dữ liệu lưu 100% trên máy bạn dưới dạng Parquet và DuckDB, không cần cơ sở dữ liệu ngoài. Token API được lưu bằng băm SHA-256, và kênh Token mặc định chỉ cho gọi từ máy bạn hoặc mạng nội bộ. Nếu bạn dùng dịch vụ AI bên ngoài thì nội dung hỏi sẽ đi qua dịch vụ đó.

Có dùng được cho thị trường chứng khoán Việt Nam không?

Theo tư liệu, repo dành cho cổ phiếu A Trung Quốc, và các nguồn dữ liệu nêu trong README (TickFlow, fuyao, TdxQuant) đều thuộc thị trường này. README cho biết nguồn dữ liệu có thể cắm thêm bằng plugin, nhưng chưa có thông tin về thị trường Việt Nam.

TSP có gợi ý mua bán cổ phiếu không?

Không. Tác giả nói rõ đây không phải phần mềm đầu tư, không có chức năng AI gợi ý mua hay dự đoán tăng trần. Nó là công cụ để bạn tự nghiên cứu, kiểm tra chiến lược, chỉ dùng cho học tập.

Khác gì các phần mềm xem bảng giá như Tonghuashun hay Tongdaxin?

README nói TSP không nhắm đối đầu các phần mềm đó. Trọng tâm của TSP là tự viết chiến lược, backtest, giám sát và mở API, còn phần mềm bảng giá tập trung vào xem giá. TSP thậm chí có thể dùng dữ liệu của chúng làm nguồn (fuyao, TdxQuant).

Chuyển nhanh tới mục

  1. I.TSP làm được gì
    1. A.Nghiên cứu dữ liệu và chiến lược
    2. B.Quan sát thị trường và giám sát
    3. C.Mở rộng và kết nối
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cài Docker
    2. B.Tải mã nguồn
    3. C.Tạo file cấu hình
    4. D.Khởi chạy
    5. E.Mở giao diện
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Người đầu tư cá nhân muốn kiểm tra một ý tưởng chiến lược
    2. B.Người theo dõi thị trường cần cảnh báo
    3. C.Dev muốn nối AI client vào dữ liệu của mình
    4. D.Người thích nghiên cứu nhân tố
  6. VI.Lỗi hay gặp và cách xử lý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.