核心用法
Cozi Skill 是一个非官方的家庭组织工具客户端，基于逆向工程实现的 Cozi Family Organizer API 封装。用户需配置 COZI_EMAIL 和 COZI_PASSWORD 环境变量完成身份认证，系统会自动缓存会话令牌避免重复登录。
主要功能覆盖三大模块：
- 清单管理：查看、创建、删除购物清单或待办清单；添加、勾选、取消勾选、删除具体项目
- 日程管理：查看月度日历视图，创建带起止时间、地点、备注的预约事件，删除特定日程
- 会话管理：本地缓存令牌至
.session.json，过期后自动重新认证
显著优点
1. 家庭场景深度适配：Cozi 本身是专为家庭协作设计的工具，该 skill 继承了共享清单、统一日程的核心价值
2. 命令行原生体验：适合开发者或习惯终端操作的用户，支持快速批量操作
3. 自动化潜力：可集成至 shell 脚本或定时任务，实现清单自动同步、日程提醒等场景
4. 会话缓存机制：减少重复认证开销，提升调用效率
潜在缺点与局限性
1. API 非官方性质：明确声明为逆向工程实现，Cozi 官方可能随时变更接口导致功能失效
2. 无服务等级保障：无官方支持渠道，故障排查依赖社区或自行分析
3. 认证方式单一：仅支持邮箱密码登录，不支持 OAuth、双因素认证等现代安全机制
4. 数据范围受限：无法访问部分 Cozi 高级功能（如食谱管理、日记等模块）
5. 错误处理简略：命令行工具形态决定了错误反馈以原始形式呈现，用户体验不及官方应用
适合人群
- 习惯命令行操作的技术用户
- 需要将 Cozi 数据与其他本地工具链集成的开发者
- 寻求家庭协作数据自动化处理方案的高级用户
- 对官方移动应用体验不满意、偏好脚本化管理的效率追求者
常规风险
- 服务中断风险：非官方 API 随时可能失效，建议避免用于关键业务场景
- 凭证安全风险：密码以环境变量形式存储，需确保
.env文件权限控制严格（建议 600 权限） - 数据一致性风险：本地缓存令牌可能与服务器状态不同步，极端情况下可能操作过期数据
- 隐私合规风险：逆向 API 的数据传输未经过官方安全审计，敏感家庭信息建议评估后再使用