MoonBit Pilot 入门指南：终端中的智能编程助手
项目地址: https://gitcode.com/MoonBit/moonbit-docs 什么是 MoonBit Pilot
MoonBit Pilot 是一款革命性的终端编程助手工具，它将 MoonBit 语言的强大能力直接带到你的终端环境中。通过智能化的代码重构和自动化工作流，它能将原本需要数小时的手动操作简化为一条简单的命令，让你的代码开发效率得到质的飞跃。
核心特性
- 终端集成：直接在终端环境中使用，无需切换开发环境
- 智能重构：支持并行代码重构，大幅提升开发效率
- 工作流自动化：将复杂的工作流程简化为单一命令
- 多模型支持：可配置多种AI模型，满足不同场景需求
模型配置指南
配置文件位置
MoonBit Pilot 使用 JSON 格式的配置文件来管理AI模型，该文件位于用户主目录下的 .moonagent/models/models.json 路径。
配置示例解析
以下是一个典型的模型配置示例，包含两个主流AI模型：
[
{
"name": "sonnet4",
"description": "Claude Sonnet模型，适用于通用任务",
"model_name": "anthropic/claude-sonnet-4",
"model_type": "saas/openai",
"base_url": "https://openrouter.ai/api/v1",
"is_reasoning": false,
"input_price": 3.0,
"output_price": 15.0,
"max_output_tokens": 8096,
"context_window": 200000,
"api_key": "你的API密钥"
},
{
"name": "k2",
"description": "",
"model_name": "kimi-k2-0711-preview",
"model_type": "saas/openai",
"base_url": "https://api.moonshot.cn/v1",
"is_reasoning": false,
"input_price": 0.28,
"output_price": 2.28,
"max_output_tokens": 8096,
"context_window": 120000,
"api_key": "你的API密钥"
}
]
配置参数详解
| 参数名 | 类型 | 说明 |
|---|---|---|
| name | string | 模型的唯一标识符 |
| description | string | 模型的人类可读描述 |
| model_name | string | API提供商使用的实际模型标识符 |
| model_type | string | API接口类型（目前支持"saas/openai"） |
| base_url | string | 模型提供商的API端点URL |
| is_reasoning | boolean | 是否为推理模型（影响token计数） |
| input_price | number | 每百万输入token的成本（美元） |
| output_price | number | 每百万输出token的成本（美元） |
| max_output_tokens | number | 模型能输出的最大token数 |
| context_window | number | 上下文窗口的总token大小 |
| api_key | string | 该提供商的API密钥 |
模型推荐
-
Claude Sonnet 4 (推荐)：
- 大上下文窗口（200k tokens），适合复杂任务
- 高质量输出，但价格较高
-
Kimi K2 (不稳定)：
- 价格较低
- 120k token上下文窗口
安装与设置
前置条件
确保已安装 Node.js v22.16.0 或更高版本。
安装命令
moon pilot
使用指南
交互模式
启动交互模式（使用配置文件中第一个模型）：
moon pilot
指定特定模型启动：
moon pilot --model k2
交互命令示例
在交互模式下，你可以直接输入需求：
act ▶ 这个项目是做什么的？
退出交互模式
- 使用
:exit或Ctrl+D退出应用 - 使用
Ctrl+C停止当前请求并清除当前输入
非交互模式（打印模式）
执行一次性命令：
echo "这个项目是做什么的" | moon pilot -p
结合文件内容使用：
cat prompt.md | moon pilot -p
会话管理
查看最近的非交互会话：
moon pilot conversations
查看特定会话详情：
moon pilot conversation 会话ID
导出会话到Markdown文件：
moon pilot conversation 会话ID --output conversation.md
会话继续
继续上次会话：
echo "我之前问了你什么？" | moon pilot -p --continue
恢复到特定会话：
echo "我之前问了你什么？" | moon pilot -p --resume 会话ID
最佳实践
- 模型选择：对于复杂任务，优先使用Claude Sonnet 4；对于简单任务或预算有限时使用Kimi K2
- 会话管理：合理使用会话继续功能，保持上下文连贯性
- 成本控制：关注模型的input_price和output_price，合理规划使用量
常见问题
Q: 如何获取API密钥？ A: 需要到各模型提供商的官网注册账号获取API密钥。
Q: 为什么推荐将sonnet4放在配置首位？ A: MoonBit Pilot默认使用配置中的第一个模型，将最常用的模型放在首位可以简化使用流程。
Q: 如何查看当前使用的模型？ A: 在交互模式下输入 :models 可以查看可用模型列表和当前使用的模型。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
