Marvis 版本基线和变更记录怎么留
记版本要记四个字段,单记一个版本号既复不了现也查不了差异。
只记版本号的人,三个月后会遇到两个问题:想复现当时的结果复现不了(系统、配置、模式都变了),想判断某条结论是否还成立也判断不了(不知道它对应哪一版)。这两个问题都不是「记得不够多」,而是记的字段不对——版本号只回答了「哪个软件」,没回答「什么环境里」。
更麻烦的是,这个产品连「版本号」本身都不唯一。安装包文件名里的数字、注册表里显示的版本、主程序文件的版本、子进程的版本,四处不一致,最大与最小之间差一整个大版本。所以记录的第一步不是写字,是先决定「以哪一层为准」。
官方没有更新日志。站点全量条目里找不到版本说明页,五篇文档正文没有版本对照表,资讯栏目二十二篇里只有一篇提到移动端版本号。这意味着版本变化的公开线索只有零星几处,剩下全靠自己记——这也正是这一节存在的原因。
前提与适用
| 项 | 说明 |
|---|---|
| 适用读者 | 写过产品说明要交出去的人;要判断半年前的结论还能不能用的人;团队里负责同步版本变化的人 |
| 事实边界 | 四字段与变更记录为编辑方法,官方无更新日志页;版本四层不一致、移动端版本号为本机与官方资讯实证 |
| 版本基线 | 客户端 1.60.3400.35(主程序文件版本);系统 Windows 11 build 26200 |
| 不适用 | 想知道官方页多久回查一次——见官方页改版回查;想知道改动到什么程度该补章——见增量与退役 |
怎么做
第一步:定四字段,一个都不能少。
客户端版本:写哪一层要固定。建议统一用主程序文件版本(在安装目录里看可执行文件的属性),因为它是唯一能与你实际运行的功能对应的数字。安装包文件名里的数字是安装器版本,注册表显示值可能是发布商的打包版本,两个都不适合当运行基线。
系统与配置:操作系统版本加核心配置。这一项不是凑数——同一个任务在不同配置上的表现差异,往往比不同版本之间还大。写「Windows 11 build 26200、16 逻辑处理器、31.8 GB 内存」比写「Windows 11」有用得多。
记录日期:写核验当天,不写「近期」。日期的作用是给结论一个保质期,没有日期的结论无法判断该不该重看。
模式与模型组合:这一项最容易被漏。模式决定数据在哪处理(效率模式与本地模式),模型组合决定用哪个模型(界面上那个模型选择器是独立控件)。两者都会改变结果,只记版本不记这两项,等于记了车牌没记路线。
四项写在同一个位置,一行一行,别散在聊天记录里。散着记的结果是:需要的时候找不到,找到了也不知道是不是同一次。
第二步:处理版本四层不一致。
先承认它不一致,再定规则。四个数字分别来自安装包文件名、注册表显示版本、主程序文件版本、子进程版本,实测互不相同。
处理办法有三条:
写的时候注明来源层。「主程序 1.60.3400.35」比「版本 1.60.3400.35」清楚,因为后者会让人以为是安装包版本。
比较只在自己那一端纵向比。同一个软件的新旧版本可以比,跨端的版本号不能横向比大小——桌面端是四段式,移动端是两段式,1.60 不比 1.2 新,1.2.5 也不代表它落后。这一条在 1.3 已经讲过,在记录里同样适用。
四层都记一次,只在建基线时做。日常记录只写主程序版本,但第一次建基线时把四层都抄下来,以后遇到「为什么两个数字不一样」的疑问,可以直接对照,不用重新查。
第三步:变更记录写成一行一条。
格式定死四列:日期、变了什么(旧值→新值)、影响哪些章节或结论、是否已回填。
四列里最重要的是第三列。版本从 1.60.3400.35 升到下一个版本,受影响的不一定是全部章节:界面文案相关的最容易失效,权限机制的表述通常稳定,配置门槛要重新核对。把影响面写出来,才知道这次要改几处。
第四列是执行状态。「已回填」与「待回填」必须分开,否则记录会变成一份「知道有变化但没改」的清单——那种清单比没有更危险,因为它给了你一种已经处理过的错觉。
第四步:别把页面的更新时间当发布日。
官方页面自带更新时间戳,但这个时间戳不能当发布日用来判断「这条信息多新」。它的问题有两处:
一处是批量重建。资讯栏目二十二篇里有二十一篇的更新时间集中在同一天的同一分钟区间内,只有一篇例外——这不是二十一篇都在那一刻被编辑过,更可能是站点迁移或批量重建留下的时间。
另一处是时间戳与内容日期可以差很远。有一篇转载稿页内标注的原发布日是五月的某天,而它的更新时间是九月末,相差四个月。用更新时间推断内容新鲜度,会得出「这是九月的信息」这种错误结论。
正确的做法是:内容日期看页内正文标注(有的话),页面更新时间只用来判断「这页有没有被改过」,且要结合批量重建的可能性一起看。两者都不能单独当「信息新鲜度」的指标。
第五步:定谁维护、怎么改。
记录只有一个人写的时候不成问题,两个人以上就会出现「谁改的、为什么改」。三条规则能省掉大部分麻烦:
只追加,不改旧行。 旧行是历史,改了就失去对比价值。发现旧记录写错了,追加一行「更正」,写明改的是哪一行、改后是什么,而不是回去把原行覆盖掉。
作废不删除。 某条结论过期时,在那一行标记作废并写日期,不要整行删掉。删除会让后面的人以为这件事从未发生,于是重新踩一遍。
变更由发现的人记,不等汇总。 等周会汇总的代价是:等到汇总时,发现者已经记不清当时看到的具体数字。四字段的价值就在于具体,模糊化的记录等于没记。
参数与边界
| 项 | 说明 |
|---|---|
| 四字段的适用范围 | 任何要复现结果的场景。只做一次性任务可以不记,凡是要交出去、要对比、要过几周再看的都要记 |
| 基线建立时机 | 第一次正式使用、每次客户端大版本升级、换机器。这三次必须重建基线,其余时候追加变更记录即可 |
| 版本号粒度 | 记录到主程序文件版本的完整四段,不截断。截成前两段会让两个不同构建看起来一样 |
| 不覆盖官方变更 | 官方无更新日志,基线与变更记录只能覆盖你观察到的变化,覆盖不了你没用到的功能 |
| 留存 | 至少保留到该版本结论失效为止。状态类结论十二个月,机制类可延长,但每次升级都要重看 |
验收清单
| # | 核对项 | 通过标准 | 不合格时 |
|---|---|---|---|
| 1 | 四字段齐全 | 版本、系统配置、日期、模式与模型组合,四项都在同一处 | 缺哪项补哪项;模式项缺失时要重新确认当时的处理位置 |
| 2 | 版本注明层级 | 写的是「主程序版本」而非裸版本号,四段完整 | 回安装目录确认属性,不要用安装包文件名替代 |
| 3 | 变更记录四列齐全 | 日期、变化内容、影响范围、回填状态都能读到 | 补影响范围;写不出影响面说明这次变化还没想清 |
| 4 | 时间戳没被当发布日 | 判断新鲜度用的是正文日期或自己的记录日期 | 把「页面更新于」改成「观察到变化于」并补自己的核验日 |
| 5 | 同一结论只有一处记录 | 不出现两个互相矛盾的版本基线 | 合并到一处,旧的那条标失效并写日期 |
失败与回滚
| 现象 | 原因判据 | 重试或恢复 | 手动兜底 |
|---|---|---|---|
| 三个月后结论无法复现 | 只记了版本,没记模式与配置;或版本取的是安装包层 | 重建基线,用主程序版本加四项齐记 | 重跑一次任务,把当前四项补记,作为新基线起点 |
| 两个记录版本号不一致 | 分别取了注册表值与文件版本,两层本来就不同 | 统一到主程序文件版本,另一层标注为「注册表显示值」 | 建基线时四层全抄一遍,之后不再混用 |
| 记录里全是「待回填」 | 变更记了但没安排执行,第四列长期停在待办 | 按影响范围排序,先改状态类结论 | 把待回填清单缩到三条以内,多了就永远做不完 |
| 把页面更新时间当成了发布日 | 时间戳来自批量重建,与内容日期相差数月 | 改用页内正文日期或自己的核验日 | 在记录里加一列「内容日期」,与「页面更新时间」分开 |
| 换机器后旧结论照用 | 配置项没记或只写了系统名 | 补配置;旧结论标为「原机器」,不直接迁移 | 在新机器上重跑关键任务,按 11.1 的四项重新验收 |
| 跨端版本号被横向比较 | 桌面端四段式与移动端两段式被当成同一序列 | 改为各端纵向比,注明端别 | 记录里加一列「端」,避免以后再混 |
自检题
| # | 问题 | 参考答案要点 |
|---|---|---|
| 1 | 为什么不能只记版本号 | 版本只回答「哪个软件」,不回答「什么环境、什么模式」;缺后两项无法复现结果 |
| 2 | 四个版本号不一致,该用哪个 | 用主程序文件版本,因为只有它与实际运行的功能对应;其余三层建基线时抄一遍备查 |
| 3 | 页面更新时间能不能当「信息很新」的证据 | 不能。存在批量重建与时间戳滞后于内容日期两种情况,新鲜度要看正文日期或自己的核验日 |
注意与相关
Note:四字段的价值不在完整,在可比。两份记录只要四项都齐,就能逐项对比找出差异;四项缺一项,对比就会退化成猜测。所以宁可字段少,也不要字段不齐。
Warning:变更记录里最危险的状态不是「未回填」,是「以为回填了」。所以第四列不要写「已处理」这种模糊词,写「已改哪几节」——具体到节能被核对,模糊词不能。
Tip:把四字段做成一行模板放在文档开头,每次更新只改数字。模板化的好处是缺项会显眼:四项的位置空着一个,写的时候一眼就能看见。
相关:12.2 官方页改版了该回查哪几处(官方侧的观察点)、12.3 什么时候开增量章、什么时候退役(变化到什么程度该动结构)、11.3 数字、型号和额度怎么标证据(数字的出处怎么标)。

TRAE-AI编程


更多建议: