AIGCCLI
AIGC CLI / DOCUMENTATION

把创作,连接起来。

从选择入口到完成第一个任务,这里是你的 AIGC CLI 使用指南。

01 / GET STARTED

选择适合你的创作入口

AIGC CLI 把图片、视频、任务和素材管理连接在一起。你可以在无限画布中探索创意,在飞书多维表中组织团队生产,或在 Harness(智能体运行环境)中加载 Skill,把同一套生成能力接入已有工作流。

第一步:向管理员取得组织名称和账号。已有账号的用户可以直接打开组织登录入口。

02 / ACCOUNT

组织与账号

组织是团队的工作范围。网页和 Skill 均使用组织名称、用户名与密码登录;是否能够使用某项功能,以账号角色和管理员配置为准。

  • 组织成员:使用组织专用地址登录,进行日常创作与任务查询。
  • 组织管理员:在组织范围内管理成员,并按授权使用创作工具。
  • 超级管理员:使用专门的管理入口,负责系统配置;不能进入组织画布。

官网是公开介绍页,不要求登录。实际生成、素材与画布属于组织工作空间,需要组织账号。还没有账号时,请联系提供服务的管理员;公开官网暂不提供自助开通或充值。

组织登录地址形如 /org/组织名称/login。首页“进入工作台”与“打开无限画布”会帮助你前往正确地址,无需手工拼接链接。

03 / REQUIREMENTS

开始前,准备这些

使用方式所需环境
网页与无限画布支持现代网页功能的浏览器,以及有效的组织账号。
macOS / Linux SkillPython 3(支持 venv)、curl、sh,以及支持 Skill、终端与文件工具的 Harness(智能体运行环境)。
Windows SkillPython 3、PowerShell,以及支持 Skill、终端与文件工具的 Harness(智能体运行环境)。Python 需可从终端运行。
飞书协作使用已开通的功能多维表与飞书群聊;填表后在群聊卡片中启动对应功能。

Skill 的默认业务服务为 https://aigc4.bsyou.top,安装包来自 AIGC CLI Skill 发布页。安装脚本会校验包的 SHA-256,并创建本地 Python 虚拟环境。

04 / INSTALLATION

将 AIGC CLI Skill 接入 Harness

Harness 是承载智能体的运行与执行环境,提供上下文、任务规划、工具调用和文件操作。AIGC CLI Skill 为它提供专业创作流程、能力发现与 CLI 调用规范;图像与视频任务由 AIGC 服务执行,Harness 再按目标处理结果。

各自负责什么

组成职责
Harness理解目标、组织上下文、规划任务,通过获准工具读取、整理文件,并编排后续操作。
AIGC CLI Skill提供专业流程与 CLI 客户端,规范能力发现、参数选择、任务提交、状态查询和结果下载。
AIGC 服务按当前模型能力执行任务,负责后台并发调度,提供任务状态、生成结果与账号素材留存。

本地文件操作和自动化范围取决于 Harness 的工具及授权。使用组织账号登录后,Harness 按 Skill 的规范调用 AIGC CLI。

安装 Skill

以下命令安装到默认的 ~/.agents/skills/aigc-cli。如果你的 Harness 使用其他 Skill 目录,请在安装前按其说明设置 AIGC_SKILLS_ROOT。使用本页面对应的 NAS 版本安装地址。

macOS / Linux

终端 · 安装
curl -fsSL https://git.bsyou.top/skills/aigc-cli/install.sh | sh

Windows PowerShell

PowerShell · 安装
irm https://git.bsyou.top/skills/aigc-cli/install.ps1 | iex

检查环境并登录

安装后重新加载 Harness 会话,让运行环境发现新 Skill。也可以先在终端检查环境并登录。macOS / Linux:

检查与登录
sh "$HOME/.agents/skills/aigc-cli/run.sh" scripts/manage.py doctor
sh "$HOME/.agents/skills/aigc-cli/run.sh" scripts/manage.py login

Windows PowerShell:

PowerShell · 检查与登录
& "$HOME\.agents\skills\aigc-cli\run.ps1" scripts/manage.py doctor
& "$HOME\.agents\skills\aigc-cli\run.ps1" scripts/manage.py login

