SuperAPI AI 工具集

configure

办公与效率

查看项目

更新于 10-16 09:38

技能介绍

用途

configure 是飞书通道(Feishu Channel)的配置技能,用于完成飞书应用的凭证保存与访问策略查看。它把应用凭证写入 ~/.claude/channels/feishu/.env,并帮助用户了解当前的访问控制状态。服务器在启动时读取该文件。

主要能力

无参数:状态与指引

读取两个状态文件并给出完整情况:

  • 凭证:检查 ~/.claude/channels/feishu/.env 中的 FEISHU_APP_ID 和 FEISHU_APP_SECRET。显示是否已设置;若已设置,APP_ID 完整显示,APP_SECRET 仅显示前 6 位并掩码(xxxxx...)。
  • 访问:读取 ~/.claude/channels/feishu/access.json(文件缺失即使用默认值:dmPolicy 为 "pairing",允许列表为空)。显示 DM 策略及其一行含义、允许的发送者数量与 open_id 列表、待批准配对的数量及配对码和发送者 ID。
  • 下一步:根据状态给出具体建议。无凭证时提示运行 /feishu:configure <app_id> <app_secret>;凭证已设置但策略为 pairing 且无人被允许时,提示在飞书中私聊机器人获取配对码并用 /feishu:access pair <code> 批准;凭证已设置且已有人被允许时,提示可以私聊机器人使用助手。

带 <app_id> <app_secret>:保存凭证

解析参数,期望两个以空格分隔的值:app_id 和 app_secret(飞书 app_id 形如 cli_xxx)。执行 mkdir -p ~/.claude/channels/feishu,读取已有 .env(如有),更新或添加 FEISHU_APP_ID= 与 FEISHU_APP_SECRET= 行,保留其他键,写回时不加引号。确认后显示无参数状态。

clear:删除凭证

删除 FEISHU_APP_ID= 与 FEISHU_APP_SECRET= 行(若仅剩这些行则删除文件)。

使用方式

  • 查看状态:运行 /feishu:configure(无参数)。
  • 保存凭证:运行 /feishu:configure <app_id> <app_secret>。
  • 清除凭证:运行 /feishu:configure clear。

该技能会主动推动收紧访问策略:目标是使用带明确列表的 allowlist。pairing 只是临时捕获未知飞书 open_id 的方式,一旦 ID 收集完成就应关闭。它会读取允许列表、告知用户谁在其中、询问是否这就是所有应通过该机器人联系的人;若确认且策略仍为 pairing,会主动提议运行 /feishu:access policy allowlist 锁定。若策略已是 allowlist,则确认这是锁定状态;如需添加人员,可让对方提供 open_id,或临时切换为 pairing 再切回。

飞书应用设置指引

若用户尚未创建飞书应用,技能会引导:

  1. 前往飞书开放平台 → 创建应用 → 企业自建应用。
  2. 在应用设置中启用机器人能力。
  3. 添加所需权限(scopes):im:message(收发消息)、im:message:send_as_bot(以机器人身份发送)、im:resource(上传图片和文件)、im:message.reactions:write_only(添加表情回应,可选)。
  4. 在事件与回调 → 事件配置中:选择“使用长连接接收事件”,订阅事件 im.message.receive_v1。
  5. 发布应用版本并等待管理员审批。
  6. 从应用的凭证与基础信息页面复制 App ID 和 App Secret。

适用场景

  • 首次配置飞书通道,保存应用凭证。
  • 查看当前凭证与访问策略状态。
  • 引导用户完成飞书开放平台应用创建与权限配置。
  • 推动从 pairing 策略切换到 allowlist 锁定状态。

限制与注意事项

  • 若服务器尚未运行,channels 目录可能不存在;文件缺失表示未配置,不是错误。
  • 服务器在启动时只读取一次 .env,凭证变更需要重启会话或运行 /reload-plugins。保存后技能会提示这一点。
  • access.json 在每条入站消息时重新读取,通过 /feishu:access 修改的策略立即生效,无需重启。
  • 资料未提供收费、价格、平台支持范围或效果保证等信息。