# @grammyjs/stateless-question 中文文档

规范地址：https://npmcn.com/package/%40grammyjs/stateless-question/

版本：4\.0\.0
npm 元数据更新时间：2024-06-03T09:18:00.414Z
中文译文更新时间：2026-11-16T22:09:05.910Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：14.4 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=14
- 运行依赖：0 个
- peer 依赖：grammy ^1\.10\.1
- 首次发布：2021-09-16T08:13:35.896Z
- 最新版本发布：2024-05-24T10:20:04.218Z
- 近 30 天下载量：12744（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 0 个）

## 中文简介

为在隐私模式下工作的Telegram用户创建无国籍问题

## 安装

```sh
npm install @grammyjs/stateless-question
```

也可以使用：`pnpm add @grammyjs/stateless-question`、`yarn add @grammyjs/stateless-question`、`bun add @grammyjs/stateless-question`

## README

# 无国籍人问题

> 为在隐私模式下工作的Telegram用户创建无国籍问题

您想要保留用户的隐私 [启用电报隐私模式( 默认)](https://core.telegram.org/bots#privacy-mode), (中文(简体) ), 发送用户用自己的语言翻译问题, 不要保存状态 用户正在这样做吗 ?

这个图书馆想解决这个问题.

基本想法是把问题发给你 [特别文本](https://en.wikipedia.org/wiki/Zero-width_non-joiner) 在结尾. 此文本对于用户来说是看不见的, 但对于您的机器人来说仍然是可见的 。 当用户 对信件的答复被选中。 如果它包含这个特殊的 文本结尾是回答问题。 这样你就可以有很多 字符串用于与翻译时相同的问题。 你只需要这样 确保 `uniqueIdentifier` 在你的机器人里是独一无二的.

特别感谢 [@Ramin-Bateni (英语)](https://github.com/Ramin-Bateni) 拿着 看着 [他的解释](https://github.com/EdJoPaTo/telegraf-inline-menu/issues/44#issuecomment-541063654) 如果你喜欢的话.

## 安装

```bash
npm install grammy @grammyjs/stateless-question
```

## 使用量

```ts
import {StatelessQuestion} from '@grammyjs/stateless-question';

const bot = new Bot(token);

const unicornQuestion = new StatelessQuestion('unicorns', ctx => {
    console.log('User thinks unicorns are doing:', ctx.message)
})

// Dont forget to use the middleware
bot.use(unicornQuestion.middleware())

bot.command('rainbows', async ctx => {
    let text
    if (ctx.session.language === 'de') {
        text = 'Was machen Einhörner?'
    } else {
        text = 'What are unicorns doing?'
    }

    return unicornQuestion.replyWithMarkdown(ctx, text)
})

// Or send your question manually (make sure to use a parse_mode and force_reply!)
bot.command('unicorn', async ctx => ctx.replyWithMarkdown('What are unicorns doing?' + unicornQuestion.messageSuffixMarkdown(), {parse_mode: 'Markdown', reply_markup: {force_reply: true}})
bot.command('unicorn', async ctx => ctx.replyWithHTML(    'What are unicorns doing?' + unicornQuestion.messageSuffixHTML(),     {parse_mode: 'HTML',     reply_markup: {force_reply: true}})
```

### 附加状态

当您的问题针对特定主题时,您可以使用 `additionalState` 记住那个无国籍的人 例如当 您想要知道一个事件正在哪个房间发生 你可以将事件设定为 `additionalState`。这在与 [远程图像内线菜单](https://github.com/EdJoPaTo/telegraf-inline-menu) 改为 存储返回菜单的路径.

```js
const locationQuestion = new StatelessQuestion(
  "target",
  (ctx, additionalState) => {
    console.log("Location of", additionalState, "is", ctx.message.text);
    saveHeroLocation(additionalState, ctx.message.text);
  },
);

// Dont forget to use the middleware
bot.use(locationQuestion.middleware());

bot.command("batman", async (ctx) => {
  return locationQuestion.replyWithMarkdown(ctx, "Where is Batman?", "batman");
});

bot.command("superman", async (ctx) => {
  return locationQuestion.replyWithMarkdown(
    ctx,
    "Where is superman?",
    "superman",
  );
});
```

### `selective` `ForceReply`

分组使用时, 只要求用户回复可能更好 开始提问。 提供电报 `selected` 作为一种选择 [强制收回](https://core.telegram.org/bots/api#forcereply)。 。 。 .

为了让 `selected` 您需要回复信件的工作 (单位:千美元)`reply_to_message_id`)或需要提及应答复的用户 这个.

```ts
await ctx.replyWithHTML(
  "What are unicorns doing?" + unicornQuestion.messageSuffixHTML(),
  {
    parse_mode: "HTML",
    reply_to_message_id: ctx.message.message_id,
    reply_markup: {
      force_reply: true,
      selective: true,
    },
  },
);
```

## 已知问题

### 强制回答问题总是在一些Telegram客户端中显示,甚至在问题已经回答很久之后

见 [4号](https://github.com/EdJoPaTo/telegraf-stateless-question/issues/4)

至于设计选择 Telegram为创建ForceReply Telegram 客户端知道一个问题是否仍然相关. 作为工作 我们可以发送 [回覆键盘移动](https://core.telegram.org/bots/api#replykeyboardremove) 作为 `reply_markup` 带有不需要其他信件的信件 `reply_markup` (仅限 一条信息是可能的).

```ts
const unicornQuestion = new StatelessQuestion("unicorns", async (ctx) => {
  console.log("User thinks unicorns are doing:", ctx.message);
  await ctx.reply("if you think so...", {
    reply_markup: { remove_keyboard: true },
  });
});
```

### 随询问消息一起发送中止/ 返回( 内置) 按钮

见 [1号](https://github.com/EdJoPaTo/telegraf-stateless-question/issues/1)

电报只允许一个 `reply_markup` 在一个时候。 由于此库依赖于 对信件的答复 [强制收回](https://core.telegram.org/bots/api#forcereply) 已经用作 `reply_markup`。为了发送一个带 需要(内含)键盘标记的同样信息。 这将是一个 第二届 `reply_markup` 不幸的电报不支持它.

## 常见问题

### @grammyjs/stateless-question 是什么？

为在隐私模式下工作的Telegram用户创建无国籍问题

### 如何安装 @grammyjs/stateless-question？

在项目目录运行 npm install @grammyjs/stateless-question，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：grammy（^1\.10\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @grammyjs/stateless-question 支持 TypeScript 吗？

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

### @grammyjs/stateless-question 支持 ESM 还是 CommonJS？

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

### @grammyjs/stateless-question 需要什么版本的 Node\.js？

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

### @grammyjs/stateless-question 可以商用吗？

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

### @grammyjs/stateless-question 的下载量有多少？

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

### @grammyjs/stateless-question 还在维护吗？

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

