用途：track17 让 Clawdbot 在本地维护包裹清单，通过 17TRACK Tracking API v2.2 查询状态并汇总变化。数据默认存于工作区下的 SQLite 数据库。
配置要求：必须设置 TRACK17_TOKEN（作为 17token 请求头发送）；需要 Python3。可选设置 TRACK17_WEBHOOK_SECRET 验证 webhook 签名，TRACK17_DATA_DIR 覆盖数据库/收件箱位置，TRACK17_WORKSPACE_DIR 覆盖工作区目录。
主要能力与用法：先初始化存储：python3 {baseDir}/scripts/track17.py init。添加包裹：python3 {baseDir}/scripts/track17.py add "RR123456789CN" --label "AliExpress headphones"，自动识别承运商失败时可用 --carrier 3011 指定。列出包裹：python3 {baseDir}/scripts/track17.py list。轮询更新：python3 {baseDir}/scripts/track17.py sync。查看单个包裹：python3 {baseDir}/scripts/track17.py status 1 或 status "RR123456789CN"。其他操作包括 stop、retrack、remove、quota。
Webhook 可选：可运行 webhook 服务 python3 {baseDir}/scripts/track17.py webhook-server --bind 127.0.0.1 --port 8789，或从 stdin/文件接收：cat payload.json | python3 {baseDir}/scripts/track17.py ingest-webhook 或 --file payload.json，也可用 process-inbox 处理收件箱。
使用建议：除非明确需要 webhook，优先使用 sync 轮询；添加包裹后运行一次 status 确认承运商/状态有效。汇总时优先关注已送达/派送中、异常/投递失败、海关扣留、承运商交接。不要回显 TRACK17_TOKEN 或 TRACK17_WEBHOOK_SECRET。
限制：需自备 17TRACK API token；未知的费率、配额上限等细节资料暂未提供。