experiment-log — Standardized Experimental Logging

Trigger Conditions

• 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

• 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

1. Receive materials → vision_analyze image reading + extract structured information
2. Generate experiment ID + sample batch ID
3. Write standard logs to

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

4. Archive raw materials (images, etc.) to

   raw/experiments/YYYY.MM.DD_Description_EXPID/

5. Add a "Raw Materials" section at the end of the log, referencing the raw path
6. Check for anomalies → append to

   anomaly-log.md

   if any
7. Append operation records to the log index
8. Notify the user of the writing location

Directory Structure

/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

Experiment ID Rules

{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.)

Sample Batch ID Rules

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

sample_batch

Equipment Codes

Obsidian Integration

• 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

experimental-logs/experiment-index.md

templates/experiment-index.md

experimental-logs/anomaly-log.md

templates/anomaly-log.md

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

templates/equipment-tracking.md

Reference Examples

references/

references/example-log.md

references/example-electrochemical.md

references/example-thermal-stability.md

Feishu CLI Operation Points

feishu-cli-integration

• 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

feishu-cli-integration

Customization Guide

• 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/experimental-logs/experiment-index.md

wiki/experimental-logs/anomaly-log.md

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