DeepLedger

DeepLedger

QuickBooks AI 会计人员

DeepLedger 将 QuickBooks 连接到 Grok、ChatGPT、Claude 和其他 AI Agent，让企业能够使用自然语言记录账单、发票、付款、存款、日记账分录及其他交易，运行财务报告，管理应收款和应付款，并跟踪月末结账进度。

此代码库将 DeepLedger 打包为 Claude Code、Cursor、Grok Build 和 Grok Bot 的插件。安装后，使用 DeepLedger 账户登录，即可用日常语言提出记账需求。Agent 会像会计人员一样操作你的 QuickBooks 公司：查找收款方、检查重复项、选择正确的交易类型并记录交易；对于不确定的事项，它会交由人工审核，而不是猜测。

QuickBooks Online 始终是正式账簿。DeepLedger 保存贵公司通过 Intuit 自有 OAuth 流程授权的 QuickBooks 连接，因此插件永远不会接触 Intuit 凭据。登录一次，即可访问你在 DeepLedger 门户中能打开的所有公司。

适用对象

• 小企业主和创始人：自行使用 QuickBooks Online 记账，并希望由工具代为处理日常分录、分类和报告。
• 簿记员和 CPA 事务所：管理多家客户公司。一个连接即可切换不同公司，每次写入都遵循同一协议，不确定的事项会连同 Agent 的推理一起进入审核队列。
• 财务团队：希望先拟好月末结账、对账准备和管理报告供审核，而不必从头开始制作。

功能

领域	Agent 的操作
银行流水	获取尚未记录的银行和信用卡交易，根据收款方在 QuickBooks 中的历史记录进行分类，记录明确的交易，并为其余交易创建审核任务
记录交易	记录付款、账单、发票、客户付款、存款、转账、退款、贷项和日记账分录；每次写入前都会查询 ID 并检查重复项
应付款和应收款	输入账单并使用未结余额进行付款，向客户开具发票并应用其付款，应用贷项，报告账龄
对账	将银行或信用卡对账单与账簿匹配，并准备对账工作簿和未结项目
月末结账	按结账清单执行，拟定调整分录和结账表，并将资料包交由审核人员签字确认
报告与分析	运行损益表、资产负债表、账龄和自定义报告，对比各个期间并说明变动情况
审计准备	编制支持性明细表、证据索引和缺失文件清单
记忆	保存每家公司持久的知识（政策、重复模式、背景信息），并在后续操作中应用审核人员的更正
人工审核	任何不确定的事项都会成为任务，并附上 Agent 的推理；审核人员的决定会原样应用

使用方法

1. 连接 QuickBooks：访问 deepledger.ai，依次打开 Settings、QuickBooks、Connect。对你管理的每家公司重复此操作。

2. 安装插件：在你的宿主中安装插件（见下文），并在浏览器打开后登录。

3. 用日常语言提出需求。 bookkeeping 技能会在任何会计请求中激活：

   Which QuickBooks company is active?
   Process the bank feed.
   Record: paid $500 to Office Depot for office supplies with the company credit card.
   Enter the Acme invoice for $2,400, net 30.
   Reconcile the operating account against the August statement.
   Generate a P&L for last month and compare it to the prior month.
   Close the books for June.
   

4. 审核升级处理的事项。 在 DeepLedger 门户中打开 Tasks，批准、重新分类或驳回 Agent 无法确定的项目。已批准的任务会在下一次运行时记录。

插件本身很轻量：它包含一个连接 DeepLedger 托管 MCP 服务的连接器和一项技能。该技能不包含操作流程；它会告诉 Agent 针对每类请求从服务端的 getGuide 工具获取相应流程，因此记账指导可以在服务端更新，无需发布插件新版本。插件没有斜杠命令、Agent、钩子或脚本。

前置条件

• 拥有一个 DeepLedger 账户，并已在 deepledger.ai 连接至少一家 QuickBooks Online 公司（Settings，QuickBooks，Connect）
• 以下主机之一

安装

Marketplace 是否提供取决于各 Marketplace 的审核进度。在列表上线之前，请使用对应主机的本地安装方式。

Claude Code

claude plugin marketplace add DeepLedger/deepledger-plugin
claude plugin install deepledger@deepledger-marketplace

本地开发：claude --plugin-dir ./deepledger-plugin。

Cursor

