#MoonCaptcha

#项目简介

#核心特性

• 滑动拼图：拖动滑块，将拼图块对准底图缺口即可完成验证；
• 文字点选：按提示顺序依次点击图片中的文字，即可完成验证；
• 图形验证码（保留）：面向不支持脚本执行、无障碍访问、嵌入式环境受限或仍依赖传统字符验证的场景。

• 弹出式：点击触发，以浮层形式呈现，适合登录弹窗等场景；
• 嵌入式：直接嵌入表单页面，适合注册、评论等表单场景；
• 同一套验证逻辑，可适配登录弹窗、表单页面、独立验证页及移动端界面。

• 验证码由服务端生成，前端交互结果仅作为校验输入；
• 验证码令牌一次性使用，防重放攻击；
• 校验答案匹配、有效期与请求上下文，不信任前端提交的结果。

• 核心验证逻辑使用 MoonBit 实现，可编译到 WASM / JS / Native 等多种目标；
• 同一套核心代码可在浏览器、服务端与边缘环境中复用，降低多端接入成本。

#工作原理

sequenceDiagram
    autonumber
    participant C as 前端 (Client)
    participant S as 后端 (Server / MoonCaptcha)

    C->>S: 请求验证码
    S-->>C: 返回底图、拼图/点选数据与验证码令牌
    C->>C: 用户完成滑动/点选交互，采集行为结果
    C->>S: 提交互结果 + 验证码令牌
    S->>S: 二次校验：令牌、答案、时效性、请求上下文
    S-->>C: 返回人机验证结果
    Note over C,S: 校验通过后，业务流程继续

1. 业务前端向业务后端请求验证码；
2. MoonCaptcha 生成底图与拼图 / 点选数据，并返回一次性验证码令牌；
3. 用户完成滑动或点选交互，前端采集交互结果（如滑动距离、点击坐标）；
4. 前端将交互结果与验证码令牌一并提交至后端；
5. 后端进行二次校验：令牌有效性、答案匹配、时效性与请求上下文；
6. 校验通过后返回验证结果，业务流程继续。

#项目状态与路线图

🚧 MoonCaptcha 目前处于规划设计阶段，接口与模块划分尚未定型，欢迎通过 Issue 参与讨论。

#快速开始

node demo/server.js
# → http://localhost:3000

#相关项目

• AJ-Captcha — 本项目的移植来源，行为验证码（滑动拼图、点选文字）
• MoonBit / MoonBit 文档 — MoonCaptcha 所使用的开发语言

#参与贡献

1. Fork 本仓库并创建你的分支；
2. 提交更改；
3. 发起 Pull Request。

#开源协议与致谢

• 本项目基于 MIT License 开源；
• 感谢 AJ-Captcha (anji-plus/captcha)（Apache-2.0）提供的设计灵感与移植基础。