Corptcha 文档

Appearance

AI Agent 接入 ​

让 AI 编码助手（Trae / Claude Code / Cursor / Codex 等）为你的项目一键接入 Corptcha。提供两种方式：直接使用接入文档 或 导入 Skill 技能包。

方式一：使用接入文档（MD） ​

下载接入文档 corptcha-agent-doc.md，将其放到项目任意位置（如项目根目录），然后在对话中告诉 AI：

请阅读项目中的 corptcha-agent-doc.md，按照文档为我的项目接入 Corptcha 人机验证。Site ID 和 Secret 见下方 / 请在控制台创建。

文档包含：前端 SDK 挂载、一次性令牌获取、后端多语言（Node.js / Python / Java / Go / PHP）校验示例、接入检查清单与排错表。

方式二：导入 Skill 技能包 ​

下载 corptcha-integration-skill.zip，解压得到 corptcha-integration/ 目录，按你的 AI 工具放入对应位置：

工具安装位置
Claude Code项目下 .claude/skills/corptcha-integration/
Cursor项目下 .cursor/skills/corptcha-integration/
Trae项目下 .trae/skills/corptcha-integration/
其它 Agent项目任意目录，在对话中说明其路径

安装后重启会话，AI 会识别该技能。之后只需说：

为我的项目接入 Corptcha 人机验证（登录表单 / 注册表单 / 评论……），Site ID 与 Secret 我已填好 / 我稍后提供。

AI 将按技能中的步骤自动完成前端引入、组件挂载与后端校验，并依据检查清单自检。

技能包内容 ​

corptcha-integration/
├── SKILL.md                          # 技能说明与接入流程
└── references/
    └── corptcha-api.md               # API 协议 + 多语言校验示例 + 错误码

在线预览：SKILL.md · corptcha-api.md

接入前你需要准备 ​

  1. 在控制台「站点管理」创建站点；
  2. 复制 Site ID（cpt_ 开头，可放前端）与 Secret（仅放后端）；
  3. 将 Site ID 和 Secret 提供给 AI（或由你填入 AI 生成的代码中）。

安全提示 ​

  • Secret 绝不写入前端代码，只能出现在后端服务端。
  • AI 生成的代码请先检查：后端必须调用 /v1/verify 校验 token（非 200 或 success !== true 即拒绝），不要信任前端传来的布尔值。
  • token 为一次性：重复使用同一 token 会返回 TOKEN_NOT_FOUND。

Corptcha 人机验证

© 2026 Corptcha