JMOKSZ/dsh-lark-bridge

Feishu(飞书)是DeepSeek Harness的入口点:通过飞书机器人驱动dsh代理,支持流式卡片、询问/批准按钮及附件功能。

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH) that lets users access their local DSH agent remotely via a Feishu (Lark) bot. To install the plugin, users first need to have DSH CLI, pnpm, and Node.js 22 or higher installed on their local machine. After that, they can run a single command dsh plugin --profile lark add @jmoksz/lark-bridge --ignore-scripts to complete installation, which automatically creates the lark profile for DSH. Users also need to create a custom enterprise Feishu app with bot capability, get the App ID and App Secret, and set them as environment variables before running.

When a user sends a message to the bot in Feishu, the request is forwarded to the local DSH agent, which handles tasks like reading and writing files, running commands, and searching the web. The entire process is updated in real time on a streaming message card, which shows thinking process, tool calls, and intermediate results, and is sealed as a final response once the task completes. Each Feishu chat (whether single user or group) gets an independent DSH session, which keeps context across restarts, so users don’t lose their work if the agent restarts. In group chats, the bot only responds when it is mentioned by default, which can be changed in configuration.

The plugin is released under the open source MIT license, so users can use it, modify it, and distribute it freely without any cost. It comes with built-in test scripts that let developers test the card building and end-to-end flow without a real Feishu app or working LLM key. There are multiple configurable options, including whether to enable cards, response rules for group chats, streaming update intervals, and max attachment size, which is capped at 100MB to match Feishu’s official limit. To run the plugin after configuration, users just execute the command with the required environment variables in the terminal.

这是一款专为 DeepSeek Harness (DSH) 开发的原生插件,实现了通过飞书(Lark)机器人远程调用本机运行的 DSH Agent 的能力。用户在飞书中向机器人发送消息,机器人会将请求转发给运行在本地的 DSH 执行,包括读写文件、运行命令、网页搜索等各类任务,处理过程通过流式消息卡片实时呈现。它基于官方WebSocket长连接运行,无需公网IP和反向代理,在内网环境即可完成部署,支持一条命令完成安装配置。

普通用户可以直接在飞书单聊或群聊中使用,每个飞书会话对应一个独立的DSH会话,互不干扰,跨重启会自动恢复上下文,群聊默认仅响应被@的消息。用户发送的图片、文件等附件会自动下载保存,视觉模型可直接读取图片内容。需要用户交互或工具审批时,会生成带按钮的交互卡片,用户点击按钮即可完成作答,也可以直接回复文字或编号。

本插件采用MIT许可证开源,使用前需要预先安装DSH CLI、pnpm、Node.js 22以上版本,以及准备好飞书企业自建应用的App ID和App Secret,配置对应的环境变量即可运行。插件支持自定义多项配置,比如卡片开关、群聊响应规则、流式更新间隔等,附件最大支持100MB,符合飞书官方限制。用户可通过项目提供的脚本完成本地开发和测试。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
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 lark add @jmoksz/lark-bridge --ignore-scripts

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

READMEREADME

DSH 飞书入口(Lark Bridge)

npm Awesome DSH Plugin CI

通过飞书机器人远程使用 DSH(DeepSeek Harness):在飞书里给机器人发消息,机器人交给运行在本机的 DSH agent 执行(读写文件、跑命令、搜索网页等),处理过程用流式消息卡片实时呈现,最终回答 sealed 进卡片回复。

本质是一个 cordis 插件(@jmoksz/lark-bridge)+ 一个 DSH profile(lark)。走官方长连接(WebSocket),无需公网 IP、无需反向代理,在家/内网即可部署。

功能与特点

  • 🎞️ 流式回复卡片(默认开启):每条任务一张「🤖 DSH 处理中…」实时卡片,思考、回答草稿、工具调用面板(状态符号·工具名·参数摘要)随执行 PATCH 更新;完成 sealed 为绿色终态(最终回复+用时+字数),出错为红色错误态
  • 📨 主动推送:agent 可用 feishu_send 工具主动向会话推送文本/卡片(中途汇报、结果分发、主动提醒)
  • 🎴 交互问答 & 审批卡片:ask_user_question 与工具审批渲染为按钮卡片,点击即作答;也可直接回复编号/文字
  • 🖼️ 附件处理:图片/文件/视频/音频自动下载保存;视觉模型下图片直接附加给模型
  • 📝 富文本:post 富文本消息自动提取纯文本
  • 🧵 多会话:每个飞书 chat(单聊或群)一个独立 DSH session,互不干扰;跨重启自动恢复上下文
  • 👥 群聊 @ 过滤:默认只在被 @ 时响应(可关闭)
  • 🛠 命令:/new(新会话)、/status、/whoami、/help

安装

前置:本机已装 DSH CLI(npm i -g @deepseek-ai/dsh)、pnpm、Node.js ≥ 22,以及一个可用的 LLM key。

一条命令安装(自动创建 lark profile,无需额外补丁文件):

# 从 npm 安装
dsh plugin --profile lark add @jmoksz/lark-bridge --ignore-scripts

# 或从 GitHub 安装
dsh plugin --profile lark add github:JMOKSZ/dsh-lark-bridge --ignore-scripts

本地开发:clone 后运行 ./scripts/setup-lark-profile.sh(可重复执行刷新代码)。

配置

1. 飞书开放平台(一次性)

  1. 创建企业自建应用,添加机器人能力,记下 App ID / App Secret
  2. 开通权限:im:message、im:message:send_as_bot、im:message.group_at_msg、im:chat、im:resource(附件必需)、im:message:update(卡片更新必需)
  3. 事件与回调 → 订阅方式选 「使用长连接接收事件」,添加事件 im.message.receive_v1;如需卡片按钮点击,另订阅 card.action.trigger
  4. 可用范围设为需要使用的成员/部门,发布版本

2. 环境变量

凭据全部来自环境变量(不写入配置文件):

变量 必填 说明
LARK_APP_ID 是 飞书应用 App ID
LARK_APP_SECRET 是 飞书应用 App Secret
LARK_WORKSPACE 否 agent 工作目录(默认启动目录)

模型 key 与 DSH 一致:export DEEPSEEK_API_KEY=sk-xxx 或写入 $DSH_HOME/.credentials.yaml。

3. 运行

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-plugin-hub 下一个 Next dsh-notifications →