用途
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 再切回。
飞书应用设置指引
若用户尚未创建飞书应用,技能会引导:
- 前往飞书开放平台 → 创建应用 → 企业自建应用。
- 在应用设置中启用机器人能力。
- 添加所需权限(scopes):im:message(收发消息)、im:message:send_as_bot(以机器人身份发送)、im:resource(上传图片和文件)、im:message.reactions:write_only(添加表情回应,可选)。
- 在事件与回调 → 事件配置中:选择“使用长连接接收事件”,订阅事件 im.message.receive_v1。
- 发布应用版本并等待管理员审批。
- 从应用的凭证与基础信息页面复制 App ID 和 App Secret。
适用场景
- 首次配置飞书通道,保存应用凭证。
- 查看当前凭证与访问策略状态。
- 引导用户完成飞书开放平台应用创建与权限配置。
- 推动从 pairing 策略切换到 allowlist 锁定状态。
限制与注意事项
- 若服务器尚未运行,channels 目录可能不存在;文件缺失表示未配置,不是错误。
- 服务器在启动时只读取一次 .env,凭证变更需要重启会话或运行 /reload-plugins。保存后技能会提示这一点。
- access.json 在每条入站消息时重新读取,通过 /feishu:access 修改的策略立即生效,无需重启。
- 资料未提供收费、价格、平台支持范围或效果保证等信息。