Zata 扎根技术 · 记录思考 · 见更大的世界

Better CodeA Brighter Tomorrow

保持好奇持续成长

最新文章

记录技术的温度,分享成长的轨迹

Featured image of post Attention

Attention

注意力机制(Attention Mechanism)详解

Featured image of post pickle

pickle

pickle的常用操作

Featured image of post 分类图

分类图

优秀图表学习

Featured image of post PyYAML

PyYAML

PyYAML的常用操作

Featured image of post Nginx

Nginx

Nginx 是一个高性能的开源 Web 服务器和反向代理服务器,以其高效、轻量和强大的并发处理能力而著称。

Featured image of post MoE

MoE

混合专家模型

Featured image of post scipy

scipy

SCiPY的常用操作

Featured image of post 软件自动更新

软件自动更新

软件自动更新是指通过内置机制检测新版本并下载安装,以保持软件最新和安全,这里以python语言为例

Featured image of post Dify

Dify

Dify 是一个开源的低代码平台,帮助开发者快速构建和部署自定义应用程序。

Featured image of post 1-hugo安装使用

1-hugo安装使用

Hugo 是一个快速、灵活的开源静态网站生成器,广泛用于构建博客、文档和个人网站。

Featured image of post 2-Hugo主题和配置

2-Hugo主题和配置

主题和配置通过模板文件和配置文件(如 .toml或者.yaml)自定义网站的样式和功能。本文主要关于主题和配置的使用,以及遇到的问题

Featured image of post 3-hugo博客集成Netlify CMS

3-hugo博客集成Netlify CMS

Netlify CMS 主要是解决了,随时随地打开浏览器写markdown博客的问题,同时它自动处理了图片上传等问题。

Featured image of post 2-github action 使用

2-github action 使用

GitHub Actions 是 GitHub 提供的自动化工具,可以帮助你在代码仓库中实现持续集成(CI)和持续部署(CD)。通过定义工作流(Workflow),你可以在代码推送、拉取请求或特定事件触发时自动运行测试、构建、部署等任务。

Featured image of post 技术热点追踪

技术热点追踪

持续追踪 Agent 与文档结构化领域的技术热点与开源项目

Featured image of post Herdr 详解:给 AI Agent 用的终端运行时

Herdr 详解:给 AI Agent 用的终端运行时

Herdr 是 tmux 的 Agent 化改造:后台 server 保住终端、侧边栏汇总所有 Agent 的 working/blocked/done 状态、CLI 与 socket API 让 Agent 之间互相指挥。本文基于本机 herdr 0.9.0 的实测输出,讲清概念模型、鼠标键盘与复制模式、右键的归属、会话恢复的五条路径、状态语义、Agent 协作配方、插件从装到写、远程与手机用法、中文输入法开关与配置避坑。

Featured image of post Blender 详解:奥斯卡和 AI Agent 为什么都选了它

Blender 详解:奥斯卡和 AI Agent 为什么都选了它

Blender 是唯一同时被奥斯卡和 AI Agent 生态选中的 3D 软件:拉脱维亚电影《Flow》用它拿下 2025 年奥斯卡最佳动画长片,blender-mcp 则把它接进了 Claude 的工具链。本文讲清四件事:它凭什么靠基金会模式做成全流程一体化(2002 年众筹 10 万欧元赎回源码)、三次技术解锁(2019 的 2.8、2021 的 Geometry Nodes、2025 的 5.0)、为什么它对 AI Agent 格外友好(bpy 全覆盖、headless、pip install bpy、可读的验证态),以及它在 AI+3D 生成管线里的位置和客观短板。

Featured image of post CC Switch 详解:一个应用管住八个 AI 编程 CLI

CC Switch 详解:一个应用管住八个 AI 编程 CLI

CC Switch 是给 Claude Code、Codex、Gemini CLI 等八个 AI 编程工具做配置管理的开源桌面应用(Tauri 2 + Rust,GitHub 13 万星)。本文讲清它解决什么问题、切换时内部到底改了什么、六大功能模块的实际能力、安装升级路径,以及本地代理接管和第三方中转型预设这两块最容易踩的坑。

