ContextMax：为你的 LLM 精准导航代码库

告诉你的 LLM，对于每个任务，代码库中哪些部分才是真正重要的。

项目主页 | 立即试用

ContextMax 是一款基于浏览器的工具，用于为大型语言模型（LLM）创建“上下文集”（Context Set）。你可以定义对于特定任务而言，哪些文件、函数和工作流程是相关的。借助内置的 LLM 辅助搜索功能，你的代码永远不会离开你的浏览器。

【YouTube 视频】精心策划的上下文集如何帮助 LLM（点击观看）

SppedUpDemo-WithText.mp4

🚀 快速开始

[最快捷] 选项一：使用托管版本

访问在线管理工具。

隐私说明：即使在托管版本上，你的代码也只会保留在浏览器中。没有任何文件会上传到我们的服务器。

选项二：使用 npm 包在本地运行（推荐）

npx contextmax
# 默认运行在 3000 端口，你也可以像这样指定端口：
PORT=3005 npx contextmax

选项三：开发环境搭建

# 克隆并安装
git clone https://github.com/galliani/contextmax.git
cd contextmax
npm install

# 启动开发服务器
npm run dev

什么是 ContextMax

ContextMax 帮助你创建“上下文集”——这是一种 JSON 文件，用于告诉你的 LLM 应该关注代码库中的哪些部分。与其将整个项目一股脑地塞给 LLM，你可以精确指定：

• 哪些文件是相关的

• 哪些具体的函数是重要的

• 不同部分之间如何连接（工作流程）

核心特性

• 可视化构建器 (Visual Builder): 通过 UI 界面创建上下文集，无需手动编辑 JSON

• 100% 隐私 (100% Private): 所有操作均在浏览器中运行。无需服务器，无需上传

• 函数级上下文 (Function-Level Context): 可以指向特定函数，而不仅仅是文件

• 工作流映射 (Workflow Mapping): 展示文件和函数在数据流中如何连接

• 版本控制就绪 (Version Control Ready): 输出是简单的 JSON 文件，可以直接提交到版本库

• 团队共享 (Team Sharing): 团队成员可以使用相同的上下文定义

• 本地 AI (Local AI): 内置嵌入模型（Embeddings Model），提供智能文件建议

• 快速 (Fast): 使用 IndexedDB 缓存，并在可用时利用 WebGPU 加速

亲自尝试：见证差异

想证明上下文集是否有效吗？ContextMax 自身的代码库就使用了上下文集！

首先，克隆 contextmax 仓库：

git clone https://github.com/galliani/contextmax.git

然后，为了了解管理工具的工作原理

• 将 contextmax 仓库上传到工具中

或者，为了了解其工作原理

• 用你的 LLM 进行测试:

  • 提问："@context:embeddingsGeneration 是如何工作的？"

  • 提问："解释 @context:contextCreation 流程"

  • 与以下提问进行比较："在这个代码库中，嵌入生成是如何工作的？"

为什么选择 ContextMax

LLM 在处理真实代码库时常常失败，因为它们：

• 生成的代码忽略了现有的代码模式

• 遗漏了关键的依赖关系和关联

• 提出的解决方案不符合你的架构

• 迫使你反复解释相同的上下文

ContextMax 通过让你一次性定义并复用上下文来解决这个问题。你的团队将获得一致、准确的 AI 辅助，它真正理解你的代码结构。

没有上下文集的情况

graph TD
    A[提示：修复登录Bug] --> B[LLM 搜索代码库]
    B --> C[在所有文件中进行 Grep]
    C --> D[读取许多文件]
    D --> E[推断关系]
    E --> F[假设架构]
    F --> G[生成代码]
    G --> H{代码有效吗？}
    H -->|否| I[用户提供更多上下文]
    I --> B
    H -->|是| J[完成 - 使用了 10k+ tokens]

使用手动文件列表的情况

graph TD
    A[用户列出：login.vue, auth.controller.ts, user.model.ts] --> B[LLM 读取文件]
    B --> C[读取完整文件 - 3k tokens]
    C --> D[没有函数定位]
    D --> E[识别相关函数]
    E --> F[遗漏：中间件、验证器、工具函数]
    F --> G[没有工作流信息]
    G --> H[生成代码]
    H --> I[用户添加遗漏的文件]
    I --> J[包含更多上下文]
    J --> B

使用上下文集的情况

graph TD
    A[提示：修复登录Bug] --> B[LLM 加载上下文：UserAuth_Flow]
    B --> C[读取指定的 5 个文件]
    C --> D

## 常见问题（FAQ）

### ContextMax 如何确保我的代码隐私安全？

ContextMax 完全在浏览器本地运行，所有代码处理都在你的设备上进行，无需上传到外部服务器，从根本上保障了代码隐私和数据安全。

### 使用 ContextMax 有哪些快速开始的方式？

有三种方式：1) 直接使用托管版本；2) 通过 npm 包在本地运行（推荐）；3) 搭建开发环境。所有方式都基于浏览器，无需复杂配置。

### ContextMax 能为 LLM 提供什么样的上下文？

你可以为特定任务精准定义相关的文件、函数和工作流程，创建精确的上下文集，并利用内置的 LLM 辅助搜索功能，让 LLM 只关注代码库中真正重要的部分。