按照提示输入组织名称和用户名。密码通过终端隐藏输入,不要发到聊天中,也不要写入命令参数或脚本。

在 Harness 中提出目标

“使用 AIGC CLI Skill,先刷新能力目录,再用可用图片模型生成一张暖色调商品展示图,并下载到本地。”

每次新创作前,Skill 应先刷新能力目录。若刷新报告 revision 变更而无法更新完整快照,应停止生成并联系管理员更新 Skill 的完整能力包;不要跳过校验或切换到旧地址。

05 / INFINITE CANVAS

在无限画布中连接创意

画布把素材、文字与生成工作台放在同一处,让你保留完整的创作上下文。点击下方入口,填写组织名称后登录,成功后会直接进入画布。

一个完整的创作过程

  1. 整理创意:创建文字、工作台与分组;将已有图片或视频导入画布作为素材。
  2. 选择创作能力:在独立的“工作台”中选择当前可用模型与功能,按表单填写模式、尺寸、时长、数量等参数。
  3. 添加参考素材:从工作台素材栏添加图片、视频或音频,并按照表单指定用途。不同模型与模式支持的素材类型不同。
  4. 引用文字:在提示词中输入 @,选择画布中的非空文字。引用在原位置展开,保留文本顺序与原有换行。
  5. 提交生成:检查参数与素材,点击工作台中的生成按钮。完成后查看输出,将结果继续连接到其他工作台。

文字、图片和视频是素材;生成操作集中在独立的“工作台”。媒体参考通过素材栏添加,提示词中的 @ 用于引用文字。必填规则与参数范围以当前模式的实际表单为准。

让项目便于继续

用分组组织不同方向,将关键文字与参考素材放在相关工作台附近。输出可以继续作为素材复用;图片裁切、视频播放与下载等操作在素材节点中完成。

06 / FEISHU BATCH WORKFLOW

飞书批量生成:填表、群聊启动、等结果

先在多维表准备这一批任务,再到飞书群聊启动对应功能。你不用逐条发提示词、逐次等待;系统批量读取符合条件的记录,执行后把结果回填原表。

① 选对应功能表→② 每行填一条任务→③ 群聊启动对应功能→④ 等待执行,回表收图

先看一次:15 条换装任务怎么跑

演示用 3 张人物参考图与 5 张服装素材图组合出 15 行:同一人物可搭配多件服装,同一服装可复用到不同人物;实际使用时可按需自由排列,每行一组搭配。填好后,在飞书群聊选择「图灵系列 → 换装」,再将 15 份示例结果回填到对应记录。可暂停、分步查看或重新播放。

1. 先选系列,再选功能表

多维表按「图灵 / 图极 / 图梦」系列分组,每种功能都有自己的表。例如做通用生图,打开「图灵系列-通用生图」;做换色,打开「图灵系列-换色」。不同功能需要不同素材与要求,请在对应的功能表里填写。

2. 一行一条任务,填好这一批记录

以「图灵系列-通用生图」为例:按需求填写 image、mask、提示词,并选择 model、供应商、size、quality、张数。纯文字生图填写提示词;需要参考图时上传 image,需要蒙版编辑时再使用 mask。可用选项与输入要求以当前表格及对应模型能力为准。

填写示例 · 以下为说明用的虚构内容
image提示词modelsize / quality张数生成图
商品参考图 A保留商品外观,生成暖色陈列场景选择表内可用模型按当前选项填写1执行后回填
商品参考图 B保留商品外观,生成简洁白底主图选择表内可用模型按当前选项填写1执行后回填
商品参考图 C保留商品外观,生成户外展示场景选择表内可用模型按当前选项填写1执行后回填

重复添加行,就能准备一批任务;「张数」是该行的出图参数。「生成图」用于接收结果,不需要在这里填写生成要求。

换一种功能,就填它对应的字段

  • 换色:素材图、颜色参考图、目标类型、目标颜色。
  • 换装:参考图、素材图、人体比例图、替换对象;补充提示词为选填,可留空,有额外要求时填写,例如「去除 logo」「修改动作」。
  • 分镜图:image、视频提示词、剧情时长、分镜数量、补充提示词。
  • 详情页:商品名称、主图、细节图、尺码图、logo图、模块顺序、配色要求、内容与设计要求;还有最终宽度、分隔高度百分比等版式参数。

