前言¶
DeepSeek Harness 的插件体系可以把渠道能力接入同一个 dsh 环境。对需要在飞书/Lark 里和 agent 协作的开发者来说，常见需求是：在私聊或群聊中发送消息、接收流式卡片、处理 dsh 审批请求、调用云文档/表格/日历/任务，并按 chat 路由多个 agent。
harness-lark 是 Lark/飞书（Feishu）渠道插件，为 DeepSeek Harness 提供飞书通信能力。
这是什么¶
harness-lark 的仓库地址为：
https://github.com/huoxue1/harness-lark
许可证为 MIT。它解决的是把 DeepSeek Harness 的会话、流式回复、审批请求和飞书能力接到飞书/Lark 消息通道的问题。
核心功能¶
下面介绍已核实的几类能力。
- IM 消息收发：WebSocket 长连接接收消息、文本/卡片回复、@提及、群聊/私聊策略、重连去重。
- 交互卡片 + 流式回复：思考过程（reasoning）流式 → 生成（answer）流式 → 最终结果更新到卡片，含可折叠思考面板、耗时/token footer。
- 媒体：图片/文件/音频的上传、下载与发送。
- 文档/Wiki/Drive：创建/读取/更新云文档（docx）、知识库节点、云盘文件。
- Base/表格/日历/任务：多维表格（bitable）、电子表格、日历事件、任务。
- 用户 OAuth：设备授权码流程（RFC 8628），用户级 token 管理。
- 表情反馈：收到消息回复 Get 表情（处理中），完成后换成 DONE。
- 飞书审批卡片：dsh 审批请求（如 bash 沙箱升级）以带批准/拒绝按钮的卡片发到会话，点击即应答，超时自动拒绝。
- 斜杠命令：/status、/model、/cd、/permission、/setting、/help 等本地命令。
安装与启用¶
前置条件¶
安装前需要满足以下条件：
Node.js ≥ 22（含 pnpm）
已安装 dsh CLI
飞书开放平台应用凭据：appId、appSecret
已订阅事件：im.message.receive_v1
推荐安装¶
先设置飞书应用凭据：
export FEISHU_APP_ID=cli_xxx
export FEISHU_APP_SECRET=your_secret
然后安装到 web profile：
dsh plugin --profile web add harness-lark
再启动：
dsh --profile web
经过上面的步骤，插件会随当前 dsh 进程加载，并按授权范围调用飞书 API。
可选一键脚本：
export FEISHU_APP_ID=cli_xxx
export FEISHU_APP_SECRET=your_secret
bash scripts/install-dsh.sh web harness-lark
源码安装¶
先克隆仓库并构建：
git clone https://github.com/huoxue1/harness-lark.git
cd harness-lark
pnpm install && pnpm run build
再把本地目录加入 web profile：
dsh plugin --profile web add file:/path/to/harness-lark
典型用法¶
斜杠命令¶
启动后可以在飞书会话中使用以下本地命令：
/status
/model
/cd
/new
/stop
/permission
/setting
/help
这些命令用于查看状态、切换模型、修改工作目录、新建上下文、停止当前回复、调整权限/设置以及查看帮助。
群聊提及¶
群聊中命令可带 @机器人 前缀，例如：
@机器人 /status
插件会自动剥离提及前缀。
多 Agent 路由¶
多 Agent 配置可在 config.agents 中按 chat 路由。下面是一个只表达 chat 路由的示例：
agents:
- id: agent-a
chats:
- oc_111
- p2p
- id: agent-b
chats:
- oc_222
- group
其中 oc_ 形式表示精确 chat_id，p2p 和 group 表示类型标签。
安全与适用场景¶
harness-lark 适合私聊助手场景。插件在授权范围内以机器人身份调用飞书 API，存在模型幻觉、提示注入等固有风险。建议不要加入群聊或允许他人交互，并保持默认安全配置：
groupPolicy: disabled
requireMentionInGroups: true
用户数据类工具在用户执行 /feishu auth 授权后以该用户身份调用飞书 API；未授权时回退为机器人身份。Wiki/Drive/IM 类工具始终以机器人身份调用。
安装前建议检查源码和许可证。许可证为 MIT。
链接¶
GitHub 仓库：
https://github.com/huoxue1/harness-lark
