# 香港 VPS · 仿 DeepSeek 手机端聊天（H5）

> 2026-11-17 建。第一版是极简聊天框；第二版按主人要求**1:1 复刻 DeepSeek App 2.8.0 的界面与交互**（图标除外），
> 并且「只保留真正能用的按钮」。

## 一、访问

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

手机浏览器打开后加桌面（PWA，`display:standalone`）→ **全屏运行、没有地址栏**。

## 二、复刻对照（来自主人提供的 App 2.8.0 截图）

| DeepSeek 原件 | 这一版 | 状态 |
|---|---|---|
| 顶栏：☰ / 会话标题 / 朗读开关 / ⊕新对话 | 同 | ✅ |
| 空态：图标 + 「你好，我能帮什么忙吗？」 | 同（图标换成自己的） | ✅ |
| 用户气泡右对齐深灰圆角 | 同 | ✅ |
| 「已思考（用时 N 秒）>」可展开 | 同，实时先显示「思考中…」 | ✅ |
| 回答动作行：复制 / 赞 / 踩 / 朗读 / 重新生成 | 同，5 个全可用 | ✅ |
| 长按菜单：复制 / 选择文本 / 修改 / 分享 | 同（分享按浏览器能力决定） | ✅ |
| 底部输入：发消息 / 深度思考胶囊 / ⊕ / 语音 | 去掉语音（见下） | ⚠️ |
| 「内容由 AI 生成，请仔细甄别」 | 同 | ✅ |
| 侧边栏：搜索 / 置顶 / 今天·昨天·7天内 / 底部账号 | 同 | ✅ |
| 设置页：账户 / 应用 / 关于 / 退出 / 底部备案位 | 同，条目换成真能用的 | ✅ |
| 智能搜索胶囊 | **不做**（没有搜索 API，按「实现不了就别加」） | ❌ 故意 |
| 语音「按住说话」 | **不做**（Android WebView 不支持语音识别） | ❌ 故意 |

## 三、只加了真能用的按钮

- **复制**：`navigator.clipboard` + `execCommand` 双保险，实测写入剪贴板内容与回答完全一致
- **选择文本**：放开 `user-select` 后可长按选字
- **修改**：把用户那条截断并回填输入框，可改完重发
- **分享**：有 `navigator.share` 才出现
- **赞/踩**：本地存储
- **朗读 / 自动朗读**：有 `speechSynthesis` 才出现；顶栏喇叭是全局自动朗读开关（真的会读）
- **重新生成**：丢掉该条 AI 回复并重发上一条用户消息
- **停止生成**：`AbortController` 真中止
- **图片上传**：canvas 压到 1100px / JPEG 0.82 再传，实测模型能读出图里文字
- **深度思考**：真控制是否展示 `reasoning_content`
- **外观 / 字体大小 / 清空数据 / 清空卡密**：设置页里都是真生效的

## 四、架构

```
手机浏览器/PWA ──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
```

- 会话历史存浏览器 `localStorage`（**没有服务端数据库**），刷新/重开都在
- `x-opencode-session` 用会话 id，保证同一对话命中 prompt 缓存（实测命中后单次成本降到 1/16）

## 五、文件

```
/vol1/ai/projects/hk-chat/
├── app.py              # 后端：静态文件 + SSE 透传（python3 标准库）
├── web/index.html      # 界面
├── web/app.js          # 逻辑（会话/流式/长按/侧栏/设置）
├── web/manifest.json   # PWA：加到桌面后全屏无地址栏
├── hy-chat.service     # systemd 单元
├── nginx-hy-chat.conf  # nginx snippet
├── vps-setup.py        # 幂等安装脚本
├── .access             # 访问口令（600）
├── apikey.txt          # 上游密钥（600）
└── shots/              # 界面截图
```

VPS：`/opt/mchat/{app.py,web/}`，`hy-chat.service` enabled 开机自启。

## 六、踩过的坑

1. **htpasswd 权限**：`root:root 640` 让 nginx worker 读不到 → 500。必须 `chown root:www-data`。
2. **SSE 被 nginx 缓冲**：`proxy_buffering off` + `X-Accel-Buffering: no`，否则回答一次性蹦出来。
3. **后端 HTTP/1.0 收尾**：`BaseHTTPRequestHandler` 默认 1.0 + `Connection: close` 最省事，nginx 自己转 chunked。
4. **markdown 吃代码**：裸正则把 `**` 当粗体，`print(3**2)` 会被毁。必须先把代码块/行内代码抽成占位符。
5. **浅色主题下 CSS 优先级**：`html[data-theme=light] .pill` 会盖过 `.pill.on`，导致「深度思考」深蓝字压深蓝底看不见。
6. **长按菜单关不掉**：只监听遮罩层 `mbg` 时，键盘/脚本触发的点击关不掉 → 改成「点 .mbox 以外一律关」。
7. **CDP 截图抓到过渡中间帧**：侧边栏/设置页是 translateX 动画，截图常抓到半开 →
   加 `?noanim=1` 关掉所有 transition 再抓。
8. **无头浏览器 basic auth**：`Network.setExtraHTTPHeaders` 加 Authorization 头；设文件要传 `objectId`
   （`DOM.getDocument` 那条路拿不到 nodeId）。
9. **浏览器会话会僵死**：`Page.captureScreenshot timed out` 时换一个 session 名重开，别去杀别的标签。

## 七、还没做

- **没打 APK**：本机只有 JDK 17 + Node，没有 Android SDK。当前用 PWA 加到桌面实现「无地址栏」。
  要真 APK 得装 Android SDK（约 1.5G）+ Gradle，再写 WebView 壳。
- **没有计费/卡密校验**：设置页里的卡密只是本地保存，服务端还没校验额度。
- **没有服务端存历史**：换设备就没了。
- **收款监控（V免签那套）**：还没碰，计划支付宝先行。
