# 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-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # WeCom Codex Assistant [简体中文](README.md) · English · [Gitee documentation](https://gitee.com/lee_coding/we-com-codex/blob/master/docs/README.md) WeCom Codex Assistant is a Windows workbench that connects WeCom intelligent bots and Weixin direct chats to a local Codex installation. It includes a **Node.js background service** and a **Rust/Tauri 2 desktop UI**, released under the [Apache License 2.0](LICENSE). ## Features - Connect an internal WeCom group through the official intelligent-bot long connection. - Pair multiple Weixin accounts by QR code, stream public answer blocks, and use the same commands and authorized bot/session routing. - Configure multiple bots with separate credentials, groups, sessions, members, tools and data locations. - Manage Codex conversations through commands or natural language, and dispatch work to configured specialist bots. - Send messages from the desktop workbench and optionally synchronize a selected Codex Desktop conversation. - Use approved read-only MCP tools, skills, knowledge directories and optional source repositories. - Read images and file references when WeCom supplies their attachments. - View token, tool-call and question-category charts. Use the system tray to check status and keep background workers running after the window closes. ## Screenshots The screenshots use local demo data. ![Chat and robot sidebar](docs/images/chat.png) | Setup wizard | Usage charts | | --- | --- | | ![Robot pairing wizard](docs/images/wizard.png) | ![Token, tools and question charts](docs/images/usage.png) | ## Quick start 1. On Windows x64, install and sign in to Codex Desktop. Standalone sessions can also use an authenticated Codex CLI. 2. Run the Windows setup executable. Check [Gitee Releases](https://gitee.com/lee_coding/we-com-codex/releases) for published installers or build from source below. 3. Create a WeCom intelligent bot in API long-connection mode and add it to an internal group. 4. Open **添加机器人** in the workbench. Select a memory directory, optionally select a read-only repository, and enter the bot name, Bot ID and Secret locally. 5. Generate the pairing code. Select the bot with an actual group mention and send the displayed `/pair` command. The first successful pairing records that group and the sender. 6. Open the conversation, run **测试 Codex**, then send one non-sensitive group message to verify delivery. The [English user guide](https://gitee.com/lee_coding/we-com-codex/blob/master/docs/user-guide.en.md) covers configuration, desktop sync, group access and troubleshooting. Mention the bot with `/help` to see commands. Use `/list` for conversations, `/read 1` for progress, `/send 1 ` to queue a message, and `/watch 1` to follow completion. Natural-language requests can use the same tools. Choose an existing Claude‑Mem library directly during setup, or an empty directory to initialize one. Multiple bots can share the same library. Configure roles and permitted collaborators under **设置 → 机器人分工**. For Weixin, select **微信 · 扫码单聊** when adding a bot and follow the QR flow. Replies to `@bot instruction` and `@会话:session instruction` return to the original entry point; delegated bots use their own persona. Weixin currently supports direct text messages. Account eligibility and phone verification are controlled by Weixin. See the [Weixin and persona guide](docs/weixin-guide.md). ## Build the Windows installer Install Git, Node.js 22.12+ with npm, Rust for MSVC x64, and Visual Studio 2022 Build Tools with Desktop development with C++ and a Windows SDK. The application uses WebView2. The first build needs access to the dependency download hosts. ```powershell git clone https://gitee.com/lee_coding/we-com-codex.git cd we-com-codex .\build-windows.cmd ``` The script prepares the runtime, installs locked packages, builds the web and Rust applications, and places the NSIS setup executable and SHA-256 checksum in `release/`. Use `.\build-windows.cmd -PrepareOnly` to prepare development resources. See [Build and release](https://gitee.com/lee_coding/we-com-codex/blob/master/docs/build.en.md) for prerequisites, caches, development commands and verification. ## Project structure `server/` contains the Node.js worker, Codex bridge and read-only tools. `ui/` contains the React and shadcn/ui interface. `src-tauri/` contains the Rust desktop entry point, IPC, tray and installer configuration. Build scripts, tests and bilingual guides are in `scripts/`, `tests/` and `docs/`. ## Security and contributions The Windows user's DPAPI protects the locally stored Secret. The app sends inference input using the configured Codex model service. Desktop sync uses the selected conversation's Codex permissions. Choose a conversation suitable for sharing with the linked WeCom group. The optional dedicated read-only project provides the workbench's tools. - [Contributing](CONTRIBUTING.md) · [Gitee Issues](https://gitee.com/lee_coding/we-com-codex/issues) - [Security reporting](SECURITY.md) · [Changelog](CHANGELOG.md) · [Third-party notices](THIRD_PARTY_NOTICES.md)