实验记录（ELN）完整指南

1. 实验标题（必填）：输入清晰的实验名称。建议格式：日期 + 实验类型 + 关键词，例如“2026-03-20 Western Blot p53 蛋白表达分析”。标题将用于全局搜索和报告抬头，最长 200 字符，支持中英文及特殊字符。
2. 研究方向（可选）：从团队已创建的研究方向中选择，用于将实验归类到项目分组。如果还没有研究方向，点击「新建研究方向」快速创建，无需离开当前对话框。
3. 模板选择：确认选中「空白实验」（默认选项），实验创建后包含空白内容区域和团队默认章节（如已配置）。
4. 负责人（可选）：默认为当前登录用户。PI 或 SUPER_ADMIN 可在此将实验创建者指定为其他团队成员（例如代博士生创建模板实验）。
5. 点击蓝色「创建」按钮。对话框关闭，页面自动跳转到实验编辑器，实验状态为 DRAFT。

1. 在创建对话框中选择「从模板创建」选项卡。
2. 浏览模板列表。模板分为两类：
   • 团队模板：由你的团队 SUPER_ADMIN 或 PI 创建的私有模板，只对团队内可见
   • 市场模板：社区共享的公开模板，可按研究领域筛选（PCR、细胞培养、免疫分析、质谱等）
3. 点击模板卡片可预览模板内容（章节结构、默认表格、协议步骤说明）。
4. 确认模板后点击「使用此模板创建」，填写实验标题，点击「创建」。

1. 在实验列表中找到要复制的历史实验，点击实验卡片右侧的「···」菜单，选择「复制实验」。
2. 填写新实验的标题（默认为“[副本] 原标题”，建议修改为有意义的名称）。
3. 点击「确认复制」。系统复制实验内容和章节结构，但 不复制：签名记录、版本历史、评论、已上传的附件链接（附件需重新上传）。

在实验编辑器中支持 Markdown 语法快捷输入，输入对应字符后按空格键自动转换：

• 实时光标：每位在线协作者的光标以不同颜色标识（颜色随机分配，每人固定），鼠标悬停可见用户名。当前有哪些人在实验中，在编辑器右上角「协作者」区域显示头像列表。
• 无冲突合并：多人同时编辑同一段落时，Yjs 使用 CRDT 算法自动合并所有改动，不会产生“版本冲突”弹窗。改动顺序依据操作时间戳精确排序。
• 离线支持：网络断线后，本地改动继续记录在浏览器本地存储中。重新连接时，离线期间的改动与服务器状态自动合并同步，不会丢失数据。
• 编辑权限：同一团队中角色为 RESEARCHER 及以上的成员均可同时编辑处于 DRAFT 或 IN_PROGRESS 状态的同一实验。TECHNICIAN 无法编辑实验内容。

CRDT 技术确保不会出现传统的“提交冲突”。具体行为如下：

• A 在句子末尾输入“字符 X”，B 同时在同一句子末尾输入“字符 Y”：最终结果是“字符 XY”或“字符 YX”（取决于时间戳顺序），两人的输入都被保留。
• A 删除了一段文字，B 同时在同一段文字末尾追加内容：A 的删除操作保留，B 追加的内容被保留在删除位置附近（不丢失）。
• 如果最终合并结果不符合预期，可使用「版本历史」查看每次改动，找到具体是哪位成员的操作导致了预期外结果。

1. 进入实验详情页，状态标签显示在实验标题右侧（蓝色药丸形按钮）。
2. 点击状态标签，弹出状态选择下拉框，显示当前可推进到的状态（不允许跳级，不允许回退）。
3. 选择目标状态，系统弹出确认对话框，提示“此操作不可回退，是否确认？”
4. 点击「确认」，状态立即更新，审计追踪同步记录：操作人、时间戳、IP 地址、旧状态→新状态。

PonyLab 的电子签名符合以下法规要求：

• 21 CFR Part 11（美国 FDA）：电子签名必须与签名时刻的记录内容绑定，使用者身份须通过独立凭据验证（密码，不接受 Session Cookie），签名不可被修改或剥离。
• GLP（优良实验室规范）：原始数据必须有签名，签名后不可修改。
• GMP（优良生产规范）：生产批记录需要操作人和审核人双签。

PonyLab 的实现机制：签名时系统计算实验内容的 SHA-256 哈希值，并与签名者 ID、时间戳、IP 地址一起存储。任何内容改动（即使一个空格）都会导致哈希值不匹配，系统可检测篡改。

