做 Agent 的这两年，GitHub 上躺着一大票「明星殒落」的仓库。AutoGPT 火过、BabyAGI 火过、SuperAGI 火过，现在要么半死不活，要么被官方归档。今天说的这个，是微软自己动手归档的——TaskWeaver。
它是什么
TaskWeaver 是 微软研究院 2023 年 9 月开源的 code-first Agent 框架，MIT 协议，专门干一件事：把「人话」翻译成能跑的 Python 代码，然后拿代码去分析数据。
一句话定位它自己 GitHub 上的原话：“The first code-first agent framework for seamlessly planning and executing data analytics tasks.”
它和市面上绝大多数 Agent 框架最不一样的地方，是把「执行过程」也当成记忆的一部分。别的框架只存聊天记录（纯文本），TaskWeaver 同时存代码执行历史，包括内存里那些 DataFrame。聊到第三轮的时候，它还记得上一轮查出来的那个表长什么样——这在处理高维表格数据的时候是刚需，纯文本历史根本承载不了。
内部是两个角色分工：
- Planner（规划者）：拆任务、定步骤、跟进度，不写代码
- Code Generator（代码生成者）：根据规划写出真正执行的 Python
两者靠一套 plugin 机制协调。plugin 就是普通 Python 函数——官方示例里那个 sql_pull_data，干的活是「接收一句自然语言，从数据库里把数据拉成 DataFrame」，底层基于 LangChain。你想接什么能力，就自己包一个 plugin 扔进去。
MIT 协议，免费、可自托管、可商用，这几点到今天都没变。
上手有多难
要求 Python >= 3.10，三步：
# 1. 装
pip install taskweaver
# 2. 配 taskweaver_config.json，把 API key 填进去
# OpenAI / Azure OpenAI 都行
# 3. 起
taskweaver
起来之后是个 CLI 问答界面，也可以启 WebUI 玩 Demo，还能不能作为库 import 进你现有项目。代码执行默认走 container 模式（Docker 里跑），这点比很多裸奔执行的框架安全不少。
官方有两个 Demo 值得看一眼：
- 从数据库拉数据 + 跑一个异常检测算法
- 预测 QQQ 未来 7 天股价
论文发在 arXiv 上（arXiv:2311.17541），作者一长串，基本是微软的 Analytics 组全员出动。
实话
这个仓库已经被微软归档了。
GitHub API 上写得明明白白：archived: true，归档时间 2026 年 3 月 23 日，最后一次 push 就是那一天。仓库现在只读——不能再提 issue，不能有新 commit，连 issue 都开不了。
看看它的发布记录你就知道它停在哪了：最后一个正式版本 v0.0.1 是 2024 年 4 月 11 日，之后只有一个 v0.0.2-alpha（2024 年 5 月 13 日，名字里就写着 Test）。也就是说，这个项目从 2024 年中就基本停止实质开发了，归档只是把既成事实补了个章。
贡献者规模上，它有 26 个贡献者页面，对微软研究院的项目来说算小项目。README 里那句 “due to our limited resources, we are not able to implement all of them” 是微软自己承认人力有限。
那它为什么被归档？微软没说。但你看它的归宿就明白了：AutoGen 之后微软把资源收拢到了 Semantic Kernel 和 AutoGen（后来的 Agent Framework） 一条线上，TaskWeaver 这种「只做数据分析场景」的垂直框架就被留在了原地。它解决的问题太窄了——不是通用 Agent，就是「让 AI 写代码查数据」。
所以该不该用？ 我的建议分两层：
- 学习价值：高。 6.1K 星的代码量不大，架构清晰，Planner + Code Generator 的分工是 Agent 里最经典的范式之一。读一遍能明白「有状态执行历史」到底解决什么问题，这一点比很多花里胡哨的框架讲得都透。
- 生产价值：接近零。 归档仓库意味着没有安全补丁、没有 issue 修复、依赖更新全靠自己。你的数据要是不敢出内网又怕踩坑，本地跑跑是可以的；但别往生产里放。
- 真要干类似的事，看微软官方现在的答案是 Semantic Kernel / AutoGen 系，或者直接上 Langfuse 这类更垂直的工具链。
收尾
TaskWeaver 是个挺有意思的样本：技术方向没错，代码质量也行，但诞生在了一个「Agent 框架还在野蛮生长」的窗口期，等它想明白自己该是什么的时候，微软已经选了别的路。
2026 年了，Agent 平台列表上真正活着的那几个——Dify、n8n、Langflow、CrewAI——要么在业务侧长出了收入，要么在 GitHub 上长出了不可替代性。剩下大部分，包括这个曾经很酷的 TaskWeaver，都在等着被归档。
我在这篇文章里用到的 TaskWeaver 星数（6168）、归档状态、版本发布时间，都是直接从 GitHub API 拉的当前值，不是记忆里的数。踩过坑的兄弟可以在下面留言。
by 数码罗记·godsun.pro
本文数据核实于 2026-10-05，GitHub API 实时拉取。
