paperless-ai

机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

📄 无纸化-AI

⚠️ 重要通知：

这个仓库目前没有维护。我感谢社区中所有提交PR和创建问题的努力。我目前正在用更稳定、最新的架构重写整个代码库。但我只能在晚上进行操作，同时在这里提供支持并进行重写对我来说是不现实的。随着即将到来的Paperless-ngx官方AI集成，我也不确定我是否会完成重写，或者是否会继续维护这个仓库。

Paperless-AI 是一个针对 Paperless-ngx 的 AI 驱动扩展，能够使用兼容 OpenAI 的 API 和 Ollama 提供自动文档分类、智能标签和语义搜索。

它实现了 完全自动化的文档工作流程、上下文聊天 和 强大的定制功能——所有这些都通过直观的网页界面进行。

💡 只需问：
“我什么时候签的租赁合同？”
“上次电费账单金额是多少？”
“哪些文档提到了我的健康保险？”

由 增强检索生成（Retrieval-Augmented Generation, RAG） 提供支持，现在你可以在整个档案中进行语义搜索，并获得精准的自然语言回答。

✨ 功能

🔄 自动文档处理

• 在 Paperless-ngx 中自动检测新文档
• 使用 OpenAI API、Ollama 及其他兼容后端分析内容
• 分配标题、标签、文档类型和往来人员
• 内置支持：
  • Ollama (Mistral, Llama, Phi-3, Gemma-2)
  • OpenAI
  • DeepSeek.ai
  • OpenRouter.ai
  • Perplexity.ai
  • Together.ai
  • LiteLLM
  • VLLM
  • Fastchat
  • Gemini（谷歌）
  • ...以及更多！

🧠 基于 RAG 的 AI 聊天

• 自然语言文档搜索与问答
• 理解完整文档语境（不仅仅是关键词）
• 由您自己的数据驱动的语义记忆
• 快速、智能、保护隐私的文档查询

⚙️ 手动处理

• 用于手动 AI 标记的 Web 界面
• 在审核敏感文档时非常有用
• Accessible via /manual

🧩 智能标记与规则

• 定义规则以限制处理的文档
• 禁用提示并自动应用标签
• 为跟踪分类设置自定义输出标签

🚀 安装

⚠️ 首次安装： 在完成设置（API 密钥、偏好设置）后 重启容器 以构建 RAG 索引。
🔁 更新时不需要。

📘 Installation Wiki

🐳 Docker 支持

• 健康监控和自动重启
• 持久卷和优雅关闭
• 开箱即用，设置最少

🔧 本地开发

# Install dependencies
npm install

# Start development/test mode
npm run test

🧭 路线图亮点

• ✅ 多AI模型支持
• ✅ 多语言文档分析
• ✅ 标签规则和过滤器
• ✅ 带RAG的集成文档聊天
• ✅ 响应式网页界面

🤝 贡献

我们欢迎PR和贡献！

# Fork, clone, then:
git checkout -b feature/YourFeature
# After changes:
git commit -m "Add YourFeature"
git push origin feature/YourFeature

然后通过 GitHub 提交一个拉取请求。

🆘 支持与社区

• Issues
• Discord

📄 许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE。

🙏 支持开发