OPC · 沉思波开放能力

开放能力 · 给你的网站装上沉思波底座

SSO验证码托管计费

把我们自己在用的账号底座、验证码、静态托管，以开放接口的形式给你的网站用。 小微企业、个人开发者、纯前端站都能接：不用自建账号体系，也能有登录、验证与发布。

口径先说死

本页只写能力与接入方式，不写价格表——价格、限额以控制台公告为准；开放接口的路径与参数以控制台文档与接口注释为准；未上线的能力一律标注「建设中」，不写成已有。支付类能力本轮不提供，本页也不写。

一、三块能力

沉思波把自营站点上已验证的三块底座开放出来，按能力单独接、也可组合接：

能力	干什么	适合谁	当前状态
统一身份认证（SSO）	用沉思波账号登录你的网站（授权码模式）	有后端的站	票据登录已在官网 / 论坛 / 控制台链路跑通；对外开放接口建设中，以控制台公告为准
人机验证码 / 短信验证码	算术题人机验证 + 短信码，防刷防轰炸	表单、注册、登录	算术题人机验证与短信码已在登录 / 短信链路运行；对外开放接口建设中，以控制台公告为准
静态托管与发布	纯前端站托管、版本目录 + 软链回滚	活动页、作品集、落地页	版本目录 + 软链回滚在自有发布链路运行；对外开放托管申请建设中，以控制台公告为准

逐块说清：

1. 统一身份认证（SSO）

用沉思波账号登录你的网站——授权码模式：用户在沉思波侧授权，你的服务端拿授权码（code）兑换令牌（token），再解析出用户身份。适合有后端的站：code 兑换与令牌校验都发生在你的服务端，浏览器拿不到 secret。

• 账号底座与官网 / 论坛 / 控制台同一套身份（登录入口），用户不用在你的站上再注册一套；
• 登录后拿到的是身份信息（用户标识、昵称一类的基础字段），不是你站上的业务数据；
• 想要「免密跳转进后台」这类站间票据能力，也在同一底座上（官网控制台单点登录即此机制）。

2. 人机验证码 / 短信验证码

算术题人机验证 + 短信验证码，面向表单、注册、登录这类要挡机器的入口：先过算术题人机验证，再发短信码；服务端带频控，防刷防轰炸。

• 短信发送必须先过人机验证，且按频控放行（不是想发就发）；
• 验证码能力独立成接口，可以只接人机验证、不接短信；
• 适合：活动报名表单、注册登录、敏感操作二次确认。

3. 静态托管与发布

纯前端站托管与发布：静态构建产物托管上云，发布走版本目录 + 软链回滚——每次发布生成一个版本目录，current 软链指向当前版本，出问题一条命令回滚到上一版，数据不受影响。

• 适合：活动页、作品集、落地页、纯前端小工具；
• 不跑你的服务端逻辑，只托管静态文件（HTML / CSS / JS / 图片）；
• 发布与回滚以控制台文档的操作说明为准。

二、怎么接（三步）

1. 在控制台创建应用，拿到 site_key（前端可见）与 secret（只在你服务端保存）；
2. 按能力选接入方式：要登录接 SSO，要防刷接验证码，要上线发布接托管——可以只接一块；
3. 上线后进名录：在「已接入站点」名录（案例墙）展示你的站（见下文，接口就绪后生效）。

开发文档已成套（2026-10-28 起逐步发布）：完整接入步骤、示例请求与响应见开放能力接入总览，分篇是统一登录 · 验证码 · 静态托管 · 后台管理 · 计费与额度。用开发助手代接的，可装 chensibo-opc Skill（随官网仓库 chensibo-skill/ 分发），让 Agent 按同一契约写代码。

示意调用形状（路径口径以控制台文档与接口注释为准——下表按 community-api 开放能力模块（opc-sso / opc-captcha / opc-hosting）路由表对齐，最终契约以接口注释为准）：

# 统一身份认证（授权码模式）
GET  /api/open/sso/authorize    # 跳转授权页，回跳你登记的 redirect_uri，带 code
POST /api/open/sso/token        # 服务端用 code + client_secret 兑换令牌
GET  /api/open/sso/userinfo     # Bearer 令牌取身份（脱敏字段，不吐明文邮箱）
POST /api/open/sso/revoke       # 吊销令牌

