# cloudnest

**Repository Path**: freecpu/cloudnest

## Basic Information

- **Project Name**: cloudnest
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-30
- **Last Updated**: 2026-10-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cloudnest（云巢）

多 Agent（Hermes + DSH）远程协作系统：云桌面 ↔ 线下电脑经公网中继服务器建立 SSH 反向隧道，A2A 协议互通，飞书作为人机交互入口。

## 架构一览

```
                        中继服务器（公网 IP，仅隧道中继）
              ┌───────────────────┴───────────────────┐
        30011/30012/30013                     30016/30017/30018
        （Unit-01 云侧）                       （Unit-01 线下侧）
              ▲                                       ▲
        云桌面 cloud-01                          线下电脑 local-01
        Hermes:9900 / DSH:9901                   Hermes:9900 / DSH:9901
        （飞书 websocket 长连接）                 （回环互调）
```

- 全部主机为 Windows 11 原生环境（无 WSL2）；
- 端口规则：协作单元 Unit-N 占用 `30000+10N` 起的 10 号段（见需求书 §2）；
- 隧道由 Windows 端 Python 守护脚本维持（替代 autossh/NSSM）。

## 目录导航

| 目录 | 内容 | 执行方 |
| --- | --- | --- |
| `docs/` | 原始需求说明书、云巢需求书、实施计划 | —— |
| `server/` | 中继服务器端脚本（bash 运维 + 工具） | AI 直连执行 |
| `windows/` | Windows 端：`common/`（两端共用脚本）+ `cloud-desktop/`（云桌面）+ `local-pc/`（本地电脑） | 云桌面：用户执行；本地电脑：AI 执行 |
| `agents/` | Hermes / DSH / A2A 对接配置与工具（阶段 P5+） | —— |

## 快速上手

1. 阅读 `docs/云巢需求书 v1.md`（端口 / 安全 / 方案权威来源）与 `docs/云巢实施计划 v1.md`（执行节奏）；
2. 中继服务器（Ubuntu 24.04，`/data/cloudnest`）：依次执行 `server/scripts/` 下编号脚本；
3. Windows 端：按角色进入 `windows/cloud-desktop/`（云桌面）或 `windows/local-pc/`（本地电脑），脚本取自 `windows/common/`（详见 `windows/README.md`）。

## 工程约定

- `.sh` 交付物：UTF-8 无 BOM + LF；禁止用 PowerShell 管道向 ssh 传脚本（PS 5.1 会注入 BOM/CRLF），统一用 scp 或 git 分发；
- 私钥、Token 不入库；配置模板以 `.example` 结尾，实际配置由 `.gitignore` 排除；
- 服务器端脚本以 git 仓库为单一来源，服务器上通过 `git pull` 同步更新。