hirsecGr-优快云博客

原创告别 @app.on_event：FastAPI 中 Lifespan 生命周期的正确打开方式

统一上下文：使用Lifespan将启动和清理逻辑整合到了同一个函数中，避免了旧机制下事件分离造成的代码碎片化。状态注入yield返回的字典会自动挂载到和app.state上，方便在路由处理函数中随时调用全局对象。工程规范：建议在所有现代 FastAPI / Starlette 项目中全面使用lifespan参数，这也是搭建生产级微服务时的标准架构配置。

2026-09-01 20:21:34 194

原创从环境搭建到工程化封装：Qdrant 向量数据库快速上手指南

部署便捷：只需一条 Docker 命令即可完成本地/服务器环境启动，配合 Web 控制台能直观排查数据。易于扩展：通过将底层的抽象成，方便快速嵌入 FastAPI 或基于 LangChain / LangGraph 构建的 AI Agent 服务中。混合查询支持：依托 Qdrant 的Filter机制，可以在大规模向量搜索的同时进行高效率的元数据剪枝，完美支撑多租户隔离、权限控制及按类别检索等真实业务需求。

2026-09-01 20:18:51 189

原创 RAG 实战踩坑指南：突破阿里云向量模型单次 20 条限制与替代方案

最直观的解决思路是在调用前，用 Python 对文本列表进行分片（Chunking/Batching），每 20 条发送一次，最后将结果合并。

2026-08-10 22:06:07 221

原创 Python 字符串数据解析实战：从 JSON 列表到复杂的类对象字符串提取

场景推荐方案核心技术点优势标准 JSON/数组形字符串标准库json速度快、安全、规范包含 Python 字面量的列表标准库ast支持单引号、元组等 Python 原生语法非标对象字符串提取特定字段正则表达式匹配零依赖、简单高效，对异常文本容错率高非标对象字符串完整结构解析Mock 类 + 受控eval()定义映射类定义命名空间能够完全还原数据层级，便于二次分析。

2026-08-10 22:02:54 164

原创番外篇：FastAPI 最小应用与工程化起步

本番外篇将带领你快速落地一个结构清晰、可直接启动的 FastAPI 后端服务。如果你有 Java 或其他后端开发背景，可以将 FastAPI 对标市面上的——它同样负责处理 HTTP 请求路由、数据校验、依赖注入，并能自动生成标准的 API 交互文档。

2026-08-03 19:48:13 192

原创企业级知识库预处理：基于 LangChain Document 与递归文本切分实战

统一返回数据结构：无论是加载单页 TXT 还是百页 PDF，均返回。在流水线开发中应使用平铺元素。严防元数据丢失：切分长文本时**切勿直接使用（这会丢弃来源信息），必须使用 split_documents()，确保源文件名、页码及字符偏移量能一路透传至向量数据库。参数评估依据chunk_size的选择没有固定的黄金法则。FAQ 类建议较小（100200），规章制度建议中等（300500），涉及长操作链路的技术文档建议调大（800+），切分效果应以实际检索场景召回准确率倒逼调整。

2026-07-30 20:20:31 216

原创 LCEL 组合艺术：基于 Runnable 架构的大模型极简管道搭建实战

在 LangChain 中，几乎所有核心组件——无论是 Prompt 模板、Chat Model、Output Parser，还是后期的 Retriever（检索器）——都遵循统一的Runnable 接口。API 方法作用经典适用场景invoke()处理单条输入，同步返回完整结果交互式问答、单次文本分析batch()批量并发处理多条输入，提高 throughput工单批量分类、商品卖点批量生成stream()边生成边流式返回 chunk打字机效果、长文本生成**ainvoke()

2026-07-23 16:20:39 231

原创确定性输出工程：基于 Pydantic 模式校验与 LangChain 结构化解析实战

自然语言适合人类阅读，但代码只接受结构化数据。今天攻克 LangChain 的输出解析体系（Output Parsers），将自由文本转化为类型安全、可直接进入业务逻辑的程序对象。

2026-07-22 21:12:52 232

原创提示词范式工程：基于 LangChain 模板抽象与历史占位符的指令动态注入

拒绝过长冗余：指令并非越长越好。约束条件过多会导致大模型注意力分散，甚至忽略核心任务。明确边界：角色（System）、任务（Human）、约束条件、输入变量要分清，利用天生的消息层级隔开。占位符类型对应的变量必须是列表（消息对象或二元组），不能是普通字符串。

2026-07-22 17:31:30 159

原创大模型开发原点：LangChain 1.0 架构范式与 DeepSeek 深度接入实战

今天开始学 LangChain！记录一下怎么在本地用 Python 调用 DeepSeek 模型，把最基础的流程跑通。

2026-07-21 21:27:31 233

原创大模型上下文控制论：基于 LangChain 消息抽象与记忆机制的多轮对话实战

本文带你厘清大模型/智能体/LangChain 的关系，搭建 Python 开发环境，并基于与 init_chat_model快速完成 DeepSeek 及多模型的调用实战。

2026-07-21 21:25:44 291

hirsecGr的博客