Discord API Emoji Reactor

通过用户提供的Authorization Token直接调用Discord API添加Emoji反应。支持多方案、用户黑白名单(ID或用户名混用)、ID未知时追溯、为特定用户(ID/用户名)指定不同反应方案并可独立开关、配置导入导出。菜单视觉优化。

安装此脚本？

提问、发表评价或者举报此脚本。

作者

MAX-TAB

日安装量

总安装量

评分

0 0 0

版本

1.0

创建于

2025-05-07

更新于

2025-05-07

大小

97.5 KB

许可证

MIT

适用于

discord.com

📢 重要提示与风险声明

违反 Discord 服务条款 (ToS) 风险: 自动化用户账户行为，特别是通过非官方方式使用用户 Token，可能违反 Discord 的服务条款。这可能导致你的账户被警告、暂时封禁，甚至永久封禁。请自行承担使用此脚本带来的所有风险。
Authorization Token 安全性: 此脚本需要你手动提供 Discord Authorization Token。这个 Token 非常敏感，相当于你的账户密码。请务必妥善保管，不要泄露给任何人，也不要在不信任的网站或脚本中使用。 作者不对因 Token 泄露造成的任何损失负责。
Token 时效性: Authorization Token 可能会在你退出登录(不可用)、更改密码或长时间未使用后失效，届时需要重新获取并设置。
API 变更风险: Discord 随时可能更改其内部 API，导致此脚本失效。
避免滥用: 请合理使用此脚本，避免过于频繁的自动化操作，以免对 Discord 服务器造成不必要的负担或被视为滥用行为。

✨ 功能特性

通过 API 反应: 直接调用 Discord API 添加 Emoji，反应更稳定、快速，且受前端 UI 变化影响较小。
灵活的 Emoji 配置方案:
- 支持创建和管理多个全局 Emoji 配置方案 (例如 "默认", "开心", "工作用" 等)。
- 可以轻松切换全局默认使用的方案。
- Emoji 字符串格式:
  - 使用分号 (;) 分隔不同的随机反应组。脚本会从这些组中随机选择一个进行反应。
  - 在一个随机选中的组内部，如果使用逗号 (,) 分隔多个 Emoji，脚本会尝试按顺序为该消息添加所有这些 Emoji。
  - 示例: 👍;🎉,❤️,😄 (脚本会随机选择：或者是单独反应 👍，或者是依次反应 🎉、❤️、😄 这三个 Emoji)
强大的用户过滤 (黑/白名单模式):
- 支持 "不过滤"、"黑名单模式" (匹配用户不反应)、"白名单模式" (仅匹配用户反应)。
- 黑/白名单列表支持混合输入【用户 ID】和【用户名】(用户名不区分大小写)。脚本在判断时会优先尝试匹配 ID 规则。
ID 未知时的高级处理 (含追溯功能):
- 当无法直接从新消息中获取发送者 ID 时 (例如对方使用默认头像或为连续消息)，可配置三种行为模式：
  - trace (追溯 - 默认): 尝试从该消息的前序消息中查找有效的发送者 ID。若追溯成功，则使用该 ID 进行过滤和专属方案判断；若失败，则该消息不进行反应。
  - in_list (按名单内处理): 根据当前过滤模式，将未知 ID 用户视为在名单内 (例如，黑名单模式下不反应, 白名单模式下反应)。
  - not_in_list (按名单外处理): 根据当前过滤模式，将未知 ID 用户视为在名单外 (例如，黑名单模式下反应, 白名单模式下不反应)。
用户专属 Emoji 方案 (支持 ID/用户名，可独立开关):
- 可以为特定的【用户 ID】或【用户名】（不区分大小写）指定一个专属的全局 Emoji 方案。当该用户发消息时，优先使用为其指定的方案。
- 独立开关: 每个用户专属方案规则都可以单独【启用】或【禁用】。禁用后，该用户将使用全局默认方案，而无需删除规则。
- 批量添加: 支持一次为多个用户 ID 或用户名设置同一个专属方案。
目标频道设置:
- 可以指定脚本只在特定的一个或多个频道 ID 生效。如果留空，则脚本会对所有频道生效。
配置导入/导出:
- 可以方便地导出当前脚本的所有设置 (包括 Emoji 方案、过滤规则、专属方案等) 到一个 JSON 文件，用于备份或迁移。
- 支持从导出的 JSON 文件导入配置，快速恢复或同步设置。导出时会提示是否包含敏感的 Auth Token。
视觉优化的用户菜单:
- 所有设置均可通过油猴脚本菜单轻松配置。菜单项通过模拟树状结构进行分组，更易于查找和操作。
详细的帮助信息:
- 菜单内提供关于获取 Auth Token、配置过滤规则与专属方案、使用自定义表情等关键操作的详细文字说明。
初始消息处理优化:
- 脚本对频道初次加载时出现的大量历史消息进行了处理优化，更专注于后续接收到的新消息，避免不必要的反应。

