本文是《AI 个人级 APP 实战手册》的精编实战版,聚焦三块:核心框架(7 条观点)→ 错题智库实战走查 → 90 天成长路径。全文基于我用 WorkBuddy 真实把一个需求做成上线 App 的踩坑经验,欢迎对照实操。

这篇手册不是一堆知识点堆在一起,而是被 7 条核心观点 串成一根线。每章开头会点出它对应的观点,结尾回扣主线。先记住这 7 条,后面你就不会迷路:
核心观点 | 它回答的问题 | |
|---|---|---|
CV0(总纲) | FDE = 把"模糊需求"编译成"可上线、可负责的产品"的人 | FDE 到底是什么、交付什么 |
CV1 | 模型强 ≠ 落地强,最后一公里才是 FDE 的主场 | 为什么需要 FDE |
CV2 | 写代码只占 25%,"让东西跑起来"才是主食 | 时间花在哪、功夫练在哪 |
CV3 | 先搭骨架再填血肉:一句话需求 → 五层展开 + 四段式 | 怎么从需求起步 |
CV4 | 平台 / 模型 / 云没有"最好",只有"和此刻任务最配" | 怎么选型 |
CV5 | 你是驾驶员,模型是副驾;双阶段变更 + 评分门是安全带 | 怎么和大模型协作 |
CV6 | 上线是起点不是终点;eval / 隐私 / 成本 / 监控是分水岭 | 怎么算"真会了" |
CV7 | 可复用能力 > 一次交付;90 天练出"可迁移骨架" | 怎么成长 |
flowchart LR
CV0[FDE=需求编译器] --> CV1[模型强≠落地强]
CV1 --> CV2[写码只占25%]
CV2 --> CV3[先骨架:五层+四段式]
CV3 --> CV4[选型看匹配]
CV4 --> CV5[你是驾驶员]
CV5 --> CV6[上线是起点]
CV6 --> CV7[可复用>一次交付]
CV7 -.沉淀骨架.-> CV0一句话记住:下面所有内容,都是在论证 CV0——你交付的不是代码,是"跑起来、能负责、可复用"的结果。对一个人做个人 App 而言,这句话更直白:你交付的是"我自己和几个朋友真在用"的东西。
▶ 核心观点 CV3:先搭骨架再填血肉——一句话需求 → 五层展开 + 四段式,是后面一切的地基。 主线案例一句话:老师/学生要一个"拍照→识别错题→归类→推送相似题+讲解"的工具。它从网页 Demo 走到安卓 App,迭代到 v1.13.5(versionCode 28),真实踩过的坑就是下面每一节的素材。
项 | 内容 |
|---|---|
产品 | 高中错题本 / 错题智库(doc3) |
核心动作 | 拍照/粘贴错题 → AI 识别 → 归类 → 推相似题+语音讲解 |
真实轨迹 | v1.0 → v1.13.5(versionCode 28) |
平台演进 | 网页先跑通 → 套安卓壳 → 接 Supabase 边缘函数 |
后端 | Supabase Edge Functions(Deno),Management API 部署 |
模型 | DeepSeek(默认)+ SiliconFlow CosyVoice2(语音讲解) |
标志性坑 | 卡红按钮连修 4 版;模型 ID 写死静默雷;空输入/权限中间态 |
迭代成效 | 28 个版本(v1.0→v1.13.5,versionCode 28);卡红按钮单点连修 4 版;沉淀 71KB 交接文档 + 16 条踩坑归档 |
验证方式 | 一手来源:资料库 doc3《用 WorkBuddy 搭一个能上线的 App(完整版)》原文;跨行业成效对比见第 1 章「案例成效对照表」 |
下面每一节,先讲主线案例怎么做,再标补充案例(主线没覆盖的技术)。

