Well

Well App AI——共同打造称霸国际发票基础设施的工具

不必再浪费时间查找发票，AI 可以代劳。

---

目录

• 概览
• 功能与优势
• 使用场景
• 工作原理
• 安装
• MCP 集成
• 参与贡献
• 许可证
• 致谢
• 路线图
• 常见问题

---

概览

Well 是一款 Chrome 扩展程序，每逢会计季，都会成为每位创始人的得力助手。

它可以自动获取供应商发票，并将数据直接导入会计工具、ERP 或仪表板，全程无需费力操作。

Well 专为创始人、独立经营者和精简团队打造，能取代数小时重复的点击、拖拽、追踪和复制粘贴操作。过去每逢税季都要花上几天的工作，如今只需点击一次。

Well 的核心是一款 Chrome 扩展程序，可代你自动执行浏览器工作流，在批量获取发票时提升效率。你也可以随时随地使用它：浏览网页时，Well 会帮你捕获发票。

功能包括：

• WhatsApp 和电子邮件接入
• Google Drive 和 Slack 集成
• AI 生成的工作流蓝图
• 可随变化自适应的自愈自动化
• 支持多种格式导出（JSON、CSV、XML、UBL、QuickBooks、Xero）
• 内置验证功能，确保发票数据完整性
• 可扩展的插件系统，支持自定义格式
• 兼容 Factur-X 和 UBL 2.1 等电子发票标准

我们相信，发票交换应遵循通用协议：即时、标准化且自动化。你不该为此操心。使用 Well 后，你就不必操心了。

---

功能与优势

• 覆盖 100,000 多个 Web 门户
  涵盖使用最广泛的 SaaS、公用事业和电子商务平台，以及那些你以为无人能自动化的长尾门户。

• 全渠道采集
  实时收集来自 Gmail、WhatsApp、PDF 等渠道的发票。

• 适配你的技术栈
  无需额外设置，即可与会计工具、ERP、CRM 和电子表格无缝连接。

• 自愈工作流
  供应商界面发生变化时，Well 会即时自适应。

• 以隐私为先
  不存储密码。完全符合 GDPR 和 CCPA。

• 导出格式 Well 支持将发票数据导出为多种格式：

  格式	说明	适用场景
  JSON	标准 JSON 格式	API、Web 应用
  CSV	逗号分隔值	电子表格、数据分析
  XML	标准 XML 格式	企业系统
  UBL	Universal Business Language 2.1	国际电子发票
  QuickBooks	IIF 格式	QuickBooks Desktop
  Xero	兼容 Xero 的 CSV	Xero 会计软件

• 数据验证

  • 自动验证必填字段
  • 检查金额和日期的数据类型
  • 可扩展的验证规则
  • 针对数据问题提供清晰的错误消息

---

使用场景

• 忙碌在路上的创始人
  一键即可轻松完成——Well 从电子邮件、浏览器或 WhatsApp 中检索发票。

• 为月底结账做准备的运营人员
  不费心力，在不到 5 分钟内从 15+ 个门户网站提取 50+ 张发票。

• 践行 5S 理念的财务负责人
  从源头落实整理、整顿、维持，并实现自动化。

• 跟踪团队预算的经理
  实时监控供应商支出，及时发现预算偏差并挖掘节省空间。

• 整理清晰审计轨迹的会计师
  使用完整、标准化的记录，为报税时的费用提供凭据。

---

工作原理

基本用法

from exporters import get_exporter

# Get an exporter instance
exporter = get_exporter('json')  # or 'csv', 'xml', 'ubl', 'quickbooks', 'xero'

# Export data
data = {
    'invoice_number': 'INV-1234',
    'date': '2025-07-29',
    'amount': 199.99,
    'customer': 'Acme Corp',
    # ... other fields
}

exporter.export(data, 'invoice.json')

必填字段

所有发票都必须包含以下必填字段：

• invoice_number（str）：发票的唯一标识符
• date（str）：发票日期，格式为 YYYY-MM-DD
• amount（float）：发票总金额（必须为正数）
• customer（str）：客户名称

