amlyczz/dsh-lark-link 预览 preview

amlyczz/dsh-lark-link

DeepSeek Harness 的高可靠性飞书/ Lark 桥接组件 — 二维码一键认证、多模式代理、卡片命令、零丢失发件箱、媒体收发、会话日志诊断工具、可复用的 DSH Web GUI

Project Overview项目介绍

dsh-lark-link is a native plugin built exclusively for DeepSeek Harness (DSH), that creates a bidirectional bridge between a locally running DSH agent and Feishu/Lark. It lets users deploy their existing DSH agent to Feishu, so they can chat with the agent, assign tasks, and check results from anywhere using the Feishu mobile or desktop app. The entire setup process takes 30 seconds via QR code, no manual configuration on the Feishu Open Platform or public server is required. It also implements dual persistence for messages, so no data is lost if DSH restarts or crashes.

This plugin is built for existing DSH users who want reliable mobile access to their local agent. After installation via DSH's built-in plugin manager, users just run the /lark setup command in the DSH terminal and scan a QR code to automatically create the Feishu app and configure all required permissions. Once live, users can access all of DSH's native features directly from Feishu, whether in one-on-one chats or group conversations. This includes all core DSH features like running bash commands, processing local files, and launching full autonomous workflows.

The plugin requires Node.js version 24 or higher to run, and it supports installation from the official npm registry, a local tarball, or directly from GitHub source via DSH's built-in plugin management system. After installation completes, a full restart of DSH is required for the plugin to activate. It is released under the open-source MIT license, and is maintained by the community, not officially affiliated with DeepSeek or Feishu. If users run into connectivity or functionality issues, they can run the /doctor command in Feishu to generate a zipped diagnostic package for troubleshooting.

dsh-lark-link是专为DeepSeek Harness(DSH)开发的原生插件,实现DSH智能体与飞书/Lark的双向桥接。它可以让用户把本地运行的DSH智能体部署到飞书,随时随地通过飞书和智能体对话、派发任务、查看结果。全程扫码30秒即可上线,不需要手动配置飞书开放平台,也不需要自备公网服务器,还能保证消息零丢失。

它面向已经本地部署DSH、想要获得移动端随时访问智能体能力的用户。安装完成后,只需要在DSH终端执行/lark setup命令扫码,就能自动完成飞书应用创建和权限订阅配置。上线后,用户可以在飞书单聊或群聊中调用DSH的全部原生能力,包括执行bash命令、处理文件、运行自主工作流,和本地终端的使用体验一致。

该插件要求Node.js版本不低于24,通过DSH官方的插件管理机制安装,支持从npm官方源、本地压缩包或者GitHub源码安装,安装完成后重启DSH即可生效。项目采用MIT开源许可证,是社区维护的第三方插件,和DeepSeek、飞书官方没有隶属关系。插件内置/doctor诊断命令,可生成带日志的压缩包方便排查问题。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 40 stars - an early-stage project星标 40,属于早期项目
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 dsh-lark-link@latest --ignore-scripts

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

READMEREADME

dsh-lark-link mascot

🪶 dsh-lark-link

DeepSeek Harness × 飞书/Lark 双向桥接 — 把你的 DSH 智能体装进飞书,扫码 30 秒上线,随时随地对话

npm CI beta MIT node


中文

DeepSeek Harness × 飞书/Lark 双向桥接插件 —— 把你的 DSH 智能体装进飞书:扫码 30 秒上线、消息零丢失、卡片化交互、每飞书会话独立 Agent。手机上随时给 Agent 派任务、看结果、切模型切模式——不用守着终端。

🌟 为什么选 dsh-lark-link

  • 零门槛:扫码即建飞书应用,不用手搓开放平台、不用配回调、不用公网服务器
  • 零丢失:出站 Outbox + 入站 WAL 双持久化,进程崩溃 / 插件热更 / dsh 重启,消息和回答都补得回来
  • 零学习成本:所有切换类命令都是单选卡片,点一下即生效;DSH 原生命令(/goal /compact …)直接用
  • 真 Agent:不是聊天机器人——bash/文件/子代理/工作流全套工具,飞书里跑完整 Harness

