核心用法
Unified Invoice Generator 是一款面向韩国本土企业及跨境自由职业者的综合性财务文档生成工具。用户通过 CLI 命令行界面，可快速生成三类文档：
1. 한국형 견적서（韩国标准报价单）：包含事业者登记号、供给价额、附加税（10%）自动计算，符合韩国税务规范
2. 세금계산서（税务发票）：区分收据/请款（영수/청구），生成批准编号，用于正式增值税申报
3. 프리랜서 인보이스（自由职业者发票）：支持 Markdown/PDF 输出，多语言（韩/英）、多币种（KRW/USD/EUR）
核心工作流：先通过 manage-clients.js 和 manage-items.js 建立交易方与品项数据库，再使用 generate.js 调用模板生成文档，输出至 output/ 目录。
显著优点
- 本土化合规：严格遵循韩国税法，事业者登记号格式验证、10% 附加税自动计算、反向推导（总价→供给价额）
- 双语跨境支持：同一工具兼顾韩国企业本地需求与海外客户国际结算场景
- 数据库化复用：交易方信息、常用品项持久化存储，避免重复录入
- 模板可定制：HTML/Markdown 模板直接编辑，支持企业品牌定制
- 自动化集成：预留与消息发送、日报系统、日历提醒、项目管理工具（Trello/Notion）的扩展接口
潜在缺点与局限性
- PDF 依赖外部服务：需 OpenClaw 浏览器（端口 18800）运行，增加部署复杂度
- CLI 门槛：非图形界面，普通财务人员学习成本较高
- 国际税务覆盖有限：虽支持多币种，但仅内置韩国源泉税（3.3%），其他国家税务规则需手动配置
- 无云端同步：数据存储于本地 JSON 文件，多设备协作需额外方案
- 审批流程缺失：生成的税务发票为"임의 생성"（临时生成）批准编号，未对接韩国国税厅电子系统
适合人群
- 韩国中小型企业（SME）经营者及财务人员
- 向韩国客户开具正式税务发票的自由职业者
- 需同时处理韩国内部交易与海外客户结算的跨境服务提供者
- 具备基础命令行操作能力的技术型用户
常规风险
- 税务合规风险：生成的税务发票未经国税厅电子确认，正式申报前需人工核对
- 数据安全风险：敏感财务数据（事业者登记号、银行账户）以明文 JSON 存储，缺乏加密机制
- 汇率波动风险：多币种发票未内置汇率更新机制，需手动确认结算汇率
- 外部依赖风险：OpenClaw 浏览器服务中断将导致 PDF 生成功能失效