「可乐工具」项目内容与产品分析

分析日期：2026-09-10（基于仓库代码全量盘点 + 此前竞品检查与改造实践）关联文档：竞品网站分析报告 · 产品问题分析与改造路线

一、项目是什么：一句话定位

「可乐工具」是一个面向中文开发者的"效率工具箱 + API 门户 + 技术学习 + 技术社区"四合一平台，PC Web、移动 Web、Android App 三端覆盖，统一账号体系贯穿。品牌视觉为"可乐"紫蓝星空渐变体系（主色 #667EEA → #764BA2）。

用竞品坐标系描述：tool.lu 的"工具+文库"结构 × 慕课网的"课程中心" × 掘金的"文章信息流"，再加一块六家竞品都没有的自有 API 目录。

二、产品结构盘点（代码核实）

2.1 四大一级业务

模块	PC 页面	Android 端	后端 Django app	内容规模
工具箱	67 个页面中的 20+ 工具页（JSON/Base64/正则/时间戳/颜色/图片压缩/图片编辑/翻译/字符集/编码转换/文本对比/计算器/日期/密码/二维码…）	`screens/tools`	`tool`（Tool/分类/收藏/使用日志）	种子 16 个工具，3 分类（开发/设计/实用）
API 目录	ApiDirectory / ApiDetail / ApiDocs / Console	`screens/api` 三屏	`apidirectory` + 5 个独立数据 API app：`weather` / `currency` / `air_quality` / `shorturl` / `ip`	天气/汇率/空气质量/短链/IP 归属地 + 百度翻译代理
学习中心	Learn / CourseLearn（视频+B站源、章节阅读、资料下载、学习计时器）	`screens/learn` 三屏（列表/详情/阅读器）	`learn`（Course/Chapter/Content/Material/ChapterRead）	课程-章节-内容三级结构，含阅读进度
文章社区	Articles / ArticleDetail / ArticleEditor（富文本+Markdown 双模式）	`screens/articles` 两屏	`article`（Article/评论/点赞/收藏/评论点赞）	分类：技术/设计/效率/行业

2.2 用户系统（这是产品最厚的部分）

user app 16 个模型，覆盖了完整增长闭环：

账号：邮箱验证注册/登录（JWT）、手机号绑定、扫码登录（Web 确认）、找回密码、多设备管理
激励：积分/金币/经验三币种钱包、每日签到、任务系统（TaskDefinition + 进度）、等级体系（LevelThreshold）、邀请体系
社交：关注/粉丝、隐私设置（主页/文章/好友列表三档可见性）、6 类通知开关
行为：收藏、浏览历史、搜索

2.3 支撑体系

多语言：zh / zh-TW / en / ja / ko / ru 六语种（竞品中罕见）
消息：站内信、系统消息、聊天气泡（chat app，WebSocket）
运营：更新日志（Changelog）、Bug 反馈（Bug/BugDetail）、任务中心、钱包/邀请页
后台：ArticleManage / LearnManage / Console 管理界面

2.4 技术架构（生产形态）

浏览器 → Nginx:8080（React SPA 静态资源，动静分离）
         ├─ /api → Granian (Django + ADRF 全异步) :8000
         └─ /ws  → Channels WebSocket :8000
数据层：PostgreSQL 16（psycopg3 异步 ORM）+ Redis 7（缓存/Session/Celery）
开发：Vite HMR :5173 → proxy :8000
服务器：docker-compose.server.yml 端口重映射（15432/16379/18000/18080），代码挂载免 rebuild

后端：Django + adrf 异步视图/序列化器（全链路 async），JWT 认证，drf-yasg Swagger，标准化响应码枚举（10000 段成功/20000 段错误）
前端：React 18 + Vite + TypeScript + Ant Design，67 页面 73 路由，路由级 lazy 分包（部分 chunk 超 500KB 待优化），移动端单独组件树（*Mobile.tsx）
Android：Jetpack Compose，Material 主题已按 PC 设计规范映射（#6D5EF2 主色、星空深色背景），20 个 screen 目录
AI 能力：百度翻译四接口（文本/识别/图片/语音）异步集成

三、产品内容分析

3.1 内容资产现状

内容是当前最大的短板，结构是好的。 四个内容池的真实库存：

内容池	结构完成度	内容库存
工具	★★★★★（分类/收藏/计数/日志齐备）	16 个（竞品 100+）
课程	★★★★（章节/进度/资料齐备）	开发库仅有空结构，依赖后台录入
文章	★★★★（评论/点赞/精选/置顶齐备）	依赖 UGC/后台录入，种子数据少
API	★★★★（目录/文档/收藏齐备）	6 个自有 API（独有优势）

内容运营基础设施（推荐位/精选/置顶/热榜）已具备，瓶颈不在"能不能展示"，在"有没有东西可展示"。

3.2 产品设计亮点（值得保持）

四合一是真壁垒：改造后"课程页内嵌代码运行器（学完即练）"是全竞品没有的组合；API 目录是第二独家能力。
用户闭环完整度高：注册→签到→任务→等级→邀请→钱包的增长飞轮骨架全在，多数工具站竞品连登录都没有。
三端一致的设计系统：docs/App-Design-Spec.md 把 PC 端色板/字号/间距/组件形态完整映射到 App，双端体验一致性好。
工程选型激进且合理：全异步 Django（ADRF + Granian + psycopg3）在个人项目里少见，WebSocket 聊天、异步翻译代理都是加分架构。

3.3 产品设计短板（按影响排序）

内容冷启动无解法：16 个工具、空课程库对搜索引擎几乎没有曝光面，四合一的"面"撑不起来（详见改造路线 P0-2/SEO 项）。
变现只有前半段：钱包/金币/任务体系是"发钱"，没有"收钱"——课程无价格字段、API 无计费、无数字商品。
社交能力藏得太深：关注/隐私/通知模型齐全，但文章流刚接入关注 feed，用户主页（UserHome）与社区动线没有串起来。
单仓巨石：PC React（67 页）、Android、Django 后端、部署配置同仓（Desktop/vscode 目录下多项目混放），git status 大量未跟踪文件，缺 CI/测试门禁（后端 test_*.py 十余个但无统一 test suite 入口）。

四、产品阶段判断与建议

当前阶段：功能建设期尾声 → 内容冷启动期。 地基（三端+账号+支付骨架+异步架构）已超出同类个人项目水准，继续堆功能边际收益递减。

接下来一个阶段的三件核心事（与改造路线一致）：

灌内容：工具扩到 40+（优先 AI 四件套）；课程/文章制定每周产出节奏；SEO 预渲染让内容被搜索引擎看见。
通闭环：课程加价格 + 订单，API 目录加 Key + 免费额度计费——让钱包体系从"发币"变成"经济系统"。
立规范：单仓拆分或至少目录隔离、统一后端测试入口、前端 bundle 预算——为多人协作和长期维护兜底。

五、一页速览（TL;DR）

是什么：开发者四合一平台（工具/API/学习/文章），三端，六语言，全异步架构
最强处：结构完整度（67 页面/73 路由/16 用户模型/三端一致设计系统）+ 两个独家能力（API 目录、学练一体）
最弱处：内容库存（16 工具、空课程）与变现后半段（只有发币没有收钱）
下一步：从"功能建设"转向"内容冷启动 + 经济闭环"，具体清单见《产品问题分析与改造路线》

7.4 KiB Raw Blame History Unescape Escape