dsh-feishu-channel：在飞书里驱动 DeepSeek Harness

前言¶

DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。在开发或调试 agent 时，频繁切换聊天软件和命令行终端是常见的干扰。本插件通过飞书 IM 通道，将聊天界面直接变为 DSH 的远程控制台，利用 WebSocket 长连接实现流式响应与交互式决策。

插件定位¶

这是一个由 whoisjiahao 维护的 DSH 客户端插件。它不提供独立的 AI 模型，而是作为飞书与 DSH 之间的桥接层。其核心价值在于将飞书的富卡片与交互能力引入 DSH 流程，让 agent 在聊天中通过按钮完成权限审批、参数确认，并将推理过程实时渲染。

核心功能¶

• 扫码即用：无需预先配置飞书应用。启动 DSH web 时打印二维码，飞书扫描即可自动创建应用并持久化凭据。
• 流式富卡片：回复以卡片形式呈现，支持加载中实时进度、完成态结论、失败态重试。超限时自动降级为原生文本消息。
• 一键审批：当 agent 需要文件读写或 Shell 权限时，飞书端弹出交互卡片，点击按钮即可决策，无需切窗口打字。
• 交互命令：发送裸命令（如 /help）会自动生成交互卡片。有固定选项的显示下拉框，需参数的显示输入框，无参数的显示确认按钮。
• 无需公网：基于 WebSocket 长连接通信，不需要配置公网 URL、回调地址或端口转发。
• 多会话隔离：私聊、群聊、话题各自拥有独立的 agent，互不干扰。支持 /new 和 /stop 控制会话。
• 安全默认：默认拒绝非白名单流量。生产环境必须配置白名单以确保安全。

安装与启用¶

本插件依赖宿主的核心服务（agents、settings、commands、sessionController），需要先运行 DSH web 环境。

1. 环境要求

   • Node.js 版本需满足 ^22.19.0 || >=24。
   • 运行 dsh web。

2. 安装插件
   在 ~/.dsh/profiles/web 目录下执行以下命令：

    dsh plugin --profile web add github:whoisjiahao/dsh-feishu-channel#v0.9.0

3. 启动与授权
   重启 dsh web。控制台会打印二维码提示：

    feishu-channel: 请用飞书扫码创建应用…

使用飞书 App 扫描该二维码，确认创建应用。凭据会自动保存在配置中，下次启动无需再扫。

使用方式¶

• 基础对话：在飞书私聊或群聊中（群聊需 @ 机器人）发送消息，agent 会以流式卡片形式回复。
• 命令交互：直接发送 /new、/reset、/stop 等命令，飞书会自动生成交互控件供你选择或输入。
• 权限审批：当 agent 执行需要敏感权限的操作时，飞书界面会弹出审批卡片，点击“允许”或“拒绝”即可。

配置与安全¶

插件默认仅允许白名单内的流量。在生产环境中，必须在配置中设置以下项以确保安全：

• senderAllowlist：私聊白名单，限制只有特定用户能发起对话。
• groupAllowlist：群聊白名单，限制只有特定群组能使用。
• approvers：审批白名单，限制只有特定用户能点击审批按钮。

常用命令¶

在飞书中可直接使用以下命令控制 agent：

• /new：新建空白会话
• /reset：重置当前会话
• /stop：停止当前任务
• /model：查看或切换模型
• /effort：查看或调整推理强度
• /help：列出可用命令

结语¶

该插件通过飞书将 DSH 的能力嵌入日常沟通流中，适合需要在聊天窗口内快速验证 agent 逻辑或进行简单运维的开发者。所有代码开源，遵循 MIT 协议。

• 插件目录
• GitHub 仓库