实验室归档写说明书，体会到为什么会有科技断代，科研靠考古的现象了

Diana010

楼主今年下半年研三，项目文章什么的都做的差不多了，准备交接后辈了
想要一劳永逸的给实验室我现在负责的方向写一个全套仪器与软件使用和流程说明书，这样以后教实验室新进来的人就不用重复手把手说明了，现在ppt写到大一半发现仪器和软件使用有好多琐碎的细节，不经过长年累月的踩坑真的好难用语言写出来。比如设置的采样频率，软件的某个组件某个参数最好怎么设置，线缆为啥要这么连，每一个具体的不同的项目还要单独考虑，感觉好麻烦
主要是有的时候仪器和软件会出现一些莫名其妙的bug，软件用labview写的，我当时摸索了一段时间才找到了一些bug通用解法。这种问题存在很多，导致我只能写一个大概的流程，有时候仪器还会出现莫名奇妙的问题，这些当时全都随机应变解决了，但现在要我写下来归档给后面的人参考很难说的清楚为啥会出现这类问题，根本写不全也没法写。期待后人在遇到一些琐碎的细节能想办法解决

难怪导师喜欢劝人读博，新进来人重新培养确实挺难的，高校实验室流动性这么大，感觉后面的学弟学妹新进来的人很容易重复发明轮子

Diana010

目前我负责的方向感觉像是屎山代码，当初也是我的学长学姐手把手教的做实验，现在我在带后辈感觉手把手教他们做挺麻烦的，感觉单纯靠口述会每一代的损失信息，最后就会变成屎山代码

theory0

确实，很多工作上的细节都是特定的人能解决，你这算是智力水平高能理解原理的。一些工厂只能是师傅怎么做，徒弟跟着学

格雷殿下

要不写本书,把东西全写进去吧

lin2004

格雷殿下 发表于 2026-8-4 18:42
要不写本书,把东西全写进去吧

这事本质是人与人知识技术传播损耗，你这解决不了任何问题，解决问题就是别传别人了让之前干这个的永远干下去，科技能做的是攻克自然寿命让你永远活着永远干下去。要不就是找个没有自然寿命的ai（因为可迁移）永远干下去。

变老的大二

这种我能想到的未来解决方法是找个ai助手随身携带学习了。
现代细枝末节的技术细节损耗多的很。大部分情况下只能保持一个理论框架是完美的。

变老的大二

甚至未来有可能还会发生元朝到明朝数学发生的技术倒退问题。算筹到珠算直接导致了高台跳水，落地生花的情况。

alitonz

这几年开始流行的那个概念，隐性知识只能靠老带新在工作中传承，不能被正规教育

渡鸦骑士

主要很多解决方法都是第一次遇到才会想得起来的。
熟练的老人会把这些变成自己的习惯反而很难从脑子里想出来，所以老带新很重要的就是通过新人激发老人摸索时期的回忆。

请发顺丰一谢谢

要不试着把自己炼化成skill

—— 来自 HUAWEI HBN-AL00, Android 12, 鹅球 v3.5.99

zn231

可以根据目标人群限定了大致的测量方向，梳理主要工作几条流程，不同测量的推荐参数给出来，保证后面能继续转起来就足够了。其他的故障或bug统统放到一个应急处理汇总表里就行了。
在后面只能依靠后人的智慧了。而且学习阶段心无旁骛的状态，真的不用担心未来的师弟们太多。

redbuck

有AI 和具身智能就不怕了，永生助手



忽然想到黑环的人偶，魔法文明的具身智能助手…

雪映风影

我给产品写过完整说明书，经过几轮迭代只能说初具人形。
编写说明书是必须有模板格式，有模板内容的，因为编写者往往是最清楚最透彻的，很多别人不清楚的知识他可能认为理所当然直接忽略了，所以必须有模板格式来限定，也就是最傻瓜的解释说明，从内容把一切都解释清楚，从格式上完全傻瓜化只要一步步操作就能完成。
另外还有个问题就是各种bug或者排故。


—— 来自 Xiaomi 23113RKC6C, Android 16, 鹅球 v3.5.99-alpha

又是十元

实际上，这也是llm大模型的局限之处，这个世界上有太多的知识是没有办法用文字记录下来的，有时候还真的只靠一个vibe。问题就是vibe coding 它理解不了这个vibe

9912811

所以日志是有用的
今天设了什么参数，记下来；明天遇到什么问题，怎么解决的，记下来。然后在LLM协助下就能搞定了

张小狗

经验之所以是经验，得自己去做过一遍才能得到。别整天AI了，我看早晚要被AI脑控。

wandeeees

感觉等算力和存储价格足够低的时候，能把实际生产中的各类参数都记录下来的话，AI应该还是能解决的

ylns1314

我现在专门搞了个 git repo 用来让 codex 记录它每次调整家里路由器设置是怎么做的，用了什么脚本，现在基本做到了哪怕路由器固件升级设置全重置也能很快自动配好

