Odoo Reporting

核心用法

Odoo Financial Intelligence 是一个生产级的 Odoo RPC 财务情报工具，专为可验证的财务报告设计。用户通过命令行工具 cfo_cli.py 直接与 Odoo 实例通信，获取会计审计、增值税分析、现金流报告等数据。所有操作默认为只读，关键方法（create、write、unlink）在连接器层面被硬阻断，确保数据安全。

显著优点

1. 数据源权威性：以 Odoo RPC 返回数据为唯一真相源，杜绝 AI 估算或幻觉输出
2. 版本兼容性：支持 JSON-2（Odoo 19+ 推荐）和 XML-RPC 双后端，具备 Odoo 20 前瞻适配
3. 完整证据链：每个数字必须附带方法声明、作用域、假设条件，支持交叉核验
4. 多场景覆盖：summary、cash_flow、vat、trends、anomalies、自然语言查询等标准工作流
5. AI 辅助但受控：AI 仅用于异常叙述、风险评论和措辞优化，不允许替代确定性计算

潜在缺点与局限性

• 依赖 Odoo 可用性：网络中断或 Odoo 服务宕机直接导致失败，无本地缓存兜底
• 认证配置门槛：需正确配置 ODOO_URL、ODOO_DB、ODOO_USER、ODOO_PASSWORD 环境变量
• 本地化复杂性：自定义税设置、多公司架构、时区漂移等场景需人工验证
• 并发数据变更风险：Odoo 数据在多次 API 调用间可能变化，需避免脆弱的多调用逻辑
• 大型数据集性能：极端数据量需手动分页处理，默认模式可能超时

适合人群

• 需要向管理层或审计师提供可溯源财务数字的财务人员
• 使用 Odoo 作为 ERP 的中小型企业主、财务总监
• 开发运维人员需要集成 Odoo 财务数据到自动化报告流程

常规风险

• 数据泄露风险：凭证管理不当可能导致 Odoo 数据暴露，建议使用 API 密钥和最小权限原则
• 误报/漏报风险：复杂业务场景（退款、部分付款、负值冲销）若未正确配置排除规则，可能导致 VAT 或现金流计算偏差
• 时区/货币混淆：跨时区、多币种聚合若未显式声明转换逻辑，易产生隐蔽错误
• AI 幻觉风险：尽管有明确护栏，用户若误将 AI 叙述当作审计结论，可能引发合规问题

最佳实践建议

生产环境务必使用专用机器人用户、API 密钥认证，并在最终报告前执行交叉核验和边缘案例检查清单。

核心功能与定位

Odoo Financial Intelligence 是一款专为 Odoo ERP 系统设计的生产级财务分析 Skill，核心价值在于以 Odoo RPC 数据为唯一可信来源，提供可复现、有据可查的财务报告能力。它并非基于 AI 估算，而是通过直连 Odoo 数据库执行确定性查询，确保审计级数字准确性。

核心用法

1. 财务概览: summary --days 30 快速生成近30天财务状况
2. 现金流分析: cash_flow 追踪资金流入流出
3. VAT 合规报告: vat --date-from YYYY-MM-DD --date-to YYYY-MM-DD 计算销项/进项/净增值税
4. 趋势可视化: trends --months 12 --visualize 生成12个月趋势图表
5. 异常检测: anomalies 规则检测或 anomalies --ai AI 辅助分析
6. 自然语言查询: ask "..." 用自然语言提问获取财务数据
7. 深度 RPC 调用: rpc-call 针对特定模型/方法进行原子级数据抽取

显著优点

• 硬只读安全: 连接器层面对 create/write/unlink 等变更方法实施硬阻断，默认只读，消除误操作风险
• 多协议兼容: 自动检测 Odoo 版本，优先 JSON-2 (Odoo 19+)，兼容 XML-RPC 旧版
• AI 增强但可控: AI 仅用于异常叙事与风险评论，所有结论必须以 Odoo 确定性数据为背书
• 严格的准确性协议: 强制要求范围声明、方法声明、交叉验证、货币完整性检查、边界案例处理
• 多租户隔离: --company-id 参数确保多公司环境数据不串流

潜在局限与注意事项

• 依赖 Odoo 端配置: 需要正确的环境变量 (ODOO_URL, ODOO_DB, ODOO_USER, ODOO_PASSWORD)，且 Odoo 端需开启 RPC 接口
• 网络稳定性要求: 大型数据集需分页读取，不稳定网络可能影响 search_read_all 模式
• 本地化复杂性: 自定义税种/会计科目需前置验证 (fields_get)，否则 VAT 计算可能偏差
• 时区敏感: 月末/年末查询需显式指定 --tz，否则可能出现边界漂移
• 非实时并发: Odoo 数据在多次调用间可能变更，复杂多步逻辑存在事务语义风险

适合人群

• 财务团队: 需要定期 VAT 申报、现金流监控、趋势分析的会计与 CFO
• 审计人员: 需要可复现数字来源、交叉验证能力的内部/外部审计师
• Odoo 管理员: 负责多公司数据隔离、权限最小化配置的系统管理员
• 开发者: 需要在 Odoo 之上构建确定性财务管道的集成工程师

常规风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| 凭证泄露 | `ODOO_PASSWORD` 存储于 `.env` 文件 | 使用 API Key 替代用户密码，文件权限 0600 |

| 中间人攻击 | RPC 通信被截获 | 强制 TLS 1.2+，移除 `--insecure` CLI 选项 |

| 多公司数据串流 | 未指定 `--company-id` 导致跨公司聚合 | 单公司查询时显式隔离 |

| 并发数据变更 | 多次调用间数据被修改 | 优先单方法原子路径，标记 provisional 状态 |

| 子进程注入 | `openclaw agent` 调用潜在风险 | 已使用 `shell=False`，建议验证命令完整性 |

安全认证亮点

经 CLS-Certify v2.1.0 全量扫描，获 S 级/83分 优秀评级：

• 静态分析 85分: 代码结构清晰，只读限制机制完善
• 动态分析 80分: 运行时零写操作，仅调用本地 OpenClaw 代理
• 依赖审计 90分: 仅依赖 requests+matplotlib，无 CVE
• 网络流量 75分: 仅与配置 Odoo 服务器通信，SSL 可验证
• 威胁情报 90分: 无可疑代码模式

三项低风险项均为功能必需（环境变量读取、网络请求、本地子进程调用），均已确认可控。