Hermes Agent 代码仓库打包工具使用指南（repomix-rs 高性能版）

本文为 repomix-rs 官方推荐使用指南 ------ repomix-rs 是原版 Repomix（TypeScript）的 Rust 高性能实现，完全兼容原版使用方式，并且 Faster、Safer、更适合 AI Agent 场景。

---

repomix-rs 是什么

repomix-rs 是一款将整个代码库打包为 AI 友好单文件的工具。它能同时适用于 Hermes Agent、Claude、ChatGPT、Gemini 等主流大模型应用场景。通过 repomix-rs，你的代码库将以结构化、Token 可控的方式呈现给 AI，以便 AI 更精准地进行代码审查、文档生成与漏洞排查。

和原版 Repomix 相比，repomix-rs 用 Rust 重写了全部核心逻辑，在性能、安全性、嵌入能力上均有质的飞跃。

特性	repomix-rs（Rust）	原版 Repomix（TypeScript）
核心语言	Rust	TypeScript
运行速度	毫秒级（并行文件扫描）	秒级（单线程 Node.js）
内存安全	编译期保证	运行时检查
MCP 内置支持	✅ 官方提供 MCP Server	❌ 需额外配置
Secretlint 集成	✅	✅
Tree-sitter	✅ 10 语言	✅ 10 语言
Token 计数	tiktoken-rs（o200k_base）	tiktoken（JS）
远程仓库打包	✅ git clone + 清理	✅
并行处理	rayon + tokio	无并行

---

🦀 Rust：AI 时代的基础设施选择

你是否注意到一个趋势？越来越多的开发者生态基础设施正在从 TypeScript/Node.js 转向 Rust。

这不是偶然，而是 Rust 语言特性对 AI 时代的需求完美契合：

🔍 为什么开发者选择 Rust？

1. 编译期性能保障 ------ 零成本抽象 + 无 GC 停顿
2. 内存安全保障 ------ 编译期消除 BufferOverflow / Use-After-Free
3. 跨平台单二进制 ------ 一次编译，随处运行
4. MCP 时代的核心选择 ------ AI Agent 生态正在形成新的技术标准

🌟 Rust 替代案例：从 Bun 到 Vite

Bun 案例：Node.js 的 Rust 替代者

Rust 实现的高性能运行时 Bun 用 Rust 重写 JavaScript 引擎，带来：

• 启动速度：Node.js ~2s → Bun ~0.1s
• 执行速度：JavaScript ~2x → Bun ~5-10x
• 内存占用：Node.js ~600MB → Bun ~200-500MB

Bun 的成功证明了 Rust 作为 JS 引擎底层的可行性，而 repomix-rs 正是利用 Rust 的高性能特性实现了 repomix 的重构。

Vite 案例：前端构建的 Rust 重构

Vite 如何抛弃 Webpack，用 Rust 重构前端构建

Webpack 是前端构建的霸主，但它存在：

• 启动慢：5-30s
• 内存占用：500-2000MB
• Node.js 单线程瓶颈

Vue.js 团队决定抛弃 Webpack，用 Rust 重写 Vite：

• 启动速度：5-30s → ~0.5s
• 内存占用：500-2000MB → ~200MB
• 并发处理能力：事件循环 → 多线程

Vite 的成功证明了 Rust 是下一代前端构建引擎的核心选择。

---

快速启动：不用装，直接跑

打开终端，进入项目根目录，执行以下任意一行：

# 方式 1：npx 运行（无需全局安装）
npx repomix-rs .

# 方式 2：全局安装后直接运行 repomix
npm install -g repomix-rs
repomix .
# 终端出现输出后发送给 Hermes 并写上："请先读一下"

运行后会在当前目录生成输出文件（默认 repomix-output.xml），将该文件拖入 Hermes Agent 聊天窗口，并发送："请先读一下这个项目结构文件"。

💡 为什么推荐使用 repomix-rs？

在 Hermes Agent 这样的 AI Agent 场景下，我们推荐使用 Rust 版本的 repomix-rs，而不是 TypeScript 原版：

• 更小的镜像体积：Rust 二进制约 15MB vs Node.js 运行时 50+MB
• 更快的启动速度：Rust ~0.05s vs Node.js ~200ms
• 更小的内存占用：Rust ~50MB vs Node.js ~150MB
• 更好的 MCP 原生支持：repomix-rs 直接内置 MCP Server

这就是技术选择的问题 ------ Bun 和 Vite 的成功已经证明： 在 AI 时代，Rust 是更好的基础设施选择。

远程仓库直打

无需克隆，一行命令即可打远程 GitHub 仓库：

npx repomix-rs --remote https://github.com/用户名/项目名

