思维框架CLI
用于命令行工具 思维框架 - 演示、录像、相机、音频、, 品牌、媒体和研究.
运行 mindframes capabilities 随时随地的 完整、随时可用的清单
能力,以及 mindframes <group> --help 钻入一个.
安装
npm install -g @conceptcraft/mindframes
或直接使用 npx :
npx @conceptcraft/mindframes create "Topic" --context "your content"
设置
获取您的 API 密钥 思维框架设置,然后配置 :
# 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"
使用量
创建演示文稿
需要上下文 为有意义的介绍。 通过其中一种方法提供:
# 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>
要使用一个网页作为上下文,请先将其刮去并插入:
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 完整名单.
实例
# 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')
列表演示文稿
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
查看演示文稿细节
mindframes get <id> # Get presentation details
mindframes get <id> --format json # JSON format
删除列报
mindframes delete <id> # Delete with confirmation
mindframes delete <id> --force # Skip confirmation
导出和导入
# Export to ZIP
mindframes export <id> -o presentation.zip
# Import from ZIP
mindframes import presentation.zip
mindframes import presentation.zip --dry-run # Validate only
标记
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
配置
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
检查认证
mindframes whoami # Show current user and team
AI 编码助理整合
安装 Claude Code, Cursor 和其他 AI 编码助理的技能 :
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(中文(简体) )
# 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。 。 。 .
编辑视频草稿
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。 。 。 .
叙述和发言说明
# 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 导入和运行状态
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"的故事板修订版中构建出一段视频.
# 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 上附加一个海报框:
mindframes video thumbnail inject -i out/video.mp4 -t out/thumb.png -o out/final.mp4
支持视频命令
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 不编写提供者提示或音乐计划.
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 登录 |
脚本示例
# 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机器可读 JSONquiet: 最小输出,只是出错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(中文(简体) ) |
一个保存 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. 版权所有.