前言¶
DeepSeek Harness (DSH) 的核心价值在于本地化智能体开发与运行。对于开发者而言，直接在终端操作 Agent 比较方便，但在移动场景下操作则不够直观。dsh-feishu-bridge 解决了这个问题：它是一个连接飞书与本地 DSH 的桥接插件，允许用户在飞书单聊中发送消息，直接驱动本机 DSH Agent 执行任务并回帖。
与官方 Web UI 或桌面套壳方案不同，该方案不需要公网 IP 或反向隧道，直接利用本机长连接处理事件。
核心功能¶
- 消息驱动：监听飞书长连接事件
im.message.receive_v1，将远程文本转化为本地 Agent 的 followup 任务。 - 回复策略：先回复「处理中…」，待回合结束再发送完整回复文本。
- 安全校验：支持白名单校验和
message_id去重；空白名单拒绝全部请求。 - 高危限制：
bash、write、edit等高危工具默认拒绝（deny）。 - 管理命令：支持
/status查看状态，/cancel取消当前任务。
安装与启用¶
前置要求：
* Node.js 版本 >= 22。
* DeepSeek Harness 版本 0.1.0-rc.6。
安装步骤：
1. 从源码克隆并构建（可选，推荐使用 npx 直接安装）。
2. 创建或指定 profile（例如 feishu-dev）。
3. 执行安装命令：
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile feishu-dev add .
配置¶
插件需要通过环境变量或配置文件注入飞书凭证与权限设置。需配置的字段包括：
* appId：飞书应用 ID。
* appSecret：飞书应用密钥。
* allowOpenIds：允许接收消息的飞书用户 ID 白名单。
* workspace：本地 Agent 工作区路径。
安全配置：
* 空白名单：若 allowOpenIds 为空或未配置，将拒绝全部消息。
* 工具权限：高危工具默认禁止。若需临时放开（极不安全），需通过环境变量手动控制，不支持飞书端点选批准。
典型用法¶
安装并启动 DSH 后，在飞书单聊中发送以下指令：
- 普通对话：发送「你好」。
- 期望：先收到「处理中…」，随后收到模型的完整回复。
- 安全测试：发送「用 bash 执行 echo hi」。
- 期望：收到「安全闸已拒绝」提示，终端日志显示
tool_denied。
- 期望：收到「安全闸已拒绝」提示，终端日志显示
- 状态查询：发送
/status。- 期望：收到 Agent 当前状态（如「空闲」或「忙碌」）。
- 取消任务：发送
/cancel。- 期望：取消当前正在进行的任务。
注意事项¶
- 免责声明：本插件为独立社区项目，与 DeepSeek 或飞书官方无隶属关系。远程消息将驱动本机 Agent 读写文件，变更与安全后果由操作者自行承担。
- 会话限制：同一会话中若上一条消息未处理完成，新消息会被提示「忙碌」（不排队）。
- 兼容性：进程重启后会话不恢复，启动为新会话。兼容性以
COMPAT.md为准，DSH 仍处于 Preview 阶段。 - 消息类型：目前仅支持单聊 + 纯文本，群聊 @、富文本、卡片消息暂不支持。
总结¶
dsh-feishu-bridge 提供了一种低侵入的方式，将飞书作为本地 DeepSeek Harness Agent 的远程控制台。它通过长连接实现即时响应，并内置了严格的安全限制，适合需要在移动端或远程快速触发本地计算任务的场景。
