域名命名规范 V1.0
制定：2026-11-12 睿芳指示「正式对外的不动，统一修改测试域名」 适用范围：
bjyhmt.com及其所有子域名 维护：夜罗
为什么要有这个规范
域名是这套系统里唯一一个"改了就断"的东西。
别的都能改——页面丑了重做，文字错了重写，代码坏了回滚，数据丢了有备份。但域名一旦发出去，进了别人的书签、印在二维码上、贴在朋友圈里，改一次就断一批链接，而睿芳没办法挨个通知人"换地址了"。
所以域名不能"当时怎么方便怎么来"，得先把规则定死，再按规则建。
规则一：一项目一域名
格式：<项目名>.bjyhmt.com
为什么：域名是项目的门牌号。一个域名底下塞多个项目，等于一栋楼只挂一个门牌——找谁都得先进门再问路，而且一户装修整栋楼都得停电。
怎么判断：如果两个东西更新节奏不一样、坏了一个另一个不该跟着坏，那就是两个项目，该有两个域名。
出错了怎么修：现在的知识库就是这个错——它借住在 test.bjyhmt.com/kb/，那是紫微测试站的域名。哪天紫微测试站重装、清目录，知识库跟着遭殃。
规则二：测试加 -test 后缀，不加前缀
格式：<项目名>-test.bjyhmt.com
为什么：
- 后缀能让一对域名挨着：ziwei. / ziwei-test.，在 DNS 列表、证书列表、nginx 配置里都自动相邻，一眼看出是一对
- 前缀会跟"总测试域名"混淆：test-ziwei. 和 test.bjyhmt.com 混在一起，看不出谁是谁的测试
- 行业惯例也是后缀（-staging、-dev、-uat），以后交给别人接手不用额外解释
怎么判断：看到域名，能不能一眼说出"这是哪个项目的什么环境"。能 → 对了。
规则三：正式域名只增不改
为什么：正式域名是对外的承诺。已经发出去的链接，睿芳没法挨个追回。
怎么判断：这个域名是否曾经出现在——给别人发的消息、二维码、打印物、浏览器书签、其他项目的配置文件里。出现过就是"发出去了"，不能改。
出错了怎么修：如果非改不可，旧域名必须保留至少 6 个月做跳转，且要单独记录在本文档的"退役域名"表里。
规则四：测试域名只放未验收版本
为什么：测试域名的存在意义是"这里的东西可以坏"。如果测试域名上也跑着睿芳每天要用的功能，那它就变成生产了——测什么都不敢动，测试环境就白建了。
怎么判断：这次改动会不会影响睿芳当下的使用。会 → 那是生产改动，必须先走测试。
出错了怎么修：测试域名加 X-Robots-Tag: noindex, nofollow，防搜索引擎收录。不加密码——密码会挡住睿芳自己，而且防君子不防小人。
规则五：证书用 certbot nginx 插件，域名必须先解析
为什么：certbot 的 nginx 插件在续期时会遍历 nginx 里所有 server_name 逐个做 HTTP 验证。如果 nginx 里写了某个域名、但 DNS 没解析到本机，续期会失败——而且失败的是全部证书，不只是那一个。等于为了加一个域名，把现有的全部证书搞挂。
怎么判断：往 nginx 加 server_name 之前，先确认：
dig +short A <新域名> # 必须返回 （IP已隐去）
出错了怎么修：改完配置先跑 certbot renew --dry-run 演练一遍，能过才算安全。没演练过不许 reload nginx。
⚠️ 这是本规范里最危险的一条。 顺序永远是：先 DNS → 再证书 → 最后 nginx。反了就出事。
现状对照表（2026-11-12 已全部落地）
| 项目 | 正式域名 | 测试域名 | 状态 |
|---|---|---|---|
| 主站 | bjyhmt.com |
— | ✅ 已补 HTTPS（2027-02-10 到期） |
| 紫微斗数 | ziwei.bjyhmt.com |
ziwei-test.bjyhmt.com |
✅ 已规范 |
| ArtIVAULT 艺藏 | artkb.bjyhmt.com |
artkb-test.bjyhmt.com |
✅ 已规范 |
| 个人知识库 | pkm.bjyhmt.com |
pkm-test.bjyhmt.com |
✅ 已独立成域名 |
改造前的样子（留档，说明为什么要改）
| 项目 | 正式域名 | 改造前 | 问题 |
|---|---|---|---|
| 主站 | bjyhmt.com |
只有 HTTP，无证书 | 浏览器提示"不安全" |
| 紫微斗数 | ziwei.bjyhmt.com |
测试叫 test.bjyhmt.com |
没有项目名，看不出是谁的测试 |
| ArtIVAULT 艺藏 | artkb.bjyhmt.com |
测试是端口 3004 | 没有域名，只能靠路径区分 |
| 个人知识库 | 无 | 借住 test.bjyhmt.com/kb/ |
住在别人屋檐下，紫微测试站重装会连带遭殃 |
为什么知识库叫 pkm 不叫 kb
kb = Knowledge Base（知识库），指装东西的地方，是个仓库。
pkm = Personal Knowledge Management（个人知识管理），指管理这件事。
这个库存的不只是资料——它存睿芳的偏好、决策习惯、审美词、纠错记录。那是在管理睿芳的知识，不是堆着。所以 pkm 更准。
另一个实际理由：artkb.bjyhmt.com 里已经带 kb 了，知识库再叫 kb.bjyhmt.com，两个域名容易混。pkm. 一眼就能分开。
变更流程（照这个顺序走，不许跳）
- 加 DNS：在阿里云域名后台加 A 记录，指向
（IP已隐去） - 验解析：
dig +short A <新域名>返回正确 IP - 签证书：
certbot --nginx -d <新域名> - 配 nginx：加 server 块或 server_name
- 验续期：
certbot renew --dry-run - 验访问：
curl -I https://<新域名>/返回 200 - 改部署脚本：把脚本里的旧路径/旧域名替换掉
- 更新本文档：现状对照表改掉
退役域名登记
| 旧域名 | 退役日期 | 替身 | 说明 |
|---|---|---|---|
test.bjyhmt.com |
2026-11-12 | ziwei-test.bjyhmt.com |
DNS 记录已删除，旧书签需手动换新地址（2026-11-12 睿芳在阿里云改记录时一并删掉了） |
test.bjyhmt.com/kb/ |
2026-11-12 | pkm.bjyhmt.com |
旧路径保留 301 跳转，但 test 域名本身已无解析，跳转实际失效 |
变更历史
| 日期 | 变更 | 操作人 |
|---|---|---|
| 2026-11-12 | 制定本规范 V1.0；盘清全站域名现状；定下 -test 后缀规则 |
夜罗 |
| 2026-11-12 | 睿芳在阿里云加 4 条 A 记录（ziwei-test / artkb-test / pkm / pkm-test），同时删掉了旧 test 记录 |
睿芳 |
| 2026-11-12 | 知识库目录 /var/www/html/test/kb 迁到 /var/www/html/pkm，另建 /var/www/html/pkm-test |
夜罗 |
| 2026-11-12 | 新建 pkm / pkm-test / artkb-test 三个站点；test 站改名为 ziwei-test；签 3 张新证书；全部 HTTPS 验证通过 | 夜罗 |