🛠️ 安装与使用

安装油猴扩展: 首先，你需要在你的浏览器中安装 Tampermonkey (推荐) 或类似的脚本管理器扩展。
安装此脚本: 点击 Greasy Fork镜像页面上的 "安装此脚本" 按钮。
获取并设置 Authorization Token (关键步骤):
- 在 Discord 网页版 (discord.com) 中登录(不可用)你的账户。
- 按 F12 键 (或 Ctrl+Shift+I / Cmd+Option+I) 打开浏览器开发者工具。
- 切换到 "网络 (Network)" 标签页。
- 在过滤器 (Filter) 中可以输入 /api 或 library 以便筛选。
- 在 Discord 界面进行一些操作 (如发送消息、切换频道) 以产生网络请求。
- 在请求列表中，找到任意一个发往 discord.com/api/... 的请求 (例如 messages, typing, library, science 等)。
- 点击该请求，在右侧面板中找到 "标头 (Headers)" -> "请求标头 (Request Headers)" 部分。
- 仔细查找名为 authorization (全小写) 的条目，并完整复制其值 (这是一段非常长的、由字母、数字和特殊符号组成的字符串，不要复制 "authorization: " 这部分)。
- 点击浏览器右上角的油猴扩展图标，找到本脚本 ("Discord API Emoji Reactor")，进入其菜单。
- 选择 "设置 Discord Auth Token"。
- 将复制的 Token 粘贴进去并保存。
- 脚本菜单中的 "❓ 帮助信息" -> "如何获取 Auth Token?" 也提供了此操作的详细说明。
配置 Emoji 方案:
- 在脚本菜单中，进入 "📂 全局 Emoji 方案管理"。
- 你可以通过 "添加新方案" 来创建新的 Emoji 组合，或通过 "编辑当前方案Emojis" 来修改选定的方案。
- Emoji 字符串输入格式说明:
  - 使用分号 (;) 分隔不同的随机选项组。脚本会从这些组中随机选择一个。例如: 👍;😄;🎉
  - 在一个选项组内部，使用逗号 (,) 分隔表示要依次反应的多个 Emojis。例如: 👍,❤️,💯
  - 可以混合使用: 👍; 😄,❤️; 🎉
  - 标准 Unicode Emoji: 请直接输入 Emoji 字符本身 (例如: 👍, ❤️, 🎉)。不要使用英文短代码如 :thumbsup: (API 不支持此格式的反应)。
  - 服务器自定义 Emoji:
    - 在 Discord 聊天输入框中，正常输入或选择你想要的服务器自定义表情。
    - 【不要发送消息！】此时观察输入框，自定义表情会显示为一段特殊的代码，格式通常是：<:myemoji:123456789012345678> (静态) 或 <a:myemoji:123456789012345678> (动态)。
    - 完整复制这个 <...> 格式的字符串 (包括尖括号和冒号) 并将其粘贴到本脚本的 Emoji 配置方案的 Emoji 字符串中。
    - 脚本菜单中的 "❓ 帮助信息" -> "如何使用服务器自定义表情?" 有详细说明。
