--- ## 这是什么？ Nexus4CC 把任何浏览器变成 **Claude Code** 的指挥中心——同时也支持 Codex、Gemini CLI 等任何终端 AI Agent。它直连你电脑上的 tmux 会话，让你随时随地监控、切换和指挥你的 AI 军团。 手机、折叠屏、平板、PC —— 一个界面，全设备适配。没有云服务，没有订阅费，没有复杂的 SSH 配置。你的终端，如影随形。 --- ## 功能 | | | |---|---| | 🔌 **WebSocket ↔ tmux 桥接** | 每个窗口独立 PTY，实时双向 I/O。关掉浏览器，Agent 继续跑。 | | 📱 **全设备终端** | xterm.js + 滑动导航 + 双指缩放 + 可配置软键盘。手机上触控操作，PC 上键盘操作——一个界面全适配。 | | 📂 **嵌入式文件浏览器** | 可拖拽调整宽度的侧栏。浏览、编辑、Markdown 预览。按名称/日期/大小排序，支持右键菜单。 | | 🗂️ **项目与频道管理** | 以目录为单位组织项目，多个频道式会话。像 Slack 频道一样即时切换——专属于你的终端工作流。 | | 💾 **会话持久化** | tmux-resurrect 保活。服务器重启后，所有会话原样恢复，无缝接续。 | | 🔀 **多会话管理** | 同时跑多个 tmux session，在浏览器里秒切，不用离开页面。 | | 🎨 **PWA** | iOS/Android 可安装到主屏幕。深色/浅色主题。用起来像原生 App，离线也能打开。 | --- ## 为什么选 Nexus4CC？ | | Anthropic Remote Control | Happy Coder | Omnara | **Nexus4CC** | |------------------------------|:---:|:---:|:---:|:---:| | 自托管 | ❌ | ❌ | ⚠️ | ✅ | | 无需订阅 | ❌ | ✅ | ❌ | ✅ | | 数据留在本地 | ❌ | ❌ | ❌ | ✅ | | 真实终端（xterm） | ❌ | ❌ | ❌ | ✅ | | 项目与频道管理 | ❌ | ⚠️ | ⚠️ | ✅ | | 发射后不管 | ⚠️ | ✅ | ✅ | ✅ (纯 tmux) | | PWA / 可安装 | ❌ | ✅ | ✅ | ✅ | | 开源 | ❌ | ⚠️ | ✅ | ✅ | > **项目与频道管理：** 以目录为单位组织项目，每个项目下有多个频道式会话——像 Slack 频道一样即时切换，专属于你的终端工作流。 --- ## 快速开始 ```bash git clone https://github.com/librae8226/nexus4cc.git && cd nexus4cc cp .env.example .env # 设置 JWT_SECRET、ACC_PASSWORD_HASH、WORKSPACE_ROOT npm install && cd frontend && npm install && npm run build && cd .. npm start # 在任意设备打开 http://localhost:59000 🚀 ``` > 完整配置指南（Claude Profile、PM2、移动端访问）：**[QUICKSTART.md →](docs/QUICKSTART.md)** --- > 💡 **致人类用户：** 按上方「快速开始」操作即可。以下内容写给帮你安装的 AI 助手看。 ### 致 AI 助手 如果你是正在帮用户安装 Nexus 的 AI 助手，按以下步骤执行： 1. 克隆本仓库并 `cd` 进入目录 2. 运行 `node scripts/setup.js` — 自动处理依赖安装、前端构建、PM2 启动和 tmux 会话创建 3. 验证：`pm2 status` 显示 `nexus` 在线 → 打开 `http://localhost:59000` 前置要求：Node.js 20+、tmux。PM2 不存在时会自动全局安装。 默认登录密码：`nexus123`（安装完成后可在 `.env` 中修改）。 --- ## 部署建议 通过 [Cloudflare Tunnel](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/) 或 [Tailscale](https://tailscale.com/) 安全暴露服务，无需端口转发。 --- ## 环境要求 | 依赖 | 版本 | 说明 | |---|---|---| | Node.js | 20+ | | | tmux | 任意近期版本 | | | PM2 | 任意近期版本 | `setup.js` 自动安装 | | 操作系统 | Linux / WSL2 | | > 💡 搭配语音输入法 [Milo Input](https://miloinput.fay.wang/) 使用体验更佳。 --- ## 安全说明 Nexus 是**单用户自托管工具**，不是多租户平台。 - 🔒 bcrypt（12 轮）密码哈希 + JWT（30天） - ⚠️ WebSocket token 通过 query string 传递 — 生产环境请启用 TLS - 🛡️ 在防火墙、VPN 或隧道后运行，不要直接暴露在公网 --- ## 文档 | 文档 | 说明 | |---|---| | [QUICKSTART.md](docs/QUICKSTART.md) | 手把手配置指南 | | [ARCHITECTURE.md](docs/ARCHITECTURE.md) | 系统架构与 API 参考 | | [PRD.md](docs/PRD.md) | 功能规格说明 | | [ROADMAP.md](docs/ROADMAP.md) | 未来规划 | | [📖 Nexus 的故事](docs/story.md) | 为什么造了这个东西 | --- ## 社区