GitHub开发者把AI Agent拆成3个文件

一个MIT协议的TypeScript项目，发布两周收获47星，却让圈内人开始重新算账：训练一个专属Agent的门槛，可能比你想象的要低得多。

Cagent的作者srutz没打算造轮子，他直接掀了桌——整套核心代码塞进3个文件，总大小不到500行。

这不是又一个"开箱即用"的黑盒工具。srutz在README里写得很直白：「Think of shadcn approach and copy it into your projects」。翻译过来就是：别装依赖了，直接复制粘贴，改完就是你的。

大厂保密三年的架构，被他用一行命令拆穿了

运行cagent --verbose list files in current dir，终端会吐出LLM调用工具的完整决策链。输入、推理、工具选择、参数填充、执行结果，每一步都摊在面前。

这种「透明模式」戳中了一个行业痛点：多数开发者用了一年Copilot，仍说不清模型是怎么决定调用哪个函数的。srutz的代码像一份解剖报告——Agent不是魔法，是带循环的API调用。

架构上，Cagent只认三件事：System Prompt定角色、User Input给任务、Tools列表供挑选。模型输出JSON格式的工具调用指令，框架解析执行，结果塞回上下文，循环直到任务完成。

没有向量数据库，没有记忆层抽象，没有多Agent编排。srutz的解释很产品经理：「It is designed to be simple and modular」。换句话说，复杂功能你自己加，但骨架必须一眼看懂。

Templates设计暴露了真实使用场景

代码里埋了一个容易被忽略的细节：Templates模块。用户可以预存常用Prompt片段，比如「用TypeScript写单元测试，要覆盖边界条件」或「解释这段代码的内存泄漏风险」。

这个设计暴露了srutz的观察——开发者80%的Agent交互其实是重复劳动。FAQ式问答、代码审查清单、格式化输出，与其每次打字，不如一键调用模板。

对比LangChain的Chains或LlamaIndex的QueryEngine，Cagent的Templates连DSL都没有，纯字符串替换。粗暴，但调试成本趋近于零。

「Copy it into your projects」背后的算盘

shadcn/ui的流行证明了一件事：前端开发者厌倦了node_modules黑洞。srutz把这个逻辑搬到AI工程领域——与其依赖版本号飘忽的SDK，不如把源码捏在手里。

MIT协议意味着没有商业限制。你可以把Cagent塞进内部工具、改个名字卖给客户、或者拆碎了融进自己的框架。srutz甚至没设捐赠链接，代码即全部。

这种「零资产」发布策略反而加速了传播。GitHub Issues区已经有开发者 fork 后接入了Claude 3.7 Sonnet，有人换成了本地Ollama模型，还有人把Tools层嫁接给了内部API网关。

47星的项目，衍生出了7个可见的fork方向——这个转化率高得反常。

为什么是现在？

2024年下半年，OpenAI和Anthropic的API价格腰斩，上下文窗口从8K卷到200K。模型变便宜了，但Agent框架仍在收「认知税」——文档越厚，开发者越怕。

Cagent的发布时间卡在一个微妙节点：大厂Agent产品（如OpenAI的Operator、Claude的Computer Use）开始收费，而开源社区仍在消化ReAct论文的实现细节。srutz用500行代码证明，中间地带存在。

他的代码里没有抽象工厂、没有插件系统、没有配置热更新。只有一个runAgent函数，循环调用模型，直到输出不含工具调用为止。

这种「裸奔」架构的代价很明显：并发要自己管、错误恢复要自己写、长对话历史会撞token上限。但srutz的赌注是——90%的Agent场景不需要这些。

一个内部数据点：Cagent的Tools定义采用JSON Schema，与OpenAI Function Calling格式兼容。这意味着你可以直接复制官方文档里的工具定义，零改动运行。

srutz没提这个词，但代码里埋了迁移路径——今天接OpenAI，明天换Anthropic，后天切到本地模型，改一行baseURL即可。

项目README的最后一句话是：「so you can do with it as you like」。没有Roadmap，没有Star目标，没有Discord邀请链接。

这种克制反而让代码本身成为唯一叙事。当你把agent.ts拖进VS Code，看到的不是框架，而是一份「如何与LLM谈判」的备忘录——系统角色怎么设、工具描述怎么写、循环终止条件怎么定，每一步都是决策点。

有个开发者在Issue里问：会支持多Agent协作吗？srutz没回复。但代码结构已经回答了：自己fork，加个 orchestrator 函数，比等作者更新快。

如果Agent工程的未来不是「调包侠」而是「代码裁缝」，Cagent这种「可复制」模式会成为主流吗？