---
name: huo15-huihuo-suite
displayName: 辉火套件ERP
description: >-
  Use this skill whenever the user wants to manage their work in the 火一五/辉火云
  company Odoo system (www.huo15.com, db=huo15) — to-dos / tasks ("记个待办"
  "加任务" "我的待办"), projects, timesheets ("记工时"), CRM leads & opportunities
  ("新建商机" "跟进客户" "销售管道"), follow-up activities & reminders ("提醒我"
  "3天后回访"), calendar events & meetings ("安排会议" "我这周日程" "提前30分钟提醒"),
  knowledge-base articles ("查/写知识库" "产品手册"), or document files ("找文档"
  "上传文件"). Also accounting ("发票" "账单" "付款" "科目"), and HR operations —
  employees ("员工" "部门"), attendance ("考勤" "签到" "签退"), time off ("请假" "休假"),
  expenses ("报销"). Also a one-stop "我今天/本周要做什么" briefing. Triggers on odoo,
  辉火云企业套件, 公司系统, /odoo/to-do /project /timesheets /crm /calendar
  /knowledge /documents /sale /purchase /inventory /invoices /hr, or "登录公司系统/保存 odoo 账号". Treat bare work-context
  mentions of 待办/任务/项目/工时/客户/商机/会议/日程/提醒/知识库/文档/销售/采购/库存/订单/发货/收货/发票/账单/付款/科目/员工/部门/考勤/签到/签退/请假/休假/报销 as this skill.
  First run: login.py init (地址/数据库/账号/认证方式/凭据 → ~/.huo15/tools.md). Pure
  standard library, zero dependencies. 推荐使用 API Key（Odoo 用户设置→安全→API密钥→新增）而非登录密码。
version: 1.8.0
aliases:
  - 火一五odoo技能
  - 火一五Odoo技能
  - 辉火云odoo
  - odoo待办
  - odoo项目
  - odoo工时单
  - 公司系统待办
  - 公司系统项目
  - 公司系统工时单
  - 公司系统CRM
  - odoo商机
  - odoo-crm
  - 销售管道
  - 客户管理
  - 商机管理
  - 活动管理
  - odoo日历
  - 日程安排
  - 会议提醒
  - 公司系统日历
  - 待办事项
  - 记待办
  - 加任务
  - 跟进客户
  - 提醒我
  - 安排会议
  - 记工时
  - 知识库
  - odoo文档
  - 产品手册
  - 我今天要做什么
  - 本周安排
  - huo15-odoo
  - huo15-suite
  - 辉火套件ERP
  - 辉火套件
  - 辉火ERP
  - odoo销售
  - odoo采购
  - 库存查询
  - 销售订单
  - 采购订单
  - odoo会计
  - odoo发票
  - 供应商账单
  - 客户付款
  - 会计科目
  - odoo员工
  - 公司系统考勤
  - odoo请假
  - odoo报销
  - 员工管理
  - 统一提醒
  - 到点提醒
  - 心跳巡检
  - 提醒我开会
  - 提醒我回访
dependencies:
  python-packages: []   # 纯标准库，无第三方依赖
---

# 辉火套件ERP

通过 XML-RPC / JSON-RPC 操作公司 Odoo 系统（**辉火云企业套件**，www.huo15.com，db=`huo15`）。
十五大能力：**待办**、**项目**、**工时单**、**CRM**、**活动**、**日历**、**知识库**、**文档**、**销售**、**采购**、**库存**、**会计**（/odoo/invoices）、**人力资源**（/odoo/hr），外加 `briefing.py` 每日/每周总览、`reminder.py` 统一提醒入口、`heartbeat_check.py` 心跳巡检。

> **完整命令** → [references/commands.md](references/commands.md)
> **API/字段细节** → [todo](references/odoo-todo-api.md) · [project](references/odoo-project-api.md) · [timesheet](references/odoo-timesheet-api.md) · [crm](references/odoo-crm-api.md) · [activity+calendar](references/odoo-activity-calendar-api.md) · [calendar-advanced](references/odoo-calendar-advanced-api.md) · [knowledge+documents](references/odoo-knowledge-documents-api.md) · [sales+purchase+stock](references/odoo-sales-purchase-stock-api.md) · [accounting](references/odoo-accounting-api.md) · [hr](references/odoo-hr-api.md)

