Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions plugins/Wlain/kling-ai/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2026 KLING AI Pte Ltd

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
70 changes: 70 additions & 0 deletions plugins/Wlain/kling-ai/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
# 可灵 AI

通过可灵国内远程 MCP,在 MiniMax Code 中创建和查询图片、视频与动作任务。插件只连接 `https://klingai.com/mcp`,不启动本地 MCP server,也不包含 API Key、Token 或 Cookie。

## 试一试

```text
使用可灵生成一张 16:9 的电影感雨夜城市图片。
```

预期行为:MiniMax Code 先通过系统浏览器连接用户的可灵账号,加载远程工具;参数明确后只提交一次生成任务,并返回任务编号和当前结果。

## 功能

- 文生图、图生图与参考素材创作
- 文生视频、图生视频与动作控制
- 查询账号灵感值、任务状态和已有结果
- 上传素材与管理可复用 Element
- 保留 `generationId` / `taskTraceId`,避免结果不明确时重复计费提交

## 要求与当前兼容性

- 中国大陆可灵账号;服务端点固定为 `https://klingai.com/mcp`。
- 真实生成可能消耗账号灵感值,具体以可灵账号和实时工具说明为准。
- 需要 MiniMax Code 支持受保护远程 MCP 的 OAuth discovery、动态客户端注册或宿主管理的预注册客户端,以及 Authorization Code + S256 PKCE。

MiniMax Code 3.0.67 可以发现本插件和三个 Skills,但当前公开 runtime 没有在远程 MCP 返回标准 `401` 后启动浏览器 OAuth,因而无法完成 `tools/list` 和工具注入。MiniMax Code 的公开 Agent Plugin 契约也说明 generic OAuth 尚不是公开能力。该兼容性问题正在 [MiniMax Code issue #120](https://github.com/MiniMax-AI/minimax-code/issues/120) 跟踪;在宿主完成支持和真实联调前,本贡献只能作为 Draft 评审,不宣称实时 MCP 已可用。

## OAuth 与安全边界

- 登录和 token 生命周期必须由 MiniMax Code 管理;插件不会要求用户在对话中粘贴凭据。
- `X-Kling-Integration: Plugin-MiniMaxCode` 只是非秘密集成标识,不是授权头或 OAuth 客户端名。
- 每个明确的生成意图至多提交一次。失败、超时或结果未知时先查询原任务,不盲目重试。
- 退出或切换账号、删除 Element 等状态变更只在用户明确要求时执行。

## 数据与网络

- 业务网络目标是 `https://klingai.com/mcp`,以及可灵工具响应中明确返回的一次性上传地址或结果地址。
- 用户提示词、明确提供的参考素材和生成参数会发送给可灵以完成所请求的操作。
- 账号凭据由宿主管理,不进入插件文件、对话或日志。
- 工具返回的签名地址可能包含临时访问能力,不应复制到诊断日志或公开 Issue。

## 包结构

```text
kling-ai/
├── plugin.json
├── mcp.json
├── README.md
├── LICENSE
└── skills/
├── kling-ai/
├── kling-ai-generate-image/
└── kling-ai-generate-video/
```

## 验证

在 `MiniMax-Code-Plugins` 仓库根目录运行:

```bash
npm install
npm run check
```

静态校验覆盖目录布局、Manifest、MCP transport、Skills、许可证、占位符和路径安全。真实 runtime 验收还必须在支持 OAuth 的 MiniMax Code 构建中完成浏览器授权、`tools/list`、只读账号查询和一次用户确认后的生成测试。

## 许可证

[MIT](./LICENSE)
12 changes: 12 additions & 0 deletions plugins/Wlain/kling-ai/mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"kling-ai": {
"type": "streamable-http",
"url": "https://klingai.com/mcp",
"headers": {
"X-Kling-Integration": "Plugin-MiniMaxCode"
}
}
}
}
20 changes: 20 additions & 0 deletions plugins/Wlain/kling-ai/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "kling-ai",
"version": "0.1.0",
"description": "通过 MiniMax Code 中的可灵远程 MCP 创建和查询图片、视频与动作任务。",
"author": {
"name": "KLING AI Pte Ltd",
"url": "https://klingai.com"
},
"homepage": "https://klingai.com",
"repository": "https://github.com/MiniMax-AI/MiniMax-Code-Plugins/tree/main/plugins/Wlain/kling-ai",
"license": "MIT",
"keywords": [
"minimax-code",
"kling-ai",
"image-generation",
"video-generation",
"mcp"
]
}
66 changes: 66 additions & 0 deletions plugins/Wlain/kling-ai/skills/kling-ai-generate-image/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
---
name: kling-ai-generate-image
description: 通过 MiniMax Code 中的 Kling AI 生成高质量图像。支持文生图、图生图,适用于海报、产品摄影、广告创意和参考素材创作。
---

