← Quay lại blog

Ghi chú phát hành

Nhật ký thay đổi cấu trúc dịch vụ và chính sách vận hành NoahAI Labs

Mục đích của trang này

Ghi chú phát hành này không liệt kê tính năng mới hay cải tiến. Mục tiêu là ghi lại thay đổi cấu trúc dịch vụ và thay đổi chính sách vận hành.

Với mỗi phiên bản, trọng tâm là vì sao cấu trúc được đổi và nguyên tắc vận hành nào được áp dụng, hơn là chỉ “đã đổi gì”.

Công bố runbook vận hành — Quy trình chẩn đoán Kiwoom OpenAPI+ trên Windows (2026-05-11)

Bối cảnh thay đổi

Trong giai đoạn beta có điều kiện cho kết nối thực ETF/cổ phiếu, nguyên nhân lỗi kết nối Kiwoom OpenAPI+ khác nhau theo từng môi trường. Để giảm độ lệch xử lý và tăng khả năng tái hiện, runbook chẩn đoán chuẩn cho Windows đã được chuẩn hóa chính thức.

Thay đổi cấu trúc vận hành

  • Luồng thực thi chuẩn: Cố định trình tự PowerShell: kích hoạt venv → chạy script kiểm chứng.
  • Khóa tách nguyên nhân: Dùng control_ok, has_OnReceiveTrData, python_bits, os để tách nhóm lỗi ActiveX/sự kiện/tài khoản.
  • Bộ bằng chứng bắt buộc: Console đầy đủ, JSON Step 0 và chi tiết FAIL ở bước kết nối API.

Chỉ số kiểm chứng hỗ trợ

Là mốc hồi quy script trên môi trường Mac dev: 13 passed, 4 skipped, 60 deselected.

v3.8.9.19 — Nâng cấp tab dashboard và đồng bộ thị trường Hàn Quốc (2026-05-06)

Bối cảnh thay đổi

Các tab tích hợp tài sản, tài chính đời sống và AI analyst trước đó chủ yếu là danh sách văn bản, nên chưa hỗ trợ đủ thông tin cho quyết định. Các engine trực quan hóa/tính toán theo từng tab đã được triển khai, đồng thời luồng xu hướng cổ phiếu chuyển sang chuẩn thị trường Hàn Quốc.

Thay đổi cấu trúc vận hành

  • Chẩn đoán phân bổ tài sản: Bổ sung biểu đồ tỷ trọng, đồng hồ HHI, heatmap tương quan, thẻ gợi ý tái cân bằng.
  • Kiểm tra kịch bản: So sánh 3 chiến lược bảo thủ/hiện tại/tích cực dựa trên 200 bản ghi trade_log gần nhất.
  • Briefing rủi ro: Bổ sung mô phỏng lỗ -5% đến -50% và danh sách hành động ứng phó tức thời.
  • Mở rộng tab tài chính đời sống: Thêm tab cảnh báo bảo mật và tab tính thuế.
  • Đồng bộ xu hướng cổ phiếu Hàn: Hiển thị KOSPI/KOSDAQ cùng cổ phiếu, nhóm ngành chính.

Xác minh triển khai

Kiểm thử hồi quy menu: 51 passed (0 failed) · Lỗi cú pháp: 0 · File thay đổi: 5 · Hàm mới: 12

v3.8.9.11 — Sửa gốc lỗi TP/SL -2021 và mở rộng nền tảng tài chính (2026-01-25)

Bối cảnh thay đổi

Trên các altcoin giá thấp như GALA, JASMY, lệnh TP (Take Profit) có thể thất bại. Thông báo lỗi là -2021: Order would immediately trigger—không chỉ là lỗi đơn lẻ mà là vấn đề cấu trúc về độ chính xác giá và kiểm tra hướng TP.

Đồng thời, động cơ vận hành AI tài chính đã được kiểm chứng trên tiền mã hóa thực tế đang được mở rộng sang ETF và cổ phiếu. Đây là bước quan trọng hướng tới nền tảng AI tài chính trung lập tài sản, không phụ thuộc một loại tài sản cố định.

Thay đổi cấu trúc vận hành

