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

快速上手

dsh-lark-link

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-lark-link

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

— 源: plugins.install

关键要点

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

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

怎么把 DSH 装进飞书?

安装插件后在 DSH Web GUI 的输入框运行 /lark setup，面板会显示二维码，手机飞书扫码确认即可完成飞书应用创建；再用 /lark start 启动桥接，在飞书找到机器人发消息就能对话。

必须用扫码注册飞书应用吗？能不能手动填 appId?

可以。设置环境变量 DSH_LARK_APP_ID 和 DSH_LARK_APP_SECRET（可选 DSH_LARK_DOMAIN=lark 切到国际版），再运行 /lark setup，凭据会直接写入 DSH credentials 服务，不走 QR 流程。

群聊里要不要 @ 机器人?

默认 groupPolicy=open（免 @ 全触发），群聊里直接说话就行。如果想收紧，改成 mention（仅 @ 触发）、keywords（包含关键词触发）或 reply（仅回复机器人时触发），用 /lark-config groupPolicy=mention 热改。

消息会不会丢？插件崩溃后已发的请求会怎么样?

出站消息走持久 Outbox（JSONL 落盘、at-least-once、幂等键），进程被杀/重启会自动续投；入站请求在到达 Agent 之前先写入 Inbound WAL，如果插件在 Agent 处理中途崩溃，重启后这条用户消息会被自动重新触发，不静默丢弃。

飞书里发的图片和文件 Agent 看得到吗?

图片会下载到本地、生成视觉模型的 ImageBlock 引用，发给多模态模型识别；非视觉模型会自动改走「图片已保存到本地路径」的纯文本路径，Agent 可用工具读取。文件做有界文本提取后并入提示词。

怎么卸载？会把凭据清掉吗?

运行 /lark uninstall-clean 会停止桥接、清除 DSH credentials 里的 appId/appSecret，并删除状态目录（配置、路由、Outbox、Inbound WAL 等）。再用 /lark setup 即可重新配置。删除插件包则只是从 DSH 移除，状态保留。

报错了怎么排查?

在飞书给机器人发 /doctor，会回传一个 ZIP 诊断包（当前会话的 DSH session log + 脱敏配置 + ISSUE.md 模板），贴给任意 AI 即可定位；/status 实时显示连接状态、Outbox 待发/失败条数、Inbound WAL 待补发数。

— 源: plugin_wiki.faq_json

兼容性

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

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则