依次选择 Customize、Marketplace，搜索 DeepLedger，然后选择 Add。本地安装：克隆此仓库，并将其符号链接到 Cursor 的本地插件文件夹，然后重新加载 Cursor。

git clone https://github.com/DeepLedger/deepledger-plugin.git
mkdir -p ~/.cursor/plugins/local
ln -s "$(pwd)/deepledger-plugin" ~/.cursor/plugins/local/deepledger

Grok Build

DeepLedger 已作为远程来源列入 xAI 插件 Marketplace，并固定到此仓库的某个提交版本。在 Grok Build 中，使用 /plugins 打开扩展模态框（或使用 /marketplace 浏览），选择 DeepLedger 并安装。Grok Build 会直接读取 .grok-plugin/plugin.json 清单、技能和 .mcp.json。启用并信任该插件，以便 Grok 连接内置的 MCP 服务；首次调用 DeepLedger 工具时会打开浏览器登录页面，使用 /mcps 可查看连接状态。

如需在 Marketplace 审核通过前测试，请直接从 GitHub 安装固定版本：

grok plugin install DeepLedger/deepledger-plugin@<full-commit-sha> --trust

本地开发：grok --plugin-dir ./deepledger-plugin。

Grok Bot

依次选择 Settings、Plugins，搜索 DeepLedger 并选择 Add，然后在浏览器中完成登录。使用 @ 将插件附加到任务，并在请求会计工作前询问当前启用的是哪家 QuickBooks 公司。

登录

首次使用时，主机会发现服务的 OAuth 2.1 端点（使用 PKCE 的授权码流程、动态客户端注册），并打开浏览器登录页面。使用 DeepLedger 账户登录后，即可授权连接。对于程序化客户端，也接受 DeepLedger 个人 API 密钥（dl_live_...）作为 Bearer 令牌。传输方式为 Streamable HTTP，地址是 https://mcp.deepledger.ai/mcp。

网络访问和凭据

该插件不包含脚本、二进制文件、钩子或 shell 命令。所有操作都通过托管的 MCP 服务完成。唯一的运行时例外是下方的附件上传：服务会返回经过 shell 引号处理的 curl 命令，供 Agent 执行。插件访问的网络端点仅有：

端点	用途
https://mcp.deepledger.ai/mcp	MCP 服务（Streamable HTTP）。用于所有 QuickBooks 读取和写入操作，以及指南、任务、记忆、文档和报告。
https://mcp.deepledger.ai/.well-known/oauth-authorization-server、/oauth/register、/oauth/authorize、/oauth/token、/oauth/revoke	OAuth 2.1 发现、动态客户端注册、使用 PKCE 的授权码流程、令牌刷新和撤销。
https://deepledger.ai	授权期间由主机打开的浏览器登录页面。
https://mcp.deepledger.ai/upload-to-qb	文件附件上传。documents（操作 upload）会返回一条 curl 命令，供 Agent 将用户选择的单个本地文件（上限为 10 MB）连同一次性令牌发送到此路径；服务随后会将文件转发到 QuickBooks。此操作不会下载或执行任何内容。

凭据：DeepLedger 账户（在浏览器中进行 OAuth 登录，权限范围为 quickbooks）。主机会存储生成的令牌；插件不会查看、存储或传输 Intuit 凭据，也不会读取本地文件、环境变量或机密信息。QuickBooks 访问权限仅限于已登录用户在 DeepLedger 门户中可打开的公司。

技能的工作方式

bookkeeping 技能会在任何会计请求中激活。它会确认当前启用的 QuickBooks 公司，然后调用服务器的 getGuide 工具，并根据请求选择匹配的指南类型，再按照返回的步骤、安全检查清单和常见错误进行操作：

请求	getGuide 类型
记录付款、账单、发票、客户付款、退款、贷项、存款、转账或日记账分录；为银行流水项目分类；应付账款和应收账款写入	transaction_recording
月末结账、调整分录、结账表	month_end_closing
对账单、解释对账差异	reconciliation
报告对比、比率、趋势、预算差异	financial_analysis
审计或审查支持、证据索引、缺失文件	audit_preparation
Agent 无法根据响应解决的工具故障	error_recovery（按工具和错误代码）

主数据、Agent 记忆、审查任务、文档和自定义报告遵循各自的工具说明；任何 QuickBooks 写入操作仍须遵循 transaction_recording 协议。

连接器提供的功能

