用户文档站

VitePress + Vue，中文首版，计划部署于 https://docs.getagentconsole.space/；本仓库改动不会自动上传服务器。

npm --prefix apps/docs ci
npm --prefix apps/docs run dev
npm --prefix apps/docs run build

将 apps/docs/.vitepress/dist/ 目录内部所有文件上传到文档域名的站点根目录。先配置 DNS、HTTPS 和该域名的静态站点，再上传官网入口页面。使用 .html 链接，无需 SPA rewrite；保留 assets/ 和 sitemap.xml，index.html 建议不长期缓存。

文档是使用说明，不包含开发者凭证或账号。修改 guide/*.md 后重新构建；官网 index.html 独立部署。首次安装无 lock 时使用 npm install，之后使用 npm ci。

发布顺序

1. 在 Cloudflare 添加 docs 的 DNS 记录，指向现有服务器。
2. 服务器建立独立静态站点并配置 HTTPS，站点目录上传上述 dist 内容。
3. 访问首页、/guide/install.html 和搜索，确认样式与图片正常。
4. 上传仓库 agent-console官网/index.html 到官网站点；导航和页脚的“使用文档”指向文档子域名。

更新时完整替换文档构建产物，保留当前构建的 assets 文件。运行中的本地 preview 在重新 build 后也应重启，避免引用旧资源。

实现与验证

独立 package 与锁文件避免影响桌面项目依赖。VitePress 1.6.4 使用 Vite 6.4.4 override，避开旧开发服务器依赖的安全报告；生产部署只上传静态文件。 已验证生产构建、1440px/390px 深浅主题、中文全文搜索和手机文档导航。内容按 0.1.2 已有功能编写，平台与账号验证边界明确标注。