vzroslieigry/maxagent

项目介绍

maxagent 是面向编程智能体的经验层，支持 Claude Code、Codex、Antigravity 和 OpenClaw。它解决的问题是：智能体每次会话都在重新搜索、试错、再找到同一个解法。maxagent 把这些经验沉淀为简短的、经过验证的「原子」（atom），放进一个共享工作区，并用项目文件记住工作停在哪里。钩子会在用户消息、命令执行前或报错后自动呈现相关原子。

仓库包含两个包：主包 maxagent（规则、工作区、经验引擎、各智能体的钩子、安装向导），以及 maxagent-bridge，一个 MCP 服务器，通过小型浏览器扩展操作用户自己的 Chrome 配置（保留登录状态），带逐智能体审批、站点黑名单、操作日志和停止按钮。

快速使用

需要 Node.js 18 或更高版本。运行安装向导：

npx maxagent init

向导默认在 ~/maxagent 创建工作区（AGENTS.md、experience/、projects/、sync.md、inbox/），为检测到的每个受支持智能体写入一段带标记的规则并安装钩子，修改前会备份原文件。可选项由一个「全部安装 / 自选 / 都不装」问题控制：

• 浏览器桥：npx maxagent bridge，然后在 chrome://extensions 中开启开发者模式并加载已解压的扩展文件夹。
• 语义搜索：npx maxagent vectors 会把 multilingual-e5-small 模型和 Python 依赖（约 270 MB）下载到 ~/.maxagent/vector；没有 Python 时退化为按词匹配。
• 共享经验包：npx maxagent experience add all。

完成后用 npx maxagent doctor 查看安装状态；npx maxagent setup 修改设置；npx maxagent uninstall 删除智能体中的规则块和钩子，工作区保留。也可以通过一句指令让智能体代为安装，npm 页面见 maxagent。

经验的两层结构

自己工作区 experience/ 中的原子优先展示，且可以拦截已知会失败的命令。共享包只作参考：仅在自己那层为空时出现，阈值更高，每条消息最多展示一个精简原子，且从不拦截命令。有用的共享原子可用 npx maxagent experience adopt "<id>" 复制进自己的库。共享包是挂在 GitHub Releases 上的单个 JSON 文件，由 packs/catalog.json 列出 sha256 和大小；客户端安装前会校验校验和、文件名和文本内容（下载即执行命令、改写智能体规则、外发密钥、破坏性命令、隐藏字符），命中任何一项就整包拒绝。

使用约束

工作区文件归用户所有，更新不会覆盖。网络请求都是对公开文件的普通 GET（npm registry、news.json 通知源，以及经用户同意后的 GitHub Releases 和 Hugging Face 模型文件）；在 npx maxagent setup 中关闭 updates 可完全停止请求，每日后台更新检查只在会话开始时提示一次新版本。浏览器桥走 Chrome Native Messaging 和本地管道/套接字，不开放端口；扩展目前仍需手动加载。规则翻译由智能体完成，尚未经母语者校对。项目使用 MIT 许可证。

HotRepo 点评

在 2026-11-10 的 JavaScript 新项目榜中，maxagent 记录到 112 颗 Star，在 22:15 至 23:45 UTC 的统计窗口内新增 9 颗，没有捕获到全语言日榜名次。对创建仅两天的项目来说样本很短，这组数字反映的是初期关注度，而不是持续采用。更值得观察的设计是把可写的个人原子和经过校验和检查的共享包分开：经验到底会有效积累还是变成噪音，取决于这条分界是否成立。