✨ 特性

能力 说明
🎯 一键认证 /lark setup 扫码创建飞书应用(自动订阅消息事件 + 群聊全量 + 表情权限 + 用户基本信息),30 秒上线,无需手搓开放平台;也支持 DSH_LARK_APP_ID/SECRET 手动通道
🧠 多模式 Agent 标准 / PTC / 极简 / Cordis preset + 你在 GUI 自建的 preset,飞书发 /mode 出单选卡片即切(默认 PTC:一次执行多步工具调用,更快更省)
🎛 权限分级 只读 / 工作区写 / Full access 三种权限,/permission 卡片即切;默认 Full access 全放行
🎨 卡片化命令 /mode /permission /model 全部是单选按钮卡片——点一下即切换,不用记命令拼写;模型选择按供应商分组展示
💬 意图确认转发 模型提问(ask_user_question)→ 飞书意图确认卡片(选项按钮 + 下拉多选 + 自定义输入),答完模型继续,飞书里完成完整交互闭环
😊 表情回执 收到消息随机表情"已收到";回复完成 / 命令完成打 DONE ✅(只使用飞书实测有效 emoji)
💪 出站零丢失 持久 Outbox(JSONL + at-least-once + 幂等键 + 分航道并行 + 失败离队不阻塞 + 周期清理),kill 重启自动续投;桥命令回复同样走 Outbox
🆕 入站请求补发 Agent 处理到一半插件/dsh 崩溃/重启,重启后自动重新触发这条用户消息(不再静默丢请求)——Inbound WAL 持久化 + 启动对账 + 次数上限/时间窗防空转;/status 显示待补发条数
🛡 连接自愈 probe 驱动受控重连 + QuotaGovernor 配额熔断(窗口过期自动解除、自动重连)+ 断连补偿;环境代理自动规避
🔀 命令三级分流 桥特有命令桥处理;DSH 注册命令原生执行;/goal、未知 /xxx、普通消息原样注入 Agent(无拦截无门禁);skill 无前缀——直接描述任务,模型自动加载
📎 入站多媒体 飞书图片 → 视觉模型看图(attachment 存储);文件 → 有界文本提取进提示词
📤 出站多媒体 模型经 lark_send_local_file 主动回传本地图片/文件(工作区白名单 + 大小校验 + 格式自动降级)
🩺 一键诊断 /doctor → ZIP 诊断包(含当前会话完整 DSH session log + 脱敏配置 + ISSUE.md),发回飞书,贴给 AI 即可定位
✍️ Markdown 渲染 回复自动检测 markdown → CardKit 卡片渲染(标题/列表/代码块/表格),纯文本走文本消息
🌊 可选流式输出 /lark-config streaming.enabled=true 热开 CardKit schema 2.0 流式卡片,逐字打印(默认关,省流量)
🆕 长任务目标驱动 /goal <目标> 直接在飞书启动自主长任务闭环;支持 /goal pause(暂停)、/goal resume(继续)、/goal clear(清除);纯文本自然对话交互,告别冗余看板干扰
🆕 会话管理与恢复 /new 当前工作区新起会话;/resume 极简卡片恢复历史会话(点选/序号/id 前缀,自动提取会话真实标题,彻底解决跨重启 live session 冲突);/workspace <路径> 切换工作区;按会话完全独立持久化工作区/模型/模式
🖥 复用 DSH Web GUI 桥 Agent = 原生 DSH session,聊天/流式/工具卡/设置全由 GUI 呈现;会话自动归入对应工作区(不再"未分组");Web 面板实时显示 Outbox/补发计数
👥 访问控制 allowlist 限定可对话的 open_id 白名单;groupPolicy 群聊触发策略(open / mention / keywords / reply);denyList 命令前缀拒绝兜底
🔓 默认 Full access 沙箱全访问 + 审批 never,零打扰

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

← 上一个 Prev cnki-mcp 下一个 Next deepseek-harness-model-config →