Files
ai-soulmate-local-deployment/docs/CLIENT-WORKSTATION-HARDWARE-BASELINE.md
T

129 lines
7.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# AI SoulMate Client 工作站硬件基线报告
- 采集时间:2026-08-10 15:37(Asia/Shanghai)
- 采集对象:AI SoulMate Client(农场端)工作站
- 主机名:`HP`
- 采集方式:通过 Tailscale + SSH 执行 Windows 本机只读命令
- 使用阶段:本地部署适配、功能跑通与轻量压力测试
## 1. 结论
这台工作站可以用于 AI SoulMate Client 农场端的功能部署和低并发验证,但不适合本地三维模型推理,也不适合作为高并发或长期生产环境的性能代表机。
当前主要限制是 **2 核 4 线程 CPU 和 8GB 单条内存**。Windows 在采集时只剩约 2.56GiB 可用内存,而 Client 还需要运行 PostgreSQL、Java 后端、前端/Nginx 和容器运行时。因此本次应采用轻量资源限制、避免在工作站本地反复构建镜像,并优先把内存升级到 16GB。
当前判定:
- 功能跑通:可以开始,但需先启用 WSL2 并安装 Docker Desktop。
- Client 低并发 POC:可以,需限制容器资源并持续观察内存。
- Client 容量结论:暂不能给出,需部署后按固定场景压测。
- Tripo 3D:继续调用外部 API;本机不承担模型推理。
- 客户生产方案:不能直接照搬这台工作站的配置与测试数字。
## 2. 实测硬件清单
| 项目 | 实测结果 | 适配判断 |
| --- | --- | --- |
| 整机 | Lenovo Baiying `NUC13 Yes`,x64 物理机 | 小型农场端工作站形态 |
| 操作系统 | Windows 11 家庭中文版,64 位,版本 `10.0.26200` | 可使用 WSL2 + Docker Desktop |
| BIOS | `YSDLP03.107` | 已开启 CPU 虚拟化能力 |
| CPU | AMD Athlon Gold 3150C with Radeon Graphics,2 核 4 线程,标称最大 2.4GHz | 功能验证可用;构建和并发能力较弱 |
| 虚拟化 | Firmware virtualization = `True`,SLAT = `True` | 满足 WSL2 的硬件前提 |
| 内存 | 1 × 8GB DDR4-2666,实际配置频率 2400MHz,系统可识别约 7.45GiB | 当前最大风险;建议升级到 16GB |
| GPU | AMD Radeon Vega 3 集成显卡,系统报告 512MiB 显存,1920×1080 | 只用于显示;无 CUDA,不承担本地 3D 推理 |
| 系统盘 | Netac G537N2 256G SATA SSD,物理容量约 238.5GiB | POC 可用;镜像、日志和模型文件需限额 |
| SSD 健康 | Windows 报告 `Healthy / OK` | 未见直接故障信号,但不是完整 SMART/寿命检测 |
| 有线网卡 | Realtek PCIe GbE Family Controller | 建议正式运行时使用千兆有线网络 |
| 无线网卡 | Realtek 8821CE 802.11ac | 当前可用,吞吐和稳定性不宜作为生产基线 |
## 3. 存储与当前资源
| 盘符 | 总容量 | 可用空间 | 当前用途建议 |
| --- | ---: | ---: | --- |
| `C:` | 约 150.05GiB | 约 110.49GiB | Windows 与应用程序 |
| `D:` | 约 87.32GiB | 约 87.23GiB | 优先用于 Client 数据、Docker 数据和部署文件 |
采集瞬间 CPU 负载约 27%,可用物理内存约 2.56GiB。瞬时值不能代表稳定负载,但说明 8GB 内存余量较小。部署时应保证磁盘至少保留 20GiB 可用空间,并设置日志轮转和 Docker 镜像清理流程。
## 4. 网络与远程维护
| 项目 | 状态 |
| --- | --- |
| 局域网 WLAN 地址 | `192.168.3.162` |
| Tailscale 地址 | `100.111.151.72` |
| Tailscale 主机名 | `ai-soulmate-workstation` |
| SSH | 已启用并验证密钥登录 |
| 中心服务器 Tailscale | `100.81.206.1`(`ai-soulmate-lab`) |
| 中心服务器业务地址 | `192.168.3.102`,已通过 Tailscale 子网路由访问 |
农场端即使换到其他网络,Tailscale 地址通常仍保持不变;局域网地址可能变化。远程运维应优先使用:
```powershell
ssh -i "$env:USERPROFILE\.ssh\id_ed25519_ai_soulmate_workstation" hedon@100.111.151.72
```
不要把 SSH 22 端口直接暴露到公网。局域网和 Tailscale 防火墙规则应继续限制来源范围。
## 5. 容器运行前置状态
| 检查项 | 当前状态 | 下一步 |
| --- | --- | --- |
| BIOS 虚拟化 | 已启用 | 无需修改 BIOS |
| SLAT | 支持 | 满足 WSL2 前提 |
| `VirtualMachinePlatform` | 未启用 | 启用后重启 |
| `Microsoft-Windows-Subsystem-Linux` | 未启用 | 启用后安装/更新 WSL2 |
| Docker CLI | 未安装 | WSL2 就绪后安装 Docker Desktop |
| Docker Engine | 未运行 | 安装后验证 `hello-world` 与 Compose |
以上两行是硬件采集时的初始状态。随后已完成前置环境安装并复核:
- `HypervisorPresent=True`。
- WSL 与 `VirtualMachinePlatform` 均为 `Enabled`。
- WSL 版本 `2.7.11.0`,默认 WSL 版本为 `2`。
- Docker Desktop `4.85.0`,Docker Engine `29.6.2`,Compose `v5.3.1`。
- Docker 使用 Linux 引擎,报告可用内存约 3.55GiB、4 个逻辑 CPU。
- 已通过 `docker run --rm hello-world`,并配置镜像源 `https://docker.m.daocloud.io/`。
因此,工作站已经具备运行 Client Linux 容器的基础条件;Client 应用镜像和本地 PostgreSQL 尚未启动。
当前尚未进入 Client 容器启动阶段。现阶段只是完成了远程维护通道、Client 本地部署分支和工作站硬件验收。
## 6. Client 部署资源建议
在 8GB 内存不升级的前提下,建议采用以下 POC 起始预算:
| 组件 | CPU 上限起点 | 内存上限起点 | 说明 |
| --- | ---: | ---: | --- |
| Client PostgreSQL | 0.5 CPU | 512MiB | 只存农场端本地业务数据 |
| Client Java 后端 | 1.0 CPU | 1024MiB | JVM 堆建议先限制在 512MiB 左右 |
| Client 前端/Nginx | 0.25 CPU | 128MiB | 使用生产静态文件,不运行 Vite 开发服务器 |
| WSL2/容器总预算 | 不超过 1.5 CPU | 约 3GiB | 为 Windows、SSH、Tailscale 和打印程序保留余量 |
这些值只是防止工作站失去响应的起始保护值,不是性能调优结论。镜像构建的峰值内存会明显高于运行时,优先在中心服务器或开发机完成构建,再把固定版本镜像传到工作站。
## 7. 风险与优先级
| 优先级 | 风险 | 影响 | 处理建议 |
| --- | --- | --- | --- |
| P0 | 仅 8GB 内存 | Docker、Java、数据库与 Windows 争用内存,可能卡顿或 OOM | 最优先升级到 16GB;升级前严格限制资源 |
| P0 | WSL2 与虚拟机平台未启用 | Docker Desktop 无法运行 Linux 容器 | 启用功能并重启后再安装 Docker |
| P1 | 2 核 4 线程低功耗 CPU | 构建慢,多任务和并发能力有限 | 避免本机构建;低并发逐级加压 |
| P1 | 单块 256GB SSD | Client 数据、镜像、日志共享容量且无冗余 | 使用 `D:`、限制日志并备份业务数据 |
| P1 | 当前使用 Wi-Fi | 文件上传和打印任务可能受无线抖动影响 | 能接网线时改用千兆以太网 |
| P1 | 集成 GPU、无 CUDA | 无法代表本地 AI 推理工作站 | Tripo 继续走 API,本机只运行业务 Client |
| P2 | 未采集温度与完整 SMART | 暂不能判断长时间满载散热与 SSD 寿命 | 压测阶段补采温度、磁盘延迟与错误计数 |
## 8. 推荐实施顺序
1. 启用 WSL2 和虚拟机平台,重启工作站。
2. 安装并验证 WSL2、Docker Desktop 和 Docker Compose。
3. 把 Client 源码与脱敏环境模板部署到工作站,真实密钥只保存在工作站 `.env`。
4. 采用固定版本镜像启动 PostgreSQL、Client 后端和前端。
5. 验证工作站到中心服务器 `192.168.3.102:8080` 的 API 访问。
6. 完成登录、任务获取、模型/文件下载、打印任务和断线恢复测试。
7. 记录空闲资源基线,再进行低并发、逐级加压和长稳测试。
## 9. 报告边界
本报告不记录序列号、MAC 地址、账号、密钥或环境变量秘密。本次只使用 Windows 系统可读取的硬件和健康状态,没有拆机,也没有执行内存压力测试、完整 SSD SMART 检测、温度采集或长时间负载测试。因此“SSD Healthy”只表示当前 Windows 存储状态未报告故障,不等同于生产级寿命保证。