Python

6 篇文章
2026

Agent 的工程细节:上下文裁剪、重试、编码与打包

核心循环之外,真正决定一个 Agent 能不能用的,是这些琐碎却关键的问题:历史无限增长怎么办、流式中断该不该重试、Windows 控制台为什么乱码、TUI 怎么和核心解耦,以及怎么打包成一个 exe。
阅读全文

从零开始写一个 Agent:一次极简的尝试

不借助任何 agent 框架,只用一个 HTTP 客户端和一个工具,把「会调用工具的模型」从头实现一遍。这篇记录整个过程——Agent 到底比普通对话多了什么,那个循环长什么样。
阅读全文

让 AI Agent 安全地执行命令

给模型一个 bash 工具,等于把 shell 交到它手里。这篇讲一个最小 Agent 如何加护栏——危险命令三分类、审批与非交互拦截、环境变量剥离防外泄,以及 Ctrl+C 的取消语义和进程树清理。
阅读全文

把 yt-dlp 封装成好用的下载器:vidgrab 的设计笔记

yt-dlp 能力很强,但接口是给命令行高手用的。vidgrab 用一层薄封装把它变成「双击即用」的工具——这篇讲它的分层设计、配置驱动的选项构造、双层进度条、风控重试,以及一个容易踩的错误处理陷阱。
阅读全文

一个下载器的工程化踩坑:单文件 .bat、cmd 陷阱与 uv 锁源

功能写完只算一半。真正难的是把程序做成「双击即用」——从一个自解压的单文件 .bat,到 cmd 的重定向陷阱、Python 版本语法差异、uv.lock 的源绑定,以及 Windows 控制台的编码问题。
阅读全文

yt-dlp 技术解析:一条视频是怎么被解析、选择并下载的

yt-dlp 不只是一个下载命令,而是一条「站点解析 → 格式选择 → 分片下载 → 后处理」的管线。这篇拆开它的内部结构,重点讲清格式选择这门迷你语言,以及 ffmpeg 到底负责哪一步。
阅读全文