可选功能与部署检查
6.1 事务邮件:权益通知等(可选)
先区分两条独立的发送链路:
| 邮件 | 凭据保存位置 | 是否需要应用调度 |
|---|
| 登录验证码/登录链接 | Supabase 的 SMTP Settings | 不需要 |
| 付款后的权益通知、停售通知、订阅到期提醒 | Vercel 的 RESEND_API_KEY 与 EMAIL_FROM | 权益队列需分钟调度;到期提醒使用每日任务 |
能收到登录邮件,只证明 Supabase SMTP 可用,不代表 Vercel 的事务邮件变量已填写。 /admin/setup 中“事务邮件环境配置”检查的是后一组,不读取 Supabase 的 SMTP 密码。
- 第 5.2 节已经验证的 Resend 发件域可继续使用,无需重复添加 DNS。到 Resend → API Keys → Create API Key,为应用创建一枚 Sending access 密钥并限制到该域,方便与登录 SMTP 分别轮换;也可使用已有、权限匹配的发送密钥。
- 将完整原值填入 Vercel Production 的
RESEND_API_KEY,Type 选 Secret。不要填 Supabase key 或把 Bearer 一并填入。
EMAIL_FROM 选 Config,填已验证域下的发件人,例如 我的站点 <no-reply@auth.example.com>。在 Vercel Value 中不加外层引号;本机文件可写 EMAIL_FROM="我的站点 <no-reply@auth.example.com>"。它是邮件的发件人,不是买家地址或站主登录邮箱。
- 与其余选定功能的变量一起保存并重新部署,再按 6.3 配置自动任务。仅填这两个值不会自动建立每分钟发信任务。
- 对一笔自己同意接收通知的测试购买,核对队列发送记录、Resend 投递状态及买家实际收件,确认只收到一次。若同时测试收款,使用同一笔小额订单即可,无需为邮件重复付款。
未启用事务邮件时,业务通知可能留在队列;日后启用前按邮件运维核对积压,避免误发历史通知。独立停运监控是可选增强,基础发信无需注册其他监控服务。
6.2 在线支付(可选)
本项目已内置 zpay/易支付兼容协议的接入:买家在本站下单后,应用会跳转到支付平台收银台,并向同一平台查询付款结果。你需要先在支付平台开通商户与支付渠道,再填写下面三个参数。
ZPAY_BASE_URL 填的是支付平台提供的接口根地址,不是你的网站地址。获取方法如下:
-
登录你已开通的支付平台商户后台,打开 API 信息/接口信息,找到接口根地址;若后台只提供文档链接,打开文档的 页面跳转支付 → 请求 URL。不要选择“API 接口支付”的其他接入方式。
-
以 ZPAY 官方开发文档为例,“页面跳转支付”的请求 URL 是 https://zpayz.cn/submit.php。其中 /submit.php 是 ZPAY 平台的支付接口路径,不是本站的文件,也不要求你部署 PHP。使用该平台的商户在 .env.local 中填写:
ZPAY_BASE_URL=https://zpayz.cn
-
本项目会在这个地址后自动追加 /submit.php 发起支付、追加 /api.php 查询订单,因此这里只记录接口根地址,不包含 /submit.php、/api.php、订单参数或签名。如果你签约的是另一家兼容平台,使用它自己提供的 HTTPS 接口根地址;对照它的“页面跳转支付”请求 URL,去掉末尾 及查询参数即可核对,不直接照抄 ZPAY 的域名。
/submit.php
及时将取得的地址与商户资料记录到 .env.local,再按下表填写完整参数组:
| Vercel Production 变量 | 从哪里取得 | 填写方法 |
|---|
ZPAY_BASE_URL(Config) | 上述商户后台的接口根地址,或按“页面跳转支付”请求 URL 核对 | 使用 ZPAY 官方文档所示平台时填 https://zpayz.cn;其他兼容平台填自己的接口根地址 |
ZPAY_PID(Config) | 同一平台商户后台的 API 信息/接口信息 | 商户 ID(pid),不是订单号、支付渠道 ID 或支付宝账号 |
ZPAY_KEY(Secret) | 上述同一商户的接口信息 | 商户通信密钥,不是商户后台登录密码 |
- 三项一起填写,和其他变量一并保存、重新部署。
- 在本站后台「站点设置 → 首页与导航 → 在线收款」开启开关,仅勾选已签约渠道,保存。设置要销售的单篇/专辑价格或年度订阅价格,前台收费方案读取这些真实设置。
- 应用用当前
SITE_URL 为新订单生成 /api/payments/notify 通知地址与订单返回地址,无需把每笔订单的链接抄回环境变量。直接在浏览器打开通知地址没有平台签名,返回 fail 属于预期,不能作为支付验收。
- 按 6.3 配置每分钟查单补漏;再由普通买家购买自己的小额测试商品。核对支付平台已付、本站订单已付、对应正文解锁、订单能打开所购文章或专辑。只打开收银台不算付款成功。
- 按支付运维说明核对同一笔订单重复通知后的权益与邮件任务唯一性。不要手工把订单改为已付,不为排错反复付款。
年度订阅到期后,订阅带来的权限自动失效,不依赖提醒任务;已单独购买的永久文章/专辑权益不受影响。
6.3 自动任务:邮件发送、查单与到期提醒
需要事务邮件、支付补单或订阅到期提醒时配置本节。仅登录邮件或分身不需要这些任务。
- 在自己的终端运行
openssl rand -hex 32,生成另一份随机值,保管完整输出。将它填入 Vercel Production 的 CRON_SECRET(Secret),不带 Bearer,与 PUBLISH_TOKEN 使用不同值。把选定功能的变量一起保存后重新部署。PUBLISH_TOKEN 用于发布内容;CRON_SECRET 仅授权维护任务,便于独立轮换。
- 确认正式固定域名可匿名访问,不受 Vercel 登录保护。任务发送的是带鉴权头的服务请求,不使用浏览器登录会话。
- 根据启用的业务选择下表任务。填写变量只解决鉴权,不等于分钟任务已经建立或运行。
| 业务 | 调度方式 | 操作入口 |
|---|
| 权益通知队列 | 每分钟调用 /api/cron/mail-outbox | 按邮件调度:SQL Editor 执行 01-enable.sql → Vault 保存 URL/密钥 → 02-prepare.sql → 核对队列后 03-start.sql → 04-status.sql |
| 支付查单补漏 | 每分钟调用 /api/cron/payment-reconcile | 按支付调度准备、启用并查询状态;复用下述 Cron 密钥,不新生成另一份 |
| 订阅到期提醒 | Vercel 每日执行 /api/cron/expiry-reminder | 已在 vercel.json 声明;Production 配好 CRON_SECRET 后,在 Vercel 项目的 Cron Jobs / Crons 查看执行日志,无需创建分钟任务 |
分钟调度的 SQL 文件从当前源码打开并复制完整内容,在 NEXT_PUBLIC_SUPABASE_URL 对应项目 → SQL Editor 执行,使用默认 postgres 角色;不用在本机安装数据库。Vault 在同一 Supabase 项目管理,用表单保存秘密,不把密钥写进 SQL 历史:
| Vault 名称 | 填什么 |
|---|
wanyou_mail_worker_url(启用邮件队列时) | https://你的正式域名/api/cron/mail-outbox |
wanyou_mail_cron_secret(两种分钟任务共用) | Vercel Production 环境变量 CRON_SECRET 的完整原值,不含 CRON_SECRET= 或 Bearer |
wanyou_payment_reconcile_url(启用支付查单时) | https://你的正式域名/api/cron/payment-reconcile |
上述新装流程使用独立 CRON_SECRET,邮件和支付调度共用它。已有外部调度也兼容 PUBLISH_TOKEN;若明确沿用该方式,Vault 的 wanyou_mail_cron_secret 保存 PUBLISH_TOKEN 的完整原值,无需修改 Vercel 的两项变量。字段名称不表示两份环境变量的值相同。密钥从新站本机配置底稿取得,不凭旧部署的记录猜测。
准备步骤不发送业务请求;启动步骤会开始实际任务,邮件可能真实送达。首次启用前按相应运维指南核对队列和订单。连续两次任务成功只能证明调用链正常,仍需核对一次非空业务任务的结果。任务失败时查看 Supabase 调度记录与 Vercel 函数日志,不重复启动或盲目重发。
6.4 AI 设置与站主分身(可选)
模型接口、API Key、知识库和分身都在本站后台 站点设置 → AI 设置(/admin/ai)配置,不需要新增 Vercel 变量或重新部署。
- 准备生成连接:在选用的模型平台创建 API Key,并从其模型列表取得准确的模型标识。后台提供 DeepSeek、硅基流动、OpenAI 和 Anthropic 的受信接口根地址;按平台文档选择 Chat Completions、Responses 或 Anthropic Messages 协议,不填控制台网页或完整请求路径。后台页面初稿与分身共用此连接,但提示词和内容互相独立。
- 准备向量连接:在硅基流动创建有目标模型权限的 API Key,知识库选用
https://api.siliconflow.cn/v1 的 BAAI/bge-m3 原生 1024 维模型。如果生成也使用同一硅基流动账户,可勾选显式复用 Key;生成使用 DeepSeek 等其他平台时,须另填硅基流动的 Key。支持生成 API 不等于提供向量模型。
- 填写连接、模型与 Key,点击 保存全部 AI 配置。密钥保存后不回显;留空保留同一平台的现有 Key。更换接口根地址须填写该平台对应的 Key;更换模型或协议后也须重新检查。
- 在 1.准备内容与连接 勾选允许发送固定合成测试文字,分别检查生成和向量连接。每次最多两次外部请求,可能计费;不会读取文章,也不会自动重试。结果显示在对应按钮下方;失败时按提示核对目标、Key 和账户权限。
- 在 知识库索引 按编号步骤操作:核对内容 → 选择首次初始化 → 确认文字发送范围 → 开始建立索引。任务建立后会连续处理批次;显示“索引已生成”后,核对范围并确认启用。检索效果检查可跳过,不作为启用门槛。可直接使用自己的已发布内容,不要求导入示例。详细操作见 6.6 节。
- 编辑 分身指令,勾选启用知识库分身并保存。固定权限与引用规则不可编辑;连接或知识库未就绪时,前台隐藏分身入口。没有相关资料时不调用生成模型,不提供通用聊天。
- 用普通账户提问公开内容、未购内容和库外问题,打开回答中的来源链接,确认没有越权正文。需要匿名提问时,再完成 6.5 节并打开允许匿名提问。
只使用后台页面生成时,完成生成连接的保存与检查即可,不必启用分身或构建知识库;生成结果是待编辑草稿,不会自动保存、发布。向量服务会接收索引文字,使用前核对其数据处理政策及账户费用;调用次数上限不是供应商账单金额上限。
已有实例若显示 迁入现有 AI 配置,可显式迁入旧配置,之后重新检查连接和构建索引。运行时只使用后台保存的连接,不自动退回旧环境变量或旧向量。
6.5 匿名提问的人机验证(可选)
本节的 Cloudflare Turnstile 用于匿名分身提问与匿名服务询价,不是 Supabase 登录邮件设置中的 CAPTCHA,也不是 Cloudflare 网站代理开关。无需修改 Vercel 环境变量。
- 注册并登录 Cloudflare Dashboard,打开 Turnstile → Add widget。填写便于识别的名称,例如“我的站点分身”。不要求把网站迁到 Cloudflare 托管。
- 在 Hostname management 添加实际使用的主机名,如
www.example.com;只填主机名,不带 https://、端口或页面路径。有独立测试 Preview 时另配测试 widget,不把无关域名加入生产配置。
- Widget mode 选择 Managed,无需为本功能开启 Pre-clearance,点击 Create。打开本站 站点设置 → 安全与人机校验(
/admin/security),填写同一 widget 的 Site Key 与 Secret Key,勾选“启用人机校验”并保存,立即生效。Secret Key 保存后不回显;留空保留,更换 Site Key 时须同时填写对应的 Secret Key。步骤见 Cloudflare 官方指南。
- 在本站
/admin/ai 的站主分身区同时勾选“启用站主分身”和“允许匿名提问”,保存。只填密钥不会自动开启匿名功能。
- 在无痕窗口使用
SITE_URL 对应的固定域名打开前台分身,完成校验并提问;应有正常回答。启用服务询价时,也检查匿名询价表单的校验控件。未完成校验、校验失败或配额用完时应提示原因,不能绕过校验生成。检查失败时核对固定域名、Cloudflare 的 hostname 和同一 widget 的密钥,不连续重试。
已有实例仍可暂用旧环境变量;后台显示“迁移当前环境配置”时可一键迁入,不回显 Secret Key。首次在后台保存后,以后台配置为准,关闭后也不会被旧环境变量重新开启;确认配置来源已迁移后,可从 Vercel 删除旧的两项 Turnstile 变量。
6.6 知识库构建、启用与日常更新
分身依赖知识库;本节不新增环境变量。索引包含已发布/暂停文章及站主编辑的公开问答,私人会话不进入索引。
- 准备自己的已发布内容,在 模型连接与分身设置 保存并检查向量连接。没有内容时先发布文章,仅需演示时才导入默认使用指南。
- 首次建立全部索引;以后默认 同步内容变化,复用未变化的向量。更换向量连接须全量重建。核对发送范围和费用,确认许可后点击 开始建立索引。
- 等待扫描和向量生成。关闭页面会停止后续批次,重新进入可继续已保存进度;失败或结果未确认时,仅在另行确认可能重复计费后重试。
- 生成完整后进入 确认启用。核对完整覆盖、当前内容版本与向量连接,勾选“我决定启用这份知识库”,点击 确认启用这份知识库。不要求先做题或达到某个命中率。启用后按提示配置生成连接、打开分身开关,再到首页提问。
- 日常发布或修改文章后点击 同步内容变化,完成后确认切换即可,无需重新测试。旧版文字立即退出检索,新内容在同步并切换后使用。分身仍只获得当前访客有权阅读的正文。
可选:检查检索效果用于排查错配和遗漏,可以在启用前后使用,也可以跳过:
- 手工准备 1–100 个真实问题,或用共享生成连接自动准备草稿;生成前会确认内容发送范围和费用。默认指南问题只适用于保留了对应文章的站点,不会导入文章。
- 逐题选择包含答案的文章,或选择 本站没有答案。自动题只是建议,未核对不能发送;无需选择分组或凑题数。
- 点击 下一步:确认检查范围,确认本次问题发送与费用,再开始检查。结果展示预期来源是否出现在前五个候选中,高亮错配;这不是生成回答的准确率,也不限制启用。
- 问题和预期来源正确时,保留失败样例。补充文章的答案、标题和上下文后发布、同步,再用相同问题比较;相同内容用同一模型重建不保证改善。修改题目或来源标注不会训练向量或调整线上检索规则。
- 只有返回来源确实包含答案时,才点击 核对后采纳此来源,加入该题的可接受来源草稿(最多 3 个,保留原来源)。原题、原报告和原始命中率不变。需要重新检查时另行确认费用;也可取消修改。
- 取消编辑问题只放弃本页未提交的问题草稿,不删除报告、正文或索引。离开前可下载草稿。为避免丢失草稿,编辑未结束时先取消编辑,再确认启用。
- 单题回答预演默认匿名视角,可切换站主视角;另行确认费用,不创建真实会话或权益。
新建索引采用固定的初始检索筛选值,兼容的增量同步沿用正在使用的规则,测试题目标注不调整它。历史报告保留当时记录,不能与不同规则、不同题目下的成绩直接比较。建议保留真实问题,在模型、检索实现或重要内容改变时比较效果;一次测试不保证未来回答都正确。
刷新、查看报告、编辑和启用不调用模型;自动出题、问题检索和回答预演分别确认范围。正文授权、来源有效性与连接检查始终生效。
6.7 人工确认:如何完成实际部署验收
/admin/setup 按基础条件、站点内容、邮件、支付、AI 分类展示。每项人工检查可展开“如何验收”。页面只读、不发邮件、不付款,不会保存人工验收结论;完成后仍显示“待人工验收”并不代表操作失败。自行记录下面的检查结果,未启用的可选业务无需为验收而开通。
| 检查 | 具体操作 | 应看到的结果 |
|---|
| 正式访问与界面 | 无痕打开固定正式域名,检查桌面、手机及深浅主题 | 首页可直接访问,不跳到 Vercel 登录;导航正确、页面可读 |
| 登录与站主 | 站主从 /admin 登录;另一浏览器普通用户从 /login 首次、再次登录;另请求一封邮件测试同浏览器链接 | 新邮件验证码为 6 位;两类账户进入正确页面,普通用户不能进入后台 |
| 发布与图片 | 素材库上传图片,发布带图文章,再修改并发布一次 | 前台正文、图片及更新都正确 |
| 权限与导航 | 受限文章在编辑器用 ⌘/Ctrl + Shift + P 插入付费墙划定预览;用匿名/未购账户查看,再改一次专辑或页面的侧栏名称 | 未授权只能看预览;页面源码和 /llms.txt 无受限正文;侧栏同步 |
| 数据库与桶 | 执行 supabase/verify.sql,核对 2.1 节安全设置与 Supabase Advisors | 每项 passed 为 true;相关 ERROR 已处理;公开/私有桶设置正确 |
| 收款(启用时) | 自己完成一笔小额付款,核对订单、正文与重复通知 | 订单已付、权益正确且不重复;订单直链到对应文章/专辑 |
| 事务邮件(启用时) | 核对分钟任务、供应商收据、上述订单的实际收件 | 连续运行成功、真实通知送达一次;空队列不代替送达验收 |
| 分身(启用时) | 普通账户提问公开及未购内容;开启匿名时另做 Turnstile | 回答与引用可用,无越权正文;匿名校验和限额有效 |
| 备份恢复 | 按备份指南备份并在独立空项目验证恢复 | 内容、图片、账户与权限可恢复;不覆盖现用站点 |
verify.sql 检查安装结构与权限,不需要在业务库载入任何测试夹具。若自行修改代码或权限规则,在独立测试库运行回归测试后再部署。后台内容 ZIP 用于复用内容,不能代替整站备份。
如果保存配置时显示超时,先到 Supabase Logs 按发生时间核对写入是否成功,再刷新检查;不要在结果未知时连续提交。若多个页面同时超时,从运行应用的环境检查 Supabase 地址的 DNS、代理与出站 HTTPS。反馈时提供页面、发生时间和提示,隐藏密钥、邮箱与配置正文。
可选功能与部署检查 · 万有AI新个体