.mcp.json 连接器指向 DeepLedger 官方托管的 MCP 服务。它不会安装本地二进制文件。该服务提供 26 个工具；每个工具都针对当前启用的 QuickBooks 公司操作，并会在结果中注明公司名称。

工具	功能
qbCompanyProfile	显示、列出或切换当前启用的 QuickBooks 公司
qbMasterData	查找、创建或更新账户、供应商、客户、项目、类别和税码
qbFetchTransactions	获取交易记录，用于重复项检查、收款人历史记录以及未结账单或发票查询
qbExpense	记录或更新即时付款的采购（银行卡、ACH、支票、现金）
qbBill	记录或更新待付款的供应商账单
qbPayment	将客户付款应用于未结发票，或在应用供应商贷项的同时支付未结账单
qbInvoice	创建或更新客户发票
qbSalesReceipt	记录即时付款的销售，或为客户退款
qbDeposit	记录银行存款，将暂存的付款合并处理，或记录直接收入项目
qbTransfer	在公司自有账户之间转移资金
qbCredit	记录供应商或客户贷项
qbJournalEntry	记录平衡的日记账分录
qbEstimate	创建、更新或转换估算单
qbRecurringTransaction	管理定期交易模板
qbProject	列出、创建、更新和关闭 QuickBooks 项目
qbCustomization	管理自定义字段定义和交易维度
qbVoidTransaction	作废发票、销售收据、退款收据、付款或账单付款
qbSendEmail	通过 QuickBooks 向客户发送销售单据
qbReports	运行损益表、资产负债表、账龄分析及其他 QuickBooks 报告
getGuide	加载当前记账流程或按工具划分的错误处理指南
tasks	审查 Agent 与人工审查者共享的任务
agentMemory	读取和维护按公司保存的持久知识
bankFeed	获取尚未记录的银行交易，并在记录后为其添加标记
documents	读取 DeepLedger 存储或 QuickBooks 附件中的文档，并将文件上传到 QuickBooks 记录
customReports	按名称运行已保存的报告定义
closeRun	跟踪月末结账及其结账表

安全模型

每次 QuickBooks 写入都遵循服务端协议，该协议由 transaction_recording 指南和工具说明承载：

1. 查找：qbMasterData 会解析供应商、客户和账户 ID。
2. 重复检查：qbFetchTransactions 会确认不存在重复记录。
3. 判断：当证据足以明确收款方、类别、工具和金额，且 Agent 有把握时，Agent 会记录交易；只有在确实存在不确定因素时，才会创建包含具体理由的审核任务。审核者对任务作出的决定会原样应用。

正确性保护不会因信心而让步：未结账单或发票决定应使用的工具；日记账分录必须平衡；作废前必须先获取并核实；没有批量工具：每笔交易都单独记录，确保每次写入都经过完整协议。供应商和客户的分类会在判断时根据 QuickBooks 历史记录推断，而非从已存储的映射中读取，因此在 QuickBooks 中重新分类后，会在下一笔交易中生效。

架构

Plugin (this repo)
  skills/bookkeeping/SKILL.md  One skill: confirm company, pull the matching getGuide procedure, verify
  .grok-plugin/plugin.json     Grok Build manifest
  .claude-plugin/plugin.json   Claude Code manifest
  .mcp.json                    MCP connector for Claude Code and Grok Build
  .cursor-plugin/plugin.json   Cursor and Grok Bot manifest
  mcp.json                     MCP connector for Cursor
    | Streamable HTTP + OAuth 2.1
MCP server (hosted at https://mcp.deepledger.ai/mcp)
  26 tools (19 QuickBooks + 7 platform)
  getGuide procedures, tasks, memory, documents, bank feed, custom reports, close runs

连接 QuickBooks

1. 登录 deepledger.ai
2. 打开 Settings，QuickBooks
3. 点击 Connect QuickBooks 并授权访问
4. 连接后，插件即可读取和写入该公司的数据

数据处理与支持

• DeepLedger 和 QuickBooks 返回的数据会在您的宿主会话中处理，并受 DeepLedger Terms 和 Privacy Policy 约束。
• 写入会进入实时 QuickBooks Online 公司。在批准任何重要操作前，请审核 Agent 提议的交易；作废操作无法撤销。
• 支持：[email protected]。插件问题：GitHub issues。

版本与许可证

请参阅 CHANGELOG.md 查看发布历史。MIT License，详见 LICENSE。