学习 → 上线路线图

在沉思波学开发 → 用我们的产品与开放能力做出来 → 上线自己的项目 → 进社群。 把「学习 → 开发 → 上线 → 社群」这条闭环拆开看，每段都有真实入口：前半段在学习中心与教学实验室学，中段拿开放能力（登录 / 验证码 / 托管）把自己的站做出来并上线，后半段进用户社群、投稿项目广场留下名字。

适合谁：小微企业 / 个人开发者 / 工作室 / 社团 / 课程项目——想把自己的作品集、活动页、课程作业或社团官网做出来并上线的人。

口径先说死：本页不写价格表；开放接口的路径与参数以开放能力与控制台文档为准；未接通的能力在课内标注「建设中」，接通后即可实操，不写成已有；社群、项目广场与证书的制度口径以用户社群、项目广场、加入合作为准，本页不重复造制度、不承诺收益。

一、六步走完这条闭环

步骤	做什么	真实入口
1. 注册	注册 / 登录沉思波账号——官网、论坛、控制台同一套身份	登录 · 控制台
2. 学	学开发：术语图鉴、需求四要素、课程体系；教学实验室看课程架与讲义	学习中心 · 教学实验室
3. 做	开发你的站：按需求四要素提需求，用 AI 编程把作品做出来	需求四要素 · 术语图鉴
4. 接	接开放能力：「用沉思波登录」（SSO）、人机 / 短信验证码	开放能力 · 控制台
5. 上线	纯前端产物发布上线：版本目录 + 软链回滚，访问 /sites/<slug>/	开放能力 · 静态托管
6. 留下	进社群互助、投稿项目广场、上案例墙 / 名字墙	用户社群 · 项目广场

六步不是六件大事：第 2、3 步在学习中心与教学实验室完成，第 4、5 步就是下面「开放能力实战」五课，第 6 步是课 E。按顺序读完五课，你手里的贯穿项目——做一个自己的作品集（或活动页）并上线——就从一句话变成一个能访问的网址。

二、开放能力实战 · 从学习到上线（五课）

五课按 A → E 排：拿到 site_key → 加登录 → 表单防刷 → 上线 → 进社群。每课含目标、前置、步骤、常见坑与下一步；状态照实写——正文已上线可先读，开放接口未接通处标注「建设中，接通后即可实操（以开放能力页为准）」。

课 A · 拿到你的第一个 site_key

目标：注册沉思波账号，在控制台创建属于你的应用，拿到 site_key 与 secret——这是后面每一课的钥匙。

前置：一个可用的邮箱；想清楚你要做的站叫什么、部署在哪个地址（贯穿项目建议先定「作品集」或「活动页」）。

步骤：

1. 注册 / 登录沉思波账号：走登录入口。账号与官网、论坛、控制台同一套身份，注册一次全站通用——这正是后面「用沉思波登录」能成立的原因。
2. 进控制台创建应用：找到开放能力（OPC）面板，新建应用，填三项：应用名（建议带用途，如 my-portfolio-web）、站点地址、回跳地址 redirect_uri（要登录才需要，先登记好，授权后只回跳登记过的地址）。
3. 复制两个凭证：site_key 是前端可见的站点标识，可以写进页面脚本；secret 是服务端密钥，只在创建（或轮换）时显示一次，抄进你的服务端配置后不要再外传。
4. 贯穿项目启动：给你的作品集建好这个应用，把 site_key 记在项目配置里，secret 放服务端环境变量——后面四课都在这个应用上做。

常见坑：

• secret 写进前端代码或前端仓库——浏览器能读到的东西都不叫密钥；把它交给 AI 助手时也别贴进聊天记录，放环境变量。
• redirect_uri 随手填——授权后回跳不上，是因为只回跳登记过的地址；本地调试先登记本地地址，上线再改。
• 一个应用混多种用途分不清——应用名带用途与环境（如 -web / -test），后面上线、查用量都清爽。

下一步：应用在手，先给网页加登录——课 B · 给你的网页加上「用沉思波登录」。

课 B · 给你的网页加上「用沉思波登录」

目标：理解 SSO 授权码流程，按「纯前端站 / 有后端站」两种接法，给你的站加上「用沉思波登录」。