方法 A:五层展开法(doc3,错题智库复盘)
层 | 名字 | 要回答 | 先后 |
|---|---|---|---|
L1 | 核心动作 | 第一件要做的事(6 行内) | 先钉死 |
L2 | 输入输出 | 吃啥、吐啥 | 先钉死 |
L3 | 数据与状态 | 存在哪、怎么变 | 先钉死 |
L4 | 流程闭环 | 一件事从进入走到结束 | 先钉死 |
L5 | 增值层 | 锦上添花 | 后补 |
错题智库的 L1–L4:拍照/粘贴 → 识别文本 → 归类标签 → 推相似题+语音。L5(社区、错题本分享、导出 PDF)后补。
方法 B:文档四段式(doc3 / doc7)。每份需求文档必须含:功能清单 + 数据结构 + 验收标准 + 已知约束。doc3 原话:"缺任何一段,都会在后期以『返工』的形式补回来,而且是带利息的。"
错题智库能迭代到 v1.13.5,靠一份约 71KB / 7 章 / 16 条踩坑的交接文档,它做对了三件事:① 写清 What(功能/结构/接口);② 写清 How to verify(测语音写"真机能出文字",不是"按钮颜色正常");③ 写清 Constraints(平台只支持 Android、localStorage 单机、模型锁某版本)——边界写死,AI 才不会替你"发挥"。
可直接抄的四段式样板(错题智库第一版)——注意,这是文档模板,不是代码,你照着填空白就行:
# 错题智库 · 需求文档(四段式)
## 一、功能清单
1. 用户粘贴/拍照错题文本,点击「识别」→ 返回结构化错题(科目/知识点/错因)
2. 每条错题可一键生成语音讲解(TTS)
3. 按知识点归类,支持检索
## 二、数据结构
- WrongItem { id, subject, point, reason, text, createdAt }
- 存储:localStorage(MVP)/ Supabase(见 4.4)
## 三、验收标准
- AC1:粘贴一道错题,3 秒内返回科目+知识点+错因
- AC2:点语音讲解能出声(真机播放,非空文件)
- AC3:空输入提示「请先粘贴」,不调模型
## 四、已知约束
- MVP 仅安卓 + 网页;单题 ≤ 2000 字
- 模型锁 DeepSeek,不自动升级
- 学生错题含个人信息 → 默认不传公网(见第 7 节隐私)操作清单 4.1
▶ 核心观点 CV4:平台 / 模型 / 云没有"最好",只有"和此刻任务最配"。

错题智库的选型原则:Web 优先,原生 / 后端补差。
怎么操作(界面步骤):
cuotiku-mvp)。▶ 核心观点 CV4(续):模型也没有"最好",按任务分级路由最划算。 模型怎么选(相对排序,价格/能力以官网实时为准)
模型 | 中文 | 代码 | 长上下文 | 价格(相对) | 个人典型用法 |
|---|---|---|---|---|---|
DeepSeek V3/R1 | 强 | 强 | 中 | 低 | 批量/默认路由 |
Qwen(通义) | 强 | 强 | 强 | 低 | 中文业务/长文 |
GLM(智谱) | 强 | 中 | 中 | 低 | 国内合规部署 |
Kimi(月之暗面) | 强 | 中 | 很强 | 中 | 长文档/合同 |
Claude | 中 | 很强 | 强 | 高 | 复杂 Agent |
GPT(OpenAI) | 中 | 强 | 强 | 高 | 通用/生态 |
这是主线案例真实用到的模型。按下面 7 步走,10 分钟能跑通:
platform.deepseek.com,右上角点「登录/注册」(支持手机号或邮箱,国内直接手机号最省事)。cuotiku-prod,方便日后区分环境。sk-xxxx……,只显示这一次!立刻点复制。.env 文件(这个文件绝不提交 git),只写一行: DEEPSEEK_API_KEY=sk-你的密钥messages 里的内容,不动 Key 和地址。静默雷(doc3 真案例,错题智库 v1.13.5):模型名写死成 deepseek-v4-flash / deepseek-v4-flash-vision-exp,今天已退役——请求仍"能用",但被隐式路由到新 Flash 模型,按新模型计费、输出风格变了,你完全不知道。"不报错、不警告,只是悄悄换了个模型替你算。" → 模型 ID 绝不硬编码,做可配置项(在 .env 里加一行 DEEPSEEK_MODEL=deepseek-chat 即可改)。语音讲解(TTS)怎么接(SiliconFlow CosyVoice2,界面步骤):
siliconflow.cn 账号 → 左侧「API 密钥」→「新建密钥」复制 sk-xxxx。.env:SILICONFLOW_API_KEY=sk-你的密钥,base_url 固定 https://api.siliconflow.cn/v1。FunAudioLLM/CosyVoice2-0.5B 和音色,输入讲解文案,输出 mp3。
分级路由(思路,不是代码):把任务分两档——"难"的(复杂抽取/长文)走强模型(Claude/GPT),"易"的(批量默认)走便宜模型(DeepSeek)。差价约 3 倍。实现上只要一个配置表,按 tier 选 base_url + model + key,并且对三种错误分别处理:401 = Key 失效,换 Key;429 = 限流,退避后重试;insufficient = 余额耗尽,去充值。
操作清单 4.3.env 里的可配置项,绝不硬编码版本号▶ 核心观点 CV4(终):云也没有"最好";错题智库选 Supabase 是因为它把"数据库+鉴权+边缘函数"打包,省掉一堆集成。