Featured image of post Cua 框架详解:给任何 Agent 一台可操控的电脑

Cua 框架详解:给任何 Agent 一台可操控的电脑

深入解析 22.6k star 的开源计算机使用框架 trycua/cua:Rust 驱动、MCP 接入、Apple Silicon 本地虚拟化、云桌面舰队与评测基准,手把手把 Claude Code 接上真实桌面。

Featured image of post DeepAgents完全指南

DeepAgents完全指南

从协议、架构到生产实践:全面解析 LangChain Deep Agents 的设计理念、API、文件系统、子智能体、上下文管理与部署策略

Featured image of post S3 兼容存储踩坑记:boto3 新默认校验和撞上 NotImplemented

S3 兼容存储踩坑记:boto3 新默认校验和撞上 NotImplemented

一次寻常的重新部署,让博客发布接口全线 500——最小草稿也发不出去,但登录、列表、健康检查全是绿的。根因藏在 boto3 1.36 的一次默认值变更里:PutObject 悄悄带上了 STREAMING-UNSIGNED-PAYLOAD-TRAILER,而第三方 S3 兼容实现不认这套新编码。

Featured image of post 为 AI 而写的 CLI 设计指南:原则、避坑与难点

为 AI 而写的 CLI 设计指南:原则、避坑与难点

给 AI Agent 调用的命令行工具,和给人用的 CLI 是两种东西。本文以 FreshAI CLI(设备码登录 + 博客草稿/发布)的真实实现为骨架,讲清非交互、stdout/stderr 分工、结构化输出、语义化退出码、幂等与「结果未知」这些设计要点,并给出避坑清单和交付自检表。

Featured image of post AG-UI:当 Agent 学会了和前端说话

AG-UI:当 Agent 学会了和前端说话

MCP 管 agent 连工具,A2A 管 agent 连 agent,那 agent 连前端呢?AG-UI 用一条 36 种事件的事件流补上了三层协议的最后一块。本文基于官方仓库 main@5f32a64e 与 Python SDK 0.1.22 / TS SDK 0.0.59 的源码写成,深入到中间件、事件校验器和完整运行管线。

Featured image of post LogQL 查询语言详解:先选流,再过滤,最后才解析

LogQL 查询语言详解:先选流,再过滤,最后才解析

Loki 只索引标签、不索引日志正文,LogQL 的全部语法设计都源于这个取舍。本文从一次真实的排障经历讲起,拆解选择器、流水线、解析器与指标查询,并总结把查询写快的四条原则。

Featured image of post Langchain-RAG实战教程

Langchain-RAG实战教程

以阿里云百炼 + LangChain 实际跑通的 RAG 应用为主线:文档加载、分割、嵌入、Chroma 向量库、LCEL 生成链,附 RetrievalQA 历史写法注记、进阶检索策略与评估指标

Featured image of post LangSmith使用教程

LangSmith使用教程

从环境变量到数据集评估:LangSmith 接入、自动追踪、@traceable、Playground、Prompt Hub 的完整上手记录(2026-09 修订环境变量与评估 API)

Featured image of post CICD

CICD

Featured image of post LangChain 常见报错与排查指南

LangChain 常见报错与排查指南

从 API Key 到 OutputParserException 再到 Agent 死循环:七类高频报错的原因与解法,外加 1.x 时代最常撞见的 import 报错对照表

Featured image of post 阿里云百炼联网搜索:三种入口,三种结果,我全都踩了一遍

阿里云百炼联网搜索:三种入口,三种结果,我全都踩了一遍

同一个百炼模型,联网搜索至少有三条入口:Chat Completions 的 enable_search、Responses API 的 web_search 工具、以及 MCP 广场的联网搜索 MCP。它们的能力、计费和踩坑完全不同。本文按我实测的顺序,把每条路的真实行为写清楚。

Featured image of post 给 Agent 接入 Web Search:四种做法,和一条我试过之后放弃的路

给 Agent 接入 Web Search:四种做法,和一条我试过之后放弃的路

