@klingai/plugin-cn 0.0.0-stage → 0.0.2-beta

package/.claude-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
+  "name": "kling-universal",
+  "displayName": "可灵 AI",
+  "version": "0.0.2-beta",
+  "description": "使用可灵 AI 生成和编辑图片、创作可灵 4.0 视频，支持关键帧、全能参考、角色主体与动作控制。",
+  "author": {
+    "name": "Kling AI"
+  },
+  "homepage": "https://klingai.com",
+  "license": "Proprietary",
+  "keywords": [
+    "kling",
+    "image-generation",
+    "video-generation",
+    "claude-code"
+  ],
+  "mcpServers": "./.mcp.json",
+  "skills": "./skills/"
+}

package/.codex-plugin/plugin.json

@@ -0,0 +1,40 @@
+{
+  "name": "kling-universal",
+  "version": "0.0.2-beta",
+  "description": "使用可灵 AI 生成和编辑图片、创作可灵 4.0 视频，支持关键帧、全能参考、角色主体与动作控制。",
+  "author": {
+    "name": "Kling AI"
+  },
+  "homepage": "https://klingai.com",
+  "license": "Proprietary",
+  "keywords": [
+    "kling",
+    "image-generation",
+    "video-generation",
+    "codex"
+  ],
+  "mcpServers": "./.mcp.json",
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "可灵 AI",
+    "shortDescription": "一句话，让灵感从想法变成大片",
+    "longDescription": "使用可灵 AI 生成和编辑图片，以可灵 4.0、4.0 Flash 等可用模型创作视频，支持关键帧、全能参考、角色主体与动作控制，并管理素材、任务和灵感值。",
+    "developerName": "可灵 AI",
+    "category": "Creativity",
+    "capabilities": [
+      "Interactive",
+      "Read",
+      "Write"
+    ],
+    "websiteURL": "https://klingai.com",
+    "defaultPrompt": [
+      "生成一张电影感图片：一只小萨摩耶在开满野花的草地上快乐奔跑，阳光逆光，毛发细节清晰",
+      "使用可灵 4.0 生成一段 5 秒电影感视频：机甲战士从空中落地，碎石与尘土飞散，镜头快速推进",
+      "查询我的可灵任务状态，只查询，不创建新的生成任务"
+    ],
+    "brandColor": "#000000",
+    "logo": "./assets/kling-logo.png",
+    "logoDark": "./assets/kling-logo.png",
+    "composerIcon": "./assets/kling-logo.png"
+  }
+}

package/.mcp.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "kling-ai": {
+      "type": "http",
+      "url": "https://klingai.com/mcp/plugin",
+      "scopes": [
+        "generation.create",
+        "generation.read",
+        "account.credit.read"
+      ]
+    }
+  }
+}

package/.workbuddy-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
+  "name": "kling-universal",
+  "displayName": "可灵 AI",
+  "version": "0.0.2-beta",
+  "description": "使用可灵 AI 生成和编辑图片、创作可灵 4.0 视频，支持关键帧、全能参考、角色主体与动作控制。",
+  "author": {
+    "name": "Kling AI"
+  },
+  "homepage": "https://klingai.com",
+  "license": "Proprietary",
+  "keywords": [
+    "kling",
+    "image-generation",
+    "video-generation",
+    "workbuddy"
+  ],
+  "mcpServers": "./.mcp.json",
+  "skills": "./skills/"
+}

package/README.cn.md

@@ -0,0 +1,48 @@
+# 可灵 AI 插件
+
+在 AI 助手中使用可灵 AI 生成图片、创作视频、复用角色主体和控制动作。内置 CLI、创作 Skill 和 MCP 集成。
+
+需要 Node.js 18 或更高版本。本包适用于中国站账号；海外站账号请安装 `@klingai/plugin-global`。
+
+## 安装
+
+```bash
+npm i -g @klingai/plugin-cn@latest
+```
+
+安装时自动为默认支持的全部助手安装 Skill，无需选择助手。安装后重启助手，新建会话即可使用 **Kling AI Plugin**。
+
+## 快速开始
+
+在助手中输入：
+
+```text
+使用可灵 AI 插件，生成一张图片：一只柴犬坐在咖啡馆窗边。
+```
+
+首次使用时按提示完成登录。生成图片和视频会消耗灵感值，可用模型和功能以当前账号为准。
+
+也可以在终端使用内置 CLI：
+
+```bash
+kling-plugin login
+kling-plugin who_am_i
+```
+
+## 升级
+
+```bash
+npm i -g @klingai/plugin-cn@latest
+```
+
+升级后重启助手。
+
+## 检查与卸载
+
+```bash
+# 检查安装
+plugin-cn doctor --host all
+
+# 完整卸载，保留登录凭据和日志
+plugin-cn uninstall
+```

