别只是学 —— 动手构建

目标

构建一个具备生产形态的 REST API：认证、多租户数据隔离、限流，以及按用量计费的钩子。

锻炼的技能

• REST 设计与版本化
• OAuth2 / 令牌认证
• Postgres 表结构与迁移
• 限流与配额
• 可观测性与测试

冲刺分解

1. 1

   冲刺 1 · 基础

   项目脚手架、Postgres、健康检查，以及一个具备完整 CRUD + 测试的资源。

2. 2

   冲刺 2 · 认证与租户

   令牌认证、按租户的行级隔离，以及基于角色的访问控制。

3. 3

   冲刺 3 · 限额与计费

   限流、按计划的每日配额（不累计），以及用于计费的用量计量。

4. 4

   冲刺 4 · 上线

   容器化，加上结构化日志 + 链路追踪、CI 流水线，并部署在反向代理之后。

目标

构建一个检索增强的副驾：基于你的文档作答、调用工具采取行动，并以一套评测衡量其表现。

锻炼的技能

• 切块与嵌入
• 向量检索 + 重排
• 工具 / 函数调用
• 智能体循环与记忆
• 评测与护栏

冲刺分解

1. 1

   冲刺 1 · 与模型对话

   一个流式聊天接口，带系统提示、重试和 token 预算。

2. 2

   冲刺 2 · 检索

   导入文档，切块 + 嵌入，存储向量，并用引用支撑答案。

3. 3

   冲刺 3 · 工具与行动力

   加入工具调用（搜索、创建、获取），以及带安全执行的规划—行动—观察循环。

4. 4

   冲刺 4 · 度量与加固

   评测数据集、以 LLM 为评审的打分、提示注入防护，以及成本看板。

目标

构建一个快速的笔记应用：录入、自动保存、分类与搜索 —— 再叠加语音录入与转写。

锻炼的技能

• 认证与按用户的数据
• 自动保存与乐观 UI
• 全文搜索
• 音频录入
• 语音转文字集成

冲刺分解

1. 1

   冲刺 1 · 笔记核心

   认证、带自动保存的笔记创建/编辑，以及分类。

2. 2

   冲刺 2 · 搜索与打磨

   全文搜索、键盘快捷键，以及响应式、无障碍的界面。

3. 3

   冲刺 3 · 语音录入

   在浏览器中录制音频、存储，并附加到笔记上。

4. 4

   冲刺 4 · 转写与部署

   接入语音转文字、让转写文本可被搜索，并部署到一个真实域名。