SparkBin - AI 原生的独立开发者项目教练
从”盲目开干”到”有理有据”
项目简介
SparkBin 是我开发的 AI 原生项目教练工具,专门针对独立开发者和 vibe coders 的痛点:大多数项目死掉不是因为技术不行,而是因为没人在乎。
SparkBin 强制你在写生产代码之前,先通过 6 个结构化阶段验证想法的可行性。每个阶段都有 AI 助手陪伴,帮你梳理思路、设计实验、生成文案。
✨ 核心功能
🧠 六阶段项目教练
- Idea(想法) — 用便签结构化记录概念:痛点、目标用户、使用场景、解决方案、差异化
- Validate(验证) — 设计并执行真实实验:问卷、访谈、社区发帖、竞品分析。GO/NO-GO 决策门防止你建错东西
- Prototype(原型) — 用 P0/P1/P2 优先级规划 MVP,选择平台(Web/iOS/Android/Desktop),AI 生成设计提示词
- Ship(发布) — 追踪上线准备度,生成多平台营销文案(小红书、Twitter、ProductHunt),收集首批反馈
- Grow(增长) — 管理多渠道内容日历,追踪渠道表现和转化率
- Monetize(变现) — 设计定价层级,模拟 Stripe 结账流程,追踪 MRR 和转化漏斗
🤖 AI 伴侣:Pixel Pet
- 像素风格的动画 AI 伙伴,有 idle/blink/happy/celebrate 等动画状态
- 10 种宠物外观,4 种性格设定
- 配置持久化到数据库
🔒 本地优先 + 自托管
- 支持 Ollama 本地 AI,无需 API Key,数据不出服务器
- 一键 Docker 部署,自带 Nginx 反向代理
- 支持 llama3.2、qwen2.5 等任意 Ollama 兼容模型
🔐 企业级安全
- JWT 双 Token 轮换(access/refresh)
- 多认证:本地注册、Google OAuth、GitHub OAuth
- 速率限制、密码复杂度强制、登录审计日志
- 蜜罐反爬虫注册保护
🌍 国际化
- 7 语言支持:中文、日语、韩语、西班牙语、法语、德语、英语
- i18n 配置持久化到 localStorage
🛠️ 技术栈
| 层级 | 技术 |
|---|---|
| 后端 | Python 3.11+, FastAPI, SQLAlchemy 2.0, Alembic |
| 数据库 | PostgreSQL(生产)/ SQLite(开发) |
| 前端 | React 18, Vite, TypeScript, Tailwind CSS, Zustand |
| AI 代理 | DeepSeek, Kimi, Doubao, OpenAI, Ollama(统一后端代理,加密 Key 存储) |
| 支付 | Stripe Test Mode(可选) |
| 认证 | JWT + bcrypt + 速率限制 + 登录审计 |
| OAuth | Google, GitHub |
| 容器 | Docker, Docker Compose, Nginx |
| 部署 | Render / Zeabur(均已配置) |
🚀 使用场景
- 独立开发者:有一个想法但不确定是否值得投入,用 SparkBin 系统验证
- Side Project:周末想做个小工具,快速跑完验证流程
- 学生创业:课程作业或竞赛项目,需要完整的从 0 到 1 的规划
- 团队内部:小团队统一项目管理语言,避免”我觉得能行”的拍脑袋决策
🐳 快速开始
git clone https://github.com/yaolinhui/sparkbin.git
cd sparkbin
cp .env.example .env
# 编辑 .env:设置 SECRET_KEY, ENCRYPTION_KEY, DEFAULT_PASSWORD
docker compose up -d
# 打开 http://localhost
# 登录:admin / 你的 DEFAULT_PASSWORD
详细部署指南见 SELF_HOSTING.md。
🔗 相关链接
如果你也是那种”想法很多但做完很少”的开发者,欢迎试试 SparkBin,让你的每个项目都经得起验证。