# 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

> tick-stock-panel (TSP) là bàn làm việc định lượng cho thị trường cổ phiếu A của Trung Quốc, tự host trên máy bạn. Nó gộp chiến lược, backtest, giám sát dị động và trợ lý AI vào một giao diện web. Repo có sẵn Dockerfile và docker-compose.yml nên việc cài khá gọn, nhưng giao diện và tài liệu chủ yếu bằng tiếng Trung.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-06-25 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/tick-stock-panel-ban-lam-viec-dinh-luong-co-phieu-a-tu-host

tick-stock-panel (viết tắt TSP) là một bàn làm việc định lượng cho thị trường cổ phiếu A (A股) của Trung Quốc, chạy tự host trên máy hoặc server của bạn. Nó gộp những việc thường nằm rải rác ở nhiều công cụ: viết chiến lược lọc cổ phiếu, backtest, giám sát dị động trong phiên, phân tích từng mã và hỏi đáp bằng AI. Tất cả dùng chung một nguồn dữ liệu.

Bạn nên xem repo này nếu đang tự làm nghiên cứu định lượng cho cổ phiếu A và chán cảnh mỗi việc một công cụ, số liệu mỗi nơi một kiểu. Lập trình viên muốn dựng bot hay công cụ riêng trên dữ liệu thị trường cũng hợp, vì TSP mở các chức năng lõi thành API và MCP server. Hiện repo có khoảng 7691 sao và 1883 fork, dùng giấy phép MIT.

Điểm đáng giá nhất là kiến trúc gọn: một container Docker, không cần cơ sở dữ liệu ngoài, dữ liệu lưu thẳng trên máy dưới dạng Parquet. Có một điều bạn cần biết trước. Tác giả nói rõ đây không phải phần mềm đầu tư hay phần mềm xem bảng giá, không thay thế các app xem giá phổ biến và không có chức năng AI gợi ý mã nên mua. Repo chỉ phục vụ học tập và nghiên cứu.

```repo
- repo | shy3130/tick-stock-panel
- kind | Ứng dụng
- desc | TSP là bàn làm việc định lượng cổ phiếu A tự host: tạo chiến lược, backtest, giám sát và hỏi đáp bằng AI, chạy trong một container Docker.
- stars | 7.7k
- lang | Python
- license | MIT
```

## TSP làm được gì

Dưới đây là các nhóm tính năng chính, theo README.

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

- **Chiến lược tự định nghĩa**: bạn tự viết chiến lược và tín hiệu, hoặc nhờ AI sinh ra. README nói hệ thống quét toàn thị trường ở mức mili giây nhờ Polars. Lợi ích thực tế là sửa điều kiện lọc xong thấy kết quả ngay, không phải chờ.
- **Một khẩu độ dữ liệu duy nhất**: hệ thống chỉ lưu 15 cột dữ liệu cơ bản, rồi tính ra 68 cột chỉ báo và tín hiệu. Chiến lược, backtest, giám sát và phục bàn đều dùng cùng một bộ số, nên ít khi bị lệch số giữa các màn hình.
- **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í và trượt giá. README cho biết backtest chạy trong tiến trình con, nên tải lại trang hay chuyển trang không làm mất tác vụ.
- **Nền tảng nhân tố và khai phá nhân tố**: bạn tự định nghĩa nhân tố bằng DSL, rồi để hệ thống tìm tổ hợp nhiều nhân tố bằng kiểm tra ngoài mẫu. Kết quả chỉ phát hành khi bạn bấm xác nhận.
- **Đổi nguồn dữ liệu không đổi kết quả**: 6 loại dữ liệu được định tuyến độc lập theo khả năng của từng nguồn. Bạn có thể đổi nguồn mà chỉ báo và kết quả backtest vẫn cùng một cách tính.

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