## 触发场景

- "帮我登录公司系统" / "连一下 odoo" / "保存我的 odoo 账号"
- "新建一个待办：xxx，截止周五" / "把待办 123 标记完成" / "看我的待办"
- "看一下 X 项目" / "给 X 项目加个任务" / "把任务移到进行中" / "改任务负责人"
- "统计这个月每个员工的工时" / "看 X 项目的工时" / "研发部本月工时报表"
- "看我的商机/销售管道" / "新建商机" / "把商机标记赢单/输单" / "线索转商机" / "按阶段统计 pipeline"
- "看我的活动/待跟进" / "给这个商机加个3天后回访" / "我这周有什么日程/会议" / "建个会议提醒我" / "提前30分钟提醒"
- "查/写知识库" / "产品手册放哪" / "找个文档/上传文件" / "**我今天要做什么**" / "本周安排"
- "建个报价单/销售订单" / "确认这个订单" / "建采购单/询价单" / "查 X 产品库存还有多少" / "看待收货/待发货" / "验证出入库"
- "列出发票/账单" / "建客户发票" / "建供应商账单" / "过账发票" / "登记付款" / "查未付款发票" / "看账簿/科目"
- "列出员工" / "查部门" / "看考勤记录" / "签到/签退" / "建请假" / "批准请假" / "建报销" / "提交报销" / "批准报销" / "过账报销"

---

## ⚠️ 第一步：凭据初始化（首次必做）

所有脚本都依赖已保存的凭据。**没配过就先初始化这 5 项，别直接跑 todo/project/timesheet。**

| # | 输入项 | 示例 | 说明 |
|---|---|---|---|
| ① | 公司系统地址 | `www.huo15.com` | 只输域名即可，脚本自动补 `https://` |
| ② | 数据库 | `huo15` | 数据库名 |
| ③ | 账号 | 邮箱 / 用户名 | 登录账号 |
| ④ | 认证方式 | API Key（推荐）/ 密码 | ⭐ **推荐 API Key**（偏好设置→账户安全→新建，可随时吊销） |
| ⑤ | 凭据密钥 | API Key 或登录密码 | 对应上一步选择的认证类型 |

保存到 `~/.huo15/tools.md`（权限 600）。

### 方式 A：Claude 代配（默认，在对话里完成）

1. 在对话里**依次问用户这 5 项**（地址 / 数据库 / 账号 / 认证方式 / 凭据），不要自己编。
2. 用 stdin 传凭据（避免明文进 shell 历史 / ps），**默认推荐 API Key**：

```bash
# 推荐：API Key（用户从 Odoo 偏好设置→账户安全→新建 API 密钥）
printf '%s' "<用户输入的 API Key>" | python3 scripts/login.py set \
    --url www.huo15.com --db huo15 --login "<账号>" --auth-type apikey --secret-stdin

# 如用户坚持用密码：
printf '%s' "<用户输入的密码>" | python3 scripts/login.py set \
    --url www.huo15.com --db huo15 --login "<账号>" --auth-type password --secret-stdin
```

> `--auth-type` 默认 `apikey`；明确指定 `password` 才用密码。

### 方式 C：企微聊天一键保存 API Key（快捷）

用户直接在企微聊天中输入 Odoo 账号和 API Key，由 Agent 自动完成配置。

**自动检测工作区**：脚本会自动检测当前是否在 OpenClaw 独立工作区内（如 `workspace-wecom-default-dm-wanghui`），
每个用户的 Key 保存到该用户工作区目录下，多用户之间互不干扰。

```bash
# Agent 在对话中收到用户的 API Key 后调用
printf '%s' "<用户的 API Key>" | python3 scripts/login.py save-key \
    --login "<Odoo 账号>"
# save-key 固定使用 API Key 认证，自动检测当前工作区
```

