sliverp/DeepSeek-harness-lark

用于DeepSeek Harness的飞书和Lark文本与图像通道插件

Project Overview项目介绍

This is a native channel plugin built exclusively for DeepSeek Harness, enabling connectivity to both Chinese Feishu and international Lark. It uses the official Lark Node SDK and WebSocket transport, so no public callback server is required for operation. You can install it directly via the DSH CLI with the command pnpm dsh plugin --profile web add github:sliverp/DeepSeek-harness-lark, or install it from a local checkout by pointing to the absolute path of the cloned repository. It supports configurable access policies for both direct and group chats, and defaults to requiring a bot mention in group conversations to trigger a response.

This plugin is designed for developers and administrators who want to run their DeepSeek Harness agent inside the Lark/Feishu chat ecosystem. It handles all common message types, including text, rich text, images, and ordinary files uploaded by end users. Inbound images and files are downloaded to a .dsh-lark/inbox/ directory under the agent workspace, so DeepSeek Harness can use its built-in filesystem tools to inspect their contents directly. It also maintains persistent, isolated sessions for each chat, and the /new command lets users start a fresh session without deleting existing chat history.

The plugin requires Node.js 22.19 or later, pnpm 10.33.4, and DeepSeek Harness 0.1.0-rc.7 or newer, and it is released under the open source MIT license. To use it, you first need to create a custom application in the Feishu/Lark developer console, enable bot capabilities, add the required permission scopes, and configure long-connection event delivery for message reception. You then add your Lark App ID to your environment or DSH configuration, and store the App Secret via the DSH credential service. If credentials are missing or invalid, the channel will go dormant without blocking the entire DSH startup process.

这是一款专为 DeepSeek Harness 开发的原生飞书/ Lark 渠道插件,使用飞书官方 Node SDK 开发,通过官方 WebSocket 长连接传输数据,无需公网回调服务器,同时支持国内版飞书和国际版 Lark。用户可以通过 pnpm 命令行直接从 GitHub 仓库或本地检出目录安装,安装后无需额外编译即可直接使用,支持访问控制、多模态消息处理等核心功能。

该插件面向需要将 DeepSeek Harness 接入飞书/ Lark 聊天生态的开发者和运维人员,支持私聊和群聊自定义访问控制,默认群聊需要提及机器人才能触发响应。用户发送的文本、富文本、图片、普通文件都会被正确处理,文件会下载到代理工作区的指定目录,方便 DeepSeek Harness 的文件系统工具读取和检查内容。

该插件要求 Node.js 22.19 或更高版本、pnpm 10.33.4 以及 DeepSeek Harness 0.1.0-rc.7 或更高版本,采用 MIT 开源许可证。首次使用需要先在飞书开发者后台创建自定义应用,配置权限和长连接事件,再将凭证填入 DeepSeek Harness;未配置凭证不会阻塞 Harness 启动,仅会将该渠道置为离线。

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 web add github:sliverp/DeepSeek-harness-lark

把 sliverp/DeepSeek-harness-lark 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

DeepSeek Harness Lark / Feishu plugin

A DeepSeek Harness channel powered by the official @larksuiteoapi/node-sdk. It uses the official WebSocket transport, so no public callback server is required, and supports both Feishu and international Lark.

Features

  • Official WebSocket connection and automatic reconnection
  • Direct and group access policies; groups require a bot mention by default
  • Text, rich-text, image, and ordinary-file input
  • Durable Harness attachments with model-aware multimodal input
  • Ordinary files are downloaded into .dsh-lark/inbox/ under the Agent workspace so filesystem tools can inspect them
  • Model text replies, generated-image upload, and workspace-file delivery
  • Persistent, isolated Harness sessions per chat; /new retains old history and switches to a blank session
  • Agent presets are mounted and recorded for both creation and resume; the default is standard
  • Registered Harness slash commands execute directly instead of being sent to the model
  • Same-conversation /approve <code> and /reject <code> decisions for one-shot tool approvals
  • /bot-ping, /bot-help, /bot-image-test, /bot-file-test, /bot-status, /bot-cancel
  • App Secret resolution through the Harness credential service
  • Dormant startup when App ID or App Secret is not configured, so installation alone never blocks Harness Web

Requirements

  • Node.js 22.19 or later
  • pnpm 10.33.4
  • DeepSeek Harness 0.1.0-rc.7 or later

Install

pnpm dsh plugin --profile web add github:sliverp/DeepSeek-harness-lark

For a local checkout:

pnpm dsh plugin --profile web add /absolute/path/to/DeepSeek-harness-lark

Configure the Lark application

  1. Create a custom application in the Feishu developer console and enable its bot capability.
  2. Grant im:message.p2p_msg:readonly, im:message.group_at_msg:readonly, im:message:readonly, im:message:send_as_bot, and im:resource. The im:message:readonly scope is required by Feishu's message-resource download endpoint for user-sent images and files.
  3. Select long-connection event delivery and subscribe to im.message.receive_v1.
  4. Publish an application version and add the bot to the required chats.
  5. Put the App ID in LARK_APP_ID and store the App Secret under the Harness credential reference LARK_APP_SECRET.

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

← 上一个 Prev openspec-agents 下一个 Next dsh-plugin-memory →