Skip to content

evenpang666/codex-wechat-bridge

v0.1.4

Weave:通过 cc-connect 在个人微信使用本地 Codex,包含 Soft UI 管理页面。

Weave · Codex × 微信

通过 cc-connect,在个人微信中使用本地 Codex。

Windows Node.js MIT License

功能特色

功能说明
本地插件集成 Codex,插件加载或会话启动时自动启动管理服务
微信扫码连接无需公网回调,绑定成功后自动启动桥接
灵活配置系统窗口选择工作区,切换模型和推理强度
三种权限请求批准、帮我审批、全部权限
简洁回复默认仅发送最终结果,可选发送分析过程
会话面板查看消息、执行状态、审批提示和运行日志

Weave 管理页面,使用示例数据

快速使用

需要 Windows、Node.js 22+,以及已登录、可在终端运行的 Codex CLI。在项目目录执行:

npm ci
npm run plugin:prepare
codex plugin marketplace add (Get-Location).Path
codex plugin add codex-wechat-bridge@weave-local
npm run service:start
  1. 打开 管理页面,点击「扫码连接微信」,用手机确认。
  2. 选择工作区、模型、推理强度和权限,保存配置。
  3. 在微信发送任务;管理页面同步显示会话和执行状态。

重启 Codex 后加载插件;首次使用钩子时按 Codex 提示审阅并信任。保存运行配置会重启桥接,请先等当前任务结束。

微信常用命令:/new 新建会话 · /stop 停止任务 · /help 查看帮助。需要审批时回复 allow 或 deny。

安装、升级与自动启动说明见 安装指南;权限及回复选项见 配置说明。

问题解决

问题处理方式
管理页面打不开运行 npm run service:start,检查返回地址及端口占用
扫码后没有会话确认显示「已绑定 / 运行中」,再从微信发送一条消息
微信无回复或显示「空响应」更新并重新安装插件,确认桥接运行后发送新消息
工作区窗口未出现检查任务栏中的目录窗口,也可直接输入绝对路径
模型或权限报错检查本机 Codex 登录及可用选项,尝试继承 Codex 默认值

更多排查见 故障排除。数据与凭据说明见 安全与本机数据,开发和验证见 开发指南。