MILKEE Swiss Accounting

核心用法

MILKEE Skill 是一款专为瑞士企业打造的会计软件集成工具，提供完整的项目管理、客户管理和时间追踪功能。核心使用场景包括：

时间追踪：通过 start_timer 和 stop_timer 命令实现精准的计费和工时管理，支持智能模糊匹配项目（如输入"Website"自动匹配最相近项目）。list_times_today 可查看当日工作汇总。

项目与客户管理：完整的 CRUD 操作支持，包括项目创建（含预算设定）、客户信息全字段维护（地址、联系方式等）。

任务与产品：支持项目任务拆分和可计费产品/服务管理。

显著优点

• 智能匹配：基于 Levenshtein 距离的模糊项目匹配，大幅提升操作效率
• 零依赖：纯 Python 标准库实现，部署简便
• 状态持久化：计时器状态保存至 ~/.milkee_timer，会话间不丢失
• 瑞士本土化：深度集成瑞士主流会计软件 MILKEE

潜在局限

• 地域限制：专为瑞士市场设计，其他地区适用性有限
• 认证格式特殊：API Token 需 USER_ID|API_KEY 格式，非标准 OAuth
• 无多用户协作：计时器基于本地文件，不适合团队同时操作
• 功能边界：专注时间/项目管理，不包含完整财务核算功能

适合人群

• 瑞士中小企业自由职业者和团队
• 需要精确工时计费的顾问、律师、设计师
• 已使用 MILKEE 会计软件的用户

常规风险

• API 密钥安全：Token 需妥善保管，避免硬编码提交
• 数据一致性：本地计时器状态与云端可能因网络问题产生偏差
• 模糊匹配误选：相似项目名称可能导致错误计费项目

核心用法

MILKEE Skill 是专为瑞士企业设计的会计软件集成工具，提供完整的时间追踪、项目管理和客户关系管理功能。用户可通过自然语言指令或命令行脚本与 MILKEE 平台交互。

时间追踪是核心功能：支持智能模糊匹配项目启动计时器（如说 "Website" 自动匹配最相似项目）、一键停止并自动记录工时、查看当日工时汇总。所有计时状态持久化存储在 ~/.milkee_timer，会话间不丢失。

项目管理支持完整的 CRUD 操作，包括创建、更新、预算管理；客户管理涵盖联系信息全字段维护；任务与产品模块支持项目任务追踪和计费项管理。

配置需设置 MILKEE_API_TOKEN（格式：USER_ID|API_KEY）和 MILKEE_COMPANY_ID，凭证从 MILKEE 后台 Settings → API 获取。

显著优点

1. 零依赖安全架构：纯 Python 3.8+ 标准库实现，无第三方包依赖，彻底消除供应链攻击风险
2. 智能交互体验：基于 Levenshtein 距离的模糊项目匹配，无需精确记忆项目名称
3. 本地化状态持久：计时器状态本地 JSON 存储，离线可用，异常恢复能力强
4. 完整功能覆盖：涵盖时间追踪、客户、项目、任务、产品五大模块，满足瑞士中小企业会计全流程需求
5. 传输安全保障：全程 HTTPS/TLS 1.2+ 加密，Bearer Token 认证，符合瑞士数据保护法规

潜在缺点与局限性

1. 地域限定：仅适配 MILKEE 瑞士会计平台，对非瑞士用户无价值
2. 凭证配置门槛：需手动获取并配置 API Token，对非技术用户存在学习成本
3. 无图形界面：纯命令行/脚本交互，依赖 Agent 或终端操作
4. 网络依赖：除计时器本地状态外，核心功能需实时联网调用 MILKEE API
5. 示例凭证风险：文档包含看似真实的示例 Token，存在用户误复制粘贴风险

适合的目标群体

• 瑞士中小企业主/自由职业者：使用 MILKEE 进行会计管理，需简化工时记录流程
• 项目管理者：需要追踪团队项目时间、预算和客户关联
• 远程工作者：依赖时间计费，需精确记录工作时段并自动生成账单依据
• Agent 自动化用户：希望通过 AI Agent 语音/自然语言指令管理日常会计事务

常规使用风险

1. 凭证泄露风险：API Token 以环境变量形式存储，需确保运行环境安全，避免提交至版本控制
2. 本地数据暴露：~/.milkee_timer 文件包含项目名和工作描述，共享设备使用时需手动清理
3. API 可用性依赖：MILKEE 服务中断时将无法同步数据，建议关键操作前确认网络状态
4. 模糊匹配误判：智能项目匹配可能在项目名称相似时选择错误项目，建议首次使用后核对记录
5. 时区与时间精度：依赖系统时间，跨时区或系统时间异常可能导致工时记录偏差