nature-experiment-log

1# experiment-log — 实验日志标准化
2 
3## 输入方式
4 
5用户通过以下任一方式提交实验原始材料时自动加载：
6 
7- **直接上传** — 在当前会话提交图片、音频、语音转录或文字。
8- **本地材料** — 提供本地文件或文件夹路径，由 agent 读取并整理。
9- **飞书群** — 通过可选的 `feishu-cli-integration` 读取群消息和附件。
10 
11## 输出方式
12 
13- **本地 Markdown** — 将日志和原始附件保存到用户指定的普通本地文件夹；未指定目录时，先返回可保存的 Markdown，不擅自选择路径。
14- **Obsidian vault** — 通过可选的 `obsidian` skill 写入 vault，并使用附带模板建立索引、异常记录和设备追踪。
15 
16核心流程不要求安装飞书或 Obsidian。使用飞书群输入时，才需要 bot 已加入目标群并具备 `im:message`、`im:message.group_msg` 和 `im:resource` 权限。
17 
18## 处理流程
19 
201. 接收上传材料、读取本地文件，或从已配置的飞书群获取材料。
212. 通过 vision_analyze 和文本解析提取结构化信息。
223. 对缺失或模糊字段向用户确认，不猜测实验条件或结果。
234. 确认输出方式和目标目录，生成实验 ID 与样品批次 ID。
245. 写出 `{OUTPUT_ROOT}/实验日志/{体系}/{类型}/{exp_id}.md`。
256. 将原始附件归档到 `{OUTPUT_ROOT}/raw/experiments/YYYY.MM.DD_描述_EXPID/`，并在日志中建立引用。
267. 如启用索引模板，更新实验索引；发现异常时追加异常记录。
278. 告知用户生成文件及原始材料的具体位置。
28 
29模糊信息（温度记不清、样品编号不明）主动询问，不猜测写入。
30 
31## 目录结构
32 
33```
34/vault/
35├── raw/experiments/                       ← 原始层（归档）
36│   └── YYYY.MM.DD_描述_EXPID/
37│       ├── 笔记.md
38│       ├── 图片/
39│       └── 语音/
40│
41wiki/实验日志/                              ← 标准层（产出）
42├── 实验索引.md
43├── 异常记录.md
44├── {体系A}/
45│   ├── 实验类型1/
46│   ├── 实验类型2/
47│   └── ...
48├── {体系B}/
49│   └── ...
50└── 公共/
51    └── 设备与试剂追踪.md
52```
53 
54## 实验 ID 规则
55 
56```
57{体系代码}-{设备代码}-YYMMDD-{序号}
58  │        │       │       └─ 当日序号（001 起）
59  │        │       └─ 日期
60  │        └─ 设备代码（M=马弗炉, T=管式炉, E=电化学, G=手套箱, F=可控气氛炉, B=通用）
61  └─ 体系代码（自定义，如 CL / NO / OX / HY 等）
62```
63 
64## 样品批次 ID 规则
65 
66```
67{体系代码}-{候选编号}-B{序号}
68  │        │         └─ 配盐批次序号
69  │        └─ 候选配方编号
70  └─ 体系代码
71```
72…