Skip to content

Latest commit

 

History

History

codex-bridge

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 

README.md

🏠 返回主页 | 中文 / English

Codex Host Bridge — 远程开发桥接

中文 | English Documentation

平台 技术

📋 项目概览

Codex Host Bridge 是运行在 Windows 宿主机上的 WPF 桌面应用,用于将远程 Codex 客户端(Linux、macOS 或其他 Windows 节点)连接到本地 Codex App Server。远程节点通过 Tailnet 连接到 Bridge Gateway,经 Gateway 转发后,在 Windows 宿主机配置的项目目录中创建和操作 Codex 会话。

当前基线: v0.4.40
项目类型: 开发工具平台
开发周期: 2024-2025
项目状态: 生产使用

🎯 为什么需要这个项目

Windows 桌面 Codex 可以 SSH 到其他主机,实现从 Windows 到远程主机的运维操作。但也存在反向需求:让 Linux 或 macOS 的 Codex 客户端加入 Windows 宿主的项目上下文。

本项目提供了这个反向通道:

远程 Codex 客户端
        |
        | Tailnet WebSocket
        ↓
Windows Codex Host Bridge Gateway
        |
        | 本地回环转发
        ↓
Windows Codex App Server
        |
        ↓
Windows 宿主项目目录

⚡ 核心特性

1. 管理 Windows Codex 服务

  • 维护生命周期和就绪状态
  • 处理启动、停止、重启、端口冲突

2. 提供远程业务入口

  • 维护连接数、节点连接数、活动追踪

3. 维护节点准入状态

4. Linux 节点永久代理

  • 连接报告和验证脚本

🏗️ 系统架构

组件关系

远程节点(Linux/macOS)
        ↓
  永久代理
        ↓
Windows Tailnet Gateway
        ↓
Windows Codex App Server
        ↓
Windows 项目目录

关键技术

💡 技术亮点

  • 跨平台远程开发支持
  • 基于会话的连接转发
  • 节点准入和访问控制
  • 状态观测和只读导出

🛠️ 技术栈

  • C# / .NET

📚 仓库结构

Codex-Host-Bridge/
├── src/CodexHostBridge/       # Windows WPF Bridge 主程序
├── nodes/linux/               # Linux 节点入驻材料
├── docs/testing/              # 测试计划和验收证据
├── docs/release/              # 版本发布记录
├── docs/plans/                # 项目计划和结案记录
├── docs/integration/          # AgentMeshOS 状态契约
└── artifacts/releases/        # 发布程序和验证材料

🔗 相关链接


这个工具桥接了不同操作系统的开发环境,实现远程 AI 辅助开发工作流。