# Kling AI 图像生成

将创意需求转化为一条规格明确的 Kling 图像请求。仅使用在 `https://klingai.com/mcp` 配置的 MCP 所提供的实时工具和模式定义。

## 使用约定

- 使用 MiniMax Code 管理的远程 MCP OAuth。绝不请求或暴露 API key、token、cookie、授权头或签名 URL;宿主无法进入浏览器授权时停止并报告兼容性限制。
- 用户提出生成请求,即表示在补齐会实质影响结果的缺失输入后,授权提交一次任务。不要增加积分消耗警告或单独的确认步骤。
- 每个已批准的意图只提交一次。绝不盲目重试结果不明确或失败的提交。
- 先发现实时模式定义,再选择工具、模型、输入名称或枚举值。实时提供方字段优先于本文示例。
- 需要时,使用远程上传工具上传附带的参考媒体,并原样复用返回的提供方引用。

提交前阅读[完整 MCP 输入输出与当前模型参数快照](../kling-ai/references/mcp-contract.md),并用当次 `tools/list` / `who_am_i` 覆盖快照中的动态值。

## 工作流程

1. 使用下方模式表判断请求类型。
2. 对于产品、广告、缩略图、人像、编辑视觉或概念创作,阅读[场景模式](references/scene-patterns.md)。
3. 当需求模糊、包含参考图或精确文案,或者需要多个受控变体时,阅读[提示词构建](references/prompt-construction.md)。
4. 只询问会实质影响结果的缺失信息:主体或产品、用途、宽高比、必需文案或必须保持一致的参考身份。
5. 在满足生成模式和参考素材的实时模型中,优先完整质量模型;只有用户明确要求草稿、快速或省灵感值时才优先低成本或极速模型。
6. 构建一条提示词,分别说明主体、动作、环境、构图、光线、色彩、材质细节、镜头语言和排除项。把“高级、电影感、高质量”等抽象要求落实为可见的光线、材质、景深、色彩和构图,不要只堆砌形容词。
7. 信息足够后,只调用一次实时图像生成工具。保留准确的 `generationId` 及任何 `taskTraceId`。
8. 返回同一次调用的当前状态、文本或结构化回落和任务编号,不为了等待完成循环调用状态工具。用户之后明确查询时只查询同一任务一次。
9. 优先使用 MiniMax Code 自动呈现的原生工具结果。不要由 Skill 手写 Markdown 图片/视频语法、额外媒体附件或缩略图、重复下载链接;没有原生媒体呈现时只返回至多一个主图链接。将 `generationId` 显示为**任务编号**,除非故障排查需要,否则不对外显示 `taskTraceId`。

## 生成模式

| 用户意图 | 模式 | 必须采用的理解方式 |
| --- | --- | --- |
| 文生图 / text-to-image | 新建图像 | 不使用源图控制身份或构图,完全根据文字需求构建场景。 |
| 图生图 / image-to-image | 编辑或参考图引导的图像 | 至少一张图像用于控制内容、身份、产品结构、构图或风格。为每项输入明确指定角色。 |
| Element 参考主体 | 图生图 | 先读取 Element,确认它是图片主体,并只选择实时模式定义明确支持 `elements` 的图生图模型。文生图不使用 Element。 |
| 变体 / restyle | 聚焦单项变化的图生图 | 锁定源图中所有未指定的事实,并明确唯一允许改变的内容。 |
| 查进度 / status | 只读 | 不调用生成工具;查询已有任务。 |

