# SnapLab v7.0.9 · by Ew4

实验数据自动录入：上传照片或仪器表格 → 识别为表格 → 核对 → 确定性计算与统计 → 图表 / Excel / 方法学段落。

## 认证
浏览器用访问密码登录（在线更新也只需要这个密码）；脚本 / AI 代理在请求头带 Authorization: Bearer <API_TOKEN>。

## 快速上手
- GET /api/skills 查看实验类型及其列约定、参数
- POST /api/agent/run (multipart: file, exp_type, params_json, project, title, auto_confirm=true) 一次完成 上传→识别→入库→计算，返回记录、结果表、图表地址
- 或分步：POST /api/upload → 人工核对 → POST /api/records/{id}/confirm
- GET /api/records?q=&exp_type=&project= 查询；GET /api/records/{id} 详情（data / processed / params）
- GET /api/records/{id}/plot.png 图表；GET /api/export/{id}.xlsx 导出
- POST /api/records/{id}/interpret | /methods | /ask 文本模型（结果缓存，force=true 才重新生成）
- POST /api/upload 默认 mode=smart：自动判断这张图是数据表 / 实验记录 / Protocol 并各自归位；返回 status=processing，轮询 /api/records/{id}/status 拿结果（含 kind 与 protocol_id）
- 笔记：mode=note 强制按记录整理；GET /api/notes 检索；POST /api/notes/{id}/tables/{i}/to-record 把笔记里的表格转成数据记录
- 实验方案：POST /api/upload 带 mode=protocol 强制按方案整理（转录原文 + 补全缺的通用环节 + 统一语言），完成后 /api/items/{id} 的 protocol_id 指向方案
- GET /api/protocols 检索方案；GET /api/protocols/{pid} 详情（含 supplemented / unclear）；GET /api/protocols/{pid}/docx 下载排版好的 Word
- GET /api/export/{id}.docx 把一条记录导成 Word；数据还支持 .xlsx/.csv/.md/.json
- GET /api/media 所有上传过的原图；GET /api/health 健康检查（无需登录）
- 上传时带 client_key=<一次性随机串>：网关超时重传会认它，不会存成两条记录
- 分类判错了：POST /api/records/{id}/reclassify {"kind":"data|note|protocol"} 拿原图重跑并记一条纠正样本
- 图像分析插件（十个，ImageJ 那一路）：GET /api/plugins 目录；GET /api/records/{id}/plugins 按图推荐；POST /api/records/{id}/plugin/{pid} 带 {"answers":{}} 跑一轮 —— 答案不全会返回 status=need_input 和要问的问题（每个问题都带 default，照抄 default 就能一键走完），答案填上再 POST 一次出结果
- GET /api/system/classifier 分类器现状；POST /api/training/calibrate 用自有数据重训权重（管理员）；GET /api/training/export.zip?scope=me|all 导出可直接微调的训练集

## 实验类型
- body_weight：小鼠体重（列：animal, group, day, weight；参数：control, drop_alert）
- colony：克隆形成 / 集落计数（列：group, colonies, seeded；参数：numerator, denominator, control, test）
- elisa：ELISA 标准曲线定量（列：sample, OD, conc；参数：fit, blank, dilution）
- flow：流式细胞术（门控百分比 / MFI）（列：group, gate, value；参数：group_col, value_col, facet_col, control, test）
- genotype：基因鉴定（列：animal, genotype, locus；参数：expected, locus）
- if_count：免疫荧光 / 免疫组化计数（列：group, field, positive, total；参数：numerator, denominator, control, test）
- notebook：手写实验记录（列：自动；参数：group_col, value_col, control, test）
- other：其他表格数据（列：自动；参数：group_col, value_col, control, test）
- qpcr：qPCR 相对定量（ΔΔCt）（列：sample, target, Ct；参数：ref_gene, control_sample, efficiency）
- transwell：Transwell 迁移 / 侵袭计数（列：group, field, cells；参数：group_col, value_col, control, test）
- tumor：动物皮下瘤 / 体重记录（列：animal, group, day, length, width, weight；参数：control, test）
- viability：细胞活力 / 增殖（CCK-8、MTT）（列：group, OD, time；参数：blank, control, test）
- wb：Western blot 灰度定量（列：sample, protein, intensity；参数：loading_control, control_sample）
- wound：划痕愈合 / 迁移（列：group, replicate, time, area；参数：control, test）

## 科研指南
- /api/docs/+¥++ûCodex-4.2+Ü+ó-++¥-ó-ªÌ+-ª-Á+ä：+¥++ûCodex-4.2+Ü+ó-++¥-ó-ªÌ+-ª-Á+ä
- /api/docs/changes-4.4：changes-4.4
- /api/docs/changes-4.5.1：changes-4.5.1
- /api/docs/changes-4.5：changes-4.5
- /api/docs/changes-4.6：changes-4.6
- /api/docs/changes-5.0：changes-5.0
- /api/docs/changes-5.1：changes-5.1
- /api/docs/changes-5.2：changes-5.2
- /api/docs/changes-5.3.1：changes-5.3.1
- /api/docs/changes-5.3.2：changes-5.3.2
- /api/docs/changes-5.3：changes-5.3
- /api/docs/changes-5.4.1：changes-5.4.1
- /api/docs/changes-5.4：changes-5.4
- /api/docs/changes-5.5：changes-5.5
- /api/docs/changes-5.6：changes-5.6
- /api/docs/changes-5.7.1：changes-5.7.1
- /api/docs/changes-5.7：changes-5.7
- /api/docs/changes-5.8.1：changes-5.8.1
- /api/docs/changes-5.8.2：changes-5.8.2
- /api/docs/changes-5.8：changes-5.8
- /api/docs/changes-5.9.1：changes-5.9.1
- /api/docs/changes-5.9.2：changes-5.9.2
- /api/docs/changes-5.9：changes-5.9
- /api/docs/changes-6.1：changes-6.1
- /api/docs/changes-6.2.1：changes-6.2.1
- /api/docs/changes-6.2：changes-6.2
- /api/docs/changes-7.0.5：changes-7.0.5
- /api/docs/changes-7.0.6：changes-7.0.6
- /api/docs/changes-7.0.7：changes-7.0.7
- /api/docs/changes-7.0.8：changes-7.0.8
- /api/docs/changes-7.0.9：changes-7.0.9
- /api/docs/changes-7.0：changes-7.0
- /api/docs/codex_server_setup_4.2：codex_server_setup_4.2
- /api/docs/data_management：实验数据管理与可追溯
- /api/docs/deploy_codex：部署与更新（给 Codex / 运维的操作手册）
- /api/docs/figures：作图与数据展示规范
- /api/docs/llm_usage：模型该做什么、不该做什么
- /api/docs/model_bench：model_bench
- /api/docs/plugins：plugins
- /api/docs/reporting_checklists：投稿报告清单（MIQE / ARRIVE / 细胞系）
- /api/docs/skill_authoring：如何新增一种实验（写一个 skill）
- /api/docs/statistics：统计方法怎么选
- /api/docs/training：training
- /api/docs/þ+ÖCodex-4.2Úâ¿þ¢¦޻¦µÄ：þ+ÖCodex-4.2Úâ¿þ¢¦޻¦µÄ
- /api/docs/给Codex-4.2部署说明：给Codex-4.2部署说明

OpenAPI: /api/openapi.json   交互文档: /api/docs-ui