sensecraft-cli
SenseCAP 设备与 SenseCraft AI 的命令行工具。一把 OpenAPI Access Key 即可访问设备、遥测、应用、模型、文件和云设备。给人用，也给 AI Agent 用。Skills 在 skills/。
安装 · AI Agent · Skills · 登录 · 命令 · 进阶 · 安全
能做什么
| 类别 | 能力 |
|---|---|
| 设备 | 列出、查看、绑定、解绑网关、节点和开发套件 |
| 分组 | 创建分组、移动设备 |
| 遥测 | 最新值、历史记录、折线聚合点 |
| 应用 | CodeCraft Hub：浏览应用，管理自己的应用、物料和活动 |
| 模型 | 搜索模型库，上传和发布模型 |
| 文件 | 上传本地文件，得到 file_url |
| 云设备 | 列出 Jetson 等云设备，部署模型 |
| reCamera | 检查经典 reCamera 的应用或模型，并打开控制台部署页 |
网页控制台是 https://sensecraft.seeed.cc。
安装
需要 Node.js 16 及以上，以及能访问 SenseCAP 和 SenseCraft AI 的网络。从源码构建另需 Go 1.25 及以上（见 go.mod）。
npx @seeed-studio/sensecraft-cli install
sensecraft-cli --version
Windows 上的命令名是 sensecraft-cli.cmd。PATH、升级和卸载见 INSTALL.md。
三步上手
在 SenseCAP 门户创建 OpenAPI Access Key，然后：
# 1. 写入钥匙。--site 为 Global 或 China，省略时是 Global
sensecraft-cli auth add --key-id <Key ID> --access-key <Access Key> --site Global
# 2. 确认。不会打印 Access Key
sensecraft-cli auth info
# 3. 调用接口
sensecraft-cli device list
交互终端里可以不带参数运行 auth add，按提示填写。
给 AI Agent
和用户一起完成。不要让用户把 Access Key 贴进对话，也不要在会被记录的命令行里带上这串密钥。
- 如果没有命令，先安装：
npx @seeed-studio/sensecraft-cli install
- 请用户在自己的电脑上运行
auth add。 - 确认钥匙已经生效：
sensecraft-cli auth info
- 再跑只读命令，例如
sensecraft-cli device list或sensecraft-cli app list --public。 - 先读
skills/sensecraft-cli/SKILL.md，它会转到对应的产品说明。
解绑、删除、发布、部署这类写操作，要等用户单独确认之后才能加 --yes。
Agent Skills
| Skill | 说明 |
|---|---|
sensecraft-cli | SenseCraft Data、SenseCraft AI 和 CodeCraft Hub |
create-app | 把本地项目做成 CodeCraft Hub 应用 |
全局 npm 安装之后：
ls "$(npm root -g)/@seeed-studio/sensecraft-cli/skills"
登录
| 命令 | 说明 |
|---|---|
auth add | 校验 Access Key，写入本机，并设为当前钥匙 |
auth info | 显示站点、组织 ID 和 Key ID |
sensecraft-cli auth add --key-id <Key ID> --access-key <Access Key> --site Global
sensecraft-cli auth info
--site | SenseCAP OpenAPI | SenseCraft AI OpenAPI |
|---|---|---|
Global | https://sensecap.seeed.cc/openapi | https://api-gateway.seeed.cc/openapi |
China | https://sensecap.seeed.cn/openapi | https://api-gateway.seeed.cc/openapi |
中国站仅支持 SenseCraft Data。SenseCraft AI 和 CodeCraft Hub 请用 Global。同一把 Access Key 用 HTTP Basic 调用接口：用户名是 Key ID，密码是 Access Key。
命令
参数用 sensecraft-cli <command> --help 查看。每一类一条示例：
sensecraft-cli device list --device-type 1
sensecraft-cli data latest --eui <EUI>
sensecraft-cli app list --public --sort popular
sensecraft-cli model list --public
sensecraft-cli file upload --type 1 --path ./cover.png --for-app
sensecraft-cli cloud device list
sensecraft-cli recamera check --model-id <id>
| 命令 | 说明 |
|---|---|
device | 网关（--device-type 1）、节点（2，默认）、开发套件（3） |
group | 设备分组 |
data | 最新遥测、历史、折线点 |
app | CodeCraft Hub 和我的应用。不传 --public 时列出自己的应用 |
model | 模型库。不传 --mine 时列出公开模型 |
file | 上传。--type：1 图片，2 模型，3 应用，4 固件，5 静态资源（需要 --flow-id），6 压缩包 |
cloud | 云设备，以及部署模型 |
recamera | 检查，或打开控制台页面。烧录在网页上完成 |
update | 安装 npm 上的最新版本 |
app list --sort 取 popular、newest 或 likes。常用 --uniform-type：40 reCamera，32 XIAO ESP32S3，53 reCamera Pro。
进阶
成功的数据命令把缩进 JSON 打到 stdout。auth add 和 auth info 打可读文本。失败在 stderr，退出码非 0。
sensecraft-cli --version 打印 npm 包版本。直接 go build 的二进制打印 dev。
配置文件名是 sensecraft.json。
| 运行方式 | 文件位置 |
|---|---|
| npm 安装 | macOS / Linux：~/.config/sensecraft-cli/sensecraft.json。Windows：%APPDATA%\sensecraft-cli\sensecraft.json |
go build 的二进制 | 当前目录下的 sensecraft.json |
命令成功后，stderr 上可能各出现一条英文提示，同一条 24 小时内只出现一次：Warning: 表示有新版本，运行 sensecraft-cli update；Notice: 写出正在进行的活动名称、日期和链接。交互终端里会再问 Ignore this activity? [y/N]。
从源码构建
go build -o sensecraft-cli .
./sensecraft-cli --version
./script/build.sh
./script/build.sh 按 packages/cli/package.json 的版本号交叉编译到 dist/。
安全
Access Key 是密钥。不要提交进仓库，也不要贴进 Agent 对话。auth info 只打印 Key ID。
解绑、删除、发布、部署在带上 --yes 之前不会执行。Agent 必须先得到用户对这一次操作的确认，再加这个参数。
本工具不通过 USB 或串口烧录固件。recamera open 只打开控制台部署页。