前言¶
DeepSeek Harness (DSH) 是一个基于插件架构的智能体开发框架。在开发或调试长流程任务时，通常需要在终端或桌面端操作。dsh-feishu 插件允许你通过飞书（Lark）手机客户端直接驱动现有的 DSH 会话，查看任务进度、回答问题、处理审批以及下发指令。
该插件通过仅出站（Outbound-only）的 WebSocket 连接工作，无需在本地开放端口或建立隧道。所有凭证存储在本地，所有者由 fan56 维护。
核心功能¶
该插件提供了一套完整的远程交互机制，主要包含以下能力：
会话管理与控制¶
- 会话控制：
/new启动一个继承上一会话配置（工作目录、模型、推理强度）的新会话；/stop随时中止正在运行的任务；/btw在主任务运行时并行处理旁注问题。 - 会话恢复：
/resume提供交互式会话选择器，支持通过下拉菜单或回复数字索引快速恢复历史会话。若遇到损坏的会话日志，插件会提供“一键损坏日志修复”功能，在保留备份的前提下重建日志。 - 交互式选择器：桌面端的
/model、/think、/permission、/select-skill和/profile-switch命令，在手机端会渲染为可一键触发的卡片选择器。
实时可视化与反馈¶
- 实时圆形卡片：每个 LLM 的往返都会生成一张圆形卡片，每 5 秒刷新一次当前状态（思考中、工具调用中、子代理运行中）。卡片底部会展示工具调用信息和正在生成的消息片段。
- 回复嵌入：当一轮任务结束，回复内容会直接嵌入到正在观看的圆形卡片中（显示为
💬 Round 回复），而非作为独立消息插入。长回复仍会以独立卡片发送。 - 快速操作：在卡片上提供 ⛔ 停止和 ▶️ 继续 的一键操作，无需输入命令。
飞书端特有功能¶
- 群聊支持：机器人可被拉入飞书群组，仅对允许列表内的成员可见。成员可通过 @机器人 下发指令，机器人主动驱动时无需再次提及。
- 图片派发：在私聊中发送图片，插件会自动下载、检测媒体类型并作为附件注入会话。
- 审批与提问：当会话需要审批（Approval）或调用
ask_user_question时，手机端会收到交互式卡片，支持下拉选择、多选或文本输入提交。 - 后台推送：支持后台推送（
backgroundPush）模式，当会话在非绑定手机上完成或子代理结算时，可通过 Cron 模式或 All 模式向手机发送完成通知（默认关闭，仅在配置开启时工作）。
安装与启用¶
使用该插件前，请确保环境满足要求。
环境要求¶
- DSH 版本 >= 0.2.0-rc.2（Alpha 行不再支持）。
- Node.js 版本 >= 22.19.0。
安装插件¶
在终端执行以下命令将插件安装到指定 Profile：
dsh plugin --profile <your-profile> add @aiwayds/dsh-feishu
配置凭证¶
安装完成后，需要在飞书侧进行配置。推荐在 DSH 桌面端运行 /feishu-onboard 命令。该命令会引导你通过扫码创建飞书应用，并自动写入凭证到 ~/.dsh/.credentials.yaml。
若使用现有应用，需手动配置 App ID 和 App Secret：
# ~/.dsh/.credentials.yaml
DSH_FEISHU_APP_ID: cli_xxxxxxxxxx
DSH_FEISHU_APP_SECRET: xxxxxxxxxxxxxxxx
权限配置¶
- 非管理员用户使用时，必须在飞书侧配置 Allowlist，否则机器人将无法响应。
- 需确保飞书应用具备机器人能力、长连接事件权限（
im.message.receive_v1等）及特定消息权限。
典型用法¶
以下是该插件支持的核心命令示例：
/new：在手机端启动一个全新的会话，继承当前会话的模型和目录配置。/resume：弹出交互式卡片，选择一个历史会话继续对话。/feishu-onboard：在桌面端运行，用于初始化或配置飞书应用的凭证。/stop：中止当前正在执行的任务。/btw：在当前任务运行时，发送旁注问题。
适用场景与注意¶
- 适用场景：适合需要在移动端监控长耗时任务、处理审批流、或利用手机快速回答模型提问的开发者。
- 连接模式：插件仅作为出站客户端，不提供内网穿透功能，需确保手机网络环境正常。
- 安全性：凭证仅存储在本地文件系统，请勿上传至公共代码仓库。
- 生态关系：该插件属于社区维护项目，目录与 DeepSeek 或幻方无官方从属关系。
结尾¶
dsh-feishu 通过飞书将 DSH 的控制权延伸至移动端，实现了会话管理的可视化与交互化。其通过出站 WebSocket 的设计降低了网络配置门槛。更多细节可参考插件目录或GitHub 仓库。
