前言¶
DeepSeek Harness（DSH）的 Web GUI 适合在电脑上长时间跑智能体会话，但任务里的审批、提问和进度往往绑在浏览器窗口上。人离开工位或只有手机在手时，常见做法是另开隧道、远程桌面，或干脆等回到电脑前再处理——会话本身可能还在跑，交互却断了。
下面介绍社区插件 dsh-feishu-pilot（维护者 pxvp2008，分类：客户端）。它把飞书私聊/群聊里的机器人当成 DSH 的远程控制台：桌面里任意 GUI 会话的任务通知、审批、提问可以推到飞书；GUI 与飞书双端可同时受理；扫码即可接入，无需公网 IP 暴露 DSH。插件当前版本 1.0.1，许可证 MIT。
这是什么¶
dsh-feishu-pilot 在已运行的 DSH 与飞书企业自建应用机器人之间建立长连接渠道，把飞书侧的消息、卡片回调与 DSH 会话运行时对齐。
社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系；安装前建议自行查看源码与许可证。插件在 当前 DSH 宿主进程权限 下运行，凭据与运行数据保存在本机插件目录。
核心功能¶
以下能力均来自项目 README，可按需选用。
远程会话与双端受理¶
- 任意会话可远程：不限于飞书创建的会话；桌面 GUI 里已有会话的任务通知、审批、提问均可推到飞书。
- 审批/提问双端竞速：GUI 与飞书同时展示待办，任一端先处理即生效，另一端卡片自动失效并更新。
- 切换会话，GUI 自动跟随：在飞书用
/ws选择工作区/会话后，桌面侧栏会打开对应会话（需保持 DSH 页面打开；长时间后台可能超时，飞书会提示手动打开）。
接入与连接¶
- 扫码一键接入：飞书扫码可自动创建应用并绑定机器人，预填权限、写入凭据并连接；也可手动填写 App ID / Secret。
- 换机器人免重启：更换 bot 后热重连，旧绑定与授权自动清理；同一时间只连一个机器人。
- 事件订阅：使用
im.message.receive_v1的长连接模式（仅企业自建应用支持；应用商店 / ISV 应用不支持）。
任务、进度与插话¶
- 进度与结果：绑定会话用进度卡展示过程与终态（耗时、token）；非绑定会话推送任务完成通知。
- 任务中插话：执行中发送
/steer <文本>或/插话 <文本>，把补充要求插入当前任务，无需等任务结束。 - 多选提问：收到多选提问后，点「回复编号作答」再回复编号（如
1,3）。
附件与命令¶
- 飞书发来的文件自动作为附件（≤20MB/个，单条最多 2 个）；图片入模型默认关闭（单条最多 4 张、单张 ≤10MB），可在设置页开启。
- 支持 DSH 原生命令
/goal、/plan、/compact，以及插件命令/new、/status、/output、/ws、/steer、/approve、/permission、/model、/help等。
隐私说明（作者声明）¶
凭据只写入本机插件状态目录；会话绑定、审批/提问记录与日志本地化；插件声明无遥测。断开连接会清除本地凭据并停止推送。
环境要求¶
安装与使用前请确认：
- 已安装并运行 DSH（DeepSeek Harness，Web GUI）。
- 飞书账号在该企业内有权限创建/管理自建应用（扫码自动建应用通常需要企业管理员或开发者权限）。
- 应用为企业自建应用并开启机器人能力；若使用已有机器人，需对该应用的开发者/管理员权限。
- DSH 所在机器能直接访问飞书开放平台（长连接，无需公网 IP）。
- 运行环境 Node.js ≥ 22（见
package.json的engines）。
安装与启用¶
通过 DSH 插件管理器安装（README 推荐方式）：
- 打开 DSH → 设置 → 插件管理器；
- 按包名
dsh-feishu-pilot搜索并安装，或直接添加：
git+https://github.com/pxvp2008/dsh-feishu-pilot.git
- 安装完成后重启 DSH。
飞书 SDK（@larksuiteoapi/node-sdk）与 qrcode 等运行依赖会自动安装。
若交给 AI Agent 安装，README 提供如下说明（仍建议优先用插件管理器）：
从 https://github.com/pxvp2008/dsh-feishu-pilot.git 安装 DSH 插件 dsh-feishu-pilot
快速开始与飞书侧配置¶
连接机器人¶
- 打开 DSH → 设置 → 飞书远控；
- 点「扫码连接」，用飞书扫码创建/选择机器人，或手动填 App ID / Secret；
- 连接成功后，在飞书私聊机器人发一条任务即可远程驱动桌面会话；
- 群聊中默认需 @机器人（可在高级设置关闭「群聊仅 @」）。
首次连接后，首个来信用户会自动成为管理员；后续可在设置页的「授权用户」中批准或忽略其他用户。
权限与事件（手动建应用时）¶
扫码模式会自动预填权限。手动配置时需开通例如：im:message:send_as_bot、im:message.p2p_msg:readonly、im:message.group_at_msg:readonly、im:message:readonly、im:resource、application:application:self_manage、斜杠命令相关权限等；事件订阅 im.message.receive_v1（长连接）与卡片回调 card.action.trigger。创建版本并发布应用，将机器人加入可用范围；群聊使用需把机器人拉入群。
详细权限表见 GitHub README。关闭「群聊仅 @」时，若需接收全部群消息，可能涉及可选敏感权限 im:message.group_msg，设置页会检查并提示缺失项。
设置页¶
DSH 设置 → 飞书远控 一页完成日常配置，修改即时生效：连接方式、远程功能开关（任务通知、审批、提问及子智能体）、会话绑定、授权用户、群聊仅 @、接收图片、审批/提问有效期等，无需改配置文件。
典型用法示例¶
私聊派任务¶
连接成功后，在飞书私聊机器人直接发送自然语言任务，与在 GUI 发消息类似；绑定会话会收到进度卡。
切换工作区 / 会话¶
在飞书发送：
/ws
按卡片或提示选择工作区与会话；桌面 GUI 侧栏会跟随打开对应会话。
任务执行中补充要求¶
/steer 请先只读代码，不要改文件
别名 /插话；空闲时行为等同普通消息。
文本处理审批¶
/approve <id> yes
或 no；也可在 GUI 或飞书卡片上先处理的一端生效。
查看状态与上一任务输出¶
/status
/output
适用场景与注意¶
适合：需要在移动端继续 DSH 审批/提问/派活；希望任务结束有飞书通知；团队已在用飞书且能建企业自建应用的场景。
注意：
- 长连接与扫码建应用依赖企业自建应用权限，个人或无开发者权限的账号可能无法一键扫码。
- 群聊默认只响应 @，避免误触发。
- 升级后状态目录会自动迁移，一般无需重扫码；设置页空白或报错时可刷新 DSH 页面（插件更新后尤其如此）。
- 插件以 DSH 进程权限访问本机会话与文件；安装前请审阅 源码仓库 与 MIT 许可证。
常见故障（未连接、群聊无响应、收不到审批卡、GUI 未跟随等）的处理表见 README「故障排查」；日志在本机插件目录。
结尾¶
dsh-feishu-pilot 把飞书变成 DSH 的远程控制台：扫码接入、双端竞速审批、任意 GUI 会话可推送，离开电脑也能继续受理任务与插话。DSH 生态强调「一切皆插件」，该插件由社区维护，可从目录页了解收录信息，从 GitHub 获取最新 README 与版本说明。