> 用户发"保存我的 Odoo Key，账号=xxx" → Agent 接收 → `login.py save-key` 验证 → 落盘到当前工作区。

### 方式 B：用户自助初始化（凭据不回显）

```bash
python3 scripts/login.py init     # 交互式，依次提示 ①地址 ②数据库 ③账号 ④认证方式(默认API Key) ⑤凭据
```

login.py 会**先验证连接成功才落盘**，写入 `~/.huo15/tools.md`（权限 600）；失败报中文原因（账号错 / db 错 / 网络）。验证：`python3 scripts/login.py test`。

> 凭据文件默认 `~/.huo15/tools.md`，可用环境变量 `HUO15_TOOLS_MD` 改路径。
> 临时/CI 可用环境变量免落盘：`HUO15_ODOO_LOGIN` / `HUO15_ODOO_SECRET` / `HUO15_ODOO_DB` / `HUO15_ODOO_URL` / `HUO15_ODOO_AUTH_TYPE`。
> **此文件含明文凭据，务必不要提交 git。**

---

## 四大应用速览

每个应用一个脚本，风格统一（`add`/`list`/… 子命令，名字可代 id，`--json` 输出，`-h` 看完整参数）。
**完整命令示例 → [references/commands.md](references/commands.md)；字段/API 细节 → 各 `references/odoo-<app>-api.md`。**

| 应用 | 脚本 | 核心模型 | 主要子命令 |
|---|---|---|---|
| 📝 待办 `/odoo/to-do` | `todo.py` | project.task（私有态） | `add` `list` `done` `reopen` `cancel` `update` `stages` |
| 📁 项目 `/odoo/project` | `project.py` | project.project + task | `list` `show` `add` `edit` `archive` `tasks` `task-add` `task-move` `task-assign` `task-done` |
| ⏱️ 工时单 `/odoo/timesheets` | `timesheet.py` | account.analytic.line | `by-employee` `by-project` `by-month` `detail` `log` |
| 💼 CRM `/odoo/crm` | `crm.py` | crm.lead（线索/商机） | `list` `show` `add` `move` `won` `lost` `restore` `convert` `pipeline` `activity` |
| 🔔 活动 My Activities | `activity.py` | mail.activity | `list` `add` `done` `cancel` `reschedule` |
| 📅 日历 `/odoo/calendar` | `agenda.py` | calendar.event + alarm + attendee | `list` `show` `add` `update` `cancel` `remind` `invite` `attendees` `rsvp` `busy`（含重复事件/忙闲查询） |
| 📚 知识库 `/odoo/knowledge` | `knowledge.py` | knowledge.article | `list` `search` `show` `add` `fav` `tree` `move` |
| 📁 文档 `/odoo/documents` | `documents.py` | documents.document | `folders` `list` `search` `upload` `link` `tags` `tag` |
| 🛒 销售 `/odoo/sale` | `sales.py` | sale.order | `list` `show` `add` `confirm` `cancel` `invoice` |
| 🛍️ 采购 `/odoo/purchase` | `purchase.py` | purchase.order | `list` `show` `add` `confirm` `approve` `cancel` `bill` |
| 📦 库存 `/odoo/inventory` | `stock.py` | stock.quant/picking/move | `qty` `pickings` `show` `validate` `locations` `warehouses` |
| 💰 会计 `/odoo/invoices` | `accounting.py` | account.move/payment/journal/account | `invoices` `show` `add` `bill` `post` `cancel` `draft` `journals` `accounts` `pay` `payments` |
| 👤 人力资源 `/odoo/hr` | `hr.py` | hr.employee/department/attendance/leave/expense | `employees` `emp-show` `departments` `attendance` `check-in` `check-out` `leaves` `leave-add` `leave-approve` `leave-refuse` `expenses` `expense-add` `expense-submit` `expense-approve` `expense-post` |
| 🗓️ 每日总览 | `briefing.py` | 聚合待办+活动+会议 | `briefing.py [today\|week]` —— 一站式「我今天/本周要做什么」 |
| ⏰ 统一提醒 | `reminder.py` | 自动判断建 activity/calendar event/todo | `create` `due` `list` `done` `cancel` —— 「提醒我…」统一入口 |
| 💓 心跳巡检 | `heartbeat_check.py` | 聚合逾期+今日+即将开始 | `heartbeat_check.py [--imminent 30m] [--overdue-only] [--json]` —— OpenClaw 心跳专用 |

