Source Code

对 HuggingFace Siglip2 模型实现 modeling_siglip2.py 的完整逐类分析。 覆盖 14 个核心类、200+ 变量/参数，每行关键代码均有功能解释和设计目的说明。 auto-generated from modular_siglip2.py — 这是最终生成的代码，非手动编辑。

Pi Agent 包源码逐行解读 本文对 packages/agent/src/ 下的 agent-loop.ts（~700 行）和 agent.ts（~540 行）做逐行级的代码解读，涵盖每个函数的设计意图、类型系统、控制流和错误处理策略。 目录 文件概览 agent-loop.ts 逐行解读 类型与导入 agentLoop / agentLoopContinue — 公开入口 runAgentLoop / runAgentLoopContinue — 异步底层 runLoop — 核心双层循环 streamAssistantResponse — LLM 流式调用 executeToolCalls — 工具调度 executeToolCallsSequential / Parallel — 串行与并行 prepareToolCall — 前置管道 executePreparedToolCall — 工具执行 finalizeExecutedToolCall — 后处理 辅助函数 agent.ts 逐行解读 类型与导入 MutableAgentState 与 createMutableAgentState PendingMessageQueue Agent 类 — 构造器 subscribe — 事件订阅 prompt — 发起对话 continue — 继续对话 steer / followUp — 消息队列 abort / waitForIdle / reset — 生命周期控制 私有方法：runPromptMessages / runContinuation runWithLifecycle — 并发控制 handleRunFailure — 失败处理 finishRun — 运行终结 processEvents — 事件归约 createContextSnapshot / createLoopConfig — 适配层 设计模式总结 文件概览 packages/agent/src/ ├── agent-loop.ts # 无状态循环引擎（~700 行，纯函数） ├── agent.ts # 有状态封装层（~540 行，Agent 类） ├── types.ts # 类型定义（~400 行） ├── proxy.ts # HTTP 代理（~320 行） ├── index.ts # 导出入口（~8 行） ├── agent-learn.ts # 学习相关 ├── agent-loop-learn.ts └── README.md 核心分界线： ...

逐行拆解 PI05（Pi 0.5）模型实现，从图像/语言观测到动作序列输出的完整源码分析。覆盖模型初始化、训练前向、推理采样、权重加载、数据预处理及所有工具函数。

逐函数拆解 ZImageControlNetPipeline 的数据流向，从 prompt 输入到最终图像输出的完整 pipeline 分析。