pengfeiqiao/kunpeng · 上手攻略

  • 仓库:pengfeiqiao/kunpeng
  • 链接:https://github.com/pengfeiqiao/kunpeng
  • 分类:AIGC 创作 / 视频 Agent / 桌面应用
  • 作者:Jay
  • 更新:2026-08-26

是什么

鲲鹏(Kunpeng)是一款跑在本地的中文 AIGC 创作工作台,基于 Tauri(React + Rust) 构建的 macOS 桌面应用。定位是"真实商业短片项目里打磨出来的全链路视频 Agent"——从 AI 剧本生成、画布编排、流水线工坊到智能剪辑,全流程一站式闭环,本地运行,完全开源。

核心特点:内嵌 DeepSeek Harness 引擎(ACP/MCP 桥接),同时还接入 GLM-5.3、Kimi K3、MiniMax M3、通义 Qwen3.8、豆包 Seed 2.1 等多家大模型,自研 agent loop 统一调度,支持智能降级。内置 AI 剧本工坊、AI 画布(自然语言指挥节点编排)、故事板预演、视频生成流水线等影视级功能。

解决什么问题

AIGC 视频创作目前的痛点: - 各工具分散(剧本 / 生图 / 生视频 / 剪辑需要切换多个平台) - AI 味重(文案生硬、镜头缺乏叙事逻辑) - 提示词调试成本高(难以复制到其他场景) - 商业项目闭环难(素材管理混乱、工序无法复用)

鲲鹏的解法:全链路本地工作台 + 剧本驱动的流水线 + 内置去 AI 化审阅,让创作者不需要在五六个工具之间来回横跳。

快速安装

下载安装包

# 1. 从 Releases 页面下载最新的 .dmg
#    https://github.com/pengfeiqiao/kunpeng/releases

# 2. 拖入「应用程序」文件夹

# 3. macOS 未签名提示的解法(二选一):
#    A. Finder 右键 → 打开 → 弹窗点「打开」
#    B. 系统设置 → 隐私与安全性 → 底部找到拦截记录 → 仍要打开

# 4. 若提示「已损坏」,终端执行:
xattr -cr /Applications/鲲鹏.app

初始化配置

  1. 启动后按引导填入 DeepSeek API Keyplatform.deepseek.com 注册获取)
  2. 其他模型(GLM / Kimi / MiniMax / Qwen / 豆包)可在设置中按需配置
  3. DeepSeek 模式可在 Harness 引擎内置 Agent 模式之间一键切换

源码构建(开发者)

# 环境要求:Node.js 24+、Rust 工具链(rustup)、macOS

# 安装依赖
npm install
npm ci --prefix dsh-runtime
npm run setup:dsh-node   # 下载内嵌 Node 运行时(首次构建需要)

# 开发模式(热更新)
npm run tauri:dev

# 打包(纯净版,不含私人资源)
npm run tauri:build

核心用法

1. 对话式创作(最简路径)

在对话窗口输入自然语言需求,例如:

「帮我把这张参考图做成 15 秒的口播视频分镜」

观察 Agent 调用工具、产出结果的全过程。两种模式可切换:对话编程(vibe coding)AI 内容创作

2. 工坊流水线(剧本 → 成品)

剧本上传 → AI 自动拆解剧情/镜头/角色 → 生成资产图 → 输出每镜专属视频提示词

所有素材在结构化表格中规整呈现,可单独提取、修改、迭代;流水线资产可一键导入画布精修,调整完再流回流水线批量出片。

3. AI 画布

自然语言指挥 AI 搭建画布、排布节点、优化画面结构,全程不需要手动操作节点:

「把这个镜头改成远景,换一个暖色调背景」

4. 故事板 & 导演预演

  • 自动读取剧本生成导演约束版 / 九宫格版故事板
  • 内置导演台白模预演:先预演镜头调度与节奏,确认后再生成视频
  • 两套顶配提示词模板,适配 Seedance 2.0 / 2.5 模型质感

