PasteMax

一款现代化的文件查看器应用，专为开发者设计，可轻松浏览、搜索和复制代码库中的代码。
非常适合粘贴到 ChatGPT 或您选择的大型语言模型中。基于 Electron、React 和 TypeScript 构建。

概述

PasteMax 是一款专为使用 AI 编程助手的开发者打造的简单桌面应用。它通过智能文件浏览器、令牌计数、文件过滤、快速复制和预览功能，让与大型语言模型分享代码变得轻而易举。只需选择所需的文件，跳过二进制文件和无用内容，即可获得干净、格式化的代码片段，直接用于您的 LLM。

视频

YouTube 链接

功能

文件导航与管理

• 文件树导航：通过可展开的树形视图浏览目录和文件
• 搜索功能：按文件名或内容快速查找文件
• 排序选项：按名称、大小或令牌数量对文件进行排序
• 文件更改监听器：当文件被添加、修改或删除时，自动更新文件列表
• 手动刷新：在需要时可执行完整的目录重新扫描

适合 AI 的功能

• 令牌计数：查看每个文件的大致令牌数量
• 模型上下文限制：选择不同的模型（Claude-3.7、GPT-4o、Gemini 2.5 等）
• 上下文限制警告：当所选内容超过模型的上下文限制时发出提醒

内容与预览

• 文件预览器：在专用的预览窗格中查看文件内容
• 多文件选择：可以选择多个文件并一起复制其内容
• 二进制文件检测：自动检测并排除二进制文件
• 智能文件排除：自动排除 package-lock.json、node_modules 等文件

工作流增强

• 工作区管理：保存和加载工作区，以便快速访问目录
• 自动更新检查器：保持应用程序始终处于最新版本
• 深色模式：可在浅色和深色主题之间切换，以获得舒适的观看体验
• 跨平台支持：适用于 Windows、Mac、Linux 和 WSL

安装

下载二进制文件

从 发布页面 下载最新的 PasteMax 版本。

从源码构建

1. 克隆仓库：

git clone https://github.com/kleneway/pastemax.git
cd pastemax

2. 安装依赖项：

npm install

3. 构建应用：

npm run build:electron
npm run package

注意：如果在运行 npm run package 时遇到问题，可以尝试使用特定于平台的命令：

npm run package:win
npm run package:mac
npm run package:linux

成功构建后，您将在 release-builds 目录中找到可执行文件：

Windows：

• PasteMax Setup 1.0.0.exe - 安装程序版本
• PasteMax 1.0.0.exe - 便携式版本

Mac：

• PasteMax 1.0.0.dmg - 安装程序版本
• PasteMax 1.0.0.zip - 便携式版本

Linux：

• PasteMax 1.0.0.deb - 安装程序版本（Deb 包）
• PasteMax 1.0.0.rpm - 安装程序版本（RPM 包）
• PasteMax 1.0.0.AppImage - 便携式版本

开发

前提条件

• Node.js（v14 或更高版本）
• npm 或 yarn

在开发模式下运行

要在开发模式下运行应用程序：

# 启动 Vite 开发服务器
npm run dev

# 在另一个终端中启动 Electron
npm run dev:electron

为生产环境构建

要为生产环境构建应用程序：

# 使用 Vite 构建 React 应用程序，并更新 Electron 的路径
npm run build:electron

# 创建特定于平台的分发包
npm run package

项目结构

• src/ - React 应用程序源代码
  • components/ - React 组件
  • context/ - React 上下文提供者
  • hooks/ - 自定义 React 钩子
  • types/ - TypeScript 类型定义
  • utils/ - 工具函数
  • styles/ - CSS 样式
  • assets/ - 静态资源，如图片
• electron/ - Electron 后端相关文件
• public/ - 公共资源（favicon 等）
• scripts/ - 用于构建和测试的实用脚本
• docs/ - 文档

使用的库

• Electron - 桌面应用程序框架
• React - UI 库
• TypeScript - 类型安全
• Vite - 构建工具和开发服务器
• tiktoken - 用于估计 LLM 上下文的令牌计数
• ignore - 基于 .gitignore 样式的文件排除模式匹配
• chokidar - 文件监视器

故障排除

Windows 上出现“警告：不受信任”

如果您看到关于应用程序不受信任的警告，可以通过点击“仍要运行”来绕过此问题。这是 Electron 应用程序中常见的问题，尤其是因为 PasteMax 未签名。

Mac 上出现“应用程序无响应”

如果您在 Mac 上遇到“应用程序无响应”的提示，可能是由于 macOS 的安全设置所致。您可以尝试以下操作：

1. 打开系统偏好设置。
2. 转到安全性与隐私。
3. 在“通用”选项卡下，找到“允许从以下位置下载的应用程序”部分。
4. 查找“PasteMax”，然后点击“仍要打开”。

其他问题

如果您遇到其他问题，请在 GitHub 上报告。

许可证

MIT 许可证 - 详情请参阅 LICENSE 文件。

贡献

欢迎贡献！请随时提交拉取请求。

1. 分支仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加一些惊人的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开拉取请求

星标历史 ⭐

---

PasteMax 快速上手指南

PasteMax 是一款专为开发者打造的现代化桌面文件查看器，旨在帮助用户轻松浏览、搜索代码库，并将选中的代码片段一键复制到大语言模型（如 ChatGPT、Claude 等）中。它具备智能文件过滤、Token 计数和上下文限制预警等功能，是 AI 编程助手的理想搭档。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows、macOS、Linux 或 WSL。
• Node.js：版本 v14 或更高。
• 包管理器：npm 或 yarn。

国内加速建议： 若下载依赖较慢，建议配置淘宝镜像源：

npm config set registry https://registry.npmmirror.com

安装步骤

您可以选择直接下载编译好的安装包，或从源码构建。

方式一：下载二进制文件（推荐）

访问 GitHub Releases 页面 下载适合您系统的最新版本：

• Windows: PasteMax Setup x.x.x.exe (安装版) 或 PasteMax x.x.x.exe (便携版)
• macOS: PasteMax x.x.x.dmg (安装版) 或 PasteMax x.x.x.zip (便携版)
• Linux: .deb, .rpm 安装包或 .AppImage 便携版

方式二：从源码构建

如果您希望自定义构建或参与开发，请按以下步骤操作：

1. 克隆仓库

   git clone https://github.com/kleneway/pastemax.git
   cd pastemax
   

2. 安装依赖

   npm install
   

3. 构建应用

   npm run build:electron
   npm run package
   

   注：若上述命令失败，可尝试平台专用命令：npm run package:win、npm run package:mac 或 npm run package:linux。

构建完成后，可执行文件将位于 release-builds 目录中。

基本使用

以下是使用 PasteMax 辅助 AI 编程的最简流程：

1. 启动应用：运行安装好的 PasteMax 程序。
2. 加载项目：
   • 点击界面打开您的代码项目目录。
   • 应用会自动识别并排除二进制文件及无关依赖（如 node_modules、package-lock.json）。
3. 选择文件：
   • 在左侧文件树中勾选需要发送给 AI 的代码文件。
   • 观察底部的 Token 计数，确保所选内容未超过您设定的模型上下文限制（支持切换 Claude-3.7, GPT-4o 等模型预设）。
4. 预览与复制：
   • 在右侧预览 pane 确认代码内容。
   • 点击 Copy 按钮，所有选中文件的代码将以格式化文本形式复制到剪贴板。
5. 粘贴至 AI：打开您的 LLM 对话框，粘贴内容即可开始对话。

此外，您还可以使用 Workspace Management 功能保存常用项目路径，以便下次快速加载。