货运追踪器（Shipment Tracker）

从一个 Markdown 格式的货运清单文件中，跨多个承运商（carrier）追踪包裹。自动根据运单号（tracking number）的格式识别承运商。采用混合式状态查询机制：优先尝试直接通过 HTTP 获取状态；若失败，则推荐使用 browser-use 在浏览器环境中完成完整追踪。

货运清单文件格式

该技能读取一个包含当前货运记录的 Markdown 文件，其中需包含一张表格：

# 当前货运清单

| 订单 | 物品 | 承运商 | 运单号 | 链接 | 添加日期 |
|------|------|--------|--------|------|----------|
| Acme #1234 | Widget | USPS | 9449050899562006763949 | [追踪](https://...) | 2026-02-19 |

• 承运商（Carrier） 和 链接（Link） 字段为可选 —— 将根据运单号格式自动识别
• 包裹送达后请手动删除对应条目，以保持文件简洁
• 默认路径：memory/shipments.md（位于 workspace 目录下）

使用方法

# 检查所有当前货运状态
python3 scripts/shipment_tracker.py memory/shipments.md

# 输出 JSON 格式（适用于集成场景）
python3 scripts/shipment_tracker.py memory/shipments.md --format json

# 仅识别某运单号对应的承运商
python3 scripts/shipment_tracker.py --detect 9449050899562006763949

承运商识别机制

系统根据运单号格式自动识别承运商：

状态查询（混合模式）

1. 直连 HTTP 查询 —— 使用 urllib 尝试从承运商官网追踪页面提取基础状态信息。适用于 USPS 及部分其他承运商的基础状态获取。
2. 浏览器回退机制（browser-use fallback） —— 当 HTTP 查询失败，或承运商页面重度依赖 JavaScript 时，脚本将提供一条完整的 browser-use 命令供用户执行。

当脚本输出中包含 needs_browser_use: true 时，会附带一条完整的 browser-use 命令：

python3 -c "
import asyncio
from browser_use import Agent, Browser, ChatBrowserUse
async def main():
    browser = Browser(use_cloud=True)
    llm = ChatBrowserUse()
    agent = Agent(
        task='访问  并提取当前追踪状态、预计送达日期及所在位置',
        llm=llm, browser=browser
    )
    result = await agent.run(max_steps=10)
    print('TRACKING:', result)
asyncio.run(main())
"

该机制确保对所有承运商（包括启用激进机器人检测策略的站点）均能实现可靠追踪。

以下情况需要启用 browser-use：

• UPS、FedEx、Amazon（其追踪页面高度依赖 JavaScript）
• USPS 在基础解析失败时（例如复杂状态更新）
• 任何启用 CAPTCHA 或机器人检测机制的承运商网站
• 需用户交互或表单提交才能访问的站点

工作流程

1. 用户提供运单号 → 运行 --detect 命令识别承运商
2. 将该运单号及相关订单信息添加至 memory/shipments.md
3. 每日晨会简报或按需触发：运行脚本检查全部货运状态
4. 对需 browser-use 的货运项：
   • 非敏感包裹：直接执行所提供的 browser-use 命令
   • 隐私敏感包裹：改用本地手动浏览器查询（数据全程保留在本地）
5. 包裹签收后：及时从货运清单文件中移除对应条目

隐私建议：对于医疗用品、个人物品或涉密订单，建议采用手动浏览器追踪方式，避免将货运详情发送至云端服务。

系统访问权限

技能直连执行（无外部依赖）：

• 文件读取：仅读取一个 Markdown 文件（路径通过命令行参数指定）
• 网络访问：向承运商追踪页面发起只读 HTTPS GET 请求（例如 tools.usps.com），无需身份认证
• 不执行文件写入、不调用子进程、不执行 shell 命令

browser-use 回退机制（涉及隐私影响）：
当技能推荐 browser-use 命令时，将发生外部数据传输：

• 运单号 和 订单信息 将被发送至云端浏览器服务
• 包裹详情 将由外部大语言模型（ChatBrowserUse）处理
• 承运商追踪 URL 将通过云端基础设施访问

隐私注意事项：browser-use 回退机制依赖第三方服务，这些服务可能记录或处理您的货运数据。对于敏感包裹，请优先选择手动浏览器追踪，而非执行所提供的 browser-use 命令。

依赖要求

• Python 3.10 或更高版本
• 具备对外访问承运商追踪网站的 HTTPS 出站连接能力
• browser-use（可选，用于在重度依赖 JavaScript 的网站上实现完整追踪）