用途
ELN 技能用于指导科研人员使用 org-mode 维护专业的电子实验记录本(Electronic Lab Notebook),目标是实现科学文档的规范化、可复现性与研究诚信。适用于创建或更新实验记录、记录假设与实验设计、文档化计算工作流、总结结果与结论、按时间组织研究笔记、建立相关工作交叉引用、为论文或报告准备文档,以及确保科研工作可复现。
核心原则
- 按时间组织:条目按日期存放在层级目录中,例如 notebook/2025/01-January/2025-01-15.org。
- 完整记录:每条记录应包含做了什么、为什么做、如何做、观察到什么、意味着什么、下一步。
- 可复现性:文档应让他人(包括未来的自己)理解决策依据、精确复现工作、获取全部数据与代码、跟随逻辑链条。
- 专业标准:清晰专业地书写;诚实记录失败与意外结果;为所有条目标注日期与时间戳;不删除或修改过往条目(以新条目进行更正);包含足以独立复现的细节。
文件与目录结构
按日期命名文件,例如 2025-01-15.org。目录结构示例:
research-notebook/ ├── 2025/ │ ├── 01-January/ │ │ ├── 2025-01-15.org │ │ ├── 2025-01-16.org │ │ └── data/ │ │ └── 2025-01-15/ │ │ ├── experiment_results.csv │ │ └── analysis.png │ └── 02-February/ ├── templates/ │ ├── experiment-template.org │ └── calculation-template.org ├── index.org └── README.org
条目模板结构
条目以 #+TITLE、#+AUTHOR、#+DATE、#+FILETAGS、#+STARTUP 开头,随后包含 Daily Summary 与具体 Entry。每个 Entry 使用属性抽屉记录 ID、PROJECT、STATUS、RELATED 等,并分节撰写 Objective、Hypothesis、Background/Context、Methods、Results、Analysis、Conclusions、Issues/Problems、Next Steps、References。Methods 中可嵌入实际代码块(如 Python 构建 Pt 表面),Results 中可包含代码生成图表并链接结果文件,数据可用表格呈现。
常用 org-mode 功能
- 属性抽屉:记录 ID、PROJECT、STATUS(Planning/In_Progress/Complete/On_Hold)、STARTED、COMPLETED、RELATED、DATA。
- 标签:用于分类与过滤,常见类别包括类型(experiment、simulation、analysis、literature、meeting)、主题(catalyst、materials、synthesis、characterization)、状态(todo、in_progress、done、failed)、优先级(urgent、important、routine)。
- 链接:内部链接(file: 与 id:)、外部链接(数据文件、DOI)、代码链接。
- 代码块:使用 #+BEGIN_SRC 与 #+RESULTS 记录可复现分析代码与输出。
- 表格:记录参数、数值、单位与备注,可用 #+TBLFM 进行公式计算。
- TODO 与复选框:记录下一步任务、截止日期与工作量。
- 时间戳:活动时间戳(出现在 agenda)、非活动时间戳(仅文档)、日期范围。
常见条目类型
技能给出五类条目示例:实验/计算工作(如 DFT 表面弛豫,记录计算器、泛函、截断能、k 点、收敛标准、命令、结果、分析与结论)、文献综述(论文信息、关键发现、与自身工作的相关性、引发的问题、待跟进文献)、数据分析(目标、数据来源、分析代码、发现表格、结论及对既往工作的影响)、会议记录(议程、个人更新、反馈、行动项、下次会议时间)、问题排查(问题描述、错误信息、尝试过的解决方案、根因、解决方式、经验教训、参考链接)。
最佳实践
- 每日摘要:每个文件开头写简要总结,说明当日重点、主要成果与主要挑战。
- 诚实记录:如实记录与预期或文献不符的结果,并分析可能原因(吸附位点、k 点、泛函、表面覆盖度等),给出解决方式。
- 版本控制集成:记录代码版本与 Git 提交哈希。
- 数据管理:链接原始输出、处理后数据、分析笔记本与归档文件,并记录 MD5 校验和。
- 交叉引用:链接背景、先前尝试、后续工作与项目总览。
- 可复现性清单:记录软件版本、输入文件、随机种子、计算环境、数据处理代码、分析脚本与关键输出归档。
检索与索引
可使用 org-mode 搜索按标签、TODO、正则文本检索,或通过 org-agenda 跨文件搜索。可创建 index.org 索引文件,汇总项目、关键结果与重要技术。
模板
提供快速条目模板(What I Did、Why、Results、Next Steps)与完整研究条目模板(Objective、Hypothesis、Methods、Results、Analysis、Conclusions、Next Steps)。
与计算工作流集成
支持嵌入代码、捕获输出,将计算与文档记录结合。
限制
资料未提供该技能的安装方式、依赖要求、收费模式、支持平台或具体效果数据,这些信息暂未提供。