下方「命令速查」给最常用命令的具体写法，够日常用；要完整参数/示例读 [references/commands.md](references/commands.md)。

---

## 命令速查

| 想做 | 命令 |
|---|---|
| 初始化(交互) | `python3 scripts/login.py init` —— 提示输入 地址/数据库/账号/密码 |
| 配登录(代配) | `printf '%s' "$PWD" \| python3 scripts/login.py set --url www.huo15.com --db huo15 --login X` |
| 测连接 | `python3 scripts/login.py test` |
| 新建待办 | `todo.py add --title ... [--deadline --priority --stage --tags]` |
| 我的待办 | `todo.py list` |
| 完成待办 | `todo.py done <id>` |
| 项目列表/详情 | `project.py list` / `project.py show <id>` |
| 建项目/任务 | `project.py add --name ...` / `project.py task-add --project <id> --title ...` |
| 移阶段/改负责人 | `project.py task-move <id> --stage X` / `task-assign <id> --users a,b` |
| 工时汇总 | `timesheet.py by-employee\|by-project\|by-month [--month/--from/--to]` |
| 工时明细 | `timesheet.py detail --employee X --month YYYY-MM` |
| CRM 商机 | `crm.py list` / `crm.py add --name ... --customer ... --revenue N --user 我` |
| 赢/输/管道 | `crm.py won\|lost <id>` / `crm.py pipeline --by stage\|user\|team` |
| 活动/提醒 | `activity.py list` / `activity.py add --model crm.lead --id N --type call --date ...` |
| 日历/会议 | `agenda.py list` / `agenda.py add --name ... --start "... HH:MM" --with X --remind 30m` |
| 重复/忙闲 | `agenda.py add ... --repeat weekly --on mon --count 52` / `agenda.py busy --who X --date Y` / `agenda.py attendees <id>` |
| 知识库 | `knowledge.py search <kw>` / `knowledge.py add --title ... --icon 📘` / `knowledge.py show <id>` |
| 文档 | `documents.py folders` / `documents.py upload --file <path> --folder X` / `documents.py link <id>` |
| 每日总览 | `briefing.py` / `briefing.py week` —— 聚合待办+活动+会议「我今天要做什么」 |
| 统一提醒 | `reminder.py create --title "开会" --when "2026-08-05 09:00" --remind 15m` —— 精确时间提醒 |
|  | `reminder.py create --title "回访" --model crm.lead --id 88 --date 2026-08-06` —— 关联业务提醒 |
|  | `reminder.py due --within 60m` / `--overdue` / `--today` —— 查到期提醒 |
| 心跳巡检 | `heartbeat_check.py` —— 逾期+今日+即将开始（默认30分钟内会议）；`--json` 供 OpenClaw 解析 |
| 销售/采购 | `sales.py add --customer X --line "产品:数量"` / `purchase.py add --vendor X --line ...` / `confirm <id>` |
| 库存 | `stock.py qty <产品>` / `stock.py pickings --in\|--out` / `stock.py validate <id>` |
| 会计 | `accounting.py invoices --unpaid` / `accounting.py add --customer X --line "产品:数量"` / `accounting.py bill --vendor X --line ...` / `accounting.py post <id>` / `accounting.py pay --partner X --amount N --type inbound` / `accounting.py journals` / `accounting.py accounts` |
| 人力资源 | `hr.py employees --department X` / `hr.py attendance --employee X --from --to` / `hr.py check-in` / `hr.py leave-add --employee X --type 年假 --from --to` / `hr.py leave-approve <id>` / `hr.py expense-add --employee X --amount N` / `hr.py expense-submit <id>` / `hr.py expense-post <id>` |

