本文旨在指导BetterDiscord插件开发者如何安全地更新用户“关于我”简介。鉴于直接获取并使用用户Token存在严重的安全风险，可能导致账户泄露，文章详细介绍了利用Discord内部`dispatch`函数作为替代方案。通过这种方法，开发者可以在不接触敏感用户凭证的前提下，实现对用户简介的程序化更新，从而确保插件功能与用户账户安全并存。
在BetterDiscord插件开发中，有时需要与Discord的API进行交互，例如更新用户的个人资料信息。一个常见的需求是修改用户的“关于我”简介。开发者可能自然地想到通过获取用户Token，然后向Discord API发送HTTP请求来实现。然而，直接获取并使用用户Token是一种极度危险的行为，它相当于直接暴露了用户的账户凭证，可能导致账户被盗用、滥用，并违反Discord的服务条款。因此，我们强烈建议规避任何直接获取和使用用户Token的方法。
规避直接使用用户Token的风险
用户Token是访问Discord账户的敏感凭证。一旦泄露，攻击者可以利用它完全控制用户的账户，包括发送消息、加入/离开服务器、更改设置等。BetterDiscord插件作为在用户客户端运行的代码，虽然具备较高的权限，但绝不应滥用这些权限去窃取或存储用户Token。为了确保用户账户安全和插件的合规性，必须寻找替代方案。
安全替代方案：利用Discord内部Dispatch函数
Discord客户端本身通过一系列内部函数来管理和更新用户界面及数据状态。其中一个关键机制是dispatch函数，它负责处理各种内部事件和状态更新。我们可以利用BetterDiscord的BdApi.Webpack模块来访问这些内部函数，从而在不涉及用户Token的情况下，安全地更新用户的“关于我”简介。
BdApi.Webpack是BetterDiscord提供的一个强大工具，它允许插件开发者访问Discord客户端内部的Webpack模块系统。通过搜索特定的字符串或属性，我们可以定位到Discord用于更新用户简介的内部dispatch函数。
实现步骤与代码示例
以下是利用dispatch函数更新用户“关于我”简介的具体步骤和代码示例：
-
定位Dispatch函数： Discord在内部更新用户简介时，会调用一个特定的dispatch函数，并传递一个包含新简介内容的动作。我们可以通过搜索与此操作相关的字符串来定位这个函数。在当前版本的Discord中，更新用户简介的内部动作字符串通常是"USER_SETTINGS_ACCOUNT_SET_PENDING_BIO"。
const dispatch = BdApi.Webpack.getByStrings("USER_SETTINGS_ACCOUNT_SET_PENDING_BIO", { searchExports: true });- BdApi.Webpack.getByStrings()：这是BetterDiscord API提供的一个方法，用于在Discord的Webpack模块中查找包含特定字符串的模块。
- "USER_SETTINGS_ACCOUNT_SET_PENDING_BIO"：这是我们用来定位目标dispatch函数的关键字符串。它暗示了该函数与设置待处理的用户简介（bio）相关。
- { searchExports: true }：这个选项告诉getByStrings不仅要在模块的内部代码中搜索字符串，还要在模块的导出（exports）中搜索，以确保能找到实际可调用的函数。
-
调用Dispatch函数更新简介： 一旦成功获取到dispatch函数，你就可以像调用普通函数一样来使用它，并传入你想要设置的新简介内容。
const newBioContent = "这是我的新简介内容，通过BetterDiscord插件更新。"; if (dispatch) { dispatch(newBioContent); console.log("用户简介已尝试更新。"); } else { console.error("未能找到更新用户简介的dispatch函数。"); }- dispatch(newBioContent)：将新的简介字符串作为参数传递给找到的dispatch函数。Discord客户端会接收到这个内部指令，并相应地更新用户的简介。
完整代码示例：
/**
* BetterDiscord插件示例：安全更新用户“关于我”简介
*
* 注意：此方法依赖于Discord内部实现，可能随Discord更新而变化。
* 请定期检查兼容性。
*/
module.exports = class MyProfileUpdater {
getName() { return "ProfileUpdater"; }
getDescription() { return "一个安全更新用户简介的BetterDiscord插件示例。"; }
getVersion() { return "1.0.0"; }
getAuthor() { return "YourName"; }
start() {
BdApi.showToast("ProfileUpdater插件已启动。", { type: "info" });
this.updateUserBio("Hello from BetterDiscord! My bio was updated securely.");
}
stop() {
BdApi.showToast("ProfileUpdater插件已停止。", { type: "info" });
}
updateUserBio(bioText) {
try {
// 尝试通过内部字符串定位Discord的dispatch函数
const dispatch = BdApi.Webpack.getByStrings("USER_SETTINGS_ACCOUNT_SET_PENDING_BIO", { searchExports: true });
if (dispatch) {
// 调用dispatch函数更新用户简介
dispatch(bioText);
BdApi.showToast(`用户简介已更新为: "${bioText}"`, { type: "success" });
console.log(`用户简介已更新为: "${bioText}"`);
} else {
BdApi.showToast("错误：未能找到更新用户简介的内部函数。", { type: "error" });
console.error("错误：未能找到更新用户简介的内部函数。Discord可能已更新或字符串不再匹配。");
}
} catch (e) {
BdApi.showToast(`更新简介时发生错误: ${e.message}`, { type: "error" });
console.error("更新用户简介时发生错误:", e);
}
}
};注意事项
- 内部API的不稳定性：利用BdApi.Webpack访问的Discord内部函数和字符串并非公开API，它们可能随着Discord客户端的更新而改变。这意味着你的插件可能在未来的Discord版本中失效，需要进行维护和适配。
- 插件兼容性：在发布插件之前，务必在不同版本的Discord客户端（如果可能）上进行测试，以确保其兼容性。
- 用户告知：尽管此方法不涉及Token，但插件仍然在修改用户的个人资料。在插件中清晰地告知用户插件将执行的操作，并提供启用/禁用该功能的选项，是良好的开发实践。
- 避免滥用：不要频繁或未经用户同意地更新用户简介，这可能会对用户体验造成负面影响，甚至导致账户被Discord警告。
总结
在BetterDiscord插件中更新用户“关于我”简介时，最安全且推荐的方法是利用Discord客户端内部的dispatch函数，而非尝试获取和使用用户Token。通过BdApi.Webpack.getByStrings()定位特定的内部更新机制，可以在不牺牲用户账户安全的前提下实现所需功能。尽管这种方法依赖于内部实现，可能存在一定的维护挑战，但它为开发者提供了一条安全有效的路径。始终将用户安全放在首位，并遵循最佳实践进行插件开发。
