行途个人站 · 从 0 到 1 白盒教程

2026-08-19 实录｜全程 3 小时｜目标：https://xingtu1996.pages.dev 上线 + 知识库 Git 化 + GitHub 品牌统一｜原则：不黑盒，每一步的工具 / 命令 / 提示词 / 原理全部摊开

〇、总览：8 个阶段一张图

图 1：主线 8 阶段（时间线标注为 2026-08-19 实测节点）。每阶段下方卡片给出「目标 / AI 工具 / bash / skill / 提示词 / 输出 / 坑」。

一、阶段拆解（白盒）

1需求澄清：买域名到底用来干嘛

目标把「想买域名」收敛成「用途 + 托管策略」两个明确选择

AI 工具AskUserQuestion（交互式澄清，不猜）

提示词（boss）「我要买 1 个域名」+ 指南转发；「考虑长远 + MVP 双轨，关心免费方案和坑」

输出双轨方案：现在免费 MVP，将来国内备案拿搜一搜 SEO

白盒点：为什么先问？因为「域名买来干什么」决定后缀（.cn 备案 / .dev 免备案）和成本，不问就动手是黑盒。

2域名调研：核实指南 + 撞名证据链

AI 工具WebSearch×3 并行（续费价/实名范围/隐私保护）＋WebFetch（抓 xingtu.com/.cn 身份）＋Bash whois（批量查占用）

skill无（纯 Web + 终端）

关键命令

whois -h whois.nic.google xingtu.dev        # 查 Google 系后缀
whois xingtu1996.com                          # 查 .com
curl -s https://rdap.nic.google/domain/xingtu.dev   # RDAP 标准接口

关键发现xingtu.com=兴图新科；xingtu.cn=字节巨量星图；拼音 xingtu 撞兴图/星途/星图 → 高度拥挤

白盒点：whois 是注册局的真实数据库，不是注册商「建议页」（Spaceship 那页全是溢价 upsell）；RDAP 是 ICANN 标准 HTTP 接口，whois 服务器不通时的替代。

3决策：为什么是 xingtu1996

图 2：域名决策树。左支=品牌资产路线（保留行途，加 1996）；右支=免费 MVP 路线。

4建站 MVP：单文件零依赖作品集

AI 工具Write（生成 index.html / README.md / deploy.sh）＋Bash git（init/commit）

关键命令

git init && git branch -M main
git add -A && git commit -m "feat: 行途 XingTu MVP 作品集"
git remote add origin git@github.com:xingtu1996/xingtu-site.git

设计原则纯静态、无构建、内容数组化（改 index.html 底部 JS 数组即更新文章/视频/开源入口）

白盒点：为什么零依赖？Cloudflare Pages 直接托管静态文件，无构建=零成本+零构建报错；内容数组化=非技术人也能维护。

5GitHub 品牌统一：xingtutech → xingtu1996

AI 工具WebFetch（绕过缓存实测用户名）+ Bash curl（GitHub API 查创建时间）

关键命令

curl -s https://api.github.com/users/xingtu1996 | grep created_at   # 查账号年龄
# 改名：Settings → Account → Change username（官方规则：旧名立即释放）

白盒结论改名已生效；旧主页永久 404 是官方行为；1996 = 时间戳资产（「出厂日期」），不进显示名

6授权与推送：gh + SSH 双通道

skillgithub（gh CLI）+ agent-browser（登录表单，最终因沙箱限制由 boss 手动）

关键命令

# 授权（走代理，因为直连 github.com 不通）
HTTPS_PROXY=http://127.0.0.1:7897 gh auth login -h github.com
echo 'github_pat_...' | gh auth login --with-token -h github.com   # 备选：PAT 方式
GH_HOST=github.com gh repo create xingtu1996/xingtu-site --private   # 建仓（强制走 github.com）
ssh -T git@github.com                                                # SSH 验证
git push -u origin main                                              # 推送（SSH 走 443+代理）

坑gh 默认走公司主机（github.cn-pgcloud.com）→ 必须 GH_HOST=github.com；设备流需 POST github.com → 直连超时 → 走代理或 PAT

白盒点：这台机器「直连 github.com 不通、走 127.0.0.1:7897 代理通」（curl 实测 000 vs 200）；SSH 用 443 + ProxyCommand 已配好 → 推送走 SSH 最稳。

7Cloudflare Pages 部署：API 建项目 + wrangler 上传

AI 工具Bash curl（验证 token / 建项目）+ wrangler（部署）

关键命令

curl "https://api.cloudflare.com/client/v4/user/tokens/verify" -H "Authorization: Bearer $CF_TOKEN"   # 验 token
ACCT_ID=$(curl -s "https://api.cloudflare.com/client/v4/accounts" -H "Authorization: Bearer $CF_TOKEN" | grep -oE '"id":"[a-f0-9]{32}"' | head -1 | cut -d'"' -f4)
curl -X POST "https://api.cloudflare.com/client/v4/accounts/$ACCT_ID/pages/projects" \
  -H "Authorization: Bearer $CF_TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"xingtu1996","production_branch":"main"}'
CLOUDFLARE_API_TOKEN=$CF_TOKEN npx -y wrangler pages deploy . --project-name=xingtu1996

坑token 缺 Account Settings Read → wrangler 列不出账号；wrangler 4 首次建项目非交互报错 → 先 API 建项目再 deploy

