nature-experiment-log

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

experiment-log — 实验日志标准化

experiment-log — Standardized Experimental Logging

触发条件

Trigger Conditions

用户通过以下任一方式提交实验原始材料时自动加载：

路径 A — CLI 直接提交（图片 / 语音转录 / 文字）
路径 B — 发到飞书科研群，通过
```
feishu-cli-integration
```
扫描

Automatically loads when users submit experimental raw materials via any of the following methods:

Path A — Direct CLI submission (images / voice transcripts / text)
Path B — Send to Feishu research group, scanned via
```
feishu-cli-integration
```

前置依赖

Prerequisites

需要配合

feishu-cli-integration

skill 使用。确保：

飞书 bot 已添加到目标群

bot 权限：

im:message

im:resource

im:message.group_msg

群 ID 配置在 skill 上下文中

Requires use with the

feishu-cli-integration

skill. Ensure:

Feishu bot has been added to the target group

Bot permissions:

im:message

im:resource

im:message.group_msg

Group ID is configured in the skill context

处理流程

Processing Flow

接收材料 → vision_analyze 读图 + 提取结构化信息
生成实验 ID + 样品批次 ID

写出标准日志到

wiki/实验日志/{体系}/{类型}/{exp_id}.md

原始材料（图片等）归档到

raw/experiments/YYYY.MM.DD_描述_EXPID/

日志末尾加「原始材料」段落，引用 raw 路径
检查异常 → 有则追加
```
异常记录.md
```
追加操作记录到日志索引
告知用户写入位置

模糊信息（温度记不清、样品编号不明）主动询问，不猜测写入。

Receive materials → vision_analyze image reading + extract structured information
Generate experiment ID + sample batch ID

Write standard logs to

wiki/experimental-logs/{system}/{type}/{exp_id}.md

Archive raw materials (images, etc.) to

raw/experiments/YYYY.MM.DD_Description_EXPID/

Add a "Raw Materials" section at the end of the log, referencing the raw path
Check for anomalies → append to
```
anomaly-log.md
```
if any
Append operation records to the log index
Notify the user of the writing location

Proactively ask for ambiguous information (e.g., unclear temperature, unknown sample number) instead of guessing and writing.

目录结构

Directory Structure

/vault/
├── raw/experiments/                       ← 原始层（归档）
│   └── YYYY.MM.DD_描述_EXPID/
│       ├── 笔记.md
│       ├── 图片/
│       └── 语音/
│
wiki/实验日志/                              ← 标准层（产出）
├── 实验索引.md
├── 异常记录.md
├── {体系A}/
│   ├── 实验类型1/
│   ├── 实验类型2/
│   └── ...
├── {体系B}/
│   └── ...
└── 公共/
    └── 设备与试剂追踪.md

/vault/
├── raw/experiments/                       ← Raw Layer (Archiving)
│   └── YYYY.MM.DD_Description_EXPID/
│       ├── notes.md
│       ├── images/
│       └── voice/
│
wiki/experimental-logs/                              ← Standard Layer (Output)
├── experiment-index.md
├── anomaly-log.md
├── {System A}/
│   ├── Experiment Type 1/
│   ├── Experiment Type 2/
│   └── ...
├── {System B}/
│   └── ...
└── Public/
    └── equipment-reagent-tracking.md

实验 ID 规则

Experiment ID Rules

{体系代码}-{设备代码}-YYMMDD-{序号}
  │        │       │       └─ 当日序号（001 起）
  │        │       └─ 日期
  │        └─ 设备代码（M=马弗炉, T=管式炉, E=电化学, G=手套箱, F=可控气氛炉, B=通用）
  └─ 体系代码（自定义，如 CL / NO / OX / HY 等）

{system-code}-{equipment-code}-YYMMDD-{sequence-number}
  │        │       │       └─ Daily sequence number (starts from 001)
  │        │       └─ Date
  │        └─ Equipment code (M=Muffle Furnace, T=Tube Furnace, E=Electrochemical Station, G=Glove Box, F=Controlled Atmosphere Furnace, B=General)
  └─ System code (customizable, e.g., CL / NO / OX / HY, etc.)

样品批次 ID 规则

Sample Batch ID Rules

{体系代码}-{候选编号}-B{序号}
  │        │         └─ 配盐批次序号
  │        └─ 候选配方编号
  └─ 体系代码

同一批样品跨多个实验时

sample_batch

保持一致，便于 dataview 追踪。

{system-code}-{candidate-number}-B{sequence-number}
  │        │         └─ Salt preparation batch sequence number
  │        └─ Candidate formula number
  └─ System code

Keep

sample_batch

consistent when the same batch of samples is used across multiple experiments for easy dataview tracking.

设备代码

Equipment Codes

代码	设备	场景
M	马弗炉	热处理、浸泡腐蚀
T	管式炉	气氛控制、脱水、热稳定性
E	电化学工作站	CV/SWV/EIS
G	手套箱	配盐、称量、取样
F	可控气氛炉	精密气氛控制
B	通用	干燥、清洗、制样

按实际设备扩展。

Code	Equipment	Scenario
M	Muffle Furnace	Heat treatment, immersion corrosion
T	Tube Furnace	Atmosphere control, dehydration, thermal stability
E	Electrochemical Station	CV/SWV/EIS
G	Glove Box	Salt preparation, weighing, sampling
F	Controlled Atmosphere Furnace	Precision atmosphere control
B	General	Drying, cleaning, sample preparation

