OPC · 接入总览

开放能力接入总览

把你本来要自建的账号体系、验证模块、发布链路，换成接入沉思波开放能力——统一登录、验证码、静态托管三块，按需单接或组合接。

SSO验证码托管计费

口径先说死

本章只写接入契约与操作步骤。价格与限额不写数字价目——免费额度 + 超量付费，具体档位以控制台与公告为准；接口路径与参数以本文与服务端注释为准；未提供的能力不写成已有。能力背景与适用场景见开放能力。

适用谁

官网 / 活动页

小微企业、个体老板的站：要登录、要防刷、要上线，不想自建一整套。

纯前端站 / 小后端站

个人开发者、工作室、社团的项目——前端几行脚本就能接起第一块能力。

课程项目与作品集

学习 → 上线五课（课 A–E）用免费额度就能做完并上线。

接入三步

1

建应用

到控制台「开放能力」（#/opc）创建应用，拿到 site_key（前端可见）与 secret（只放你服务端，只显示一次）。

2

选能力接

要登录接统一登录 SSO，要防刷接验证码，要发布接静态托管——可以只接一块。

3

上线进名录

接入任一能力并上线后，到联系我们登记站点信息，核对后进「已接入站点」名录（见开放能力 · 案例墙）。

三块能力

统一登录（SSO）

用沉思波账号登录你的站（授权码模式）。

典型场景：会员区、后台、报名身份

sso.html 接入文档 →

人机验证码 / 短信验证码

算术题人机验证 + 短信码，防刷防轰炸。

典型场景：表单、注册、登录、敏感操作

captcha.html 接入文档 →

静态托管

纯前端构建产物托管，版本目录 + 软链回滚。

典型场景：作品集、活动页、落地页

hosting.html 接入文档 →

三块共用同一个应用（同一个 site_key / secret）与同一份配额账（quota_daily），用量明细在后台管理的应用详情里看。

文档地图

接入总览（本页）

给决定「接不接、接哪块」的人：三步、能力表、边界。

index.html →

统一登录接入

给写登录链路的开发者：授权码时序、示例请求与响应、安全边界。

sso.html →

验证码接入

给写表单 / 注册的开发者：challenge/verify、短信 send/verify、频控。

captcha.html →

静态托管

给要把纯前端站发出去的人：建站、发布、回滚、限制。

hosting.html →

后台管理文档

给管应用与配额的人（含管理员）：控制台怎么用、权限、审计。

console.html →

计费与额度

给关心「免费到哪、超量怎么算」的人：免费额度口径、什么可能收费。

billing.html →

开放能力 · 能力总览

给老板 / 决策者：三块能力的业务叙事、案例墙。

open-platform.html →

也可以不读文档、直接让开发助手代接：仓库分发的 chensibo-opc Skill（见开放能力页「开发者接入」段）能让 Agent 按本章契约写代码。

两个硬前提

红线（两条都不可绕）

secret 只在服务端：创建应用时明文只回一次，不进前端仓库、不写进页面、不进 URL。前端只带 site_key。

redirect_uri 登记制（接 SSO 才有关）：回跳地址必须在应用登记范围（allowed_origins / 站点地址）内，不接受任意地址回跳。

常见坑

• 把 secret 发到浏览器：任何前端可见的渠道（仓库、页面、小程序包）都等于泄露。泄露了立刻到后台轮换。
• 授权码当长期令牌：code 一次性、约 90 秒过期，只能在服务端换令牌；拿 code 当登录态存会随机失效。
• 验证码接口当无限用：每个应用有日配额（quota_daily），超了回 429——先看计费与额度。
• 托管当服务器用：只托管静态文件，不跑你的服务端逻辑；扩展名白名单与体积限制见静态托管。

下一步

• 决定接哪块 → 从统一登录 / 验证码 / 托管挑一篇往下走；
• 先把应用建好 → 后台管理文档 · 建应用；
• 想弄清免费到哪 → 计费与额度；
• 想跟课做完一个作品集 → 学习 → 上线五课。