Docker Compose：depends_on的陷阱与正确实践
Docker Compose：depends_on的陷阱与正确实践 核心结论先记住： depends_on 只保证容器启动，不保证服务就绪 MySQL 容器跑起来了，但数据库可能还没初始化完成 真正可靠的方式：应用代码中加重试机制 + healthcheck 条件依赖 一、depends_on 的局限1.1 直觉误区12345678services: mysql: image...
gRPC与Protobuf深度剖析：从协议定义到代码落地
gRPC与Protobuf深度剖析：从协议定义到代码落地 核心结论先记住： .proto 是跨语言、跨平台的”契约”，定义消息格式和服务接口 protoc + 插件生成 .pb.go，开发者只需关注 .proto 编写 gRPC 客户端是”死”的（Stub调用桩），服务端是”活”的（注入业务逻辑） Protobuf 高性能原因：二进制序列化 + Varint压缩 + 丢弃字段名 字段编号是...
Access Token + Refresh Token 双Token认证方案
Access Token + Refresh Token 双Token认证方案 核心结论先记住： Access Token：短期通行证，用于直接访问 API Refresh Token：换新凭证，用于 Access Token 过期后换取新的 双 Token 是令牌设计方案，Redis 是服务端控制手段，两者是两个维度，不冲突 一、两种 Token 各自干什么Access Token（...
前端直传OSS：前后端分离文件上传最佳实践
前端直传 OSS：前后端分离文件上传最佳实践一、为什么不能”前端 → 后端 → OSS”？错误做法：前端把文件传给后端服务器，后端再转发给 OSS。 生产环境的三大致命弱点： flowchart TD subgraph 传统做法["❌ 前端 → 后端 → OSS"] F1[前端上传文件] --> B[后端服务器] B --> O[阿里云OSS] ...
【Eino篇15】：ReAct Agent 实践指南
本文档整理了从基础 Components 进阶到 ReAct Agent 的核心知识点，重点攻克了 Agent 状态管理、内部循环机制、MessageModifier 设计哲学等难点。 一、核心认知：Agent 的”骨架”与”血液”1.1 Agent 是静态编排，不是运行时12// 这一步只是"画图纸"，没有任何数据流动agent, err := react.New...
【Eino篇14】：Flow vs ADK——Agent 开发的两条路
本文档基于官方文档，梳理 Flow 和 ADK 两个模块的定位、区别，以及学完 Compose 后的推荐学习路线。 一、两个模块的定位1.1 *Flow — 用 compose “模拟” Agent ReAct Agent 使用手册 | CloudWeGo Flow 模块的 ReAct Agent、Multi-Agent 等，底层是用 compose Graph 搭建的。比如 ReA...
【Eino篇13】：LLM 工具调用机制与 Message 协议基础
开发 AI 应用的前置常识。理解大模型”工具调用”的底层机制，搞清楚 Message、Role、ToolCall 这些核心概念到底是框架发明的还是模型原生支持的。 参考资料： OpenAI Function Calling Eino ChatModel 指南 Eino ToolsNode 使用说明 一、大模型不是简单的 string → string很多初学者（包括早期的我）对 L...
【Eino篇12】：Agent 还是 Graph？AI 应用路线辨析
本文直接复制自 Eino 官方文档，因为我觉得这篇说的很透彻，解决了我上手学习时候的，面对各种组件、名词的模糊和混乱的问题，直接指明了当下开发推荐的方式，给人稍微明确了学习 eino 的方向。 由于是直接拷贝的，所以有些特殊的 mermaid 图会显示异常，好像只有官方博客文档才能正常显示，其他地方显示异常。 引言：两种并存的 AI 交互范式许多应用程序的界面都集成了不同形态的 AI...
【Eino篇11】：ADK 基础——Agent 开发工具包入门
本文档为半成品草稿，会随着学习深入持续扩充。 当前重点：理解 ADK 定位、Agent 统一接口、ChatModelAgent 基础用法。 参考资料： Eino ADK: 一文搞定 AI Agent 核心设计模式 用 Eino ADK 构建 Excel Agent ADK - Agent Development Kit 一、为什么需要 ADK？1.1 从 Graph 到 Agent...
【Eino篇10】：流式编程——StreamReader 与四大运行范式
本文档整理 Eino 的流式编程能力——涵盖 StreamReader/StreamWriter 底层机制、四种运行范式、自动拼接与装箱、Graph 流式编排、SSE 集成等核心知识点。 流式编程在 ToC 场景中是刚需：用户不愿等 5 秒才看到完整回答，而是希望像 ChatGPT 一样逐字”蹦”出来。Eino 通过 schema.Pipe 和 StreamReader[T] 封...