MILKEE Skill

与瑞士会计软件 MILKEE 的完整集成。支持项目、客户、工时追踪、任务及产品的管理。

功能特性

• ⏱️ 工时追踪 — 支持模糊匹配项目名称，一键启停计时器
• 👥 客户管理 — 完整的增删改查（CRUD）操作
• 📋 项目管理 — 创建、更新及预算管理
• ✅ 任务管理 — 追踪项目相关任务
• 📦 产品管理 — 管理可计费项目

快速开始

工时追踪（核心功能）

# 启动计时器（支持智能模糊匹配）
python3 scripts/milkee.py start_timer "Website" "Building authentication"

# 停止计时器（自动同步至 MILKEE）
python3 scripts/milkee.py stop_timer

# 查看今日所有工时记录
python3 scripts/milkee.py list_times_today

项目管理

python3 scripts/milkee.py list_projects
python3 scripts/milkee.py create_project "My Project" --customer-id 123 --budget 5000
python3 scripts/milkee.py update_project 456 --name "Updated" --budget 6000

客户管理

python3 scripts/milkee.py list_customers

# 创建客户（填写全部字段）
python3 scripts/milkee.py create_customer "Example AG" 
  --street "Musterstrasse 1" 
  --zip "8000" 
  --city "Zürich" 
  --phone "+41 44 123 45 67" 
  --email "info@example.ch" 
  --website "https://example.ch"

# 更新指定字段
python3 scripts/milkee.py update_customer 123 --name "New Name" --phone "+41 44 999 88 77"

任务与产品管理

python3 scripts/milkee.py list_tasks
python3 scripts/milkee.py create_task "Implement feature" --project-id 456

python3 scripts/milkee.py list_products
python3 scripts/milkee.py create_product "Consulting Hour" --price 150

配置说明

设置环境变量：

export MILKEE_API_TOKEN="USER_ID|API_KEY"
export MILKEE_COMPANY_ID="YOUR_COMPANY_ID"

或通过网关配置文件，在 skills.entries.milkee.env 路径下进行配置。

获取您的凭证信息

1. 登录 MILKEE → 设置 → API
2. 复制您的 User ID 和 API Key
3. 格式为：USER_ID|API_KEY
4. Company ID 可在设置页面中查看

特色功能

模糊项目匹配

当您输入 “Website” 时，该 Skill 将执行以下操作：

1. 从 MILKEE 获取全部项目列表
2. 基于 Levenshtein 距离进行模糊匹配
3. 自动选择最接近的匹配项
4. 在该匹配项目上启动计时器

计时器状态持久化

• 计时器状态保存于 ~/.milkee_timer
• 跨会话保持有效
• 停止时自动计算已耗时长

每日汇总

list_times_today 命令将显示：

• 今日全部工时条目
• 每条目的持续时间
• 当日总工作时长

技术细节

• 编程语言：Python 3.8+
• 依赖项：无（仅使用标准库）
• 计时器文件：~/.milkee_timer（JSON 格式）
• API 文档：https://apidocs.milkee.ch/api

作者：xenofex7 | 版本：2.0.0