博客

表格里躺着八百行数据，用眼睛看看到眼花。今天请来数据分析界的”重型吊车”——pandas，一行代码把整张Excel读进程序，列名直接当标签用，求和、平均、找最大值都不用写循环

一、老板的三个问题

先说一个你迟早会遇到的场景。

周五下午五点五十，老板在群里甩过来一个销售明细.xlsx：”帮我看看，今年总销售额多少？谁卖得最多？平均一单多少钱？快点，六点开会要用。”

你打开文件——八百行，十七列。你点进”销售额”这一列，Excel左下角状态栏显示求和；再排序找最大值对应的销售名；再用AVERAGE算平均。三个问题，三轮操作，五分钟。刚喘口气，老板又来了：”那按月看看呢？华东区单独算呢？”——每多一个问题，就是一轮手动操作。

（更多…）

电脑里躺着几十个”报告1.csv、最终版.csv、最终版2.csv”，一个一个点开改要一下午。今天学两个新朋友——glob负责”找到所有文件”，os负责”动文件”，从此一句话收拾整个文件夹

一、一个文件夹引发的惨案

先说一个真实到让人想哭的场景。

月底报销，财务说：”把发票扫描件都按’日期_金额’格式重命名，不规范的不收。”你打开文件夹一看——IMG_2041.jpg、IMG_2042.jpg、微信图片_20260930.png、新建文件夹、新建文件夹(2)……一百三十七个文件。你咬咬牙开始一个个改名，改到第二十个，把IMG_2051改成了IMG_2050的名字，覆盖了，找不回来了。

再比如：二十个分店各交来一份销售.csv，你得逐个打开、加上”分店”这一列、再合成总表。或者：把整个文件夹的.txt笔记全部转成.md；把照片/下所有超过5MB的图片挑出来……

（更多…）

版本: AI SDK v7.0.99 | 许可证: Apache-2.0 | 仓库: vercel/ai

分析日期: 2026-09-13

概述

Vercel AI SDK 是由 Next.js 团队打造的 Provider 无关的 TypeScript AI 工具包，提供统一 API 对接 OpenAI、Anthropic、Google 等 25+ 模型提供商。其核心设计理念是三层抽象：Core 层（generateText/streamText）、Provider 层（统一语言模型规范）、UI 层（框架无关的 React/Svelte/Vue hooks）。本文从 10 个维度深入剖析其架构设计。

1. 统一 Provider 架构

AI SDK 的核心创新是定义了一套 Language Model Specification（语言模型规范），所有 Provider 必须实现该规范接口。通过 @ai-sdk/provider 包发布规范，@ai-sdk/provider-utils 提供工具函数，各 Provider 包（如 @ai-sdk/openai）实现具体适配。

// packages/ai/src/model/resolve-model.ts
// 模型解析：字符串 → Provider 实例 → LanguageModel
import type { LanguageModel } from '../types';

// 支持两种使用方式：
// 1. 字符串形式：model: 'openai/gpt-5.4'（通过 Vercel AI Gateway）
// 2. Provider 实例：model: openai('gpt-5.4')（直连 Provider）
export function resolveLanguageModel(model: LanguageModel | string): LanguageModel {
  // 字符串通过 Gateway 路由，对象直接使用
}

架构意义：开发者可以一行代码切换 Provider，无需修改业务逻辑。Gateway 模式更是将 Provider 选择从代码层提升到配置层。

（更多…）

真实世界的数据从来不干净：空格、错格式、缺胳膊少腿的行混在一起。今天学两招——字符串处理和条件筛选，把脏数据洗成能用的数据

一、一份”看着没问题”的表格，坑有多深

先说一个你八成遇到过的场景。

朋友发来一份”聚餐报名表.csv”，说：”帮我算算一共来多少人，按男女分个组。”你打开一看，十几行，有姓名、性别、手机号，挺整齐的嘛。结果一算——人数比实际多了3个；按性别分组，分出来四组：”男”、”男 “（带空格）、”女”、”M”。手机号更离谱，有的带横杠，有的带”+86″，还有人写了”没手机”。

你找朋友对质，朋友说：”我就是让大家自己填的啊。”

（更多…）

项目: geekan/MetaGPT — 57.4k Stars

定位: 多智能体协作框架，模拟软件公司 SOP（标准操作流程）

核心理念: Code = SOP(Team) — 将 SOP 物化并应用于 LLM 组成的团队

源码版本: main 分支 (2025)

