# `@limecloud/lime-cli`

Lime 的官方命令行入口，面向统一任务编排。

当前 npm 首发策略：

- 优先尝试下载预编译二进制
- 如果预编译资产暂未发布，npm 安装不会失败
- 运行时会优先查找：
  - `LIME_CLI_BINARY_PATH`
  - 包内已存在的预编译二进制
  - 当前源码仓库中的本地构建产物
  - 当前源码仓库中的 `cargo run -p lime-cli`

当前主线提供：

- `lime task create image`
- `lime task create cover`
- `lime task create video`
- `lime task create broadcast`
- `lime task create url-parse`
- `lime task create typesetting`
- `lime task create resource-search`
- `lime task status`
- `lime task list`
- `lime task retry`
- `lime task cancel`
- `lime task result`
- `lime skill list`
- `lime skill show`
- `lime doctor`

安装方式：

```bash
npm install -g @limecloud/lime-cli
```

说明：

- npm wrapper 在 `postinstall` 阶段会从 `https://github.com/limecloud/lime/releases` 下载同版本预编译二进制。
- 当前预编译 release asset 覆盖：`darwin/arm64`、`darwin/amd64`、`windows/amd64`、`linux/amd64`。
- 若对应版本的 release asset 尚未发布，安装会失败，此时请先发布 GitHub release asset，或在本地直接编译 Rust 二进制使用。

示例：

```bash
lime task create image \
  --prompt "未来城市插图，蓝色电影感" \
  --size "1024x1024" \
  --workspace "." \
  --idempotency-key "image-future-city"
```

成功时标准输出为 JSON，包含：

- `task_id`
- `task_type`
- `status`
- `normalized_status`
- `artifact_path`
- `absolute_artifact_path`
- `reused_existing`

失败时标准错误同样输出结构化 JSON，包含：

- `error_code`
- `error_message`
- `retryable`
- `hint`

常用命令：

```bash
lime task list --status failed
lime task status <task-id>
lime task retry <task-id>
lime task cancel <task-id>
lime skill list
lime skill show broadcast_generate
lime doctor
```

说明：

- `lime media image|cover|video generate` 仍保留为兼容别名。
- 新主线统一收敛到 `lime task create ...`。
- 如果你现在只发布 npm、不发布 GitHub Release，请至少准备一种运行方式：
  - 设置 `LIME_CLI_BINARY_PATH`
  - 或在 Lime 源码仓库内使用该 wrapper，让它自动回退到 `cargo run`

## 维护者发布流程

1. 先构建对应目标平台的 `lime-cli`：

```bash
cargo build --manifest-path "../../src-tauri/Cargo.toml" -p lime-cli --release
```

2. 生成和 npm wrapper 约定一致的 release asset：

```bash
npm run build:release -- \
  --binary "../../src-tauri/target/release/lime" \
  --out-dir "./dist"
```

也可以在 CI 中直接传 target triple：

```bash
npm run build:release -- \
  --target-triple "aarch64-apple-darwin" \
  --version "1.3.0" \
  --out-dir "./dist"
```

3. 将生成的归档上传到 GitHub Release，对应命名形如：

- `lime-<version>-darwin-arm64.tar.gz`
- `lime-<version>-darwin-amd64.tar.gz`
- `lime-<version>-windows-amd64.zip`
- `lime-<version>-linux-amd64.tar.gz`

4. 确认 release asset 已上传后，再执行 npm 发布：

```bash
npm publish --access public
```