← 返回《共创实战 · 行动案例》专栏目录
口 径 四 步 法 · C

一次收藏,永久有效:版本号不该出现在用户要点的地址里

「今天的报告有更新吗,链接不需要改变吧?」——必须如实回答:链接确实变了,因为每天产出的是带版本号的新文件。对方打开的是旧内容,而这不是"内容没更新",是更新了但没送到他手上。与上一条是同一种病。

2026-10-18 · 创业陪跑Lab · 行动案例 032 素材来自 2026 现场 阅读约 9 分钟 关键词:稳定链接 / 版本内演进 / 场次标记 / 交付纪律
本 篇 提 要
给用户收藏的地址不带版本号,内容原地覆盖;版本在文件内部演进(带版本号的文件留作历史快照),场次则用数据字段区分。根因一句话:版本号是给自己管历史用的,不该成为对方每次都要重记一遍的东西。再往下一层——对方只愿意收藏一次,尤其在同时跑七八条线的时候。
3
个版本并存
1
次收藏
0
版本号的地址
1
条交付纪律

触发(教授原话,10-17 08:50):"今天早晨学情报告有更新吗,链接不需要改变吧?" —— 而我必须如实回答:链接确实变了,晨间自动化产的是带版本号的新文件(v1.1 → v1.2)。

最终口径:交付给用户收藏的地址不带版本号,内容原地覆盖;版本在文件内部演进(文件名带版本号的留作历史快照),场次用数据字段区分。

01可复用四步法的又一次运转

1
先盘现状,不许先想答案

查本地与线上:三个版本并存(v1.0 / v1.1 / v1.2),教授收藏的是早期的那个——打开的是旧内容。这不是"内容没更新",是更新了但没送到他手上。与 行动案例 031 是同一种病:我把"生成新版"当成了"交付完成"。

2
找跨度根因,不找措辞

根因是把内部版本号写进了用户地址。版本号是给我自己管历史用的,不该成为用户每次都要重新记一遍的东西。更深一层:教授收藏链接的动作只愿意做一次——尤其在他自述记忆力不比年少、且同时在跑七八条线的时候。

3
给一句能对外、也能改口的人话

"一次收藏,永久有效。" 三判据:① 不需前置知识 ✓;② 不要求任何一方改变习惯(我改,他不用改)✓;③ 能写失效条件 ✓(见下)。

4
立刻落到跳转

① 建两个无版本号固定链接 pretest_briefing_1017.html、teaching_plan_1017.html,内容即最新版,双通道验证;② 晨间自动化改为原地覆盖这两个地址;③ 当天下午新增场次(上午场/下午场各一套题),不靠文件名区分,而用数据里的 ver 字段(v1.0 / v2.0-pm),后台加场次切换。

02这次长出来的三个新说法

① 版本号是作者的历史,不是用户的负担。

用户要记的只有一个地址。历史留给带版本号的文件,它们继续存在,只是不再被人收藏。

② 同一天多场次,用数据字段区分,不用文件名区分。

上午场 5 题、下午场 6 题,若靠文件名区分,教授就得同时记住两个链接、还要判断今天该发哪个。改用 ver 字段后,后台自动分开统计,且明确"全部"视图不混算正确率——两场题目不同,混算是假数据。

③ 例外要显性化,不能悄悄改。

下午场按教授要求兼作点名(姓名必填),这与上午场"可匿名、不做签到"的口径不同。我没有默默改规则,而是:学生端页面上明写"兼作下午到课记录",后台口径提醒同步改写并注明"成绩相关仍以教务系统为准"。规则的例外一旦发生,就要在两处可见的地方写清楚。

03顺带长出来的:操作手册也要按这条纪律写

当晚教授问"上传到 Canvas 的路径找不到了",我出的保姆级流程也按同一条思路组织:

结构作用
一句话版(置顶)忙的时候只看这一句就能动手
每一步带检查点走不下去时立刻知道卡在哪、该换哪条路
三条路线(标准 / 新版 / 手工兜底)不假设机构界面一致,给退路
故障表 + 五步验证清单出错能自查,做完能自检

同时坚持一条:我不知道的就留空——学校 Canvas 入口域名项目里没有记录,指南里留了空格让教授自填,没有凭空编一个地址。这与"宁愿少而真,不要多而假"是同一条纪律。

04失效条件(留着改口)

关联与出处

触发事件
10-17 08:50 教授晨问 · 13:05 下午场分场次 · 22:10 Canvas 流程
落地产物
pretest_briefing_1017.html / teaching_plan_1017.html(固定链接)· mba_quiz_1017pm.html + quiz_admin.html(分场次)· canvas_quiz_import_guide_v1.0.html(手册)
同批记录
行动案例 031 交付即同步 · 行动案例 033 以真正用的那一份为准
披露纪律
本记录为内部存档;若转公开案例,只保留四格,过五道闸,机构不点名
写 在 最 后

这三条(029/030/031 之外再添一条)说的其实是同一件事:把便利给对方,把麻烦留给自己。

版本号留在文件名里、留在 JSON 里、留在后台台账里都行,但不该留在他要点的那个地址里。

这条纪律后来也被写进了操作手册——手册自己也得按这条纪律写。