1. 设计哲学：SOP 驱动的多智能体

MetaGPT 的核心设计哲学是将软件公司的标准操作流程（SOP）形式化，让 LLM 角色像真实团队一样协作。一行需求输入，产出用户故事、竞品分析、需求文档、数据结构、API 设计等完整软件交付物。

# team.py - Team 类的核心定位
class Team(BaseModel):
    """
    Team: Possesses one or more roles (agents), SOP (Standard Operating Procedures),
    and a env for instant messaging, dedicated to env any multi-agent activity,
    such as collaboratively writing executable code.
    """
    env: Optional[Environment] = None
    investment: float = Field(default=10.0)
    idea: str = Field(default="")
    use_mgx: bool = Field(default=True)

团队拥有环境（Environment）、投资预算（investment）、以及可选的 MGX 增强模式。这体现了”软件公司”隐喻——有预算约束、有组织架构、有协作环境。

2. 角色系统（Role）：智能体的核心抽象

Role 是 MetaGPT 最核心的抽象，每个角色拥有独立的身份（profile）、目标（goal）、约束（constraints）、动作列表（actions）、记忆系统（memory）和运行时上下文（RoleContext）。

（更多…）

为什么专业程序的设置都放在单独的文件里？今天你做出第一个”改配置不改代码”的程序

一、一个改到崩溃的真实场景

先讲一个你大概率亲历过的惨案。

假设你（或者AI）写了一个”每日打卡提醒程序”，里面写着提醒时间是早上8点。用了一周，你想改成7点半——于是你打开代码，找到那行提醒时间 = "08:00"，改成"07:30"，保存，重新运行。

又过了两周，你想改提醒语；再过一周，你想把打卡记录存到另一个文件夹……每次改动都得：打开代码 → 全文搜索找到那行 → 改 → 提心吊胆别改错别的地方 → 保存重跑。

（更多…）

n8n 是一个 Fair-code 工作流自动化平台，原生支持 AI Agent 能力。通过可视化画布结合自定义代码，连接 1500+ 集成，支持自托管或云端部署。本文从源码层面深入分析其架构设计。

1. 版本化节点系统（VersionedNodeType）

n8n 采用版本化节点架构，所有节点（包括 AI Agent）都通过 VersionedNodeType 基类管理多版本。这种设计允许节点在不破坏现有工作流的情况下持续演进。

源码位置: packages/@n8n/nodes-langchain/nodes/agents/Agent/Agent.node.ts

export class Agent extends VersionedNodeType {
    constructor() {
        const baseDescription: INodeTypeBaseDescription = {
            displayName: 'AI Agent',
            name: 'agent',
            icon: 'node:ai-agent',
            iconColor: 'black',
            group: ['transform'],
            description: 'Generates an action plan and executes it. Can use external tools.',
            codex: {
                alias: ['LangChain', 'Chat', 'Conversational', 'Plan and Execute', 'ReAct', 'Tools'],
                categories: ['AI'],
                subcategories: {
                    AI: ['Agents', 'Root Nodes'],
                },
            },
            defaultVersion: 3.1,
        };

        const nodeVersions: IVersionedNodeType['nodeVersions'] = {
            1: new AgentV1(baseDescription),
            1.1: new AgentV1(baseDescription),
            // ... 1.2-1.9 均为 AgentV1
            2: new AgentV2(baseDescription),
            2.1: new AgentV2(baseDescription),
            // ... 2.2-2.3 均为 AgentV2
            3: new AgentV3(baseDescription),
            3.1: new AgentV3(baseDescription),
        };
        super(nodeVersions, baseDescription);
    }
}

架构洞察: 版本映射表将语义版本号映射到具体实现类。V1 系列（1.0-1.9）共享同一实现，V2 和 V3 各有独立实现。defaultVersion: 3.1 表示新建工作流默认使用最新版本。这种设计使得旧工作流可以继续运行，同时新功能只在新版本中提供。

（更多…）

配置文件、网站接口、AI的回复，满世界都是JSON——今天你把它彻底看懂

一、你早就在见它了，只是不知道它叫JSON

先讲一个你肯定遇到过的场景。

你跟AI说：”帮我把这周的菜谱整理一下。”AI回复了一段话，里面是一份结构清晰的清单。你又说：”把这个存到文件里吧。”AI给你存好了。第二天你想让另一个程序读这份菜谱——比如做个采购清单工具——问题来了：

两个程序之间，怎么交接这份数据？

（更多…）