跳到主要内容

重要规则与常见问题

献丑 Skill 的核心原则是：Agent 只使用公开 CLI 和 /api/cli/* 契约，所有模型参数动态查询，所有写文件操作先确认范围。

必须遵守的规则​

  1. 只使用公开 CLI：优先调用 xianchou 命令，不直接请求 Web 内部接口。
  2. 只使用 /api/cli/* 契约：不要绕过 CLI 调 /run、/canvas、/toolbar-image、/toolbar-video。
  3. 模型 ID 动态获取：生图先运行 xianchou models image，生视频先运行 xianchou models video。
  4. 不要硬编码渠道参数：provider_id、model_id、channel 以模型查询结果为准。
  5. 视频素材必须是可访问 URL：本地文件需要先上传，不能把 /Users/.../image.png 直接传给服务端。
  6. Markdown 默认 dry-run：没有 --write 时不改原文；写回前要确认目标文件和资源目录。
  7. 区分保存目录和访问路径：--assets-dir 是本地目录，--public-url-prefix 是写入 Markdown 的链接前缀。
  8. 封面必须显式开启：只有传入 --cover 才写入 frontmatter 的 cover 和 coverAlt。
  9. 不要删除图片标记：<!-- xianchou:image ... --> 用于重复运行时识别并更新图片块。
  10. 任务成功后必须 settle：使用 --poll 时 CLI 会处理；手动轮询时要确认任务完成后的 settle 流程。

常见问题​

找不到 xianchou 命令​

先安装 CLI，并确认全局 npm bin 在 PATH 中：

npm install -g @xianchou/cli
xianchou --help

本地开发环境可以在 cli 仓库中使用 pnpm dev -- --help 验证。

提示未授权或项目不存在​

重新登录并确认项目 ID：

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

如果使用环境变量，检查 XIANCHOU_ACCESS_KEY 和 XIANCHOU_PROJECT_ID 是否在当前终端会话中生效。

不知道该用哪个模型​

不要猜。先查询模型：

xianchou models image
xianchou models video

根据返回的能力选择比例、分辨率、时长、模式和音频等参数。

Markdown 重复出现图片​

不要手动复制或删除 xianchou:image 标记。CLI 依赖该标记更新已有图片块。若文件被手动改乱，先清理重复图片块，再重新运行 dry-run。

图片保存了，但 Markdown 链接不对​

检查两个参数是否混淆：

xianchou markdown images ./article.md   --assets-dir ./public/images   --public-url-prefix /images   --write

--assets-dir 决定文件保存到哪里，--public-url-prefix 决定 Markdown 里写什么链接。