plant-tracker

🌱 零依赖的本地智能园艺管家

基于 Python 标准库构建的本地植物管理工具,支持多场景园艺追踪与数据导出,零外部依赖保障隐私安全。

收藏
1.9k
安装
684
版本
v1.0.0
CLS 安全性认证2026-05-19
点击查看完整报告 >

使用说明

核心用法

Plant Tracker 是一款面向个人用户的植物与花园管理工具,通过命令行界面实现结构化的植物追踪与养护日程管理。用户可通过 add 命令添加植物并记录物种、位置、种植日期等元数据;使用 care 命令记录浇水、施肥、修剪、收获等养护行为;借助 listsearch 命令快速检索植物状态;通过 export 将数据导出为备份文件。工具支持室内植物、蔬菜园、花卉园及多地点花园等多种使用场景,数据以 JSON 格式本地存储于 ~/.openclaw/workspace/plants_db.json

显著优点

1. 零依赖架构:仅使用 Python 标准库(json、argparse、pathlib 等),无外部包依赖,部署简单且攻击面极小。
2. 完善的安全设计:export 功能内置 is_safe_path()() 验证机制,严格限制写入路径为工作目录、家目录及 /tmp,主动阻断系统敏感路径和配置文件写入。

3. 场景覆盖全面:从单盆室内绿植到多床蔬菜园,再到社区花园分块管理,提供差异化的追踪模板和最佳实践指导。

4. 数据主权归属:所有数据本地存储,无网络传输,用户完全掌控自己的园艺记录。

5. 可追溯的养护历史:每条 care 记录包含时间戳与备注,支持长期生长规律分析与产量优化。

潜在缺点与局限性

  • 无跨设备同步:数据仅存储于单台设备,多终端用户需手动迁移 JSON 文件。
  • 缺乏协作功能:不支持多用户共享或权限管理,团队园艺场景适用性有限。
  • 无可视化界面:纯命令行交互,对非技术用户存在一定学习门槛。
  • 无智能提醒:未集成定时任务或通知系统,需用户主动查询养护日程。
  • 数据格式依赖:JSON 存储虽便于备份,但大规模数据下的查询效率未经验证。

适合的目标群体

  • 家庭园艺爱好者与室内植物收藏者
  • 自耕农与阳台蔬菜种植者
  • 需要系统记录植物生长周期的科研或教育用途
  • 注重数据隐私、偏好本地工具的技术型用户

使用风险

  • 数据丢失风险:本地存储无自动云备份,设备故障可能导致记录丢失,建议定期执行 export 备份。
  • 路径限制认知:用户需知晓 export 仅支持特定目录,尝试写入其他位置将触发阻断。
  • 长期维护依赖:作为个人开发者项目(T3 来源),未来更新与兼容性保障存在不确定性。

安全解读

核心用法

Plant Tracker 是一款面向家庭园艺者的本地命令行植物管理工具。用户可通过简洁的 CLI 界面完成植物信息录入(名称、物种、位置、种植日期)、养护记录(浇水、施肥、修剪、采收等 9 类动作)、跨维度搜索(支持名称、物种、位置、养护备注模糊匹配)以及数据导出(JSON/Markdown 格式)。

典型工作流
1. 建档阶段add 命令录入植物基础信息,建议采用 "品种-具体名" 格式命名

2. 日常养护care 命令记录具体动作与观察笔记,形成时间轴式的养护日志

3. 周期复盘list/search 查看植物状态,结合位置筛选实现多花园管理

4. 数据安全export 定期备份至指定安全目录

显著优点

  • 零外部依赖:仅使用 Python 标准库,无第三方包引入供应链风险
  • 路径安全加固export 功能实现严格的 is_safe_path 验证,白名单限制为工作区、家目录及 /tmp,明确阻断系统路径与敏感 dotfile 写入
  • 隐私优先设计:纯本地 JSON 存储(~/.openclaw/workspace/plants_db.json),无网络请求、无云端同步、无用户数据收集
  • 结构化数据模型:每株植物完整记录名称、物种、位置、种植日期及带时间戳的养护历史,便于长期追踪与数据迁移
  • 多场景适配:内置室内绿植、蔬菜花园、花卉观赏、多地点管理的完整示例,降低上手门槛

潜在局限

  • 输入验证宽松:当前仅检查重名,未对特殊字符、长度、注入风险进行严格过滤
  • 异常处理粗放:多处使用裸 except: 捕获,可能掩盖文件权限、JSON 解析等具体问题
  • 无内置备份恢复:依赖用户手动 export,缺乏自动定期备份与导入恢复机制
  • 单机数据孤岛:无多设备同步能力,跨终端使用需手动迁移 JSON 文件
  • 检索能力有限:仅支持基础模糊搜索,无高级筛选(如按养护间隔、生长阶段)

适合人群

  • 室内绿植爱好者:管理 10-50 盆 houseplants,追踪浇水施肥周期
  • 家庭菜园种植者:记录蔬菜瓜果的播种、养护、采收全周期
  • 多花园管理者:同时维护庭院、阳台、社区菜园等多地点植物
  • 数据敏感型用户:偏好本地优先、拒绝云同步的隐私保护主义者

常规风险

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据丢失 | 单点 JSON 文件损坏或误删 | 定期 `export` 备份,考虑版本控制 |
| 输入污染 | 特殊字符可能导致显示异常或导出问题 | 手动规范命名,待版本更新加强验证 |
| 权限问题 | 家目录或工作区无写权限时操作失败 | 检查目录权限,细化异常提示(待改进) |

安全等级判定依据:核心功能无网络暴露面,文件操作路径严格受限,数据完全本地可控。

plant-tracker 内容

scripts文件夹
手动下载zip · 6.0 kB
plant_tracker.pytext/plain
请选择文件