- **Môi trường thị trường**: chu kỳ tâm lý chia 6 giai đoạn, kèm xếp hạng chủ đề theo khái niệm và ngành.
- **Giám sát dị động**: bao phủ ba loại là đấu giá, trong phiên và lệch. Có cửa sổ cảnh báo, đọc giọng nói và đẩy tin qua Feishu (Lark).
- **Trung tâm giám sát**: bốn loại quy tắc, kết hợp AND/OR.
- **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 trần và phục bàn sau giờ**: có AI hỗ trợ tổng kết sau phiên.

### Mở rộng và tích hợp AI

- **API mở**: token chia 6 mức quyền, 65 endpoint có hợp đồng rõ ràng, có luồng sự kiện SSE. Mặc định API token chỉ cho gọi từ máy nội bộ hoặc mạng LAN.
- **MCP server**: 12 công cụ để các ứng dụng AI khác dùng được dữ liệu trong TSP.
- **Trợ lý AI hội thoại**: bạn hỏi dữ liệu bằng một câu, các bước lấy dữ liệu hiện ra từng dòng để đối chiếu. Trợ lý cần mô hình hỗ trợ gọi công cụ qua giao diện tương thích OpenAI.
- **Trang và nguồn dữ liệu mở rộng**: nguồn dữ liệu dạng plugin, trang mở rộng dạng một file duy nhất. Xóa thư mục là gỡ, chép thư mục vào là nhập.

## Cần chuẩn bị gì

Theo tài liệu, bạn cần:

- **Python 3.11 trở lên** cho phần backend.
- **Node 20 trở lên** cho phần frontend. Phần này chỉ cần nếu bạn chạy từ mã nguồn.
- **Docker** nếu chọn cách chạy một container. Repo có Dockerfile và docker-compose.yml.
- **Khóa API nguồn dữ liệu**: file .env.example có biến TICKFLOW_API_KEY. TickFlow là một trong các nguồn dữ liệu được nhắc tới. Đoạn README mình có không nói rõ bạn có bắt buộc phải dùng nguồn này hay không.
- **Khóa AI (tùy chọn)**: nếu muốn dùng chức năng AI, bạn điền nhà cung cấp, địa chỉ, khóa và tên mô hình. Mình thấy .env.example có các biến AI_PROVIDER, AI_BASE_URL, AI_API_KEY và AI_MODEL. README nhắc DeepSeek, Tongyi và Ollama là các lựa chọn tương thích.

Tư liệu mình có không nêu yêu cầu GPU hay dung lượng ổ đĩa tối thiểu. Phần giới thiệu ghi giao diện bằng tiếng Trung, nên bạn nên chuẩn bị trình duyệt có thể dịch trang.

```note
Khóa API (TICKFLOW_API_KEY, AI_API_KEY) là bí mật của bạn. Chỉ điền vào file .env trên máy mình, không đưa lên GitHub, không gửi vào nhóm chat. Chức năng AI gọi mô hình bên ngoài nên có thể phát sinh chi phí theo nhà cung cấp bạn chọn. Biến AI_DAILY_TOKEN_BUDGET trong .env.example có vẻ để đặt hạn mức token mỗi ngày, bạn nên xem ý nghĩa của nó trong tài liệu rồi hãy đặt.
```

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

Đoạn README mình có bị cắt trước mục Bắt đầu nhanh (快速开始), nên chưa có lệnh cài chính thức để chép lại. Mình chỉ viết những lệnh phổ thông chắc chắn đúng. Khi tới bước chạy, bạn hãy mở mục 快速开始 trong README hoặc file 操作说明书.md (sách hướng dẫn thao tác) trong repo để lấy lệnh chính xác.

```steps
- Cài Docker | Chuẩn bị Docker để chạy một container
- Tải mã nguồn | Dùng git clone rồi vào thư mục repo
- Tạo file .env | Sao chép từ .env.example và điền khóa cần thiết
- Khởi chạy | Dùng docker-compose.yml có sẵn trong repo
- Mở giao diện | Vào trình duyệt, đăng nhập bằng mật khẩu nếu có đặt
```

