# WeCom-Codex

**Repository Path**: lee_coding/we-com-codex

## Basic Information

- **Project Name**: WeCom-Codex
- **Description**: 连接企业微信与本机 Codex 的 Windows 助手，支持多机器人、桌面会话同步、只读 MCP 和本机知识库。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/lee_coding/we-com-codex/blob/master/docs/README.md
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2026-11-11
- **Last Updated**: 2026-11-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 企微 Codex 助手

简体中文 · [English](README.en.md) · [Gitee 文档中心](https://gitee.com/lee_coding/we-com-codex/blob/master/docs/README.md)

一个连接企业微信智能机器人、微信单聊与本机 Codex 的 Windows 工作台。可管理多个机器人、查看会话并发消息，也可按机器人选择是否与 Codex 桌面会话双向同步。

项目包含 **Node.js 后台服务**和 **Rust/Tauri 2 桌面端**。采用 [Apache License 2.0](LICENSE)。

## 功能

| 功能 | 说明 |
| --- | --- |
| 企微长连接 | 使用智能机器人 API 模式和配对口令，无需部署公网回调服务器 |
| 微信扫码单聊 | 扫码绑定多个账号，公开进度和答案分段返回；支持短命令与授权协作 |
| 多机器人 | 每个机器人独立配置凭据、绑定群、会话、成员权限、工具、记忆和知识库 |
| 会话管理与协作 | 短命令和自然语言管理桌面会话，按角色给协作机器人分派任务并跟进结果 |
| 会话工作台 | Markdown、快捷键、消息转发选项、Codex 桌面同步 |
| 工具与资料 | 可启用受控的只读 MCP、Skill、知识库及选填的源码仓库 |
| 附件 | 接收企微提供的图片与文件引用，解析常见文档和表格 |
| 统计与运行 | Token、工具调用、问题类型图表，以及托盘状态、后台运行和登录启动 |

## 界面预览

下图使用本地模拟数据。

![机器人会话和侧栏](docs/images/chat.png)

| 添加机器人向导 | 用量统计 |
| --- | --- |
| ![添加机器人和群配对向导](docs/images/wizard.png) | ![Token、工具调用和问题类型](docs/images/usage.png) |

## 快速开始

1. 在 Windows x64 上安装并登录 Codex 桌面版。独立会话也可使用已登录的 Codex CLI。
2. 运行 Windows 安装包。可从 [Gitee Releases](https://gitee.com/lee_coding/we-com-codex/releases) 查看发布产物，或按下文从源码构建。
3. 在企业微信创建支持 **API 模式 → 长连接** 的智能机器人，把机器人加入目标内部群。
4. 在助手侧栏点 **添加机器人**。选择记忆目录，按需选择只读代码仓库，然后在本机窗口填写机器人名称、Bot ID 和 Secret。
5. 生成配对口令，在目标群真正选中 `@机器人` 后发送向导显示的 `/pair` 口令。首次配对会绑定发送人和所在群。
6. 配对成功后打开会话。可以先做「测试 Codex」，再在群里 `@机器人` 验证一次收发。

运行、重新配对、桌面同步、群成员授权和故障排查详见 [中文使用指南](https://gitee.com/lee_coding/we-com-codex/blob/master/docs/user-guide.md)。

在群里 `@机器人 /help` 查看快捷命令。`/list` 列出会话，`/read 1` 查看进度，`/send 1 继续核对测试结果` 向指定会话排队发送，`/watch 1` 跟进结果。还可用自然语言要求机器人查询或调度会话。

初始化可以直接选择现有 Claude‑Mem 记忆库。空目录会初始化，多台机器人选择同一目录即可共享记忆。分工和协作对象在「设置 → 机器人分工」管理。

微信入口在添加机器人时选择「微信 · 扫码单聊」，按向导扫码。`@机器人 指令`、`@会话:名称 指令` 的答复回原入口，被调用机器人使用自己的人设回答。微信目前支持单聊文本，账号准入及数字验证由微信决定，详见 [微信与角色配置](docs/weixin-guide.md)。

## 一键构建 Windows 安装包

构建机需要 Git、Node.js 22.12+（包含 npm）、Rust MSVC x64，以及 Visual Studio 2022 或 Build Tools 的「使用 C++ 的桌面开发」和 Windows SDK。运行需要 WebView2。首次构建需连接依赖下载站点。

```powershell
git clone https://gitee.com/lee_coding/we-com-codex.git
cd we-com-codex
.\build-windows.cmd
```

脚本准备运行时、安装锁定的依赖、构建前端和 Rust 程序，生成 NSIS 安装包及 SHA-256 校验文件。产物输出到 `release/`。只准备开发资源可运行 `.\build-windows.cmd -PrepareOnly`。

完整依赖、离线缓存、开发运行和测试步骤见 [构建与发布](https://gitee.com/lee_coding/we-com-codex/blob/master/docs/build.md)。

## 源码结构

```text
server/       Node.js 后台、企微连接、Codex 桥接、只读工具和附件处理
ui/           React / shadcn/ui 桌面界面
src-tauri/    Rust 入口、IPC、Windows 托盘和安装配置
scripts/      构建、依赖准备和验收脚本
tests/        后台集成回归测试
docs/         中英文文档及示例截图
```

## 安全与贡献

Secret 由当前 Windows 用户的 DPAPI 加密保存。群消息、工具结果和会话按实际配置在本机处理，并按所用 Codex 模型服务的方式发送推理请求。桌面同步沿用所选会话的权限，请选择适合在绑定群共享的会话。需要使用助手提供的只读工具时，可选择专用只读项目。

- [贡献指南](CONTRIBUTING.md) · [Gitee Issues](https://gitee.com/lee_coding/we-com-codex/issues)
- [安全报告](SECURITY.md) · [变更记录](CHANGELOG.md) · [第三方组件声明](THIRD_PARTY_NOTICES.md)