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

快速上手

dsh-lark-bot

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-lark-bot

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

— 源: plugins.install

关键要点

• 私聊、群聊、话题（thread）里指挥本机 dsh coding agent，图片 / 文本文件直接发给 bot 即可；
• 流式过程卡以飞书原生折叠面板实时展示思考、工具调用与结果，完成后最终回答单独发送，支持交互按钮（停止 / 计划门禁 / 审批 / 问答卡）；
• Git 仓库内为每个会话自动创建隔离 worktree 项目工作区，多项目互不干扰。
• 🆘 Guardian 安全网守护——“永远叫得应”：DSH 崩溃后飞书仍会回复你，/safemode 进入仅核心安全模式直接重启。
• 👥 多角色 Agent——“一个机器人，一整个团队”：/role 切换或指派 PM / 开发 / 文档等角色，每个角色独立人设、模型偏好与规则。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后怎么开始使用？

先确保本机已装好 DeepSeek Harness 并配置 DEEPSEEK_API_KEY，运行 dsh --profile <profile名> 启动；首次启动终端会打印二维码，飞书/Lark App 扫码创建或选择 PersonalAgent 应用即可绑定。私聊直接发消息，群聊/话题默认需要 @bot。

需要公网 IP、域名或服务器吗？

不需要。飞书通道使用 WebSocket 出站长连接，本机在 NAT 后也能用，免公网服务器、免域名、免内网穿透。

dsh 进程崩溃或掉线后飞书 bot 还能用吗？

可以。默认安装的安全网守护（guardian）独立于 dsh 常驻，dsh 掉线时自动接管飞书通道；发 /safemode 进入仅核心安全模式可远程定位/修复问题、禁用损坏插件，再 /safemode exit 交还通道。

多个项目/多人协作怎么隔离？

每个会话自动落在独立 git worktree；群聊隔离可通过 /isolation 在整群共享/话题独立/成员独立之间切换；管理员可用 /role 定义 PM/开发/文档等多角色并绑定到不同 scope；多机器人实例用 dsh-lark-bot bot add 创建独立身份与凭据。

卸载会影响本地数据吗？

仅运行 dsh plugin --profile <profile名> remove dsh-lark-bot 不会删除本地数据。配置、会话、归档、角色、凭据默认保留在 ~/.dsh-lark；如需彻底清除请手动备份后删除该目录。

报 ERR_PNPM_IGNORED_BUILDS 怎么办？

按官方指引在 profile 的 pnpm-workspace.yaml 中加 allowBuilds: { protobufjs: true } 后重试即可。setup 命令会自动预批准这些构建策略（仅在手动 dsh plugin add 时才会触发该报错）。

agent 长连接掉了会怎样？

SDK 适配器会自动重连并在恢复后向最近活跃会话发送恢复提示。机器睡眠或断网期间 WebSocket 无法收消息，恢复连接后会触发提示，不需要人工重启。

ACP / SDK / web / headless 这些 adapter 有什么区别？

sdk（默认）走官方 dh-sdk-client，支持原生 session 续跑与 token 级流式；acp 走官方 ACP server，审批体验更接近协议原生；web 驱动本地 dsh web agent 由网页端作为唯一写者；headless 是兼容旧版的子进程 fallback。新部署建议保持 sdk 或 acp。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.8
• Node: >=22.19.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则