新人入门 · Onboarding

Vivi 项目知识库

Vivi(Vivid Dreams)是一款 Telegram 上的 AI 角色对话 Mini App。这份知识库是新同学加入团队后从零理解产品、监控、运营、商业化所需的全部背景 —— 不管你是 PM、运营,还是工程师都能找到自己的入口。

产品 · Telegram Mini App · AI 角色 RP 对话 目标市场 · 全球(含 NSFW 容许地区) 入口 · @ViviDreamsBot

项目快照

技术栈
FastAPI · Vanilla JS
Python 3.12 · 无构建步骤前端
部署平台
Fly.io · CF Pages
后端 vividreams (ams) · 前端 vivi-app-e7m
数据库
Turso (LibSQL)
EU West · 本地 dev fallback SQLite
前端入口
@ViviDreamsBot
Telegram WebApp · 无应用商店

新人必读 · 四件大事

① 入口 = Telegram Bot

用户必须先打开 @ViviDreamsBot 才能进入 Mini App,没有 App Store / Google Play。所有用户增长都依赖 Telegram 链接、群发、Adsgram 等渠道;分享时给链接,不要试图引导下载安装。

② 计费走 Telegram Stars

所有付费走 TG openInvoice,钱在 Telegram 平台。退款必须从 Telegram 后台发起,不能直接打回用户银行卡;用户问退款找 PM,PM 走 Bot 后台 refundStarPayment

③ NSFW 不能用 Google/OpenAI

Vivi 含成人内容,任何环节用 Google/OpenAI 模型都会触发 TOS 封号(包括"只是提取关键词"这种轻量任务)。聊天/记忆/提取统一走 OpenRouter 上的非审查模型。

④ 推完代码 ≠ 已部署

Vivi 没有 PR 级 CI,merge 到 main 立即自动 deploy。每次推完必须 gh run list 看绿灯,再 curl 验证生产文件包含改动 —— CI 绿不代表 CDN 已刷新。

知识库目录

★ CHARACTERS

角色目录(公开 SEO 落地页)

45 个角色的公开可索引落地页(英文,Google 可收录),每页含 og:image + JSON-LD + 一键回 Telegram 的可归因 CTA(ref-seo)。自然搜索流量入口。

浏览 →
01 · ARCHITECTURE

系统架构总览

Telegram → Cloudflare Pages → Fly.io → OpenRouter / fal.ai / Venice / Mem0 / Turso 是怎么拼起来的;Vivi / Workflow / Softie 三仓库职责边界;聊天、生图、支付三条数据流。

阅读 →
02 · PRODUCT

产品形态与角色体系

Mini App 用户旅程、45 个角色 + 135 个故事、亲密度 6 级、能量机制、礼物系统、Your Character 虚拟角色、生图 / TTS 玩法。PM 必读。

阅读 →
03 · MONETIZATION

商业化体系

四档订阅(Basic / Plus / Pro / Ultra)⭐ 直购、Gems 钻石经济、能量与签到、Your Character 99 💎、礼物物品、首充翻倍、付费漏斗与转化关键节点。

阅读 →
04 · OBSERVABILITY

数据与监控体系

北极星 = 日消息量。DailyLoop 四阶段自动化管线、Bitable 五张表、PostHog / Sentry / Better Stack / Clarity 分工、Lark Bot 矩阵、关键事件埋点速查。

阅读 →
05 · OPERATIONS

运营与排障 SOP

Admin 后台用法、加角色 SOP、紧急回滚命令、用户问题排查 checklist、Lark 推送规范、需求模板、Adsgram 充值流程。运营/客服必读。

阅读 →
06 · LESSONS

踩坑经验(必读)

过去半年踩过的所有重要坑按主题分类:Telegram WebApp / CI 与 CDN / Turso 数据 / LLM 选型与封号 / NSFW 合规 / 项目拆分 / Fly.io / SPA 路由。新人省一周。

阅读 →
07 · CASE STUDIES

用户案例库(10 个真实旅程)

从 PostHog / Turso / Clarity 挑出 10 个高意向用户:5 位实际付费 + 5 位卡在某处的潜在付费。每个案例独立 URL,便于会议讨论。每个 paywall、每次 invoice_callback 都对应真实用户。

阅读 →

外部资源