接入人机验证 BitCaptcha

<div id="captcha"></div>
<script src="https://shudun.bitbeam.cn/sdk/bitcaptcha.min.js"></script>
<script>
  BitCaptcha.init({
    element: '#captcha',
    captchaId: 'YOUR_CAPTCHA_ID',
    onVerify(err, data) {
      // data.validate 交给后端核销
      if (!err) submitLogin({ captcha: data.validate })
    }
  })
</script>

curl -X POST https://shudun.bitbeam.cn/api/v1/captcha/verify \
  -H 'Content-Type: application/json' \
  -d '{"validate": "前端提交的 validate", "secret_key": "你的 secret_key"}'

r = requests.post(f"{HOST}/api/v1/captcha/verify",
                  json={"validate": validate, "secret_key": SECRET}, timeout=5)
if not r.json().get("result"):
    abort(400, "captcha failed")

const r = await fetch(`${HOST}/api/v1/captcha/verify`, {
  method: "POST", headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ validate, secret_key: process.env.CAPTCHA_SECRET })
}).then(r => r.json());
if (!r.result) throw new Error("captcha failed");

git clone ... shudun && cd shudun
# 改 docker-compose.yml 里的 SESSION_SECRET / PUBLIC_URL
docker compose up -d --build
curl -s http://127.0.0.1:8790/api/v1/health   # {"status":"ok"}

<!-- page.json -->
{ "usingComponents": { "bitcaptcha": "/components/bitcaptcha/index" } }

<!-- page.wxml -->
<bitcaptcha captcha-id="YOUR_CAPTCHA_ID" api-base="https://shudun.bitbeam.cn"
             mode="embed" bind:verify="onVerify" />
<!-- 智能无感知:点一下,安全用户直接过,可疑自动切成拼图 -->
<bitcaptcha captcha-id="YOUR_CAPTCHA_ID" api-base="https://shudun.bitbeam.cn"
             type="sense" bind:verify="onVerify" />

// page.js
Page({ onVerify(e) { const { validate } = e.detail
  wx.request({ url: '/login', method: 'POST', data: { captcha: validate } }) } })

dependencies:
  bitcaptcha_flutter: ^0.6.2

import 'package:bitcaptcha_flutter/bitcaptcha_flutter.dart';

// 嵌入式
BitCaptcha(
  captchaId: 'YOUR_CAPTCHA_ID', apiBase: 'https://shudun.bitbeam.cn',
  onVerify: (r) => login(captcha: r.validate),
)

// 弹窗式:用户关闭返回 null
final r = await showBitCaptcha(context,
    captchaId: 'YOUR_CAPTCHA_ID', apiBase: 'https://shudun.bitbeam.cn');
if (r != null) login(captcha: r.validate);

// 文字点选:BitCaptchaText / showBitCaptchaText(enhanced: bool)
// 智能无感知:点一下,安全用户直接过,可疑自动弹出拼图
BitCaptchaSense(
  captchaId: 'YOUR_CAPTCHA_ID', apiBase: 'https://shudun.bitbeam.cn',
  onVerify: (r) => login(captcha: r.validate),
)

BitCaptcha.init({ ..., lang: 'en',
  i18n: { slide: 'Drag to verify', success: 'Welcome back' } })

#captcha .bc { --bc-primary: #7c3aed; --bc-primary-soft: #ede9fe; }

{
  "mcpServers": {
    "shudun": {
      "command": "python",
      "args": ["integrations/mcp-server/server.py"],
      "env": { "BITBEAM_HOST": "https://shudun.bitbeam.cn" }
    }
  }
}