opencode-feishu

OpenCode 飞书插件 — 通过飞书 WebSocket 长连接将飞书消息接入 OpenCode AI 对话。

快速开始

1. 配置 OpenCode 加载插件

在 ~/.config/opencode/opencode.json 中添加：

{
  "plugin": ["opencode-feishu"]
}

2. 创建飞书配置文件

创建 ~/.config/opencode/plugins/feishu.json：

{
  "appId": "cli_xxxxxxxxxxxx",
  "appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

也支持通过环境变量注入敏感值（适合容器部署）：

{
  "appId": "${FEISHU_APP_ID}",
  "appSecret": "${FEISHU_APP_SECRET}"
}

${VAR_NAME} 占位符会在启动时从 process.env 读取，未设置则报错。明文值直接使用。

3. 配置飞书应用

在 飞书开放平台 创建自建应用，然后：

1. 添加机器人能力
2. 事件订阅 — 添加 im.message.receive_v1 和 im.chat.member.bot.added_v1
3. 订阅方式 — 选择「使用长连接接收事件/回调」（不是 Webhook）
4. 权限 — 开通 im:message、im:message:send_as_bot、im:chat、im:message:readonly
5. 发布应用

4. 启动 OpenCode

opencode

插件自动安装并连接飞书 WebSocket。

配置说明

~/.config/opencode/plugins/feishu.json 完整配置：

群聊行为

开发

npm install        # 安装依赖
npm run build      # 构建
npm run dev        # 开发模式（监听变更）
npm run typecheck  # 类型检查
npm publish        # 发布到 npm

许可证

MIT