名称： vodoo
描述： 通过 vodoo CLI 查询和管理 Odoo ERP 数据（服务台工单、项目、任务、CRM 线索、知识文章）

Vodoo - Odoo 命令行工具

使用 uvx vodoo 通过 XML-RPC 与 Odoo 交互。无需安装，uvx 可直接运行。

重要：始终使用 --no-color

请务必在每个 vodoo 命令后添加 --no-color。 这会禁用 ANSI 转义码，显著减少令牌使用量。

# 正确
uvx vodoo --no-color helpdesk list

# 错误（会因颜色代码浪费令牌）
uvx vodoo helpdesk list

命令概览

服务台工单

# 列出工单
uvx vodoo helpdesk list
uvx vodoo helpdesk list --stage "New"
uvx vodoo helpdesk list --limit 5

# 显示工单详情
uvx vodoo helpdesk show 123

# 添加评论（客户可见）
uvx vodoo helpdesk comment 123 "您的问题已解决"

# 添加内部备注（客户不可见）
uvx vodoo helpdesk note 123 "已升级至开发团队"

# 管理标签
uvx vodoo helpdesk tags                    # 列出可用标签
uvx vodoo helpdesk tag 123 "urgent"        # 为工单添加标签

# 查看历史记录与附件
uvx vodoo helpdesk chatter 123             # 消息历史
uvx vodoo helpdesk attachments 123         # 列出附件
uvx vodoo helpdesk download 456            # 按 ID 下载附件
uvx vodoo helpdesk download-all 123        # 下载所有附件

# 更新字段
uvx vodoo helpdesk fields                  # 列出可用字段
uvx vodoo helpdesk fields 123              # 显示工单字段值
uvx vodoo helpdesk set 123 priority=3      # 设置字段值

# 附件与链接
uvx vodoo helpdesk attach 123 report.pdf   # 附加文件
uvx vodoo helpdesk url 123                 # 获取网页链接

项目任务

# 列出任务
uvx vodoo project-task list
uvx vodoo project-task list --project "Website Redesign"
uvx vodoo project-task list --stage "In Progress"

# 创建任务
uvx vodoo project-task create "修复登录错误" --project "Website"

# 显示任务详情
uvx vodoo project-task show 456

# 评论与备注
uvx vodoo project-task comment 456 "已开始处理此任务"
uvx vodoo project-task note 456 "需要客户澄清"

# 标签
uvx vodoo project-task tags
uvx vodoo project-task tag 456 "backend"
uvx vodoo project-task tag-create "new-tag"
uvx vodoo project-task tag-delete "old-tag"

# 附件与历史记录
uvx vodoo project-task chatter 456
uvx vodoo project-task attachments 456
uvx vodoo project-task attach 456 spec.pdf

# 字段与链接
uvx vodoo project-task fields
uvx vodoo project-task set 456 priority=1
uvx vodoo project-task url 456

项目

# 列出项目
uvx vodoo project list

# 显示项目详情
uvx vodoo project show 789

# 评论与备注
uvx vodoo project comment 789 "项目启动完成"
uvx vodoo project note 789 "预算已批准"

# 历史记录与附件
uvx vodoo project chatter 789
uvx vodoo project attachments 789
uvx vodoo project attach 789 contract.pdf

# 字段与阶段
uvx vodoo project fields
uvx vodoo project set 789 description="更新后的描述"
uvx vodoo project stages              # 列出任务阶段
uvx vodoo project url 789

CRM 线索/商机

# 列出线索
uvx vodoo crm list
uvx vodoo crm list --stage "Qualified"

# 显示线索详情
uvx vodoo crm show 321

# 评论与备注
uvx vodoo crm comment 321 "已安排跟进"
uvx vodoo crm note 321 "决策者：John Smith"

# 标签
uvx vodoo crm tags
uvx vodoo crm tag 321 "hot-lead"

# 历史记录与附件
uvx vodoo crm chatter 321
uvx vodoo crm attachments 321
uvx vodoo crm attach 321 proposal.pdf

# 字段与链接
uvx vodoo crm fields
uvx vodoo crm set 321 expected_revenue=50000
uvx vodoo crm url 321

知识文章

# 列出文章
uvx vodoo knowledge list

# 显示文章
uvx vodoo knowledge show 111

# 评论与备注
uvx vodoo knowledge comment 111 "已为 v2.0 更新"
uvx vodoo knowledge note 111 "需要审核"

# 历史记录与链接
uvx vodoo knowledge chatter 111
uvx vodoo knowledge attachments 111
uvx vodoo knowledge url 111

通用模型操作

适用于特定命令未覆盖的任何 Odoo 模型：

# 读取记录
uvx vodoo model read res.partner --domain "[('is_company', '=', True)]" --fields name,email
uvx vodoo model read res.partner --ids 1,2,3

# 创建记录
uvx vodoo model create res.partner name="ACME Corp" is_company=true

# 更新记录
uvx vodoo model update res.partner 123 phone="+1234567890"

# 删除记录
uvx vodoo model delete res.partner 123

# 调用模型方法
uvx vodoo model call res.partner 123 method_name

安全 / 用户管理

# 创建标准的 Vodoo 安全组
uvx vodoo security create-groups

# 创建 API 服务账户
uvx vodoo security create-user "api-bot" "api-bot@example.com"

# 将用户分配至 Vodoo API 群组
uvx vodoo security assign-bot 456

# 设置/重置用户密码
uvx vodoo security set-password 456 "new-password"

通用选项

大多数命令支持：
- --no-color - AI 使用时必需（紧接在 vodoo 后使用）
- --limit N - 限制结果数量
- --help - 显示命令帮助

字段更新

set 命令支持对数值字段使用特殊运算符：
- field=value - 设置为指定值
- field+=10 - 在当前值上增加
- field-=5 - 在当前值上减少
- field*=2 - 将当前值乘以倍数
- field/=2 - 将当前值除以倍数

使用技巧

1. 始终使用 --no-color 标志（通过移除 ANSI 代码节省令牌）
2. 更新前使用 fields 命令探索可用字段
3. 阶段名称区分大小写，必须完全匹配
4. 如果知道模型的技术名称，model 命令可以访问任何 Odoo 模型