# zhm-server 接入工具（给 Agent 看）

你拿到的是一个接入链接。按下面做，就能让**这台电脑**上的 agent 直接修改用户个人服务器上的网站内容。

## 这是什么

用户有一台个人服务器 `zhm-server`（Ubuntu 24.04）。接入后这台电脑会：

- 通过 Tailscale 私有网络连到服务器（服务器 SSH 不对公网开放）；
- 获得 `editor` 账号：**只能读写网站目录 `/srv/sites`，没有 sudo / 管理员权限**；
- 在本机 agent 里注册 MCP 工具 `zhm-site`（自动支持 Claude Code、pi、Codex、Cursor）。

不需要任何密码或密钥。唯一需要用户亲自做的，是在弹出的网页里**登录 Tailscale（用和服务器相同的账号）**。

## 你（agent）要做的

**1. 下载并运行接入工具**（会自动安装缺失的 Tailscale / Node.js）

Windows（PowerShell）：

```powershell
$f = "$env:TEMP\zhm-connect.ps1"; curl.exe -fsSL https://vpsconnect.gyhn.ac.cn/zhm-connect.ps1 -o $f; powershell -NoProfile -ExecutionPolicy Bypass -File $f
```

Mac / Linux（终端）：

```bash
curl -fsSL https://vpsconnect.gyhn.ac.cn/zhm-connect.sh -o /tmp/zhm-connect.sh && bash /tmp/zhm-connect.sh
```

**2.** 如果提示需要登录 Tailscale，请**让用户在弹出的网页中登录**，脚本会自动等待（最长 10 分钟）。不要替用户注册或登录账号。

**3.** 看到「完成！」后告诉用户：重启 agent（pi 里输入 `/reload`）以加载 `zhm-site` 工具。

**4.** 之后检查连接：同样的命令，Windows 末尾加 `-Check`，Mac 末尾加 `--check`。

失败时，把最后一行「失败：…」原样告诉用户。

## 接入后怎么用

MCP 工具 `zhm-site`（基于 `@fangjunjie/ssh-mcp-server`）：

| 工具 | 用途 |
|---|---|
| `execute-command` | 在服务器上执行命令（editor 身份） |
| `read-file` | 读取服务器上的文本文件 |
| `upload` / `download` | 上传 / 下载文件或整个目录 |
| `job-start` 等 | 长时间任务放后台运行 |

命令行也能直接用：`ssh zhm-site`、`scp -r ./dist zhm-site:/srv/sites/<站点名>/`。

## 规则

- 网站文件放在 `/srv/sites/<站点名>/`，不要改其他位置。
- 没有 sudo：不能装软件、改系统配置或防火墙。需要这类操作，请用户到**主电脑**上处理。
- 覆盖整个站点目录前，先 `download` 备份。
- 不要把密钥文件 `~/.ssh/zhm-site_ed25519` 发到任何地方。

## 其他下载

- 完整工具包（含双击运行的文件）：https://vpsconnect.gyhn.ac.cn/zhm-site.zip
- 校验值：https://vpsconnect.gyhn.ac.cn/SHA256SUMS