L0 路由表 · 任务类型 → 必读篇目

怎么用：接任务后先花 30 秒在表里找一行，只读「必读」列指定的 1–2 篇，然后动手。不要一次读完全部 36 篇——那是 5 万 token，且 90% 与当前任务无关。

为什么需要它：两个月数据显示，每段对话前 5–10 轮平均花在「找代码在哪、端口是多少、谁反代谁」，单轮 50–100 万 token。这张表就是把这 5–10 轮压缩成 1 次读取（约 3000 token）。

---

一、路由表

任务类型	必读（1–2 篇）	不要读	关键铁律
改笔记站功能	笔记站 notes	词汇站、C-Lab	改完必须 build + 重启；.next 锁用 PowerShell 删
改门户或反代规则	门户 portal + 站群架构联系	各站细节	basePath 与反代必须同时改，只改一处必 404
改词汇站	词汇站 kaoyan-vocab	笔记站	该站不校验 x-portal-secret，别照搬笔记站写法
改 C-Lab / 题目台	C-Lab 与题目制作台	笔记站	端口 3103、前缀 /c-lab（不是 3200//lab）
构建 / 发布 / 回滚	Skill 方案 S3	对话档案	launch.ps1 必须 UTF-8 BOM；先按端口杀进程
站点挂了 / 巡检	Skill 方案 S1	架构篇	先判「进程死了」还是「隧道断了」，两者处置不同
隧道 / 域名 / HTTPS	站群架构联系 + 踩坑地图	功能篇	先做端口矩阵三对照；DNS 必须同时查 IPv4 与 IPv6
批量写笔记 / 入库	Skill 方案 S4	对话档案	走 wb-create.mjs；父节点用 /api/tree 挂，别手抄 id
文档 / 表格转换	Skill 方案 S5	架构篇	转换后必须校验行列数与公式数
整站长图	Skill 方案 S6	其他	等 document.fonts.ready 再截
新项目勘查	Skill 方案 S7	对话档案	输出 environment.md，端口/任务名必须实测
写复盘 / 总结	用户画像 + 任务完成度评判	架构细节	先给验收标准，再动笔

---

二、三条全局铁律（任何任务都适用）

1. 端口：门户 3000 / 词汇 3001 / 笔记 3102 / C-Lab 3103。改代码前先 Get-NetTCPConnection -State Listen 确认实际归属，不要假设。
2. 身份：所有站都由门户反代，直连必须带 x-portal-secret + x-user-id/username/role；门户会剥掉客户端自带的 X-User-*，伪造无效。
3. 数据：任何改动前先备份（notes/backups/ 或 .bak）；新规则上线必须给存量数据兜底，否则会出现「新数据好看、老数据崩」。

---

三、验收模板（每次动手前先交给用户确认）

交付物：3 项（路径可点开）
硬断言：3 条（命令 + 期望输出，自测后贴结果）
反向清单：不许动 X / Y / Z
边界样例：存量数据、空数据、异常输入各 1 例
回滚：一条命令或一个备份路径

---

四、五条开机命令（确认环境用，约 10 秒）

# 1 端口与进程
Get-NetTCPConnection -State Listen | ? {$_.LocalPort -in 3000,3001,3102,3103} | Select LocalPort,OwningProcess
# 2 计划任务
Get-ScheduledTask | ? {$_.TaskName -like 'Kaoyan*'} | Select TaskName,State
# 3 各站健康
'portal','vocab','notes','c-lab' | % { "$_ " + (curl.exe -s -o NUL -w "%{http_code}" "http://127.0.0.1:$(@{portal=3000;vocab=3001;notes=3102;'c-lab'=3103}[$_])/") }

# 4 公网可达（两条隧道）
curl -sS --noproxy '*' -o /dev/null -w "%{http_code}\n" https://cag.odn.cc/notes/
curl -sS --noproxy '*' -o /dev/null -w "%{http_code}\n" https://cag.quest/notes/

# 5 批量入库（写笔记时用）
node wb-create.mjs --file x.md --title "标题" --category "分类" --parent <parentId>

---

五、什么时候该读更多

只在三种情况下升级到 L2（细分篇）：

1. 按表读完后仍找不到落点（说明选错了篇目，换一篇，不要全读）。
2. 出现未记录过的报错（去踩坑地图按关键词搜，不是通读）。
3. 需要引用历史决策（去对话档案按时间找那一段）。

一句话：路由表负责让你少读，不是让你多读。