这个网站怎样运行

这是现有 humanoid-study 学习笔记的本地项目与技术文档网站，使用开源 VitePress 1.6.4 构建。Markdown 仍是内容来源，侧栏、全文搜索、文档目录和代码排版复用框架；首页与视频页是少量 Vue 展示组件。没有建立账号系统、数据库或云服务。

现在需要花钱吗

不需要购买服务器，也不需要域名。 本地方式由当前电脑运行网站服务，浏览器通过 http://127.0.0.1:4173 访问。这个地址只指向当前电脑，不是公网网址；网站运行需要电脑开机且服务进程存在。

域名是好记的地址，服务器是运行或存放网站的设备，两者不是一回事。静态网站可以放在当前电脑、未来的NAS，或支持静态网页的托管平台。是否购买域名，等真的需要对外访问时再决定。

本机打开和关闭

当前工作区的一键入口：

bash /home/z/bridge/site.sh start
bash /home/z/bridge/site.sh status
bash /home/z/bridge/site.sh stop

打开 http://127.0.0.1:4173。运行日志位于学习仓库 .site-runtime/preview.log，该目录不会进入Git。

修改 Markdown 后重新构建：

bash /home/z/bridge/site.sh build
bash /home/z/bridge/site.sh stop
bash /home/z/bridge/site.sh start

开发时需要保存即刷新，可运行 bash /home/z/bridge/site.sh dev，并按终端地址访问。网站的Node依赖独立于机器人的Python训练环境。

笔记和视频放在哪里

• 笔记源文件：/home/z/humanoid-study/*.md 与 experiments/。
• 网站配置、样式与组件：.vitepress/。
• 视频与封面：assets/videos/、assets/posters/；assets/media.json保存来源、时长和哈希。
• 构建结果：.vitepress/dist/，不会进入Git。
• public/assets和public/experiments/evidence是指向既有资料的相对符号链接，用于保留原来的网址；不复制一套笔记源文件。

视频页读取媒体清单。新增录像先确认文件、类型、来源及完整时长，再更新清单；失败实验和运动学参考必须保持各自身份。首页的进度是注明日期的学习快照，不是实时监控训练状态。

以后搬到 NAS

将构建后的 .vitepress/dist/ 整个目录交给NAS上的静态网页服务即可。相对资源路径不依赖这台电脑的 /home/z/；模型和大权重不需要跟网站一起搬。

网站代码与锁定依赖保存在学习Git仓库，生成结果可随时重建。NAS上的文件服务、反向代理或容器按届时设备支持选择，不需要现在购买。

公开展示

本机访问与 Cloudflare Pages 公网托管独立。Pages 项目地址为 dqx46-robotics.pages.dev，每次部署只上传构建后的网页与媒体；GitHub 源码仓库继续保持私密。本地启动或关闭服务不影响线上版本。

个人展示与 GitHub Pages

展示定位：机器人算法项目作品集与技术文档。首页直接呈现研究对象、技术栈、个人适配工作、实验结果和验证状态；不使用励志口号、培训课程宣传或闯关式文案。技术学习内容保留在文档中。涉及待完成能力时明确标注计划，不编造项目指标、工作履历或实机成果。回放按已训练策略在前、失败寄录在后分区；“寄”为用户指定的命名，保留此字。页面不使用个人背景标签。

后续个人站地址可采用 https://dqx46.github.io/ ，对应仓库名为 dqx46.github.io。也可部署为项目站 https://dqx46.github.io/humanoid-study/ ；此时需要把 VitePress 的 base 设置为 /humanoid-study/ 并重新构建。

GitHub Pages 提供静态网页托管，采用默认 github.io 地址无需购买域名或独立服务器。按 GitHub 当前规则，免费账户使用公开仓库；支持从私密仓库发布的付费方案另有要求。可保留现有私密研究仓库，另建公开展示仓库，只发布适合公开的网页、视频和文档。当前没有创建 GitHub Pages 的公开展示仓库，已选择 Cloudflare Pages 作为托管目标。

官方依据：Pages 类型与默认网址、建站与仓库可见性要求。

Cloudflare Pages 部署（2026-10-20）

已安装并锁定 Cloudflare 官方 Wrangler，项目配置见 wrangler.toml。采用 Direct Upload：本机构建后只上传 .vitepress/dist 中的静态网页与媒体，不修改 GitHub 仓库的私密属性。

首次使用需在 Cloudflare 官方页面登录并授权。所需范围为账户读取、用户读取、Pages 项目读写，以及用于续期的 offline_access；不申请 DNS、R2、D1 或 Workers 脚本管理权限。

通过现有工作区入口使用原生 Wrangler：

# 登录：授权页面由 Wrangler 提供
bash /home/z/bridge/site.sh cloudflare login --scopes account:read user:read pages:write

# 核对账户与已有项目
bash /home/z/bridge/site.sh cloudflare whoami
bash /home/z/bridge/site.sh cloudflare pages project list

# 首次创建项目；已有同名项目时不重复创建
bash /home/z/bridge/site.sh cloudflare pages project create dqx46-robotics --production-branch main --force

# 每次发布前构建，然后上传
bash /home/z/bridge/site.sh build
bash /home/z/bridge/site.sh cloudflare pages deploy .vitepress/dist --project-name dqx46-robotics --branch main

Cloudflare 已确认项目名为 dqx46-robotics、项目域名为 https://dqx46-robotics.pages.dev/。首次创建项目时 Wrangler 4.151.1 的 --force 用于选择 Pages，避免该版本对新项目的 Workers 自动委派；项目存在后，后续发布命令不需要 --force。

Direct Upload 项目不能直接切换为 Git integration；如需自动化，可继续使用官方 Wrangler 接入 CI。官方流程：Direct Upload。

已完成账户登录与 Pages 项目创建。运行上面的部署命令后，应以 Cloudflare 返回的部署结果和线上页面验证判断是否发布成功；项目地址存在不代表某次更新已完成。