前置：课 A 的应用与 site_key / secret；一张能跑起来的网页（贯穿项目的作品集页面即可，本地能打开就行）。

步骤：

1. 先懂概念：授权码流程。用户点「用沉思波登录」→ 跳到沉思波侧授权页 → 用户点「同意」→ 回跳你登记的 redirect_uri，带上一次性授权码 code → 你的服务端拿 code 加 secret 兑换令牌 token → 用令牌取用户身份（用户标识、昵称一类基础字段）。关键只有一句：code 兑换与令牌校验都发生在服务端，浏览器永远拿不到 secret。
2. 有后端站的标准接法：前端放登录按钮跳授权地址（带上你的 site_key 与 redirect_uri）；后端写两个动作——收 code 兑换令牌、带令牌取身份，然后按你自己的会话方式把用户「记在你的站上」。示意路径（授权 / 兑换 / 取身份）见开放能力，以开放能力页与接口注释为准。
3. 纯前端站的接法：没有服务端就不能保管 secret，硬拿 JS 兑换令牌等于把密钥公开。两条正路：一是加一层极薄的服务端（云函数 / 轻后端）只做 code 兑换与身份校验；二是先只做「跳转授权」的入口与说明，身份入库等你有服务端再补。开放能力页给纯前端站的建议是先接验证码与托管，有后端再加 SSO——按这个顺序走不绕路。
4. 贯穿项目：给作品集加一个「用沉思波登录」按钮。有后端的走完整链路；纯前端的先放按钮与说明文案，把跳转地址留好。开放接口建设中的阶段，先把授权地址、回跳地址与后端兑换逻辑的架子写好，接通后即可跑通（以开放能力页为准）。

常见坑：

• 把 secret 放进前端「图省事」——这一条没有例外；谁能看到页面源码，谁就拿到了你的密钥。
• 回跳地址不校验 state——授权流程建议带一次性 state 参数防跨站请求伪造，回调时比对一致才认。
• 把登录拿到的身份当你站上的业务数据——开放能力给的是身份（谁在登录），用户的资料、订单、内容归你自己管、你自己存。

下一步：登录有了，表单别裸奔——课 C · 表单防刷：人机验证码与短信码。

课 C · 表单防刷：人机验证码与短信码

目标：给报名表单、注册登录这类入口加上防刷：算术题人机验证 + 短信验证码，理解「为什么必须先过人机验证」。

前置：课 A 的应用；一张带输入框的表单（贯穿项目的作品集「联系我」或活动页「报名」表单）。

步骤：

1. 为什么先过人机验证：短信通道有成本，脚本一刷就是成百上千条；算术题人机验证先挡掉机器，服务端频控再挡住人工轰炸——短信发送必须先过人机验证，这是接口的固定顺序，不是可选项。验证码能力也独立成接口：可以只接人机验证、不接短信。
2. 接人机验证：进表单时向服务端取一次性算术题（challenge），用户作答后提交换一次性 ticket；校验失败就换一题，不给反复试。
3. 接短信码：凭 ticket 发送短信码（服务端按频控放行，不是想发就发）；用户填码后验码，换一次性短票据，你的表单拿这张票据才算「验证通过」。示意路径（取题 / 校验 / 发短信 / 验码）见开放能力，以开放能力页与接口注释为准；开放接口建设中的阶段先把表单流程与错误提示写好，接通后即可实操。
4. 贯穿项目：给活动页报名表单加上这两道：提交前先过算术题，手机号一栏走短信码——脚本刷提交的路就堵住了。

常见坑：

• 只做前端校验就当防刷——隐藏输入框、按钮置灰都拦不住直接打接口的脚本；验证必须在服务端判。
• 跳过人机验证直接发短信——等于给刷短信的人开闸；ticket 被复用同理，票据都是一次性的。
• 验证码没有有效期与频控——取题、发码都要带过期时间与频次限制，否则旧票据能一直用。

下一步：表单安全了，把站发出去——课 D · 纯前端项目一键上线。

课 D · 纯前端项目一键上线

目标：把纯前端产物（HTML / CSS / JS / 图片）发布上线，弄懂版本目录与软链回滚，拿到属于你的 /sites/<slug>/ 访问地址。

