# alemonjs 中文文档

规范地址：https://npmcn.com/package/alemonjs/

版本：2\.1\.121
npm 元数据更新时间：2026-11-03T01:50:03.315Z
中文译文更新时间：2026-11-03T02:34:58.169Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/alemonjs
原文对照：https://npmcn.com/package/alemonjs/?lang=original
项目主页：https://github.com/lemonade-lab/alemonjs#readme
源码仓库：https://github.com/lemonade-lab/alemonjs

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

- 包体积（解压后）：1.3 MB，390 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：18 个
- 首次发布：2023-10-10T03:29:49.863Z
- 最新版本发布：2026-11-03T01:50:03.102Z
- 已发布版本数：440（近 12 个月 125 个）

## 中文简介

机器人脚本

## 安装

```sh
npm install alemonjs
```

也可以使用：`pnpm add alemonjs`、`yarn add alemonjs`、`bun add alemonjs`

## README

# [ALemonJS](https://alemonjs.com/)

专用于开发聊天机器人的 Node.js 框架，它提供了完整的事件驱动架构来处理各种聊天平台的消息和交互。

官网文档 [https://alemonjs.com](https://alemonjs.com/)

插件能力与 AI 工具调用见 [Expose](https://npmcn.com/package/alemonjs/docs/expose.md)。

## 应用启用与加载顺序

新配置以模块名作为唯一 key，在模块内部设置启用状态和加载序号：

```yaml
apps:
  '@example/database':
    enabled: true
    order: 10
  '@example/business':
    enabled: true
    order: 20
  '@example/optional':
    enabled: false
    order: 30
```

`enabled` 默认 `true`，`order` 为安全整数，省略时使用声明位置（从 0 开始）。建议所有模块显式填写序号，按 10、20、30 留出插入空间。序号越小越先加载，同序号保持声明顺序。框架等待前一个模块初始化结束再加载下一个；主应用仍先于这些模块加载。序号不代表依赖检查，也不保证失败的模块已就绪。

旧版 `模块名: true/false` 和名称数组仍可读取，后续新增配置统一使用上述模块映射。禁用模块保留序号，桌面管理入口启用、禁用时不会丢失其他模块配置。无效条目警告并跳过，字符串 `"false"` 不会被当作启用。`alemonc add/remove apps` 同步使用模块映射，保留已有模块的序号；精确调整序号请编辑 YAML。

## 常见问题

### alemonjs 是什么？

机器人脚本

### 如何安装 alemonjs？

在项目目录运行 npm install alemonjs，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 alemonc、alemonjs，可以用 npx alemonc 直接运行。

### alemonjs 支持 TypeScript 吗？

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

### alemonjs 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### alemonjs 可以商用吗？

alemonjs 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### alemonjs 还在维护吗？

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