轻量终端购物清单管家

基于非官方API的Listonic购物清单CLI管理工具，支持列表增删改查与项目状态切换，适合需要自动化购物清单的桌面用户。

基本信息

• 技能名称?listonic
• 中文名称?轻量终端购物清单管家
• 作者?JeremyMahieu
• 分类?效率
• 版本?v1.0.0
• 标签?productivity, automation, api, cli

使用方法

使用说明
核心用法
Listonic Skill 是一款命令行购物清单管理工具，通过反向工程的非官方 API 与 Listonic 服务交互。用户需先在 ~/.openclaw/credentials/listonic/config.json 配置认证信息（支持 refreshToken 或 email/password 模式），随后可通过 lists 查看所有清单、、 items > 查看项目、、 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 服务条款，企业环境需评估合规性