@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

安装方式：

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 二进制使用。

示例：

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

常用命令：

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：

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

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

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

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

npm run build:release -- \
  --target-triple "aarch64-apple-darwin" \
  --version "1.1.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 发布：

npm publish --access public