以上列出各功能的主要业务字段,供你定位要填的内容;不代表所有列都必填。完整列名可在下方展开查看,具体按当前功能要求填写。

系列不同,参数列也不同

通用生图功能表素材与要求模型与出图参数
图灵系列image、mask、提示词model、供应商、size、quality、张数
图极系列image、提示词model、供应商、构图比例、分辨率、张数
图梦 5.0image、提示词供应商、size、张数

请使用当前系列表内的参数列。表格模板与可用模型可能更新,实际使用以你打开的功能表为准。

3. 到飞书群聊,启动对应系列与功能

填好多行后,打开配套的飞书群聊,在功能卡片中找到与表格一致的系列和功能。例如填的是「图灵系列-通用生图」,就在群聊选择「图灵系列」的「通用生图」。

群聊功能卡片示意 · 图灵系列

通用生图换背景换色换装动作裂变详情页细节图平铺图动作参考人物替换风格参考换脸换形象视角补全分镜图高质量女图

卡片里的「换色」「换装」「详情页」等按钮分别对应各自的功能表。填写完表格后,还要在群聊启动;普通聊天文字不会直接启动生成。你能看到的系列和功能以当前群聊开通内容为准。

4. 等待批量执行,回原表查看「生成图」

启动后,系统按当前功能的筛选规则读取符合条件的记录,批量执行任务,再将生成结果回填到原记录的「生成图」附件列。执行需要时间,可关注群聊任务反馈,完成后回原表集中查看这一批产物。

某行没有产物时,先核对该行素材与字段、当前启动的系列和功能,以及群聊里的任务反馈。处理中的任务先等待或查看原任务,避免重复启动同一批生成。

图灵系列:16 张功能表字段参考

以下列名来自实际多维表结构核对,包含输入、参数、结果与记录信息。展开对应功能即可查看。

图灵系列-分镜图
日期image视频提示词剧情时长分镜数量补充提示词model供应商sizequality生成图备注创建人
图灵系列-通用生图
日期imagemask提示词model供应商sizequality张数生成图备注创建人父记录
图灵系列-换背景
日期参考图素材图model供应商sizequality张数生成图备注创建人
图灵系列-换色
日期素材图颜色参考图目标类型目标颜色model供应商sizequality张数生成图备注创建人
图灵系列-换装
日期参考图素材图人体比例图替换对象补充提示词model供应商sizequality张数生成图备注创建人
图灵系列-动作裂变
日期image张数补充提示词model供应商sizequality生成图备注创建人
图灵系列-详情页
日期商品名称主图细节图尺码图logo图模块顺序配色要求内容与设计要求model供应商quality最终宽度分隔高度百分比生成图备注创建人
图灵系列-细节图
日期参考图细节位置提示词补充提示词model供应商sizequality张数生成图备注创建人
图灵系列-平铺图
日期image目标类型model供应商sizequality张数生成图备注创建人
图灵系列-动作参考
日期素材图参考图动作model供应商sizequality生成图备注创建人
图灵系列-人物替换
日期素材图参考图model供应商sizequality张数生成图备注创建人
图灵系列-风格参考
日期参考图素材图人体比例图补充提示词model供应商sizequality张数生成图备注创建人
图灵系列-换脸
日期素材图人脸图model供应商sizequality张数生成图备注创建人
图灵系列-换形象
日期参考图素材图人脸图人体比例图替换对象补充提示词model供应商sizequality张数生成图备注创建人
图灵系列-视角补全
日期参考图商品品类目标视角model供应商sizequality生成图备注创建人
图灵系列-高质量女图
日期服装图片角色图片写真风格场景方向姿态动作提示词补充要求model供应商sizequality张数生成图备注创建人
07 / CLI & TASKS

从一次生成,到结果交付

下面示例使用 macOS / Linux 的默认 Skill 路径。Windows 请将 sh "$HOME/.agents/skills/aigc-cli/run.sh" 换成 & "$HOME\.agents\skills\aigc-cli\run.ps1"。若安装到自定义位置,请使用实际绝对路径。

