[!NOTE]
☝️ 我目前正在寻找工作！尤其对柏林的公司或德国境内的远程职位感兴趣。这是我的 简历 和 LinkedIn 个人主页。谢谢大家 🙏

TaxHacker 是一款专为自由职业者、独立开发者和小型企业设计的自托管会计应用，旨在利用现代 AI 的强大功能节省时间，并实现费用与收入追踪的自动化。

只需上传收据、发票或 PDF 文件的照片，TaxHacker 就能自动识别并提取会计所需的所有重要数据：商品名称、金额、项目明细、日期、商家信息、税费等，并将其保存到类似 Excel 的结构化数据库中。你甚至可以通过自定义 AI 提示词创建专属字段，以提取任何特定信息。

该应用还具备基于交易日期历史汇率的自动货币转换功能（包括加密货币！）。借助内置的筛选功能、多项目支持、导入导出能力以及自定义分类，TaxHacker 能够简化报表生成，让报税工作变得更加轻松。

🎥 观看演示视频

[!IMPORTANT]

本项目目前仍处于早期开发阶段，请谨慎使用！请给项目加星，以便及时获取新功能和错误修复的通知 ⭐️

✨ 功能特性

1 使用 AI 分析照片和发票

拍摄任意收据的照片或将发票 PDF 上传，TaxHacker 将自动识别、提取、分类并将所有信息存储到结构化的数据库中。

• 上传与整理文档：可将多个文档暂存于“未分类”文件夹，待您准备好再手动处理或借助 AI 处理。
• AI 数据提取：利用 AI 自动提取日期、金额、供应商及明细项目等关键信息。
• 自动分类：根据内容自动将交易归入相关类别。
• 项目拆分：从发票中提取单个项目，并在需要时将其拆分为单独的交易记录。
• 结构化存储：所有数据都会被保存到有序的数据库中，方便后续筛选和检索。
• 选择 LLM 模型：您可以使用 OpenAI、Google Gemini、Mistral，或者本地部署的 LLM（在自托管版本中）。但数据的质量和隐私安全由您自行负责。

TaxHacker 可以处理多种类型的文档，包括商店收据、餐厅账单、发票、银行对账单、信件，甚至是手写收据。它能够轻松应对任何语言和任何币种。

2 多币种支持与自动换算（包括加密货币！）

TaxHacker 会自动检测文档中的币种，并根据历史汇率将其转换为您设定的基础币种。

• 多币种检测：自动识别文档中使用的货币。
• 历史汇率：根据实际交易日期获取汇率。
• 全球覆盖：支持超过 170 种世界货币以及 14 种主流加密货币（BTC、ETH、LTC、DOT 等）。
• 灵活输入：当您需要更精细的控制时，也可以手动输入。

3 使用您自己的 LLM：Ollama、LM Studio、vLLM、LocalAI 等

该应用兼容您的本地 LLM 或 OpenAI 兼容的 API 端点。请确保您的本地模型在 OCR 任务上表现良好，否则结果可能无法保证 :)

4 使用完全可定制的分类、项目和字段组织交易

通过无限的自定义选项，让 TaxHacker 更贴合您的独特需求。您可以创建符合自身业务特点、行业标准或国家规定的自定义字段、项目和分类。

• 自定义分类和项目：创建属于您自己的分类和项目，以任何便捷的方式对交易进行分组。
• 自定义字段：您可以创建无限数量的自定义字段，从发票中提取更多详细信息（就像在 Excel 中添加额外的列一样）。
• 全文搜索：直接搜索已识别文档的实际内容。
• 高级筛选：通过搜索和筛选功能精准定位所需内容。
• AI 驱动的提取：编写专属提示词，从文档中提取任何自定义信息。
• 批量操作：一次处理多个文档或交易记录。

5 自定义任意 LLM 提示词，甚至系统提示词

全面掌控 TaxHacker 的 AI 如何处理您的文档。为字段、分类和项目编写自定义的 AI 提示词，或修改内置提示词以满足您的特定需求。

• 可定制的系统提示词：在设置中调整通用提示模板，以适应您的业务需求。
• 针对字段或项目的提示词：为行业特定的文档创建自定义提取规则。
• 完全可控：调整字段提取优先级和命名规范，以匹配您的工作流程。
• 行业优化：微调 AI，使其更好地理解您特定类型的商业文档。
• 完全透明：AI 提取过程的每个环节都由您掌控，可在设置中随时更改。

TaxHacker 可以 100% 适应并调整至您的独特要求——无论您需要从文档中提取电子邮件、地址、项目代码，还是其他自定义信息。

