本机环境

MkBoard 本地 CLI 配置教程

按官方文档配置 Codex CLI、Claude Code、Node.js、FFmpeg、即梦 CLI 和 HyperFrames CLI，让 MkBoard 桌面端复用本机登录态完成分镜与视频草稿工作。

下载桌面端

先确认这些

  1. 本地 Agent 二选一：Codex CLI 或 Claude Code。MkBoard 用它读取当前脚本、分镜表和项目素材。
  2. HyperFrames 渲染需要 Node.js 22 或更高版本，以及可在终端直接执行的 FFmpeg。
  3. Seedance 2.0 视频生成需要即梦 CLI，并且本机即梦账号已经登录、余额可用。
  4. 安装完成后，回到 MkBoard 桌面端设置页，点击“重新扫描”。

MkBoard 不保存 Codex、Claude Code、即梦或 HyperFrames 的账号凭据，只复用你本机 CLI 已经完成的登录态。

官方来源

工具官方地址MkBoard 用途
Codex CLIOpenAI Codex CLI / openai/codex GitHub本地 Agent
Claude CodeClaude Code 安装 / Claude Code 认证本地 Agent
Node.jsNode.js 下载HyperFrames 运行环境
FFmpegFFmpeg Download / Homebrew ffmpegHyperFrames 视频编码
HyperFramesHyperFrames Quickstart / heygen-com/hyperframes GitHubHTML 视频渲染
即梦 CLI即梦官网 / CLI 安装地址Seedance 2.0 本机视频生成

本地 Agent

Codex CLI

Codex CLI 可作为 MkBoard 的本地 Agent，用来读取当前脚本、分镜表和项目素材，并生成结构化结果。官方入口见 OpenAI Codex CLI 和 openai/codex GitHub。

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex login --device-auth
codex login status

codex login status 是 MkBoard 桌面端用于确认登录态的自检命令。如果系统浏览器登录失败，优先使用 codex login --device-auth。

Claude Code

Claude Code 也可以作为本地 Agent。MkBoard 只检测本机 claude 命令和登录状态，不上传 Claude 登录凭据。官方入口见 Claude Code 安装 和 Claude Code 认证。

curl -fsSL https://claude.ai/install.sh | bash
claude auth login
claude auth status --json

claude auth status --json 是 MkBoard 桌面端用于确认登录态的自检命令。登录完成后重开终端再执行一次，避免 PATH 或登录态还没刷新。

渲染前置依赖

Node.js 22+

HyperFrames 需要 Node.js 22 或更高版本。先确认当前版本：

node --version

如果低于 v22 或没有安装，请从 Node.js 官方下载页 安装新版 Node.js。安装后重新打开终端，再执行 node --version。

FFmpeg

FFmpeg 必须能在系统终端直接执行，HyperFrames 才能编码视频。官方入口见 FFmpeg Download。macOS 使用 Homebrew 时，也可以参考 Homebrew ffmpeg 公式页。

macOS：

brew install ffmpeg
ffmpeg -version

Ubuntu / Debian：

sudo apt update
sudo apt install ffmpeg
ffmpeg -version

Windows：

  1. 打开 FFmpeg Download，进入 Windows builds。
  2. 选择官网列出的构建入口，例如 gyan.dev 或 BtbN，下载 release build。
  3. 解压后把 bin 目录加入系统 PATH。
  4. 重新打开 PowerShell，执行 ffmpeg -version。

如果 MkBoard 仍然显示未找到 FFmpeg，先确认你不是只在某个终端配置文件里临时加了 PATH。GUI 启动的桌面应用有时拿不到终端里的临时环境变量，重启 MkBoard 后再点“重新扫描”。

视频制作工具

HyperFrames CLI

HyperFrames 用于本机渲染 HTML 视频项目。官方入口见 HyperFrames Quickstart 和 heygen-com/hyperframes GitHub。MkBoard 会优先使用本机 hyperframes，如果没有全局安装，会尝试通过 npx 自动拉取官方包。

node --version
ffmpeg -version
npx hyperframes doctor
npm install -g hyperframes

HyperFrames 渲染需要 Node.js 22+ 和 FFmpeg。只检测到 npx 不代表渲染环境完整，仍需要确认 Node.js 和 FFmpeg。

即梦 CLI

即梦 CLI 用于 Seedance 2.0 本机视频生成。安装后需要登录，并确认账号余额可用。当前公开入口是 即梦官网 和官方 CLI 安装地址 https://jimeng.jianying.com/cli。

curl -fsSL https://jimeng.jianying.com/cli | bash
dreamina login
dreamina user_credit

常见问题

设置页显示未安装

确认对应命令在系统终端里能直接执行。GUI 启动的 Electron 应用有时拿不到完整 PATH，完成安装后可以重启 MkBoard 或点击“重新扫描”。

设置页显示需要登录

在系统终端执行对应 CLI 的登录命令。不要把第三方账号 token 或密钥填进 MkBoard。

HyperFrames 或 FFmpeg 检测失败

先确认：

node --version
ffmpeg -version
npx hyperframes doctor

Node.js 需要 22 或更高版本。FFmpeg 需要在 PATH 中可用。npx hyperframes doctor 如果提示 FFmpeg 缺失，先按上面的 FFmpeg 安装步骤处理。

即梦生成失败

先检查登录态和余额：

dreamina user_credit

如果命令提示未登录，执行 dreamina login 后回到 MkBoard 重新扫描。