核心用法
Cozi Skill 是一个基于 Node.js 的非官方命令行客户端，用于与 Cozi Family Organizer 服务交互。用户需配置 COZI_EMAIL 和 COZI_PASSWORD 环境变量完成认证，会话令牌会自动缓存以减少重复登录。
主要功能模块：
- 清单管理：查看、创建、删除购物清单和待办清单；添加、完成、取消完成、删除项目
- 日历操作：查看月份视图、添加预约（含时间、主题、地点、备注）、删除预约
典型工作流：通过 lists 查看清单 → 使用 add 添加项目 → 用 check/uncheck 标记完成状态。日历功能支持快速查看家庭日程和创建带详细信息的预约。
显著优点
1. 命令行自动化：适合开发者和技术用户将家庭事务管理融入脚本工作流
2. 完整功能覆盖：涵盖清单和日历两大核心模块，满足日常家庭组织需求
3. 会话缓存机制：自动缓存认证令牌，减少频繁登录的摩擦
4. 开源生态：基于社区维护的 cozi-api-client 和 py-cozi 项目
潜在缺点与局限性
⚠️ 关键风险：非官方 API，通过逆向工程实现。Cozi 官方随时可能更改接口导致功能失效，且无服务稳定性保障。
- 认证局限：仅支持邮箱/密码登录，无 OAuth 等现代认证方式
- 单用户会话：缓存的会话令牌绑定单一账号，多账户切换不便
- 错误处理：命令行界面简陋，API 变更时的错误提示可能不够友好
- 无官方支持：遇到问题无法通过 Cozi 客服渠道解决
适合人群
- 熟悉命令行的技术用户和开发者
- 需要将 Cozi 数据与其他工具链集成的自动化爱好者
- 接受非官方 API 风险、追求效率优先的家庭管理员
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| API 失效 | 高 | 非官方接口，随时可能因官方变更而中断 |
| 凭据安全 | 中 | 邮箱密码以明文形式存储在 `.env` 文件中，需确保文件权限安全 |
| 数据一致性 | 中 | 非官方客户端可能存在同步延迟或状态不一致 |
| 服务终止 | 中 | Cozi 可能封禁非官方客户端的访问模式 |