真实做法(doc3,错题智库):后端优先 Supabase Edge Functions(Deno),走 Management API + 零依赖工具包,明确排斥 CLI / Docker。doc3 原话:"CLI 要装、Docker 要起、网络还得通,每一环都是一个新的失败点。用 Management API 把『部署』压缩成一个纯 HTTP 调用——这是成本结构的考虑,不是技术偏好的考虑。"
第一段:建项目 + 建表 + 拿密钥
supabase.com,用 GitHub 授权登录最快(没有就邮箱注册)。cuotiku)→ 设一个数据库密码(这密码只显示一次,截图或记进密钥管理)→ 选离用户近的区域(国内用户选「Singapore」或「Tokyo」延迟较低)→ 创建。wrong_items → 图形化加列:video-search)→ 在网页编辑器里贴代码 → 点「Deploy」。适合第一次试水。PUT /v1/projects/{ref}/functions/{slug}/body 推源码、POST .../secrets 设密钥。文档原话强调排斥 CLI/Docker,就是为了让"部署"变成一次纯网络请求,少一堆本地失败点。
服务端代理(doc3 逐字,错题智库的 B 站相似题搜索)——它解决了什么:前端想直连 B 站搜相似题,但 B 站接口有 CORS 限制 + 要登录态 Cookie,浏览器直接调会被拦。标准解法是在 Supabase 上放一个服务端代理函数,由它持凭证去调 B 站、再返回干净数据给前端。这个函数做了 5 件事:① 动态取签名密钥;② 给参数加签名;③ 带上 Cookie 和浏览器指纹去请求;④ 把 B 站字段重命名成你自己的结构;⑤ 响应头加 Access-Control-Allow-Origin: *(漏了这步前端照样白干)。代码实现大模型能写,你只要把上面的"5 件事清单"喂给平台即可。重点记住:代理三件套 = 服务端持凭证 + 前端只 fetch + 失败有降级兜底。【补充·创意本】IMA 桥接代理:纯静态 App 没有 IMA 凭证,且 IMA 接口无 access-control-allow-origin → 浏览器拦截前端直连 → 同样必须有持有凭证的服务端代理(Supabase Edge Function)。思路同源:前端只发"标题+内容",代理函数持 IMA_TOKEN 去调 IMA 接口、轮询解析状态,再回传 mediaId。
密钥边界铁律:ANON_KEY 可进浏览器;SERVICE_ROLE_KEY 永远只在服务端。
数据库怎么选
选型 | 适合 | 案例 |
|---|---|---|
SQLite(WAL 模式) | 单文件随包分发、Skill 内嵌、离线可用 | 知识抽取工作台(doc5) |
Supabase Postgres | 托管/鉴权/实时/边缘函数 | 错题智库 / 创意本 |
腾讯云 / 自建 | 国内合规/私有化(商业化延伸) | 企业级 FDE |
个人 App 起步,能 SQLite 就别上云;要多人用、要实时、要鉴权,再上 Supabase。别为了"显得专业"一上来就搭全套。 操作清单 4.4
▶ 核心观点 CV5:你是驾驶员,模型是副驾;双阶段变更 + 评分门是你的安全带。 你是驾驶员,模型是副驾。
flowchart LR
A[提需求/改需求] --> B[双阶段: 先出方案评审]
B --> C{你确认?}
C -->|否| B
C -->|是| D[真实调用验证, 非假设]
D --> E[盯末端结果, 防静默失败]
E --> F[评分门: 价值提升?]
F -->|否| G[整轮丢弃/重写]
F -->|是| H[闭环交付+沉淀文档]
H --> A落到界面上怎么操作:
flowchart TD
V0[MVP: 跑通一条核心链路] --> V1[V1: 补数据/状态闭环]
V1 --> V2[V2: 加一个增值层 L5]
V2 --> V3[V3: 接后端/原生壳]
V3 --> V4[V4: 真实环境攻坚+评分门]
V4 --> VN[完整产品: 文档+降级+监控]真实版本轨迹(都标注来源)
▶ 核心观点 CV7(收口):可复用能力 > 一次交付;90 天练出"可迁移骨架"。 前面 10 章把该讲的都讲了,但"知道"和"会"之间隔着一条河。这一章就是那座桥:不按"技能点"打卡,按"一条真产品的流水线"练——90 天里,你把一个点子推成自己和 3 个朋友真在用的 App。
为什么不按技能、按流水线?因为 CV0 说得直白:FDE 交付的是结果,不是知识点。没人会因为你"会调 API"付你钱,只会因为你"把一个需求变成了能用的东西"。
整条流水线 7 步,每步都挂一个核心观点、都带"交付物 + 验收门",过不了门不许进下一步——这就是把 CV5 的"评分门"用在你自己身上:
flowchart LR
S1["1 选场景<br/>CV4"] --> S2["2 点子→概念<br/>CV3"]
S2 --> S3["3 原型+用户+MVP<br/>CV5"]
S3 --> S4["4 AI coding 开发<br/>CV2·CV5"]
S4 --> S5["5 UI 设计(专家)<br/>CV4·CV7"]
S5 --> S6["6 部署与测试(含封装)<br/>CV6"]
S6 --> S7["7 持续优化与发布<br/>CV6·CV7"]
S7 -.沉淀骨架.-> S1一句话:这 7 步走第二遍时会快一倍——因为第 2~5 步沉淀的骨架能直接复用,这就是 CV7 兑现的样子。
不写一行代码,先把"打哪只怪"选对。选错场景,后面 89 天全白费。
动作
谁 + 什么痛 + 他现在怎么凑合。一句话要先长成"骨架",这就是 CV3 的"先搭骨架"。
动作
先画鬼,再找人看,最后才决定第一次到底做多少。
动作
这是"写代码只占 25%"(CV2)真正落地的地方:你的时间主要花在选型、连接、验收、改稿,而不是敲字。
动作(按这个顺序,别乱)
到了"面子工程",但它是能被程序读懂的工程,不是画得好看就行。
动作
上线不是终点,是"真人开始用"的起点(CV6)。这一步把东西从"我电脑上能跑"变成"别人手机上能用"。
动作
-bootclasspath 屏蔽了 JDK 核心库,dex 打成 0 字节)。
▶ 回扣 CV6 + CV1 案例锚点:错题智库的 Supabase 部署 + 版本三件套;创意本的空壳 APK 血泪。
上线后才是 FDE 真正的主场(CV6)。别做完就跑——真实使用会把所有没想清楚的地方打回原形。
动作

