本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-lark

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @sugarforever/dsh-lark

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 支持飞书中国版和国际版 Lark。
• 使用 WebSocket 长连接接收事件，无需公网回调地址。
• 单聊和普通群聊按聊天复用 Harness Session。
• 话题群按线程使用独立 Harness Session。
• 回复会关联原始消息，并保留在原来的话题线程中。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后需要立即配置 App ID 和 App Secret 吗？

不需要。插件会保持启用但不会建立连接，直到在 Settings 页面或通过环境变量提供凭据。

App Secret 会被写进配置文件或返回到浏览器吗？

不会。Secret 只允许保存到 Harness Credentials 文件、启动环境变量或外部 Secret Manager，Settings 页面只显示已配置/未配置状态。

为什么我必须用 WebSocket 而不是 Webhook？

插件依赖官方 SDK 的 WebSocket 长连接，本地电脑和内网环境无需公网入口或回调地址，直接配置"使用长连接接收事件"即可。

一个飞书应用能同时跑多个插件实例吗？

不建议。平台可能在多个长连接之间分发事件，导致单实例只能收到部分消息，应保持一个应用一个连接。

同一个飞书聊天里的多条消息会怎么处理？

官方 SDK 会按聊天串行处理，避免两个 Agent 轮次同时修改同一会话；后续消息会复用同一个 Harness Session 以保留上下文。

升级 Harness 后还需要升级插件吗？

兼容范围从 0.1.0-rc.6 开始，CI 持续验证最新 Harness 版本，因此升级到后续 RC 通常不需要重新发布插件。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则