1、打包软件#

直接在飞书群里面 @机器人，给我出个软件包。

2、读取飞书群文件#

机器人可以获取到飞书群文件并进行任务。

3、像直接使用 Codex 一样，飞书中进行需求开发#

正常的开发任务更是不在话下。

4、手机端直接发任务#

出门在外，工作也不会落下，手机端直接操控干活。

这里就不举例了，电脑飞书怎么使用，手机就怎么使用即可。

5、功能扩展#

飞书连接到具体的 Codex 项目中，然后再配合项目中各种 skill 技能，将会完成更加复杂的功能，以及更完美的闭环。

1.1、安装运行#

要用到的 Bridge 是 Codex Remote Feishu。

GitHub：https://github.com/zhuyidian/in-feishu

macOS / Linux 直接运行：

1
curl -fsSL https://raw.githubusercontent.com/zhuyidian/in-feishu/main/install-release.sh | bash

Windows PowerShell 运行：

1
irm https://raw.githubusercontent.com/zhuyidian/in-feishu/main/install-release.ps1 | iex

脚本运行后会在浏览器打开一个 Codex Remote Feishu 安装程序。

1.2、扫码添加飞书机器人#

地址：http://localhost:9501/setup

跟着安装程序一步步走即可。环境检测成功后，可以扫码在飞书创建应用，点击“立即创建”即可。

1.3、权限检查#

如果有缺失的权限，直接把给出的代码复制，然后点击跳转到飞书后台权限设置界面。

点击“批量导入/导出权限”，把刚才复制的内容填进去，然后点击“新增权限”即可。

创建版本后，需要企业管理员审核。

1.4、事件订阅#

接下来它会让机器人尝试发送事件订阅测试，一般都没问题；如果不通过，去飞书后台配置即可。

测试成功后继续下一步。

1.5、回调测试#

接下来是回调测试，一般也不会有问题。

测试成功后继续下一步。

1.6、菜单配置#

接下来是机器人配置，点击进入飞书后台配置即可。如果不配置，所有东西都需要靠手敲 / 命令来实现，手机上很不方便。

1.7、自动启动#

自动启动不用管，检测通过后就会进入 VS Code 集成。如果没有这个需求，点击“先不使用”即可跳过。

1.8、配置完成#

到这里配置就完成了。

接入完成后，发布机器人的新版本，就可以在飞书里使用了。

1.9、对外共享#

下面两个设置，按大家的使用情况来勾选。

1.10、管理页面#

http://localhost:9501/admin/

2.1、/list：选择工作区#

开始任务之前，要先选择工作区，也就是选择在哪个项目下面进行对话。输入 /list 即可进入选择界面。

这里的工作区其实就是你使用 Codex 时操作的工作区。

2.2、其它命令#

这里就不一一列举命令测试了，自行使用即可。

1
/help 查看可用命令帮助。
2
/menu 打开按钮式命令菜单。
3
/status 查看当前模式、工作区、线程、运行状态。
4
/workspace 打开工作区管理入口。
5
/workspace list 列出可用工作区。
6
/workspace new 新建工作区入口。
7
/workspace new dir 从本地目录添加/创建工作区。
8
/workspace new git 从 Git 仓库创建工作区。
9
/workspace new worktree 创建 Git worktree 工作区。
10
/workspace detach 解除当前工作区绑定。
11
/list 列出可接管的实例/工作区。
12
/use 选择当前实例里的线程；别名 /threads、/sessions。
13
/useall 从全部线程里选择；别名 /sessionsall。
14
/detach 解除当前飞书会话的接管。
15
/new 新建一个会话，下一条消息作为首条输入。

1
/sendfile 从当前工作区选择文件发送到飞书。
2
/review 打开代码 review 入口。
3
/review uncommitted review 当前未提交改动。
4
/review commit <sha> review 指定 commit。
5
/admin 打开系统管理入口。
6
/admin web 打开公网/外部管理页入口。
7
/admin localweb 打开本地管理页入口。
8
/admin autostart on 开启自动启动，平台支持时可用。
9
/admin autostart off 关闭自动启动。
10
/cron 打开定时任务入口。
11
/cron reload 重新加载定时任务配置。
12
/upgrade 查看升级状态。
13
/upgrade latest 检查或继续升级到当前 track 最新版。
14
/upgrade track beta 切换 release track。
15
/upgrade local 使用本地 artifact 升级。
16
/debug 查看调试入口。
17
/vscode-migrate VS Code 迁移/兼容相关入口。

补充：/setup 不是飞书聊天命令，是启动服务后在浏览器打开的 Web Setup/Admin 配置入口。

3.1、怎么停止 Codex Remote Feishu#

停止 Codex Remote Feishu：

1
$pidFile = "$HOME\.local\state\codex-remote\codex-remote-relayd.pid"
2
$relayPid = Get-Content $pidFile
3
Stop-Process -Id $relayPid -Force

确认是否停掉：

1
curl.exe --noproxy "*" -sf http://127.0.0.1:9501/v1/status

如果返回连接失败，就说明已停止。

如果还没停干净，可以查进程：

1
Get-Process | Where-Object { $_.ProcessName -like "*codex-remote*" }

然后按 PID 停：

1
Stop-Process -Id <PID> -Force

只是在飞书里停止当前任务的话，不用停 daemon，发送：/stop。

3.2、怎么运行 Codex Remote Feishu#

PowerShell 中直接运行：

1
& "C:\Users\xxx\AppData\Local\codex-remote\bin\codex-remote.exe"

重新执行安装式启动，也可以运行：

1
cd E:\project\AIProjet\in-feishu\codex-remote-feishu
2
.\bin\codex-remote.exe install -bootstrap-only -start-daemon

或者在用户目录下运行：

1
& 'C:\Users\xxx\AppData\Local\codex-remote\bin\codex-remote.exe' install -bootstrap-only -start-daemon

启动后打开：http://localhost:9501/admin/

或者：http://localhost:9501/setup

运行成功会看到类似：

1
service: ready
2
web admin: http://localhost:9501/admin/
3
logs: xxxxx

然后检查状态：

1
curl.exe --noproxy "*" -sf http://127.0.0.1:9501/v1/status

打开管理页：http://localhost:9501/admin/

3.3、中断当前 Codex turn#

在飞书机器人里面发送：

1
/stop

/stop 是中断当前 Codex turn；上面的 PowerShell 是停止整个 Codex Remote Feishu 后台服务。

3.4、/list 等命令老是提示：目标回调服务器超时未响应#

经过分析日志发现：不是飞书后台没通，也不是机器人没收到回调，而是 Codex Remote Feishu 自己在处理“选择工作区”这个动作时卡住，或没有及时响应飞书。

这说明点击“选择工作区”后，事件已经进入本机 daemon，但没有完成绑定，也没有及时给飞书返回 ACK，所以飞书客户端显示“目标回调服务器超时未响应”。

原因是 v1.8.4 的 bug 或 Windows 下的处理链路问题：卡在 surface.target_picker.select_workspace 后，没有后续 attach/select 成功日志。

如果是 Windows 平台，可以尝试直接用源码编译后再试。新版本已经修复。

3.5、本地配置的信息在哪里？#

机器人的持久化配置在这里：

1
C:\Users\xxx\.config\codex-remote\config.json

安装状态文件也指向这个配置路径：

1
C:\Users\xxx\.local\share\codex-remote\install-state.json