🚀 新手入门
Minto 是一个多模型 AI 助手平台，专为战略研究和商业分析设计。它可以帮您：
- 市场研究 - 快速收集和分析市场数据
- 竞品分析 - 深度拆解竞争对手策略
- 数据分析 - 从数据中发现洞察和机会
- 内容创作 - 撰写报告、提案、演示文稿
- 项目规划 - 制定计划和路线图
简单来说，它就像一个随时待命的智囊团，能够调用 20+ 种 AI 模型为您服务。
完全不需要！
Minto 的设计目标就是让非技术用户也能轻松使用。您只需要：
- 安装（只需复制粘贴一行命令）
- 配置 API 密钥（按照指引操作）
- 用自然语言描述您的需求
就像和一个助手对话一样简单。
安装非常简单，只需在终端中运行一行命令：
npm install -g @within-7/minto
前提条件：
- 需要先安装 Node.js 20 或更高版本
- 如果没有安装 Node.js，请先从 nodejs.org 下载安装
安装完成后，运行 minto --version 验证是否成功。
API 密钥就像是访问 AI 服务的"通行证"。Minto 本身是免费的，但使用 AI 模型需要向模型提供商付费。
获取 API 密钥：
- Claude（推荐） - 访问 console.anthropic.com 注册获取
- OpenAI - 访问 platform.openai.com 注册获取
- DeepSeek - 访问 platform.deepseek.com 注册获取（性价比最高）
费用参考：一般的研究任务，每次成本约 $0.01-$0.10 不等，取决于使用的模型和数据量。
📝 基本操作
非常简单，只需三步：
- 打开终端，输入
minto启动程序 - 用自然语言描述您的研究需求
- 等待 Minto 完成分析并给出结果
示例：
分析美国智能家居市场的规模和主要玩家
Minto 会自动理解您的需求，调用合适的 Agent 和工具来完成任务。
直接告诉 Minto 文件的名称和您想分析的内容：
分析 sales_data.xlsx 的销售趋势，找出增长机会
支持的文件格式：
- Excel 文件（.xlsx, .xls）
- CSV 文件（.csv）
- PDF 文档（.pdf）
- Word 文档（.docx）
- 文本文件（.txt, .md）
提示：确保文件在当前工作目录中，或者提供完整的文件路径。
您可以要求 Minto 将结果保存为文件：
将这份分析报告保存为 market_research.md
或者在提出需求时就指定输出格式：
分析智能家居市场，生成一份 Markdown 格式的研究报告
以下是最常用的几个命令：
/help |
查看帮助信息 |
/models |
查看和切换 AI 模型 |
/agents |
查看可用的 Agent |
/compact |
压缩对话历史，释放空间 |
/clear |
清除当前对话，重新开始 |
🤖 模型相关
Minto 支持 20+ 种主流 AI 模型，包括：
- Claude 系列 - Opus 4.5、Sonnet 4、Haiku（推荐用于深度分析）
- GPT 系列 - GPT-4 Turbo、GPT-4o、GPT-4o-mini（推荐用于快速任务）
- DeepSeek - Chat、Reasoner（性价比最高）
- Gemini - Pro、1.5（适合多语言和长文档）
- 以及 Qwen、Mistral 等更多模型
根据任务类型选择：
| 战略分析、深度研究 | Claude Opus/Sonnet |
| 快速问答、草稿生成 | GPT-4o-mini |
| 数学计算、逻辑推理 | DeepSeek Reasoner |
| 多语言、长文档 | Gemini Pro |
| 控制成本 | DeepSeek Chat |
在对话中随时使用 /model 命令：
/model claude-sonnet-4
或使用 /models 查看所有可用模型后再选择。
省钱技巧：
- 简单任务使用 GPT-4o-mini 或 DeepSeek Chat，成本可降低 80%+
- 使用
/compact命令压缩对话历史，减少 token 消耗 - 任务描述尽量清晰具体，避免多次重试
- 在各服务商后台设置使用限额
⚙️ 功能使用
Agent 就像是专业顾问团队中的不同专家。每个 Agent 擅长特定类型的任务。
使用方式：您不需要手动选择 Agent，只需描述您的需求，Minto 会自动调用合适的 Agent。
查看可用 Agent：输入 /agents 命令。
当出现以下情况时，建议使用 /compact 命令：
- 对话进行了很长时间
- 收到"上下文接近限制"的提示
- 准备切换到新的研究话题
- 想要保存当前进度后继续
压缩会保留重要信息，同时释放空间继续对话。
可以！Minto 内置了网络搜索工具，可以获取最新的市场信息、新闻和数据。
示例：
搜索最新的智能家居市场报告
Minto 会自动使用网络搜索工具，获取最新信息并整合到分析中。
🔧 问题排查
检查步骤：
- 确认 API 密钥已正确复制（无多余空格）
- 检查密钥是否过期或被撤销
- 确认账户余额充足
- 验证环境变量是否正确设置
重新设置密钥：
export ANTHROPIC_API_KEY="您的密钥"
可能的原因和解决方法：
- 网络问题 - 检查网络连接是否稳定
- 对话太长 - 使用
/compact压缩对话 - 模型选择 - 换用更快的模型（如 GPT-4o-mini）
- 服务器繁忙 - 稍后再试
改进技巧：
- 更具体的描述 - 说明您想要的格式、深度、侧重点
- 提供背景信息 - 说明目的、受众、使用场景
- 分步骤请求 - 复杂任务分成多个小任务
- 给出示例 - 提供您期望的输出样例
示例对比：
分析市场
分析美国智能家居市场 2024 年的规模、前三大玩家和增长趋势，输出一份适合向客户汇报的简要报告
有几种方式：
- 输入
/quit或/exit命令 - 按
Ctrl + C组合键 - 按两次
Esc键
🎓 进阶问题
这是一个进阶功能。如果您想创建适合自己工作流程的 Agent：
- 在项目目录创建
.minto/agents/文件夹 - 创建一个
.md文件（如my-agent.md） - 在文件中定义 Agent 的专长和工作方式
详细教程请参考 Agent 开发指南。
Minto 基于 Claude Code 的架构，但有以下增强：
- 多模型支持 - 不仅限于 Claude，支持 20+ 种模型
- 双模式压缩 - 专为商业分析和代码开发优化的压缩策略
- 战略研究优化 - 内置市场研究、竞品分析等专业 Agent
同时 Minto 完全兼容 Claude Code 的 Agent 和配置。
可以通过以下方式在团队中共享：
- 项目配置 - 将
.minto/agents/目录提交到 Git - 配置文件 - 共享
.minto.json（注意不要包含 API 密钥）
安全提醒：永远不要将 API 密钥提交到代码仓库。