1. Sửa gốc lỗi TP/SL -2021

  • Tương thích tên khóa: Hỗ trợ cả price_precision và pricePrecision. Trước đây, không khớp khóa khiến độ chính xác giá luôn cố định ở 2, nên coin giá thấp không tính giá đúng được.
  • Tự phát hiện coin giá thấp và chỉnh độ chính xác: Tự nhận diện coin có giá khoảng 0,001–0,02 và áp dụng độ chính xác phù hợp để TP/SL khớp lệnh đúng.
  • Kiểm tra hướng TP: Với LONG, TP phải cao hơn giá hiện tại; với SHORT, TP phải thấp hơn. Trước đây bước này thiếu nên có thể tạo TP sai hướng.

2. Mở rộng nền tảng AI tài chính

  • Giao diện StockExchange: Thêm trading/exchanges/interfaces/stock_exchange.py để xử lý sàn chứng khoán và tiền mã hóa qua cùng một giao diện—nguyên tắc thiết kế cốt lõi cho động cơ trung lập tài sản.
  • Khung adapter chứng khoán trong nước: Thêm trading/exchanges/adapters/kiwoom_stock_adapter.py làm nền tích hợp API chứng khoán vào hệ thống AI tài chính.
  • Mở rộng bảng điều khiển: Tab cổ phiếu/chứng khoán và tab con theo từng công ty chứng khoán để quản lý tiền mã hóa và cổ phiếu trong một giao diện.

Nguyên tắc vận hành

Cùng một lớp an toàn phải hoạt động cho mọi loại tài sản. Dù alt giá thấp hay coin giá cao, tiền mã hóa hay cổ phiếu, các cơ chế như TP/SL phải hoạt động chính xác và không được khác nhau chỉ vì độ chính xác giá hay loại tài sản.

Thiết kế trung lập tài sản giúp khi thêm loại tài sản mới vẫn tái sử dụng các lớp an toàn và cấu trúc vận hành hiện có. Mở rộng ETF/cổ phiếu là ứng dụng thực tế đầu tiên của nguyên tắc này.

v3.8.9.9 — Triển khai đầy đủ Binance Algo Order API (2025-12-27)

Bối cảnh thay đổi

Sau thay đổi chính sách Binance (2025-12-09), lệnh có điều kiện (TP/SL) phải đi qua Algo Service. Đây không chỉ là thêm tính năng mà là tái thiết kế cấu trúc vận hành theo chính sách API sàn.

Thay đổi cấu trúc vận hành

  • Thống nhất quy tắc ký: Ký theo chuỗi truy vấn để xử lý mọi tham số nhất quán.
  • Chuẩn hóa độ chính xác giá: Ưu tiên tickSize, giảm sai số dấu phẩy động.
  • Đơn giản hóa nhánh lệnh có điều kiện: Giảm logic phức tạp (khoảng 160 dòng → 55 dòng) để dễ bảo trì.
  • Thống nhất định dạng phản hồi: Chuẩn hóa phản hồi Algo Order giống lệnh thường để tương thích mã cũ.

Nguyên tắc vận hành

Khi chính sách sàn thay đổi, cấu trúc phải đáp ứng yêu cầu mới trong khi giữ tương thích với mã hiện có. Thiết kế sao cho mọi module tự áp dụng và hạn chế chỉnh sửa bổ sung.

v3.8.9.7 — Tuân thủ API Binance và cải thiện cấu hình (2025-01-26)

Bối cảnh thay đổi

Tuân thủ đầy đủ quy tắc chính thức của Binance API và chuyển cấu hình cứng sang cấu trúc người dùng có thể điều khiển.

Thay đổi cấu trúc vận hành

  • Tuân thủ API: Khi closePosition=True thì bỏ quantity; không dùng đồng thời reduceOnly và closePosition.
  • Cấu trúc file cấu hình: Chuyển TP/SL dự phòng sang settings.json để AI tự điều chỉnh theo thị trường.
  • Tự phát hiện đường dẫn: Bỏ đường dẫn cứng; tự nhận đúng đường dẫn kể cả khi đóng gói.
  • Làm rõ vai trò TP/SL: Tách giám sát thời gian thực (chính) và TP/SL dự phòng (bảo hiểm).

Nguyên tắc vận hành

Quy tắc API sàn được tuân thủ tuyệt đối. Phần người dùng điều khiển được tách ra file để AI điều chỉnh động.