所有脚本支持 `--json` 输出、`--tools-md <path>` 指定凭据文件。

---

## 字段坑速查（最容易错，改脚本前必看）

| 坑 | 正确做法 |
|---|---|
| 待办放哪 | `project.task` 且 **不传 project_id**（保持 False）+ `user_ids` 含本人 |
| 截止日期 | `date_deadline` 是 **Datetime / UTC**，不是 date（脚本已自动本地→UTC） |
| 完成状态 | `state='1_done'`；取消 `'1_canceled'`；进行中 `'01_in_progress'`；等待 `'04_waiting_normal'` |
| 任务负责人 | `user_ids` 是 **Many2many**，写 `[(6,0,[ids])]`；不是 user_id |
| 分配工时 | 任务用 `allocated_hours`，**不是 planned_hours**（19 已删） |
| 工时小时数 | 工时单求和用 `unit_amount`（不是 amount，amount 是钱） |
| 是不是工时单 | 没有 is_timesheet 字段，判定 `('project_id','!=',False)` |
| 分组统计 | `read_group` 多 groupby 必须 `lazy=False`；优先 `formatted_read_group`（脚本已封装） |
| 个人阶段筛选 | `personal_stage_type_id` 无 search，按阶段筛走 `project.task.stage.personal` 关联表（脚本已处理） |
| CRM 赢/输单 | 建商机必传 `type='opportunity'`；负责人 `user_id` 单数；赢/输/复活调 `action_set_won/lost/restore`，别手动 write |
| CRM 字段 | 手机号写 `phone`（无 mobile）；`crm.stage.team_ids` 复数 m2m（空=全团队）；`description` 是 Html |
| 活动 | `date_deadline` 是 **Date**；完成=archive(`action_feedback`)不是删；`state` computed 无 search，查逾期用 `date_deadline` 比较 |
| 日历 | `start/stop` 是 **Datetime/UTC**（脚本自动转）；写 `partner_ids` 自动建参与人；alarm 只有 notification/email |
| 日历重复/忙闲 | 重复走 calendar.event(`recurrency=True`)，rrule 只读用结构化字段；改重复带 `recurrence_update`(all 不能改时间)；忙闲用区间重叠+`show_as=busy`；crm 用 `opportunity_id` 关联 |
| 知识库 | 根文章必有 internal_permission(create 自动补 write)；收藏 `action_toggle_favorite`；移动 `move_to`；权限走方法非直接写 member |
| 文档 | **19 版文件夹=document(type=folder)**，无 documents.folder/share；上传直接传 datas(base64)；下载用 access_token；建标签需管理员 |
| 销售/采购 | state 无 done(用 locked)；销售行 `product_uom_qty`+`product_uom_id`+`tax_ids`，采购行 `product_qty`；确认是写操作建交货/入库单；采购删除前先 cancel |
| 库存 | 查库存用 product `free_qty`/`qty_available`(限仓库走 context)；明细 `move_ids`(无 \_without_package)；完成量 `quantity`(非 qty_done)；validate 必传 `skip_backorder` |
| 会计 | account.move.state 只有 draft/posted/cancel(无 done)；move_type 区分发票(out_invoice)/账单(in_invoice)/退款(out_refund/in_refund)；金额全 compute(由 invoice_line_ids 算)不可直接 write；payment_state: not_paid/in_payment/paid/partial/reversed/blocked；payment 创建需 payment_type+partner_type+amount+partner_id+journal_id，创建后需 action_post |
| 人力资源 | 考勤签到/签退走 hr.employee._attendance_action_change(不直接建 hr.attendance)；请假用 request_date_from/to(Date)非 date_from/to(Datetime,compute)；number_of_days 是 compute(由工作日历算)不可直接 write；v19 报销无 sheet(直接操作 hr.expense)；报销 action_post 建会计凭证不可逆 |

> 这些都已在脚本里处理对。手工写新调用 / 改脚本时对照本表和 references/。

---

## OpenClaw 主动提醒集成

