# @ckeditor/ckeditor5-dev-stale-bot 中文文档

规范地址：https://npmcn.com/package/%40ckeditor/ckeditor5-dev-stale-bot/

版本：63\.1\.3
npm 元数据更新时间：2026-11-09T07:49:49.064Z
中文译文更新时间：2026-11-09T23:30:02.265Z
软件包许可：GPL-2\.0-or-later

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

原始 npm 页面：https://www.npmjs.com/package/%40ckeditor/ckeditor5-dev-stale-bot
原文对照：https://npmcn.com/package/%40ckeditor/ckeditor5-dev-stale-bot/?lang=original
项目主页：https://github.com/ckeditor/ckeditor5-dev/tree/master/packages/ckeditor5-dev-stale-bot
源码仓库：https://github.com/ckeditor/ckeditor5-dev

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

- 包体积（解压后）：58.1 kB，28 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=26\.10\.0
- 运行依赖：7 个
- 首次发布：2023-12-14T07:23:34.981Z
- 最新版本发布：2026-11-09T07:49:48.902Z
- 近 30 天下载量：4988（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：172（近 12 个月 80 个）

## 中文简介

使用有名的bot来标记最近没有更新的问题和拉动请求.

## 安装

```sh
npm install @ckeditor/ckeditor5-dev-stale-bot
```

也可以使用：`pnpm add @ckeditor/ckeditor5-dev-stale-bot`、`yarn add @ckeditor/ckeditor5-dev-stale-bot`、`bun add @ckeditor/ckeditor5-dev-stale-bot`

## README

# CKEditor 5 Stale 瓶装

[![npm version](https://badge.fury.io/js/%40ckeditor%2Fckeditor5-dev-stale-bot.svg)](https://www.npmjs.com/package/@ckeditor/ckeditor5-dev-stale-bot) [![CircleCI](https://circleci.com/gh/ckeditor/ckeditor5-dev.svg?style=shield)](https://app.circleci.com/pipelines/github/ckeditor/ckeditor5-dev?branch=master)

使用有名的bot来标记最近没有更新的问题和拉动请求.

有关开发工具包的更多信息可在以下 URL 找到: [https://github.com/ckeditor/ckeditor5-dev 互联网档案馆的存檔,存档日期2014-12-21](https://github.com/ckeditor/ckeditor5-dev)。 。 。 .

## 使用量

要执行 Stale bot, 请运行以下命令 :

```bash
pnpm run ckeditor5-dev-stale-bot [<args>...]
```

本脚本接受以下参数:

-   `--config-path` - 要求。 包含 JSON 或 JavaScript 文件的路径 [stale 机器人配置](https://npmcn.com/package/%40ckeditor/ckeditor5-dev-stale-bot/#readme-configuration)。 。 。 .
-   `--dry-run` - 可选的, `false` 默认。 允许禁用 GitHub 的任何更改 `true`。默认的 stale bot 将利用您的 **真实、现场、生产数据**。 。 。 .

### 配置

下列配置选项由 stale bot 支持 :

-   `GITHUB_TOKEN` - 要求。 带有 GitHub 符号 `repo:*` 管理储存库和问题所需的范围.
-   `REPOSITORY_SLUG` - 要求。 格式化的仓库名称 `owner/name`,在那里 stale bot 将检查 stale 的问题和拉请求.
-   `STALE_LABELS` - 要求。 关于分层问题和牵引请求的要添加的标签列表.
-   `CLOSE_ISSUE_LABELS` - 要求。 关闭 stale 后要添加的标签列表 .
-   `CLOSE_PR_LABELS` - 要求。 关闭 stale 拖放请求后添加的标签列表 .
-   `STALE_ISSUE_MESSAGE` - 要求。 补充了对分层问题的评论.
-   `STALE_PR_MESSAGE` - 要求。 在分层拉力请求上添加的注释.
-   `CLOSE_ISSUE_MESSAGE` - 要求。 补充了对已了结问题的评论.
-   `CLOSE_PR_MESSAGE` - 要求。 对已关闭的牵引请求添加的评论 .
-   `DAYS_BEFORE_STALE` - 可选,默认365个。 未开展使问题或拉动请求有资格被标为呆滞活动的天数。 考虑的日期是:
    -   创建日期,
    -   编辑一个问题或拉出请求的最后日期,
    -   最后一个对问题或牵引请求作出响应的日期,
    -   添加或编辑评论的最后日期,
    -   更改标签的最后日期.
-   `DAYS_BEFORE_STALE_PENDING_ISSUE` - 可选,默认14个。 非团队成员未就未决问题发表意见的天数,将该问题标为呆板.
-   `PENDING_ISSUE_LABELS` -可选,默认为空数组. 确定未决问题的标签清单。 如果空出,则不处理未决问题.
-   `STALE_PENDING_ISSUE_MESSAGE` - 可选,设置为从 `STALE_ISSUE_MESSAGE` 默认。 补充了对待决问题的评论.
-   `DAYS_BEFORE_CLOSE` ——可选,默认30人. 关闭悬疑问题或悬疑拉出请求前的天数.
-   `IGNORE_VIEWER_ACTIVITY` - 可选的, `true` 默认。 如果设定了, 当前认证用户的活动将被忽略 .
-   `IGNORED_ISSUE_LABELS` -可选,默认为空数组. 一份标签清单,其指定某一问题会导致这一问题被忽略,即使它符合陈旧的标准.
-   `IGNORED_PR_LABELS` -可选,默认为空数组. 标签列表,其给拉出请求的指定导致拉出请求被忽略,即使符合 Stale 标准.
-   `IGNORED_ACTIVITY_LABELS` -可选,默认为空数组. 标签列表,其对某一问题或牵引请求的指定不算作活动事件.
-   `IGNORED_ACTIVITY_LOGINS` -可选,默认为空数组. GitHub 登录列表,其活动不计入.

## 更改日志

见 [`CHANGELOG.md`](https://github.com/ckeditor/ckeditor5-dev/blob/master/packages/ckeditor5-dev-stale-bot/CHANGELOG.md) 文档.

## 许可证

根据下列规定获得许可证: [GNU 通用公共许可证版本 2 或稍后版本](http://www.gnu.org/licenses/gpl.html)请检查date=中的日期值 (帮助) `LICENSE.md` 文档.

## 常见问题

### @ckeditor/ckeditor5-dev-stale-bot 是什么？

使用有名的bot来标记最近没有更新的问题和拉动请求\.

### 如何安装 @ckeditor/ckeditor5-dev-stale-bot？

在项目目录运行 npm install @ckeditor/ckeditor5-dev-stale-bot，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ckeditor5-dev-stale-bot，可以用 npx ckeditor5-dev-stale-bot 直接运行。

### @ckeditor/ckeditor5-dev-stale-bot 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/ckeditor\_\_ckeditor5-dev-stale-bot 是否存在。

### @ckeditor/ckeditor5-dev-stale-bot 支持 ESM 还是 CommonJS？

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

### @ckeditor/ckeditor5-dev-stale-bot 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=26\.10\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ckeditor/ckeditor5-dev-stale-bot 可以商用吗？

@ckeditor/ckeditor5-dev-stale-bot 使用 GPL-2\.0-or-later 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以兼容的 GPL 许可开源。仅在内部使用、不对外分发时不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### @ckeditor/ckeditor5-dev-stale-bot 的下载量有多少？

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

### @ckeditor/ckeditor5-dev-stale-bot 还在维护吗？

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