invoice-template

核心用法

Invoice Template Skill 是一款专门用于生成专业 PDF 发票的自动化工具。用户只需提供结构化的发票数据（包括公司信息、客户信息、项目明细、税率等），该技能即可通过两种技术方案生成标准化发票文档：一是基于 ReportLab 库的底层 PDF 绘制方案，适合需要精细控制布局的场景；二是基于 WeasyPrint + Jinja2 的 HTML 转 PDF 方案，支持通过模板引擎实现灵活的样式定制。技能支持批量生成、递归发票创建以及按客户定制模板等高级功能，所有操作均在本地完成，无需联网。

显著优点

该技能的最大优势在于其专业性与灵活性的平衡。首先，生成的 PDF 完全本地化，确保财务数据的隐私安全，不会上传至云端。其次，双技术栈设计满足了不同技术背景用户的需求：ReportLab 方案适合追求极致性能和精确控制的开发者，而 HTML 模板方案则让前端开发者能通过熟悉的 CSS 进行样式设计。此外，技能支持自动计算小计、税额和总计，避免人工计算错误，并能轻松实现品牌一致性，通过模板复用确保所有发票符合企业视觉识别标准。

潜在缺点或局限性

尽管功能实用，但该技能存在一些使用门槛。首先，用户需要手动安装多个 Python 依赖库（reportlab、weasyprint、jinja2 等），而 WeasyPrint 在 Windows 平台上的安装可能涉及额外的系统依赖配置。其次，技能提供的示例代码缺少输入验证和异常处理机制，直接使用示例代码处理不可靠的输入数据可能导致 KeyError 或计算错误。此外，该技能仅支持本地文件存储，无法实现云端同步或自动邮件发送功能，对于需要云原生发票管理的场景不够完善。

适合的目标群体

该技能主要面向四类用户：一是自由职业者和咨询顾问，需要快速生成专业发票向客户收款；二是中小企业财务部门，需要批量处理周期性账单或定制化客户发票；三是电商和 SaaS 平台开发者，需要将订单数据自动转换为 PDF 发票集成到现有工作流；四是会计师事务所和代理记账服务，需要标准化、自动化的文档生成工具来处理大量客户账务。

使用风险

使用该技能时需注意以下风险：依赖库版本可能存在冲突，特别是 WeasyPrint 对系统库有特定要求，建议在生产环境部署前进行充分测试；文件操作存在路径风险，用户应确保输出路径指向可控目录，避免覆盖系统重要文件；数据验证责任完全由用户承担，技能本身不检查输入数据的合理性（如负数量、无效税率等），错误数据将导致错误发票；此外，大批量生成 PDF 时可能占用较多系统资源，建议在非高峰时段执行批量任务。