每个 Discord 权限都是一个大整数中的一位(例如 KICK_MEMBERS = 1 << 1 = 2,ADMINISTRATOR = 1 << 3 = 8)。API 和机器人邀请链接需要这些位的总和。该工具支持双向转换。
如何使用该工具
勾选所需权限,或从预设(基础、版主、管理员)开始。
在“结果”面板中查看计算出的十进制(或十六进制)整数。
将其复制到邀请链接的 permissions 参数(参见“机器人邀请链接”工具)或您的代码中。
要解码已有整数,请粘贴到输入框,对应复选框会自动勾选。
注意事项
ADMINISTRATOR 拥有所有权限并绕过频道覆盖,仅在确有必要时授予机器人。整数超过 2^53,代码中请使用字符串或 BigInt。T/V/S 列表示适用的频道类型(文字、语音、舞台)。数值已于 2026-10-09 对照 Discord 官方开发者文档核对;文档中未定义第 47 位。
// discord.js
const { PermissionsBitField } = require('discord.js');
const perms = new PermissionsBitField(['ViewChannel', 'SendMessages']);
console.log(perms.bitfield.toString()); // 3072常见问题
- 为什么整数这么大?
- 新权限使用较高的位(最高 1 << 52),总和超出普通 JavaScript 整数范围,因此使用 BigInt 计算。
- 我的数据会被发送到别处吗?
- 不会。所有计算都在浏览器中完成,仅最后一个值保存在浏览器本地存储中。
