【限时免费】 MoonBit Pilot 入门指南：终端中的智能编程助手

什么是 MoonBit Pilot

MoonBit Pilot 是一款革命性的终端编程助手工具，它将 MoonBit 语言的强大能力直接带到你的终端环境中。通过智能化的代码重构和自动化工作流，它能将原本需要数小时的手动操作简化为一条简单的命令，让你的代码开发效率得到质的飞跃。

核心特性

1. 终端集成：直接在终端环境中使用，无需切换开发环境
2. 智能重构：支持并行代码重构，大幅提升开发效率
3. 工作流自动化：将复杂的工作流程简化为单一命令
4. 多模型支持：可配置多种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密钥

模型推荐

1. Claude Sonnet 4 (推荐)：

   • 大上下文窗口（200k tokens），适合复杂任务
   • 高质量输出，但价格较高

2. 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

最佳实践

1. 模型选择：对于复杂任务，优先使用Claude Sonnet 4；对于简单任务或预算有限时使用Kimi K2
2. 会话管理：合理使用会话继续功能，保持上下文连贯性
3. 成本控制：关注模型的input_price和output_price，合理规划使用量

常见问题

Q: 如何获取API密钥？ A: 需要到各模型提供商的官网注册账号获取API密钥。

Q: 为什么推荐将sonnet4放在配置首位？ A: MoonBit Pilot默认使用配置中的第一个模型，将最常用的模型放在首位可以简化使用流程。

Q: 如何查看当前使用的模型？ A: 在交互模式下输入 :models 可以查看可用模型列表和当前使用的模型。