Wlain/deepseek-plugin

可灵 AI for DeepSeek Harness

一句话，让灵感从想法变成大片。在 DeepSeek Harness 中直接用自然语言调用
可灵 AI，支持文生图、图生图、文生视频、图生视频、参考图创作、任务跟踪和
结果预览。

功能

- 文生图、图生图，制作海报、插画、人像、产品图、电商主图和广告素材
- 文生视频、图生视频与动作控制，制作产品展示、营销短片、社交媒体视频和电影感内容
- 上传参考素材，查询灵感值、生成进度和历史任务
- 通过浏览器完成可灵账号 OAuth，不需要在对话中粘贴 API Key
- 生成前展示最终参数并等待确认，每个确认过的意图只提交一次
- 在 DeepSeek Harness 工具卡中直接预览已完成的可灵图片或视频，并保留原始结果链接

安装

直接安装固定的 v1.0.0 版本：

dsh plugin --profile web add github:klingai-dev/deepseek-plugin#v1.0.0
dsh web --host 127.0.0.1 --port 3080

首次启动时，保持 dsh web 进程运行，在自动打开的浏览器页面完成可灵账号授权，
然后新建一个 Harness 会话。

使用

输入 /kling-ai，再用自然语言描述你想要的图片或视频。插件会补齐真正影响结果的
必要信息，在计费生成前展示模型、提示词、画幅、时长或分辨率与数量，并等待确认。
提交后只跟踪同一个任务，不会因超时或结果不明确而重复生成。

例如：

- 生成一张电影感图片：一只穿复古宇航服的小熊猫漂浮在空间站舷窗前，16:9
- 制作一段 5 秒电影感视频：机甲战士从高空重砸地面，镜头快速推近，16:9
- 检查当前授权和灵感值，不要创建生成任务

灵感值不足时，请充值后再试。完成后会返回任务编号和可灵提供的主要结果链接；
临时链接失效后，可以使用原任务编号重新查询。

结果链接可能包含用于访问 CDN 的签名查询参数。插件必须逐字保留完整链接，并用
简短的“打开生成结果”标签承载，不得删除 ? 后的参数、只保留文件路径或把长链接
直接铺在正文中。若无法取得完整链接，插件会保留任务编号并提示重新查询，而不会
重复生成。

本地开发与验证

DeepSeek Harness 插件通过 Harness 官方 MCP tools bridge 和固定版本
mcp-remote 的标准 OAuth 流程连接国内服务。安装包只注册
cordis.patch.yml 中的 https://klingai.com/mcp，并且只创建一个
Plugin-DeepSeek-kling-ai MCP 客户端。

git clone https://github.com/klingai-dev/deepseek-plugin.git
cd deepseek-plugin
npm install
npm run build
npm run check
npm run verify:bridge
npm run verify:installed
dsh plugin --profile web add "$PWD"
dsh web --host 127.0.0.1 --port 3080

verify:bridge 只使用本地假 OAuth/MCP；verify:installed 只在临时
DSH_HOME 内安装和合成配置，不读取或改写现有 Harness profile。

运行 dsh --profile web --dump-config 可在授权前检查有效配置；输出中应只出现
一个 Plugin-DeepSeek-kling-ai 客户端和国内 MCP 地址。

首次启动时 mcp-remote 会打开浏览器完成 Kling OAuth。配置通过
--static-oauth-client-metadata 固定 DCR client_name 为
Plugin-DeepSeek，携带 X-Kling-Integration: Plugin-DeepSeek，并把 callback
等待时间从上游默认 30 秒延长到 180 秒。保持
dsh web 进程运行，完成授权后新建 Harness 会话，输入 /kling-ai
加载计费安全流程。真实工具名使用
mcp__Plugin-DeepSeek-kling-ai__ 前缀。

Harness 官方 MCP 客户端 0.1.0-rc.6 目前只桥接 tools，不消费 MCP resources，
也没有标准 MCP Apps 容器。本包因此不复制远端 App、不注册第二个 MCP server，
而是使用 Harness 官方 tool.call.toolview 扩展点提供一个宿主原生结果卡：它只从
同一次可灵工具调用保留下来的文本结果中读取完整 https://.klingai.com 媒体 URL，
内嵌预览图片或视频，并保留原始链接。它不是 MCP App，也不会调用工具、自动刷新或
提交生成；真实生成仍由远端 MCP 完成并受 Skill 的确认与单次提交约束。

跨平台呈现契约

- 不复制或链接仓库根目录的本地 mcp-app/，不把 Harness 原生结果卡称为 MCP App。
- 结果卡只承担呈现，不调用工具、不拥有轮询、不改变计费与任务状态；无法识别媒体时
保持普通工具结果回落。
- Harness 官方 MCP 客户端增加 resources consumer 后，直接消费远端
_meta.ui.resourceUri，届时删除此宿主适配，避免与标准 MCP App 重复呈现。

OAuth bridge 边界

本包固定 mcp-remote@0.2.0，不使用会随时间漂移的 @latest。仓库的
npm run verify:bridge 会用本地假 OAuth/MCP 服务验证 protected-resource
discovery、动态注册、Plugin-DeepSeek 客户端名、S256 PKCE、token endpoint、
Bearer 重试和 tools/list；测试不会打开真实浏览器、读取凭据或调用 Kling。

上游仍有运行中 access/refresh token 同时失效后 callback listener 未重建的
问题 #248，以及异常退出后旧
callback 端口冲突的问题 #253。
遇到授权过期时先停止并重新启动 dsh web，只完成新进程打开的一次授权。
不要反复点击多个旧授权页，也不要直接分享 ~/.mcp-auth 或 --debug 产生的
原始日志；其中可能包含 OAuth 状态和敏感诊断信息。