# 香港 VPS · 极简 DeepSeek 聊天页（验收版）

> 2026-11-17 搭建。主人原话：「先走一次香港的vps试一下，你给我做一个只有对话功能的网页端，
> 要能展示思考过程、显示网络延迟、上传图片，不用豪华，要有这些功能，我体验一下」

## 一、访问方式

```
地址： https://hk.hynixing.cn/chat/
账号： hy
密码： th93wr2tbm          （也写在 /vol1/ai/projects/hk-chat/.access）
```

用的是 hk.hynixing.cn 现有的 Let's Encrypt 证书，路径 `/chat/` 挂在 nginx 上，
原有验收页、`/dl/`、`/sub/`、xray WS、hysteria2 **一条都没动**。

## 二、有什么功能

| 功能 | 实现方式 |
|---|---|
| 对话 | 流式 SSE，客户端直连 `/chat/api/chat` |
| 展示思考过程 | 解析上游 `delta.reasoning_content`，实时显示、答完自动折叠成「思考过程 · N 字」 |
| 显示网络延迟 | 每 5 秒打一次 `/chat/api/ping`，绿 <120ms / 黄 <350ms / 红；每条回答下方另有「首字延迟」和「总用时」 |
| 上传图片 | 前端 canvas 压到 1200px、JPEG 0.82 再 base64 上传；后端原样转给上游视觉接口 |
| 花费显示 | 读上游 `usage.opencode.list_cost` / `allowance` / `cached_tokens` |

额外送了：最简 markdown（粗体、行内代码、代码块）、多轮上下文、「新对话」按钮（同时换 `x-opencode-session`）。

## 三、架构

```
手机浏览器 ──HTTPS──> nginx:443 (hk.hynixing.cn, LE 证书, basic auth)
                          └─ /chat/ ──> 127.0.0.1:8090  python3 app.py（标准库，无依赖）
                                            └─HTTPS──> opencode.ai/zen/go/v1/chat/completions
                                                          model: deepseek-v4.1-flash
                                                          billing_source: go（吃 Go 订阅额度）
```

- 费用全部记在 **opencode Go 订阅**（$10/月，DeepSeek V4.1 Flash 月限额 $100 等效用量）
- `x-opencode-session` 由前端 localStorage 生成并稳定复用 → 同一会话命中 prompt 缓存（实测命中后单次成本降到 1/16）

## 四、文件位置

本地（NAS，源头）：
```
/vol1/ai/projects/hk-chat/
├── app.py               # 后端，SSE 透传代理（python3 标准库）
├── index.html           # 整个前端，单文件
├── hy-chat.service      # systemd 单元
├── nginx-hy-chat.conf   # nginx snippet
├── vps-setup.py         # 幂等安装脚本（插 include + 写 htpasswd）
├── .access              # 访问口令（600）
└── apikey.txt           # 上游密钥（600，别外传）
```

VPS 上：
```
/opt/mchat/{app.py,index.html,apikey.txt}
/etc/systemd/system/hy-chat.service        # enabled，开机自启，Restart=always
/etc/nginx/snippets/hy-chat.conf
/etc/nginx/.htpasswd-chat                  # root:www-data 640（nginx 要能读，644 root:root 会 500）
/etc/nginx/sites-available/hk.bak-hychat   # 改动前的 nginx 备份
```

## 五、实测数据（2026-11-17，NAS ⇄ VPS）

| 项 | 值 |
|---|---|
| TCP 握手 / ICMP RTT | 362~376 ms（稳定） |
| 丢包 | 5%（20 发包测）；偶发突发时 TLS 握手会拖到 2~6 秒 |
| 同连接 ping（keep-alive） | 368 ms |
| 全新 TLS 握手 | 0.7~2.1 s（TLS1.3 一轮 RTT 正常值 ~0.7s，慢的是丢包重传） |
| 首字延迟（含思考） | 1.5~2.9 s（大头是上游模型出第一个 token，不是网络） |
| 一轮对话花费 | $0.0001~0.0003（≈ ¥0.0007~0.002） |
| 缓存命中效果 | 1595 输入里 1536 命中，单次成本 $0.000482 → $0.0000305 |

## 六、踩过的坑（下次直接看这里）

1. **htpasswd 权限**：`root:root 640` 会让 nginx worker（www-data）读不到 → 500 Internal Server Error。
   必须 `chown root:www-data` + `chmod 640`。
2. **SSE 被 nginx 缓冲**：snippet 里必须 `proxy_buffering off; proxy_cache off;`，后端再补 `X-Accel-Buffering: no`，
   否则回答会一次性蹦出来而不是逐字。
3. **后端用 HTTP/1.0 收尾**：`BaseHTTPRequestHandler` 默认 1.0，配 `Connection: close` 最简单，
   nginx 自己会转成 chunked 给浏览器；不要试图手写 1.1 chunked。
4. **markdown 吃代码**：裸正则把 `**` 当粗体，`print(3**2)` 会被毁成 `3<strong>2</strong>`。
   做法是先把代码块/行内代码抽成占位符，处理完再填回。
5. **basic auth 在无头浏览器里的调法**：`Network.setExtraHTTPHeaders` 加 Authorization 头；
   设文件用 `DOM.setFileInputFiles` 必须传 `objectId`（`DOM.getDocument` 那条路在这套 CDP 里拿不到 nodeId）。
6. **CDP 5 秒超时**：`js()` 里 await 超过 5 秒的 Promise 会超时，连续采样要控制在 3 次以内。

## 七、下一步（未做）

- 没有计费 / 用户体系 / 兑换码 —— 这是纯验收版，只有一个账号口令
- 没有落库，刷新页面即丢历史
- 上游就一个 Go 订阅，5 小时窗 $20 额度（DeepSeek Flash 约 43,330 轮/5h，官方估算）
- 要转向卖钱，还需要：new-api 网关 + 用户额度 + 卡密 + 收款通道（见
  `/vol1/ai/agents/hermes/reports/DeepSeek客户端-施工方案v1.md`）