### Cài Docker và mở terminal đúng chỗ

Bạn cần có Docker trên máy. README nói TSP chạy một container, nên đây là cách dễ nhất cho người mới. Sau khi cài xong, mở terminal (PowerShell trên Windows, Terminal trên macOS hoặc Linux). Chỗ người mới hay vấp là chạy lệnh khi Docker chưa bật. Hãy mở Docker Desktop và đợi nó báo đã sẵn sàng trước.

### Tải mã nguồn về máy

Lệnh dưới tải repo về và vào thư mục của nó. Mọi lệnh sau phải chạy bên trong thư mục này, vì docker-compose.yml và .env.example nằm ở đó.

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

### Tạo file cấu hình .env

Repo có sẵn file mẫu .env.example. Bạn tạo bản sao tên .env rồi mở bằng trình soạn thảo để điền giá trị. Các biến trong file mẫu gồm: 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 và DATA_DIR.

Mình chưa có mô tả chi tiết cho từng biến trong tư liệu, nên đừng đoán giá trị. Chỉ điền những gì bạn hiểu, ví dụ khóa dữ liệu và mật khẩu đăng nhập AUTH_PASSWORD. Phần còn lại hãy xem ghi chú ngay trong file .env.example.

```bash
cp .env.example .env
```

Trên Windows PowerShell, lệnh tương đương là:

```powershell
Copy-Item .env.example .env
```

### Khởi chạy bằng Docker

Repo có docker-compose.yml, nên cách thông dụng là dùng Docker Compose để dựng và chạy. Lệnh dưới là lệnh Compose phổ thông, chưa được chép từ README. Nếu README hay 操作说明书.md ghi lệnh khác, hãy theo hướng dẫn của tác giả.

```bash
docker compose up -d
```

Lệnh này đọc docker-compose.yml, dựng ảnh từ Dockerfile rồi chạy nền. Lần đầu có thể lâu vì phải dựng cả phần giao diện (README nói build hai giai đoạn). Chạy xong, bạn mở trình duyệt vào địa chỉ máy mình với cổng đã đặt trong PORT. README đoạn mình có không nói cổng mặc định, nên hãy xem file .env hoặc docker-compose.yml.

### Hoặc chạy từ mã nguồn để phát triển

Repo có sẵn dev.sh (cho macOS, Linux) và dev.ps1 (cho Windows PowerShell). Nội dung và cách dùng hai script này không có trong đoạn README mình có, nên bạn đọc phần hướng dẫn phát triển và file CONTRIBUTING.md trước khi chạy. Chỉ chọn cách này nếu bạn đã quen Python và Node.

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

Tư liệu mình có không mô tả màn hình hay lệnh kiểm tra cụ thể. Bạn có thể tự kiểm theo thứ tự sau:

1. Chạy lệnh dưới, nếu container hiện trạng thái đang chạy là ổn.

```bash
docker compose ps
```

2. Mở trình duyệt vào địa chỉ và cổng bạn đặt. Nếu đã đặt AUTH_PASSWORD, bạn sẽ thấy màn hình đăng nhập. README nói bảng điều khiển dùng phiên đăng nhập bằng mật khẩu.
3. Khi vào được, README mô tả các trang chính như Bảng điều khiển (Dashboard), Chiến lược (Screener), Backtest, Khai phá (Mining), Trung tâm giám sát (Monitor) và Môi trường thị trường (Regime). Thấy các trang này là bước cài đã xong.
4. Nếu trang trống thì đó là bình thường. Chiến lược và nội dung mở rộng phải do bạn tự tạo hoặc nhập, README ghi rõ như vậy.

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

Các tình huống dưới đây chỉ bám theo khả năng có trong README. Chúng là ví dụ minh họa chứ không phải cam kết về hiệu quả đầu tư.

### Nhà đầu tư cá nhân tự lọc cổ phiếu theo điều kiện riêng

