youmind-cli

YouMind OpenAPI CLI — 通过命令行调用 YouMind OpenAPI。

安装

pnpm --filter youmind-cli build
npm link packages/youmind-cli

认证

优先级从高到低：

1. 环境变量（推荐，适合 CI/CD 和脚本）

   export YOUMIND_API_KEY=ym_xxxxxxxxxxxx
   youmind callApi listCrafts

2. 命令行参数

   youmind callApi listCrafts --api-key ym_xxxxxxxxxxxx

命令

searchApi — 搜索 API

youmind searchApi board          # 搜索含 "board" 的 API
youmind searchApi craft
youmind searchApi                # 无参数，列出所有 API

readApi — 查看 API schema

youmind readApi createBoard      # 查看 requestBody 和 response schema
youmind readApi listCrafts

callApi — 调用 API

# --key value 形式
youmind callApi createBoard --name "My Board" --boardGroupId "xxx-uuid"

# JSON 字符串
youmind callApi createBoard '{"name":"My Board"}'

# stdin 管道
echo '{"name":"My Board"}' | youmind callApi createBoard

# 无参数
youmind callApi listCrafts

环境变量

| 变量 | 说明 | |------|------| | YOUMIND_API_KEY | API Key |

--api-key > 环境变量。

项目结构

packages/youmind-cli/
├── src/
│   ├── index.ts       # 入口 + 命令定义
│   ├── api.ts         # HTTP 调用 /openapi/v1/{name}
│   └── spec.ts        # 拉取 OpenAPI spec
├── package.json
└── tsconfig.json