configure 是 Discord 频道的配置技能,主要用于完成机器人令牌的保存与访问策略的查看和调整。
用途:当用户提供 Discord 机器人令牌、要求配置 Discord 频道,或询问如何设置访问权限时,可使用该技能。它会将令牌写入 ~/.gemini/config/channels/discord/.env,并让用户了解当前的访问控制状态。
主要能力:
- 无参数运行时显示状态:检查令牌是否已设置(已设置时仅显示前 6 位掩码);读取 access.json,展示 DM 策略、已允许发送者数量与名单、待配对请求数量及配对码、已加入的服务器频道数量,并给出具体的下一步建议。
- 保存令牌:将参数视为令牌,去除空白后写入 .env 文件,保留其他键值,并将文件权限设置为 600。保存后会展示无参数状态,让用户了解当前配置。
- 清除令牌:删除 .env 中的 DISCORD_BOT_TOKEN 行;若该行为唯一内容则删除文件。
使用方式:通过 /discord:configure 命令调用,可附加令牌参数或 clear 子命令。技能会引导用户从配对模式逐步过渡到允许名单模式,主动建议锁定访问权限,避免长期停留在配对模式。
适用场景:需要将 Discord 机器人接入助手、管理可访问机器人的用户名单、检查配置状态或清除已保存令牌时。
限制:令牌变更需要重启会话或重新加载插件才能生效;访问策略文件在每次收到消息时重新读取,策略变更即时生效。频道目录可能尚未存在,缺失文件视为未配置而非错误。