STT Demo

这是一个可本地启动的实时语音转写与翻译演示项目，默认使用中文产品界面，并保留运行时中英文切换。

快速启动

bun install --frozen-lockfile
cp env.example .env
bun run dev:web

默认访问 http://localhost:3000。SSO provider 全部留空时使用 guest mode；AUTH_SESSION_SECRET、RTC App ID 和移动 Viewer签名密钥仍需配置。

可选 SSO

需要 SSO 时必须一次性完整配置 provider：

SSO_BASE_URL="https://sso.shengwang.cn"
SSO_CLIENT_ID="console"
SSO_CLIENT_SECRET="your-sso-client-secret"
SSO_SCOPE="basic_info"
SSO_OPEN_API_BASE_URL="https://sso-open.shengwang.cn"

常用命令

bun run dev:web
bun run build:web
bun run test:web

参数说明

参数	说明
VITE_LOCALE	首次访问默认产品语言；用户选择后以 locale cookie 为准。
AUTH_SESSION_SECRET	guest 与 SSO session 的服务端签名密钥。
VITE_AGORA_RTC_APP_ID	RTC 与 STT 使用的 Agora App ID。
AGORA_RTC_APP_CERTIFICATE	RTC App Certificate；配置后由服务端生成动态 Token，留空时使用 App ID 模式。
VITE_AGORA_RTM_APP_ID	RTM App ID；可与 RTC 项目相同。
AGORA_RTM_APP_CERTIFICATE	RTM App Certificate；配置后由服务端生成动态 Token，留空时使用 App ID 模式。
AGORA_STT_REST_BASE_URL	当前 edition 的 STT REST API 地址。
AGORA_STT_ALLOWED_BASE_URLS	只允许完整匹配的额外 STT REST Base URL，多个值以逗号分隔；匹配时仅忽略末尾斜杠。
MOBILE_VIEWER_TOKEN_SECRET	移动字幕 viewer token 的服务端签名密钥。
AGORA_STT_CAPTION_*	可选 VTT 对象存储配置；全部留空时不启用 VTT 下载。

安全注意事项

• 不要提交 .env、App Certificate、Basic Auth、customer secret 或对象存储凭据。
• 只有浏览器可见配置使用 VITE_ 前缀；服务端 secret 不得使用该前缀。
• certificate 留空时对应 RTC/RTM 链路使用静态 App ID 模式。

参与贡献

提交 issue 或 pull request 前，请阅读 贡献指南 和 行为准则。

许可证

本项目采用 Apache License 2.0。

导出内容

• LICENSE
• CODE_OF_CONDUCT.md
• CONTRIBUTING.md
• .gitignore
• biome.json
• bun.lock
• package.json
• apps/web/package.json
• apps/web/server.mjs
• apps/web/tsconfig.json
• apps/web/vite.config.ts
• apps/web/public
• apps/web/src
• apps/caption-viewer-desktop/README.md
• README.md
• env.example

本源码包不包含真实环境变量、Git 元数据、测试、部署配置、内部文档、依赖目录或构建产物。