v3.8.9.5 — Tăng cường xác thực TP/SL và tính nguyên tử (2025-01-26)

Bối cảnh thay đổi

Giao dịch vẫn có thể tiếp tục khi xác thực TP/SL thất bại. Chúng tôi củng cố an toàn bằng đảm bảo tính nguyên tử.

Thay đổi cấu trúc vận hành

  • TP/SL bắt buộc: Khi xác thực thất bại, đóng vị thế ngay và coi giao dịch là thất bại.
  • Tính nguyên tử: Nếu TP hoặc SL lỗi thì hoàn tác cả hai; khi đặt lại vẫn giữ tính nguyên tử.
  • Thống nhất logic xác thực: Dùng cùng bộ lọc loại lệnh ở mọi nơi.
  • Chuẩn bị module hóa: Gom trách nhiệm TP/SL vào TpSlManager để tái sử dụng.

Nguyên tắc vận hành

Cơ chế an toàn (TP/SL) là bắt buộc. Không đặt được thì không chạy giao dịch. Tính nguyên tử tránh trạng thái lỗi một phần.

v3.8.9.3 — Cải thiện số dư tổng hợp và thống kê giao dịch (2025-11-29)

Bối cảnh thay đổi

Khi vận hành nhiều sàn, chúng tôi cải thiện cấu trúc số dư và thống kê giao dịch để quản lý thống nhất.

Thay đổi cấu trúc vận hành

  • Tổng số dư: Cộng số dư USDT/KRW trên nhiều sàn và hiển thị.
  • Thống kê giao dịch thống nhất: Ưu tiên exchange_trade_stats, dự phòng trade_log để tăng độ chính xác.
  • Ghi nhận đóng TP/SL: Cập nhật trade_log khi đóng bằng TP/SL để thống kê đúng hơn.
  • Đóng lệnh có tính phí: Ngưỡng lợi nhuận tối thiểu sau phí để đảm bảo thu hồi phí.

Nguyên tắc vận hành

Vận hành đa sàn cần góc nhìn tổng hợp—không chỉ từng sàn mà phải thấy toàn bộ tài sản và hiệu quả một lần nhìn.

v3.8.9.2 — Học từng bước thông minh (2025-11-29)

Bối cảnh thay đổi

Để áp dụng điều kiện phù hợp cho người mới và người dùng lâu năm, chúng tôi giới thiệu hệ thống học dần dần.

Thay đổi cấu trúc vận hành

  • Ngưỡng theo lịch sử: Từ giao dịch đầu tiên (0 lần) đến giao dịch bình thường (11+ lần), nới lỏng theo giai đoạn.
  • Giao dịch đầu theo coin: Khi giao dịch coin mới cũng áp dụng ngưỡng nới lỏng.
  • Tin tưởng phán đoán tổng thể của AI: Tín hiệu yếu vẫn có thể chấp nhận khi thị trường thuận lợi.
  • Điều chỉnh theo cường độ tín hiệu: Tự điều chỉnh độ tin cậy AI theo cường độ.

Nguyên tắc vận hành

Học diễn ra dần dần. Bắt đầu với điều kiện nới lỏng; khi lịch sử đủ dày chuyển sang ngưỡng bình thường. Tin vào phán đoán tổng thể của AI, không chỉ cường độ tín hiệu.

v3.8.9 — Tăng cường đồng bộ vị thế (2025-11-21)

Bối cảnh thay đổi

Giữ trạng thái chính xác sau khi khởi động lại ứng dụng và củng cố đồng bộ giữa sàn thực tế và bộ nhớ.

Thay đổi cấu trúc vận hành

  • Đồng bộ sàn và bộ nhớ: Mỗi chu kỳ giao dịch, truy vấn vị thế thực.
  • Xóa vị thế đã đóng: Dọn bộ nhớ để đếm vị thế chính xác.
  • Khôi phục vị thế thực: Chịu được khởi động lại ứng dụng.
  • Ổn định chu kỳ: Đếm vị thế đúng để vòng giao dịch hoạt động bình thường.

Nguyên tắc vận hành

Trạng thái trong bộ nhớ phải luôn khớp với sàn. Đồng bộ giữ trạng thái đúng sau lỗi mạng hoặc khởi động lại.