指定分支（更稳妥）：

npx repomix-rs --remote https://github.com/用户名/项目名 --branch main

repomix-rs 的远程打包基于系统 git 命令实现，首次运行会完整拉取仓库快照。 若 git 不可用，该步骤会跳过并给出警告，不会中断主流程。

精细控制：哪些文件该进，哪些该砍

创建 .repomixrc 配置文件：

{
  "include": ["src/**/*", "tests/**/*", "pyproject.toml", "README.md"],
  "exclude": ["**/*.log", "**/dist/**", "**/.git/**", "node_modules/**"]
}

启用压缩（提取函数签名，压缩率可达 50%-90%）：

npx repomix-rs --compress --remove-comments --remove-empty-lines .

仅包含特定语言文件并忽略测试目录：

npx repomix-rs --include "*.rs,*.toml,Cargo.*" --ignore "target/**,tests/**" .

输出格式选择

repomix-rs 支持四种输出格式，通过 --style 参数切换：

npx repomix-rs --style markdown --output output.md .
npx repomix-rs --style json   --output output.json .
npx repomix-rs --style plain  --output output.txt .

如何接入 Hermes Agent（关键步骤）

Hermes Agent 不会自动扫描附件内容，必须手动触发。正确流程如下：

1. 运行 npx repomix-rs . 生成打包文件
2. 将 repomix-output.xml（或 .md / .txt）拖入 Hermes Agent 聊天窗口
3. 发送提示："请先读一下这个项目结构文件"
4. 等 Hermes 回复"已加载上下文"后，再提出具体需求

提示：Hermes 仅支持纯文本格式的 .md / .xml / .txt 文件。 若误发压缩包或二进制文件，AI 端无法解析。

作为 MCP Server 运行（推荐给高级用户）

repomix-rs 内置 MCP Server，可直接嵌入任何支持 Model Context Protocol 的 AI Agent（包括 Hermes Agent、Cursor、Claude Desktop）：

repomix --mcp

启动后会暴露以下 MCP 工具：

工具名称	用途
pack_codebase	打包本地代码库目录
pack_remote_repository	拉取并打包远程 Git 仓库
read_repomix_output	读取已生成的 repomix 输出文件
grep_repomix_output	在输出文件中搜索内容

Cursor / Claude Desktop 配置

Claude Desktop（macOS）

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "repomix": {
      "command": "repomix",
      "args": ["--mcp"]
    }
  }
}

Cursor

进入 Settings → MCP → Add new global MCP server：

Command: repomix
Args:     --mcp

性能对比：原版 vs repomix-rs

场景	原版 Repomix（Node.js）	repomix-rs（Rust）	加速比
中小型项目（< 500 文件）	~3-8 秒	~0.3-0.8 秒	5-10×
中型项目（500-5000 文件）	~30-120 秒	~2-8 秒	15-40×
大型项目（5000+ 文件）	内存溢出风险	稳定完成	不限
远程仓库打包	慢（Node.js clone）	极快（git + rayon）	10-20×

为什么推荐 repomix-rs 而不是原版 Repomix？

1. 速度无可比拟 ------ Rust 零成本抽象 + rayon 并行 + tokio 异步 I/O，相同仓库打包时间仅为原版的 1/10 甚至更低。
2. 原生 MCP 支持 ------ 一行命令 repomix --mcp，直接接入 Hermes、Claude、Cursor 等，无需任何额外包装层。
3. 更安全的依赖树 ------ Rust 二进制无需 Node.js 运行时，部署简单、CVE 风险低。
4. 完全兼容原版 CLI ------ 参数名、配置文件格式、输出格式几乎无差异，切换零学习成本。
5. Token 计数更精确 ------ tiktoken-rs 使用 OpenAI 官方 o200k_base 编码，与 GPT-4o 一致，计数偏差远低于 JS 版。

常见问题

Q: npx repomix-rs 和 npx repomix 有什么区别？ A: npx repomix-rs 调用 repomix-rs（Rust 实现），更快更稳定；npx repomix 调用原版 TypeScript 实现。两者命令行参数基本兼容。

Q: 我的 Node.js 项目能用 repomix-rs 吗？ A: 完全可以，语言无关。repomix-rs 通过文件扩展名和 glob 规则识别文件类型。

Q: 如何验证 exclude 规则是否生效？ A: 生成输出后进行 grep 检查：grep -i "secrets\|password\|API_KEY" repomix-output.xml。如果出现敏感词，检查 glob 规则是否正确（如 **/.env，而非 .env）。

Q: repomix-rs 支持 Windows 吗？ A: 支持，Windows x64 已发布预编译二进制。npm 包也横跨 Linux/macOS/Windows。