KJiaoShou LocalDetect-Go API
與 Python 版 LocalDetect 保持相同接口契約，供雲機中控台遠程調用。
GET /health
健康檢查，無需鑑權。
{
"status": "正常",
"service": "KJiaoShou - 本地驗證碼識別服務端",
"version": "1.0.0"
}
POST /detect
上傳全屏截圖，識別滑塊箭頭與缺口，回傳滑動距離。
- Content-Type:
multipart/form-data - 欄位名:
file（PNG/JPEG） - Query:
debug=true可保存標註圖到 debug_output/ - 若設定
LOCAL_DETECT_TOKEN，需帶Authorization: Bearer <token>或X-API-Key
curl -X POST "http://127.0.0.1:8765/detect" \ -H "Authorization: Bearer YOUR_TOKEN" \ -F "file=@screenshot.png"
{
"success": true,
"distance": 123,
"arrow": { "class": "箭頭", "confidence": 0.91, "x": 10, "y": 20, "width": 30, "height": 40 },
"gap": { "class": "缺口", "confidence": 0.88, "x": 120, "y": 22, "width": 32, "height": 38 },
"detections": [ ... ]
}
識別失敗時 HTTP 422，success=false 並附 error 字段。
環境變量
LOCAL_DETECT_HOST=0.0.0.0 LOCAL_DETECT_PORT=8765 LOCAL_DETECT_TOKEN=your-secret LOCAL_DETECT_MODEL=/opt/localdetect/dy.onnx LOCAL_DETECT_ORT_LIB=/opt/localdetect/lib/libonnxruntime.so.1.26.0 LOCAL_DETECT_MAX_UPLOAD_MB=10