5. AI 精细剪辑

  • 自动剔除口播水词、优化语句节奏
  • 配音用豆包精修,再导入工作流精准音画匹配

支持的模型渠道

渠道 模型 协议 备注
DeepSeek Harness ACP/MCP(推荐) 需 API Key
智谱 GLM GLM-5.3 / 5.2 Anthropic 兼容 需 API Key
Kimi K3 系列 原生视觉 + 1M 上下文 需 API Key
MiniMax M3 / M2.7 / M2.5 Anthropic 兼容,1M 上下文 需 API Key
通义 Qwen qwen3.8-max 等 百炼 DashScope 需 API Key
豆包 Doubao Seed 2.1 火山方舟 需 API Key
模态 引擎/渠道
视频生成 Seedance 2.0/2.5、MiniMax H3、Omni MG、即梦本地 CLI
图像生成 Seedream 系、GPT-Image 系、Midjourney 系
语音/ASR 豆包语音(双通道)

典型适用场景

  1. 商业短片全链路制作:剧本 → 分镜 → 素材 → 成片,一站式
  2. AI 视频创作者的工作流管理:资产库 + 提示词库 + 项目归档
  3. 视频工作室的定制化:源码开放,可嵌入自有 Agent、改造工作流
  4. 去 AI 化的文案/脚本处理:内置审阅模式消除机器腔

坑与注意

坑点 说明
macOS only 目前只有 macOS 版本,Apple Silicon 为主;Windows 移植暂无计划
非专业程序员从零迭代 代码有临时迭代冗余(作者自述"屎山"),但商用实战已稳定跑通
AI 精细剪辑有局限 商用高精度成片建议外接专业剪辑软件
第三方渠道自配 视频/图像/语音渠道为用户自配,项目不做商业担保
DeepSeek Harness 需额外了解 DeepSeek 模式依赖 Harness 引擎,新用户有一定学习曲线
API Key 全自配 无内置免费调用额度,需自行准备各平台 API Key

与同类对比

工具 定位 优势 劣势
鲲鹏 Kunpeng 本地全链路视频 Agent 本地运行、DeepSeek Harness 嵌入、多模型统一调度、源码开放 macOS 独占、非专业程序员维护
Coze / Dify 在线 Agent 构建平台 生态成熟、插件多 不专注视频、无本地部署
Runway / Pika / Sora 纯视频生成 生成质量高 非全链路、无本地控制
剪映 / CapCut 剪辑工具 + AI 功能 用户基数大、国产友好 非 Agent 化、非开源
ComfyUI + Deforum 本地 AI 视频/图像 完全可控、开源生态 门槛高、无剧本级工作流

Kunpeng 的差异化:本地 + 全链路 + DeepSeek Harness + 多模型路由,在开源 AIGC 视频工作台中是少数具备完整剧本→成品闭环的方案。

一句话推荐结论

如果你做 AIGC 视频创作已经离不开 Codex、同时又需要管理剧本/素材/提示词的全生命周期,鲲鹏是目前开源生态里最接近"本地版商业视频 Agent 工作站"的选择——macOS 用户优先,代码有一定维护风险(Beta 状态),适合能接受折腾的深度用户。


原始来源: - README: https://github.com/pengfeiqiao/kunpeng(main 分支,2026-08-26) - Contributing: https://github.com/pengfeiqiao/kunpeng/blob/main/CONTRIBUTING.md - Changelog: https://github.com/pengfeiqiao/kunpeng/blob/main/CHANGELOG.md - Releases: https://github.com/pengfeiqiao/kunpeng/releases

⚠️ 未确定处:Node.js 24+ 的具体最低版本要求未标注;Rust 工具链版本要求未明确;各视频/图像渠道的 API 密钥配置细节需参考各渠道官方文档;deepseek harness 引擎版本号(v2506/v2507 等)未在 README 中标注。