Agent 需要实时信息时,接入 web search 有五条路径:模型厂商内置工具、搜索 API 包 function tool、MCP server、CLI+Skill,以及自托管 SearXNG。本文给出前四种的具体做法与选型建议;第五种我实测过,聚合并没有解决上游不稳定的问题,最终很难用,不推荐。

Featured image of post Agent Run 流式协议:事件溯源、SSE 投影与断线恢复

Agent Run 流式协议:事件溯源、SSE 投影与断线恢复

把 Agent Runtime 的执行过程变成前端可稳定消费的流,关键不是把模型输出直接 pipe 给客户端,而是先把执行事实落库,再把事件投影到 SSE。本文记录我当前系统里的三层协议设计:Runner 端口事件、Canonical 事件库和 SSE wire format。

Featured image of post Agent 内容输出规范:本地给路径,远程给协议

Agent 内容输出规范:本地给路径,远程给协议

一个 Agent 跑完一次,会输出自然语言、工具调用、产物文件三类内容。本地运行时给文件路径就够了,但一旦把 Agent 挂到远程接口上,就必须有一套类型化的输出协议。本文梳理消息协议、SSE 事件设计、产物通道与 AG-UI 标准。

Featured image of post 让用户选择指定 Skill:从社区实践到生产级 API 设计

让用户选择指定 Skill:从社区实践到生产级 API 设计

Agent Skills 规范并没有定义用户如何点名执行 Skill。本文对比 Deep Agents、VS Code、Codex 与 Jan 的调用模式,并给出一套包含权限、快照、幂等和运行时强制激活的生产级设计。

Featured image of post 主流 Agent 框架对比与多框架统一接口设计

主流 Agent 框架对比与多框架统一接口设计

对比 Deep Agents、LangGraph、LangChain create_agent、OpenAI Agents SDK、PydanticAI、Google ADK 与 Microsoft Agent Framework,并给出多框架共存时的统一请求、响应、流式事件和会话设计。

Featured image of post 下拉框里显示 _all:Base UI 与 Radix Select 的一个行为差异

下拉框里显示 _all:Base UI 与 Radix Select 的一个行为差异

智能体市场的四个筛选器全部显示成 _all。代码里明明写了中文文案,问题出在组件库:Base UI 的 Select.Value 默认渲染原始 value,而不是选中项的文本。记录排查过程、修复模式和全仓同类问题清扫。

Featured image of post Playwright Chromium 在 Docker 内 SIGTRAP 启动崩溃排查实录

Playwright Chromium 在 Docker 内 SIGTRAP 启动崩溃排查实录

Dokploy 部署后点击登录触发 Playwright TargetClosedError,最终定位为 useradd -r 没创 /home/appuser,chrome 拿不到可写 HOME 导致 crashpad handler 拿不到 --database 而 exit 1,主进程 IMMEDIATE_CRASH(SIGTRAP)。记录六轮被自己打脸的错误假设链

Featured image of post 从 noVNC 到 Playwright 截图流:容器内 VNC 踩坑记

从 noVNC 到 Playwright 截图流:容器内 VNC 踩坑记

在 Docker 容器内为有头 Chrome 提供远程桌面,先后踩遍 MIT-SHM 0-byte、VizDisplayCompositor 黑屏、x11vnc Azure VM 兼容性等坑,最终放弃 VNC 协议,改用 Playwright Page.screenshot 自定义帧流。记录选型思路、六轮修复与最终架构。

Featured image of post tmux简易使用

tmux简易使用

从零开始掌握 tmux:会话、窗口、窗格、复制模式与常用配置,打造不掉线的终端工作环境。

Featured image of post Gliding Horse Agent OS 介绍:Rust 构建的工业级 AI Agent 操作系统

Gliding Horse Agent OS 介绍:Rust 构建的工业级 AI Agent 操作系统

全面介绍 doiito/gliding_horse —— 一个用 Rust 编写的工业级多智能体编排框架,涵盖 PDCA 7 级自适应调度、5W2H 本体、CPU 缓存启发的 4 层记忆、JSON-LD 数据总线、Oxigraph 统一知识图谱、自演化 Skill Graph、Center/Edge 联邦架构,以及 Software Engineering Team 与 Gliding Code 两个旗舰应用。

