
sound-cocktail
io.github.indulgers/sound-cocktail
Discover 22 ambient sounds, recommend soundscapes, and build playable Sound Cocktail mix links.
Documentation
Sound Lab / Sound Cocktail
一个以沉浸式旅行为入口的声音空间:选择地点和状态,听真实授权的动态影像搭配原创声音作品;需要时进入 Studio 调节声音图层、静音或独奏,并分享自己的混音配方。Cocktail 仅指声音混合,不再以酒杯作为编辑器。
注意:仓库没有提交新版 6 个地点的旅行视频、对应封面和 18 条 15 分钟长音频。它们由 CI 构建生成,新电脑或新分支需要先恢复媒体。
巴厘岛 / 清迈 AI 场景试制
优先使用真实感强的 AI 视频重新打造两个标杆场景:巴厘岛乌布雨林露天 SPA、清迈雨季木质咖啡馆。原有视频暂不替换,避免未验收素材被当成真实实景。制作流程:AI 视频镜头提示 → 1080p 独立横/竖屏候选 → FFmpeg 画质编码 → 与旧版视频并排审核 → 通过后更新来源标注、场景、SEO 与部署资源。
完整生产步骤见 Bali + Chiang Mai AI Video Pilot。
```bash pnpm film:plan -- --scene bali --shot hero # 安全 dry-run,不扣费 pnpm film:plan -- --scene chiang-mai --shot hero # 先审 prompt
真正付费生成必须手动传 --execute --max-usd,并配置私有 API 密钥
```
当前会话未连接 AI 视频生成服务账号,因此仅实现可执行生产管线与候选镜头方案,没有产生真实 AI MP4、没有收费、也没有上架。
临时 QA Plus 测试账号(本地 / 线上)
需要体验所有高级场景和完整调音功能时,可以为已登录的指定 userId 开启短期测试 Plus;无需真实付款,其他账号不会被影响。
- 本地:在私有 `.dev.vars` 里设置 `SOUNDLAB_QA_PLUS_USER_IDS` 与 `SOUNDLAB_QA_PLUS_EXPIRES_AT`,然后重启。
- 线上预览 Worker:另设 `SOUNDLAB_QA_PLUS_ALLOWED_HOSTS` 为精确的域名,通过 Worker Secret 管理,不提供公开免登录 Plus URL。
- 测试授权最长 30 天,不写入订单或正式订阅;页面显示 `QA PLUS`。
具体获取账号 userId、设置方式、取消与验收见 docs/qa-plus.md。
本地声音/视频资源(先执行)
# 拉取分支代码后,先恢复可验证的已发布媒体:
pnpm assets:sync
pnpm assets:check
# 资源齐全再启动网站
pnpm dev
本地资源说明、单场景下载、Worker 地址覆盖与离线生成方案,见 docs/local-media.md。缺少媒体不会导致所有 React 组件都报错,但沉浸播放器会遇到视频/音频 404。
本地运行
需要 Node.js 22.12 或更新版本。
npm ci
npm run dev # http://localhost:3000(TanStack Start 开发服务器,跑在 workerd 里)
首页 / 和沉浸页 /focus 由 TanStack Start(文件路由)管理,共用一个 Web Audio 控制器。直接访问沉浸页时可按「继续播放」开始。首页 SSR:初始 HTML 已包含标题、描述和三个进阶包。
用 npm test 运行计时与配方权限测试。用 npm run build 构建,再用 npm run preview 预览生产包(同样跑在 workerd 里)。
支付宝正式密钥配置
支付宝正式环境使用 RSA2 + 密钥模式;本项目已存在支付路由和 Cloudflare Workers 接入。请按 支付宝正式密钥配置指南 在本地生成 PKCS#1 密钥、上传应用公钥、保存支付宝公钥并设置 Worker Secrets。私钥绝不提交仓库,正式环境密钥不得复用沙箱密钥。
支付(本地沙箱)
支付 API 与网站跑在同一个 Worker 里(src/routes/api/*,同源 /api,不需要开发代理)。本地开发用支付宝沙箱配置:
npm run sync-dev-vars # 从 .alipay-sandbox.json 生成 .dev.vars(沙箱密钥,绝不提交)
npm run dev
.dev.vars 只在本地生效;生产密钥用 wrangler secret put 设置(见部署一节)。订单存在 Cloudflare KV(ORDERS_KV 绑定),本地开发用 wrangler.jsonc 里 preview_id 对应的本地命名空间,数据存在 .wrangler/ 下。
沙箱下单验证:POST /api/pay/create {"productId":"focus-pack"} 应返回 200 和一张 ¥6.00 的支付宝沙箱支付表单。注意:本机出站代理会破坏 workerd 的 TLS 握手,workerd 无法直接连到支付宝沙箱网关做查询/退款——服务端 API 调用(query/refund/close)用的是 src/server/alipay-fetch.ts 的 fetch 传输(与 SDK 相同的 RSA2 签名/验签算法),已用本地假网关端到端验证通过(见该文件头注释),上线前请在已部署的 Worker 上再跑一次真实沙箱查询确认。
海外版(英文 + Waffo Pancake)
导航栏右上角有 EN / 中文切换(存在 localStorage 的 sc-locale 里)。语言决定界面文案、货币和支付通道:中文 → 支付宝(人民币 ¥6/¥9/¥12),英文 → Waffo Pancake(美元 $1.99/$2.99/$3.99)。包 ID 不变(focus-pack / sleep-pack / rain-night-pack),两条通道共用同一份权益(GET /api/entitlements)。
- 语言相关的商品接口:
GET /api/products?locale=en返回 USD 价格,?locale=zh(或不带参数)返回 CNY 价格。 - Waffo 下单:
POST /api/waffo/create {"productId":"focus-pack"}(需登录,未登录返回 401;未配置返回 503WAFFO_NOT_CONFIGURED)。成功返回{checkoutUrl, sessionId, outTradeNo, productId, totalAmount, currency},前端在新标签页打开checkoutUrl。 - Waffo 回调:
POST /api/waffo/webhook(原始 body 验签,事件order.completed→ 标记已支付并授予权益;已处理的event.id会跳过)。付款完成后 Waffo 跳回/waffo-return?order=<outTradeNo>&pack=<id>,页面轮询权益接口确认解锁。 - 本地开发配置(
.dev.vars,绝不提交;示例见.dev.vars.example):
WAFFO_MERCHANT_ID=
WAFFO_STORE_ID=
WAFFO_PRIVATE_KEY=
WAFFO_ENV=test
WAFFO_PRODUCT_FOCUS_PACK=
WAFFO_PRODUCT_SLEEP_PACK=
WAFFO_PRODUCT_RAIN_NIGHT_PACK=
私钥填法:用单行 raw base64(去掉 -----BEGIN PRIVATE KEY----- / -----END PRIVATE KEY----- 和所有换行,只留 base64 本身);SDK 也接受 PEM(含头尾行)或字面 \n 转义,但单行 base64 是最稳妥的格式。部署到 Worker 时同样贴单行 base64:npx wrangler secret put WAFFO_PRIVATE_KEY 后直接粘贴(或把 PEM 文件重定向进 stdin:npx wrangler secret put WAFFO_PRIVATE_KEY < waffo-private-key.pem)。
测试环境产品已在 Waffo 后台建好(test 模式,不要点 publish,发布是单向的、等上线决定再做)。测试卡:成功 4576750000000110,拒付 4576750000000220。
本地验证脚本(都在 scripts/,读 .dev.vars,不打印任何密钥):
node scripts/waffo-create-products.mjs # 在 test 环境创建三个一次性产品,打印 productId
node scripts/waffo-checkout-smoke.mjs # 用真实 test 密钥建一个 checkout 会话,确认返回 checkoutUrl(token 不打印)
注意:和支付宝沙箱一样,本机 workerd 的 TLS 握手会被出站代理破坏,所以本地 vite preview 里的 /api/waffo/create 调不通 api.waffo.ai(502)——这是本机环境的限制,不是代码问题;上面两个 Node 脚本(走 Node 的 fetch)可以验证 SDK 与真实 test 环境,部署到 Worker 后再在已部署的 Worker 上验证整条链路(下单 → 测试卡支付 → webhook 授予 → 回跳页解锁)。
音频素材
作者、原始链接及逐条许可见 音源目录 和页面内的「音源清单」。详见 素材整理说明。
部署(Cloudflare Workers)
本站已从 Cloudflare Pages(静态站)迁移到 Cloudflare Workers(TanStack Start 全栈:SSR + 支付 API 同一个 Worker)。当前生产站仍在 Pages(soundcocktail.app / sound-lab-97n.pages.dev),切流量之前先在 Worker 上验证通过。
首次部署(需要 Cloudflare 登录)
npx wrangler login
npx wrangler whoami
# 1. 创建订单 KV 命名空间,把返回的 id 填进 wrangler.jsonc(替换现在的占位 UUID)
npx wrangler kv namespace create ORDERS_KV
npx wrangler kv namespace create ORDERS_KV --preview
# 2. 设置生产支付宝密钥(生产密钥目前还不存在:需先完成白名单 → 签约 → 建应用,
# 再把应用公钥对应的私钥等填进来;不要用沙箱密钥部署生产)
npx wrangler secret put ALIPAY_APP_ID
npx wrangler secret put ALIPAY_APP_PRIVATE_KEY_PKCS1
npx wrangler secret put ALIPAY_PUBLIC_KEY
# 生产网关(默认是沙箱网关;生产用 https://openapi.alipay.com/gateway.do):
npx wrangler secret put ALIPAY_GATEWAY
# 可选:异步通知地址(需公网可达)
npx wrangler secret put ALIPAY_NOTIFY_URL
# 3. 设置 Waffo Pancake 密钥(海外版,test 环境;生产切换前不要改 WAFFO_ENV)
npx wrangler secret put WAFFO_MERCHANT_ID
npx wrangler secret put WAFFO_PRIVATE_KEY # 粘贴单行 raw base64(见上文「海外版」一节)
npx wrangler secret put WAFFO_PRODUCT_FOCUS_PACK
npx wrangler secret put WAFFO_PRODUCT_SLEEP_PACK
npx wrangler secret put WAFFO_PRODUCT_RAIN_NIGHT_PACK
npx wrangler secret put WAFFO_ENV # test(生产切换时再改为 prod)
# 4. 在 Waffo 后台注册 webhook:https://soundcocktail.app/api/waffo/webhook,订阅 order.completed 事件
# 5. 部署(会自动先构建;不要加 --config 参数,部署用插件生成的配置)
npm run deploy
# 成功后会得到 https://sound-cocktail.<子域名>.workers.dev
部署包约 2.8 MiB(gzip 约 0.6 MiB),在免费版 3 MiB 限制内。
绑定自定义域名(验证通过之后再做)
# 先确认 workers.dev 上的站和支付都正常,再把域名从 Pages 项目解绑、绑到 Worker:
npx wrangler deploy # 确认 Worker 已上线
# Cloudflare Dashboard → Workers & Pages → sound-cocktail → Settings → Domains → Add → Custom Domain → soundcocktail.app
# 或:npx wrangler custom-domains add soundcocktail.app
绑定后 soundcocktail.app 即由 Worker 提供服务,Pages 项目可保留作回滚(不要同时让两个项目绑同一个域名)。
部署后检查
curl https://<workers.dev 域名>/ # 初始 HTML 应含标题和三个包名
curl https://<workers.dev 域名>/api/products
curl -X POST https://<workers.dev 域名>/api/pay/create \
-H 'Content-Type: application/json' -d '{"productId":"focus-pack"}'
# 生产密钥就绪前,下单会返回 503 PAYMENT_NOT_CONFIGURED(预期行为)
# 沙箱密钥部署到预览环境时,应返回 ¥6.00 的支付宝沙箱支付表单;
# 再用返回的 outTradeNo 调 /api/pay/query/:outTradeNo 确认查询链路
旧的 Pages 部署说明:生产站目前仍由 Cloudflare Pages 从 indulgers/sound-lab 的 main 分支部署(https://sound-lab-97n.pages.dev/)。本目录(TanStack Start 版)尚未推送到 GitHub、尚未部署,待验证通过后再决定推送与切换方式。
No installation packages available.