什么是sf-express
顺丰速运（SF Express）是一款专为快递物流场景设计的智能助手工具，旨在帮助用户高效处理与顺丰快递相关的日常事务。无论是追踪包裹状态、预估运费或时效，还是查找最近的营业网点和自助快递柜，该工具都能提供一站式服务。通过集成顺丰官方数据接口，用户可以在命令行环境中快速获取实时物流信息，而无需频繁切换网页或使用手机App。
该工具采用本地持久化机制，在用户执行查询、订阅包裹动态等操作时，会自动在 `~/.openclaw/data/sf-express/` 目录下生成 SQLite 数据库文件，用于存储历史查询记录和已订阅的运单信息。同时，为保障数据安全，敏感信息如加密密钥会保存在受保护的子目录中，并设置严格的访问权限（mode 600）。此外，工具还支持隐私管理功能，允许用户查看、导出或清除本地存储的数据，确保个人物流信息不被滥用。
使用上，工具遵循最小必要原则：仅在用户提供关键信息（如运单号、寄件地址、包裹尺寸等）后才执行具体操作。若无法确定精确费用或送达时间，则会基于当前政策给出合理估算，并明确说明前提条件。整个交互流程简洁直观，优先返回最实用的结果，避免冗余信息干扰用户体验。
核心功能特点
- 支持实时追踪顺丰运单状态，提供详细的物流节点信息
- 可估算不同服务类型下的运费及预计送达时间
- 内置网点与自助快递柜查询功能，方便就近寄送或取件
- 具备本地数据持久化能力，自动保存查询历史和订阅记录
- 提供隐私管理工具，支持查看、导出和清理本地存储数据
适用场景
顺丰速运工具特别适合需要频繁处理快递业务的个人和企业用户。例如，电商卖家在发货后可立即通过运单号追踪订单流向，及时发现异常并联系客户；普通用户在网购后也能随时掌握包裹位置，合理安排收货时间。对于计划寄送包裹的用户，该工具能根据目的地、包裹重量和所选服务自动计算大致费用与时效，辅助决策是否加急或选择经济型物流方案。
此外，当用户身处陌生城市或临时找不到营业网点时，可通过工具快速定位附近的顺丰服务点或智能快递柜，节省寻找时间。企业采购人员也可利用其对比不同服务等级的成本效益，优化供应链物流策略。值得一提的是，由于所有敏感数据均加密存储于本地，即便不连接互联网，部分功能仍可离线调用历史记录，兼顾效率与隐私安全。
对于注重数据主权的用户，该工具还提供了完整的隐私控制选项——既能一键清除所有本地缓存，也能将存储元数据导出为 JSON 文件供审计。这种透明化的设计让用户清楚知道自己的哪些信息被保留、如何被使用，从而建立对工具的信任感。总体而言，这是一款集实用性与安全性于一体的命令行级物流助手，适用于各类需要高效管理顺丰快递的场景。