← 返回 Skills 市场

fit-device-id-modifier

Name: fit-device-id-modifier
Author: ckboss

作者码代码的猿猿 · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

156

总下载

当前安装

版本数

在 OpenClaw 中安装

/install fit-device-id-modifier

功能描述

Modify FIT files to set device manufacturer to Garmin (1) and product ID to Edge 500 China (1030) for proper recognition on Garmin Connect.

使用说明 (SKILL.md)

fit-device-id-modifier

修改 FIT 文件的设备 ID（manufacturer 和 garmin_product），将骑行记录转换为 Garmin Edge 500 China 设备生成的格式。

用途

修改 FIT 文件中的 manufacturer 字段为 1 (Garmin)
修改 garmin_product 字段为 1030 (Edge 500 China)
用于让第三方骑行软件生成的 FIT 文件能被 Garmin Connect 等平台正确识别

依赖

Python 3.x
fitparse 库 (pip install fitparse)

使用方法

批量处理子目录中的 FIT 文件

cd /home/ckboss/.openclaw/workspace/skills/fit-device-id-modifier/scripts
/home/ckboss/anaconda3/bin/python modify_fit.py

这会处理 ./ */*.fit 匹配的所有 FIT 文件，生成 _GM.fit 后缀的修改版。

处理单个文件

/home/ckboss/anaconda3/bin/python modify_fit.py /path/to/ride.fit

处理整个目录

/home/ckboss/anaconda3/bin/python modify_fit.py /path/to/rides/

输出

原文件保持不变
生成新文件：原文件名_GM.fit

注意事项

会自动跳过已处理的文件（文件名包含 _GM.fit）
会重新计算 CRC 校验和确保文件完整性
使用 conda Python：/home/ckboss/anaconda3/bin/python

文件结构

skills/fit-device-id-modifier/
├── SKILL.md
└── scripts/
    └── modify_fit.py

安全使用建议

This skill appears to be what it says: a local tool to modify FIT files so Garmin Connect recognizes them. Before using it widely: 1) Back up original FIT files (the script can corrupt files because it replaces raw byte sequences and may match unintended bytes). 2) Test on a small sample and verify the generated _GM.fit is accepted by Garmin Connect. 3) Use an isolated Python environment and pip install fitparse rather than running the absolute /home/ckboss path in the SKILL.md. 4) Review/consider improving the script (identify fields by message structure rather than byte-pattern search and verify the CRC algorithm matches the FIT specification). 5) There are no network calls or credential requests in the code, so there is low privacy risk, but always inspect outputs before uploading to external services.

功能分析

Type: OpenClaw Skill Name: fit-device-id-modifier Version: 1.0.0 The skill is designed to modify device identification fields in FIT files to mimic a Garmin Edge 500 China. The Python script `modify_fit.py` performs binary replacement of specific fields and recalculates the CRC checksum as described. While `SKILL.md` contains hardcoded absolute paths specific to a user environment ('ckboss'), the code lacks any indicators of data exfiltration, malicious execution, or persistence.

能力评估

✓ Purpose & Capability

Name, description, SKILL.md, and the included modify_fit.py are consistent: the skill reads FIT files, sets manufacturer to 1 and garmin_product to 1030, recalculates CRC, and writes new *_GM.fit files. The only external dependency mentioned is fitparse (pip), which is appropriate for parsing FIT files.

ℹ Instruction Scope

Runtime instructions only ask the agent/user to run the provided Python script against FIT files. The script only reads local files and writes new files; it prints message/field values to stdout. Caveats: the script performs binary replacement by searching for the old numeric value's byte sequence anywhere in the file (data.find) which can accidentally replace unrelated occurrences, and it uses a custom CRC calculation that may not match the official FIT CRC algorithm. SKILL.md references an absolute conda/python path and to run from a specific workspace directory — these are benign but environment-specific and should be adjusted to your system.

✓ Install Mechanism

There is no install spec (instruction-only skill with a Python script). The only required package is fitparse (pip), which is reasonable and expected. No remote downloads or archives are fetched by the skill itself.

✓ Credentials

The skill does not request environment variables, credentials, or config paths. SKILL.md mentions a local Python interpreter path but that is an instruction, not a secret. No access to unrelated services is requested.

✓ Persistence & Privilege

always is false and the skill does not attempt to modify other skills or system-wide configuration. It only operates on files given to it and writes per-file outputs.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install fit-device-id-modifier
安装完成后，直接呼叫该 Skill 的名称或使用 /fit-device-id-modifier 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release of fit-device-id-modifier. - Modifies FIT file device IDs to `manufacturer: 1 (Garmin)` and `garmin_product: 1030 (Edge 500 China)`. - Supports batch processing within subdirectories, single file, or entire directory. - Outputs new files with `_GM.fit` suffix, preserving originals. - Skips files already processed and recalculates FIT file CRC for integrity. - Requires Python 3.x and `fitparse` library.

元数据

Slug fit-device-id-modifier

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题