综合评估：KSeF 波兰电子发票会计助手
核心用法
本技能为纯知识型文档集合，专为波兰 KSeF 2.0（Krajowy System e-Faktur）电子发票系统提供会计与税务合规支持。核心能力覆盖六大领域：
1. KSeF 2.0 API 操作指引：提供发票发送/查询、会话令牌管理、离线模式(Offline24)、UPO接收等端点说明及错误处理
2. FA(3) 发票结构解析：详解FA(3)与FA(2)差异（附件支持、员工类型、扩展银行格式、50万条修正限制等），含XML示例
3. 波兰会计分录流程：销售/采购完整账务处理，含应收账款匹配、分割付款机制(MPP)、发票修正及月度关账
4. AI 辅助功能架构：提供成本分类、欺诈检测(Isolation Forest)、现金流预测等机器学习参考实现模式（仅算法说明，无预训练模型）
5. 合规与安全规范：白名单VAT验证、Fernet加密令牌存储、审计追踪、GDPR、RBAC等实施模板
6. JPK_V7 税务申报：销售/采购登记簿及月度/季度JPK_V7M/K生成
显著优点
- 深度本地化：精准匹配波兰财政部KSeF 2.0技术规范，覆盖FA(3)全部结构细节
- 安全设计前置：三重声明
disableModelInvocation（frontmatter camelCase/kebab-case + skill.json），强制用户显式授权；环境变量明确标记secret: true - 风险隔离机制：严格区分DEMO环境（默认）与生产环境，强制用户确认切换
- AI架构参考价值：提供可落地的ML工程模式（Random Forest分类、图分析检测VAT carousel等），降低企业自研成本
- 合规工具链完整：从发票生命周期到税务申报(JPK_V7)、从数据安全到GDPR的全流程覆盖
潜在缺点与局限性
- 纯文档无执行能力：所有代码示例（Python/sklearn/pandas）仅为伪代码演示，用户需自行实现完整系统
- 法律效力依赖人工：明确声明"非法律/税务建议"，关键决策仍需持证税务顾问确认
- 平台安全依赖：
disableModelInvocation等安全标志需宿主平台强制解析，技能本身无法阻止违规调用 - 时效性风险：KSeF法规持续更新（如强制使用期限调整），文档知识可能滞后
- 语言壁垒：核心内容为波兰语，非波兰用户难以直接使用
适合人群
| 用户类型 | 使用场景 |
|---------|---------|
| 波兰企业会计/财务团队 | KSeF 2.0迁移、日常电子发票处理、JPK_V7申报准备 |
| ERP/财务软件开发商 | FA(3) XML生成器开发、KSeF API集成架构设计 |
| 波兰税务顾问 | 为客户提供技术合规咨询时的参考手册 |
| 跨国企业波兰子公司 | 理解本地电子发票法规差异，设计合规工作流 |
| ML工程师（有限适用） | 参考成本分类/欺诈检测算法设计，需自行训练模型 |
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| **平台解析失败** | 宿主未读取`disableModelInvocation`，导致AI自主调用 | 安装前强制检查registry metadata，不匹配则禁用凭证配置 |
| **生产环境误操作** | 用户未验证直接配置`ksef.mf.gov.pl`生产地址 | 强制DEMO测试流程，生产切换需二次确认 |
| **凭证泄露** | 用户在对话中直接粘贴token/密钥（违反设计意图） | 平台需拦截含敏感值的对话输入，强制使用env vars |
| **AI建议误用** | 将参考算法当作已验证模型直接部署 | 文档明确标注"pseudokod pogladowy"，置信度阈值需人工复核 |
| **法规合规失效** | 依据过期文档操作导致税务处罚 | 定期核对`ksef-legal-status.md`更新，关键决策咨询税务师 |
关键使用建议
1. 安装前必做：验证平台registry中disable-model-invocation=true且环境变量标记为secret
2. 永不直接对话凭证：仅通过平台密钥管理器配置KSEF_TOKEN等变量
3. 分阶段验证：DEMO环境全流程测试 → 小规模生产验证 → 全面部署
4. 保持人工终审：AI分类建议(confidence<0.8时)必须人工复核，欺诈标记需调查确认