# @conceptcraft/mindframes 中文文档

规范地址：https://npmcn.com/package/%40conceptcraft/mindframes/

版本：0\.3\.43
npm 元数据更新时间：2026-11-05T06:33:22.170Z
中文译文更新时间：2026-11-10T22:58:56.652Z
软件包许可：SEE LICENSE IN LICENSE

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40conceptcraft/mindframes
原文对照：https://npmcn.com/package/%40conceptcraft/mindframes/?lang=original
项目主页：https://conceptcraft.ai/

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.1 MB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.23\.4 \<23
- 运行依赖：13 个
- 首次发布：2026-01-21T06:57:15.387Z
- 最新版本发布：2026-11-05T06:33:21.815Z
- 近 30 天下载量：2475（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：84（近 12 个月 84 个）

## 中文简介

用 ConceptCraft 创建AI 驱动演示文稿的 CLI 工具

## 安装

```sh
npm install @conceptcraft/mindframes
```

也可以使用：`pnpm add @conceptcraft/mindframes`、`yarn add @conceptcraft/mindframes`、`bun add @conceptcraft/mindframes`

## README

# 思维框架CLI

用于命令行工具 [思维框架](https://www.mindframes.app/) - 演示、录像、相机、音频、, 品牌、媒体和研究.

运行 `mindframes capabilities` 随时随地的 完整、随时可用的清单 能力,以及 `mindframes <group> --help` 钻入一个.

## 安装

```bash
npm install -g @conceptcraft/mindframes
```

或直接使用 npx :

```bash
npx @conceptcraft/mindframes create "Topic" --context "your content"
```

## 设置

获取您的 API 密钥 [思维框架设置](https://www.mindframes.app/settings/api-keys),然后配置 :

```bash
# Interactive setup (recommended)
mindframes config init

# Or set directly
mindframes config set api-key YOUR_API_KEY

# Or use environment variable
export MINDFRAMES_API_KEY="your-api-key"
```

## 使用量

### 创建演示文稿

**需要上下文** 为有意义的介绍。 通过其中一种方法提供:

```bash
# Direct text context
mindframes create "Q4 Report" --context "Revenue: $10M, Growth: 25%, New customers: 500"

# From a file (markdown, text, or JSON)
mindframes create "Research Summary" --context-file ./research.md

# Pipe content from another command (stdin is read automatically when piped)
cat notes.md | mindframes create "Meeting Notes"

# Upload source documents (PDF, PPTX, DOCX, images)
mindframes create "Competitor Analysis" --file ./competitor-report.pdf

# Brand and style the deck
mindframes create "Board Update" --branding-id <brand-id> --template <template-id>
```

要使用一个网页作为上下文,请先将其刮去并插入:

```bash
mindframes scrape https://example.com/report | mindframes create "Competitor Analysis"
```

### 创建选项

| 选项 | 说明 | 默认 |
| --- | --- | --- |
| `-n, --slides <count>` | 幻灯片数量(1-20) | 服务器默认 |
| `-m, --mode <mode>` | 质量:最佳,平衡,快,超快,即时,图像-min,图像-max | 快点 |
| `--image-tier <tier>` | HTML 模式的嵌入式图像质量:智能、快、平衡、最佳 | 聪明 |
| `-t, --tone <tone>` | 口音:创造性、专业性、教育性、正规、随意 | 服务器默认 |
| `--amount <amount>` | 密度:最小、简洁、详细、广泛 | 服务器默认 |
| `--audience <text>` | 目标受众说明 | \- 说吧 |
| `-g, --goal <type>` | 目标:通报、说服、培训、学习、娱乐、报告 | \- 说吧 |
| `-l, --language <lang>` | 输出语言 | \- 说吧 |
| `--branding-id <id>` | 已保存品牌配置文件 ID (参见 `mindframes branding list`(中文(简体) ) | \- 说吧 |
| `--brand-domain <url>` | 用保存的品牌的网站/域标出甲板 | \- 说吧 |
| `--template <id>` | 幻灯片模板 ID (参见 `mindframes templates`(中文(简体) ) | 自动 |
| `-c, --context <text>` | 内在文本上下文 | \- 说吧 |
| `--context-file <path>` | 从文件中读取上下文 | \- 说吧 |
| `--stdin` | 从 stdin 读取上下文( 管道被自动检测) | \- 说吧 |
| `-f, --file <paths...>` | 上传源文件( PDF, PPTX, DOCX, 图像) | \- 说吧 |
| `--styling <mode>` | freeform, 品牌独有, 品牌外加风格, 风格独有, 无风格 | 服务器默认 |
| `--reference-url <url>` | 用作视觉样式参考的图像 URL | \- 说吧 |
| `--thinking-depth <depth>` | AI深度:快,中,深,深 | 服务器默认 |
| `--theme <preset>` | _只有即时模式_ 蓝色、紫色、玫瑰、橙色、绿色 | \- 说吧 |
| `--primary-color <hex>` | _只有即时模式_ ——主要颜色 | \- 说吧 |
| `--decorations <style>` | _只有即时模式_ 没有,左下波浪,右上波浪,角球,最小 | \- 说吧 |
| `--team-id <id>` | 团队/工作空间覆盖 | \- 说吧 |
| `-o, --output <format>` | 产出:人类、Json、安静 | 人类 |
| `--no-stream` | 等待完成而不流出进度 | \- 说吧 |
| `--wait` | 投票直到一代完成 | \- 说吧 |
| `--open` | 完成后在浏览器中打开甲板 | \- 说吧 |
| `--debug` | 启用调试日志 | \- 说吧 |

`--secondary-color`, (中文(简体) ), `--accent-color`, (中文(简体) ), `--background-color`, (中文(简体) ), `--foreground-color`, (中文(简体) ), `--id` 财务报告和审定财务报表 `--studio` 还可用; 运行 `mindframes create --help` 完整名单.

### 实例

```bash
# High-quality investor pitch
mindframes create "Series A Pitch" -m best -t formal --slides 12 \
  --audience "Venture capitalists" --context-file ./pitch-notes.md

# Quick internal update
mindframes create "Weekly Update" -m instant -t casual --slides 5 \
  --context "Shipped 3 features, fixed 12 bugs, 2 new hires joining Monday"

# Educational content built from uploaded research
mindframes create "AI in Healthcare" -t educational --amount detailed \
  --file ./research-paper.pdf

# JSON output for scripting
URL=$(mindframes create "Demo" --context "..." -o json | jq -r '.viewUrl')
```

### 列表演示文稿

```bash
mindframes presentation list                 # List recent presentations
mindframes presentation list --sort title    # Sort by title
mindframes presentation list --json          # JSON for scripting
mindframes presentation list --limit 50      # More results
```

### 查看演示文稿细节

```bash
mindframes get <id>                # Get presentation details
mindframes get <id> --format json  # JSON format
```

### 删除列报

```bash
mindframes delete <id>             # Delete with confirmation
mindframes delete <id> --force     # Skip confirmation
```

### 导出和导入

```bash
# Export to ZIP
mindframes export <id> -o presentation.zip

# Import from ZIP
mindframes import presentation.zip
mindframes import presentation.zip --dry-run  # Validate only
```

### 标记

```bash
mindframes branding list                 # List brand profiles
mindframes branding find "acme"          # Find a saved brand by name or URL
mindframes branding get <id>             # Brand profile details
mindframes branding extract <url>        # Extract a brand profile from a website
mindframes branding status <run-id>      # Check an extraction run
mindframes branding set-default <id>     # Make a brand the workspace default
mindframes branding profile [brand-id]   # Read design tokens
mindframes branding set [brand-id] ...   # Write design tokens (key=value or design.md)
mindframes branding logo set ...         # Set logo, dark variant, or favicon
mindframes branding competitor list|add  # Competitors
mindframes branding social add ...       # Social handles
```

### 配置

```bash
mindframes config init             # Interactive setup
mindframes config show             # Show current config
mindframes config set api-key KEY  # Set API key
mindframes config set api-url URL  # Set custom API URL
mindframes config refresh          # Refresh feature flags (unlocks gated commands)
mindframes config pull             # Pull workspace config
mindframes config path             # Show config file path
mindframes config clear            # Clear all config
```

### 检查认证

```bash
mindframes whoami                  # Show current user and team
```

### AI 编码助理整合

安装 Claude Code, Cursor 和其他 AI 编码助理的技能 :

```bash
mindframes skill install           # Auto-detect and install to all editors
mindframes skill install --local   # Install to current project only
mindframes skill show              # View skill content
mindframes skill uninstall         # Remove skill from editors
```

支持的编辑器: Claude Code, GitHub 副驾驶, Cursor, Codex, OpenCode, Windsurf, Agent

## 两个不同的视频管道

CLI已经 **两个** 不相关的视频路径 。 选错人最多 常见错误 :

| 你想这样 | 使用 |
| --- | --- |
| 转一圈 **完成演示文稿** 输入 MP4 中,包含描述、相机、音乐和标题 | `mindframes presentation video` |
| 构建一个 **短片/故事板上的视频** 有库存+生成的相片 | `mindframes video` |

他们没有共同的状态: `presentation video` 使您已有的幻灯片, `video` 制作一部新电影.

## 介绍 + MP4(`presentation video`(中文(简体) )

```bash
# 1) Create (or reuse) a video project for a deck
mindframes presentation video prepare <presentation-id> --yes

# 2) Inspect the project and its ordered scene timeline
mindframes presentation video inspect <project-id>

# 3) Optional: persist render settings for the project
mindframes presentation video settings <project-id> --settings ./settings.json --yes

# 4) Render the MP4
mindframes presentation video <presentation-id> --render-engine remotion --yes
mindframes presentation video <presentation-id> --render-engine hyperframes --yes

# 5) Poll the render
mindframes presentation video status <run-id>
```

`prepare` 接受 `--force-new`, (中文(简体) ), `--team-id`, (中文(简体) ), `--idempotency-key` 和要求 `--yes`。 。 。 .

它本身需要一分一分 `<presentation-id>` 参数 **或者说** `--project-id <id>` (从来没有两者),加 `--settings <json-or-path>`, (中文(简体) ), `--force-new`, (中文(简体) ), `--force-rerender`, (中文(简体) ), `--render-engine <remotion|hyperframes>` (单位:千美元)`remotion` =标准, `hyperframes` = Pre, `--team-id`, (中文(简体) ), `--idempotency-key`,以及 `--yes` 以确认. `--settings` 财务报告和审定财务报表 `--force-new` 只使用演示文稿 id, 而不是 `--project-id`。 。 。 .

### 编辑视频草稿

```bash
mindframes presentation video edit <project-id> --edit ./edit.json     # one atomic draft edit
mindframes presentation video refresh <project-id>                     # re-pull slides from the deck
mindframes presentation video versions <project-id>                    # list saved draft versions
mindframes presentation video restore <project-id> <version-number>    # restore a version
mindframes presentation video presenter <project-id> <slide-id> --avatar-id <id>
mindframes video library list <project-id>                              # reusable clips/recordings
```

`presenter` 取一个 `--avatar-id`, (中文(简体) ), `--cast-preset-id` 或者说 `--inherit`· ; `--render-tier <basic|standard|premium>` 只对 `--avatar-id`,以及 `--no-apply-preset-voice` 保持现场的当前声音 当应用一个铸模预设时。 阿凡达和语音ID来自 `mindframes avatar options`。 。 。 .

### 叙述和发言说明

```bash
# Regenerate one slide's narration inside a video draft
mindframes presentation video-narration <project-id> --slide-id <id> --instructions "warmer, shorter"
mindframes presentation video-narration-status <run-id>

# Persisted deck speaker notes
mindframes presentation speaker-notes <presentation-id> --mode ensure --style concise
mindframes presentation speaker-notes <presentation-id> --mode regenerate --slide-id <id> --language de
mindframes presentation speaker-notes-status <run-id>
```

两者默认跟随运行; 通过 `--no-follow` (或 `-f json`立刻把身份证拿回来.

### PowerPoint 导入和运行状态

```bash
mindframes presentation import --file deck.pptx --mode preserve
mindframes presentation import --file deck.pptx --mode rebrand --branding-id <id>
mindframes presentation import transform <import-id>
mindframes presentation import status <run-id>
mindframes presentation import transform-status <run-id>
mindframes presentation status <run-id>          # deck generation run
```

## 故事板上的视频( E)`video`(中文(简体) )

主机管道从"Markdown"的故事板修订版中构建出一段视频.

```bash
# Optional: analyze a reference video and reuse it as a media binding
mindframes video reference analyze --file ./ref.mp4 --idempotency-key ref-1
mindframes video reference status <run-id>

# 1) Create a versioned Markdown storyboard
mindframes video storyboard create --file ./storyboard.md --duration 30 --aspect 16:9 \
  --idempotency-key sb-1 --title "Launch teaser"

# 2) Revise it (immutable revisions)
mindframes video storyboard revise <storyboard-id> --base-revision <rev-id> \
  --file ./storyboard-v2.md --duration 30 --aspect 16:9 --idempotency-key sb-2

# 3) Read it back
mindframes video storyboard show <storyboard-id> --json

# 4) Render from a pinned revision (this is the terminal step)
mindframes video create --storyboard-revision <rev-id> --idempotency-key run-1 --yes

# 5) Poll
mindframes video status <run-id>
```

`video create` 还接受 `--source-video <id>`, (中文(简体) ), `--release` (720页 默认渲染为 480p)和 `--team-id`删除 `--yes` (或运行) `video quote` 使用同一种旗帜),以打印最多可以收取的视频,以及 盖着什么,没有开始什么.

### 海报框

在完成的 MP4 上附加一个海报框:

```bash
mindframes video thumbnail inject -i out/video.mp4 -t out/thumb.png -o out/final.mp4
```

### 支持视频命令

```bash
mindframes video find "city timelapse"                      # stock/web video search
mindframes video lipsync --source-video-id <uuid> --audio-url <url> -o out.mp4
mindframes video translate --source-video-id <uuid> --output-dir ./translated
mindframes video translate-languages                        # supported target languages
mindframes video library list <project-id>                  # reusable clips
```

### 视频感知音乐和SFX

生成 TTS 并先敲定时间段 。 然后将真实的视频数据传递给 后端; CLI 不编写提供者提示或音乐计划.

```bash
mindframes music generate --request music-request.json --output public/audio/music.mp3
mindframes sfx generate --request sfx-request.json --output public/audio/logo-lock.mp3
```

两个JSON文件都使用 `schema_version: 1`, (中文(简体) ), `video_description`, (中文(简体) ), `duration_s`,以及 `narration`。 SFX 请求还包括一项 `visual_event`; 包括描述 tTS 提供时的单词时间。 双子座将最终事实变成 提供者准备的音乐或 SFX 提示后端.

## 指挥小组

`mindframes capabilities` 列出每个可调用的能力及其确切命令 路径,以及 `mindframes <group> --help` 钻入下面的任何一组。 一些团体 仅出现在 `mindframes login` + 键 `mindframes config refresh` (地标-旗口) - `derive` 这是最明显的例子).

| 组 | 目的 |
| --- | --- |
| `create` | 创建演示文稿 |
| `list` 编号 : `get` 编号 : `delete` | 列表、检查和删除演示文稿 |
| `export` 编号 : `import` | 导出一个甲板到 ZIP; 导入一个返回( E)`import` 只有管理员) |
| `templates` | 列出幻灯片设计模板 `create --template` |
| `ideas` | 生成演示主题构想 |
| `presentation` | Deck – MP4, 扬声器, PowerPoint导入, 运行状态 |
| `video` | 故事板驱动的视频生成,股票搜索,平唇同步,翻译,分析 |
| `derive` | 甲板的衍生内容(博客、微博、LinkedIn、红色小组问题、作弊表)——贴出地标 |
| `branding` | 品牌简介、设计标志、标志、竞争者、社会手柄 |
| `avatar` | 介绍片段和外观`avatar options` 列出可视化和声音) |
| `cast` | 您的视频可以使用的面相和声音, 包括保存的预设 |
| `tts` 编号 : `music` 编号 : `sfx` 编号 : `mix` | 语音、视频感知音乐、音效、音频混合 |
| `image` | 图像搜索和 AI 图像生成 |
| `search` | 网络、新闻、图像和股票视频搜索 |
| `scrape` 编号 : `content` 编号 : `transcript` | 从 URL、 文件或 YouTube 视频中提取文本 |
| `media` | 复制和复制你已经拥有的录音 |
| `document` | 创建、读取和编辑图书馆文档(带有版本/备份) |
| `library` | 图书馆文件夹和归档 |
| `knowledge` | 搜索工作空间知识中心并读取知识包 |
| `agent` | 列表代理; 读取、 编辑或删除代理内存 |
| `poll` | 独立投票 |
| `microsite` | 可共享的多节网页微网站 |
| `ad-set` | 广告创作(呼喊、复制、视觉) |
| `visual-abstract` | 密集摘要的一页视觉抽象图形 |
| `capabilities` | 列出每个可调用的能力及其均等状态 |
| `config` 编号 : `login` 编号 : `logout` 编号 : `whoami` | 认证和配置 |
| `skill` | 将代理技能安装到 Claude Code, Cursor, Codex, .. |
| `runner` | 运行代理在本地使用您自己的 Claude 代码/ Codex 登录 |

## 脚本示例

```bash
# Batch export all presentations
mindframes presentation list --json | jq -r '.[].id' | xargs -I {} mindframes export {} -o {}.zip

# Filter presentations by JSON
mindframes presentation list --json | jq '.[] | select(.numberOfSlides > 10)'

# Generate from file and open URL
mindframes create "Report" --context-file data.md -o json | jq -r '.viewUrl' | xargs open
```

## 输出格式

-   `human` (默认):终端的彩色、格式化输出
-   `json`机器可读 JSON
-   `quiet`: 最小输出,只是出错
-   `table`: 列表命令的表格格式

## 退出代码

| 代码 | 含义 |
| --- | --- |
| 0 个 | 成绩 |
| 1个 | 一般错误 |
| 2个 | 认证错误 |
| 3个 | 未找到 |
| 页:1 | 超过费率限额 |
| 页:1 | 网络错误 |
| 6个 | 无效的输入 |
| 第7条 | 需要的批准:请求在某人在浏览器中批准之前持有;以收件方式重试或 `--wait-for-approval` |

## 环境变量

| 变量 | 说明 |
| --- | --- |
| `MINDFRAMES_API_KEY` | 用于认证的 API 密钥; 优先于保存的登录 |
| `MINDFRAMES_API_URL` | 自定义 API URL( 默认 ): [https://www.mindframes.app 互联网档案馆的存檔,存档日期2013-12-22](https://www.mindframes.app/)(中文(简体) ) |

一个保存 `mindframes login` 仅发送到发布它的服务器,以及一个密钥 保存为 `mindframes config set api-key` 仅保存到 API URL . 当 API URL 指向他处, 没有其它证书应用时, 命令 在打印中需要签名的消息,该信件将同时命名服务器和退出 代码 2. 认证请求从不跟随重定向到另一个服务器. `mindframes whoami` 财务报告和审定财务报表 `mindframes config show` 报告使用时的证书,不包含 打印出来 升级CLI后, 请再次登录: 证书由更早保存 未使用版本.

## 所需资源

-   节点.js 22.22.x

## 许可证

专有——版权 (c) 2024年至今 Mindframes. 版权所有.

## 常见问题

### @conceptcraft/mindframes 是什么？

用 ConceptCraft 创建AI 驱动演示文稿的 CLI 工具

### 如何安装 @conceptcraft/mindframes？

在项目目录运行 npm install @conceptcraft/mindframes，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mf、mindframes，可以用 npx mf 直接运行。

### @conceptcraft/mindframes 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/conceptcraft\_\_mindframes 是否存在。

### @conceptcraft/mindframes 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @conceptcraft/mindframes 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.23\.4 \<23。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @conceptcraft/mindframes 可以商用吗？

@conceptcraft/mindframes 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @conceptcraft/mindframes 的下载量有多少？

根据 npm 官方下载统计，@conceptcraft/mindframes 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,475 次，日均约 83 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @conceptcraft/mindframes 还在维护吗？

最新版本 0\.3\.43 发布于 2026/11/05（5 天前）；至今共发布 84 个版本，其中过去 12 个月发布了 84 个；首次发布于 2026/01/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。