VKodex

VKodex 是一个开源机器人，用于通过 VKontakte（VK）的消息和群聊远程控制 OpenAI Codex。它让你可以在手机上继续现有的 Codex 任务或创建新任务：在管理者对话中选择项目，打开关联的 VK 群聊，并向同一上下文发送补充说明和附件。与社区的私人对话充当管理者，而独立的 VK 群聊则对应一个 Codex 任务。

项目状态为在 Windows 上与 Codex 的实验性集成。VKodex 与桌面版 Codex 运行在同一台电脑上，并使用同一个 Windows 用户。对于每个 owner: "app-server" 的配置档，VKodex 会维持一个长期运行的 App Server。

Desktop 桥接会自动在 BOT_DATA_DIR/diagnostics 中维护一份独立的私有 JSONL 日志。每行对应一个 vkodex.diagnostic.v1 事件。这些事件关联了传入消息队列、观察准备、所有者检测失败、路由选择、RPC 写入、确认以及按历史记录的核对。RPC 的参数/响应、消息文本、文件内容、令牌以及错误文本/堆栈都不会被记录。

运行需要装有已启动的桌面版 Codex 的 Windows、Node.js、npm、Git，以及拥有独立社区和密钥的 VK 账户。对于在俄罗斯的典型启动方式，需要分流路由：VKodex 通过俄罗斯 IP 直接访问 VK API 和 Long Poll，而 Codex/OpenAI 则通过 VPN。不需要公网 IP、域名、HTTPS 证书和入站端口：VKodex 自己通过 Bots Long Poll 接收事件。