Skip to content

install.md

Latest commit

 

History

History
107 lines (74 loc) · 2.03 KB

install.md

File metadata and controls

107 lines (74 loc) · 2.03 KB
Raw

安装与卸载

前置条件

  • macOS。
  • Python 3。
  • 已安装并登录 Codex CLI。
  • 已准备飞书机器人的 App ID 和 App Secret。

一键安装

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/LpcPaul/FeishuCodexBridge/main/remote-install.sh)"

安装脚本会提示输入飞书应用凭证，然后自动安装 launchd 服务。

安装完成后不要直接结束配置。继续按 安装后必做检查 确认飞书后台已经把消息事件和卡片回调都切到长连接，否则卡片按钮会报 code: 200340。

手动安装

git clone https://github.com/LpcPaul/FeishuCodexBridge.git
cd FeishuCodexBridge
./install.sh

安装后位置

安装后必做

  1. 在飞书开放平台「事件与回调」里选择长连接接收事件和回调。
  2. 在「已订阅的事件」里添加 im.message.receive_v1。
  3. 在「已订阅的回调」里添加 card.action.trigger。
  4. 保存并发布新版应用。
  5. 回到本机运行：
./bridge status
./bridge logs 30

完整验收清单见 安装后必做检查。

安装后位置

运行目录：

~/Library/Application Support/FeishuCodexBridge

应用副本：

~/Library/Application Support/FeishuCodexBridge/app

配置文件：

~/Library/Application Support/FeishuCodexBridge/app/.env.feishu

可选能力也在这个文件里开启：

FEISHU_CODEX_CARDS_ENABLED=1
FEISHU_CARDKIT_ENABLED=1
FEISHU_DOCS_ENABLED=0
FEISHU_DOCS_FOLDER_TOKEN=

修改配置后运行 ./bridge restart 让服务重新读取。

LaunchAgent：

~/Library/LaunchAgents/com.codex.feishu-codex-bridge.plist

服务管理

在项目目录里运行：

./bridge status
./bridge restart
./bridge logs
./bridge follow-logs
./bridge stop
./bridge start

卸载

只移除服务，保留状态库和配置：

./uninstall.sh

移除服务并删除运行数据：

REMOVE_FEISHU_CODEX_BRIDGE_DATA=1 ./uninstall.sh