feishu_X_codex

KO | EN

gitlite — search

#hacktoberfest #ai #typescript #golang #android #machine-learning #rust #docker #macos #windows #cli #mcp #openai #open-source

(★ 16)

No description available.

feishu_X_codex Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 飞书 <-> Codex CLI Bridge

这个桥接工具可以做到：
1) Codex CLI 有新回复后自动推送到飞书（单聊 or 群机器人）。
2) 你在飞书里回复机器人，消息会直接写入本地 Codex CLI（保留上下文）。

## 环境准备
- Node.js 18+
- 本地已安装 Codex CLI（可在命令行直接运行 `codex`）
- 飞书自建应用（机器人能力已启用）
- 群自定义机器人 webhook（用于推送消息）

## 安装
```bash
npm install
```

## 配置
复制配置文件：
```bash
copy config.example.json config.json
```

关键字段说明：
- `appId` / `appSecret`: 飞书自建应用的凭证
- `webhookUrl`: 群自定义机器人 webhook
- `allowedOpenIds`: 白名单（只有这些 open_id 可以控制 CLI）
- `codexCommand` / `codexArgs`: 启动 Codex 的命令与参数
- `workingDir`: 指定 Codex 运行目录（也可用环境变量 `WORKING_DIR` 覆盖）
- `debugLogs`: 输出事件调试日志
- `replyOnReceive` / `replyText`: 收到消息后回执
- `idlePushMs`: 空闲 N 毫秒后推送（默认 10000）
- `sendToUserOnIdle`: 推送时同时私聊最后的发送者
- `maxMessageChars`: 推送内容最大长度
- `mode`: `tui`（交互模式，保留上下文）或 `exec`（非交互，输出干净）
- `outputSource`: `session`（读 Codex 会话日志，干净）或 `pty`（直接读终端输出）
- `codexHome`: Codex home 路径（默认 `~/.codex`）

## 启动
```bash
npm start
```

如果需要指定目录运行（不改 `config.json`），可以：
```bash
set WORKING_DIR=E:\Your\Project
npm start
```

也可以在启动时传参：
```bash
npm start -- --dir=E:\Your\Project
```

## 常见问题
1) **推送有乱码/碎字符**  
   使用 `mode: "tui"` 时请配合 `outputSource: "session"`，输出会从会话日志提取，基本无噪声。

2) **提示“应用未建立长连接”**  
   说明桥接服务未连接或 `appId/appSecret` 错误，确保 `npm start` 已运行且应用已发布。

## 飞书自建应用创建与配置（单聊机器人）
1) **创建应用**  
   打开飞书开放平台（open.feishu.cn）→「我的应用」→「创建企业自建应用」。

2) **开启机器人能力**  
   应用详情 →「添加应用能力」→ 选择「机器人」并启用。

3) **配置权限**  
   「权限管理」里至少开通“读取用户发给机器人的消息（单聊）”等消息接收权限。

4) **订阅事件**  
   「事件与回调」→ 订阅 `im.message.receive_v1`。

5) **选择接收方式：长连接**  
   在「事件与回调」设置中选择“使用长连接接收事件/回调”，无需公网回调地址。

6) **发布版本并设置可见范围**  
   「版本管理与发布」创建版本并发布；  
   「应用可见范围」把你的账号加入，否则客户端搜不到机器人。

7) **获取 AppId / AppSecret**  
   应用详情页可看到 `App ID (cli_xxx)` 与 `App Secret`，填入 `config.json` 的 `appId` / `appSecret`。

8) **获取 open_id（白名单）**  
   先把 `allowedOpenIds` 设为空数组，运行桥接后给机器人发消息；  
   控制台日志里会打印你的 `open_id`，再写回 `allowedOpenIds`。

## 打包分享
有三种方式：
1) **ZIP 分享**：直接压缩整个目录发给别人，收到后 `npm install` 即可。
2) **Git 仓库**：推到 GitHub/Gitee，其他人 `git clone` 后运行。
3) **发布为 npm 包**：把 `package.json` 改成可发布包，执行 `npm publish`（适合公开发布）。

## 安全建议
- 必须设置 `allowedOpenIds`，避免任何人操控你的 CLI。
- 建议限制 `workingDir`，避免误操作全盘。

feishu_X_codex

feishu_X_codex Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

feishu_X_codex

feishu_X_codex Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README