▶ 回扣 CV6 + CV7 + CV0:你交的不是"一次产品",是"一套能反复用的做法"。 案例锚点:创意本从 v28 一路迭代到 v98,"评分门 + 整轮重写(而非追加)"就是它的持续优化机制。
周次 | 这一步 | 关键动作 | 交付物 | 验收门 |
|---|---|---|---|---|
W1 | 1 选场景 | 定方向、写场景卡 | 场景卡 | 3 个真实的人 + 原话 |
W2 | 2 产品概念 | 五层展开 + 四段式 | 概念卡 + 四段式 v0 | 朋友能复述产品 |
W3–4 | 3 原型 / MVP | 画原型、聊用户、砍 MVP | MVP 清单 + 验收标准 | 主功能 ≤5、可一句话验收 |
W5–8 | 4 AI coding | 选型 / 连模型 / 连库 / 协作 | MVP v0.3 | 主流程端到端跑通 |
W9–10 | 5 UI 设计 | 定规范、调 UI 专家、五查 | UI 规范 + 高保真 | 生成页不跑版、真机可点 |
W11–12 | 6 部署测试 | 部署 / 封装 / eval / 监控 | 线上 URL + 包 + eval 报告 | 新用户全程无卡点 |
W13+ | 7 优化发布 | 收反馈、迭代、发布 | v1.0 + 复盘 | 连续 2 周有人在用 |
走完 90 天,把这 10 条刻进肌肉记忆——它们是从错题智库、创意本、PROJECT_NOTES、知识抽取、以及第 1 章跨行业案例里反复出现的"可复用判断",比任何工具教程都值钱(接 CV7:可复用 > 一次交付):
原创声明:本文由作者用 WorkBuddy(AI 编程平台)实操沉淀,属个人真实经验,非水文。关注我,持续分享「个人级 AI App 从 0 到上线」的实战方法。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。