1. 读取能力目录

能力发现
sh "$HOME/.agents/skills/aigc-cli/run.sh" scripts/capabilities.py --refresh
sh "$HOME/.agents/skills/aigc-cli/run.sh" scripts/catalog.py --model 图灵2.0

2. 生成并等待完成

图片生成示例
sh "$HOME/.agents/skills/aigc-cli/run.sh" scripts/generate.py \
  --model 图灵2.0 \
  --prompt '白底商品摄影,柔和光线,清晰细节' \
  --wait

指定 --local-output-dir /absolute/output 可等待完成并下载到运行 CLI 的设备。参考素材使用本地绝对路径;根据模型选择对应素材参数。

3. 查询任务与下载文件

将 TASK_ID 与文件路径换成实际值
sh "$HOME/.agents/skills/aigc-cli/run.sh" scripts/task_result.py status TASK_ID --detail
sh "$HOME/.agents/skills/aigc-cli/run.sh" scripts/task_result.py files TASK_ID
sh "$HOME/.agents/skills/aigc-cli/run.sh" scripts/task_result.py download TASK_ID RELATIVE_PATH -o /absolute/output.png

任务等待与恢复

  • --wait 超时不代表任务停止。保留任务 ID,继续查询原任务。
  • 提交响应丢失时,使用 scripts/task_result.py request-status REQUEST_ID 查找原请求。
  • 部分成功时先查看文件列表,保留已有结果;下载失败时补下载原任务。
  • 任务并发与执行重试由后端负责,客户端无需再建立一层生成队列。

不要因为等待超时、网络中断或回写失败就再次提交生成。先按原任务 ID 或请求 ID 恢复,避免产生重复任务与费用。

08 / LIVE CATALOG

当前可用的创作能力

下面直接读取服务端的公开能力目录。新增能力、模式与参数以实时接口及工作台表单为准,本文不维护另一份固定模型矩阵。

正在读取当前能力目录…

模型名称相同,不代表所有功能、素材类型和参数范围都相同。正式提交前请刷新目录,再查看对应功能的帮助与参数。

09 / FAQ

常见问题

为什么官网可以打开,画布却需要登录?

官网用于公开展示。画布与生成任务归属于组织,包含组织素材与工作内容,需使用组织管理员或成员账号。请使用首页的“打开无限画布”按钮,填写准确的组织名称。

没有组织名称或账号,如何开始?

请向提供服务的管理员申请组织与账号。公开官网暂不提供自助开通。已有飞书群聊也需要完成组织和人员绑定后才能使用。

安装后,Harness 没有发现 Skill?

确认安装目录是该 Harness 实际读取的 Skill 目录,然后重新打开会话。默认目录为 ~/.agents/skills,可在安装前设置 AIGC_SKILLS_ROOT。先通过 manage.py doctor 检查运行环境。

提示 401 或登录失效怎么办?

在终端重新执行 manage.py login,并按照提示输入组织名称、用户名与密码。网页登录与本地 Skill 的会话分别在各自入口管理。密码只在终端隐藏输入。

刷新能力目录提示 revision 不一致?

这表示本地完整能力快照与服务端已有变化。请联系管理员提供包含最新完整快照的 Skill 包,再刷新目录。不要通过禁用预检、手工修改 revision 或重复提交任务来绕过检查。

飞书批量生成,具体从哪里开始?

先打开对应模型系列下的功能表,按一行一条任务填好素材、要求与参数。然后到飞书群聊,点击对应系列和功能的卡片按钮,等待批量执行;完成后回原表查看「生成图」。

生成一直在等待,可以重新提交吗?

先按原任务 ID 查询。等待超时不会自动取消后台任务;提交响应丢失时按原请求 ID 恢复。重复提交会成为新的生成请求。

有固定价格表或免费试用吗?

本页面不展示未经核实的价格或试用承诺。实际模型价格、组织积分与权限由管理员配置;请向服务管理员确认。

YOUR CREATIVE SPACE

进入你的创作空间

填写管理员提供的组织名称,前往组织专用登录页。

还没有组织账号?请联系为你提供服务的管理员开通。了解组织与账号 →

联系我们

联系方式二维码