关键要点
- MIT许可证——可免费使用、修改及自行托管，包括商业用途
- GitHub仓库microsoft/TaskWeaver星标已超过6,100，fork超过780（创建于2023年9月）
- 微软已于2026年3月23日将其归档——仓库现为只读状态，无新提交、发布或issue
- 通过Planner + Code Generator架构将自然语言请求转换为可执行的Python代码
- 有状态：在整个会话过程中保留聊天历史和代码执行历史，包括DataFrame等内存中数据
- 通过插件系统支持特定领域的数据分析操作扩展
- 通过
git clone+pip install -r requirements.txt安装——没有PyPI软件包
📍 简单一句话
TaskWeaver是微软推出的免费、MIT许可、面向数据分析的代码优先AI智能体框架，通过Planner角色和Code Generator角色将自然语言请求转换为可执行的Python代码——微软已于2026年3月23日将该仓库归档，使其变为只读状态。
💬 简单来说
使用TaskWeaver，你可以用平实的语言描述一项数据任务，让它编写并运行真正的Python代码来完成，同时记住整个对话过程以及沿途生成的数据——但微软已停止开发该项目并将其标记为只读。
📌注: TaskWeaver已被归档，不再处于积极开发状态——应将其视为参考实现，或适用于已有部署的方案，而非新生产项目的起点。关于TaskWeaver与仍在积极维护的智能体框架相比表现如何，请参见本地LLM软件目录。
从研究论文到归档仓库
微软研究院于2023年末在arXiv发布了TaskWeaver论文，并在GitHub上发布了代码，将其描述为“首个能够无缝规划和执行数据分析任务的代码优先智能体框架”。
该项目在2024年及2025年初持续开发：2024年3月推出了默认的基于容器的代码执行模式，同月还发布了一体化Docker镜像；2024年9月增加了用于在各角色间传递信息的共享内存系统；2024年12月接入了AgentOps可观测性集成；2025年1月推出了名为Recepta的实验性推理角色；2025年3月为Planner角色添加了视觉输入能力。
在项目自身的更新日志中，2025年3月的这次更新之后再无新功能公告。提交活动逐渐减少到仅有依赖项更新，微软最终于2026年3月23日将该仓库归档——GitHub的归档提示写明该仓库“已由所有者于2026年3月23日归档”，并“现为只读状态”，这将禁用新的提交、拉取请求和issue提交。
这使TaskWeaver与本系列中的大多数其他框架处境不同。AutoGen处于微软托管的维护模式（仅提供缺陷和安全修复），并有一个明确的继任者——Microsoft Agent Framework。而TaskWeaver既没有明确的继任者，也没有任何维护承诺——它就被冻结在归档时的状态。
仓库创建
- 日期:
- 2023-09
- 含义:
- GitHub仓库microsoft/TaskWeaver创建；论文随后不久在arXiv上发布
容器模式默认化+Docker镜像
- 日期:
- 2024-03
- 含义:
- 代码执行默认在隔离容器中进行；发布一体化Docker镜像以实现一步式安装
共享内存+AgentOps集成
- 日期:
- 2024-09至2024-12
- 含义:
- 各角色可通过内存系统共享信息；接入AgentOps可观测性集成
Recepta推理角色+视觉输入
- 日期:
- 2025-01至2025-03
- 含义:
- 推出实验性推理角色以及Planner角色的视觉输入能力——文档记录的最后功能
微软将仓库归档
- 日期:
- 2026-03-23
- 含义:
- GitHub将该仓库标记为只读：不再有新的提交、发布、拉取请求或issue
📌注: MIT许可证不会因归档而改变——现有代码依然可以在其条款下自由使用、fork和修改。改变的是：微软今后将不再修复漏洞、不再打安全补丁，也不再添加新功能。
TaskWeaver是什么？
TaskWeaver是微软研究院为数据分析打造的开源代码优先AI智能体框架（MIT许可，已归档，github.com/microsoft/TaskWeaver）——它将自然语言请求解释为可执行的Python代码，而不是自由文本指令，并在有状态的会话中运行该代码。
- Planner角色：将复杂请求分解为一系列子任务，并在整个对话过程中跟踪进度
- Code Generator角色：编写可执行的Python代码片段来完成每个子任务，并与已配置的插件协同工作
- 插件系统：数据库查询、预测、文档检索等特定领域操作被打包为插件，供Code Generator调用
- 有状态执行：TaskWeaver在整个会话过程中不仅保留之前消息的文本，还保留聊天历史和代码执行历史——包括pandas DataFrame等内存中数据结构
- 丰富的数据结构：由于状态保存在内存中，TaskWeaver可以在各步骤之间直接传递DataFrame或其他Python对象，而无需再次将其序列化为文本
- 代码验证：生成的代码在执行前会被检查是否存在潜在问题，并向用户提供修复建议
- 基于会话的多用户隔离：基本的会话管理使不同用户的数据相互隔离，代码执行在独立进程中运行以避免相互干扰
- 默认基于容器执行：自2024年3月起，生成的代码在容器内而非宿主进程中运行，这需要Docker支持
# 克隆并安装（需要Python 3.10及以上版本）
git clone https://github.com/microsoft/TaskWeaver.git
cd TaskWeaver
pip install -r requirements.txt
# 在taskweaver_config.json中配置你的LLM，然后运行：
python -m taskweaver -p ./project/TaskWeaver要花多少钱？
TaskWeaver本身在MIT许可下是免费的——没有订阅费、付费套餐，也没有需要付费的微软托管服务。 你需要支付的是自己的硬件或服务器费用，以及在taskweaver_config.json中配置的LLM提供商产生的任何API费用。
- TaskWeaver（开源框架）：在MIT许可下永久免费，自行托管，没有使用上限，运行无需微软账户
- 没有微软托管的产品或订阅：TaskWeaver是你自己运行的代码，而非托管服务——没有任何东西需要订阅
- 可选费用：自己的硬件或服务器，以及如果你连接云端模型而非本地模型，所配置的LLM提供商产生的API费用（例如OpenAI按token计费）
- 可选费用：默认基于容器的代码执行模式需要Docker，运行在你已有或自行提供的基础设施上
如何安装并开始使用TaskWeaver？
TaskWeaver没有PyPI软件包——安装方式是克隆GitHub仓库，并用pip安装其依赖项，这需要Python 3.10或更高版本。 由于项目已归档，这正是归档时所发布的安装流程；今后不会再有可替代安装的新版本。
- 1确保已安装Python 3.10或更高版本（可选先创建专用环境：
conda create -n taskweaver python=3.10 && conda activate taskweaver）。 - 2克隆仓库：
git clone https://github.com/microsoft/TaskWeaver.git。 - 3安装依赖：
cd TaskWeaver && pip install -r requirements.txt。 - 4在
taskweaver_config.json中配置LLM提供商——例如OpenAI可配置为{"llm.api_key": "你的密钥", "llm.model": "gpt-4"}。 - 5如果打算使用默认的基于容器的代码执行模式（推荐），请安装Docker；不使用容器的替代方案见代码执行文档。
- 6从克隆得到的文件夹启动命令行界面：
python -m taskweaver -p ./project/，或者改为将该项目作为库导入——见库使用文档。
TaskWeaver已经归档，我还能安装吗？
可以。归档使仓库对新贡献变为只读，但现有代码、分支和带标签的发布仍完全可以按发布时的原样下载和安装。
TaskWeaver有PyPI软件包吗？
没有。文档记录的安装方式是先克隆再在克隆的文件夹内运行pip install -r requirements.txt，或使用pip install git+https://github.com/microsoft/TaskWeaver@<TAG>安装特定的带标签版本。
谁适合使用TaskWeaver？
TaskWeaver适合已经基于它建立了可用部署的团队，或者想要研究其Planner/Code Generator架构作为参考实现的团队。 鉴于其已归档状态，对于今天要开始新生产环境智能体项目的人来说，它的适用面较窄。
什么情况下不应使用TaskWeaver？
截至本次评测，任何新的生产项目都应避免使用TaskWeaver——微软已于2026年3月23日将该仓库归档，今后不再有维护、安全补丁或路线图。
- 从零开始启动新智能体项目的团队——一个带有53个未解决且被冻结的issue的已归档仓库，是新生产工作的薄弱基础
- 需要依赖项安全补丁的团队——
requirements.txt中固定的版本自归档以来一直被冻结，不会再获得更新，因此固定依赖项中后续发现的漏洞不会在上游得到修复 - 需要官方支持的团队——根据项目README，曾经是“首选”支持渠道的GitHub Issues，在已归档的仓库上不再接受新的提交
- 专门为新项目评估微软智能体框架的团队——应改为从AutoGen（维护模式，至少仍在接收修复）或正在积极开发的Microsoft Agent Framework入手
- 只有在你确实需要研究或维护其代码优先、有状态的Planner/Code Generator模式的现有部署时，才应使用TaskWeaver
TaskWeaver与替代方案对比
TaskWeaver与微软生态系统中其他代码执行型智能体框架相互竞争，其中大多数——与TaskWeaver不同——仍在积极维护，或至少处于官方维护模式。
工具 | 接口 | 许可证 | 状态 | 最适合场景 |
|---|---|---|---|---|
| TaskWeaver | Python代码 / CLI | MIT | 已归档（2026-03） | 研究/维护现有部署 |
| AutoGen | Python代码 | MIT / CC BY 4.0 | 维护模式 | 仅限现有AutoGen应用 |
| Semantic Kernel | .NET/Python/Java SDK | MIT | 活跃（正向MAF融合） | 企业编排SDK |
| CrewAI | Python代码 | MIT | 活跃，有风投支持 | 基于角色的多智能体团队 |
| LangGraph | Python代码 | MIT | 活跃 | 有状态的基于图的工作流 |
评估TaskWeaver时的常见误区
这些误区源于没有直接查证仓库状态，或者将TaskWeaver与其他微软智能体项目混淆。
常见问题
TaskWeaver还在维护吗？
不再维护。微软已于2026年3月23日将microsoft/TaskWeaver仓库归档，使其变为只读状态——今后不再接受新的提交、发布或issue提交。
TaskWeaver免费吗？
是的。TaskWeaver采用MIT许可证，商业使用、修改和自行托管均免费。没有订阅费，也没有需要付费的微软托管产品。
GitHub仓库中的“已归档”是什么意思？
当所有者将仓库归档后，GitHub会将其标记为只读：无法再提交新的提交、拉取请求或issue，但现有代码、分支和发布仍可下载。
TaskWeaver的核心架构是什么？
Planner角色将请求分解为子任务，Code Generator角色为每个子任务编写并执行Python代码，插件系统提供特定领域的操作——所有这些都在一个保留聊天历史和代码执行历史的有状态会话中协同运作。
如何安装TaskWeaver？
使用git clone https://github.com/microsoft/TaskWeaver.git克隆仓库，然后在克隆得到的文件夹内运行pip install -r requirements.txt。没有PyPI软件包。
TaskWeaver需要Docker吗？
并非严格必需，但自2024年3月起，默认的代码执行模式会在容器内运行生成的代码，这需要Docker——不使用容器的替代方案见代码执行文档。
TaskWeaver使用什么许可证发布？
MIT许可证，允许免费的商业使用、修改和自行托管。仓库归档不会改变许可证。
什么取代了TaskWeaver？
TaskWeaver没有任何官方明确指定的继任者。如果需要正在积极开发的通用微软智能体框架，应转而评估Microsoft Agent Framework或Semantic Kernel。
TaskWeaver有多少GitHub星标？
截至2026年9月，microsoft/TaskWeaver仓库的GitHub星标已超过6,100，fork超过780。
我还能对TaskWeaver提交issue或贡献代码吗？
不能。归档禁用了新的issue和拉取请求。归档时开放的53个issue仍然可见，但已被冻结——不会再被处理或关闭。