Indolencoma

实验技术的传代是这个样子的，主要是真让你整理成册的话，许多习惯性的、细节性的东西你自己都不一定能想得出来要注明，那属于肌肉记忆，但这肌肉记忆有时候就会影响实验结果；而手把手带人做实验的时候你看到对方的操作有时候才会想起来“这不对”

—— 来自 OPPO PKC110, Android 16, 鹅球 v4.0

来都来了

现在的最新流行方法是炼一个实验方法.skill

Totokei

还真遇到过类似的情况，有个十分冷门的活我是办公室里第一个遇上完成的。

结果半年多点同事也遇上了类似的情况我已经忘记了怎么做了，于是重新摸索完之后赶紧趁有记忆和截图先写了个文档

lin2004

redbuck 发表于 2026-8-4 19:29
有AI 和具身智能就不怕了，永生助手

到了那个时候，牧师就是跟神祈祷直接要奇迹，法爷亲就要自搓具体操纵事物的法术，你看这是不是跟现实世界跟ai许愿和手搓的代码现在的对上了。

tiro_finale

不过屎山代码靠AI来整理效率完爆过去了，也很难有离职了再也看不懂的情况

哈尔路尼亚

主要问题是 你写的越细，别人认真读的概率越小

与天争锋_L

往好处想，这种经验性的东西好歹用多了也能自己琢磨出来（大部分）

—— 来自 vivo V2505A, Android 16, 鹅球 v3.5.99-alpha

相见恨晚

谢谢你，混血王子

四顾

人和人沟通要融合视野，人自己回顾也要，所以超麻烦。
方法这个东西配同时记录和事后总结的差别挺大的。一旦跨过难度门槛，事后的注意力重点、态度就会飘走，顶多保留一些比较常见反复，或者成就感强的流程焦点。
而且除非有副程序保留过程比对，人在不同状态下自我监控失焦是常态。

我就再氪一单

后来人需要的是 师兄.skill
不过有很多你认为理所应当 已经化为肌肉记忆的东西，师弟师妹根本不理解为什么。也许降龙十八掌就是这样只剩下九掌的吧。

—— 来自 Xiaomi 23049RAD8C, Android 15, 鹅球 v3.5.99

wwdzcjsmxx

文字记录是这样的啊。。。我N年前自己写的烘焙配方，当时觉得已经写得很深入浅出了，十多年过去了，里面好多地方我自己已经看不懂了

havoc_cc

你平时会写工作日志吗，无论做什么项目我都会把前前后后的过程内容都写进去；
以前用obsidian现在typora，现在AI方便了，可以直接根据项目文件生成markdown，自己负责审核就好

zerocount

alitonz 发表于 2026-8-4 19:12
这几年开始流行的那个概念，隐性知识只能靠老带新在工作中传承，不能被正规教育 ...

ai的rag模块，可以部分匹配楼主的要求。
只要把日常的维护日志，操作细节，分别解决/避免了什么情况和问题，都一股脑塞进去，后人提问时ai自然会列清单。

长末

以前编码的时候有猴子也能懂系列的指南

炽十二翼

我有个想法，来套带视频的穿戴数据采集系统，干活的时候把操作都录下来，顺便可以语音说明，然后让ai整理成SKILLS，装到萝卜上，以后就是具身智能上了，不用那么多传帮带了

gammatau

这算啥，载人航天地面测控的程序都是纯命令行还没文档的呢

新人马甲0

写得太细了会发现还是要手把手地教别人才读得懂

红魔馆的糖

公司大搞降本增效，我也很头疼，别人给我的交接文档完全不能覆盖工作内容。但是想了想如果要我把自己的工作编写一份文档交接出去，我估计还不如他们

surely

一堆bug能work就不要动任何一个bug！！！！
说明书，手搓，现场手搓！！！
玛德，我当初是怎么手搓出来的，我现在也不知道啊

呼鲁鲁修

确实，别说别人写的了，我自己当年写的流程，我重新翻出来看都一头雾水

火炎龍

wandeeees 发表于 2026-8-4 20:39
感觉等算力和存储价格足够低的时候，能把实际生产中的各类参数都记录下来的话，AI应该还是能解决的 ...

还是不太行，一线生产中还有一些经验不是能被目前的传感器数字化记录下来的
传感器装得多成本又高，一直采集数据量又大处理起来成本也高
能覆盖大多数情况后，少部分边角要覆盖的成本就太高了




—— 来自 鹅球 v3.5.99-alpha

Alufer

我自己也写操作手册，写过几次之后感觉：必须要把读的人当傻子，然后按这个标准来写。
因为我有每隔几个月干一次的活，写完操作手册扔在那。然后过了几个月需要用，发现按照工作手册不会做了。里面存在太多当时的我以为是随手就能拿到的数据或者显而易见的逻辑，但才过了一两个月我就忘得一干二净，只能找当时的数据一点点反推。
后面再写我就老实了，必须事无巨细，每一步为啥这么做都得写明白。