关于 ComplyEaze Bridge
ComplyEaze Bridge 是面向会计师和 CA 事务所的开源 MCP 服务,可连接本机 TallyPrime,读取账簿并分析报表。它还可从四家印度银行的加密 PDF 对账单生成待审核的凭证导入文件;默认不向 TallyPrime 过账。
主要功能
- 01读取试算平衡表及往来款账龄
- 02查看分类账变动和交易凭证
- 03查询损益表、资产负债表及库存摘要
- 04解析四家印度银行的加密 PDF 对账单
- 05生成需人工审核的凭证导入文件
适用场景
- 01检查客户的应收应付及账龄
- 02按日期范围查看试算平衡表和分类账变动
- 03将银行对账单整理为 TallyPrime 凭证导入文件
MCP 相关
作为 MCP 服务连接 Claude Desktop 与本机 TallyPrime,向 MCP 客户端提供账簿查询、报表读取和凭证文件生成工具。默认只读取并准备本地文件;启用过账后,每次过账仍需批准。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
ComplyEaze Bridge:适用于 Claude Desktop 的 TallyPrime MCP 服务
ComplyEaze Bridge 是一个开源(Apache-2.0)MCP 服务,可将 Claude Desktop 连接到运行在你自己电脑上的 TallyPrime(也写作 Tally Prime)。 它专为特许会计师、CA 事务所和会计人员打造。它会读取你的账簿;对于受密码保护的 SBI、HDFC、Union Bank of India 或 Bank of Baroda 银行对账单 PDF,它会提出付款、收款和对转凭证;待所有 账簿名称完全匹配且所有问题都已回答后,它会将凭证写入文件, 由你自行导入 TallyPrime。Claude 从你的账簿中读取的内容会作为聊天的一部分发送给你的 AI 服务提供商。你可以询问试算平衡表、应收和 应付未结款项及账龄、分类账变动和凭证、采购和销售登记簿、库存汇总,以及损益表和资产负债表(仅当 Tally 自己的期末库存补齐所有差额时,才会读取包含库存项目的账簿)。它会在你过账前检查分类账 名称,并将日记账、付款、收款和对转凭证整理为导入文件,由你自行检查并导入 TallyPrime。新安装时默认关闭过账功能,因此安装后它绝不会向 TallyPrime 过账:它只会从中读取数据,并在你的电脑上准备文件。如果你在扩展程序中启用 过账功能,它会一次过账一张凭证,或过账一个已保存的批次(最多 50 张),且每次过账前都需要你批准。
Tally Solutions 也为 Claude Desktop 提供了自己的 TallyPrime MCP 插件; 其帮助页面(最后更新于 2026 年 9 月 18 日)列出了六组工具: 公司、主数据、会计、库存、未结款项和交易。ComplyEaze Bridge 并非由 Tally Solutions 制作,也与其没有关联;我们也没有将两者并排运行过。TallyPrime 还提供自己的银行对账单导入功能,可导入 Tally 为各家银行列出的格式的对账单文件。
当前版本: mcp-v0.6.1(2026 年 10 月 27 日),
适用于 Windows x64 和 Apple Silicon Mac,作为 Claude Desktop 扩展(.mcpb
文件)提供;尚未在其他 MCP 客户端中运行过。每次发布前,我们都会检查该版本:发布检查会确认每个软件包均可启动、能列出其
工具,并能解析模拟的加密银行对账单。它不会连接 TallyPrime 运行,且我们能执行的测试无法覆盖每个
Tally 版本、账簿或设置。下文列出了哪些情况已经在真实的
TallyPrime 上运行过,哪些尚未运行。
安装指南 · 更改内容 ·
安全与隐私 ·
如何将 Claude 连接到 TallyPrime ·
如何安全地选择 TallyPrime MCP 服务
尚未进行代码签名;打开前,电脑可能会发出警告。
获取:下载页面
提供适用于你电脑的文件;请按安装指南所述,将其与对应的 .sha256 文件进行比对。ComplyEaze Bridge 不会自行
更新,请前往发布页面查看是否有更新版本。
可以尝试这样提问(先使用测试公司):
- “列出已加载的公司。”
- “显示截至 3 月 31 日的应收和应付未结款项及账龄。”
- “显示 4 月 1 日至 3 月 31 日的试算平衡表。”
- “过账前,请根据账簿核对这些分类账名称:……”
一览:版本 0.6.1。
- 可以查询:有账龄的应收款和应付款、试算平衡表、指定日期范围内的凭证(可按编号、参考信息、摘要或金额查找,也可按分类账、月份、凭证类型、组或主组汇总;仅在一本合成账簿上测试,未在大型账簿上测试)、Tally 自带的整月现金流(仅在其净额与试算平衡表相符时显示;不是 AS 3 下的现金流量表;已在两本合成账簿上测试)、一个分类账的变动、Tally 自带的整月按月销售或采购登记簿(不与凭证核对;已在一本合成账簿上读取)、指定时间段内 Tally 自带的负库存和负分类账列表(列出某项不代表发现了问题;仅使用合成账簿),以及 Tally 在其 GSTR-1 中标记为 Uncertain 的某一类型凭证(销售类型,已在一本合成账簿上评估)。
- 部分支持:损益表和资产负债表(只有在 Tally 自带的期末库存补齐所有差额时,才会读取含库存项目的账簿;已在一本合成账簿上评估;含多种货币的账簿会被拒绝);截至 3 月 31 日的期末库存价值,以及小型账簿中 Tally 自带的库存汇总表将项目单独列示时的期末数量;目前仅检查了截至 2026 年 3 月 31 日的会计年度;以及从受密码保护的 SBI、HDFC、Union Bank of India 或 Bank of Baroda PDF 银行对账单生成的 Payment、Receipt 和 Contra 凭证文件,由你自行检查并导入 Tally。它不会创建分类账,无法将凭证记入 Cash-in-Hand 分类账,且尚未在真实银行对账单上运行。
- 此版本尚不支持:GST 申报表或 GSTR-2B 匹配、制作销售或采购发票或 GST 分录、税务审计标记(有一项测试,即收付款中现金占比是否超过第 44AB(a) 条限额,默认关闭,且尚未在实际运行中的 TallyPrime 上测试),以及 Tally 的 Funds Flow 和 Ratio Analysis 报表。
“可以查询”是指它已在我们实际运行测试的账簿和构建版本上作出回答;已发布的 Windows x64 0.6.1 文件中的程序(已与其 .sha256 文件核对)曾在一台 Windows 电脑上,于 2026 年 10 月 27 日对实际运行中的 TallyPrime 7.2 Silver 进行过一次只读运行。测试客户端直接启动了该程序,而非将其安装在 Claude Desktop 中(程序报告了版本 0.6.1,读取了 Tally 的状态、公司列表和一家合成公司的分类账主数据;未过账任何内容);macOS 文件尚未在 TallyPrime 上运行;我们记录的已发布 0.6.0 文件在实际运行中的 TallyPrime 上执行过一次操作:于 2026 年 10 月 16 日,在一台 Windows 电脑上向一家合成公司过账一笔 Contra,并读取了该凭证(#1780);其他 0.6.0 过账操作则是在候选发布版和演练版上运行的。超大型账簿可能会运行失败,或耗时超过助手的等待时间;含多种货币的账簿也只能部分读取。请在使用任何数据前先与 Tally 核对。问题页面列出了完整表格及其限制。
工具。 按名称排序;0.6.1 版本安装其中 32 个,默认提供 31 个(仅在启用相应设置时才会出现 audit_test_run),而 gst_by_counter_ledger 已包含在源代码中,但尚未纳入已发布的构建版本。所有工具都不会更改你的 TallyPrime 账簿;启用过账功能后,还会出现另外两个工具,说明见下表下方。每次调用都会在此电脑上的日志中添加一行回执,不含任何数据。
| 工具 | 提供的内容 | 除该回执外写入的内容 |
|---|---|---|
audit_test_run | 默认关闭(设置 允许税务审计测试运行)。针对公司自有账簿,在指定日期范围内执行一次税务审计测试运行;目前仅核算收付款中现金部分与 s.44AB(a) 限额的对比:提供数值和发现项 ID,以及对应的数值、置信度和条款,并提供任何失败账簿检查的计数;不包含分类账名称或凭证;启用脱敏设置时会拒绝运行。现金组和银行组由你指定;期间必须在 2025-26 年内。仅依据账簿,不构成税务意见 | 无 |
balance_sheet | 指定日期范围内按一级组列示的资产负债表,取自 TallyPrime 的试算平衡表(含库存项目的账簿仅在 Tally 自身的期末库存填补所有差额时才会读取) | 无 |
build_import_xml | 检查一批 Journal、Payment、Receipt 或 Contra,并写入导入文件 | 此计算机上的导入文件和分类账记录 |
cash_flow | Tally 自身按整月生成的现金流量:按月列示现金和银行分类账的变动;仅当其净总额与试算平衡表相符时才返回;按月拆分方式由 Tally 自行决定,未经检查(不是 AS 3 下的现金流量表) | 无 |
company_features | Tally 中公司记录当前保存的三项设置(成本中心、GST 和批次库存;每项为是、否或未报告),以及货币符号;不含分类账、凭证、金额或摘要。三项设置各自在三本合成账簿上与 Tally 的 F11 界面一致,但未在本公司账簿上验证;在一次操作期间更改的设置尚未测量 | 无 |
egress_log | ComplyEaze Bridge 保存的自身工具调用记录,不含数字 | 无 |
gst_by_counter_ledger | 指定期间内,账簿记录在 Duties & Taxes 下分类账中的 GST,按对方分类账汇总:采购、借项通知单、日记账或包含供应商的付款中唯一一个 Purchase Accounts、Direct Expenses、Indirect Expenses 或 Fixed Assets 分类账,按名称和 GUID 列出,借方与贷方分开,并按项目列示;其他所有含 GST 的凭证均按命名原因归类,并分别汇总。仅依据账簿,不是报税表数据或资格判定;已在一本合成账簿的 Tally 界面上对十四张凭证进行测量 | 无 |
gst_status | 指定期间(最长 93 天)内某一凭证类型的凭证在 Tally 自身 GSTR-1 中的状态标记:逐张列出凭证编号、日期、状态(included、uncertain、excluded、not in return、cancelled、optional 或 post-dated;后三种状态还会列出三项状态标记的读数),以及是否有人按原样接受了该凭证;不含金额、往来方、分类账或摘要。状态是 Tally 自身的标记,不代表 ComplyEaze Bridge 的判断。已在一本 TallyPrime 7.1 Silver 合成账簿上测量,尚未观察到 excluded 状态 | 无 |
gst_uncertain_vouchers | 指定期间(最长 93 天)内,某一凭证类型(已测量的是 Sales 类型)中被 Tally 在 GSTR-1 标记为 Uncertain 的凭证,以及有人按原样接受的凭证:逐张列出编号、日期、往来方分类账、发票总额(不含正负号,但注明借贷方向)和 Tally 的标识符;还提供 CA 申报前阅读的说明,该说明会注明涵盖的凭证类型;若未读取凭证、没有不确定凭证,或依赖的凭证无法读取,则不提供该说明。往来方和总额会返回给助手,mask_parties 仅对往来方脱敏,不处理总额。不会读取不确定原因,也不会单独列出缺少 HSN/SAC 的账单。已在一本 TallyPrime 7.1 Silver 合成账簿上,于一次 Accept As Is 操作前后进行测量;尚未测量项目发票、已注册买方、贷项通知单、外币以及同时接受多个凭证的情况 | 无 |
ledger_masters | 分类账及其期初余额;可选包含 GSTIN、PAN 和其他往来方详情 | 无 |
ledger_movement | 指定期间内某个分类账的期初、借方、贷方和期末余额 | 无 |
list_companies | TallyPrime 中已加载的公司(从此处开始) | 无 |
local_data_report | ComplyEaze Bridge 在此计算机上保存的内容 | 无 |
masters | 凭证类型、仓库、单位、库存组、库存项目、成本中心、成本类别或科目组 | 无 |
month_register | Tally 自身按整月生成的 Sales Register 或 Purchase Register:每月一行,逐字列出 Tally 打印的借方、贷方和期末列;不与凭证或试算平衡表关联,也不与 Tally 的登记簿界面进行比对 | 无 |
negative_ledgers | Tally 自身在指定时间范围内返回的 Negative Ledgers 列表,未与其他报告比对;列表为空不代表发现问题 | 无 |
negative_stock | Tally 自身在指定时间范围内返回的 Negative Stock 列表,逐项列出 Tally 打印的数量、单价和价值,未与其他报告比对;列入列表不代表发现问题,结果为空也不代表发现问题 | 无 |
outstandings | 含账龄的应收款和应付款、主要往来方及未结清账单 | 无 |
parse_bank_statement | 读取受密码保护的 SBI、HDFC、Union Bank of India 或 Bank of Baroda 对账单 PDF,并提出 Payment、Receipt 和 Contra 凭证 | 此计算机上的私人提议文件 |
profit_and_loss | 指定日期范围内按一级组列示的损益表(含库存项目的账簿仅在 Tally 自身的期末库存填补所有差额时才会读取) | 无 |
purchase_register | 账簿记录中涉及 Duties & Taxes 下分类账的 Purchase 和 Debit Note 凭证(不是 GST 报税表) | 无 |
read_evidence | ComplyEaze Bridge 自身近期读取记录,以指纹形式呈现,不含数字 | 无 |
sales_register | 账簿记录中涉及 Duties & Taxes 下分类账的 Sales 和 Credit Note 凭证(不是 GST 报税表) | 无 |
statement_tie_out | 银行分类账的余额是否与解析所得银行对账单所示的期初和期末余额一致;可按对账单日期或其涵盖的整历月计算:提供三个差额和日期,不返回余额本身 | 无 |
stock_summary | 截至 3 月 31 日每个库存项目的期末价值;若 Tally 自身的 Stock Summary 将该项目单独列为一行,则同时提供期末数量;库存组内的项目不返回数量;仅支持小型账簿(任何类型的主数据条目较多时会拒绝处理,其他日期也会拒绝);仅验证了截至 2026 年 3 月 31 日的会计年度 | 无 |
tally_status | TallyPrime 网关是否响应,以及已加载的公司 | 无 |
trial_balance | 指定日期范围内按分类账列示的试算平衡表 | 无 |
validate_masters | 在生成导入文件前,根据当前账簿检查分类账名称 | 无 |
verify_import | 读取你在 TallyPrime 中手动导入的一批数据 | 此计算机上的证明文件和状态记录 |
voucher_presence | 拟议凭证中哪些已存在于账簿中 | 无 |
voucher_read_cost | 在调用 vouchers、ledger_movement 或 verify_import 前,提供将执行的计数读取次数(在获取任何凭证前遍历整本账簿,统计期间内凭证数量的读取),以及这些读取之间间隔所需的最短时间。它依据账簿经历过的凭证变更次数(Tally 的计数器,即其 voucher mark),而非期间,因此缩短期间不会降低次数,N 次单日调用就要付 N 次读取成本。此值为推算结果,未经测量,也不代表调用耗时 | 无 |
voucher_schema | 凭证文件格式,无需向 TallyPrime 查询 | 无 |
vouchers | 指定期间内的凭证。按凭证编号、参考信息、摘要或金额搜索,以及按分类账、月份、凭证类型、组或一级组汇总的功能,在 0.5.0 版中提供,在 0.4.2 版中不提供(已在一本含 67 张凭证的合成账簿上进行一次检查,测试搜索和前三种汇总;另一次运行测试了按组和一级组汇总;未在大型账簿上检查) | 无 |
启用扩展中的过账功能后,还会出现两个工具:post_import 会在你于 ComplyEaze Bridge 窗口中批准后,过账一张已保存的凭证,或一批已保存的 2 至 50 张凭证(批次过账时需批准批次摘要);acknowledge_post_review 则会在自己的窗口中请你记录:你已审阅一张已过账的凭证,而该凭证的分类账现在指向了不同的主数据。 |
它如何处理你的账簿
- 仅限本地连接。 它通过回环地址与 Tally 自带的 XML 网关通信,因此无法连接到远程 Tally 主机。它无法判断本地端口是否已转发到另一台机器;请勿将端口转发到互联网。Tally 连接不会向 ComplyEaze 服务发送任何内容。
- 你的 AI 服务提供商会看到助手读取的内容,就像它会看到对话的其余内容一样,包括公司、往来方和分类账名称、金额、日期、叙述、参考信息、GSTIN,以及在读取分类账详情时出现的 PAN、银行账号、IFSC、MSME 或 Udyam 注册号、电子邮件、电话和地址;在生成凭证文件时,还会看到该文件的本地路径(其中可能包含你的电脑用户名)。该设置只能选择一项,不能同时选择两项:将往来方和分类账名称及银行账号缩短为仅保留前两位和后两位字符(四位或更少时显示为“…”),或删除叙述。两种方式都不会隐藏金额、公司名称、PAN、GSTIN、IFSC、MSME 或 Udyam 注册号、联系方式或参考信息,也不会隐藏银行对账单账号的末四位;缩短后的名称仍可能被识别,尤其是旁边还会发送 GSTIN 或 PAN。请参阅下文的使用客户数据前。
- 扩展默认关闭过账功能。 请注意,这是一个新设置:如果你在早期版本中启用了过账功能,需要重新启用。启用过账功能后,每次过账都需要在单独的 ComplyEaze Bridge 窗口中获得你的批准(批次过账时显示批次摘要)。在 Windows 上,该窗口还会接管键盘:在已发布的 0.6.0 版本测试中(Tally 全屏、单屏,#1780),输入 n 会拒绝,输入 y 会批准;因此,当你发起过账时,请停止在 Tally 中输入,直到用鼠标在该窗口中作出回应。没有任何 Bridge 工具能让助手批准过账;只有该窗口返回新的单次使用令牌,批准才会生效。过账后,系统会从 Tally 重新读取凭证,让你查看实际写入的内容。目前仍有四项已知限制:ComplyEaze Bridge 无法撤销已过账的凭证(你需要在 Tally 中更正);如果公司在最后一次检查后立即被重命名为目标公司的名称,或以目标公司的名称载入(或仅大小写、空格不同),只要该公司有这张凭证所需的分类账,仍可能收到该凭证;ComplyEaze Bridge 不一定能判断凭证被写入何处,也无法阻止这种情况;如果分类账在同一时刻被重命名并替换,替换后的分类账可能会收到该分录,而且系统不会发现所有此类更改;批准窗口仅涵盖 ComplyEaze Bridge,因此同一个 Claude Desktop 中其他能够更改分录的 Tally 连接器仍可进行更改。请先阅读启用过账功能前。
- 工具调用会留下凭据,保存在你电脑上的日志中:包括公司的 Tally 标识符,以及对请求内容和返回内容生成的指纹;无论调用成功还是被拒绝,都会记录。
- 你必须先接受使用条款。 扩展会在设置中要求你接受 ComplyEaze Bridge 使用条款(版本 2026-10.1);在你接受前,所有工具都会返回
terms_not_accepted并拒绝调用。(在 0.5.0 中,从 0.4.2 更新后,Claude Desktop 可能无法启动扩展:一台 Mac 上出现了未提及使用条款的错误;一台 Windows 电脑上没有错误;#1413。) - 开源,采用 Apache-2.0 许可。
已在真实的 TallyPrime 上进行的测试
除非标注为由所有者报告,否则以下每一项均记录在仓库中,或记录于相关的 Issue 或 Pull Request 中。除非另有说明,每项测试均使用已获授权的 TallyPrime Silver 7.1 和合成公司运行。完整记录请参阅 MCP 指南 和 ADR 0004。
- 读取:在尚未发布的 macOS arm64 构建版本上进行了 27 项检查(PR #228),记录于 2026 年 9 月 6 日评估。 后续也曾在开发构建版本上进行一些实时读取,例如在带有合成公司的调试构建版本上读取试算平衡表(#246,其记录未注明 Tally 版本或许可层级)。并非每项读取都有单独记录的实时运行。
- 过账一张日记账,使用 2026 年 9 月 22 日的开发构建版本 (问题 #579);以及在 macOS 上通过审批对话框过账一笔付款、一笔对冲和两笔收款(其中一笔为三笔分录之一) (PR #600),每笔都读取回为已过账。这些构建版本早于 2026 年 9 月 26 日发布的版本(版本 0.3.0)。
- 在已授权的 TallyPrime Gold 7.1 上原生过账十批数据,于 2026 年 9 月 28 日在一个会话中使用开发构建版本和一本客户端账簿完成(其中九批保存了导入请求);未记录其审批步骤 (协议参考)。
- 在 Windows x64 上运行已发布的 0.3.0 软件包,并在 Claude Desktop 中使用(没有付费计划;我们不对其他计划作出声明):于 2026 年 9 月 28 日在已授权的 TallyPrime Gold 7.1 上进行仅读取操作,使用一本客户端账簿;该会话与上述开发构建版本过账的会话分开进行(由所有者报告;未保留日志)。
- 在 Windows 11 上运行 0.4.0 候选构建版本,日期为 2026 年 10 月 1 日(这是 CI 为版本拉取请求生成的构建版本:除一个测试文件中的注释外,与发布版本代码相同)。维护者将其安装在 Claude Desktop 中,使用一个没有付费计划的新 Claude 账户,对应已授权的 TallyPrime Silver 7.1,其中有一家合成公司。关闭 Terms 设置时,一次调用被拒绝,未读取任何内容。开启后,
tally_status、vouchers、validate_masters、purchase_register、stock_summary和local_data_report均有响应。在 Windows 审批窗口中拒绝了一次凭证过账,没有发送任何内容;批准了另一次,并过账一张日记账,随后通过verify_import验证。同一候选版本的 macOS 构建版本已启动并读取公司列表,其工具也在 macOS 上的 Claude Desktop 聊天中加载成功。这只是一次运行,并非对窗口每个按键的受控测试。 - 于 2026 年 10 月 2 日在 Mac 上运行 0.4.1 构建版本。运行内容:版本拉取请求的 CI 构建软件包,而非已发布文件。维护者将其作为升级安装到已安装 0.4.0 的 Claude Desktop 中;Terms 设置和其他设置均予以保留,扩展的服务进程在升级后自动重新启动(通过进程列表读取了启动时间)。随后,
tally_status和list_companies在已授权的 TallyPrime Silver 7.1 上有响应,其中包含实验室自己的合成公司。未运行的内容: 已发布文件在另一台运行器上重新构建,其程序文件与测试过的文件不同。我们在没有 Tally 的情况下运行了两个构建版本:两者均报告版本 0.4.1,列出 21 个工具,并对tally_status给出相同响应。我们尚未在 Claude Desktop 中安装已发布文件。 - 于 2026 年 10 月 3 日在 Mac 上运行 0.4.2 构建版本。运行内容:发布候选版本的 CI 构建软件包,而非已发布文件。维护者在一台已安装 0.4.1 的 Mac 上将其安装到 Claude Desktop 中:它没有替换 0.4.1,而是作为第二个扩展安装(0.4.2 中作者一栏发生变化,而 Claude Desktop 会部分依据该栏构建扩展的身份);设置没有保留。随后,
tally_status和list_companies在已授权的 TallyPrime Silver 7.1 上有响应,其中包含实验室自己的公司。未运行的内容: 已发布文件在另一台运行器上重新构建,其程序文件与测试过的文件不同。我们在没有 Tally 的情况下运行了已发布的 Mac 文件:它报告版本 0.4.2,在关闭过账时列出 22 个工具(开启时为 24 个),关闭 Terms 设置时会拒绝调用。我们尚未在 Claude Desktop 中安装已发布文件,我方也无人曾在 Windows PC 上的 Claude Desktop 中安装 Windows 软件包。 - 于 2026 年 10 月 8 日在 Mac 上运行 0.5.0 构建版本。运行内容:版本拉取请求在合并队列中构建的 CI 软件包,而非已发布文件。维护者将其安装到已安装 0.4.2 的 Claude Desktop 中,作为更新替换了 0.4.2;Tally 端口、Response redaction 和过账设置均保持原样;旧的 Terms 设置已消失,新的设置尚无值。
勾选该选项之前、退出应用之前,Claude Desktop 没有启动扩展,且请求失败并返回 400 错误,错误中未提及 Terms。勾选并保存后,扩展立即启动,
tally_status也有响应;不过助手最初调用了该扩展遗留的第二个条目,结果以相同方式失败;退出并重新打开 Claude Desktop 后,只剩一个连接器,并返回了公司列表。未运行的内容:已发布文件、未勾选该选项时退出并重新打开、在 0.4.2 之前的版本上覆盖安装、全新安装,以及 Windows。 - 于 2026 年 10 月 8 日在 Mac 上使用 0.5.1 软件包。运行内容:贡献者在该 Mac 上从 Terms 设置更改(#1436)构建的软件包,仅将其版本设为 0.5.1;并非已发布文件,也不是 CI 软件包。贡献者在 macOS 26.6.2 上的 Claude Desktop 2.26454.2 中安装了该软件包,当时 Tally 未运行且过账已关闭:作为全新安装;覆盖安装到 0.4.2 上(先在接受 Terms 后开启,再关闭后重新开启);作为更新覆盖安装到 0.5.0 上,且 Terms 已勾选;以及在移除 0.4.2 后安装。每次开启扩展后,Claude Desktop 都会立即启动程序;唯一例外是覆盖安装到保持关闭状态的 0.4.2 上时,在退出并重新打开 Claude Desktop 之前,助手都没有 ComplyEaze Bridge 工具。关闭 Terms 时,调用遭到拒绝并指出 Terms;勾选后,调用进入 Tally 检查阶段并报告 Tally 无法访问。将用户级
BRIDGE_TERMS_ACCEPTED设为 true 并未改变结果:程序自身的值仍为 false。记录见 #1436。未运行的内容:使用该版本读取实时 Tally、已发布文件,以及 Windows。 - 于 2026 年 10 月 9 日在 Windows 电脑上运行 0.5.1 构建版本,按印度时间记录(#1413)。一台 Windows 10 电脑(22H2)、来自 Microsoft Store 的 Claude Desktop 2.26454.2、TallyPrime Release 7.1 Silver,以及为测试创建的一家公司。运行内容:提交
d744d25a的 CI 构建版本(提交时间早于已发布文件;后续提交改写了部分工具文本和说明):全新安装;从 0.4.2 和 0.5.0 更新(作为更新覆盖安装,以及勾选 Terms);将用户级BRIDGE_TERMS_ACCEPTED设为 true;公司列表;一个包含六张凭证的银行对账单导入文件,分别由 0.5.0 和该构建版本生成并进行比较;手动导入该构建版本的文件并读取回来(验证发现全部六张凭证,读取回了叙述,且 8 月试算平衡表与 Tally 自身屏幕显示一致;首次在 0.5.0 上将文件导入公司时被拒绝为empty_book_first_import,当时账簿中已有分类账但没有凭证,因此先在 ComplyEaze Bridge 之外向 Tally 再导入一个分类账和一张 4 月 1 日凭证,该凭证也计入试算平衡表);以及对该文件进行不变更的重新导入(与六张凭证匹配,没有新增)。还测试了关闭状态的扩展连续经过两次更新(它一直保持关闭,聊天中没有工具也没有错误;开启扩展即可)。随后,在合并后的提交b91038a9的 CI 构建版本上重新执行步骤 1 和 2,并在关闭 Tally 的情况下对已发布的 0.5.1 文件执行步骤 1(根据其.sha256文件和构建证明核对)。此电脑上未能启动覆盖安装在 0.4.2 上的已发布 0.5.0 文件:聊天中没有 ComplyEaze Bridge 工具,也没有显示错误。未运行的内容:更改后的重新导入、在已发布文件上执行步骤 2 至 11、过账,以及其他 Windows 版本、Tally 版本或 Claude Desktop 构建版本。记录为贡献者在 #1413 中的报告。 - 于 2026 年 10 月 16 日在 Windows 电脑上运行 0.6.0 构建版本(#1148)。一台 Windows 10 Home 22H2 电脑、来自 Microsoft Store 的 Claude Desktop 2.37337.1.0、使用端口 9001 的 TallyPrime 7.1 Silver,以及一家新建的合成公司。运行内容:发布拉取请求的 CI 软件包(提交
a3b7316947cdf3c5ce46615c8b89e45d538345f3,bridge-tally.mcpbSHA-2566b83ca74377d7ed86a2b524f4d53bd2e9753b3318bfa6634078d5f5645184022,bridge_mcp.exeSHA-256e9780806594e60afabdb83d35bb751f0aeefba708b2b63c33b11452bbf0e5a84),开启唯一的过账设置后,分别过账一张日记账、一笔收款、一笔对冲和一笔付款,各一次且未指定凭证编号;另将一批三张凭证(一笔付款、一笔收款和一笔对冲)在一次审批后过账。每次过账都成功创建了所发送的内容,且每张凭证在过账后的读取结果和再次执行verify_import时均为posted_verified。审批窗口显示在全屏 Tally 和 Claude Desktop 前面(一次运行,一个屏幕),默认选中“否”,并取得键盘焦点(原本用于 Tally 的向下箭头移动了窗口中的选项;单独按 Enter 会拒绝,使用箭头键后按 Enter 可选中“Yes”;本次运行未测试输入字母;当日稍后的已发布文件测试中,输入 n 会拒绝窗口,输入 y 会批准:#1780)。随后将由发布工作流自身步骤构建的软件包(演练运行 38885882661,bridge_mcp.exeSHA-25610e4614f74eab975897834ec1c9750edbe9fc7ad91584b802e5cde57a8180899)覆盖安装在其上,保留了端口和过账设置(版本相同,并非升级),并以相同方式再过账一张日记账。已发布文件(bridge-tally-mcp-v0.6.0-windows-x64.mcpbSHA-2567bf81f08e058fc7ae00ccc51b3dceec10dc50d45dca8477a0438fd9b5a2852ca,bridge_mcp.exeSHA-2561e41e039fbf3daaf6be5a3c8e2f5e0bd1245a745abc5e78349fd83ce678224c1)与上述两者均不同:其 exe 与演练构建版本的 26,503,168 字节中有 77 字节不同;在实时 TallyPrime 上,仅在 2026 年 10 月 16 日的探测中运行过(#1780),如上所述:输入 n 拒绝;输入 y 批准了一笔由于调用已超时而未发送的过账;27 分钟后再次调用,此时审批已过期,因此打开了新窗口;通过鼠标点击“Yes”作答后,成功过账一笔对冲,并读取回posted_verified。这些构建版本均未运行的内容包括:一批日记账、超过 3 张凭证的一批数据、被拒绝或部分成功的过账、修改、审核窗口、On Account 审批、已弃用的批次变量、凭证编号行(#724、#1668)、针对真实vouchers调用的voucher_read_cost、Microsoft Store 安装版本的锁定证明(#1584、#1459)、第二台显示器、实时过账时批次的headline、导入菜单、桌面应用、销售发票过账(0.6.0 未提供)、Gold、macOS、其他 Windows 或 Tally 版本,以及从 0.5.1 升级。此次测试记录在变更日志的 0.6.0 条目中;与已发布文件的比较是在发布后根据发布资源进行的。 - 2026 年 10 月 27 日测试了已发布的 Windows 版 0.6.1 文件。
bridge-tally-mcp-v0.6.1-windows-x64.mcpb(SHA-2567812d8ad7b0ff6a07eac20828dfedaef4d50104bd5d679db3fc03c26e784c47a,与其.sha256文件、冒烟测试报告和来源记录一致;bridge_mcp.exeSHA-256bdd428e4806bdbf70925956f90d410df48a0470b1a2f78c746c4c18088471d8d)经解包后由我们的测试客户端直接启动(未安装在 Claude Desktop 中;过账和导入设置均未设置,因此列出 29 个工具),并连接到已授权的 TallyPrime 7.2 Silver,其中有一家合成公司:它报告版本 0.6.1,且tally_status、list_companies和ledger_masters均有响应。未进行任何过账。未运行:macOS 文件、Claude Desktop、过账、开启设置后的audit_test_run,以及任何其他读取。记录:lab/061-post-publish-answers提交为647a64014ce7369acc611b7adc3de63bd80df708。 - 于 2026 年 10 月 4 日和 5 日在 Mac 上运行银行对账单流程的前四步,使用同一个由 CI 构建的 0.4.2 候选版本(10 月 3 日安装;并非已发布文件),连接到已授权的 TallyPrime Silver 7.1,其中包含实验室自己的合成公司。成功解析了合成的 HDFC 格式对账单(六行,合计与提供的数字一致);名称检查发现没有名为“Suspense”的分类账,因此拒绝生成文件,且未写入任何文件;在 Tally 中通过单分类账导入(不使用此工具)创建“Suspense”后,成功生成包含六张凭证的文件。我们尚未导入该文件或读取结果,也未运行真实对账单。
我们尚未在受控测试中运行以下场景:使用已发布的软件包向运行中的 TallyPrime 过账,唯一例外是 2026 年 10 月 16 日的那次 Contra(#1780);Windows 审批窗口中的每种拒绝方式(已尝试一种);接受条款后,在 macOS 上通过 Claude Desktop 使用工具(在 0.4.1 的 CI 构建版、0.4.2 的 CI 构建版,以及一台运行 0.5.0 CI 构建版的 Mac 上,
tally_status和list_companies均有响应);在 TallyPrime Education 上过账;在 TallyPrime Gold 上过账并记录其审批步骤。每个发布包都会在 Windows x64 和 Apple Silicon Mac 的托管 CI 运行器上构建并启动、检查其工具列表,并解析一份合成的加密银行对账单。
最新版本中尚不支持
- 库存组内项目的库存数量,以及任何类型主数据较多的账套中的库存读取;销售、采购或税务过账;创建主数据;按账单分配
- TallyPrime Education 模式:试算平衡表、损益表、资产负债表、现金流量表、月度登记簿、
company_features、库存汇总和masters读取均会被拒绝;凭证读取、分类账变动、任一登记簿读取,或其他日期范围读取(其范围开始或结束日期不是 1 日、2 日或 31 日)也会被拒绝;凭证日期不是上述日期的导入文件或过账操作同样会被拒绝(尚未在 Education 上运行过账) - 库存已关闭的账套中的库存汇总,或在同时加载同一公司其他年度账套时,按年度拆分的公司中的库存汇总
- 删除或撤销已过账的凭证(请在 Tally 中更正)
- 超大型账套中的读取可能失败,或耗时超过助手的等待时间(#485、#703)
- 基本货币不是 INR 的账套。在包含多种货币的账套中:外币分类账和凭证本身(会被搁置或扣留,并注明名称)、分类账变动、损益表和资产负债表、采购和销售登记簿(若其中有一张凭证指向被搁置的分类账,整个读取操作都会被拒绝且不返回任何行),以及过账
- Tally Cloud Access 或任何远程 Tally 主机
- Intel Mac,以及经过代码签名的安装程序
适合你吗
本工具面向执业会计师或 CA 事务所:他们已使用 TallyPrime 维护客户账套,并希望通过 Claude Desktop 等 AI 助手查询账套或向其中过账。
当前功能
- 读取已加载的公司、分类账主数据、试算平衡表、指定日期范围内的凭证、应收和应付未结款项,以及分类账变动。
- 过账前检查分类账名称。 提供银行对账单或发票中的名称,工具会报告哪些名称存在于账套中,哪些名称相近但不完全匹配、需要你决定。跳过这一步时,导入被整体拒绝的最大单一原因就是没有先读取分类账列表。
- 记录操作。 Bridge 运行的每次工具调用——无论是读取还是写入,无论成功还是被拒绝——都会在你自己的机器上向日志追加一份回执,标明其操作涉及的公司,并为请求内容和返回结果生成指纹。读取操作也会将这些指纹作为证据一并保存。准备好的批次会记录其构建时所针对的本地端点;若该端点此后发生变化,原生过账就会被拒绝。这项安全检查保存在 Bridge 的内部导入账簿中,而不会写入审核人员打开的证明报告。审核人员可以直接查看日志,而不必盲目信任摘要。
开启过账前
是否启用写入取决于你的安装方式。 上述功能均为读取功能。关闭写入时,写入工具并非仅仅拒绝请求,而是会完全从工具列表中消失,因此助手看不到这些工具的存在。
- Claude Desktop 扩展默认关闭凭证过账。 过账仍有四项已知限制。Tally 会根据公司名称将导入内容指定给公司,无法将其绑定到公司的 GUID。Bridge 在过账前的最后一次请求会检查,已加载的公司中是否恰有一家公司的 GUID 和名称与目标一致,且没有其他已加载公司在忽略大小写和空格后名称相同;否则会拒绝过账(#607)。如果在该检查完成后,某家公司被重命名为目标名称,或以目标名称(或仅大小写、空格不同的名称)加载,只要它拥有凭证所用的分类账,仍可能收到该凭证。Bridge 之后可能会标记已加载的公司发生变化,但不一定能确定凭证去了哪里,也无法阻止这种情况(已接受的剩余风险,#574)。如果在同一时刻某个分类账被重命名并替换,过账可能会落到替代分类账中。Bridge 如果发现该分类账现在解析到不同的主记录,会将结果标记为需要对账;如果更改没有移动公司的主记录标记,或在检查前已恢复,就不会被发现;同一时刻发生的重新分组也不会被检测到(#623)。此外,Bridge 没有删除或撤销已过账凭证的工具,因此错误过账必须在 Tally 中手动更正。Bridge 会记录每次过账发送的 REMOTEID,但目前还没有删除工具(#579,#582)。审批窗口仅涵盖 ComplyEaze Bridge:同一 Claude Desktop 中另一个能够更改分录的 Tally 连接器可以不经此审批就进行更改。在扩展设置中启用
允许过账凭证:单张凭证或最多 50 张的批次,会添加
post_import,用于过账一张已保存的上述类型凭证,或一个包含 2 至 50 张日记账的已保存批次,或一个包含 2 至 50 张付款、收款和对冲凭证的已保存批次; 每次过账仍需在单独的 Bridge 对话框中获得你的批准(批次过账时显示其摘要)。批次过账还有两项限制:如果 Tally 只创建了批次中的部分凭证,Bridge 会报告账簿中能找到哪些凭证、找不到哪些凭证,并拒绝再次过账缺失的凭证(找不到的凭证仍可能已在 Tally 中,但经过编辑:请在 Tally 中逐一检查,确认前不要重新录入);如果批次超过 50 张,或其摘要无法在窗口中显示,也会被拒绝。除非你接受这些风险,否则请关闭此设置。凭证文件准备和银行对账单解析不会向 Tally 写入内容,因此关闭此设置后仍可使用。 这是一个新设置:如果你在早期版本中启用了过账,请重新启用。 - 源码构建默认关闭写入功能。 准备文件需要设置
BRIDGE_AGENT_ENABLE_IMPORT;过账还需要设置BRIDGE_AGENT_ENABLE_WRITES,该设置会同时授予这两项权限,并涵盖单张凭证和包含 2 至 50 张凭证的已保存批次。BRIDGE_AGENT_ENABLE_BATCH_POST已弃用:过账启用时,如果仍设置了该变量,post_import会以setting_retired为由拒绝;请移除该变量。 - 源码构建还需要
BRIDGE_TERMS_ACCEPTED=true。 扩展会要求将其设为“I accept”;未设置时,所有工具都会拒绝执行。
启用写入功能后:
- 将凭证准备为本地文件 — 日记账、付款、收款和转账。Bridge 会写入文件,但不会发送文件。
- 每次批准后过账一张已保存的日记账、付款、收款或转账凭证;也可以先批准汇总,再过账 2 到 50 张已保存的凭证,并且只有在你通过自己设备上的对话框批准该凭证(或该批凭证的汇总)后才会过账。
助手无法替你批准。随后,Bridge 会读回凭证,让你查看实际写入的内容。你也可以自行通过 Tally 导入准备好的文件;之后,
verify_import会读回该凭证。 - 过账有限制。 它不会创建主数据,不会过账销售、采购、税务或库存分录,也不会修改或删除凭证。定义了多种币种的公司将被拒绝。
- 每条银行流水最多过账一次。 Bridge 最多只会从这台电脑向一家公司发送每条银行对账单流水一次;即使过账失败、回复丢失,或凭证之后在 Tally 中被修改或删除,也不会将其作为新凭证再次发送。如果 Tally 中没有这条记录,请自行在 Tally 中录入;不要修改对账单来绕过 Bridge。Bridge 无法识别从另一台电脑过账或重装后过账的记录、日期、类型、分类账或金额不同的手动录入、在已过账凭证被修改后从其他地方下载的同一份对账单,也无法识别手动导入 Bridge 保存的文件。完整规则及其六项限制见Agent 指南。
它不会做什么
- Tally 路径不会向 ComplyEaze 上传任何内容。 Bridge 通过本地连接读取数据,并将其交给你正在使用的助手;Tally 路径中的任何内容都不会将数据发送到我们的服务端。
- 准备好文件后,若没有单独、明确的后续步骤,它不会过账任何内容。
- 它不是 Tally 的替代品、报表套件或申报工具。
桌面应用
该扩展与桌面应用由同一个源代码库构建。 0.3.0 及更早版本的包中包含尚未完成的文档上传功能和 AXAL 登录功能,但扩展的任何工具都不会调用这些功能。这些代码已移除(#914),从 0.4.0 起发布的版本不再包含这些代码;ComplyEaze Bridge 自有代码中唯一的网络客户端会连接到你自己电脑上的 Tally。目前没有发布桌面安装程序。请参阅安全与隐私。
使用客户数据前
使用前有一点需要了解。 你通过 Bridge 向 AI 助手询问财务数据时,助手的服务提供商会看到它读取的内容,包括公司、往来单位和分类账名称、金额、日期、摘要、参考编号、GSTIN,以及读取分类账详情时的 PAN、银行账号、IFSC、MSME 或 Udyam 注册号、电子邮箱、电话和地址;构建凭证文件时还会看到该文件的本地路径(其中可能包含你的电脑用户名)。这是使用托管式助手带来的特性,而非 Bridge 所致。ComplyEaze Bridge 可以在发送前将往来单位和分类账名称及银行账号缩短为仅保留开头和末尾各两个字符(四个或更少字符会变为“…”),或删除摘要(BRIDGE_AGENT_REDACTION 只能取其中一个值,不能同时取两个)。这不会隐藏金额、公司名称、PAN、GSTIN、IFSC、MSME 或 Udyam 注册号、联系方式或参考编号,也不会隐藏银行对账单账号的末四位;缩短后的名称仍可能被识别,尤其是旁边一并发送的 GSTIN 或 PAN 足以识别时——回复中始终会包含金额。处理客户数据时,请审慎决定。
费用说明
ComplyEaze 尚未为 ComplyEaze Bridge 定价,也不出售其许可证;您无需在我们这里注册账户、订阅服务或获取许可证密钥。您下载的版本代码仍受其发布时所采用的许可证约束(当前版本采用 Apache-2.0)。我们尚未决定未来是否会对任何内容收费。
目前您需要支付或提供:
- **TallyPrime:**您自己的许可证。
- **Claude Desktop:**Anthropic 的套餐。2026 年 10 月 1 日,我们在 Windows 上使用一个没有付费套餐的 Claude 账户,在一家模拟公司中运行了 0.4.0 候选构建版本(非已发布文件);我们不对其他套餐或更大型账簿的情况作任何保证。
- **您客户的数据:**Claude 读取的数据会根据您所用套餐的 Anthropic 条款发送给 Anthropic;通过 ComplyEaze Bridge,ComplyEaze 不会接收这些数据 (隐私政策,第 4 至 6 节)。
- **您自己的核查:**依赖检查结果前,请先在 Tally 中核实。
我们不保证提供支持和更新 (使用条款,第 4.4 节)。我们的责任范围受第 14 节规定的限制,包括其中的兜底条款和例外情况;在为客户开展工作前,请先阅读该节。
安装
**安装前,请开启 Tally 的 HTTP 网关。**TallyPrime 默认不会监听 ComplyEaze Bridge 的连接。在 Tally 自带的连接/客户端-服务器配置设置中,将 Tally 设为服务器(按 Tally 的说法,选择 “acts as Both”),并记下其 HTTP 网关端口——默认是 9000,但可以配置。要确认网关确实已开启,请在浏览器中打开 http://localhost:9000/status(将端口替换为您自己的端口):正在运行的网关会返回一段简短的 Tally XML 响应;如果浏览器无法连接,则表示网关仍处于关闭状态——除非 Tally 在 Mac 上的 Windows 虚拟机中运行,这种情况下请在该虚拟机内执行检查,或等到本地端口转发正常后再检查。Mac 上的浏览器无法连接,可能是因为缺少下文所述的端口转发,而不是网关已关闭。如果页面一直等待且没有响应,则 Tally 可能只是正在处理其他请求——请等待后重试,不要更改设置。
请安装 Claude Desktop 扩展的最新已发布版本。 请按照安装指南安装并配置该扩展。 操作前,请先了解它的功能及限制:
- Bridge 仍在开发中。 发布版本可能包含错误,请先使用测试数据试用,并保留最新备份。目前尚未进行代码签名或公证,因此操作系统可能会在打开前发出警告。
每个软件包都附有
.sha256文件和来源记录,方便你确认下载的具体字节内容及对应的源代码提交。 - 仅检查了能否启动。 发布版构建确认软件包可以启动并列出其工具,但不能证明它能与您的 Tally 配合使用,或能在 Claude Desktop 对话中正常工作。已在真实 TallyPrime 上进行过测试的内容及对应版本,见上文;我们曾在 2026 年 10 月 16 日 (#1780) 使用发布的 0.6.0 软件包连接实时 TallyPrime 进行测试,当天创建了一笔 Contra,使用的是合成公司;发布的 Windows 0.6.1 文件中的程序曾于 2026 年 10 月 27 日进行过一次只读运行,未进行过记账(见上文 2026 年 10 月 27 日的条目);macOS 0.6.1 文件尚未在 TallyPrime 上运行;我们根据相同源代码自行检查生成的另外两个 0.6.0 构建版本,曾在一台 Windows 电脑上连接 TallyPrime 7.1 Silver 进行测试(见上文 2026 年 10 月 16 日的条目)。
- 仅支持 Windows x64 和 Apple Silicon Mac。 不支持 Intel Mac。
- 在 Mac 上,Tally 必须在同一台 Mac 上运行,可以是在本地 Windows 虚拟机中运行,也可以通过经批准的本地转发运行。Bridge 只会与您自己的电脑上的 Tally 通信,因此无法通过输入地址连接单独的电脑或网络上其他位置的 Tally。
- 不会自动更新。 要升级,请从 Claude Desktop 的“扩展”设置中安装较新的发布版本,并保留数据文件夹。0.4.2 安装在旧版本旁边,而不是替换旧版本(在 Mac 上观察到;未在 Windows 上测试)。我们自行检查生成的 0.5.0 构建版本(并非发布文件)曾在一台 Mac 上替换 0.4.2,并保留其 Tally 端口、Response redaction 和记账设置:在该设备上,勾选新的 Terms 设置,检查记账设置,然后退出并重新打开 Claude Desktop。未测试在早于 0.4.2 的发布版本上安装:请先将其移除。如果“设置”中的“扩展”列出两个 ComplyEaze Bridge 条目(曾在 0.4.2 安装在旧版本旁边时出现),请先移除旧条目,再使用任一版本;在新版本中输入设置,包括默认值为 none 的 Response redaction,勾选新的 Terms 设置,然后退出并重新打开 Claude Desktop。
Bridge 桌面应用是一个独立程序,目前没有发布安装程序;如何从源代码构建,请参阅下文的贡献者快速入门。
本文件其余部分面向参与 Bridge 开发的人员。此代码库可独立使用:构建和开发命令会相对于克隆的代码库解析文件,而非依赖开发者专属目录。其中包含一个 Tauri 桌面应用,以及面向 Claude Desktop 的 MCPB 打包流程,并包含用于 Tally 和本地数据库操作的 React/TypeScript 与 Rust 组件。
第一个有用的结果
请按照安装指南安装 Claude Desktop 扩展的最新发布版本。如需使用源码,下面的贡献者快速开始会构建桌面应用;如需从源码运行 MCP 服务,请遵循源码 MCP 设置。
在通过 MCP 客户端请求财务数据之前,客户端可能会将所选的 Tally 结果发送给其 AI 提供商,包括公司身份、往来方或未结账单明细、金额、日期、摘要、参考号、GSTIN,以及在其读取分类账明细时的 PAN、银行账号、IFSC、MSME 或 Udyam 注册号、电子邮件、电话和地址,还有在其构建凭证文件时该文件的本地路径(其中可能包含你的计算机用户名)。源码安装默认使用 BRIDGE_AGENT_REDACTION=none;如果更符合工作流,请在启动前将其设置为 mask_parties 或 drop_narration(只能设一个值,不能同时设两个)。这些设置会缩短往来方和分类账名称及银行账号,或删除摘要;它们不会隐藏金额、公司名称、PAN、GSTIN、IFSC、MSME 或 Udyam 注册号、联系方式或参考号,也不会隐藏银行对账单账号的后四位数字。包安装设置提供相同的选项。
为了获得第一个结果,请运行 tally_status 以检查是否观测到 TallyPrime 及其 Licensed 或 Education 模式,然后列出已加载的公司。选择一家恰好观测到一个 INR 货币主数据的公司,并请求应收或应付。在 Education 模式下,请在第 1、2 或 31 天显式提供 as_of 日期;省略日期会默认为今天,并可能被拒绝。Bridge 会为财务读取重新检查产品、模式、日期和货币;其他或未观测到的产品/模式、没有货币主数据、非 INR,或有多个货币主数据都会被拒绝。
桌面端还通过 Prepare file 提供本地 XML 草稿准备。它会在可编辑建议旁保留源观测数据,并保存本地草稿以供后续审阅。
贡献者请使用下面的设置和开发路径。
支持的开发主机
Bridge 旨在 Windows 和 macOS 12.4 或更高版本上构建和运行。请在各个操作系统对应的原生主机上运行平台检查;在一个操作系统上成功构建并不能验证另一个操作系统。
共享先决条件:
- Node.js 24(>=24.15.0)和 Corepack(
.node-version固定 CI 基线) - 由
rust-toolchain.toml固定的 Rust 工具链 - 用于捆绑 SQLCipher/OpenSSL 构建的 Perl 5 及
Locale::Maketext::Simple - 用于生成 SQLCipher 绑定的 LLVM/libclang(可能需要
LIBCLANG_PATH) - Tauri 先决条件中列出的操作系统依赖项
在 Windows 上,请安装 Microsoft C++ 生成工具、WebView2 组件,以及完整的 Perl 发行版(如 Strawberry Perl)。如果另一个不完整的 perl.exe 先出现在 PATH 中,请将 OPENSSL_SRC_PERL 设置为完整的 Perl 可执行文件。同时安装 LLVM;如果无法发现 libclang.dll,请将 LIBCLANG_PATH 设置为其所在目录(通常为 C:\Program Files\LLVM\bin)。在 macOS 上,请安装 Xcode Command Line Tools。Bridge 的 macOS 捆绑包需要 macOS 12.4 或更高版本。
贡献者快速入门
在仓库根目录中,通过 PowerShell、命令提示符或 POSIX 兼容的 shell 运行以下命令:
corepack pnpm install --frozen-lockfile
corepack pnpm exec playwright install chromium webkit
corepack pnpm test
corepack pnpm run build
corepack pnpm run cargo:check
corepack pnpm run tauri:dev
pnpm test 包含 Chromium 和 WebKit 的证据抽屉焦点测试套件;因此,每个开发环境都需要在安装依赖后安装锁定版本的浏览器。tauri:dev 会启动 Vite 开发服务器和桌面应用。它不要求固定的检出位置。首次 Rust 构建可能需要几分钟。
要构建发行版,请在每个目标主机上运行 corepack pnpm run tauri:build。
CI 生成的捆绑包仅为未签名的冒烟测试产物。在发行流程手册中的签名、公证、来源证明和回滚关卡完成之前,请勿重新分发桌面安装程序。
平台验证
在声称支持某个平台之前,请在该平台上运行以下命令:
corepack pnpm install --frozen-lockfile
corepack pnpm run build
corepack pnpm run cargo:check
corepack pnpm run tauri:build
另请手动测试受影响的 Tally 工作流。 即使仓库路径和项目命令具有可移植性,供应商集成仍可能需要特定主机软件。
集成信任边界
即使渲染器遭到入侵,Bridge 仍会限制原生网络和文件访问:
- Tally 连接仅限环回地址(
localhost、127.0.0.0/8或::1)。 明文远程 Tally 主机会被有意拒绝。 - 在文件管理器中显示导出文件时,只接受 ComplyEaze Bridge 启动后导出的文件;渲染器发送的任何其他路径都会在启动任何程序前被拒绝。
隐私与安全诊断
请勿提交或附上真实的客户、公司、税务、证书、凭据、财务或文档数据。分享日志、屏幕截图、测试样例或复现步骤之前,请将个人和客户数据替换为合成值,并移除本地用户名和绝对路径。私密报告和处理要求请参阅 SECURITY.md。
仓库目录
src/- React UI 和 API 绑定src-tauri/- Rust 核心和 Tauri 配置docs/- 架构、路线图和运维指南.github/- 问题和拉取请求模板,以及 CI 配置
治理
许可证
Bridge 根据 Apache License, Version 2.0 授权。
归属声明见 NOTICE。
ComplyEaze 徽标和图标文件不受 Apache-2.0 许可;详情请参阅
NOTICE 和 TRADEMARKS.md。
Tally 和 TallyPrime 是 Tally Solutions Pvt. Ltd. 的商标。ComplyEaze
Bridge 是独立产品,与 Tally Solutions 无关联,也未获其认可;仅使用这些名称描述兼容性。
历史版本 v0.1.0 仍依据该标签随附的 MIT 许可证授权;当前开发源代码版本为 0.6.1,依据 Apache-2.0 授权。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。