白盒点：wrangler「自动识别账号」= 调 GET /accounts；token 权限决定它能不能看到账号。看懂 API 依赖，就知道为什么报错、怎么解。

8上线 + 验证

验证命令

curl -sI https://xingtu1996.pages.dev   # HTTP 200
curl -s https://xingtu1996.pages.dev | head   # 返回真实首页内容

结果自动 HTTPS ✅ 免备案 ✅ 永久免费 ✅；源代码在私有仓库 xingtu1996/xingtu-site，后续 git push 可接自动部署

二、工具总表（谁负责什么）

工具/能力	本教程中干的事	什么时候用
AskUserQuestion	澄清用途/托管，不瞎猜	需求有分支选项时
WebSearch	核实价格/规则/商标	需要最新事实
WebFetch	抓站点身份、查用户名占用	看页面内容/身份
Bash + whois/RDAP	域名占用实测	域名可用性（不信注册商推荐页）
Bash + curl	GitHub/Cloudflare API、连通性测试	API 操作、网络诊断
Bash + git	init/commit/push	版本管理与推送
Write/Edit	建站、写文档、改台账	一切文件产出
skill: github	gh CLI 建仓/API	GitHub 自动化
skill: agent-browser	浏览器自动化（本环境受限）	登录/表单场景（环境允许时）
wrangler	Cloudflare Pages 部署	部署/CI

三、白盒要点速查（为什么）

现象	原理
直连 github.com 报错	网络直连 000，走 127.0.0.1:7897 代理 200 → 浏览器/gh 都要代理或走 SSH 443
gh 建仓跑公司服务器	gh 默认取「active 主机」→ 用 `GH_HOST=github.com` 强制
wrangler 报「列不出账号」	token 缺 Account:Account Settings:Read → 加权限或显式 CLOUDFLARE_ACCOUNT_ID
wrangler 非交互报错	首次部署要「确认建项目」→ 先用 API 建好项目再 deploy
浏览器自动关闭	沙箱在命令结束回收后台进程 → 跨命令自动化不可行，改单命令或人工
改名后旧链接 404	GitHub 官方规则：旧用户名释放、旧主页永久 404
为什么 1996 不进显示名	显示名=给读者记；handle=唯一标识层，两层职责不同

九、发布原理：不可变快照（白盒）

原理每次部署 = 一个不可变版本（类似 git commit）；Cloudflare 无服务器进程，文件存在边缘存储、全球 300+ 节点代为分发

专属 URL每次部署生成唯一地址（如 cd719a2c.xingtu1996.pages.dev），永久可访问，可回滚

白盒点：「发布」不是覆盖文件，而是「上传新快照 + 切换 production 指针」。这就是为什么改坏了能一键回滚，比 FTP 覆盖安全一个量级。

十、自定义域名绑定流程

前提先买真域名：xingtu.dev（~$12–15/年，大厂背书）或 xingtu1996.com（国内可备案）

步骤

控制台 → Workers & Pages → xingtu1996 → Custom domains → Add custom domain；
输入域名（如 xingtu.dev）→ 若 DNS 已在 Cloudflare 托管：自动加记录，等几分钟验证；
若 DNS 在别处（Namecheap/腾讯云等）：按提示加一条 CNAME：xingtu.dev → xingtu1996.pages.dev；
验证通过 → Cloudflare 自动签发 HTTPS 证书 → 生效；
可选：设为主域，pages.dev 保留或 301 重定向过去。

白盒点：自定义域的原理 = DNS 把域名「指到」Cloudflare，证书由 CF 自动管理（免费）；免备案（服务器在境外）。国内搜一搜 SEO 需另买 .cn 走 ICP 备案（7–20 天）。

十一、时间账本与 AI 提效（直观感受）

阶段	人工估算	AI 实际	提效	AI 干的是哪部分
① 需求澄清	0.1h	0.05h	×2	提问收敛选项
② 域名调研	3.0h	0.3h	×10	并行搜索+抓站+whois 实测+交叉验证
③ 决策	1.5h	0.15h	×10	批量查 13 个组合+年龄 API
④ 建站	4.0h	0.25h	×16	单文件作品集全量生成
⑤ GitHub 改名	1.0h	0.2h	×5	官方规则核实+账号年龄实测
⑥ 授权推送	1.5h	0.5h	×3	gh/SSH 配置+踩坑（含环境限制）
⑦ CF 部署	2.5h	0.3h	×8	token 权限排查+wrangler 流程
⑧ 内容沉淀	6.0h	0.7h	×9	教程/手记/复盘文档生成
合计	≈19.6h（2.5 工作日）	≈2.5h（半天）	≈8 倍	—

白盒点（诚实说明）：① 估算是「熟练者手工做」的量级，不是严格计时；② AI 用时含当日真实耗时（含踩坑）；③ 注册账号/登录/授权/改密/revoke 等"身份动作"AI 做不了，必须本人，约占实际总时间 30%——AI 提效的是"脑力活"，不是"身份活"。

行途 / XingTu · 实战派技术深耕者｜本教程为 2026-08-19 实录白盒复盘，所有命令真实可复现｜配套 MD 版见 02_内容仓库 (Content Hub)/行途个人站从0到1白盒教程_2026-08.md