🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

飞书 IM 通道 drliuhuan/dsh-plugin-feishu-im

DeepSeek Harnessv1.16.0
drliuhuan10 天前有提交已提供中文文档扫描:含敏感能力

扫码接入飞书机器人,在飞书里收发任务与审批

34.6/100
综合分
0
GitHub 星标
1,474
npm 周下载
—/5
用户评分

数据截至 2026/10/28 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add dsh-plugin-feishu-im
npm 源 · dsh-plugin-feishu-im 的发布者账号已校验与本仓库一致

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:已验证
是什么
dsh 原生插件 · platform
装得上吗
本站已在 dsh 0.2.1-rc.2 下真实安装成功
非静态推断
L5 · 运行时冒烟等级说明 →
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
活跃:最近一次提交在 10 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查✓ 自动检查通过
展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-plugin-feishu-im @ 1.16.0
✓Node 引擎要求 >=22 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/28 08:36:51

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描:含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件发起外部网络请求
查看扫描证据(共 37 处,展示前 35 条)
  • 读取本地文件
    index.js:88
    const raw = await readFile(new URL('./package.json', import.meta.url), 'utf8')
  • 读取本地文件
    index.js:173
    if (!TRACE_ENABLED && !existsSync(traceFlagPath())) return
  • 写入本地文件
    index.js:176
    mkdirSync(join(home, 'feishu-im'), { recursive: true })
  • 写入本地文件
    index.js:177
    appendFileSync(
  • 发起网络请求
    index.js:461
    return json(await restart.request({ sessionId: body.sessionId, reason: '设置页重启' }))
  • 读取本地文件
    index.js:599
    const raw = await readFile(restartMarker, 'utf8')
  • 删除本地文件
    index.js:600
    await rm(restartMarker, { force: true })
  • 发起网络请求
    client.js:92
    var response = await fetch(API + path, init);
  • 发起网络请求
    lib/feishu.js:66
    const response = await fetch(`${base}${REGISTRATION_PATH}`, {
  • 发起网络请求
    lib/feishu.js:161
    const response = await fetch(`${openBase(domain)}/open-apis/auth/v3/tenant_access_token/internal`, {
  • 发起网络请求
    lib/feishu.js:186
    const response = await fetch(`${openBase(domain)}/open-apis/bot/v3/info`, {
  • 发起网络请求
    lib/feishu.js:200
    const response = await fetch(
  • 发起网络请求
    lib/feishu.js:240
    const response = await fetch(
  • 发起网络请求
    lib/feishu.js:263
    const response = await fetch(
  • 写入本地文件
    lib/inbound.js:242
    await mkdir(cwd, { recursive: true })
  • 发起网络请求
    lib/inbound.js:418
    const result = await restart.request({ sessionId, reason: '来自飞书 /restart' })
  • 执行外部命令固定命令
    lib/restart.js:53
    const child = spawn('/bin/sh', ['-c', `sleep ${Math.round(delayMs / 1000)}; exec ${command}`], {
  • 写入本地文件
    lib/restart.js:103
    await mkdir(dirname(markerPath), { recursive: true })
  • 写入本地文件
    lib/restart.js:104
    await writeFile(markerPath, JSON.stringify({ requestedAt: Date.now(), reason }))
  • 读取本地文件
    lib/service.js:103
    const cgroup = readFileSync('/proc/self/cgroup', 'utf8').trim()
  • 读取本地文件
    lib/service.js:175
    const file = await readFile(LAUNCHD_PATH, 'utf8').catch(() => '')
  • 读取本地文件
    lib/service.js:210
    readFile(UNIT_PATH, 'utf8').catch(() => ''),
  • 写入本地文件
    lib/service.js:264
    await mkdir(dirname(LAUNCHD_PATH), { recursive: true })
  • 写入本地文件
    lib/service.js:265
    await writeFile(LAUNCHD_PATH, plist, { mode: 0o644 })
  • 写入本地文件
    lib/service.js:276
    await mkdir(dirname(UNIT_PATH), { recursive: true })
  • 写入本地文件
    lib/service.js:277
    await writeFile(UNIT_PATH, text, { mode: 0o644 })
  • 删除本地文件
    lib/service.js:297
    await rm(LAUNCHD_PATH, { force: true })
  • 删除本地文件
    lib/service.js:301
    await rm(UNIT_PATH, { force: true })
  • 读取本地文件
    lib/state.js:101
    return normalize(JSON.parse(await readFile(stateFile(), 'utf8')))
  • 写入本地文件
    lib/state.js:110
    await mkdir(stateDir(), { recursive: true, mode: 0o700 })
  • 写入本地文件
    lib/state.js:113
    await writeFile(temporary, JSON.stringify({ ...state, updatedAt: Date.now() }, null, 2), { mode: 0o600 })
  • 写入本地文件
    lib/state.js:114
    await chmod(temporary, 0o600).catch(() => {})
  • 写入本地文件
    lib/state.js:115
    await rename(temporary, target)
  • 写入本地文件
    lib/state.js:116
    await chmod(target, 0o600).catch(() => {})
  • 删除本地文件
    lib/state.js:122
    await rm(stateFile(), { force: true })
扫描于 2026/11/2(1 天前) · 范围 入口闭包 + 全包扫描 · 来源 npm 发布包

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

DeepSeek Harness 的飞书 IM 插件:扫码创建专属飞书应用,任务完成/审批/提问推送到飞书,并可在飞书里指挥 DSH。

README

由 DeepSeek 最新模型翻译生成
dsh-plugin-feishu-im DeepSeek Harness 的飞书 IM 通道:在 DSH Web 的「设置 → 飞书 IM」里扫码创建专属飞书机器人,把任务进展、审批请求、提问推到飞书,并在飞书里直接指挥 DSH。 飞书 IM 设置页 它能做什么 | 能力 | 行为 | | 连接 | 扫码创建专属飞书应用(自动带上收发消息权限),或手动填 App ID / App Secret | | 任务通知 | 任何会话一轮结束时推一张卡片:结论 + 用时,失败时带原因 | | 审批 | 工具需要授权时推卡片,「允许一次 / 拒绝」,点完 DSH 继续跑 | | 提问 | ask_user_question 的选项变成按钮;也能点「输入你的答案」用文字回答 | | 进度 | 收到消息后在你那条消息上打 Typing 反应,处理完撤掉,失败换 CrossMark | | 指挥 | 在飞书里发消息 → 进 DSH 会话执行 → 结果回传到同一个对话 | | 插话 | 任务还在跑时再发消息,默认作为插话引导并入当前这一轮(不排队),会回一条提示;用 /queue 改为排队 | | 会话 | /sessions 列会话、点编号切换,或 /resume <编号|id|标题> |
展开完整文档(README 剩余 1 节)
dsh-plugin-feishu-im

DeepSeek Harness 的飞书 IM 通道:在 DSH Web 的「设置 → 飞书 IM」里扫码创建专属飞书机器人,把任务进展、审批请求、提问推到飞书,并在飞书里直接指挥 DSH。

飞书 IM 设置页

它能做什么

| 能力 | 行为 |
| 连接 | 扫码创建专属飞书应用(自动带上收发消息权限),或手动填 App ID / App Secret |
| 任务通知 | 任何会话一轮结束时推一张卡片:结论 + 用时,失败时带原因 |
| 审批 | 工具需要授权时推卡片,「允许一次 / 拒绝」,点完 DSH 继续跑 |
| 提问 | ask_user_question 的选项变成按钮;也能点「输入你的答案」用文字回答 |
| 进度 | 收到消息后在你那条消息上打 Typing 反应,处理完撤掉,失败换 CrossMark |
| 指挥 | 在飞书里发消息 → 进 DSH 会话执行 → 结果回传到同一个对话 |
| 插话 | 任务还在跑时再发消息,默认作为插话引导并入当前这一轮(不排队),会回一条提示;用 /queue 改为排队 |
| 会话 | /sessions 列会话、点编号切换,或 /resume <编号|id|标题> |
| 权限 | 每个飞书对话可选四种模式:只读 / 工作区读写 / Auto Review / 完全权限 |
| 会话位置 | 新对话建在可配置的文件夹(默认 ~/dsh-plugin-feishu-im),工作区名默认「飞书IM」,都在设置里改 |
| 渲染 | 消息以 卡片 JSON 2.0 发送:标题、引用、代码块都能渲染;表格用原生 table 元素(表头纯色、行高紧凑),超长按段分页不截断 |

安装

从 npm 安装(推荐) plugin_manager install_bundle dsh-plugin-feishu-im

或者
npm i -g dsh-plugin-feishu-im

装好后进入 设置 → 飞书 IM。

做成服务(不需要 sudo)

设置页「部署方式」可以把 DSH 装成用户级 systemd 服务(~/.config/systemd/user/dsh.service,Restart=always),全程不需要 sudo —— 这对只能通过网页 / 飞书操作、没有终端可以输入密码的部署尤其重要。

- 设置页会先检测当前是否已经是服务模式(系统级 / 用户级),已托管时按钮禁用并显示是哪一种;
- Windows 下该选项直接禁用,并提示「当前仅支持 Linux(用户级 systemd)与 macOS(launchd)」;
- 未托管时会提示风险:进程退出或重启机器后不会自动拉起、关闭终端或注销会中断;
- 已经由系统级 dsh.service 托管时,插件会拒绝安装用户级服务,避免两个进程抢 3080;
- 「注销后仍运行」需要 root 一次性执行 loginctl enable-linger $USER(本机已开启);
- 装好后的重启走 systemctl --user restart dsh.service,scripts/restart-dsh.py 会自动优先用它,并仍按「忙碌检测 → 飞书预告 → 重启 → 新进程发完成通知」的流程执行。

连接飞书

扫码创建(推荐)

1. 点「生成连接二维码」,用飞书手机端扫码;
2. 按提示确认创建;
3. 页面自动拿到凭据、写入本机并校验机器人身份。

飞书这一侧用开放平台的设备码注册流程(accounts.feishu.cn/oauth/v1/app/registration, archetype=PersonalAgent),创建出来的应用已带消息权限,不需要手动勾选。这条接口不在飞书公开文档里,可能随平台演进;失败时界面会退回到手动填写。

手动填写

已有应用时直接填 App ID / App Secret,但需要自己配置:

- 开启「机器人」能力
- 权限:im:message、im:message:send_as_bot、im:resource、im:chat
- 事件:im.message.receive_v1(长连接)
- 回调:card.action.trigger(回调配置页,不是事件配置页;同样用长连接)
- 发布一个应用版本(权限与回调不发布会不生效,点按钮会报 200340)

指挥与询问策略

指挥与安全

审批与提问默认只走飞书:宿主不把同一条请求转给网页,所以在飞书答完就是最终结果,不会留下一个还在等你的网页提示。
打开「网页与飞书同时询问」会恢复并行:两边都弹,谁先回答用谁(飞书先答时,网页那条要等本轮结束才消失)。

飞书等待上限:1–120 分钟,或「永不超时」。超时后卡片失效(原地改写为「⏱ 已超时」),请求转回 DSH 网页。
这段时间里 DSH 网页不会弹原生的选择窗口——独占模式下请求只存在于飞书。

卡片状态

所有卡片终态都是原地改写,选项按钮不再保留:

已作答 / 已超时

| 触发 | 标题 | 内容 |
| 点选项 | ✅ 已作答 | 问题:答案 |
| 输入文字 | ✅ 已作答 | 问题:答案(输入) |
| 进入输入 | ⌨️ 等待你输入答案 | 原问题 + 选项文字 + (等待输入) |
| 超时 | ⏱ 已超时 | 问题:(未作答) + 已转回 DSH 网页 |
| 授权 | ✅ 已允许 / ❌ 已拒绝 | 工具、原因、结果 |

改过消息路由的卡片会在底部标明当前路由,例如「消息路由:已切回原来的会话,接下来的消息会照常发给 DSH。」

提问卡片

提问卡片

点选项直接作答,或点「✏️ 输入你的答案」后在下一条消息里写答案。

点选项作答

授权卡片

需要授权

任务完成

任务完成卡片

会话列表与切换

会话列表

/sessions [关键字](别名 /history)发一张卡片:最多 10 个按钮,按钮上直接是会话标题 · 最后互动时间(如「修 CI · 2 小时前」),点按钮即切换;正文不再重复标题,只提示可以用 /sessions <关键字> 检索。也可以 /resume <编号|id|标题>。
切换后就地改写那张卡,只保留目标会话标题。列表会过滤子代理会话,并标出当前会话(←当前)。

| 命令 | 作用 |
| /sessions [关键字]、/history | 列会话并切换 |
| /resume <编号\|id\|标题> | 切换当前会话 |
| /current | 看当前绑定 |
| /new | 开一个新会话 |
| /queue <内容> | 排队处理,不插话 |
| /permission、/mode | 查看并切换本对话的权限模式(也可 /permission readonly) |
| /restart | 重启 DSH(有任务在跑时拒绝并说明) |
| /stop | 让当前会话停下 |
| /id | 当前会话 id |
| /help | 命令说明 |

模型也能用:内置工具 feishu_sessions(list / current / switch),在飞书发起的会话里可以直接说「切到第 3 个会话」。

会话建在哪

设置里的「飞书会话的位置」控制两件事:

- 工作文件夹:默认 ~/dsh-plugin-feishu-im,不存在会自动创建;
- 工作区名称:默认「飞书IM」,工作区列表里按这个名字分组;改名后下一次新建飞书对话时同步到已有工作区。

已经在用的对话不受影响;想搬到新目录,发 /new 开一个即可。

会话权限

每个飞书对话独立保存一个权限模式,切换后立即作用于它绑定的会话:

| 模式 | 沙箱 | 审批 | 说明 |
| 只读 | read-only | 询问 | 只能读;越界操作会来问你 |
| 工作区读写 | workspace-write | 询问 | 工作区内可读写;越界要你确认 |
| Auto Review | 由 Auto Review 决定 | 裁决 | 优先使用宿主的 dsh-experimental-auto-review:每个工具调用前用当前模型评估风险,放行=完全权限执行,拒绝=改成问你;没有装这个插件时才退回"只读 + 插件按文本判断"的兜底 |
| 完全权限 | danger-full-access | 不再询问 | 不做沙箱限制,也不再打扰你 |

切换是两步:/permission(或 LLM 通过 feishu_permission 工具申请)先发一张带四种模式的卡片;点其中一种后再弹确认卡片(显示「从 X → 到 Y」),点「确认修改」才真正生效,点「取消」则什么都不变。
超时未确认会原地改成「⏱ 已超时」,权限保持原样。

实现上:沙箱模式是会话级的 sandbox/mode 事件,审批策略用 approval.setPolicy,auto 模式交给宿主的 Auto Review(dsh-experimental-auto-review)逐次评估。设置页可以改新会话的默认模式,单聊用 /permission 覆盖。

安全模型

- App Secret 只存在 <DSH_HOME>/feishu-im/state.json,权限 0600,不回传浏览器、不写进 cordis.patch.yml;
- 设置页的接口是 DSH 的 exact Fetch 路由(/api/feishu-im/),只有本机已认证的 owner 浏览器能访问;
- 飞书侧按 open_id 允许列表过滤,扫码授权的人自动进入列表;列表为空时接受第一个来消息的人并设为唯一使用者;
- 关闭「允许在飞书里指挥 DSH」后,飞书只收通知,不接指令;
- 危险操作仍走 DSH 的审批策略;卡片只是把同一次请求搬到手机上回答;
- 同一个飞书应用不要在别处同时开长连接(飞书会把事件随机投给其中一条)。

排障

打开宿主追踪(默认关闭,也可 touch <DSH_HOME>/feishu-im/trace.on 运行时打开):

DSH_FEISHU_IM_TRACE=1 dsh web

日志在 <DSH_HOME>/feishu-im/host-probe.log:路由注册、长连接起停、turn 事件、通知发送、卡片点击。

| 症状 | 多半原因 |
| 设置页报 HTTP 404 | 插件没激活,或 /api/feishu-im/ 路由没注册 |
| 长连接 gateway-failed | App Secret 不对,或应用没发布版本 |
| 点按钮报 200340 | card.action.trigger 没配成回调 + 长连接,或没发布版本 |
| 没有 Typing 徽标 | 应用缺消息 reaction 写权限,不影响收发 |
| 名字是「未命名会话」 | 该会话还没生成标题,发一条消息后会补上 |
| 表格只显示 10 行 | 原生 table 元素按页展示(page_size: 10),其余由客户端翻页 |

开发

测试会写 fixture 状态。sessions-smoke / answers-smoke 在未设置 DSH_HOME 时会自己指到临时目录——不会碰你 ~/.dsh/feishu-im/state.json 里的真实凭据。手动跑其它会写状态的脚本时,请依然带上 DSH_HOME=$(mktemp -d)。

npm test # tool-schema + inbound + answers + sessions + service + render
npm run test:render # 真 React 渲染每个页面状态(需要 react/react-dom)
npm run test:live # 真连飞书,回读卡片内容并断言三种终态
npm run test:timeout # 真连飞书,走一遍超时转回

发布走 .github/workflows/release.yml:trusted publisher(OIDC) 自动发布并生成 provenance,不使用 NPM_TOKEN。
push 一个 v* tag 即可。

License

MIT
预览分享卡片长什么样 ↓drliuhuan/dsh-plugin-feishu-im
分享 · DeepSeek Harness Hub
drliuhuan/dsh-plugin-feishu-im

扫码接入飞书机器人,在飞书里收发任务与审批

这是你的仓库?认领条目

回到顶部