listonic

核心用法

Listonic Skill 是一款命令行购物清单管理工具，通过反向工程的非官方 API 与 Listonic 服务交互。用户需先在 ~/.openclaw/credentials/listonic/config.json 配置认证信息（支持 refreshToken 或 email/password 模式），随后可通过 lists 查看所有清单、、items <list>> 查看项目、、add-item 添加商品、、check-item//uncheck-item 切换完成状态，以及 delete-item 或 delete-list` 执行删除操作。支持通过名称或 ID 定位列表，并可输出原始 JSON 便于脚本集成。

显著优点

1. 零外部依赖：仅使用 Python 标准库（urllib、argparse、json 等），无 pip 安装负担，部署极轻量
2. 认证灵活：同时支持 OAuth refreshToken（推荐，兼容 Google 登录）和传统邮箱密码模式
3. 交互友好：列表名称支持模糊匹配，无需记忆数字 ID；命令设计符合直觉，学习成本低
4. 安全透明：代码完全开源可审计，无隐蔽数据收集，HTTPS 全程加密通信

潜在缺点与局限性

• API 稳定性风险：依赖非官方反向工程接口，Listonic 官方随时可能变更协议导致功能失效
• 功能边界：无法实现官方 App 的全部特性（如商品图片、价格追踪、位置提醒等）
• 无实时同步：CLI 操作后需手动刷新移动端才能看到更新，非双向实时同步
• 错误恢复有限：API 变更或网络异常时，用户需自行排查或等待社区修复

适合的目标群体

• 习惯终端工作流的开发者/技术用户
• 需要将购物清单集成到自动化脚本（如智能家居、定时任务）的场景
• Listonic 移动端用户希望在桌面端快速批量管理清单
• 追求极简工具、反感臃肿官方客户端的用户

使用风险

• 服务中断风险：非官方 API 无 SLA 保障，关键业务场景不宜强依赖
• 凭据泄露风险：本地明文存储 token/密码，需确保文件权限（建议 chmod 600）
• 误操作风险：delete 操作不可逆，虽文档建议二次确认，但 CLI 环境下仍可能手滑
• 隐私合规：反向工程 API 的使用可能违反 Listonic 服务条款，企业环境需评估合规性

核心用法

Listonic skill 通过逆向工程的非官方 API 与 Listonic 购物清单服务交互，提供完整的购物列表管理能力。用户需先在 ~/.openclaw/credentials/listonic/config.json 配置认证信息，支持 refresh token（推荐，兼容 Google 登录）或邮箱密码两种模式。

主要功能流程：
1. lists 查看所有购物清单
2. items <列表名或ID> 查看清单内物品
3. add-item <列表> "物品名" 添加物品，支持 --amount 和 --unit 参数
4. check-item / uncheck-item 切换完成状态
5. delete-item 删除物品（需用户确认）
6. add-list / rename-list / delete-list 管理清单本身

高级特性：--json 参数可输出原始 JSON，便于脚本集成。

显著优点

• 功能完整：覆盖购物清单的全生命周期管理，从创建到删除、从添加到完成标记
• 认证灵活：同时支持 OAuth refresh token（兼容社交登录）和传统邮箱密码
• 使用便捷：支持列表名称模糊匹配，无需记忆数字 ID
• 依赖极简：纯 Python 标准库实现，无第三方依赖，供应链攻击面极小
• 数据安全：所有通信使用 HTTPS，凭证本地存储无硬编码

潜在缺点与局限性

| 方面 | 说明 |

|------|------|

| **API 稳定性** | 非官方逆向工程 API，Listonic 官方随时可能变更接口导致功能失效 |

| **功能边界** | 无法同步官方 App 的某些高级功能（如智能分类、价格追踪） |

| **配置门槛** | 获取 refresh token 对普通用户有一定技术门槛，文档指引可更详细 |

| **硬编码凭证** | 包含 Listonic 应用的默认 client_id/secret（虽为公开值） |

适合人群

• 现有 Listonic 用户：已在使用该应用，希望获得命令行/脚本化管理能力
• 效率工具爱好者：喜欢通过终端快速操作，避免打开手机的场景
• 自动化需求者：需要结合 --json 输出将购物清单集成到个人工作流

常规风险

1. 服务中断风险：非官方 API 随时可能失效，建议避免用于关键业务场景
2. 数据一致性：API 变更可能导致本地与官方 App 数据不同步
3. OAuth token 安全：refresh token 需妥善保管，配置文件权限建议设为 600
4. 误操作风险：delete-item 和 delete-list 为破坏性操作，务必确认后再执行

---

综合评分：功能实用性高，但受限于非官方 API 的固有不稳定性，建议作为便利工具而非核心依赖。