potterlee369-prog/dsh-feishu

README 摘要

dsh-feishu DSH 宿主插件： 用飞书控制本机 DSH 。手机或电脑上的飞书客户端给机器人发 @dsh ，插件通过飞书 长连接 （WebSocket，无需公网 IP）收到消息，把指令作为用户消息投递给一个专属 DSH 会话执行完整 agent 流程（工具调用、读写工作区、权限审批都在本机 DSH 内完成），等 DSH 空闲后把最终回复发回同一个飞书会话——手机和 PC 双端同步可见。 飞书后台要求（配置过一次即可） 1. 飞书开放平台 → 自建应用 → 开通机器人能力 （建议机器人名就叫 dsh ，群聊里 @ 它）。 2. 复制 App ID （ cli ... ）与 App Secret 。 3. 权限管理添加（以应用身份开通）： - im:message.p2p msg:readonly （读取用户发给机器人的单聊消息）——私聊必须 - im:message.group at msg:readonly （读取群聊中 @ 机器人的消息）——群聊必须 - im:message:send as bot （以机器人身份发消息） - 如果希望机器人读取群里 所有 消息（不 @ 也触发），再额外加 im:message.group msg 4. 事件与回调： - 订阅 接收消息 im.message.receive v1 - 订阅方式选 “使用长连接接收事件” 5. 创建应用版本并发布 （组织内可用即可，无需上架）。修改权限或事件后必须发新版，否则不会生效。 构建与安装 配置 App ID / App Secret（推荐：设置页面） 重启 dsh web 后打开 设置 → 飞书 ，在页面上填写： - App ID （ cli ... ）与 App Secret ； - 触发词、工作目录等可选项； - 点 保存 —— 凭据变化会立即重连飞书长连接，无需再重启。 设置保存在本机 DSH 设置文档中（ settings 服务），也可以在 cordis.patch.yml 里给 feishu 行写 appId / appSecret 作为底层默认值，页面保存的值会覆盖它： App ID / Secret 也可以用环境变量 DSH FEISHU APP ID 、 DSH FEISHU APP SECRET ；环境变量仅在配置值为空时兜底。 使用 场景 操作 单聊机器人 直接发消息 即可（默认私聊免 @，例如发“帮我看看当前目录有哪些文件”） 群聊 把机器人拉进群，发 @dsh 帮我写一个周报 ，只有 @ 它才触发 发图片（私聊） 直接发图片，DSH 会调用本机 dsh-image-recognizer 识别后回复 发图片（群聊） 在群里 @机器人 后发图片，机器人识别后回复 发文件（私聊） 直接发送文件；文件会下载到 DSH 工作目录的 .feishu-inbox/…

分类