Bối cảnh: bạn có vài tiêu chí lọc cổ phiếu A và mỗi lần phải xuất file Excel để lọc thủ công. Trong trang Chiến lược, bạn tạo chiến lược tự định nghĩa dựa trên bộ chỉ báo có sẵn (68 cột) hoặc nhờ AI sinh chiến lược. Bạn chạy quét toàn thị trường và xem danh sách mã trúng điều kiện. Kết quả nhận được là danh sách mã trúng chiến lược gần như tức thì, theo mô tả mili giây của README.

### Kiểm tra chiến lược bằng backtest trước khi tin

Bối cảnh: bạn vừa nghĩ ra một chiến lược và muốn xem nó có đứng vững không. Bạn mở trang Backtest, chọn chiến lược, đặt phí và trượt giá, rồi chạy. Hệ thống tính theo T+1 và hiển thị đường vốn, mức sụt giảm và chi tiết giao dịch. README nhấn mạnh dùng nguyên tắc chỉ dùng thông tin đã biết trong ngày để tránh nhìn trước tương lai.

> Muốn tin một chiến lược, hãy để nó chạy backtest cùng một bộ số với lúc quét và lúc giám sát.
>
> — Ông T

### Nhân viên theo dõi dị động trong phiên

Bối cảnh: bạn phải để ý mã trong danh sách theo dõi nhưng không thể nhìn bảng giá cả ngày. Trong Trung tâm giám sát, bạn tạo quy tắc kết hợp AND/OR, bật cảnh báo bằng cửa sổ, giọng nói hoặc đẩy tin Feishu. Kết quả là bạn nhận cảnh báo khi quy tắc kích hoạt. README cũng nói hệ thống tự dừng thăm dò vào ngày nghỉ lễ, đỡ gọi dữ liệu vô ích.

### Lập trình viên nối AI vào dữ liệu thị trường

Bối cảnh: bạn dùng một ứng dụng AI hỗ trợ MCP và muốn nó hỏi được dữ liệu từ TSP. Vào Cài đặt → Giao diện mở để tạo API Token, README nói bản rõ chỉ hiện một lần nên hãy lưu ngay. Cấp quyền tối thiểu theo 6 mức (ví dụ chỉ đọc thị trường: read:market). Sau đó cấu hình mcp-server trong repo (cách cấu hình xem tài liệu của repo). Kết quả là AI client gọi được 12 công cụ tùy quyền token. Lưu ý token mặc định chỉ gọi từ máy nội bộ hoặc mạng LAN. README khuyên truy cập từ xa nên dùng SSH tunnel.

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

**Docker không chạy hoặc lệnh báo không kết nối được.** Thường do Docker Desktop chưa bật. Mở Docker Desktop, đợi nó sẵn sàng rồi chạy lại lệnh.

**Mở trang web không được.** Kiểm tra container có đang chạy không bằng docker compose ps. Kiểm tra giá trị HOST và PORT trong .env, và xem cổng có bị chương trình khác chiếm không. Đổi PORT rồi chạy lại nếu cần.

**Giao diện hiện tiếng Trung, khó hiểu.** README và giao diện của dự án chủ yếu bằng tiếng Trung. Bạn dùng chức năng dịch trang của trình duyệt. Repo cũng có thư mục docs và file 操作说明书.md để tra cứu.

**Gọi API hoặc MCP từ máy khác bị lỗi 403.** README nói token mặc định chỉ gọi từ máy nội bộ hoặc LAN và chặn công khai bằng 403. Cách an toàn nhất là dùng SSH tunnel như tác giả khuyên. Đừng vội mở rộng quyền truy cập ra Internet.

**Chức năng AI không hoạt động.** Kiểm tra lại AI_BASE_URL, AI_API_KEY và AI_MODEL trong .env. README lưu ý trợ lý hội thoại cần mô hình hỗ trợ gọi công cụ qua giao diện tương thích OpenAI. Nếu mô hình bạn chọn không hỗ trợ, trợ lý có thể không chạy đúng.

