Kết nối AI

Trang chính chỉ cần mã kết nối; toàn bộ phần cài server đặt ở đây

Mã kết nối không phải API key. Trình duyệt dùng mã này để ghép với bridge AI trên VPS hoặc máy đang chạy bộ kết nối.

Tải bộ kết nối AI

Dùng trên app

Kết nối trong 20 giây

Mở bộ server/bridge AI và chắc chắn nó đang chạy.
Sao chép mã ghép nối của server.
Dán mã vào ô AI trên Hỏi Việc hoặc Mệnh.
Bấm biểu tượng ↵. Nếu trạng thái đổi từ × sang ✓, kết nối đã sẵn sàng.
Bấm Luận AI. Nếu đổi mã, dấu ✓ sẽ tự trở về × cho đến khi kiểm tra lại.

VPS · cấu trúc đang dùng

Luồng kết nối

Website

kymon.pp.ua chỉ chứa giao diện và logic lập/kiểm tra bàn. Không chứa API key AI.

Named Tunnel

ai-origin.kymon.pp.ua chuyển request tới bridge nội bộ; không cần mở cổng 8765 trực tiếp ra Internet.

Bridge

local/server.mjs nghe localhost, kiểm tra Host/Origin/mã ghép nối và xác minh protocol trước khi gọi AI.

AI router

Runtime hiện dùng router nội bộ và fallback chain đã cấu hình trên VPS; web không tự đổi provider/model.

Cài VPS

Thiết lập chuẩn theo repo hiện tại

Cài runtime. Cần Node.js 22+, Codex CLI, cloudflared, curl và 9router service.
Đưa source lên VPS. Giữ nguyên cấu trúc dist/, local/, START-VPS.sh và scripts/.
Tạo file môi trường riêng. Không commit mã ghép nối, API key hoặc token Cloudflare vào GitHub.
Tạo Named Tunnel. Token tunnel lưu thành file riêng, permission 600. Tunnel trỏ hostname AI về bridge localhost.
Cài autostart. Chạy script systemd đi kèm để 9router và Kỳ Môn bridge tự lên sau reboot.
Kiểm tra. Chỉ coi là hoàn tất khi systemd active, /api/status trả đúng protocol và app đổi trạng thái thành ✓.

Biến cấu hình chính

Không đặt bí mật vào mã website

QIMEN_PAIRING_TOKEN=...            # mã ghép nối riêng
QIMEN_AI_ROUTER=9router
QIMEN_MODEL=qimen-smart
QIMEN_REASONING_EFFORT=auto
OPENAI_BASE_URL=http://127.0.0.1:20128/v1
OPENAI_API_KEY=...                 # khóa nội bộ router, chỉ ở VPS
QIMEN_TUNNEL_HOSTNAME=ai-origin.kymon.pp.ua
CLOUDFLARE_TUNNEL_TOKEN_FILE=~/.config/kymon-vps/cloudflare-tunnel.token

Tên biến là cấu hình của repo hiện tại. Giá trị thật phải nằm trong file môi trường riêng trên VPS, không dán vào giao diện công khai.

Lệnh vận hành

Systemd

cd /duong-dan/KY-MON-DON-GIAP
bash scripts/install-vps-autostart.sh

sudo systemctl status 9router.service
sudo systemctl status kymon-vps.service

# Sau khi thay source/config:
sudo systemctl restart kymon-vps.service

Nếu app báo ×: kiểm tra theo thứ tự bridge → 9router → Named Tunnel → mã ghép nối → protocol. Không khắc phục bằng cách mở trực tiếp cổng 8765 ra Internet hoặc tắt kiểm tra Host/Origin.

Cập nhật

Khi app web đã đổi protocol

Luôn cập nhật toàn bộ bộ kết nối tương ứng, không chỉ sửa số version trên server cũ. Sau cập nhật, restart bridge rồi kiểm tra lại bằng biểu tượng ↵ trên app. Bộ tải xuống hiện hành được build cùng source của website.