PlutoKeating/dsh-lark-bot
dsh-lark-bot
dsh-lark-bot is a community DeepSeek Harness plugin. Read the repository README before installing.
Install
npx @deepseek-ai/dsh plugin --profile web add github:PlutoKeating/dsh-lark-botRestart `dsh web` after install. Bundle APIs can change during the developer preview.
README badge
[](https://dshhub.dev/plugins/dsh-lark-bot)Paste this into your README. The star count updates with every catalog sync.
From the README
Excerpt from PlutoKeating/dsh-lark-bot, cleaned of badges and images.
<strong>把 DeepSeek Harness 装进飞书</strong> · 扫码 30 秒 · 手机指挥本机 coding agent · 崩溃了飞书也照样回你
产品简介
让 DeepSeek Harness 成为你飞书里的一员,在手机、群聊、话题里直接指挥本机 coding agent。 走飞书 WebSocket 长连接,不需要公网 IP、域名、服务器或内网穿透;Linux / macOS / Windows 通用,Node.js ≥ 22。
快速开始
前置:本机已安装 DeepSeek Harness(dsh)并配置好 DEEPSEEK_API_KEY;Node.js ≥ 22.19;一个飞书 / Lark 账号。
npx dsh-lark-bot@latest setup --profile dsh-lark # ① 一键安装(装进 dsh profile + 默认装「安全网守护」)
dsh --profile dsh-lark # ② 启动
③ 首次启动终端打印二维码 → 飞书 App 扫码创建或选择 PersonalAgent 应用 → 绑定后直接私聊发消息;群聊 / 话题默认 @bot。
- 已有应用可跳过扫码:
DSH_LARK_APP_ID=cli_xxx DSH_LARK_APP_SECRET=<secret> DSH_LARK_TENANT=feishu dsh --profile dsh-lark。 - 升级:
npx dsh-lark-bot@latest upgrade --profile dsh-lark --yes。
不用碰命令行:管理员直接在飞书发
/upgrade即可。
核心能力
全网独家
- 安全网守护:dsh 崩溃后飞书仍会回复你,
/safemode进入仅核心安全模式直接自愈;重启后自动恢复排队任务,/jobs可显式重试。多数桥接方案是「串行单聊 + 崩溃就失联」。 - 多机器人可信交接:
bot add增加独立实例,可信机器人在同群真实 @ 交接,连续协作有上限。 - 完善的工作区与会话管理:每会话自动创建隔离 git worktree 项目工作区;
/session浏览 / 绑定会话,/archive+/retention自动归档与清理,会话列表不会烂掉。 - 完善的版本管理机制:管理员直接在飞书发
/upgrade后台更新、验证并重载;有新版本才提醒,不打断当前工作。 - dsh Web 可视化设置:官方 Settings → Plugins 页面点选工作目录、模型、并行数、提醒,不用背环境变量。
其他核心能力
- 并行多任务:同一群聊同时跑多个任务、会话隔离。
- 多角色 Agent:
/role切换或指派 PM / 开发 / 文档等角色,各带人设、模型偏好与规则。 - 对话内管理模型与密钥:一张
/config卡片切换供应商、热更新密钥,不用离开飞书。 - 快速 / 平衡 / 深度模式:
/mode一键选任务强度,下一轮生效且不打断当前任务。 - 关键任务先拍板:
lark_request_plan_approval先出完整计划,再批准或附意见继续规划。 - 跨会话通知 + @人:A 群跑完任务主动推送到 B 群 / 私聊并 @ 你。
- 通知转发到常用 IM(纯通知):把完成 / 失败 / 审批与突发 / 故障通知,经
/channels配置后单向推送到 Telegram / 企业微信群机器人等;只推送、无入站交互,飞书仍是唯一完整交互平台,未配置时行为不变。/channels add --qr <wechat|qq|telegram>让用户在飞书会话里收到二维码图片,用对应 IM 扫码即创建并绑定通知渠道。
流式过程卡以飞书原生折叠面板实时展示阶段、耗时与工具状态。
命令速览
命令帮助、状态与卡片均中英文;/help 为全量权威清单,全部命令见 docs/MANUAL.md。
| 命令 | 作用 |
|---|---|
/config | 模型 / Provider / 凭据管理卡片(/model、/provider(s)、/key 为同一张卡的别名) |
/new /reset | 开始新会话 |
/status | 查看状态卡(工作区 / 模型 / session / run / token / 任务账本) |
/mode(/effort) | 选择快速 / 平衡 / 深度任务强度 |
/cd <path> | 切到该目录的独立会话 |
/ws list|save|use|remove | 管理命名工作空间 |
/jobs [list|show|retry] | 对账并重试排队/运行/失败/中断任务 |
/session、/session bind | 浏览 / 显式绑定 DSH session |
/role list|show|set|clear | 查看 / 绑定角色 |
/notify <scope|chatId> <text> | 跨会话发送通知(管理员) |
/notifications [show|off|on …] | 配置完成 / 失败 / 审批提醒(sinks= 转发到其他 IM 渠道) |
/channels [list|show|add|accept|remove|enable|disable …] | 管理出站通知渠道(管理员);add --qr <wechat|qq|telegram> 扫码即建 |
/stop | 终止当前任务 |
/upgrade | 自更新(管理员) |
/doctor | 生成脱敏诊断包(管理员) |
/help | 查看命令清单 |
⚠️ 仅认准官方渠道:唯一官方仓库 PlutoKeating/dsh-lark-bot, 唯一官方 npm 包
dsh-lark-bot/dsh-feishu-bot(维护者plutokeating)。本项目从不提供 .exe 或 “下载即运行”的安装包,任何以此名义分发的页面 / 仓库均为假冒 / 恶意来源。官方安装唯一命令:npx dsh-lark-bot@latest setup --profile dsh-lark。详见文末「安全提醒」。
常见问题
Q: DeepSeek Harness 怎么接入飞书?
A: 装好 Node ≥ 22 与 dsh(已配 DEEPSEEK_API_KEY)后,执行 npx dsh-lark-bot@latest setup --profile dsh-lark,再 dsh --profile dsh-lark 扫码绑定即可;私聊直接发消息,群聊 / 话题默认 @bot。
…