package/README.global.md

@@ -0,0 +1,48 @@
+# Kling AI Plugin
+
+Generate images and videos, reuse Elements, and control motion with Kling AI in your AI assistant. Includes a CLI, a creation Skill, and MCP integration.
+
+Requires Node.js 18+. This package is for Global accounts; use `@klingai/plugin-cn` for China-site accounts.
+
+## Installation
+
+```bash
+npm i -g @klingai/plugin-global@latest
+```
+
+Installation automatically adds the Skill for all default supported assistants. No assistant selection is needed. Restart your assistant and open a new conversation to use **Kling AI Plugin**.
+
+## Quick Start
+
+Ask your assistant:
+
+```text
+Use Kling AI Plugin to generate an image of a shiba inu sitting by a cafe window.
+```
+
+Follow the sign-in instructions when prompted. Image and video generation consumes credits. Available models and features depend on your account.
+
+You can also use the bundled CLI in your terminal:
+
+```bash
+kling-plugin login
+kling-plugin who_am_i
+```
+
+## Upgrade
+
+```bash
+npm i -g @klingai/plugin-global@latest
+```
+
+Restart your assistant after upgrading.
+
+## Check And Uninstall
+
+```bash
+# Check installation
+plugin-global doctor --host all
+
+# Uninstall; keep login credentials and logs
+plugin-global uninstall
+```

package/README.md

@@ -1,3 +1,48 @@
-# Temporary Holding Version
+# 可灵 AI 插件
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+在 AI 助手中使用可灵 AI 生成图片、创作视频、复用角色主体和控制动作。内置 CLI、创作 Skill 和 MCP 集成。
+
+需要 Node.js 18 或更高版本。本包适用于中国站账号；海外站账号请安装 `@klingai/plugin-global`。
+
+## 安装
+
+```bash
+npm i -g @klingai/plugin-cn@latest
+```
+
+安装时自动为默认支持的全部助手安装 Skill，无需选择助手。安装后重启助手，新建会话即可使用 **Kling AI Plugin**。
+
+## 快速开始
+
+在助手中输入：
+
+```text
+使用可灵 AI 插件，生成一张图片：一只柴犬坐在咖啡馆窗边。
+```
+
+首次使用时按提示完成登录。生成图片和视频会消耗灵感值，可用模型和功能以当前账号为准。
+
+也可以在终端使用内置 CLI：
+
+```bash
+kling-plugin login
+kling-plugin who_am_i
+```
+
+## 升级
+
+```bash
+npm i -g @klingai/plugin-cn@latest
+```
+
+升级后重启助手。
+
+## 检查与卸载
+
+```bash
+# 检查安装
+plugin-cn doctor --host all
+
+# 完整卸载，保留登录凭据和日志
+plugin-cn uninstall
+```