6 灵活的数据筛选与导出

文档处理完成后，您可以轻松查看、筛选和导出完整的交易记录，完全按照您的需求进行操作。

• 高级筛选：按日期范围、分类、项目、金额以及任何自定义字段进行筛选。
• 灵活导出：将筛选后的交易导出为 CSV 格式，并附带所有相关文档。
• 税务报告：为您的会计师或税务顾问生成全面的报告。
• 数据可移植性：下载完整数据档案，以便迁移到其他服务——您的数据始终归您所有。

7 自托管模式，保障数据隐私

通过本地存储和自托管选项，您可以完全掌控自己的财务数据。TaxHacker 尊重您的隐私，并让您对信息拥有完全的所有权。

• 家庭服务器就绪：在您自己的基础设施上托管，以获得最大的隐私和控制权
• 原生支持 Docker：使用提供的 Docker 容器和 Compose 文件，轻松完成部署
• 数据所有权：您的财务文档始终处于您的控制之下
• 无供应商锁定：随时导出所有数据并迁移
• 透明运营：完全开放源代码，运营过程完全透明

🛳 部署与自托管

TaxHacker 可以轻松地在您自己的基础设施上自托管，从而完全掌控您的数据和应用环境。我们提供一个 Docker 镜像 和 Docker Compose 配置，使部署变得简单：

curl -O https://raw.githubusercontent.com/vas3k/TaxHacker/main/docker-compose.yml

docker compose up

Docker Compose 配置包括：

• TaxHacker 应用容器
• PostgreSQL 17+ 数据库（或连接到您现有的数据库）
• 启动时自动进行数据库迁移
• 用于持久化数据存储的卷挂载
• 生产就绪的配置

每次发布新版本时，都会自动构建并发布新的 Docker 镜像。您可以使用特定的版本标签（例如 v1.0.0）或 latest 来获取最新版本。

对于高级设置，您可以根据自己的基础设施自定义 Docker Compose 配置。默认配置使用 GitHub Container Registry 中预构建的镜像，但您也可以使用提供的 Dockerfile 在本地构建镜像。

自定义配置示例：

services:
  app:
    image: ghcr.io/vas3k/taxhacker:latest
    ports:
      - "7331:7331"
    environment:
      - SELF_HOSTED_MODE=true
      - UPLOAD_PATH=/app/data/uploads
      - DATABASE_URL=postgresql://postgres:postgres@localhost:5432/taxhacker
    volumes:
      - ./data:/app/data
    restart: unless-stopped

环境变量

使用以下环境变量为 TaxHacker 进行个性化配置：

变量	必需	描述	示例
UPLOAD_PATH	是	文件上传和存储的本地目录	./data/uploads
DATABASE_URL	是	PostgreSQL 连接字符串	postgresql://user@localhost:5432/taxhacker
PORT	否	应用程序运行的端口	7331（默认）
BASE_URL	否	应用程序的基础 URL	http://localhost:7331
SELF_HOSTED_MODE	否	设置为“true”以启用自托管：开启自动登录、自定义 API 密钥及其他功能	true
DISABLE_SIGNUP	否	禁用您实例上的新用户注册	false
BETTER_AUTH_SECRET	是	身份验证的密钥（至少 16 个字符）	your-secure-random-key

⌨️ 本地开发

我们使用：

• Next.js 15+ 作为前端和 API
• Prisma 用于数据库模型和迁移
• PostgreSQL 作为数据库（推荐使用 PostgreSQL 17+）
• Ghostscript 和 GraphicsMagick 用于 PDF 处理（在 macOS 上可通过 brew install gs graphicsmagick 安装）

设置您的本地开发环境：

# 克隆仓库
git clone https://github.com/vas3k/TaxHacker.git
cd TaxHacker

# 安装依赖
npm install

# 设置环境变量
cp .env.example .env

# 编辑 .env 文件以进行配置
# 确保将 DATABASE_URL 设置为您自己的 PostgreSQL 连接字符串
# 例如：postgresql://user@localhost:5432/taxhacker

# 初始化数据库
npx prisma generate && npx prisma migrate dev

# 启动开发服务器
npm run dev

访问 http://localhost:7331 即可查看您本地的 TaxHacker 实例。

若要进行生产构建，请不要使用 npm run dev，而是执行以下命令：

# 构建应用程序
npm run build

# 启动生产服务器
npm run start

🤝 贡献

请勿提交由 AI 生成的 PR。在发送新更改之前，请先打开一个新的 Issue，并与维护者讨论细节。

❤️ 支持项目