前置：一个能构建出静态文件的项目（贯穿项目的作品集，构建产物是一个文件夹就行）；课 A 的应用（托管站点与应用在控制台同一处管理）。

步骤：

1. 先认清适用范围：静态托管只托管静态文件，不跑你的服务端逻辑——作品集、活动页、落地页、纯前端小工具正合适；要跑服务端，那是另一回事（开放能力的登录 / 验证码仍可单独接）。
2. 发布：在控制台的托管管理口创建站点（拿到你的 slug），上传构建产物生成新版本目录，current 软链切到新版本——发布即生效，访问 https://chensibo.cn/sites/<slug>/。
3. 回滚：新版本有问题，一条命令把 current 软链指回上一版，数据不受影响；每次发布都留版本目录，就是为了这一刻。发布与回滚的具体操作以控制台文档为准。
4. 贯穿项目：把作品集构建产物发上去，拿到 /sites/<slug>/ 的地址——从「本地能打开」到「全世界能访问」，这一步只花几分钟。开放托管申请建设中（见开放能力），申请通道开放后按上面流程走，接通后即可发布。

常见坑：

• 拿静态托管跑后端——托管不执行服务端代码，接口放上来只会 404；前后端要分开想。
• 直接在当前目录上覆盖文件——没有版本目录就没了回滚点；走发布入口生成版本，别手动覆盖。
• slug 与路径拼错——访问地址是 /sites/<slug>/，末尾带不带斜杠、slug 大小写都按控制台给的为准。

下一步：站上线了，别让它孤零零挂着——课 E · 上线之后：进社群与项目广场。

课 E · 上线之后：进社群与项目广场

目标：把上线的项目带进社群：会进用户社群、会投稿项目广场，知道名字墙与证书的口径在哪看。

前置：一个已上线的作品（课 D 的 /sites/<slug>/ 地址，或你自己已有的站）；一个沉思波账号（课 A）。

步骤：

1. 进用户社群：站内交流区邮箱注册即用，微信群入口与开放节奏见社群页。进社群能做的：提问答疑、看产品更新、提需求、找同行——社群公约就在该页，只谈产品、技术与合作。
2. 投稿项目广场：实验室成员可自主投稿想做的项目（缺资金 / 缺技术均可提）——官方主导：官方提供平台、渠道、资源与点子支持，成员对等付出；参与即在名字墙留名、参与即发项目证书（编号连续可查）。投稿流程、清退与结算条款以项目广场与加入合作口径为准，本课不重复造制度，也不承诺收益。
3. 留下名字：接入开放能力并上线的站，可在开放能力的「已接入站点」名录（案例墙）登记展示——站点名、一句话简介、入口、接了哪块能力，登记入口见该页；项目侧的名字墙与证书走项目广场口径，两条线各自清楚。
4. 贯穿项目收尾：把你的作品集地址发进社群、按项目广场口径投稿或登记——从「上线了」到「有人看见」，这一步是分界线。

常见坑：

• 把证书当收益承诺——口径是参与即挂名、参与即发证书，分成与出资按合作模式与项目协议来，证书本身不等于收益。
• 把社群当广告位——公约写明只谈产品、技术与合作，违规内容由管理员处理。
• 登记案例墙时夸大状态——没接完的能力别写「已接入」，照实写接了哪块、还在建哪块。

下一步：五课读完，闭环就走通了。往上是合作模式与加入实验室的进阶路径，往下是随时可查的学习中心。

三、你不是一个人在做

这条路上的每个环节都有人接应，不是一个人闷头做：

• 社群互助：用户社群里提问、反馈、需求共创，由真人团队查看与回复；接入问题可以直接在对应产品或文档页发帖。
• 项目协作：项目广场公开在营项目的活力、分工与缺口——缺人缺技能的项目在等合适的人；对等付出、官方主导。
• 投稿立项：有想法可以按项目广场口径投稿立项，通过即挂发起人；想走更进一步的代理、运维与合作，看合作模式与加入合作 · 四层身份。

口径与项目广场、加入合作一致：参与即挂名、参与即发证书，不承诺收益；结算与清退条款以项目协议为准。想先聊项目，走联系我们。