飞书AI工作流桥接

源码安装（纯代码变更 pull 即生效，依赖变更需重装）

cd feishu-bridge && git pull pip install -e '.[dev]' # 仅 pyproject.toml 依赖变更时需要 ```

使用 /update 可手动触发版本检查并自动重启部署。

快速开始

2. 安装

```bash pipx install feishu-bridge # 推荐（隔离环境）

PyPI 安装

pipx upgrade feishu-bridge

部署

```bash

3. 配置并运行

首次运行自动启动配置向导：

```bash $ feishu-bridge --bot my-bot

→ 凭证写入 ~/.config/feishu-bridge/.env

→ 配置写入 ~/.config/feishu-bridge/config.json

手动配置 `~/.config/feishu-bridge/config.json`：

发送 `/agent claude`、`/agent codex`、`/agent pi`、`/agent omp` 或 `/agent alma` 可在当前 bot 进程内热切换后端。切换会清空旧会话映射，避免复用不兼容的 `session_id` / `thread_id`；该切换仅影响当前运行实例，重启后仍以配置文件中的 `agent.type` 为准。

`agent.args` / `agent.env` 是当前 `agent.type` 的简写；如需给热切换目标预置不同参数，使用 `args_by_type` / `env_by_type`。

如需在 bridge 内热切换 provider，而不是手改配置文件，可定义 `agent.providers`：

随后可在飞书内直接发送：

agent.prompt 用于控制 bridge 自己追加的 system prompt 片段；provider 下的 prompt 会覆盖全局设置。对本地 Ollama，通常建议关闭 feishu_cli / cron_mgr，并把 safety 降到 minimal，这样可以显著减少每次启动时固定注入的 token。

切换 provider 会像 /agent 一样清空旧会话映射，避免复用不兼容的 session。

模型相关配置归属 CLI

Bridge 只做透传，不内置任何模型名、context window、别名默认值。所有模型相关配置由下游 CLI 自己管理：

Bridge 行为：

• bot.model、/model <name> — 直接透传给下游 CLI；未设则由 CLI 自己决定
• agent.providers.<name>.model_aliases — 飞书端别名解析（/model qwen → /model Qwen3.6-35B-A3B-mxfp4），解析后再透传
• /status 与消息 footer：若流事件未上报 contextWindow（或上报为 0），显示 "上下文窗口：未知（由 CLI 决定）"，跳过百分比告警

最小配置（只配 agent.type，其他全部交给 CLI）：

"agent": { "type": "claude" }
// 等效于 claude CLI 自己的默认模型 + context window

飞书 CLI 工具

feishu-cli 负责 bot 消息发送（文本、图片、音频），lark（larksuite/cli）覆盖 20+ 飞书服务（文档、表格、多维表格、Wiki、日历、任务、邮件、云盘、审批等）。Agent 自动按需调用，也可作为独立 CLI 工具使用。

CLI 工具

Bridge 安装后提供三个 CLI 入口：

飞书服务 API 操作（文档、表格、日历、任务、邮件等）使用独立的 lark CLI：

lark docs +fetch --doc doxcnXXX              # 读取文档
lark docs +create --title "报告" --body "..."  # 创建文档
lark sheets +read --token xxx --range A1:C10  # 读取表格
lark calendar events +list                   # 查看日历
lark tasks +list                             # 查看任务
lark mail +search --query "季度报告"           # 搜索邮件