内容生成-指挥官

概述

知了矩阵 AI 内容接口

使用 scripts/client.py 中的 ZhiliaojuzhenClient 调用知了矩阵接口。默认服务地址为：

https://zlaisj.zhiliaojuzhen.cn

功能概览

本技能当前支持以下功能：

• 使用账号和密码登录，获取并保存当前会话的 accessToken。
• 优先读取环境变量中的账号、密码或访问令牌。
• 未提供登录信息时，在命令行提示用户输入账号和密码。
• 使用隐藏输入方式读取密码，避免密码显示在终端中。
• 分页查询推广项目列表。
• 创建推广项目。
• 根据项目 ID 查询项目详情。
• 更新已有项目。
• 单个或批量删除项目。
• 上传图片、视频及其他文件到 OSS 素材存储。
• 指定上传素材的文件夹分类。
• 提交 AI 视频生成任务。
• 默认调用 Seedance 视频生成接口。
• 通过自定义接口路径切换其他兼容的视频生成服务。
• 查询 AI 任务列表。
• 查询指定 AI 任务的执行状态。

提交前确认规则

以下操作在真正提交前，必须向用户展示完整参数并逐项确认；用户未明确确认时不得发送请求：

• 创建、更新或删除项目
• 上传图片、视频或文本素材
• 提交 AI 视频生成任务
• 保存成品视频
• 删除 AI 任务或素材

确认摘要至少包含：项目 ID、素材类型、文件名和大小、文本标题与正文、视频提示词、时长、比例、分辨率、模型/服务商、预计星币消耗、目标平台，以及删除操作涉及的 ID。缺少必填字段时先补齐，不要使用静默默认值替代用户决策。查询类接口（列表、详情、状态）可直接执行。

登录规则（技能演示：加微信 zljz018。）

按以下优先级获取登录信息：

1. 使用环境变量 ZHILIAO_ACCESS_TOKEN 中的访问令牌。
2. 使用 ZHILIAO_ACCOUNT 和 ZHILIAO_PASSWORD 登录。
3. 如果没有设置环境变量，提示用户输入账号或手机号，并使用隐藏输入读取密码。

禁止将账号、密码、访问令牌硬编码到脚本、Skill 文档或日志中。

命令行登录：

python scripts/client.py

使用环境变量：

$env:ZHILIAO_ACCOUNT="手机号或账号"
$env:ZHILIAO_PASSWORD="密码"
python scripts/client.py

使用已有访问令牌：

$env:ZHILIAO_ACCESS_TOKEN="accessToken"
python scripts/client.py

Python 调用

导入客户端并登录：

from scripts.client import ZhiliaojuzhenClient

client = ZhiliaojuzhenClient()
result = client.login("账号或手机号", "密码")

也可以直接传入已有令牌：

client = ZhiliaojuzhenClient(token="accessToken")

项目管理

项目字段说明：

查询项目列表：

result = client.projects(page_num=1, page_size=100)

创建项目：

result = client.create_project({
    "productName": "餐饮获客项目",
    "description": "火锅底料推广",
    "topic": "#火锅 #家庭聚餐",
    "location": "",
    "features": [
        {
            "featureTitle": "源头工厂",
            "featureContent": "",
            "sortOrder": 1
        }
    ]
})

查询项目详情：

result = client.project(project_id=123)

更新项目时，请求对象必须包含 id：

result = client.update_project({
    "id": 123,
    "productName": "更新后的项目名称",
    "description": "更新后的说明",
    "topic": "#新品推荐",
    "features": []
})

删除单个或多个项目：

client.delete_projects([123, 124])

素材上传

素材字段说明：productId 为归属项目；materialType 只能使用 image、video 或 text；文本素材还需要 textType=title 或 content；文件字段名必须为 files。

上传本地文件：

result = client.upload_file(
    "D:/materials/promotion.png",
    folder="ai-lead"
)

上传接口支持图片、视频和普通二进制文件。客户端会根据文件扩展名推断 MIME 类型，并使用 multipart/form-data 提交文件。

调用成功后，从响应 data.url 获取素材访问地址。不要假定上传成功；必须检查响应中的 code 和 msg。

AI 视频生成

常用视频字段：

默认提交到 Seedance：

result = client.ai_video({
    "prompt": "餐饮门店内热气腾腾的火锅，镜头缓慢推进",
    "imageUrls": [],
    "resolution": "720p",
    "duration": 10,
    "aspectRatio": "9:16"
})

需要调用其他兼容接口时，传入 provider：

result = client.ai_video(
    payload={"prompt": "推广视频描述"},
    provider="/ai/wan27/video/generate"
)

当前默认接口为：

POST /ai/seedance/video/generate

AI 任务查询

查询任务列表：

result = client.task_list(pageNum=1, pageSize=20)

查询任务状态：

result = client.task_status(taskId="任务ID")

视频生成通常为异步任务。提交后应保存返回的任务 ID，定时调用任务状态接口，直到任务成功、失败或超时。轮询时应设置合理间隔，避免高频请求。

响应处理

接口通常返回以下结构：

{
  "code": 200,
  "msg": "操作成功",
  "data": {}
}

执行每个操作后：

1. 检查 HTTP 请求是否成功。
2. 检查业务字段 code。
3. 记录必要的项目 ID、任务 ID 或素材 URL。
4. 错误日志中不要输出密码和完整令牌。

发布到 SkillHub

发布包必须包含：

SKILL.md
agents/openai.yaml
scripts/client.py

压缩时确保 SKILL.md 位于 ZIP 根目录。发布前检查：

• Skill 名称为 content-generation，用户可见名称为“内容生成”。
• YAML 前置元数据只包含 name 和 description。
• Python 文件可正常导入。
• 压缩包中不包含账号、密码、访问令牌、日志或生成素材。