(可选) 配置用户过滤 (黑/白名单):
- 在脚本菜单中，进入 "👥 用户过滤设置"。
- 通过 "切换过滤模式" 选择 "不过滤"、"黑名单模式" 或 "白名单模式"。
- 使用 "编辑黑名单 (ID/名)" 或 "编辑白名单 (ID/名)" 来添加或修改列表。可以输入用户 ID 或用户名，多个条目用英文逗号 , 分隔。
- 在 "ID未知时行为" 中选择当无法获取发送者ID时的处理策略（追溯、按名单内、按名单外）。
- 详细说明请参阅菜单中的 "❓ 帮助信息" -> "用户过滤与专属方案配置说明"。
(可选) 设置用户专属 Emoji 方案:
- 在脚本菜单中，进入 "👤 用户专属方案 (ID/用户名)"。
- 使用 "✨ 添加/修改专属方案 (可批量)" 为指定的用户 ID 或用户名绑定一个已创建的全局 Emoji 方案。
- 可以通过 "⚙️ 切换规则启用/禁用状态" 来管理各条专属规则的激活状态。
(可选) 设置目标频道 ID:
- 在脚本菜单中，进入 "⚙️ 其他设置与数据管理" -> "设置目标频道ID"。
- 输入一个或多个 Discord 频道的数字 ID，用英文逗号 , 分隔。如果留空，脚本将对所有频道生效。
(可选) 备份与恢复配置:
- 在 "⚙️ 其他设置与数据管理" 中，您可以使用 "📥 导出脚本配置" 来备份您的所有设置，或使用 "📤 导入脚本配置" 来恢复。
启用脚本:
- 在脚本菜单中，选择最顶部的 "切换API自动反应"，确保其状态显示为 "✅ ... (当前: 开启)"。
- 如果 Auth Token 未设置或无效，脚本通常会自动禁用并给出提示。

❓ 常见问题与故障排除

脚本不工作/没有反应:
1. 检查 Auth Token 是否正确设置且仍然有效。 Token 可能会过期，需要重新获取并更新到脚本设置中。
2. 检查脚本是否已在菜单中启用（显示为 ✅ 开启）。
3. 检查浏览器控制台 (按 F12，然后切换到 "Console" 标签页) 是否有红色的错误信息。 这些信息可能指示问题所在。
4. 检查 Emoji 配置方案中的 Emoji 字符串格式是否正确。 特别注意标准 Unicode Emoji 必须是字符本身，自定义 Emoji 必须是完整的 <...> 格式。
5. 检查用户过滤设置（黑/白名单、ID未知时行为）是否意外地将目标用户或消息排除。
6. 检查目标频道 ID 设置是否正确配置，或者是否因为设置了特定频道而导致在其他频道不生效。
7. Discord API 可能已更新或脚本本身存在 bug。 这种情况下，脚本可能需要更新才能恢复正常工作。
提示 "授权令牌无效 (401/403)" 或类似错误:
- 这通常意味着您设置的 Auth Token 已过期、不正确或已被撤销。请按照上述步骤重新获取一个新的 Auth Token，并在脚本菜单中更新它。脚本在此类错误后通常会自动禁用。
提示 "未知表情符号 (Unknown Emoji)" 或 API 错误代码 10014:
- 这表示您在 Emoji 配置中使用的某个 Emoji 对于 Discord API 来说是无效的或您无权使用。
  - 标准 Emoji: 确保您输入的是 Emoji 字符本身 (如 👍)，而不是它的英文短代码 (如 :thumbsup:)。
  - 自定义 Emoji: 确保您使用的是从 Discord 输入框中复制的完整 <:name:id> 或 <a:name:id> 格式。同时，请确认您的账户有权限在该服务器和频道中使用此自定义表情，并且该表情未从服务器中删除。
提示 "速率限制 (429 Too Many Requests)" 或反应变慢/失败:
- 您可能在短时间内触发了过多的 API 请求，这通常发生在：
  - Emoji 配置中使用了大量通过逗号分隔的序列反应 (例如 😀,😂,🤣,😄,😅,😆)。
  - 脚本在非常活跃、消息刷新极快的频道中运行。
- 解决方法：
  - 尝试在 Emoji 配置中减少序列反应中 Emoji 的数量。
  - 如果问题持续，考虑暂时禁用脚本一段时间，或仅在消息流量较小的频道中使用。
  - （高级用户）可以尝试修改脚本内部处理反应的延迟时间（但这需要直接编辑脚本代码）。
追溯功能不准确或无效:
- 追溯功能（用于获取无直接发送者信息消息的作者）依赖于消息在页面上的 DOM 结构和排列顺序。诸如快速滚动页面、大量系统消息的插入/删除、或 Discord 进行界面结构更新等因素，都可能影响其准确性。
- 当前的追溯深度是有限的（通常是向上几条消息）。

感谢使用！ 如果您发现任何 bug 或有改进建议，欢迎通过 Greasy Fork镜像平台反馈。