package/bin/plugin.mjs

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+
+import {
+  PACKAGE_NAME,
+  PLUGIN_BASE_URL,
+  PLUGIN_DISPLAY_NAME,
+  SUPPORTED_HOSTS,
+  DEFAULT_SKILL_HOSTS,
+  createInstallPlan,
+  displayPath,
+  doctor,
+  doctorSkillDirectory,
+  exposeCommand,
+  installHost,
+  installSkillDirectory,
+  parseArgs,
+  preflightInstallHosts,
+  resolveInstallHosts,
+  removeManagedObsoleteSkills,
+  stagePackage,
+  uninstallHost,
+  uninstallSkillDirectory,
+} from '../lib/install.mjs';
+import { uninstallAll } from '../lib/uninstall.mjs';
+
+function reportCommand(wrapper) {
+  console.log(`CLI: ${displayPath(wrapper)}`);
+  if (process.platform === 'win32') return;
+  const result = exposeCommand(wrapper);
+  if (result.status === 'linked') console.log(`Command: ${displayPath(result.path)} -> kling-plugin is available in new terminals`);
+  else if (result.status === 'conflict') console.log(`Command: kling-plugin was not linked (${result.reason}); run ${displayPath(wrapper)} directly or remove that file`);
+  else if (result.status === 'not-on-path') console.log(`Command: add ~/.kling/bin to PATH to run kling-plugin, e.g. echo 'export PATH="$HOME/.kling/bin:$PATH"' >> ~/.zshrc`);
+}
+
+function usage() {
+  const installerName = PACKAGE_NAME.split('/').at(-1);
+  return [
+    `${PLUGIN_DISPLAY_NAME} installer`,
+    '',
+    'Usage:',
+    `  ${installerName} install  # Install Skills for the checked Host set`,
+    `  ${installerName} install --host <${DEFAULT_SKILL_HOSTS.join('|')}|all>`,
+    `  ${installerName} install --skills-dir <path>`,
+    `  ${installerName} install --host <directory-host> --link-skills`,
+    `  ${installerName} install [--host <host>] --dry-run`,
+    `  ${installerName} doctor --host <host|all>`,
+    `  ${installerName} doctor --skills-dir <path>`,
+    `  ${installerName} uninstall [--dry-run]  # Remove all managed Skills, CLI and npm installs`,
+    `  ${installerName} uninstall --host <host> [--purge]`,
+    `  ${installerName} uninstall --skills-dir <path> [--purge]`,
+    '',
+    `${PACKAGE_NAME} has a fixed endpoint: ${PLUGIN_BASE_URL}.`,
+  ].join('\n');
+}
+
+try {
+  const { command, host, skillsDir, purge, dryRun, linkSkills } = parseArgs(process.argv.slice(2));
+  const installOptions = { skillsOnly: !host || host === 'all' };
+  if (command === 'help' || command === '--help' || command === '-h') {
+    console.log(usage());
+    process.exitCode = 0;
+  } else if (!host && !skillsDir && command !== 'install' && command !== 'uninstall') {
+    throw new Error(`--host or --skills-dir is required. Choose: ${SUPPORTED_HOSTS.join(', ')}, all`);
+  } else if (command === 'install') {
+    if (skillsDir) {
+      if (dryRun) {
+        console.log(JSON.stringify({
+          ...createInstallPlan([]),
+          customSkillsDir: displayPath(skillsDir),
+        }, null, 2));
+        process.exitCode = 0;
+      } else {
+        const staged = stagePackage();
+        const result = installSkillDirectory(skillsDir, staged, { linkSkills });
+        console.log(`[written] custom: ${displayPath(result.path)}`);
+        reportCommand(staged.wrapper);
+        console.log('Skill files written; Host discovery is not verified. Restart the Host or reload Skills, then start a new session.');
+      }
+    } else {
+      const hosts = resolveInstallHosts(host);
+      if (host && host !== 'all' && !DEFAULT_SKILL_HOSTS.includes(host) && host !== 'agents') {
+        console.error(`Unverified Host target: ${host}. This writes Skill files only; application discovery and invocation have not passed acceptance.`);
+      }
+      const preflight = preflightInstallHosts(hosts, { ...installOptions, linkSkills });
+      if (dryRun) {
+        console.log(JSON.stringify({ ...createInstallPlan(hosts, installOptions), preflight }, null, 2));
+        process.exitCode = 0;
+      } else {
+        const failedPreflight = preflight.filter((result) => result.status === 'failed');
+        const unavailable = preflight.filter((result) => result.status === 'unavailable');
+        const conflicts = preflight.filter((result) => result.status === 'conflict');
+        if (failedPreflight.length > 0 || (host !== 'all' && host !== undefined && (unavailable.length > 0 || conflicts.length > 0))) {
+          const reasons = [...failedPreflight, ...unavailable, ...conflicts]
+            .map((result) => `${result.host}: ${result.reason}`)
+            .join('; ');
+          throw new Error(`Install preflight failed: ${reasons}`);
+        }
+
+        const installableHosts = preflight
+          .filter((result) => result.status === 'ready')
+          .map((result) => result.host);
+        if (installableHosts.length === 0) {
+          throw new Error('No available Host remained after install preflight');
+        }
+
+        const staged = stagePackage();
+        const results = [...unavailable, ...conflicts].map((result) => ({
+          host: result.host,
+          status: 'skipped',
+          reason: result.reason,
+        }));
+        for (const item of installableHosts) {
+          try {
+            const result = installHost(item, staged, { ...installOptions, linkSkills });
+            results.push({ host: item, status: result.status, path: result.path });
+          } catch (error) {
+            results.push({ host: item, status: 'failed', reason: error.message });
+          }
+        }
+
+        console.log('Install summary:');
+        for (const result of results) {
+          const detail = result.path ? displayPath(result.path) : result.reason;
+          const status = result.status === 'installed' && (installOptions.skillsOnly || !['codex', 'claude', 'pi'].includes(result.host))
+            ? 'written' : result.status;
+          console.log(`  [${status}] ${result.host}: ${detail}`);
+        }
+        reportCommand(staged.wrapper);
+        console.log('Host discovery and invocation are not verified by installation. Restart the Host or reload Skills, then start a new session.');
+        if (results.some((result) => result.host === 'workbuddy' && result.status === 'installed')) {
+          console.log(`WorkBuddy: look for Kling AI Plugin under Installed Skills (user-defined); the plugin marketplace is separate.`);
+        }
+        if (!installOptions.skillsOnly && results.some((result) => result.host === 'codex' && result.status === 'installed')) {
+          console.log('Codex MCP OAuth is separate from kling login. Check: codex mcp list; if kling-ai is Not logged in, run: codex mcp login kling-ai. Then restart Codex and open a new session. UI rendering still depends on the Host.');
+        }
+
+        const failures = results.filter((result) => result.status === 'failed');
+        if (failures.length > 0) {
+          throw new Error(`${failures.length} Host installation${failures.length === 1 ? '' : 's'} failed`);
+        }
+        if (installOptions.skillsOnly) removeManagedObsoleteSkills(staged);
+      }
+    }
+  } else if (command === 'doctor') {
+    if (skillsDir) {
+      const result = doctorSkillDirectory(skillsDir);
+      console.log(JSON.stringify(result, null, 2));
+      if (!result.ok) process.exitCode = 1;
+    } else {
+      let result;
+      if (host === 'all') {
+        const plan = createInstallPlan(resolveInstallHosts('all'), { skillsOnly: true });
+        const results = plan.hosts.map(({ host: item, target }) => ({
+          host: item, path: target, ...doctor(item, { skillsOnly: true }),
+        }));
+        result = { ok: results.every((item) => item.ok), hosts: results };
+      } else {
+        result = doctor(host);
+      }
+      console.log(JSON.stringify(result, null, 2));
+      if (!result.ok) process.exitCode = 1;
+    }
+  } else if (command === 'uninstall') {
+    if (!host && !skillsDir) {
+      console.log(JSON.stringify(uninstallAll({ dryRun }), null, 2));
+    } else if (skillsDir) {
+      uninstallSkillDirectory(skillsDir, { purge });
+    } else {
+      const hosts = host === 'all' ? resolveInstallHosts('all', { includeUnverified: true }) : [host];
+      for (const item of hosts) uninstallHost(item, { skillsOnly: host === 'all', purge: purge && item === hosts.at(-1) });
+    }
+    if (host || skillsDir) console.log('Plugin registration removed. OAuth credentials and logs were preserved.');
+  } else {
+    throw new Error(`Unknown command: ${command}\n\n${usage()}`);
+  }
+} catch (error) {
+  console.error(`Error: ${error.message}`);
+  process.exitCode = 1;
+}

package/bin/postinstall.mjs

@@ -0,0 +1,16 @@
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { recordNpmInstallation } from '../lib/install.mjs';
+
+// npm exec / npx runs the user's installer arguments after fetching the package.
+// Installing here would turn --dry-run and single-Host operations into full installs.
+if (process.env.npm_command !== 'exec') {
+  const result = spawnSync(
+    process.execPath,
+    [fileURLToPath(new URL('./plugin.mjs', import.meta.url)), 'install'],
+    { stdio: 'inherit' },
+  );
+  if (result.error) throw result.error;
+  process.exitCode = result.status ?? 1;
+  if (result.status === 0) recordNpmInstallation(fileURLToPath(new URL('..', import.meta.url)));
+}