最近我开源了一个项目FAME Knowledge Agent Gateway项目地址https://github.com/superalp1985/fame-knowledge-agent-gateway一句话介绍这是一个给 AI Agent 用的外部工程记忆 工具调用安全网关 知识路由系统。再说直白点大模型用它可以少飘一点。本地小模型用它可以更像一个能干工程活的助手。一、为什么要做这个项目现在很多人都在玩 AI Agent、本地大模型、自动写代码、自动调用工具。但真正用过的人都知道一个 Agent 真正进入工程环境后问题非常多它会忘记前面做过什么它会重复犯同样的错误它会乱调用 PowerShell、git、npm、文件操作它会把上下文塞满它经常“看起来完成了”但没有证据本地小模型尤其明显稍微复杂一点就容易跑偏。所以我做这个项目的初衷不是再造一个聊天机器人也不是做一个普通知识库。我想解决的是如何让本地小模型真正进入工程化使用我的判断是以后本地小模型会越来越强但它不可能只靠模型参数解决所有问题。它需要一套外部系统来帮它记住工程过程管住工具调用保留失败经验按需加载上下文按知识路线思考不要每次都从零开始。这就是 FAME Knowledge Agent Gateway 的定位。二、它现在能做什么目前这个项目已经能做到下面这些事功能 作用知识网路由 Agent 开工前先拿到当前任务相关的知识路线工程记忆 记录项目中的成功、失败、工具结果和决策工具调用防错 对 PowerShell、Git、Node/npm、JSONL 等高风险操作做预检失败签名 把错误变成可复用经验下次遇到类似问题提前拦截上下文裁剪 只加载当前任务需要的摘要不把全部日志塞进上下文FAME 参数 给知识路线记录可靠性、及时性、成功率和负经验可视化工作台 用 3D/2D 图谱查看知识网和工程记忆Agent 接入协议 让 Codex、Cursor、Claude Code、OpenHands 等工具类 Agent 按协议接入它不是普通 RAG。普通 RAG 主要是“查资料”。FAME 更偏向“工程执行前的路线规划 工具调用约束 失败经验回写”。三、一个典型例子PowerShell 翻车很多 Agent 在 Windows 上调用 PowerShell 时特别容易犯错。比如中文乱码路径带空格没处理删除命令范围不清楚PowerShell 和 cmd 混用相对路径不确认git 工作区有用户改动还直接覆盖。这些问题不是模型完全不知道而是它在真实工程里容易忽略。FAME 的做法是用户任务- 知识路由- 找到 PowerShell 风险域- 生成 ProposedAction- 检查路径、权限、预期结果、回滚方式- 必要时要求用户确认- 执行工具- 写回 ToolResultSummary- 更新失败签名和 FAME 参数也就是说Agent 不再是“想到命令就直接跑”而是先过一层工程安全网关。四、核心设计大模型防飘小模型增效这个项目的核心目标可以概括成一句话大模型防飘小模型增效。对于大模型它的问题往往是自信过头上下文太长后开始漂工具调用时不够谨慎没有把失败经验稳定沉淀下来。FAME 可以给它加一层外部约束。对于本地小模型它的问题更实际上下文短记忆弱工具调用不稳定工程经验不足复杂任务容易断。FAME 则相当于给它装了一个“工程外脑”。模型本身不用记住所有东西。它只需要在开工前读取路线在调用工具前读取规则在结束后写回摘要。五、FAME 参数是什么FAME 可以理解成一套路线评分机制。每一条知识路线、工具经验、失败教训都不是静态的。它需要知道这条路线以前成功过吗最近还有效吗有没有失败记录失败是环境问题还是方法问题这条知识适合当前任务吗可以用一个简化公式理解route_score 可靠性及时性证据强度成功反馈失败惩罚如果某条路线经常导致工具调用失败它不会被删除而是会变成负经验。这点很重要。工程里失败不是垃圾数据。失败是下一次避坑的路标。六、快速开始项目地址https://github.com/superalp1985/fame-knowledge-agent-gateway克隆项目git clone https://github.com/superalp1985/fame-knowledge-agent-gateway.gitcd fame-knowledge-agent-gatewayWindows 下可以直接运行.\start.ps1或者start.bat手动启动方式npm run install:allnpm run generate:allnpm run dev打开http://127.0.0.1:5178/启动运行时网关npm run gateway默认网关地址http://127.0.0.1:5191/七、当前内置检查结果目前项目内置了中英文两个开源版本的知识网和测试机制。英文版当前检查结果示例graph_nodes: 45graph_edges: 84routes: 48content_units: 104errors: 0warnings: 0Release 检查示例scanned_files: 969errors: 0warnings: 0这些不是第三方 benchmark只是项目自带的工程健康检查。它的目标不是证明模型变聪明了而是证明知识网结构完整路由能返回Agent 协议能读工具防错场景能跑中英文版本机制对齐。八、知识网可以怎么扩展这个项目开源后我最希望大家一起补的是知识网。目前开源版重点放在编程工具调用PowerShellGitNode/npmJSONL数据库同步Agent 工程记忆失败签名本地小模型工程化。后续大家可以继续补充Python 工程常见错误Docker 部署踩坑Linux shell 安全前端构建错误CI/CD 发布错误本地模型部署经验各种 Agent 的接入模板真实项目的失败案例。补充知识时不是随便扔一段文本进去而是按照这个结构学科分类- 抽象层级- 具体知识点- 路由关系- FAME 参数- 失败签名- 数据库详细内容这样知识网才不会变成一个乱糟糟的资料堆。九、它适合谁这个项目适合下面几类人正在用本地小模型的人正在折腾 AI Agent 的人经常让 Agent 调用命令行工具的人想沉淀个人工程知识资产的人做开源项目、长期项目、复杂工程的人想让 Agent 少犯低级错误的人。如果你只是想找一个聊天机器人这个项目可能不适合。如果你想让 AI 真正在本地参与工程它会比较有用。十、我为什么开源因为我觉得未来每个人都会有自己的 AI 工具链。模型会换。Agent 框架会换。IDE 会换。但个人积累下来的知识网、工程记忆和失败经验应该保留下来。FAME Knowledge Agent Gateway 想做的就是这层东西模型之外的长期工程资产它不追求替代任何 Agent。它更像是一个通用外部插件。你可以把它接给 Codex、Cursor、Claude Code、OpenHands也可以接给自己的本地 Agent。最后目标很简单让 Agent 少犯错让本地小模型更能干活让个人经验真正沉淀下来。项目地址GitHubhttps://github.com/superalp1985/fame-knowledge-agent-gateway欢迎 Star、Fork、提 Issue也欢迎直接补知识网。