# @agentxin-ai/plugin-moonshot 中文文档

规范地址：https://npmcn.com/package/%40agentxin-ai/plugin-moonshot/

版本：0\.0\.2
npm 元数据更新时间：2026-03-19T10:53:30.484Z
中文译文更新时间：2026-11-06T18:12:19.041Z
软件包许可：AGPL-3\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agentxin-ai/plugin-moonshot
原文对照：https://npmcn.com/package/%40agentxin-ai/plugin-moonshot/?lang=original
项目主页：https://github.com/agentxin-ai/agentxin-plugins#readme
源码仓库：https://github.com/agentxin-ai/agentxin-plugins

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：374 kB，16 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：@langchain/openai 0\.6\.9，@metad/contracts ^3\.6\.1，@nestjs/common ^11\.1\.6，@nestjs/config ^4\.0\.2，@agentxin-ai/plugin-sdk ^3\.6\.1，chalk 4\.1\.2，zod 3\.25\.67
- 首次发布：2026-03-19T10:53:29.947Z
- 最新版本发布：2026-03-19T10:53:30.302Z
- 近 30 天下载量：2501（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 1 个）

## 中文简介

`@agentxin-ai/plugin-moonshot` 连接 [(基米语)](https://platform.moonshot.cn/) 模式 [新奈伊探员](https://github.com/agentxin-ai/agentxin) 平台。 插件整合了 Moonshot 的 OpenAI 兼容的 API, 这样 Agent XinAI 代理可以杠杆

## 安装

```sh
npm install @agentxin-ai/plugin-moonshot
```

也可以使用：`pnpm add @agentxin-ai/plugin-moonshot`、`yarn add @agentxin-ai/plugin-moonshot`、`bun add @agentxin-ai/plugin-moonshot`

## README

# Agent Xin 插件: 月光相机 AI

## 概览

`@agentxin-ai/plugin-moonshot` 连接 [(基米语)](https://platform.moonshot.cn/) 模式 [新奈伊探员](https://github.com/agentxin-ai/agentxin) 平台。 该插件整合了Moonshot的OpenAI相容API,使Agent XinAI代理能够利用Kimi强大的长通文字语言模型,上下文窗口可达128K个令牌,包括最新的具有高级推理能力的K2系列.

## 核心特征

-   船舶 `MoonshotModule`,用于注册插件运行时间所需的 NestJS 提供者策略、生命周期钩和配置方案.
-   执行 `MoonshotLargeLanguageModel`一个LangChain动力的适配器 `ChatOpenAI` 支持流式聊天补全,函数调用,以及代理远程测量的符号记账回调.
-   共享控制台准备 `moonshot.yaml` 驱动 Agent XinAI UI 表格(cons, help link, Creditential points)用于快速操作员登入.
-   支持多个 Moonshot 模型变体,包括:
    -   **月光相机 V1 系列**数字 : `moonshot-v1-8k`, (中文(简体) ), `moonshot-v1-32k`, (中文(简体) ), `moonshot-v1-128k` 对于各种上下文长度要求
    -   **Kimi K2 系列**数字 : `kimi-k2-0711-preview`, (中文(简体) ), `kimi-k2-0905-preview`, (中文(简体) ), `kimi-k2-turbo-preview` 提高业绩
    -   **木卫一 K2 思维系列**数字 : `kimi-k2-thinking`, (中文(简体) ), `kimi-k2-thinking-turbo` 用于高级推理任务

## 安装

```bash
npm install @agentxin-ai/plugin-moonshot
```

> **同伴依赖关系**:确保您的主机服务也提供 `@agentxin-ai/plugin-sdk`, (中文(简体) ), `@nestjs/common`, (中文(简体) ), `@nestjs/config`, (中文(简体) ), `@metad/contracts`, (中文(简体) ), `@langchain/openai`, (中文(简体) ), `chalk`,以及 `zod`。参见 `package.json` 准确的版本.

## 启用新AI代理

1.  在启动代理 XinAI 服务器前声明插件 :
    
    ```bash
    PLUGINS=@agentxin-ai/plugin-moonshot
    ```
    
2.  在 Agent XinAI 管理控制台( 或配置文件) 中创建一个指向 `moonshot`,然后在您想要使用的特定月光/基米版本中添加映射的单个模型.

## 证书模型配置( M)

这个 `moonshot.yaml` schema 支持您在控制台看到的窗体字段 :

| 外地 | 说明 |
| --- | --- |
| `api_key` | 要求。 您的月光 API 密钥来自 [平台. moonshot.cn/console/ api-keys (中文(简体) )](https://platform.moonshot.cn/console/api-keys)。 。 。 . |
| `base_url` | 可选的 API 请求的基础 URL( 默认为 `https://api.moonshot.cn/v1`。用于代理配置. |

在验证过程中,插件将一个 ChatOpenAI 客户端与您的证书同步,并发送一个测试消息("),以确保连接和权限.

## 模型能力

-   **长背景支持**:所有"月球相机"模型都擅长处理长写方案,V1-128K变体支持多达128,000个上下文符号.
-   **对话模式**数字 : `MoonshotLargeLanguageModel` 将供应商的资质与每个模型的覆盖合并,允许流出,并登记符号使用回调,这样代理遥测保持准确.
-   **高级理由**: K2思维系列模型为复杂的解决问题任务提供了更强的推理能力.
-   **OpenAI 兼容性**:建于兰Cha `ChatOpenAI`确保与现有的OpenAI兼容工作流程的无缝整合.

## 开发与调试

从 repo 根中运行 Nx 命令,用于此软件包 :

```bash
cd agentxinai
npx nx build @agentxin-ai/plugin-moonshot
npx nx test @agentxin-ai/plugin-moonshot
```

人工林占地面积 `agentxinai/models/moonshot/dist`设置时使用 `jest.config.ts`,则资产复印机通过 `npm run prepack` 发表前.

## 许可证

此插件在 [AGPL-3.0 许可证](https://npmcn.com/LICENSE) 位于寄存器根.

## 常见问题

### @agentxin-ai/plugin-moonshot 是什么？

@agentxin-ai/plugin-moonshot 连接 \(基米语\) 模式 新奈伊探员 平台。 插件整合了 Moonshot 的 OpenAI 兼容的 API, 这样 Agent XinAI 代理可以杠杆

### 如何安装 @agentxin-ai/plugin-moonshot？

在项目目录运行 npm install @agentxin-ai/plugin-moonshot，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@langchain/openai（0\.6\.9）、@metad/contracts（^3\.6\.1）、@nestjs/common（^11\.1\.6）、@nestjs/config（^4\.0\.2）、@agentxin-ai/plugin-sdk（^3\.6\.1）、chalk（4\.1\.2）、zod（3\.25\.67）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @agentxin-ai/plugin-moonshot 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @agentxin-ai/plugin-moonshot 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @agentxin-ai/plugin-moonshot 可以商用吗？

@agentxin-ai/plugin-moonshot 使用 AGPL-3\.0 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @agentxin-ai/plugin-moonshot 的下载量有多少？

根据 npm 官方下载统计，@agentxin-ai/plugin-moonshot 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,501 次，日均约 83 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agentxin-ai/plugin-moonshot 还在维护吗？

最新版本 0\.0\.2 发布于 2026/03/19（7 个月前）；至今共发布 1 个版本，其中过去 12 个月发布了 1 个；首次发布于 2026/03/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。