# 人机验证码 / 短信验证码
GET  /api/open/captcha/challenge   # 取一次性算术题
POST /api/open/captcha/verify      # 提交答案，换一次性 ticket
POST /api/open/sms/send            # 凭 ticket 发短信码（三重频控）
POST /api/open/sms/verify          # 验短信码，换一次性 sms_ticket

# 静态托管与发布（建设中 · 控制台管理口）
POST /api/console/opc/hosting/:slug/deploy     # 上传构建产物，生成新版本目录并切 current 软链
POST /api/console/opc/hosting/:slug/rollback   # 软链回滚到指定版本

# 已接入名录（只读）
GET  /api/open/partners     # 只读名录（只回公开字段），页面案例墙从这里取数

接入侧的账目就两笔：前端几行脚本（跳授权 / 取验证），后端一次 code 兑换（或一次验证码校验）。secret 只走服务端，详见下文「安全与边界」。

三、小微企业开放能力包（OPC）

不开自建账号体系，也能有登录、验证码、上线发布。 这是「小微企业开放能力包」的全部意思：把你本来要自己写的账号系统、验证模块、发布链路，换成接入沉思波开放能力——省下的是自建与维护一套账号底座的活。

适用场景：

场景	接什么
社团 / 工作室的官网	SSO 登录（成员用沉思波账号进后台）+ 静态托管发布
课程项目 / 课程作业站	静态托管发布 + 验证码（挡脚本刷提交）
门店活动页 / 活动报名	验证码（报名表单防刷）+ 静态托管（活动页上线）
作品集 / 落地页	静态托管发布，版本目录 + 软链回滚
个人开发者的纯前端站	验证码 + 托管；有后端再加 SSO

接入成本量级（能力口径，不是报价）：前端几行脚本、后端一次 code 兑换或一次验证码校验，即可跑通登录 / 验证 / 发布中的任意一块。价格与限额未在本页写明的，一律「按公告」——控制台可见；本页不写价格表，也不承诺未写明的额度。计费口径（免费额度起步、超量付费，具体以控制台与公告为准）展开见计费与额度。

四、安全与边界

• 密钥只在服务端：secret 不发到浏览器、不进前端仓库、不写进页面；前端只带 site_key。
• redirect_uri 登记制：授权回跳地址在创建应用时登记，只回跳登记过的地址，不接受任意地址回跳。
• 短信需先过人机验证：短信发送前置人机验证 + 服务端频控，防刷防轰炸。
• 我们不代管你的业务数据：开放能力只提供登录 / 验证 / 托管底座，你的用户资料、订单、内容等业务数据归你自己管、你自己存。
• 隐私：账号与验证涉及的个人信息处理口径见隐私政策。

五、已接入站点（案例墙）

数据来源：后端只读名录接口 GET /api/open/partners——页面只展示名录里登记的站，不在前端写死客户名单。

建设中：名录接口就绪前，本区块暂为「征集中」——还没有可展示的已接入站点，就不写；不编造客户名、不放占位假站名。接口就绪后，登记过的站点（站点名 + 一句话简介 + 站点入口）会从名录拉取展示在这里。

想上墙：接入任一开放能力并上线后，在联系我们登记站点信息（站点名 / 简介 / 入口 / 接了哪块能力），核对后进名录；下线或换地址也走同一入口改。

六、开始接入

1. 到控制台创建应用，拿 site_key 与 secret；
2. 按上文「怎么接」选能力接进去——手把手步骤与示例在接入总览（分篇见 SSO / 验证码 / 托管 / 后台 / 计费）；要让开发助手代接，装 chensibo-opc Skill（chensibo-skill/skills/chensibo-opc/）；
3. 卡住了、要谈限额与商务口径，走联系我们——写清站点形态（有无后端）、想接哪块能力、大概体量。

---

口径说明

本页只写能力口径与接入方式；开放接口的路径与参数以控制台文档与接口注释为准，价格与限额以控制台公告为准，未上线能力标注「建设中」不写成已有。合作与代理口径见合作模式 · 加入我们，定制开发与技术服务见官方小店，成品交付见客户案例。