Tally Prime CA — Tally Prime 会计师事务所

TallyPrime (CA) 技能 通过其 XML-over-HTTP 接口连接到本地运行的 TallyPrime 实例。所有请求都是 HTTP POST 到 $TALLY_URL（通常为 http://localhost:9000），带有 XML 正文。没有云 API：TallyPrime 必须在用户的机器上打开/运行。多公司：始终使用正确的 SVCURRENTCOMPANY（确切的拼写）。

英雄用例：桥接 JSON → Tally 条目 该技能从桥接服务（参见 reference/bridge-input.md 的模式）接收预提取的发票数据作为规范的 JSON 负载。PDF/图像提取由单独的 tally-extractor-skill 处理，该技能运行在实例 A 上。目标：为处理多个客户的 CA 实现零手动输入。从桥接服务接收验证的 JSON 负载（公司、方、GSTIN、日期、发票号、项目、税金、总计）。确保主数据存在：方账、购买/销售账、GST 账（如果需要）、银行/现金账。使用唯一的 GUID（JSON 中的 idempotency_key）发布凭证。将结构化结果返回给桥接服务，以便将其转发给用户。重要：此技能不解析 PDF 或图像。所有文档提取都发生在实例 A（tally-extractor-skill）上。此技能仅处理通过桥接 HTTP 端点的结构化 JSON 输入。

PDF 生成 当用户要求从发票数据或任何文本消息生成 PDF 时，使用 tallyca CLI。这将原始 WhatsApp/Telegram 文本直接转换为专业的 GST 合规 PDF。重要：始终通过 tallyca 生成文件。当 tallyca 失败时，不要使用模型生成 HTML/PDF - 修复环境（如下）或设置 TALLYCA_PDF_BACKEND=pdfmake 并重试。

一次性设置（每个环境运行一次） npm install -g tallyca 最低 tallyca CLI 版本（OpenClaw 必须保持最新） OpenClaw 不会自动发现新的 npm 发布版本。使用 npm install -g tallyca 安装的版本将保持不变，直到有人运行升级命令。该技能的 PDF 流程所需：tallyca >= 1.0.1（semver）。诸如 Playwright + pdfmake 回退和 TALLYCA_PDF_BACKEND 之类的功能假设此基线。当您发布新的突破性或必须具有的 CLI 版本时，请在 SKILL.md 中编辑此行以更新最低版本，然后重新部署技能，以便代理重新安装（如果需要）。

预飞行检查（在生成 PDF 之前） 运行 tallyca --version（输出类似于 tallyca/1.0.1 ...）。将数字版本与上述最低版本进行比较。如果 tallyca 缺失或版本低于最低版本，请运行：npm install -g tallyca@latest 或精确固定：npm install -g tallyca@1.0.1。可选（仅当 npm 注册表可访问时）：比较注册表与已安装版本：npm view tallyca version。如果注册表版本较新且您想要最新的修复，请运行 npm install -g tallyca@latest，然后重新检查 tallyca --version。注意：此文件顶部的 version 字段是技能文档版本，而不是 tallyca 包版本。

服务器上的 PDF 渲染（AWS / Linux / 最小图像） tallyca 尝试首先使用 Playwright + Chromium（匹配 HTML 模板）。如果 Chromium 无法启动（常见错误：缺少 libatk-1.0.so.0，"无法启动浏览器"，缺少 GTK/GBM 库），则它会自动回退到 pdfmake（纯 JavaScript，无浏览器）。您可以使用 TALLYCA_PDF_BACKEND 控制此行为： 值 行为 auto（默认） Playwright 首先在典型的 Chromium 故障上使用 pdfmake playwright 仅 Playwright - 如果 Chromium/库缺失则失败 pdfmake 跳过 Chromium - 始终使用 pdfmake（在锁定的无服务器/AWS 上最适合没有 apt/yum） 在 AWS 上出现 Playwright 错误时推荐：export TALLYCA_PDF_BACKEND=pdfmake 然后运行相同的 tallyca from-text / generate:invoice 命令。如果您可以安装操作系统包（具有 sudo 的完整 EC2/容器），请安装 Chromium 依赖项和浏览器以使 Playwright 工作： Amazon Linux 2 / AL2023 sudo yum install -y \ alsa-lib atk at-spi2-atk cups-libs libdrm libXcomposite \ libXdamage libXrandr mesa-libgbm pango gtk3 npx playwright install chromium npx playwright install-deps chromium Ubuntu / Debian sudo apt-get update sudo apt-get install -y \ libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 \ libxcomposite1 libxdamage1 libxrandr2 libgbm1 \ libpango-1.0-0 libcairo2 libasound2 libatspi2.0-0 npx playwright install chromium npx playwright install-deps chromium

从原始 WhatsApp 文本生成发票 PDF 直接将用户的消息传递给 tallyca from-text： tallyca from-text \ --company "ABC 公司" \ --text "方名称：XYZ 方 发票号：186 日期：2/1/2026 项目：PQR 项目 2523 @ 18 % 数量：140 袋 率：279.66/袋 HSN 代码：25322210 金额：39152.40 确保使用凭证类 Sales @ 18 %" \ --output invoice_186.pdf 解析器自动提取：方名称、发票号、日期、项目详细信息、HSN、数量、率、税率、金额和凭证类。

使用结构化标志生成发票 PDF 当您已经提取了字段时： tallyca generate:invoice \ --company "ABC 公司" \ --party "XYZ 方" \ --invoice-no 186 \ --date "2/1/2026" \