xmanrui/dsh-feishu 预览 preview

xmanrui/dsh-feishu

Plugin插件 Native原生 ⭐ 9 MIT Notifications & Remote通知与远程

通过扫码将飞书机器人接入DeepSeek Harness

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH) that enables users to connect one or more Feishu bots directly to their DSH agent instance. Installation is completed with a single command run from your terminal: npx -y github:xmanrui/dsh-feishu install, after which you need to restart the dsh web process to load the plugin. Once loaded, you can access the plugin configuration from the DSH settings menu under the Plugins section, and add new bots by scanning a QR code with your Feishu app, no manual copying of App ID or App Secret required.

After you scan the QR code and complete all required connection checks, the bot will be marked as Connected in your DSH settings, and you can immediately start sending messages to the bot from your Feishu client. Each bot has fully isolated state: separate credentials, Feishu long connections, authorized users, session mappings, and message deduplication. All interactions with a bot are mapped to a persistent DSH session to preserve multi-turn context, and bots default to using DSH’s standard agent preset, which includes tools like web search. Every bot supports three core commands: /new, /status, and /help.

The plugin follows secure defaults to protect user credentials: RPC endpoints are only accessible from the local DSH page, browsers cannot read or send App Secrets, and only the user who scanned the QR code is authorized to message the bot by default. It is open-sourced under the permissive MIT license, and is currently built against the plugin and Connection RPC interfaces of DeepSeek Harness 0.1.0-rc.6. After upgrading DSH, you are recommended to run the included tests and verify the end-to-end messaging flow before regular use. The repository still retains legacy code for older standalone bridge deployments.

本项目是专为 DeepSeek Harness 开发的原生插件,作用是将一个或多个飞书机器人直接接入 DSH 智能体。用户可通过一条命令从 GitHub 完成安装:npx -y github:xmanrui/dsh-feishu install,安装完成后重启 dsh web 即可使用。接入后,用户无需手动复制 App ID 或 App Secret,只需在 DSH 的插件设置页扫码就能逐个添加机器人。

每个接入的飞书机器人都拥有独立凭据、飞书长连接、授权用户、会话映射和消息去重状态,单个机器人断线、重连或移除都不会影响其他机器人的运行。扫码创建机器人的用户会自动成为该机器人的首位授权用户,创建完成后即可直接在飞书和机器人对话。所有飞书会话都会映射到持久化的 DSH 会话,支持多轮上下文,默认使用 DSH 的 standard 智能体预设,包含网页搜索等工具能力,适合需要在飞书内和 DSH 智能体持续交互的用户使用。

本插件遵循安全默认设计,RPC 仅允许本地 DSH 页面访问,浏览器无法读取或提交 App Secret,所有密钥仅存储在 DSH Host 的凭据存储中。项目采用 MIT 许可证开源,当前针对 DeepSeek Harness 0.1.0-rc.6 的插件接口开发,升级 DSH 后建议先验证功能完整性。仓库仍保留旧版独立桥接代码,兼容早期独立进程部署方案,新安装推荐使用原生插件模式。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 9 stars - very few users, little community feedback星标只有 9,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:xmanrui/dsh-feishu

把 xmanrui/dsh-feishu 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

本项目不维护了,有刚好的插件dsh-im了,支持微信、飞书、钉钉、QQ、企微、Slack、telegram、discord、WhatsApp:https://github.com/xmanrui/dsh-im

dsh-feishu

中文 · English

中文

把一个或多个飞书机器人直接接入 DeepSeek Harness。安装插件后,在 Harness 的设置页扫码即可逐个创建机器人;每次确认完成并通过连接检查后,都能立即在飞书里与同一个 Harness 智能体连续对话。

界面预览

DeepSeek Harness 飞书机器人扫码接入页面

主要能力

  • 在 Harness「设置 → 插件 → 飞书」内反复扫码添加多个机器人,无需手动复制 App ID 或 App Secret
  • 每个机器人拥有独立凭据、飞书长连接、授权用户、会话映射和消息去重状态
  • 单个机器人断线、重连或移除不会中断其他机器人
  • 扫码用户自动成为首位授权用户,创建后即可私聊机器人
  • 收到消息立即添加处理中 Reaction,成功或失败后更新状态
  • 使用飞书 CardKit 原生流式卡片输出,失败时安全回退为普通文本
  • 每个飞书会话映射到持久的 Harness 会话,支持多轮上下文
  • 默认使用 Harness standard 智能体预设,包括网页搜索等工具能力
  • App Secret 仅保存在 DSH Host 的凭据存储中,不进入浏览器、二维码或插件配置文件

安装

从 GitHub 一条命令安装:

npx -y github:xmanrui/dsh-feishu install

安装后重启 dsh web,打开「设置 → 插件 → 飞书」,点击「添加机器人」,再用飞书扫码确认。需要更多机器人时再次点击「添加机器人」即可;扫码只会新增,不会覆盖现有机器人。页面只有在以下条件全部满足后才把该机器人显示为“已连接”:

  1. 飞书应用创建成功;
  2. 凭据已安全保存;
  3. 机器人身份校验成功;
  4. 飞书长连接已建立;
  5. DeepSeek Harness Host 可访问。

连接成功后,在飞书中找到刚创建的机器人并发送消息即可。每个机器人都支持 /new、/status 和 /help。

本地开发

git clone https://github.com/xmanrui/dsh-feishu.git
cd dsh-feishu
npm install
npm test
npm run build
node bin/dsh-feishu.mjs install --source .

插件运行在 dsh web 的 Host 进程内,不需要再维护独立桥接服务。非敏感配置保存在 $DSH_HOME/integrations/dsh-feishu/,各机器人的会话状态彼此隔离;每个 App Secret 都由 Harness 的 credential provider 独立管理。

当前按 DeepSeek Harness 0.1.0-rc.6 的插件与 Connection RPC 接口开发。更新 Harness 后,建议先运行测试并验证设置页、扫码和消息收发闭环。

安全默认值

  • RPC 仅允许本机 Harness 页面访问;
  • 浏览器不能提交或读取 App Secret;
  • 默认只接受扫码创建机器人的飞书用户消息;
  • 机器人使用 standard 工具集,但不会自动批准 Harness 的高风险操作;
  • 移除某个机器人会只停止它自己的长连接并清除它自己的插件凭据,不影响其他机器人;
  • 重复扫码得到同一个飞书应用时会复用原机器人记录,不会产生重复接入。

旧版独立桥接

仓库仍保留 src/index.mjs 与 .env.example,用于兼容早期的独立进程部署。新安装优先使用 Harness 插件模式。

许可证

MIT


English

Connect one or more Feishu bots directly to DeepSeek Harness. After installing the plugin, you can create bots one by one by scanning a QR code in the Harness settings page. Once registration and connection checks succeed, each bot is immediately ready for continuous conversations with the same Harness agent.

Interface preview

Feishu bot QR-code setup in DeepSeek Harness

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-edex-ui 下一个 Next awesome-deepseek-harness-plugins →