nature-experiment-log

experiment-log — 實驗紀錄標準化

輸入方式

使用者透過以下任一方式提交實驗原始材料時自動載入：

• 直接上傳 — 在目前對話中提交圖片、音訊、語音轉錄或文字。
• 本機材料 — 提供本機檔案或資料夾路徑，由 Agent 讀取並整理。
• 飛書群組 — 透過可選的 feishu-cli-integration 讀取群組訊息與附件。

輸出方式

• 本機 Markdown — 將紀錄與原始附件儲存到使用者指定的普通本機資料夾；未指定目錄時，先傳回可儲存的 Markdown，不擅自選擇路徑。
• Obsidian vault — 透過可選的 obsidian Skill 寫入 Vault，並使用附帶範本建立索引、異常紀錄與設備追蹤。

核心流程不要求安裝飛書或 Obsidian。使用飛書群組輸入時，才需要 Bot 已加入目標群組並具備 im:message、im:message.group_msg 和 im:resource 權限。

處理流程

1. 接收上傳材料、讀取本機檔案，或從已設定的飛書群組擷取材料。
2. 透過 vision_analyze 與文字解析擷取結構化資訊。
3. 對缺失或模糊欄位向使用者確認，不擅自猜測實驗條件或結果。
4. 確認輸出方式與目標目錄，產生實驗 ID 與樣品批次 ID。
5. 寫出 {OUTPUT_ROOT}/實驗紀錄/{體系}/{類型}/{exp_id}.md。
6. 將原始附件歸檔到 {OUTPUT_ROOT}/raw/experiments/YYYY.MM.DD_描述_EXPID/，並在紀錄中建立參照。
7. 如啟用索引範本，更新實驗索引；發現異常時追加異常紀錄。
8. 告知使用者產生檔案及原始材料的具體位置。

模糊資訊（溫度記不清、樣品編號不明）主動詢問，不猜測寫入。

目錄結構

/vault/
├── raw/experiments/                       ← 原始層（歸檔）
│   └── YYYY.MM.DD_描述_EXPID/
│       ├── 筆記.md
│       ├── 圖片/
│       └── 語音/
│
wiki/實驗紀錄/                              ← 標準層（產出）
├── 實驗索引.md
├── 異常紀錄.md
├── {體系A}/
│   ├── 實驗類型1/
│   ├── 實驗類型2/
│   └── ...
├── {體系B}/
│   └── ...
└── 公共/
    └── 設備與試劑追蹤.md

實驗 ID 規則

{體系代碼}-{設備代碼}-YYMMDD-{序號}
  │        │       │       └─ 當日序號（001 起）
  │        │       └─ 日期
  │        └─ 設備代碼（M=馬弗爐, T=管式爐, E=電化學, G=手套箱, F=可控氣氛爐, B=通用）
  └─ 體系代碼（自訂，如 CL / NO / OX / HY 等）

樣品批次 ID 規則

{體系代碼}-{候選編號}-B{序號}
  │        │         └─ 配鹽批次序號
  │        └─ 候選配方編號
  └─ 體系代碼

同一批樣品跨多個實驗時 sample_batch 保持一致，便利 dataview 追蹤。

設備代碼

代碼	設備	場景
M	馬弗爐	熱處理、浸泡腐蝕
T	管式爐	氣氛控制、脫水、熱穩定性
E	電化學工作站	CV/SWV/EIS
G	手套箱	配鹽、稱重、取樣
F	可控氣氛爐	精密氣氛控制
B	通用	乾燥、清洗、製樣

按實際設備擴充。

可選的 Obsidian 整合

本 Skill 可以只向普通本機資料夾輸出 Markdown，也可以與 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 對應位置即可使用。

參考範例

references/ 目錄包含三個完整的實驗紀錄範例，涵蓋常見實驗類型：

檔案	實驗類型
references/example-log.md	材料腐蝕浸泡實驗
references/example-electrochemical.md	電化學表徵（CV 視窗測試）
references/example-thermal-stability.md	熱穩定性實驗

每個範例均包含完整的 YAML frontmatter 與 Markdown 正文，可直接作為範本修改使用。

可選的飛書 CLI 整合

需要從飛書群組擷取材料時，使用 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 的設定方式取得。

自訂指南

• 體系代碼：依你的實驗體系自訂（如 CL/NO/OR/PO）
• 實驗類型：在 wiki/實驗紀錄/{體系}/ 下按需建立子目錄
• YAML 欄位：範本為建議結構，可自行增刪欄位
• 設備代碼：依實驗室實際設備擴充
• 輸出根目錄：可以是普通本機資料夾，也可以是 Obsidian vault 根目錄

相關檔案

檔案	用途
references/example-log.md	完整實驗紀錄範例
wiki/實驗紀錄/實驗索引.md	Dataview 儀表板
wiki/實驗紀錄/異常紀錄.md	異常紀錄格式
wiki/實驗紀錄/公共/設備與試劑追蹤.md	設備、試劑追蹤