OdooCC基础设置

OdooCC基础设置

为 OdooCC 模块提供统一设置入口，集中维护按公司隔离的 OpenAI 兼容服务配置，并提供受控的文本、结构化 JSON 调用与脱敏审计。

主要能力

• 系统管理员可在“设置 - OdooCC设置 - AI设置”维护按公司隔离的服务商、端点、默认模型、超时、重试和密钥。
• occ.ai.client 提供文本和 JSON Schema 调用接口，检查 OpenAI Chat Completions 兼容响应。
• 默认拒绝非 HTTPS、回环、私网和链路本地端点；显式允许内网时仍由管理员承担合规责任。
• 调用共享总时间预算，限制响应大小和重试次数，并把状态、耗时、用量及哈希写入脱敏审计日志。
• 不保存完整提示词或响应，也不在日志中写入 API 密钥；配置和审计菜单仅对系统管理员开放。

适用边界

目标 Odoo 版本为 20.0，直接依赖 base 和 mail；暂不原生适配 Anthropic、Gemini 或语音协议，也不替代数据脱敏、内容安全和人工审批制度。

安装与升级

1. 确认 Odoo 20、base、mail 和 Python requests 依赖已安装。
2. 备份数据库和附件目录，在测试数据库中安装 occ_basic_setting，再由系统管理员进入“设置 - OdooCC设置 - AI设置 - 模型配置”。
3. 仅填写经审批的 HTTPS OpenAI 兼容端点、默认模型和 API 密钥，使用“测试连接”验证后再启用配置。
4. 升级前在副本中执行模块升级并检查公司隔离、权限拒绝、超时、重试、JSON 校验和脱敏审计。

卸载与边界

卸载前应确认没有其他 OdooCC 模块依赖其模型或客户端；卸载会移除本模块模型、菜单、配置和审计数据。模块不负责供应商账号、模型内容安全、业务提示词脱敏或人工审批。