Kling Ai Plugin

---
name: kling-ai-plugin
description: 在 WorkBuddy 中通过 Kling AI 生成图像或视频，处理已有任务、素材上传、主体库、动作库、额度与账号连接。能力以当前账号的 MCP 返回为准；仅分析现有媒体且不调用 Kling 时不使用。
---

# 可灵 AI

使用本包 `mcp.json` 中的 `kling-ai-plugin` 连接器。OAuth 由 WorkBuddy 管理，不索取 API Key、不覆盖客户端注册信息，不在日志中保存凭证、私有账号字段或签名 URL。

## 按请求加载规则

- 图片生成、编辑、海报与参考图创作：使用 `kling-ai-generate-image`。
- 视频生成、关键帧、全能参考、动作控制与分镜：先读取[视频生成 Skill](../kling-ai-generate-video/SKILL.md)，默认推荐 `omni_ref_video` 的 可灵 4.0 模型；不能只读核心 Skill 和提交流程就调用生成工具。
- 只查进度、展示结果或刷新作品链接：只读[任务结果](references/task-results.md)，不加载生成推荐、模型参数或创作参考。
- 新生成、编辑或已授权重试：按对应创作 Skill 选型，再执行[生成提交](references/tool-workflows.md)；多步骤按依赖顺序执行。
- 主体库、动作库或本地文件上传：读[素材工作流](references/asset-workflows.md)。只读素材查询不提交生成任务。
- 生成前先读[能力发现](references/capability-discovery.md)，选定当前账号可用的模型后，按[参数模块加载表](references/model-parameters.md)只读本次需要且受支持的规则。
- 授权、上传、模型或服务错误：读[故障排查](references/troubleshooting.md)。需要请求示例时读[用法示例](references/prompt-examples.md)。

## 模型可见性与灰度

- 当前账号的模型、参数、规格、输入类型与组合限制，统一以 `who_am_i` 的实时返回为准。`tools/list` 只确认入口存在及调用结构；会员页、工具描述和静态示例不能覆盖账号能力。
- 只有当前连接的 `tools/list` 返回目标工具，且当前账号的 `who_am_i.availableModels` 在该工具下列出目标模型时，才可展示、推荐或调用其模型名。工具数量（即使增加了全能参考工具）、描述中的举例或默认模型字段不能代替模型集合的授权判断。
- 视频默认推荐 `omni_ref_video` 的 可灵 4.0 模型，图片默认推荐满足需求的可用图像模型；实际选型以当前账号返回的对应输出类型模型集合为准。
- 用户点名但当前筛选集合未返回时，按[能力发现](references/capability-discovery.md)补查后再判断。若模型实际可用但仅支持另一输出类型，说明用途不匹配，不说账号无权限，并让用户选择保留作品类型或改做该模型支持的作品；不自动切换媒体类型或模型。完整发现后仍未返回时，只说明当前连接未返回所请求模型，不补充或重复隐藏型号；替代仅列出实际可用且符合需求的模型。
- 重新连接、切换账号或环境后，重新发现工具和模型，不沿用先前账号的能力缓存。能力发现失败或无法确认模型属于当前集合时，不使用静态快照兜底提交。

## 创作与能力选择

视频选型（包括只读选型）也先读取视频 Skill：`omni_ref_video` 已全量开放，所有普通视频生成默认从该入口推荐 可灵 4.0。纯文本、图片、关键帧、主体库和音频输入按所选模型的实时约束构造；动作控制等专用需求按其必需能力选择入口。

用户已经明确的素材角色、模型、声音、画幅和质量要求直接采用，只询问会实质改变结果的缺失信息。用户指定且当前可用的模型优先；未指定时按输出类型选型：

| 输出类型 | 选型行为 |
| --- | --- |
| 图片 | 使用图像入口可用集合中的 `defaultModel`；不符合需求时选择同一输出类型中符合需求的模型 |
| 视频 | 默认推荐 `omni_ref_video` 已返回且符合需求的 可灵 4.0 系列模型；规范名/别名以实时响应为准。速度、预算、动作与素材限制优先于版本偏好；没有适用 可灵 4.0 时使用符合需求的可用默认模型，不提示未开放型号 |

新增入口只有明确支持用户的素材角色与意图时才参与选型；某入口可用的模型不得移到其他入口调用。所有选型都服从账号可见性规则，能力读取失败时停止。先满足身份/产品一致性、文字、动作和声音等必需能力，不自动提高分辨率、数量或降低要求，不能承诺尚未检查的成品质量。

查询已有作品与编辑已有作品是不同操作：状态、展示和刷新链接不生成新任务；用户明确要求编辑、变体或制作视频时，按共享流程刷新并选定源作品，再执行已授权的新步骤。多个步骤按依赖顺序执行，前一步未成功时不提交依赖它的下一步。

## 宿主与 UI

使用远端工具实际提供的 `_meta.ui.resourceUri`（兼容 `_meta["ui/resourceUri"]`）及 `text/html;profile=mcp-app` 资源。元数据存在不等于 widget 已成功挂载；刷新与文本回落按任务结果流程处理。包内不复制 widget HTML 或增加第二个 MCP server。

删除主体、退出或切换账号只在用户明确要求且目标清楚时执行。上传素材、查看额度或选中主体不构成生成授权。