发票生成器

从结构化JSON数据生成PDF发票。

设置

1. 1. 安装Node.js依赖：

bash
cd invoice-generator && npm install

1. 2. 设置INVOICE_DIR环境变量（或在skills.entries.invoice-generator.env中设置）：

bash
export INVOICE_DIR=/path/to/your/invoices

这将创建目录结构：

$INVOICE_DIR/
├── configs/ # 可选：已保存的发票配置
└── invoices/ # 生成的PDF输出

使用方法

bash

从标准输入（即时处理）

从完整文件路径

从已保存的配置（在$INVOICE_DIR/configs/中查找）

加载：$INVOICE_DIR/configs/client-template.json

输出到：$INVOICE_DIR/invoices/invoice-{number}.pdf（如果存在则自动版本化）

输入数据格式

JSON输入必须包含以下字段：

json
{
company: {
name: 您的公司,
address: 123 Main St,
cityStateZip: 城市, 州, 12345,
country: 国家
},
client: {
name: 客户名称,
address: 456 Client Ave,
cityStateZip: 城市, 州, 67890,
country: 国家,
taxId: TAX123
},
invoice: {
number: INV-2025.01,
date: 2025年1月15日,
dueDate: 2025年1月30日
},
items: [
{
description: 服务描述,
rate: 1000.00,
currency: USD
}
],
totals: {
currency: USD,
total: 1,000.00
}
}

查看references/data-schema.md获取完整的字段文档。

输出

脚本在成功时输出生成的PDF文件路径：

$INVOICE_DIR/invoices/invoice-INV-2025.01.pdf

如果该文件名已存在，脚本将写入：

$INVOICE_DIR/invoices/invoice-INV-2025.01-2.pdf（然后-3，以此类推）

错误处理

• - 如果JSON无效或缺少必填字段，退出代码为1
• 如果weasyprint生成PDF失败，退出代码为2
• 错误消息写入stderr