本技能与 OpenClaw 心跳（HEARTBEAT）和 cron 深度集成，实现「龙虾主动提醒你」而非「你问才查」。

### 决策树：用户说"提醒我…"时

```
用户说"提醒我明天9点开会"
→ 有精确时间 → reminder.py create --title "开会" --when "明天 09:00" --remind 0m
  （建 calendar.event + alarm，到点推送）

用户说"3天后回访客户"（关联了商机）
→ 关联业务 → reminder.py create --title "回访客户" --model crm.lead --id 88 --date 3天后
  （建 mail.activity 挂在商机上）

用户说"提醒我周五前交报告"
→ 只有日期 → reminder.py create --title "交报告" --date 周五
  （建 project.task 待办 + 截止日）
```

### 心跳巡检（HEARTBEAT）

在 HEARTBEAT.md 中加入辉火云巡检清单：

```markdown
## 🔔 辉火云巡检（每次心跳）
- [ ] 跑 `python3 scripts/heartbeat_check.py --json` 查看今日待办/活动/会议
- [ ] 有逾期项 → 主动提醒用户
- [ ] 有 30 分钟内开始的会议 → 主动提醒
- [ ] 无事项 → 静默，不打扰
```

### Cron 定时（精确时间点）

心跳间隔不够精时，用 cron 兜底：

| 时间 | 命令 | 说明 |
|---|---|---|
| 每天 08:30 | `briefing.py today` | 早间总览：今日待办+活动+会议 |
| 每天 17:30 | `briefing.py` | 晚间检查：明日待办 |
| 每小时 | `heartbeat_check.py --imminent 60m --json` | 检查一小时内到期的会议 |

### 输出格式

`heartbeat_check.py` 精简输出示例：
```
🗓️  巡检结果（2026-08-04）

📝 今日待办（2）
  🔴  #1234  08-03 18:00  高    跟进三和红木分账
  🔴  #1236  08-04 09:00  紧急 写周报

🔔 今日活动（1）
  🟡  #201  08-04  电话  某客户   回访报价

📅 即将开始（1）
  #88  14:30-15:30  方案评审       会议室A

合计 4 项（待办 2 / 活动 1 / 会议 1）
```

`--json` 输出供 OpenClaw 直接解析决策：有 `total > 0` → 主动告知用户；`total == 0` → 静默。

---

## 品牌口径

- **对外**（PRD/汇报/客户文档）：辉火云企业套件 / 辉火云。
- **对内调试 / 本技能文档 / 代码注释**：可用 odoo 等真实技术标识符。
- 版权：青岛火一五信息科技有限公司。

## 安全红线

1. 凭据写入对应工作区的 `.huo15/tools.md`（权限 600），不同用户之间相互隔离，**永不进 git / commit / 日志**。
2. secret 传参优先 `--secret-stdin`，避免明文进 shell 历史。
3. 推荐 API Key 而非主密码（可吊销）。
4. 删除/归档/批量改状态前向用户确认。

## 🚫 禁止直读 tools.md / 禁止跳过脚本

**永远不要**用 `cat` / `read_file` / 任何方式直接读取 `~/.huo15/tools.md` 或工作区内的 `.huo15/tools.md`。

- **原因**：tools.md 是 markdown + YAML 混合格式，LLM 手动解析必定失败（不是 key=value，不是纯 JSON）。
- **必须使用技能提供的 Python 脚本**：
  - 保存 API Key → `python3 scripts/login.py save-key --login <账号>`
  - 配置凭据 → `printf '%s' "<Key>" | python3 scripts/login.py set --login <账号> --auth-type apikey --secret-stdin`
  - 测试连接 → `python3 scripts/login.py test`
  - 查待办 → `python3 scripts/todo.py list`
  - 查项目 → `python3 scripts/project.py list`
- 所有脚本自带 `_parse_block()` 正确解析 tools.md 格式，**LLM 不要自己尝试解析**。
- 也禁止试图用 `xmlrpc.client` / `requests` / `urllib` 直连 Odoo——走脚本。