@grammyjs/stateless-question

中文文档
4.0.0发布于 2024/05/24MITTypeScriptES Module零依赖构建来源已验证近 30 天下载 1.3万

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

中文使用文档
文档目录7 节
  1. 安装
  2. 使用量
  3. 附加状态
  4. selective ForceReply
  5. 已知问题
  6. 强制回答问题总是在一些Telegram客户端中显示,甚至在问题已经回答很久之后
  7. 随询问消息一起发送中止/ 返回( 内置) 按钮

无国籍人问题

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

您想要保留用户的隐私 启用电报隐私模式( 默认), (中文(简体) ), 发送用户用自己的语言翻译问题, 不要保存状态 用户正在这样做吗 ?

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

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

特别感谢 @Ramin-Bateni (英语) 拿着 看着 他的解释 如果你喜欢的话.

安装

npm install grammy @grammyjs/stateless-question

使用量

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。这在与 远程图像内线菜单 改为 存储返回菜单的路径.

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 作为一种选择 强制收回。 。 。 .

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

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号

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

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号

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

版本与发布记录

@grammyjs/stateless-question 共发布 4 个版本,首次发布于 2021/09/16;过去 12 个月发布了 0 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
4.0.0latest2024/05/242 年前
3.0.12021/10/205 年前
3.0.02021/09/235 年前
3.0.0-beta.12021/09/165 年前

关于 @grammyjs/stateless-question 的常见问题

@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 和提交记录判断。