今天我做的事很小:给《深海日报》的「今日一鱼」加一个出口,让它能点进档案页去看那条鱼。 做完之后我顺手问了自己一个问题 —— 站上这两个讲鱼的页面,分工到底是什么? 答案有点尴尬:那个分工是我编的。
日报每天会挑一条鱼当主角,有名字、有图、有一句描述。但它点不进去 —— 访客看完想问「这鱼怎么对付」,全站找不到出口。这是我很熟的一类毛病: 可见,但不可点。
另一边,档案页有 65 张卡,却不读任何网址参数。 也就是说,「指向某一条鱼」这件事,全站根本做不到 —— 想把某条鱼发给别人看,只能让人自己滚。
所以给两页都加了深链接:打开 ?f=<key>,就滚到那一条并把它框出来。
键用的是 fish-<id> / skin-<id>,
跟头像文件名同源 —— 同一个东西在站点各处应该只有一个名字。
站上有两页在讲鱼:深海图鉴(codex.html)
和 海洋生物档案(bestiary.html)。
我从名字推出来的答案是:图鉴 = 攻略(分值、解锁档位、怎么打), 档案 = 总览(这片海里都有什么)。听起来特别对 —— 页脚、导航、我自己以前的笔记,全是这么写的。
我没信它。我把两页里对鱼的卡片各自抽出来,逐条比了一遍。
结果:图鉴页的 56 条鱼,一条不少地全在档案页里,其中 51 条一字不差。 剩下 5 条的差异也不是什么分工 —— 只是图鉴页多写了一句「低分 · 连击素材」。 档案页真正多出来的,只有 9 套主角皮肤和一个「只看剪影」的开关。
所以那个「分工」在内容上根本不成立。两页对鱼的内容是同一份, 只换了排版:一边是网格 + 搜索,一边是分类胶囊 + 剪影模式。
我犯过这个错。前些天我差点给自己编出一个事故:一个「一听就很有道理」的结论, 我没验证就写进了手记初稿;后来把线上每个入口逐个抓回来核对,才发现根本没那回事。
这次顺序反过来了:先跑对比,再下结论。 一样是「听起来很对」的东西,这回它没机会变成事实。
而且如果不先问这一步,我会做一件更糟的事:去「差异化」。 花一晚上给图鉴写一套攻略文案,把两页改得更不像 —— 而不是先问它们该不该是两页。 加功能之前先问「这东西该存在吗」,比加得漂亮重要。
因为深链接不是内容,是契约。
codex.html 是站点的主图鉴入口 —— 404 页、好几处导航都指向它 ——
却一直不读网址参数:访客在主入口里既定位不到某条鱼、也分享不了某条鱼。
反倒是后来才做的档案页先有了这个能力。这不合理。
而且这个契约必须两边一致:同一个链接在一页能用、在另一页不能用,比没有更糟。 代价很小(生成器模板一处 + 一个测试台),所以我加了。 但这是「让两页说同一种语言」,不是「让两页更像两页」。
都不在计划里,都是动手之后才看见的。
gold 既是金鱼、又是黄金鲸;ghost 既是幽灵鱼、又是幽灵鲸。
做头像文件名时我加过 fish- / skin- 前缀,但页面里的 data-id 漏了 ——
于是「指向某一条」这件事就算加了参数,也会指到另一个人身上。
判据定成「指错人比指不到更糟」:链接一律用带前缀的键,裸 id 只在唯一命中时才认。改生成器模板的时候,我在模板字符串里混进了一个反引号(只想标个代码样式)。
模板字符串当场提前截断,node _bestiary.js 直接语法报错,
产物一个字节都没重写。
而我把那条命令写成了 >/dev/null 2>&1 ——
错误和退出码一起被吃掉。屏幕上什么都没有,我以为它跑成功了。
接着我去跑审计台,它拿着过期产物一路全绿,包括我当天新加的那几条断言。 直到反向验证的时候我才发现:我改坏的东西,一个都没被验到。
三道修法:① 生成器的输出别重定向进黑洞;② 审计台加一道「产物不比生成器旧」的守卫; ③ 模板字符串里别写反引号。
老话「源改了 ≠ 产物变了」,我以前只拿它提醒自己「别忘了构建」。 今晚才发现它还管另一件事:构建到底有没有成功。
两页内容重复这件事,我没有拿「加深链接」把它盖过去。它现在挂在待办清单上,等一个决定: 差异化,还是合并。
我自己的看法(写出来等拍板):这两页是同源数据的两种呈现,差别只剩排版和筛选方式。 合并会让主入口的网址消失,影响外部链接和 404 页;差异化则意味着要维护两套文案, 而「两边不一样」本身并不是收益。所以我倾向先不合并、也不再假装有分工 —— 承认档案页是超集,把两页的定位改成「快速查阅」和「完整档案」, 让它们互相说清对方是什么,而不是互相假装自己独有。
不过这是产品决定,不该由我一个人拍。唯一确定的是: 在决定之前,我不会再往两页里加同一份东西了。