1. 确认实验状态：实验必须处于 COMPLETED 状态才能签名。如当前为 DRAFT 或 IN_PROGRESS，先将状态推进到 COMPLETED。
2. 最终内容审查：在签名前仔细阅读实验全文，因为签名后内容永久锁定。检查：数据是否完整、无遗漏；单位是否正确；附件是否全部上传；方法描述是否清晰。
3. 点击「签署实验」按钮：该按钮位于实验页面顶部右侧，图标为铅笔/签名样式，状态不为 COMPLETED 时按钮显示灰色不可点击。
4. 弹出签名对话框：对话框显示以下字段：
   • 邮箱地址：自动填写当前登录账号的邮箱，不可修改
   • 密码（必填）：输入账号密码（不接受 Session Token，必须重新输入密码），这是二次身份验证，确保签名人是账号持有者本人
   • 签名含义声明（可选）：输入本次签名代表的含义，例如“本人确认已按 SOP-PCR-001 规程完成上述实验操作，所记录数据真实准确”。声明将附加在签名记录中，出现在合规报告里
5. 点击「确认签名」：系统验证密码，计算内容哈希，写入签名记录，实验状态自动变为 SIGNED，所有编辑入口关闭。整个过程约 2-3 秒。

1. 主签名完成后（实验处于 SIGNED 状态），实验页面顶部出现「请求见证人签名」按钮。
2. 点击该按钮，弹出见证人选择对话框，显示团队成员列表（主签名者本人已被自动过滤排除，系统强制要求见证人与主签名者不同）。
3. 选择见证人：从列表中选择一名或多名见证人。建议选择有专业资质、了解该实验领域的成员（如 PI 或高级研究员）。
4. 添加消息（可选）：输入给见证人的说明，例如“请审阅第 3 节的 Western Blot 数据并作为见证人签名”。
5. 点击「发送请求」。系统向选中的见证人发送：应用内通知（立即）+ 邮件通知（含实验直链，几分钟内到达）。

1. 见证人打开邮件通知中的实验直链，或在应用内通知中点击，进入实验页面。
2. 页面顶部显示「你被请求作为见证人签名」提示条（黄色背景）。
3. 见证人仔细阅读实验全文（只读模式），可以滚动查看所有内容和附件。
4. 确认无误后，点击「作为见证人签名」按钮。弹出签名对话框，输入见证人自己的账号密码（同样是二次身份验证）。
5. 可填写见证人声明，例如“本人已独立审阅上述实验记录，内容与实验操作记录一致，确认签名”。
6. 点击「确认见证签名」，实验状态变为 WITNESSED。

两份签名（主签名 + 见证人签名）均记录在实验的不可篡改审计追踪中，每条签名记录包含：

• 签名人全名和邮箱地址
• 签名时间戳（精确到毫秒，UTC 时区）
• 客户端 IP 地址
• 浏览器 User-Agent 信息
• 签名时的内容 SHA-256 哈希值
• 签名含义声明（如填写）

这些记录可在实验详情页的「审计」标签中查看，也可在 合规与审计 → 电子签名报告 中导出为 PDF。

1. 进入实验详情页，点击编辑器工具栏右侧的「历史」按钮（时钟图标）。
2. 左侧面板显示版本列表，每条记录包含：版本号、作者头像 + 姓名、时间戳（相对时间和绝对时间）、变更摘要（如“修改了第 2 节”）。
3. 点击某版本，右侧主区域显示该版本的完整内容（只读模式）。

1. 在版本列表中选中一个版本，再按住 ⌘/Ctrl 点击另一个版本，进入双版本对比模式。
2. 编辑器以双栏布局显示两个版本的内容，差异以颜色高亮：绿色背景表示新增内容，红色背景表示删除内容，无背景表示未变化内容。
3. 点击右上角「退出对比」回到单版本预览。

1. 在版本列表中，找到要恢复的目标版本，点击「恢复此版本」按钮。
2. 系统弹出确认对话框，说明：“此操作将在当前内容的基础上创建新版本，内容恢复为所选历史版本。历史版本不受影响。”
3. 点击「确认恢复」。系统创建新版本（版本号递增），内容与所选历史版本完全相同，并在审计追踪中记录“恢复至版本 N”操作。

1. 前往 设置 → 实验模板（需要 PI+ 权限）。
2. 点击「新建模板」按钮，弹出模板编辑器（与实验编辑器相同界面）。
3. 设计模板结构：
   • 创建章节标题（如“目的”、“材料与试剂”、“实验方案”、“结果”、“结论”）
   • 在章节下预填格式说明文字（用 斜体 注明这是提示，使用者可替换）
   • 插入预格式化表格（如数据记录表，列头预填，行可添加）
   • 添加协议步骤的有序列表框架
