
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2475
使用教程
环境要求
- Unix-like 系统(macOS 或 Linux);README 未提供完整的 Windows 安装命令
- 能访问网络,安装脚本通过 curl 下载
- 建议在 Git 仓库中运行,以便利用 .gitignore 和 Git 历史推断文件重要性
- 安装命令依赖 curl(README 安装命令使用 curl -fsSL)
安装与启动步骤
-
1安装 yek
在 macOS/Linux 终端执行官方安装脚本。注意:README 中 Windows 安装章节内容不完整,未给出命令。
curl -fsSL https://azimi.me/yek.sh | bash -
2进入目标目录
切换到要序列化的仓库或目录,yek 会按当前目录内容处理并应用 .gitignore 规则。
cd /your/project -
3运行序列化
默认直接运行即可序列化整个仓库,结果写入临时文件,控制台会打印该文件路径。
yek -
4管道输出内容
yek 会自动检测输出是否被管道接管,若被管道接管则直接流式输出内容而不写文件。
yek > context.txt -
5使用自定义配置
在项目根目录放置 yek.yaml,或用 --config-file 指定配置路径,自定义忽略规则、输出等。
yek --config-file /your/path/yek.yaml
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
max_size | 否 | 输出大小上限,也支持用 tokens 单位 | 128K |
json | 否 | 开启 JSON 格式输出 | false |
debug | 否 | 开启调试日志 | false |
line_numbers | 否 | 输出中包含行号 | false |
tree_header | 否 | 在开头包含目录树 | false |
如何确认成功
运行 yek 后控制台打印出生成的临时文件路径,即表示序列化成功;用管道运行时则直接看到文件内容输出。
常见问题
Q:序列化结果保存在哪里?
A:默认写入临时目录中的一个文件,并把该文件路径打印到控制台。若输出被管道接管,则改为流式输出内容,不写文件。
Q:如何忽略不需要的文件?
A:默认使用 .gitignore 规则跳过文件,并自动推断额外的忽略模式(如二进制、大文件等),也可在 yek.yaml 中添加自定义忽略模式。
Q:为什么重要文件排在输出最后?
A:yek 会依据 Git 历史推断文件重要性,让更重要文件靠后出现,因为 LLM 通常更关注上下文末尾的内容。
Q:怎么修改输出大小或格式?
A:在项目根目录的 yek.yaml 中设置 max_size、json、line_numbers、tree_header 等,或用 --config-file 指定配置文件路径。
Q:Windows 怎么安装?
A:README 的 Windows 安装章节内容不完整、未给出具体命令,请以仓库最新 README 为准,本教程不虚构命令。
注意事项
- 本教程命令全部来自 README,Windows 安装命令缺失故未提供。
- 配置文件可放在项目根目录,也可通过 --config-file 指定自定义路径。
- yek 支持一次处理多个目录、glob 模式与指定单个文件(README 提及但未给出具体命令示例)。
- README 未说明具体端口、版本号或安装路径,教程中不做假设。
核心亮点
- 基于 Rust 实现,处理大型仓库速度极快,节省等待时间
- 自动过滤二进制和无关文件,有效节省 LLM 上下文窗口
- 输出结构清晰,方便 LLM 理解项目文件层级和依赖关系
不足之处
- 仅支持文本文件,对图片、PDF 等非文本内容无法处理
- 文档/社区待观察
适用场景
- 使用 AI 编程助手时快速提供整个项目的代码上下文
- 构建基于代码库的 RAG 系统,作为数据预处理工具
- 在 CI/CD 中自动生成项目摘要供 AI 分析
替代项目
RepoMix、gpt-repository-loader、code2prompt
上一篇:vllm-ascend
同类项目推荐
humming
开源
运行时生成量化矩阵乘内核,推理更快更灵活
Humming is a high-performance, lightweight, and highly flexible JIT (Just-In-Time) c···
hazmat
开源
给 AI 代理套上安全笼子,防破坏防泄露,还能一键回滚
Containment for AI agents - user isolation, sandboxed execution, network controls, b···
knowledgeops-agent
开源
快速搭建企业级安全可观测的 RAG 知识问答平台
Production-oriented Spring AI platform prototype for RAG, tool calling, async ingest···
openlit
开源
一键接入,全栈监控你的 LLM 应用,从开发到生产。
Same agent Smaller bill. The tools and infrastructure to get more work from your AI.···
mxcp
开源
把企业数据安全接入大模型,让 AI 直接查数分析
Model eXecution + Context Protocol: Enterprise-Grade Data-to-AI Infrastructure
Wax
开源
在 Apple 设备上实现亚毫秒级本地 AI 记忆检索,无需服务器
Shared Single-file memory layer for all your agents, sub mili-second RAG over text, ···
Agent2API
开源
一个本地网关,把桌面 AI 客户端的额度变成标准 API
Local AI routing gateway with Agent client takeover — reuse existing client logins,···
tunnel-client
开源
把本地 MCP 服务安全连到 ChatGPT 等 AI 工具,无需公网暴露
Customer-run client for Secure MCP Tunnel: connect private or localhost MCP servers ···
KVzip
开源
长文本推理显存直降4倍,延迟减半,即插即用
[NeurIPS'25 Oral] Query-agnostic KV cache eviction: 3–4× reduction in memory and 2···