如果 TaxHacker 帮助您节省了时间或更好地管理了财务，欢迎您支持它的开发！您的捐赠将帮助我们维护项目、添加新功能，并保持其免费和开源。每一份贡献都有助于我们持续改进和维护这款面向社区的工具： https://vas3k.com/donate/

📄 许可证

TaxHacker 根据 MIT 许可证 授权。

TaxHacker 快速上手指南

TaxHacker 是一款可自托管的 AI 会计工具，专为自由职业者、独立开发者和小型企业设计。它能通过 AI 自动识别收据、发票和 PDF 中的关键信息（如日期、金额、商户、税费等），并支持多币种（含加密货币）自动换算，将数据整理为结构化的表格。

环境准备

系统要求

• 操作系统: Linux, macOS, Windows (需安装 Docker)
• 内存: 建议至少 2GB RAM (若使用本地大模型需更多)
• 磁盘空间: 根据存储需求而定，建议预留足够空间存放上传文件和数据库

前置依赖

推荐使用 Docker 和 Docker Compose 进行部署，这是最简便的方式。

• Docker Engine 20.10+
• Docker Compose v2.0+

若选择本地开发模式，需准备：

• Node.js 18+ & npm
• PostgreSQL 17+
• Ghostscript 和 GraphicsMagick (用于 PDF 处理)
  • macOS: brew install gs graphicsmagick
  • Ubuntu/Debian: sudo apt-get install ghostscript graphicsmagick

安装步骤

方式一：Docker 部署（推荐）

这是最快且最适合生产环境的方式。

1. 下载配置文件 获取官方提供的 docker-compose.yml 文件：

   curl -O https://raw.githubusercontent.com/vas3k/TaxHacker/main/docker-compose.yml
   

2. 配置环境变量 为了安全运行，你需要设置认证密钥。创建或编辑 .env 文件（在同一目录下）：

   echo "BETTER_AUTH_SECRET=$(openssl rand -hex 32)" > .env
   echo "SELF_HOSTED_MODE=true" >> .env
   # 可选：自定义端口或数据库连接
   

   注意：BETTER_AUTH_SECRET 必须是至少 16 个字符的随机字符串。

3. 启动服务 运行以下命令启动应用和数据库：

   docker compose up -d
   

4. 访问应用 打开浏览器访问 http://localhost:7331。首次启动时会自动初始化数据库。

方式二：本地开发部署

如果你需要修改源码或调试：

1. 克隆项目

   git clone https://github.com/vas3k/TaxHacker.git
   cd TaxHacker
   

2. 安装依赖

   npm install
   

3. 配置环境变量 复制示例配置并编辑：

   cp .env.example .env
   

   在 .env 中确保设置正确的 DATABASE_URL (指向你的 PostgreSQL) 和 BETTER_AUTH_SECRET。

4. 初始化数据库

   npx prisma generate && npx prisma migrate dev
   

5. 启动开发服务器

   npm run dev
   

   访问 http://localhost:7331。

基本使用

1. 初始设置与 LLM 配置

登录后，进入设置页面配置 AI 模型。TaxHacker 支持多种后端：

• 云服务: OpenAI, Google Gemini, Mistral。填入对应的 API Key 即可。
• 本地模型: 如果你运行了 Ollama、LM Studio 或 LocalAI，在设置中将 API 端点指向本地地址（如 http://host.docker.internal:11434），并确保所选模型具备较强的 OCR 和理解能力。

2. 上传票据

• 点击 "Upload" 按钮，直接拖入收据照片、发票 PDF 或银行对账单。
• 文件会暂时存储在 "Unsorted"（未分类）区域。

3. AI 自动处理

• 选中上传的文件，点击 "Process with AI"。
• 系统将自动提取：交易日期、金额、商户名称、税费、具体商品明细等。
• 多币种支持: 如果票据是外币（包括比特币等加密货币），系统会根据交易发生日的历史汇率自动转换为你设定的基础货币。

4. 自定义字段与分类

• 你可以创建自定义项目（Projects）和分类（Categories）。
• 高级用法: 在设置中编写自定义 Prompt，让 AI 提取特定信息（如“项目编号”、“客户邮箱”），这些内容会作为新列出现在数据表中。

5. 导出报表

• 使用筛选功能（按日期、类别、金额等）找到所需数据。
• 点击 "Export"，可将筛选后的交易记录连同原始附件打包下载为 CSV 格式，直接用于报税或导入 Excel。

提示: 由于项目处于早期开发阶段，建议在正式用于重要财务数据前，先人工核对 AI 提取的关键金额和日期。