产品文档
怡途Claw APP 课程接口实战：难度筛选传「入门」查出 0 条，两套词表谁也没迁就谁
怡途Claw APP 端课程三接口（/api/app/courses、/{slug}、/categories）的难点不在调用而在过滤参数：难度有两套词表、分类比较连一个空格都容不下、分页其实是内存里 slice。这篇逐条对照 docs/app-api.md 和 src/lib/blog-service.ts，讲清每处差额的来龙去脉和客户端的最稳传参姿势。
2026年8月16日21 分钟
产品文档
跨设备同步学习进度时数据"凭空消失"：怡途科技 APP 学习进度 API 的取舍与踩坑
怡途Claw APP 端的学习进度同步看着只有 GET / POST 两个接口，但全量替换语义 + device_id 标识 + 缺事务这三个决定一起决定了"为什么换台手机进度会丢、为什么网络抖一下历史就清空"。这一篇把 docs/app-api.md 第三章的承诺和 `src/app/api/app/progress/route.ts` 的实现之间那点没说清的差额，一次讲完。
2026年8月10日26 分钟
产品文档
怡途Claw APP 博客接口：列表、详情、分类、标签——docs/app-api.md 没说的四个差额
怡途Claw APP 端的博客四个接口（list/detail/categories/tags）看着只是 GET 包装，但 blog-service.ts 在分页、分类过滤、标签聚合、质量过滤上各埋了一处和文档承诺不一致的差额。客户端上线前最好把这些差额捋一遍，否则列表里看到的文章和详情接口拿到的可能是两份数据。
2026年8月9日34 分钟