核心功能
klientenportal 是一款针对奥地利 RZL Software 旗下 klientenportal.at 的浏览器自动化技能，基于 Playwright 实现客户端与税务师之间的会计文档安全交换。该技能完整覆盖了门户的核心工作流：凭证上传（Belegübergabe）、已发布文件查询、事务所文档下载（Kanzleidokumente）及会话管理。
显著优点
- 专业场景精准覆盖：针对德语区（尤其是奥地利）税务会计协作场景设计，支持 ER（进项发票）、AR（销项发票）、KA（现金）、SP（银行）四种标准凭证分类，符合当地会计规范。
- 自动化完整闭环：提供 login → upload/query/download → logout 的标准流程，支持无头/有头浏览器模式，既可 CI/CD 集成也可调试排障。
- 灵活的文件操作：支持通配符批量上传、按索引/名称/最新模式下载、ZIP 自动解压，以及 JSON 结构化输出，便于脚本化集成。
- 凭证安全隔离：依赖环境变量管理门户凭据（PORTAL_ID/USER_ID/PASSWORD），避免硬编码风险。
潜在局限
- 地域限制强：专为奥地利 RZL 生态设计，对其他国家/地区的会计门户无兼容性。
- 环境依赖较重：需 Python 3、Playwright 及浏览器二进制文件，部署成本高于纯 API 方案。
- 维护被动性：依赖目标网站 DOM 结构稳定，RZL 门户改版可能导致选择器失效。
- 无原生加密：传输安全依赖目标网站的 TLS，技能本身不提供额外的端到端加密层。
适合人群
- 奥地利中小企业财务负责人或外部会计服务客户
- 需要批量处理会计凭证的自动化运维人员
- 将税务文档交换集成到内部 ERP/文档管理系统的开发者
常规风险
| 风险项 | 说明 |
|--------|------|
| 凭据泄露 | 环境变量需在安全环境中配置，避免提交至版本控制 |
| 会话残留 | 异常退出可能导致浏览器会话未清理，建议配合 logout 或超时机制 |
| 下载路径遍历 | 自定义 `-o` 参数需验证路径合法性，防止覆盖敏感文件 |
| 并发冲突 | Playwright 实例非线程安全，高并发场景需队列化处理 |
总体评估
该技能在特定垂直领域（奥地利 RZL 税务门户自动化）具备高实用价值，技术实现成熟，但适用面较窄，适合有明确地域和业务需求的用户。