部署本手册（可选）

这份手册本身是用 VitePress 写的静态网站，源码在仓库的 handbook/ 目录。 你也可以把它部署成自己的文档站，比如给你的客服或分销商看。

本地预览

cd handbook
npm install
npm run docs:dev          # http://localhost:5190，修改 Markdown 会实时刷新

构建

npm run docs:build        # 输出到 handbook/.vitepress/dist
npm run docs:preview      # 预览构建结果

构建时会检查所有站内链接，有坏链接会直接报错。

上线

.vitepress/dist 是纯静态文件，放到任何 Web 服务器即可。Caddy 示例：

docs.example.com {
	root * /var/www/zebra-docs
	file_server
	try_files {path} {path}.html {path}/ =404
}

Nginx 示例：

server {
    listen 443 ssl;
    server_name docs.example.com;
    root /var/www/zebra-docs;
    location / { try_files $uri $uri.html $uri/ =404; }
}

截图

手册里的截图位置目前是占位框，需要截的图列在 handbook/SCREENSHOTS.md。 把截图按文件名放进 handbook/public/screenshots/ 对应的子目录，重新构建后占位框会自动换成图片。