技能介绍

解决什么问题

日常维护 Odoo 时，很多操作并不复杂，但总要打开网页、切换模块、找到对应记录才能处理：随手记一条待办、把任务挪到进行中、查看某员工本月工时、更新商机阶段、给会议加提醒。这类操作重复、琐碎，手工点界面效率低，而且离开当前上下文后容易遗漏。

这个技能把辉火云企业套件里高频的六类能力做成统一脚本入口，直接通过 XML-RPC / JSON-RPC 连接公司 Odoo 实例，覆盖 待办、项目、工时单、CRM、活动 和 日历。你不必手写 ORM 调用或记住每个模型的字段差异，调用一个脚本即可完成增删改查和状态流转。

核心能力与工作方式

所有脚本围绕同一套约定组织：每个应用一个入口，使用 add、list、show、update 等子命令；支持 --json 输出，方便集成到其他工具或自动化流程；可用 --tools-md 指定凭据文件路径。

第一次使用必须先初始化凭据，脚本会引导你输入四个关键值：公司系统地址、数据库名、账号、密码或 API Key。保存位置固定在 ~/.huo15/tools.md，权限设为 600。推荐使用 API Key，可以在 Odoo 的偏好设置 → 账户安全中创建并随时吊销。也可以在 CI 环境用 HUO15_ODOO_LOGIN、HUO15_ODOO_SECRET、HUO15_ODOO_DB、HUO15_ODOO_URL 等环境变量临时注入。

连接验证通过 python3 scripts/login.py test 完成。凭据写入失败、账号错误或数据库不对时，脚本会返回中文原因，而不是静默继续。

字段坑与适用边界

Odoo 的字段命名和类型并不总是直观。待办任务使用 project.task，但需要保持 project_id 为 False；截止日期和日历起止时间都是 Datetime / UTC，不是本地 date；任务负责人 user_ids 是 Many2many，必须写成 (6, 0, [ids])；工时单里的小时数来自 unit_amount，amount 是金额；任务工时使用 allocated_hours，老字段 planned_hours 已移除。

CRM 商机必须带 type='opportunity'，赢单、输单和恢复要走 action_set_won、action_set_lost、action_restore，不要手动 write 状态字段。活动里的 date_deadline 是 Date，完成操作是归档而不是删除；日历提醒只支持 notification 和 email。

凭据文件包含明文 secret，不要提交到 git，也不要打印到日志。删除、归档或批量改状态前，脚本会先向用户确认。这些约束看起来繁琐，但保证了操作可追溯、风险可控。