7月AI产品化全景总结技术决策、踩坑记录与8月路线规划一、7月技术决策回顾12个关键选择及其影响复盘7月开发周期中每个技术决策都在随后几周的实践中得到了验证或修正以下是6个最具影响力的选择。决策1优先选择Claude Sonnet作为主力模型而非GPT-4o。这个选择在7月中旬做出核心理由是成本60%的单价差异和长文本处理能力。月底数据显示Claude在生活场景的1024 Token以内的生成质量与GPT-4o基本持平但在超过2048 Token的长文本场景如周报生成中Claude的信息结构化能力更优。负面代价是API并发限制更严高峰期5%重试率vs GPT-4o的1%以及Structured Output功能不成熟。决策2引入设计Token体系。投入约4天建立三层Token抽象原始值→语义Token→组件Token在月末的暗色模式适配中证明了价值——改动仅涉及语义Token层约30行配置而如果无Token体系则需要修改40个组件文件。代价是初期的学习和接受曲线两名开发者花了一周时间才完全适应Token驱动而非值驱动的样式思维。决策3自建上下文代理而非使用第三方工具。选择自行开发AI上下文聚合器3天/人而非购买现成的知识管理工具。月底数据显示自建方案的检索准确率为73%虽低于商业工具的85%但深度集成能力SlackNotionGitHub三源融合是商业工具不具备的。长期来看维护成本是主要风险。决策4采用混合RAG检索而非纯向量检索。将精确查询40%流量导向元数据过滤避免向量检索的不必要开销。这一决策使中位检索延迟从1.2秒降至0.4秒回答可用率从58%升至82%。决策5异步优先工作流取代即时响应模式。深度工作时间从3.2小时升至4.7小时但紧急响应时间从12分钟延长至35分钟。团队通过urgent标签机制达成平衡。决策6Prompt模板集中管理。47个Prompt从代码内嵌转为独立YAML管理版本回滚在1分钟内完成。隐性代价是模板维护的持续性投入。二、7月踩坑全景最值得记录的6个教训踩坑1模型版本漂移。GPT-4o在7月中旬的一次无感更新中调整了输出格式默认值导致简报格式从Markdown退化为纯文本。排查耗时6小时。解决方案在所有Prompt中显式声明输出格式不依赖模型默认行为。踩坑2时区混乱。时间线数据在数据库中以UTC存储、前端以用户本地时区展示但向量检索生成的摘要chunk中嵌入了UTC时间戳导致昨天的时间指代在跨时区时错位。解决方案统一所有数据处理管道使用用户时区仅在存储层使用UTC。踩坑3脱敏不彻底。Staging环境从生产同步数据时的脱敏脚本遗漏了日记正文中嵌入的手机号码。虽在Staging环境内部使用但构成了数据合规风险。修复扩展脱敏正则为电话号码和身份证号码模式。踩坑4Suspense滥用。为追求流式渲染每个数据获取组件都包裹了Suspense导致页面上出现了5个独立的加载骨架屏视觉效果凌乱。解决方案合并相邻的数据依赖组件共享同一个Suspense边界。踩坑5缓存的脏数据传播。TanStack Query的5分钟staleTime在测试环境看起来很合理但在生产环境中用户修改数据后需要等待最多5分钟才能看到更新。解决方案在写操作成功后通过queryClient.invalidateQueries主动失效补充服务端的revalidatePath。踩坑6AI摘要的质量幻觉。上下文代理自动生成的决策摘要中约7%的内容包含未在原讨论中出现的推理补充——AI在摘要时加入了它认为合理的推断。降低误报的代价是增加人工校验比例。三、8月技术路线规划三个优先级最高的建设方向优先级1多模态能力集成目标8月中旬当前系统仅处理文本输入。用户反馈中最频繁的需求是上传一张食物照片让AI估算卡路里和拍一张药品说明书让AI提取服用时间。多模态能力不追求视频理解等高成本场景聚焦于图片文本的轻量级多模态。选型上倾向于Claude的视觉能力已包含在现有API费用中无需额外的Vision模型。优先级2本地优先的离线降级方案目标8月下旬当前产品强依赖云端API断网时完全不可用。8月计划实现核心功能的离线降级预缓存最近7天的用户数据到IndexedDB缓存上一次生成的简报模板断网时展示上次更新的数据离线标识。不追求完整的离线AI推理而是在离线期间提供可用的降级体验。优先级3产品可观测性体系建设目标8月全月7月的故障排查严重依赖开发者手动查日志。8月计划建立三大可观测支柱结构化日志JSON格式requestId追踪、关键指标DashboardAPI延迟P50/P95/P99、错误率、Token消耗趋势、业务指标功能使用频率分布、场景完成率、用户留存关联分析。选型上倾向OpenTelemetry自建避免第三方监控服务的成本。四、8月风险预判已知的未知与应对预案风险1模型API的价格波动或服务变更各模型提供商的定价策略仍在快速变化中。7月已出现一次无预警旧版模型废弃通知Claude 3 Haiku在发布8周后宣布废弃。应对预案8月第一周完成模型提供商热切换能力——通过配置中心的模型路由表实现零代码变更切换提供商配合自动化的跨模型回归测试。风险2用户数据增长的存储与检索压力当前日均新增约500条日记记录向量索引按月增长约15万条。按此趋势到9月向量检索延迟可能从当前的200ms升至800ms以上。应对预案8月末前实施向量数据的分层存储——近30天数据在内存索引快速检索30天以上数据在磁盘索引可接受较高延迟配合用户级别的数据归档策略。风险3产品功能收敛的决策压力7月验证了12个功能的使用频率分布极不均匀前4占82%。8月面临是否削减低使用率功能的决策压力。应对预案不是直接删除功能而是将它们从主动触达推送、首页展示降级为按需访问设置页中的可选模块观察1个月后的使用率变化再决定是否完全下线。五、总结7月AI产品化从0到1的关键收获与8月路线7月关键决策Claude Sonnet替代GPT-4o为主力模型年化节省成本约40%。设计Token体系使暗色模式适配成本从不可估降为30行配置。混合RAG将回答可用率从58%升至82%核心是精确查询不走向量检索。自建上下文代理虽准确率低于商业工具但深度集成能力带来独特价值。7月核心教训模型版本无感更新→所有Prompt显式声明输出格式。时区处理→统一管道使用用户时区仅存储层UTC。Suspense过度→合并相邻数据依赖组件共享边界。缓存脏数据→写操作后主动失效不依赖staleTime。8月优先事项图片文本轻量多模态W2完成集成测试。离线降级方案IndexedDB缓存模板W4上线。可观测性体系OpenTelemetryDashboard全月建设。模型热切换分层向量存储应对增长风险。