xhh678876/openclaw-sjtu/shuiyuan-rag-service

# 手动启动
~/openclaw-sjtu/.venv/bin/python -m uvicorn shuiyuan_rag_http:app \
  --host 127.0.0.1 --port 9111 --workers 1
 
# 走 launchd plist(推荐 — 开机自启 + 崩了自动拉起)
launchctl load ~/Library/LaunchAgents/com.dahui.shuiyuan-rag.plist
launchctl start com.dahui.shuiyuan-rag
launchctl list | grep shuiyuan-rag
 
# plist 模板: ~/agents-chat/gateway/deploy/com.dahui.shuiyuan-rag.plist

# 健康检查 — 报告 lifespan 是否完成预加载
curl -s http://127.0.0.1:9111/healthz
# → {"ok": true, "ready": true}
 
# 搜索
curl -sS -X POST http://127.0.0.1:9111/search \
  -H "Content-Type: application/json" \
  -d '{"query":"教务选课流程","max_results":5,"recency_days":null}'
 
# KB 统计 — 总帖数 + 类别分布
curl -sS -X POST http://127.0.0.1:9111/stats

{
  "query":        "string, 1-200 chars (required)",
  "category":     "string | null  — 限制板块",
  "min_likes":    0,
  "max_results":  5,        // 1-20
  "recency_days": null,     // null = 全时段; 1-1825 = 近 N 天
  "time_weight":  0.3       // 0.0-1.0,越大越倾向新帖
}

{
  "query": "...",
  "total": 5,
  "low_confidence": false,   // BGE-reranker 平均置信度低于阈值时 true
  "hits": [{
    "title": "...",
    "excerpt": "...(<=1500 字)",
    "author": "...",
    "category": "...",
    "likes": 0, "views": 0,
    "created_at": "2024-...",
    "url": "https://shuiyuan.sjtu.edu.cn/t/topic/...",
    "confidence": 0.87,
    "is_protected": false
  }]
}

SHUIYUAN_KB_PATH        默认 /Users/xiehaohui/openclaw-sjtu/scripts/shuiyuan_kb
SHUIYUAN_LOCAL_BYPASS   "1" = 包含 protected 帖(运营者明确开放,可能有隐私)
                        "0" = 只搜公开表(默认,生产)

lobster-gateway (Next.js)  →  127.0.0.1:9111/search  →  BGEM3 + LanceDB
shuiyuan-search MCP client →  同上                   →  共享一份内存模型