1. 浏览我们的服务商图库
   访问 wellapp.ai/providers，探索数千个受支持的门户网站。

2. 启动 Chrome 扩展程序
   安装并固定扩展程序。点击一次即可启动发票检索。

3. 浏览时自动检测发票
   Well 发现已付款的发票时，会通过 AI 建议检索。

4. 报税季批量检索
   只需点击几次即可执行大规模检索。

5. 使用 AI 生成新蓝图
   使用 Contributor Mode，无需编写代码即可教会 Well 新的工作流。

6. 让它自动修复
   门户网站发生变化时，Well 会自动适应，无需手动修复。

---

安装

1. 从 Chrome 网上应用店安装。
2. 将扩展程序固定到工具栏。
3. 登录以开始与会计工具同步。

---

MCP 集成

使用 Model Context Protocol（MCP） 将 AI 助手连接到 Well。

直接从 Claude、Cursor、Windsurf 或 ChatGPT 查询发票、公司和联系人。

Claude Code 插件（一键安装）

在 Claude Code 中使用 Well 的最快方式——同时打包 MCP 和 财务技能（生成损益表、资产负债表、对账），无需 API 密钥：

/plugin marketplace add WellApp-ai/Well
/plugin install well@well

然后运行 /mcp，选择 well 并进行 Authenticate（通过浏览器登录）。每条命令单独占一行运行。

快速入门（适用于任何 MCP 客户端）

https://api.wellapp.ai/v1/mcp

将此 URL 添加到 MCP 客户端，并使用 Well 账户进行身份验证。在 Claude Desktop / web 中：Settings → Connectors → Add custom connector。在 Codex 中：通过 mcp-remote 将其添加到 ~/.codex/config.toml。

文档

• MCP 概览
• 快速入门指南
• 客户端设置 - Claude、Cursor、Windsurf、VS Code
• 工具参考
• 故障排除

可用工具

工具	描述
well_get_schema	查找可用的根节点和字段
well_query_records	查询发票、公司、人员、交易、会计分类账等
well_get_entity	按 ID 获取单条记录
well_add_contact_channel	为公司或人员添加电子邮件/电话
well_remove_contact_channel	移除联系人渠道
well_update_invoice	更新发票字段
well_delete_invoice	删除发票

完整文档请访问 docs.wellapp.ai/mcp

---

扩展 Well

添加新的导出格式

1. 在 exporters 目录中创建新的 Python 文件
2. 创建一个继承自 BaseExporter 的类
3. 实现 _export 方法
4. 添加 @ExporterFactory.register() 装饰器

示例：

from .base_exporter import BaseExporter
from .exporter_factory import ExporterFactory

@ExporterFactory.register("myformat")
class MyFormatExporter(BaseExporter):
    """Exports invoice data to MyFormat."""
    
    def _export(self, data: dict, output_path: str) -> None:
        with open(output_path, 'w') as f:
            f.write(f"MyFormat: {data['invoice_number']}")

贡献

我们欢迎社区贡献。若要提出修复、功能或改进建议：

• 发起拉取请求
• 提交问题
• 或通过 Contributor Mode 贡献新的蓝图

请阅读我们的 CONTRIBUTING.md 和 行为准则。

---

许可证

本项目根据 MIT 许可证发布。更多信息请参阅 LICENSE。

---

致谢

感谢所有帮助完善 Well 的贡献者和早期用户。特别感谢让这一切成为可能的开源库和协议。

---

路线图

• 启动公开测试版
• 将支持范围扩展至 200K+ 个门户
• 添加移动端检索助手
• 支持 Zapier 和 Make 集成
• 建立贡献者排行榜

---

常见问题

Q：Well 能保障我的数据安全吗？
A：可以。我们不存储密码，遵循严格的加密标准，并符合 GDPR 和 CCPA。

Q：我可以在 Chrome 以外使用 Well 吗？
A：目前，Well 以 Chrome 扩展程序的形式提供。未来可能会支持其他浏览器。

Q：如何添加新门户？
A：使用 Contributor Mode 引导 AI 完成你的工作流。系统会立即生成蓝图。