不要静默切换模式。附带图像不等于自动要求图生图:如果用户要求生成一张无关的新图像,只有在确认附件与请求无关后才能忽略它。反过来,在上传或模式定义校验失败后,也绝不能把明确的图生图请求降级为文生图。

调用工具前,在内部检查所选模式、宽高比、参考图角色和允许的改动。除非需要用户澄清缺失的创意要求,否则不要显示提交前的过程消息。

## 质量优先的默认策略

- 普通交付默认使用实时模型支持的 `2k`;高质量、商用、广告、精细材质或需要后期裁切时使用 `4k`;只有草稿或速度优先时使用 `1k`。若模型默认分辨率更高,不要主动降级。
- 当实时模型提供 `quality` 参数时,普通交付使用中档,高质量或商用需求使用高档,草稿才使用低档;参数值必须来自实时枚举。
- 根据投放位置选择宽高比:`1:1` 用于方形社交媒体图或产品图,`4:5` 用于信息流竖图,`9:16` 用于故事或竖版封面,`16:9` 用于横幅或缩略图。
- 用户没有要求多个结果时只生成 `1` 张;不要用批量近似图替代清晰的创意决策。
- 除非用户明确要求在生成图中包含文字,否则优先生成无文字的干净图像。
- 制作变体时,每次已批准的生成只改变一个明确维度:概念、构图、色彩、镜头距离或表情。不要使用几乎重复的提示词。
- 将用户提供的品牌名称、标签、标志、人脸和产品结构作为锁定约束保留。绝不虚构功效、价格、认证、成分、效果或统计数据。

## 质量门禁

提交前,检查需求是否有一个清晰的焦点主体、易读的视觉层级、适合投放位置的安全区域、协调的光线,以及互不冲突的镜头或构图指令。如果宿主能够检查输出,应验证参考图还原度、文字准确性、主体数量和明显瑕疵。无法检查时,不要声称已完成视觉质检。

## 失败处理

- 授权失败:确认 MiniMax Code 是否对第三方远程 MCP 启动标准 OAuth;无法进入浏览器授权时停止,不改用 API Key。
- 参数不受支持:刷新实时模式定义,只修改被拒绝的字段。
- 积分不足:告知用户充值并停止。不要自动重试。
- 响应丢失:将任务是否创建视为未知;在进行任何新生成前,先查询已有任务。
- 提供方失败:报告提供方消息并保留各项 ID;不要自动重新提交。
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
# 图像提示词构建

## 提示词顺序

按以下顺序编写提示词:

1. 投放位置和媒介:产品照片、编辑人像、海报、缩略图、营销静帧。
2. 主体和锁定事实:身份、产品结构、准确色彩、官方标志或文案。
3. 动作或视觉创意。
4. 环境、时间、天气和氛围。
5. 构图:宽高比、取景、相机高度、镜头观感、视觉焦点层级、负空间。
6. 光线和色彩。
7. 材质、纹理、表面细节,以及写实或风格化程度。
8. 约束:主体数量、禁止改动项、不得添加额外文字或水印、安全区域要求。

## 参考素材清单

使用多项输入时,先说明它们的角色,再写创意提示词:

```text
参考素材 1 = 主要主体的身份
参考素材 2 = 产品结构和标签
参考素材 3 = 官方标志;保留准确形状和色彩
```

不要把风格参考图当作身份参考图。应描述其中可以迁移的特征。

## 精确文字

- 逐字保留用户提供的文案。
- 如果之后可以使用确定性的设计工具添加文字,优先生成有意预留文案安全区域的无文字底图。
- 如果用户明确要求把文字直接生成在图中,只写一次准确文案,要求不要出现其他可读文字,并提醒用户生成的文字排版可能需要复查。

## 受控变体

应分别生成提示词,不要请求一批几乎重复的图像。保持锁定事实完全一致,每次只改变一个维度:

