命令速查

献丑 Skill 要求 Agent 优先调用 xianchou CLI。除非你正在开发 CLI 本身，否则不要让 Agent 直接请求 /run、/canvas、/toolbar-image、/toolbar-video 等 Web 内部接口。

认证

xianchou auth login --key <ACCESS_KEY> --project-id <PROJECT_ID>

如果需要指定 API 地址：

xianchou auth login   --key <ACCESS_KEY>   --project-id <PROJECT_ID>   --api-url https://api.xianchou.com

查询模型

生成前必须先动态查询模型。不要猜测或硬编码 provider_id、model_id、channel。

xianchou models image --project-id <PROJECT_ID>
xianchou models video --project-id <PROJECT_ID>

如果已经通过 auth login 保存默认项目 ID，可以省略 --project-id。

生成图片

xianchou generate image   --prompt "现代科技文档封面，抽象 AI 视频创作画布"   --project-id <PROJECT_ID>   --poll

常用参数：

参数	说明
--provider-id	从 models image 返回值中读取
--model-id	从 models image 返回值中读取
--ratio	图片比例
--resolution	分辨率选项
--output-format	输出格式
--number	生成数量
--poll	轮询到完成并自动 settle

生成视频

文生视频：

xianchou generate video   --prompt "电影感航拍镜头，雨后的未来城市"   --project-id <PROJECT_ID>   --poll

首帧生视频：

xianchou generate video   --mode first   --prompt "让参考图中的人物自然转身并看向镜头"   --first-frame-url "https://example.com/first.png"   --project-id <PROJECT_ID>   --poll

首尾帧视频：

xianchou generate video   --mode first-last   --prompt "从白天城市过渡到夜晚霓虹街道"   --first-frame-url "https://example.com/first.png"   --last-frame-url "https://example.com/last.png"   --project-id <PROJECT_ID>   --poll

参考生视频：

xianchou generate video   --mode reference   --prompt "保留角色主体和服装风格，生成电影感行走镜头"   --reference-url "https://example.com/reference.png"   --project-id <PROJECT_ID>   --poll

轮询任务

如果生成命令没有使用 --poll，可以拿返回的任务 ID 继续轮询：

xianchou generate task <TASK_ID> --poll

为 Markdown 配图

默认 dry-run，只输出计划和结果，不写回原文件：

xianchou markdown images ./article.md --count 3

确认后写回 Markdown：

xianchou markdown images ./article.md --count 3 --write

同时生成封面和正文图：

xianchou markdown images ./article.md --cover --count 3 --write