Expand according to actual equipment.

Obsidian 集成

Obsidian Integration

本 skill 设计为与 Obsidian vault 配合使用。Obsidian 是一个基于本地 Markdown 文件的笔记系统，配合 Dataview 插件可实现实验数据的动态查询和仪表盘。

为什么用 Obsidian：

所有日志为纯文本 Markdown，可版本控制、可全文搜索
YAML frontmatter 结构使 dataview 可自动生成实验列表、异常汇总、设备使用记录
本地存储，无云依赖性，数据安全

安装 skill 后需在 vault 中创建以下文件：

文件	模板	用途
`实验日志/实验索引.md`	`templates/experiment-index.md`	Dataview 查询仪表盘
`实验日志/异常记录.md`	`templates/anomaly-log.md`	异常记录
`实验日志/公共/设备与试剂追踪.md`	`templates/equipment-tracking.md`	设备与试剂追踪

将模板文件复制到你的 Obsidian vault 对应位置即可使用。

This skill is designed to work with Obsidian vault. Obsidian is a note-taking system based on local Markdown files, and with the Dataview plugin, it enables dynamic querying and dashboards for experimental data.

Why use Obsidian:

All logs are plain text Markdown, enabling version control and full-text search
YAML frontmatter structure allows dataview to automatically generate experiment lists, anomaly summaries, and equipment usage records
Local storage, no cloud dependency, data security

After installing the skill, create the following files in your vault:

File Template Purpose

File	Template	Purpose
`experimental-logs/experiment-index.md`	`templates/experiment-index.md`	Dataview query dashboard
`experimental-logs/anomaly-log.md`	`templates/anomaly-log.md`	Anomaly logging
`experimental-logs/Public/equipment-reagent-tracking.md`	`templates/equipment-tracking.md`	Equipment and reagent tracking

experimental-logs/experiment-index.md

templates/experiment-index.md

Dataview query dashboard

experimental-logs/anomaly-log.md

templates/anomaly-log.md

Anomaly logging

experimental-logs/Public/equipment-reagent-tracking.md

templates/equipment-tracking.md

Equipment and reagent tracking

Copy the template files to the corresponding locations in your Obsidian vault to use.

参考示例

Reference Examples

references/

目录包含三个完整的实验日志示例，覆盖常见实验类型：

文件	实验类型
`references/example-log.md`	材料腐蚀浸泡实验
`references/example-electrochemical.md`	电化学表征（CV 窗口测试）
`references/example-thermal-stability.md`	热稳定性实验

每个示例均包含完整的 YAML frontmatter 和 Markdown 正文，可直接作为模板修改使用。

The

references/

directory contains three complete experimental log examples covering common experiment types:

File	Experiment Type
`references/example-log.md`	Material corrosion immersion experiment
`references/example-electrochemical.md`	Electrochemical characterization (CV window test)
`references/example-thermal-stability.md`	Thermal stability experiment

Each example contains a complete YAML frontmatter and Markdown body, which can be directly modified and used as a template.

飞书 CLI 操作要点

Feishu CLI Operation Points

路径 B 使用

feishu-cli-integration

skill：

拉消息：

lark-cli im +chat-messages-list --chat-id oc_*** --page-size 30 --sort asc

下载图片：

lark-cli im +messages-resources-download --message-id *** --file-key *** --type image --output <相对路径>

⚠️
```
--output
```
只接受相对路径，先
```
cd
```
到
```
raw/experiments/
```
归档目录

群 ID 和 bot 权限按

feishu-cli-integration

skill 的配置获取。

Path B uses the

feishu-cli-integration

skill:

Pull messages:

lark-cli im +chat-messages-list --chat-id oc_*** --page-size 30 --sort asc

Download images:

lark-cli im +messages-resources-download --message-id *** --file-key *** --type image --output <relative-path>

⚠️
```
--output
```
only accepts relative paths; first
```
cd
```
to the
```
raw/experiments/
```
archive directory

Obtain the group ID and bot permissions according to the configuration of the

feishu-cli-integration

skill.

自定义指南

Customization Guide

体系代码：按你的实验体系自定义（如 CL/NO/OR/PO）
实验类型：在
```
wiki/实验日志/{体系}/
```
下按需创建子目录
YAML 字段：模板是建议结构，可增删字段
设备代码：按实际实验室设备扩展

System Code: Customize according to your experimental system (e.g., CL/NO/OR/PO)
Experiment Type: Create subdirectories as needed under
```
wiki/experimental-logs/{system}/
```
YAML Fields: The template is a suggested structure; fields can be added or removed
Equipment Code: Expand according to actual laboratory equipment

Related Files

文件	用途
`references/example-log.md`	完整实验日志示例
`wiki/实验日志/实验索引.md`	Dataview 仪表盘
`wiki/实验日志/异常记录.md`	异常记录格式
`wiki/实验日志/公共/设备与试剂追踪.md`	设备、试剂追踪

File	Purpose
`references/example-log.md`	Complete experimental log example
`wiki/experimental-logs/experiment-index.md`	Dataview dashboard
`wiki/experimental-logs/anomaly-log.md`	Anomaly log format
`wiki/experimental-logs/Public/equipment-reagent-tracking.md`	Equipment and reagent tracking