用途:通过 commands/ 目录下的 CLI 脚本管理 Discord 服务器。共 18 个无状态命令,连接、执行、断开,输出均为 JSON,任意命令可加 --help 查看用法。
前提:.env 中的机器人令牌有效,且机器人已在服务器中并具备管理频道、管理角色和发送消息权限。
用法:所有命令以 node commands/<command>.mjs <args> 运行。读取类(无副作用)包括 server-info.mjs、list-channels.mjs、list-members.mjs、read-messages.mjs <channel> [--limit N](默认 10,最大 100)、list-roles.mjs、list-threads.mjs <channel>。写入类包括 send-message.mjs <channel> <message>、send-embed.mjs(支持 --title、--description、--field、--color、--footer)、edit-message.mjs、create-channel.mjs <category> <name>(可加 --topic、--read-only)、create-thread.mjs、set-topic.mjs、create-role.mjs、assign-role.mjs、remove-role.mjs、pin-message.mjs。破坏性操作 delete-channel.mjs 与 delete-role.mjs 必须加 --confirm 才会执行,运行前应获得用户明确确认。
输出:成功返回 { "ok": true, ... },错误返回 { "error": "description" },应先解析输出确认成功再向用户报告。
限制:需有效机器人令牌与相应权限;破坏性命令需 --confirm;资料未提供其他平台、收费或效果信息。