Featured image of post AI Agent Loop 工程:原理、模式与实现

AI Agent Loop 工程:原理、模式与实现

深入解析 AI Agent 中 Loop(循环)机制的工程化设计:从 ReAct、Reflection、Reflexion、Plan-and-Execute 到 CAMEL,系统讲解循环的组成要素、终止条件、记忆机制、状态管理,以及如何基于 LangGraph 落地生产级 Agent Loop。

Featured image of post 智能体编排设计工程师学习指南

智能体编排设计工程师学习指南

深入解析智能体编排设计工程师这一新兴岗位的职责、技能要求与发展路径,从 LLM 框架到多智能体协作的完整学习地图。

Featured image of post RAG 技术全景:从入门到进阶

RAG 技术全景:从入门到进阶

RAG 不只是检索+生成,Graph RAG、Agentic RAG、多模态 RAG……一文梳理 RAG 的技术演进路线。

Featured image of post 类图

类图

建模图之类图

Featured image of post 数据流图

数据流图

建模图之数据流图

Featured image of post gradio教程

gradio教程

Featured image of post RLHF

RLHF

Featured image of post Agent 记忆模块深度技术文档

Agent 记忆模块深度技术文档

深入解析智能体记忆系统的架构设计、实现方案与最佳实践,从短期记忆到长期记忆的完整技术栈详解

Featured image of post gh使用教程

gh使用教程

详细介绍 GitHub CLI(gh)的常用命令、认证方式、仓库操作、PR/Issue 流程、Actions、Release、API 调用与自动化实践

Featured image of post 代理配置与环境变量实战

代理配置与环境变量实战

涵盖 macOS 系统代理、Shell 环境变量、NO_PROXY 绕过,以及 Git/Docker/包管理器等常见工具的代理配置

Featured image of post Typer + Rich 入门教程

Typer + Rich 入门教程

用 Typer 写 CLI、用 Rich 美化输出,Python 命令行工具的最佳拍档

Featured image of post Woodpecker CI 使用教程

Woodpecker CI 使用教程

从概念、架构、部署到流水线 YAML,系统了解轻量级开源 CI/CD 工具 Woodpecker CI。

Featured image of post 服务器磁盘管理基础

服务器磁盘管理基础

从查看磁盘、分区格式化到持久化挂载,覆盖日常服务器磁盘管理的完整操作指南

Featured image of post 数据库备份实战

数据库备份实战

PostgreSQL 与 MySQL 数据库备份策略、自动化脚本与恢复演练完整指南

Featured image of post 作图参考

作图参考

Featured image of post 项目中日志的使用教程

项目中日志的使用教程

在软件开发中,日志记录(Logging)是调试、监控和问题排查的重要工具。本教程详细介绍在项目中哪些代码需要加日志,哪些不需要,并提供最佳实践和示例。

Featured image of post 一个标准的软件项目结构

一个标准的软件项目结构

从通用软件工程实践出发,梳理一个标准项目结构的核心目录、职责划分与组织原则。

Featured image of post FastAPI 后端架构设计

FastAPI 后端架构设计

面向中大型项目的 FastAPI 后端架构设计示例,涵盖分层组织、模块拆分与可维护性设计。

Featured image of post Coolify

Coolify

Featured image of post nl2sql

nl2sql

Featured image of post n8n

n8n

Featured image of post JAX

JAX

Featured image of post vllm

vllm

Featured image of post cookbook

cookbook

Featured image of post pytest测试用例使用教程

pytest测试用例使用教程

一份涵盖基础、内置 fixtures、conftest.py、参数化和实战的 Pytest 综合指南。

Featured image of post Celery

Celery

Featured image of post ALL-fastapi

ALL-fastapi

Featured image of post pipeline

pipeline

Featured image of post tokenizer

tokenizer

Featured image of post model

model

Featured image of post datasets

datasets

Featured image of post evaluate

evaluate

Featured image of post trainer

trainer