笔记不是手册全集

这个 blog 最早五篇是 Git、npm、Markdown、MC 服、团队规范。日期在 2025 年 7 月到 12 月那一带，口吻是手册：工作区怎么进暂存区、git push、PowerShell 的 mkdir 没有 -p、npm 怎么装、Markdown 标题怎么写、MC 服怎么登录、WenZhenGuardian 的分支名怎么起。当时给自己和同学。同学问，把链接丢过去，比当场再讲一遍分支保护省事。官方文档比我全。我写的是当时这台机器和这个团队用得上的那一截。

后面这些是做东西时留下的痕迹。课：47/452、课设 100、撞周、睡眠切段。赛：国创北京赛区一等、海淀展 A-53、黑西装手心湿。项目和实习在更早的帖里各有各的仓库名字。跑：5 公里 18′20，马拉松无成绩。生活：汉服、白 T、茶桌、山、西土城路。站点：不能 Remix Framer、必须 bundle exec、缺 nbconvert 就 exclude assets/jupyter/、简历源在 typst、首页数字要指回 edu-honors-summary、邮箱两封、favicon 陶土红。痕迹不是手册全集。全集要跟版本走，Git 官方手册会更新，我这份会过期。过期的命令留着当考古可以，当教程会害人。

100 篇看起来很多。每篇只负责一件事。一件事写完就停。停的意思是：不要在「不要在 $HOME 里改项目」里顺便教完 pnpm；不要在茶桌页里塞国创一等奖的完整漏斗；不要在 favicon 篇里重写皮肤方案。漏斗有自己的帖，皮肤有自己的帖。交叉引用可以，把另一篇的完成标准搬进来不行。搬进来字数会虚高，事实会重复到互相打架。打架的典型是：生活页写了奖，奖项页又把生活当证据。茶桌和山明确不对应奖项。写痕迹的时候要把这句守住。

手册口吻和痕迹口吻不要混在同一篇的主干里。最早五篇可以继续保留命令、列表、流程图。后面这些用第一人称场景：哪一周撞了，哪张照片进了哪一页，哪条命令在仓库根才能跑。场景里如果出现命令，命令要真：

bundle exec jekyll serve --host 127.0.0.1 --port 4000

假命令比没有更坏。假命令会让以后的自己在答辩前浪费一小时。真命令也只写限制，不写「从零到一搭建个人站」。搭建请看 al-folio 的 INSTALL。我只写这台机器上多出来的限制：brew ruby@3.3、代理 7890、没有 timeout、rg 经常没有、jupyter exclude、不要在家目录开工。限制是痕迹。痕迹够用。

课赛仍会来抢写笔记的时间。笔记不是任务系统。撞周先冻课设、先保演示，站点 blog 排后。排后时不要用手册体连夜补十篇「知识管理」。知识管理没有验收。验收在卷面、在 47/452、在 typst 那几行、在演示当场能不能收。blog 写到能让以后的自己少踩同一处即可。少踩的那些处，往往是工具和口径：cwd、一个仓库、数字指回简历、Under Review 不写中、电话不放站点、汉服是自己的、国创是北京赛区一等。口径写进痕迹，比写进一百页教程安全。教程会诱人扩 scope。痕迹写完就停。

所以这篇的完成标准是把 blog 的任务说清楚：最早五篇是手册残留；后面是课赛站点和生活的痕迹；不追求全集；每篇一件事；官方文档更全的部分不重复造。读者如果想学 Git，去官方。想知道我为什么首页放汉服、页脚写西土城路、数字为什么是 2、7、4 加两个校级，读对应的帖。对应的帖读完，不要期待这里还有隐藏的证书。没有。证书在简历 PDF 里。PDF 的源在 typst。站点只是抄件加照片加这些句子。句子写满一件事，就结束。结束之后去睡第二段，或者去操场，或者去改真正的仓库。真正的仓库一次仍只开一个。

手册已经有五篇

Git、npm、Markdown、MC 服、WenZhenGuardian 规范，是给自己和同学用的短手册。后面这一百篇是课、赛、项目、实习、跑和这张网站留下的痕迹。官方文档比我全的部分，我不重写。重写会过期，过期的命令比没有更坑。

一篇只停在一件事

扩成正常篇幅，是为了把过程写完，不是为了把相邻的十件事塞进来。赛的过程写赛，切仓的过程写切仓。写完就停。停在限制上：没跑的数不写，没登记的爱好不写成经历，Under Review 不写成中了。 官方文档会更新。我这页不会跟着 npm 每个小版本改。要查命令，去官方。要查我当时怎么踩坑，才来这里。踩坑有日期。日期过了，命令以当时本机为准，不以这篇当永恒手册。永恒手册是那五篇里还在用的部分，其余以仓库现场为准。