入门指南

入门指南#

MoonBit Pilot#

图片：MoonBit Pilot 界面概览

在你的终端中直接释放 MoonBit 语言的原始力量。并行重构你的代码。将数小时的工作流程转变为一个单一的命令。你的工具。你的工作流程。你的代码库，以思想的速度进化。

模型配置#

在使用 MoonBit Pilot 之前，你需要通过在 ~/.moonagent/models/models.json 创建一个配置文件来配置至少一个模型：

[
  {
    "name": "sonnet4",
    "description": "Claude Sonnet model for general tasks",
    "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": "your-api-key-here"
  },
  {
    "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": "your-api-key-here"
  }
]

我们强烈推荐使用 sonnet4 并且将其放在配置文件的第一个位置。

配置字段说明#

  • name: 模型的唯一标识符（用于参考）

  • description: 模型的可读描述

  • model_name: API 提供商使用的实际模型标识符

  • model_type: API 接口类型（目前支持 “saas/openai”）

  • base_url: 模型提供商的 API 端点 URL

  • is_reasoning: 是否为推理模型（影响 token 计数）

  • input_price: 每百万输入 token 的成本（美元）

  • output_price: 每百万输出 token 的成本（美元）

  • max_output_tokens: 模型可以输出的最大 token 数

  • context_window: 总上下文窗口大小（以 token 为单位）

  • api_key: 您此提供商的 API 密钥

关于示例模型#

以上配置包括两个流行的模型：

  • [Recommend]Claude Sonnet 4 (sonnet4): Anthropic’s latest high-performance model via OpenRouter

    • 高上下文窗口（20 万 token）适用于复杂任务

    • 价格较高但质量卓越

  • [Unstable]Kimi K2 (k2): Moonshot’s cost-effective model

    • Lower pricing

    • 12 万 token 上下文窗口

获取 API 密钥#

要使用这些模型，你需要获取 API 密钥：

  • OpenRouter (用于 Claude Sonnet 4): 访问 openrouter.ai 创建账户并获取你的 API 密钥

  • Moonshot (用于 Kimi K2): 访问 moonshot.cn 注册并获取你的 API 密钥

在配置中将 "your-api-key-here" 替换为你的实际 API 密钥。

设置#

安装 Node.js v22.16.0 然后运行：

moon pilot

用法#

MoonBit Pilot 将自动使用你配置文件中的第一个模型（在本例中为 “sonnet4”）。你可以配置多个模型，并在启动 MoonBit Pilot 时通过 --model 参数指定它们。

交互模式#

使用预览部分指定的第一个模型启动交互模式。

moon pilot

或者指定一个特定的模型：

moon pilot --model k2

交互式命令#

进入交互模式后，你可以正常输入你的需求，MoonBit Pilot 会为你响应并执行任务。

act ▶ 这个项目是做什么的？

退出交互模式#

  • 使用 :exit 或 Ctrl+D 退出应用程序

  • 使用 Ctrl+C 停止当前请求并清除当前输入

目录