← 返回 Skills 市场
harrylabsj

Logistics

作者 haidong · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
359
总下载
0
收藏
4
当前安装
3
版本数
在 OpenClaw 中安装
/install logistics
功能描述
Query and explain parcel logistics across courier providers, including tracking, courier identification, multi-package lookup, status interpretation, and del...
使用说明 (SKILL.md)

Logistics

Overview

Use this skill to help the user track parcels, identify couriers, interpret logistics statuses, and understand what a shipment update usually means. It serves as a unified entry point for multi-courier logistics queries, including major Chinese courier networks such as SF Express (顺丰), JD Logistics (京东快递), ZTO (中通), Cainiao (菜鸟), J&T Express (极兔), and others.

Workflow

  1. Identify whether the user has:
    • one tracking number
    • multiple tracking numbers
    • an unknown courier
    • a status they want explained
  2. If the courier is unknown, infer cautiously from the number pattern or context.
  3. Return the latest useful tracking interpretation first.
  4. If a package appears delayed, explain likely reasons and a reasonable next action.
  5. Keep summaries concise when handling multiple shipments.
安全使用建议
What to consider before installing: - The skill will create a SQLite DB (~/.openclaw/data/logistics/logistics.db) and an encrypted storage area (~/.openclaw/data/logistics/secure) and will write a key file (.key) with 0600 perms. Expect persistent local data and encrypted blobs. If you don't want local persistence, don't install. - There is no install script; requirements.txt contains heavy native deps (cryptography, opencv, pyzbar). Make sure you trust the author and are prepared to install these packages (they may require system libraries). The absence of an explicit install step is an operational risk. - The secure storage code is intended to protect data but uses an odd key-derivation approach (PBKDF2 with random inputs) that looks buggy and may break or not yield a proper Fernet key. This appears to be sloppy/incorrect engineering rather than malicious, but it reduces confidence in the encryption correctness. - The current query() implementation returns simulated data and does not call external APIs, but the client contains an API_BASE and imports aiohttp — the code could be extended to make network calls (e.g., to kuaidi100) in future versions. If you need networked tracking, ask the author how API keys are handled and whether any outbound endpoints are contacted. - If you plan to install, review the code (especially secure storage and any networking) yourself or ask the author to explain: (1) why the KDF is used that way, (2) whether any external endpoints are contacted and how API keys are stored/used, and (3) provide an explicit install mechanism or containerized packaging to avoid surprise native installs. - If you are uncomfortable with local file writes or installing native libs, avoid installing this skill or run it in a restricted environment (container or VM).
功能分析
Type: OpenClaw Skill Name: logistics Version: 1.0.2 The logistics skill is a well-structured tool designed to track parcel delivery statuses across various Chinese couriers. It features a local SQLite database for history tracking and a custom 'security.py' module that uses Fernet encryption to protect stored data. While the 'requirements.txt' file includes several unused dependencies related to image processing (e.g., opencv-python, pyzbar), the core logic in 'logistics.py' is functional, uses parameterized SQL queries to prevent injection, and restricts file operations to its own data directory. No evidence of malicious intent, data exfiltration, or prompt injection was found.
能力评估
Purpose & Capability
Name/description (multi-courier parcel tracking) aligns with the code: carrier detection, queries (currently simulated), batch handling, history and subscription features. Persisting history/subscriptions locally and supporting QR/barcode libs (requirements) is plausible for this purpose, though the README does not explicitly mention local DB or secure storage.
Instruction Scope
SKILL.md describes only tracking and interpretation. The packaged code, however, creates a SQLite DB under ~/.openclaw/data/logistics, manages subscriptions, and uses an encrypted secure storage area under ~/.openclaw/data/<app>/secure. The instructions do not call out these file writes or persistence, so users should be aware the skill will store local data.
Install Mechanism
No install spec is provided even though requirements.txt lists many non-trivial native/third-party packages (cryptography, opencv, pyzbar, etc.). That mismatch is problematic: installation may fail or require compiling native deps and the skill may attempt imports that won't work without explicit install steps. The lack of an install mechanism plus heavy deps increases friction and risk.
Credentials
The skill requests no environment variables or external credentials (SKILL metadata shows none). It does write files into the user's home (SQLite DB and encrypted files) and creates a key file at ~/.openclaw/.../.key with 0600 perms. Local storage is proportional to history/subscription features, but the secure key-generation logic is unusual (see below) and merits review.
Persistence & Privilege
always is false; the skill does not ask for platform-wide privileges and confines files to a self-named ~/.openclaw directory. It will persist history, subscriptions, and an encryption key locally which is normal for a local helper, but users should accept that local data will be created and retained unless removed.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install logistics
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /logistics 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.2
English main doc for multi-courier logistics tracking
v1.0.1
English-first documentation update
v1.0.0
- Initial release of the logistics skill. - Enables parcel tracking, courier identification, and multi-package lookup across providers. - Explains shipment progress updates and status meanings. - Offers guidance for delayed packages, including likely reasons and suggested next steps. - Supports concise summaries for multiple shipments and helps interpret courier-specific details.
元数据
Slug logistics
版本 1.0.2
许可证 MIT-0
累计安装 5
当前安装数 4
历史版本数 3
常见问题

Logistics 是什么?

Query and explain parcel logistics across courier providers, including tracking, courier identification, multi-package lookup, status interpretation, and del... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 359 次。

如何安装 Logistics?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install logistics」即可一键安装,无需额外配置。

Logistics 是免费的吗?

是的,Logistics 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Logistics 支持哪些平台?

Logistics 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Logistics?

由 haidong(@harrylabsj)开发并维护,当前版本 v1.0.2。

💬 留言讨论