摘要： LangGraph 图初始化 & app.state 图初始化：两种写法 写法1：跟 lifespan/ctx 绑定 优点：启动即校验连接。 缺点：新增图要同步改 4 处（lifespan、路由、worker startup、handler）。 写法2：模块级异步单例 优点：随处 await get 阅读全文

摘要： @lru_cache装饰器； 核心概念 缓存的是函数调用后的返回值（一个具体对象），不是函数本身。 第一次调用真正执行函数体；之后所有调用直接返回同一个缓存对象。 maxsize=1 如果函数无参数、只有一种调用方式，写不写效果一样，但写出来更能表达"这是当单例用的"这个意图。 装饰在类上：可行，效 阅读全文

摘要： arq 在工作流中的使用 & 任务打断机制 核心认知：两个不同层面的"打断" 项目里有两种完全不同的"打断"，容易混在一起，先分清楚： arq 取消 LangGraph 中断 触发方 外部主动调用 job.abort() 图节点内部主动调用 interrupt() 语义 "别跑了，不要这个结果了" 阅读全文

摘要： arq worker独立部署知识总结 1. worker 进程需要完整的业务代码和依赖 worker 进程启动时会真正执行 import 链，一路带出更深层的依赖，也就是实现任务流程的整条工作流。 worker 环境需要的东西 项目自己的完整代码，因为 worker 是在进程内直接调用这些函数，不是 阅读全文

摘要： 核心架构变化：手写异步队列改为成熟任务队列库 删除了自建的 TaskDispatcherService（asyncio.Queue + worker 协程 + 手写状态机），迁移到 arq（基于 Redis 的成熟任务队列库）。 为什么做这个决定 自建 dispatcher 要手写取消功能：区分"排 阅读全文

摘要： RAG 任务调度链路设计改动 1. 任务状态设计：PENDING 的语义 submit_task 写入 TaskRecord 时状态设为 PENDING，因为此时任务只是"被登记、进队列"，尚未被 worker 消费，RUNNING 只能由真正开始执行的 worker 设置。 完整状态生命周期：PE 阅读全文

摘要： asyncio.Queue 中协程等待任务的本质 核心结论 asyncio 中没有真正的"线程阻塞"，只有协程级别的"挂起"（suspend）。 当多个 worker 协程执行 await queue.get() 而队列为空时，等待的是协程本身，而不是操作系统线程。 等待发生在哪里 阻塞点在各个消费 阅读全文

摘要： TaskHandler 类型设计 问题起因 新增任务 interrupt 支持后，TaskHandler 签名从 1 个参数变成 3 个，导致不需要 interrupt 的 run_pdf_structured_task 也必须接收多余参数。 三种解决方案 方案一：统一签名（最简单，现在用的） Ta 阅读全文

摘要： LangGraph中State更新messages原理； State 定义 messages: Annotated[list[BaseMessage], add_messages] Annotated[类型, reducer] 中的 reducer 用于定义 State 更新时的合并策略。 使用 m 阅读全文

摘要： 视频流相关基础概念 网络传输只有 byte 网络的物理层本质是比特流（bit stream），协议栈向上封装后，应用层看到的就是 byte[]。 所以不管传的是图像、视频还是字符串，到了网络上都变成 bytes，接收方再根据约定的格式还原。 byte[] 与数据格式 byte[] 只是数据在内存或网 阅读全文