v3.8.8.8 — Gỡ bế tắc giao dịch đầu và bảo toàn cấu hình (2025-11-14)

Bối cảnh thay đổi

Giải quyết vòng lặp “gà và trứng” khi giao dịch đầu không chạy và cải thiện để cấu hình người dùng được lưu bền.

Thay đổi cấu trúc vận hành

  • Cho phép giao dịch đầu: Khi tổng số giao dịch bằng 0, áp dụng điều kiện nới lỏng.
  • Thiếu dữ liệu: Điều chỉnh động qua user_signal_threshold.
  • Lưu cấu hình: Gộp đệ quy dict lồng nhau, xử lý đầy đủ từ hai cấp trở lên.
  • Khóa được bảo vệ: Bảo vệ rõ ràng để khi gộp template không ghi đè giá trị người dùng.

Nguyên tắc vận hành

Vòng lặp phải được giải bằng cấu trúc: cho phép giao dịch đầu để tích lũy dữ liệu và luôn giữ cấu hình người dùng chỉnh sửa.

v3.8.8.6 — Chế độ Alpha Arena (2025-11-07)

Bối cảnh thay đổi

Thêm chế độ giao dịch tự chủ dựa trên LLM để mở rộng hỗ trợ nhiều chiến lược giao dịch.

Thay đổi cấu trúc vận hành

  • Chế độ độc lập: Alpha Arena tách hoàn toàn khỏi đường ống tự động chính.
  • Tự chủ LLM: AI trực tiếp quyết định và thực thi.
  • Chiến lược đã kiểm chứng: Áp dụng thuật toán thắng đã qua benchmark Alpha Arena.
  • Guardrail tích hợp: Giới hạn đòn bẩy, TP/SL bắt buộc, cooldown, v.v.

Nguyên tắc vận hành

Chế độ mới vận hành độc lập với hệ thống cũ, mỗi chế độ có guardrail phù hợp. Chiến lược phụ thuộc chế độ người dùng chọn.

v0.1 — Công bố cấu trúc dịch vụ website (2025-12)

Cấu trúc trang dịch vụ

Chúng tôi sắp xếp khu vực dịch vụ trên website NoahAI Labs như sau:

  • Services (/product): Tập trung vào dịch vụ AI tài chính cá nhân hiện có.
  • Trợ lý tài chính tự chủ (/product/assistant): Khái niệm tổng cho tích hợp wealth tech / AI tài chính / trợ lý tự chủ và tầm nhìn mở rộng.
  • Technology (/technology): Động cơ AI tài chính và stack vận hành.
  • Enterprise (/enterprise): Stack vận hành cho B2B và tổ chức.

Lý do thay đổi

Trước đây nội dung lệch về mô tả xoay quanh coin. NoahAI Labs hướng tới AI phán đoán tài chính tích hợp, không chỉ một loại tài sản.

Tiền mã hóa chỉ được đề cập với vai trò “tài sản đầu tiên được kiểm chứng thực tế”; trang trợ lý tài chính tự chủ riêng giúp làm rõ kiến trúc AI tài chính có thể mở rộng.

Nguyên tắc vận hành

  • Không nhấn mạnh chiến lược từng coin, con số lợi nhuận hay thành tích ngắn hạn.
  • Trọng tâm là phán đoán → thực thi (tùy chọn) → ghi log → xem lại → giải thích (XAI).
  • Cấm tư vấn đầu tư và cam kết lợi nhuận.
  • Không phóng đại kỹ thuật; dùng từ như “nền tảng”, “động cơ”, “cấu trúc vận hành”.

Kế hoạch tiếp theo

Các ghi chú phát hành sau sẽ ghi lại thay đổi cấu trúc như:

  • Mở rộng phạm vi tài sản (coin → chứng khoán/ETF/bất động sản)
  • Nâng cao khả năng diễn giải rủi ro
  • Mở rộng phạm vi giải thích phán đoán
  • Mở rộng phạm vi thực thi
  • Thay đổi chính sách vận hành
  • Ứng phó thay đổi chính sách API sàn
  • Cải thiện cấu trúc an toàn

Chúng tôi không ghi tính năng mới hay con số hiệu suất—chỉ thay đổi cấu trúc và nguyên tắc vận hành.