4. 填写模板元数据：
   • 模板名称（必填）：清晰描述实验类型，例如“Western Blot 蛋白质检测”
   • 描述（可选）：适用场景和注意事项
   • 标签（可选）：用于在模板列表中筛选
   • 可见性：选择「团队私有」或「发布到社区」
5. 点击「保存模板」。模板立即出现在新建实验时的模板列表中。

• 前往「设置 → 实验模板」，点击模板卡片上的「编辑」按钮，进入模板编辑器修改内容。保存后的更改只影响后续使用此模板创建的新实验，不影响已创建的实验。
• 点击「删除」按钮删除模板。删除后此模板不再出现在创建实验的选择列表中，但基于此模板已创建的实验不受影响。

1. 在左侧导航点击「模板市场」，浏览社区共享的实验模板。
2. 使用顶部筛选器按研究领域（分子生物学/细胞生物学/生化/有机化学等）和实验类型（PCR/ELISA/Western Blot 等）筛选。
3. 点击模板卡片可预览完整模板内容和其他用户的使用评分。
4. 点击「导入到团队」，模板添加到你的团队私有模板列表，可再次编辑修改适配本实验室需求。

1. 在「设置 → 实验模板」中，找到要共享的模板，点击「发布到市场」。
2. 填写：完整的模板描述、适用实验类型、需要的仪器设备、标准参考（如相关 SOP 编号）。
3. 提交后进入人工审核队列，通常 1-3 个工作日内审核完成。审核通过后模板对所有 PonyLab 用户可见。

• AI 无法访问实验室外部的实验数据或参考数据库（不联网），建议在提问时提供必要背景
• AI 生成的内容（如结论段落）需要研究人员自行审阅验证，不应未经审阅直接作为实验记录的正式内容
• AI 对话记录不纳入实验的合规审计追踪，仅存储在 AI 对话历史中
• 图片附件内容目前无法直接分析（仅知道附件存在，无法识别图片内容）

• 将 CSV 文件拖拽到实验编辑器中上传后，系统自动在后台触发异常检测（不影响编辑操作）。
• 检测完成后（通常 5-15 秒），在附件旁出现「异常报告」标签（橙色感叹号），点击查看检测结果。
• 也可以手动触发：在已上传的 CSV 附件上点击「运行异常检测」。

导出的 PDF 报告遵循以下固定结构：

1. 封面页：团队名称（logo）、实验标题、实验 ID、创建日期、状态
2. 签名页：主签名者信息、见证人信息（如有）、签名时间、签名含义声明
3. 实验内容：与编辑器中完全相同的排版，标题层级保留、表格保留
4. 附件清单：所有附件的文件名、上传时间、文件大小（图片类型含缩略图）
5. 审计追踪摘要：创建时间、所有状态变更记录

1. 在实验详情页右侧面板找到「标签」区域（位于成员信息下方）。
2. 点击「+ 添加标签」，弹出标签输入框。
3. 输入标签名称（如“PCR”、“阳性结果”、“重复实验”），按 Enter 确认。标签不区分大小写，“PCR”和“pcr”是同一标签。
4. 已有的标签名称会在输入时自动提示（避免创建重复标签），直接选择即可。

• 在实验列表页面右侧的「筛选器」面板中，展开「标签」分组，勾选一个或多个标签，列表自动过滤为包含所选标签的实验（AND 逻辑：同时包含所有选中标签）。
• 也可以直接点击某实验的标签芯片，快速筛选相同标签的所有实验。
• 在标签管理（设置 → 标签管理）中可查看每个标签的使用次数，清理低频标签。

• 实验方案部分使用有序列表记录步骤，每步包含：操作内容、数量/浓度/时间、关键参数
• 结果部分使用表格记录数值数据，而非在正文中堆砌数字
• 每次出现偏离预期的结果，在编辑器中注明观察到的现象和可能原因
• 实验结束当天完成记录（不要积压多天后补记，这在合规上有争议）
• 使用「任务列表」功能记录后续待完成的事项

• 签名前的最终检查清单：数据完整性、单位一致性、附件是否全部上传、缩写定义是否清晰
• 签名含义声明不要使用通用语，应针对本实验写具体的声明（增加法律效力）
• 对于多人参与的实验，应在实验内容中@提及所有参与实验操作的成员，而不仅仅是记录者签名