cube-ai/dsh-feishu-client ↗★ 1
@cubeai/dsh-feishu-client
DSH飞书客户端:1)用户(人)通过本插件提供UI访问远端智能体;2)本地DSH通过调用本插件提供工具访问远端智能体。支持的远端智能体包括且不限于:DSH、OpenClaw、WorkBuddy、Weknora等等。
安裝
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add @cubeai/dsh-feishu-client說明文件
閱讀完整 README ↗第一次使用
A. 远端智能体准备(以 DSH 为例)
1. 安装飞书频道插件
在目标 DSH 安装并启用 @cubeai/dsh-feishu-channels 插件 :
dsh plugin --profile web add @cubeai/dsh-feishu-channels
刷新 DSH,侧边栏出现 任务 | 飞书频道。
2. 添加飞书频道
在目标 DSH 的「飞书频道」页签中:
- 点击「添加飞书频道」;
- 填写频道名称;
- 扫码创建飞书机器人应用。
插件会自动开通所需权限并写入重定向 URL,通常不需要再进入飞书开发者后台进行操作。
B. 本地智能体操作
1. 在本地添加机器人
- 点击本地 DSH 左侧边栏的「DSH飞书客户端」;
- 点击「+ 添加飞书机器人」;
- 填写名称、App ID、App Secret。可从目标 DSH 的「飞书频道」设置中复制;
- 保存后进入授权页。
2. 授权并绑定单聊
点击「授权并绑定单聊」,在手机飞书App中扫码/登录并同意。授权成功后插件会自动让机器人发一条设置消息。
绑定成功后,左侧出现机器人,在右侧对话界面直接发消息即可。
本插件必须使用目标智能体正在使用的同一个飞书机器人应用。一个飞书机器人应用只对应一个单聊。
日常使用
机器人列表
- 点击左侧机器人切换对话;
- 列表显示名称、最后一条消息、状态点和时间;
- 点击「+ 添加飞书机器人」可添加新的机器人。
聊天页
- 右上角「刷新」重新拉取消息和授权状态;
- 右上角「设置」进入设置页;
- 输入框支持文字、附件、粘贴图片/文件;
- 消息区支持 Markdown、代码块、图片灯箱、文件卡片和审批按钮。
设置页
设置页分为两张卡片:
- 基本信息:名称、能力描述、标签,修改后点「保存修改」;
- 连接与授权:查看授权和单聊绑定状态,执行授权、重新绑定、重新授权、测试应用、删除机器人。
右上角「返回」回到对话。删除机器人只删除本插件记录,不会删除飞书机器人应用,也不影响飞书侧聊天记录。
Agent 工具用法
- 先让智能体调用
feishu_client_list选择远端; - 再调用
feishu_client_ask提交任务; - 返回
pending、needs_approval或needs_answer时,用feishu_client_continue继续; - 同一远端同时只允许一个请求,第二个请求会返回
busy。
使用限制
- 当前一个飞书机器人应用只对应一个单聊;
- 聊天页加载最近 50 条消息,暂不支持分页;
- 远端飞书频道当前按文本、图片、文件和富文本处理消息,原生语音/视频按文件发送;
- UI 目前为中文,插件元数据提供中英文。