Sau khi sửa .env, bạn cần khởi động lại container để cấu hình mới có hiệu lực.

## Có nên dùng không

**Điểm mạnh.** Tự host, dữ liệu nằm trên máy bạn. Một container, không cần cơ sở dữ liệu ngoài. Dùng chung một bộ số từ chiến lược tới backtest và giám sát. Mở API và MCP nên dễ tích hợp. Kiến trúc cho phép gỡ hoặc thay phần mở rộng mà không ảnh hưởng lõi. Giấy phép MIT, repo vẫn được cập nhật trong 3 tháng gần đây.

**Giới hạn.** Chỉ nhắm vào thị trường cổ phiếu A. Tài liệu và giao diện chủ yếu tiếng Trung. Tư liệu mình có chưa nêu rõ yêu cầu phần cứng và chưa thấy phần hướng dẫn chạy nhanh, nên bạn phải tự đọc README đầy đủ. Tác giả tuyên bố đây không phải phần mềm đầu tư, không có AI gợi ý mã mua, nên đừng kỳ vọng nó đưa ra lời khuyên mua bán.

**Khi nào chọn cách khác.** Nếu bạn chỉ cần xem giá và biểu đồ hằng ngày, các app xem bảng giá phổ thông sẽ đơn giản hơn. Nếu bạn quan tâm thị trường ngoài Trung Quốc, TSP không phải lựa chọn phù hợp. Nếu bạn không quen Docker hay dòng lệnh, hãy thử trên máy thử nghiệm trước và đọc kỹ tài liệu.

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

### TSP có miễn phí không?

Mã nguồn dùng giấy phép MIT nên bạn dùng và chỉnh sửa được. Tuy nhiên nguồn dữ liệu và dịch vụ AI bên ngoài có thể tính phí riêng. Trong tư liệu mình có không nêu giá cụ thể của các dịch vụ đó.

### TSP có cần GPU không?

Tư liệu mình có không nhắc yêu cầu GPU. Dự án dùng Polars và DuckDB để xử lý dữ liệu, chức năng AI thì gọi mô hình qua giao diện bên ngoài. Yêu cầu phần cứng chính xác chưa có thông tin.

### TSP chạy được trên Windows không?

Repo có script dev.ps1 cho PowerShell và dev.sh cho shell kiểu Unix, ngoài ra có Docker. Nghĩa là Windows được hỗ trợ ít nhất ở cách chạy phát triển và Docker. Bạn nên xem README đầy đủ để biết chi tiết từng hệ điều hành.

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

README nói dữ liệu lưu hoàn toàn trên máy (Parquet và DuckDB), token API được băm SHA-256, và token mặc định chỉ gọi từ máy nội bộ hoặc LAN. Tuy vậy nếu bạn bật AI, nội dung câu hỏi có thể gửi tới nhà cung cấp mô hình mà bạn cấu hình. Hãy tự cân nhắc điều này.

### TSP khác gì các app xem bảng giá phổ biến?

Tác giả nói rõ TSP không đối chuẩn với các phần mềm xem giá và không có AI gợi ý mã mua hay dự đoán tăng trần. TSP tập trung vào nghiên cứu chiến lược, backtest, giám sát tự dựng và mở API cho tích hợp.

### Có dùng được với Claude hay AI khác không?

README nói repo có MCP server với 12 công cụ để giao cho bất kỳ ứng dụng AI nào hỗ trợ MCP. Chức năng AI bên trong thì dùng giao diện tương thích OpenAI, với ví dụ DeepSeek, Tongyi và Ollama. Cách cấu hình MCP cụ thể bạn xem trong thư mục mcp-server của repo.

### Giao diện có tiếng Việt không?

Chưa có thông tin về bản tiếng Việt. Tài liệu và giao diện trong tư liệu chủ yếu bằng tiếng Trung, nên bạn nên dùng chức năng dịch của trình duyệt.