- 概念:直白展示 / 人物场景 / 隐喻表达
- 镜头:微距 / 中景 / 环境广角
- 构图:居中 / 三分法重点位置 / 俯拍
- 情绪:明亮商业感 / 克制高级感 / 高饱和活力感
- 表情或动作

## 避免

- 缺少视觉依据的空泛赞美,例如“漂亮”。
- 互相冲突的指令,例如同时要求极简和密集分层,或者同时要求微距和完整环境广角。
- 重复正向需求的冗长负面清单。
- 未经验证的产品功效、医疗效果、价格、奖项、认证或统计数据。
- 未检查实时模式定义,就假设某个模型或参数一定存在。
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# 图像场景模式

选择符合用户投放位置的最小场景模式。用户提供的事实和品牌素材优先于下方所有建议。

## 产品与电商

- **目录或影棚图:**准确还原产品结构,使用中性或品牌色背景纸、受控的柔光箱反射、落地阴影、干净留白,不添加装饰性杂物。
- **生活方式场景:**展示产品在可信环境中被实际使用;确保手部、比例和互动符合物理规律。
- **特写演示:**围绕纹理、机械结构、使用过程或材质表面进行微距或紧凑裁切;保留足够语境以识别产品。
- **主视觉横幅:**使用宽幅构图,把产品置于一侧三分线重点位置,为真实排版文字有意预留负空间,并加强前景与背景分离。
- **电商平台辅图:**每幅画面只展示一个卖点或使用场景;避免未经验证的徽章、尺寸、宣传语或虚假界面。
- **概念产品视觉:**可以使用超现实悬浮、液体或飞溅、雕塑式布景、微缩世界或类似 CGI 的材质表现,但必须保留真实产品和标签。
- **风格重塑:**锁定主体结构和指定文案;只改变季节、环境、色彩、光线或造型。

## 广告与社交媒体

- **静态广告:**一个吸引点、一个主体、一项视觉证据和清晰的文案安全区域。避免让图像本身承载冗长营销文案。
- **UGC 静帧:**使用随意的相机高度、可信的居家或街头环境、自然的不完美感和真实的操作方式;不要虚构用户证言。
- **社交媒体轮播:**定义统一的色彩、镜头、光线、边距和产品比例,再为每一页赋予一个不同角色。
- **Pinterest 或编辑风格图钉:**使用竖向叙事、可感知的细节、分层景深,以及令人向往但可信的造型。
- **营销活动主视觉:**使用标志性轮廓、令人难忘的色彩机制、一个主导视觉隐喻和简化背景。

## 人物与身份

- **人像或编辑摄影:**明确取景、表情、视线、服装、背景、主光或补光或轮廓光,以及纹理。除非用户要求风格化,否则保持皮肤和面部结构自然。
- **参考身份:**按角色和顺序标明每张参考图。锁定骨骼结构、肤色、发际线、显著特征和年龄呈现,不要美化或平均化。
- **时尚或试穿:**保留服装剪裁、材质、图案、扣合方式、标志位置和合身效果;确保人体结构和布料张力可信。

## 封面与缩略图

- **YouTube 16:9:**使用一个主导人脸或物体、强烈的信息缺口、明亮的主体分离效果和极少杂物;保证小尺寸下可读,并真实反映视频内容。
- **短视频或故事 9:16:**把人脸和关键动作置于画面上部三分之二区域;为平台界面预留下方安全区域。
- **海报:**一个视觉主张、有意设计的层级、干净的文案区域、可识别的轮廓和受控色彩。
- 不要复制参考缩略图中的准确身份或构图。只提取通用的动感、取景、色彩和版式逻辑。

## 概念选择

当用户请求创意时,提出三个实质不同的方向,例如:

1. 产品事实——直白演示或准确还原的主视觉产品图。
2. 人物结果——通过生活方式场景展示使用和情绪。
3. 视觉隐喻——符号化、超现实或基于尺度反差的概念。

为每个方向标注用途、焦点主体、构图、色彩,以及它能快速传达信息的原因。
Loading