{"slug": "fame-an-external-memory-and-tool-safety-gateway-for-local-coding-agents", "title": "Fame, an external memory and tool-safety gateway for local coding agents", "summary": "FAME Knowledge Agent Gateway, an open-source external memory and tool-safety gateway for local coding agents, has been released. It combines a graph knowledge net, project memory, tool-call governance, and a visual workbench to help agents align goals, reason through structured knowledge, and execute tools under enforceable approval. The project aims to improve agent context health and tool safety by routing calls through a proposed-action approval gateway and retaining all traces externally.", "body_md": "中文优先。English follows.\n\nFAME Knowledge Agent Gateway 是一个面向 Agent 的万用外部插件：它把图谱知识网、项目工程记忆、工具调用治理、FAME 路由反馈和可视化工作台放在同一套外部运行时里。\n\n它不是普通 RAG，也不是普通聊天记忆。它的核心目标是让 Agent 在真实工程中先对齐目标、再按知识路线思考、再受控调用工具、最后把成功、失败、教训和证据写回外部记忆，而不是把所有东西堆进上下文里。\n\n``` php\ngoal\n-> scoped knowledge route\n-> abstraction and association\n-> FAME edge evaluation\n-> context pack\n-> ProposedAction\n-> Enforcement Kernel\n-> signed ApprovedAction\n-> Tool Gateway\n-> retained memory / trace / asset index\n```\n\n- Agent 外部记忆和执行治理插件。\n- 3D/2D 图谱知识网工作台。\n- 工程项目记忆 overlay，避免污染核心知识网。\n- 工具调用前置审批网关，避免 Agent 误调工具。\n- 语言树中枢 + 抽象/联想路线，让知识网参与思考，而不只是检索。\n- 多模态资产轻量索引，原始资产留在数据库/对象存储，图谱只保留预览和引用。\n\n**不是检索库**：知识以路线、抽象层级、联想边、FAME 参数组织。**上下文健康**：按`project_id / subject / route_id / task_id`\n\n裁剪，只打包当前任务需要的摘要和引用。**工具安全**：变更类工具必须经过`ProposedAction -> ApprovedAction -> Tool Gateway`\n\n。**可验证记忆**：测试、构建、工具结果、人工反馈会更新 FAME 路线状态。**全量保留**：不做记忆蒸发，原始日志、trace、失败教训保留在外部存储。**可开源扩展**：中文开源版和英文版保持 route、scenario、content unit、golden task 与评测机制同构。\n\n- 中文开源版：\n`versions/chinese-open/`\n\n，专门为了开源整理的干净种子，重点是 Agent 工具调用治理和高频错误域。 - 英文版：\n`versions/english/`\n\n，与中文开源版机制和知识网结构对齐，中心为`Language Tree Hub`\n\n。 - 根目录运行时：工作台、运行时网关、公共示例数据、项目记忆 overlay 和资产轻量索引。\n\n外部 Agent 接入先看：[AGENTS.md](/superalp1985/fame-knowledge-agent-gateway/blob/main/AGENTS.md)。\n\n一键启动：\n\n```\nstart.bat\n```\n\n或：\n\n```\n.\\start.ps1\n```\n\n脚本会设置 UTF-8 输出、安装缺失依赖、生成索引、启动 Runtime Gateway 和 Workbench，并打开 `http://127.0.0.1:5178/`\n\n。\n\nWorkbench 默认进入 `Agent 外脑`\n\n控制台。这里会把安全阻断红绿灯、动作契约审批流、失败签名热力区、动态免疫网、上下文健康和记忆写回队列放在同一屏，方便先确认 Agent 是否接入、工具调用是否可放行、失败教训是否会回写。\n\n需要接入本机 Agent 时，进入 `Agent Runtime`\n\n视图使用首次接入向导，可选择中文开源版或 English open edition，并生成主流 Agent 的接入消息和配置片段。\n\n手动启动：\n\n```\nnpm run install:all\nnpm run generate:all\nnpm run dev\n```\n\n打开：\n\n```\nhttp://127.0.0.1:5178/\n```\n\n启动运行时网关：\n\n```\nnpm run gateway\n```\n\n默认 HTTP 地址：\n\n```\nhttp://127.0.0.1:5191/\n```\n\n启动 MCP stdio 网关：\n\n```\nnpm run gateway:mcp\n```\n\n详细中文说明见：[docs/使用手册.zh-CN.md](/superalp1985/fame-knowledge-agent-gateway/blob/main/docs/%E4%BD%BF%E7%94%A8%E6%89%8B%E5%86%8C.zh-CN.md)\n\n```\nnpm run check:chinese-open\nnpm run check:english\nnpm run check:editions\nnpm run doctor:english\nnpm run eval:english\nnpm run package:portable\ndocker compose up --build\n```\n\n`package:portable`\n\n会生成 `.tmp/release/fame-knowledge-agent-gateway-portable.zip`\n\n。Docker 默认暴露 Workbench `5178`\n\n和 Gateway `5191`\n\n。\n\nGitHub Release 一键安装会发布 `install.ps1`\n\n、portable zip、SHA256 校验文件和 release manifest。用户可从 Release 下载，或使用：\n\n```\nInvoke-WebRequest -Uri \"https://github.com/<owner>/<repo>/releases/latest/download/install.ps1\" -OutFile \"install.ps1\"\npowershell -NoProfile -ExecutionPolicy Bypass -File .\\install.ps1\n```\n\n发布资产生成：\n\n```\nnpm run build:release-assets\n```\n\nFAME Knowledge Agent Gateway is a universal external plugin for agents. It combines a graph-based knowledge net, project memory, tool-call governance, FAME route feedback and a visual workbench into one external runtime.\n\nIt is not plain RAG and not plain chat memory. Its purpose is to help agents align goals, route through structured knowledge, call tools through enforceable approval, and retain evidence, lessons and traces outside the active model context.\n\n- External memory and execution-governance plugin for agents.\n- 3D/2D graph workbench for knowledge navigation and editing.\n- Project Memory overlay that does not pollute the core knowledge net.\n- Tool Gateway that blocks unsafe direct mutation calls.\n- Language Tree-centered abstraction and association reasoning.\n- Multimodal light index that keeps raw assets outside the graph.\n\n**Beyond retrieval**: knowledge is organized by routes, abstraction layers, association edges and FAME parameters.** Context health**: context is scoped by`project_id / subject / route_id / task_id`\n\n.**Tool safety**: mutation tools must pass`ProposedAction -> ApprovedAction -> Tool Gateway`\n\n.**Verifiable memory**: build, test, tool and human feedback update route confidence and lessons.** Full retention**: raw traces and lessons are retained externally instead of being erased.** Open-source ready**: Chinese full edition plus an English seed edition.\n\n```\nnpm run install:all\nnpm run generate:all\nnpm run dev\n```\n\nOpen:\n\n```\nhttp://127.0.0.1:5178/\n```\n\nThe Workbench opens on the `Agent 外脑 / Agent External Brain`\n\nconsole first. It shows the stoplight gate, Action Contract approval flow, failure-signature heat zone, dynamic immune net, context health and memory write-back queue before users drill into Agent Runtime, 3D Universe, 2D Detail, FAME or GoalGate views.\n\nStart the runtime gateway:\n\n```\nnpm run gateway\n```\n\nStart the MCP stdio gateway:\n\n```\nnpm run gateway:mcp\n```\n\nDetailed English guide: [docs/USER_GUIDE.en.md](/superalp1985/fame-knowledge-agent-gateway/blob/main/docs/USER_GUIDE.en.md)\n\nAgent integration protocol: [AGENTS.md](/superalp1985/fame-knowledge-agent-gateway/blob/main/AGENTS.md)\n\n```\n.\n|-- workbench/              # React + Three.js + React Flow workbench\n|-- runtime_server/         # HTTP/MCP gateway, SQLite store, enforcement kernel\n|-- docs/                   # docs and user guides\n|-- examples/               # client and sample knowledge examples\n|-- scripts/                # public knowledge sanitizer and release checks\n|-- knowledge/              # Chinese/public knowledge-net base\n|-- versions/               # Chinese edition note and English seed edition\n|-- asset_store/            # public sample asset light indexes\n|-- memory/                 # public sample project-memory overlay\n|-- runtime_store/          # local runtime artifacts, ignored\n`-- knowledge_backup/       # private local knowledge, ignored\nnpm run release:check\nnpm run gateway:smoke\nnpm run lint\nnpm run build\nnpm run build:release-assets\n```\n\nOr:\n\n```\nnpm run ci\n```\n\nDo not commit:\n\n`.env`\n\n- real API keys or approval secrets\n- local runtime databases\n- private knowledge data\n- generated private indexes\n- raw multimodal payloads that are not cleared for publication\n\nBefore public release, run an independent secret scan and license review. Theory PDFs and public knowledge materials may need separate attribution review.\n\nApache License 2.0. See [LICENSE](/superalp1985/fame-knowledge-agent-gateway/blob/main/LICENSE).", "url": "https://wpnews.pro/news/fame-an-external-memory-and-tool-safety-gateway-for-local-coding-agents", "canonical_source": "https://github.com/superalp1985/fame-knowledge-agent-gateway", "published_at": "2026-06-29 12:05:13+00:00", "updated_at": "2026-06-29 12:22:40.291575+00:00", "lang": "en", "topics": ["ai-agents", "ai-tools", "ai-safety", "developer-tools", "ai-infrastructure"], "entities": ["FAME Knowledge Agent Gateway", "GitHub", "Docker", "MCP"], "alternates": {"html": "https://wpnews.pro/news/fame-an-external-memory-and-tool-safety-gateway-for-local-coding-agents", "markdown": "https://wpnews.pro/news/fame-an-external-memory-and-tool-safety-gateway-for-local-coding-agents.md", "text": "https://wpnews.pro/news/fame-an-external-memory-and-tool-safety-gateway-for-local-coding-agents.txt", "jsonld": "https://wpnews.pro/news/fame-an-external-memory-and-tool-safety-gateway-for-local-coding-agents.jsonld"}}