协议管理

协议与 SOP

PonyLab 的协议管理模块支持创建、版本化、发布和执行标准操作规程(SOP),追踪偏差,并与培训记录集成。AI 可从文本和 PDF 中自动解析操作步骤。本页提供每个功能的完整操作指引。

协议生命周期

草稿Draft可自由编辑提交审核待审核Under Review等待审核人签名批准发布已发布Published团队可使用创建新版本新版本草稿New Versionv1.0 → v2.0退回修改

协议一旦发布(Published),当前版本不可直接编辑。任何修改都需要创建新版本,经审核后发布新版本取代旧版。旧版本永久存档,不可删除。

核心概念:什么是协议(SOP)?

标准操作规程(SOP,Standard Operating Procedure)是描述如何一步步完成特定实验或操作任务的书面文件。对于非技术用户而言,可以把 SOP 理解为「实验室专用菜谱」——它规定了原料(试剂)、工具(仪器)和步骤顺序,以确保每次执行得到可重复、可靠的结果。

在受监管的实验室环境中(如 GLP、GMP),SOP 还具有法律意义:它记录了你的实验室声称使用的方法,偏离 SOP 的任何操作都必须记录并评估其影响。

概念定义在 PonyLab 中对应
协议(Protocol)描述如何完成特定操作的文档,包含目的、范围、步骤、注意事项协议模块中的每一条记录
版本(Version)协议的一次修订,用 v1.0、v1.1、v2.0 等语义版本号标识协议详情页的「版本历史」标签
发布(Publishing)将协议正式对团队公开,表明该版本经过审核批准,可供使用状态为 已发布 的协议
执行(Execution)在实际实验中按协议步骤操作,并逐步记录完成情况实验编辑器中的「协议执行模式」
偏差(Deviation)实际操作与协议规定步骤不符的情况,必须记录并评估影响执行模式中的「记录偏差」功能
培训记录记录成员已完成该协议培训的证明,是授权操作的前提协议设置 → 培训要求

创建协议(逐步操作)

在左侧导航点击「协议」,进入协议列表页,点击「+ 新建协议」。

基本信息填写

  1. 填写「协议标题」(必填):建议使用标准化命名格式,包含编号和描述性名称。例如:「SOP-BIO-001:细胞复苏标准操作规程」。清晰的命名有助于团队成员快速识别和搜索。
  2. 选择「类别」(必填):对协议进行分类,方便筛选和浏览。
    • 样品处理:涉及样品采集、储存、制备的操作
    • 仪器操作:仪器的标准使用和维护规程
    • 数据分析:数据处理、计算和报告规程
    • 安全规程:实验室安全操作和应急处置
    • 培训:新成员培训材料和考核规程
    • 自定义类别:在「设置 → 协议类别」中添加机构专属类别
  3. 填写「适用范围」(选填):描述该协议适用的实验类型、样品类型或仪器。例如:「适用于所有需要使用流式细胞仪(BD FACSCanto II)分析细胞表面标记物的实验」。
  4. 选择「作者」:默认为当前登录用户,可以更改为其他团队成员(例如,由助理录入但实际由 PI 起草的协议)。
  5. 选择「审核人」(建议填写):协议发布前需要审核并电子签名的团队成员。通常为资深研究人员或 PI。可以选择多位审核人(所有审核人都需签名方可发布)。
  6. 设置「有效期」(选填):协议的有效期限,到期后系统提醒重新审核。对于受监管环境,通常为 1–2 年。
  7. 点击「创建草稿」,进入协议编辑器界面。

协议字段完整说明

字段必填说明示例
协议标题必填建议格式:编号-类型-描述,1–200 字符SOP-BIO-001:细胞复苏
类别必填样品处理/仪器操作/数据分析/安全/培训(可自定义)样品处理
适用范围选填描述适用的实验类型或仪器,支持富文本适用于所有 PCR 实验
作者必填协议起草人,默认为创建者张研究员
审核人选填发布前需签名的成员,可多人;未设置则跳过审核直接发布李 PI(课题组长)
关键词选填用于搜索的标签,最多 10 个PCR, 分子生物学, 扩增
有效期选填到期前 30/14/7 天发送提醒2026-12-31
相关文档选填关联其他协议(如前置操作 SOP)SOP-BIO-000:通用安全
内容必填富文本编辑器,支持步骤列表、表格、图片、附件(见「编辑协议内容」章节)

编辑协议内容

PonyLab 协议编辑器是一个富文本编辑器,支持多种内容格式,帮助你创建结构清晰、可执行的操作规程。

推荐的协议结构

一份完整的 SOP 通常包含以下章节(可根据需要增删):

章节内容是否必须
1. 目的本 SOP 的目标是什么,解决什么问题推荐
2. 适用范围适用于哪些实验、样品类型、仪器推荐
3. 安全注意事项危险品警告、个人防护要求涉及危化品时必须
4. 所需材料试剂清单(含浓度/规格)、仪器设备、耗材推荐
5. 操作步骤编号操作步骤,每步包含具体操作、参数和预期结果必须
6. 结果判读如何判断实验成功/失败;正常结果的特征描述推荐
7. 故障排查常见问题及解决方法选填
8. 参考资料参考文献、产品说明书、相关 SOP 编号选填

编辑器功能

在协议编辑器中,使用 / 命令(斜杠命令)快速插入特殊格式:

命令插入内容用途
/step带复选框的可执行步骤块执行协议时可逐步打勾确认
/table表格列出试剂配方、参数对照表
/warning黄色警告框安全注意事项、危险品警告
/tip蓝色提示框操作技巧和经验提示
/image图片上传区域插入步骤说明图、设备照片
/file文件附件附加仪器手册 PDF、数据模板
/protocol嵌入其他协议引用引用通用前置 SOP(如通用安全规程)

提示

协议步骤建议使用「编号列表」格式(1. 2. 3.),配合 /step 命令创建可勾选版本。每步应明确描述:做什么、用什么参数、预期结果是什么。例如:「3. 将细胞悬液以 300 × g 离心 5 分钟,室温。预期结果:可见明显细胞沉淀,上清透明。」

版本控制

PonyLab 使用语义版本号(major.minor,如 v1.3)追踪协议变更。版本控制确保团队始终使用最新批准的方法,同时保留完整的变更历史供审计使用。

为什么版本控制如此重要?

在科研和合规场景中,协议版本控制解决以下关键问题:

  • 可溯源性:2 年前的实验使用的是哪个版本的 PCR 方案?版本历史提供明确答案。
  • 合规要求:GLP/GMP 法规要求记录方法变更,证明任何修改都经过审核批准。
  • 防止误用:发布机制确保团队成员只使用经过批准的版本,而非个人修改版。
  • 变更影响分析:通过版本 diff 功能,可以精确了解每次修订改变了哪些内容。

版本类型说明

版本类型版本号变化适用情况是否需要重新审核
次要修订(Minor)v1.0 → v1.1错别字修正、格式调整、澄清说明、添加提示,不改变操作步骤实质不需要
主版本更新(Major)v1.x → v2.0操作步骤、参数、试剂配方或合规要求发生实质性变更必须重新审核

创建新版本(逐步操作)

  1. 打开已发布协议的详情页,点击右上角「创建新版本」按钮。
  2. 在弹出对话框中选择版本类型:「次要修订」或「主版本更新」。选择后系统自动建议下一版本号(如 v1.2 或 v2.0)。
  3. 填写「变更说明」(必填):简要描述本次版本修改的内容和原因。例如:「根据 2024-03-15 的实验室审核意见,将步骤 4 的离心时间从 5 分钟调整为 8 分钟,以提高细胞回收率。」
  4. 点击「创建草稿」,系统创建一个与当前发布版本内容相同的新草稿,在编辑器中打开。
  5. 在编辑器中进行必要的修改,修改内容实时自动保存。
  6. 修改完成后,若为次要修订可直接点击「发布」;若为主版本更新,需先点击「提交审核」完成审核流程后再发布。
  7. 新版本发布后,旧版本自动变为「历史版本」状态,团队成员使用协议时默认看到最新发布版本。

版本比较(Diff 查看)

  1. 在协议详情页,点击「版本历史」标签,查看所有版本列表(含版本号、创建时间、创建人、变更说明)。
  2. 勾选任意两个版本(通过左侧复选框),点击「比较版本」按钮。
  3. 系统显示并排或内联 diff 视图:新增内容以绿色高亮,删除内容以红色删除线显示,未变化内容以灰色显示。
  4. 点击「导出 Diff 报告」可将差异对比导出为 PDF,用于变更控制文档。

注意

协议一旦被标记为「已发布」状态,现有版本不可直接编辑。必须创建新版本,经审核后发布新版本,才能取代旧版。旧版本永久存档,不可删除。这是合规性要求。

审核与发布协议

协议发布流程确保所有对团队公开的操作规程都经过合格人员的审核和批准。

发布流程(逐步操作)

  1. 协议编写完成后,在协议详情页点击「提交审核」按钮。协议状态变为 待审核,系统通知所有指定审核人。
  2. 审核人登录后,在「通知」中点击链接或在协议列表中找到「待审核」状态的协议,打开详情页。
  3. 审核人仔细阅读协议内容,可以:
    • 在文档中选中文字后点击「添加评论」,提出具体修改意见(行内评论)
    • 在协议底部「评论区」发表整体意见
    • 如需修改:点击「退回作者」,填写退回原因,协议状态回到草稿,作者收到通知
  4. 若内容符合要求,审核人点击「批准并签名」:
    • 系统弹出电子签名对话框
    • 审核人输入账号密码(不接受免密认证)进行身份验证
    • 系统记录签名:姓名、邮箱、时间戳(UTC 精确到毫秒)、IP 地址、签名含义「已审核并批准此协议版本」
  5. 若设置了多位审核人,所有审核人都完成签名后,SUPER_ADMIN 或 PI 可以点击「发布」,协议状态变为 已发布,对全团队可见。

发布后效果

协议发布后,以下变化立即生效:

  • 协议出现在「新建实验」表单的「关联协议」下拉选择列表中
  • 可在实验编辑器中使用 /protocol 命令嵌入协议步骤
  • 出现在「协议列表」的「已发布」筛选结果中,团队所有成员可见
  • 可以被选为「培训协议」用于成员培训考核
  • 若已配置,可发布到「模板市场」供其他团队使用

提示

协议的「发布」权限默认仅限 SUPER_ADMIN 和 PI 角色。在「设置 → 角色权限」中可以调整,允许特定角色(如实验室管理员)直接发布次要修订。

协议执行模式

在实验中引用已发布协议后,可以开启「协议执行模式」,逐步跟踪操作进度,并记录每个步骤的完成状态。

启动协议执行

  1. 在实验记录编辑器中,找到已嵌入的协议引用块。若尚未嵌入,输入 /protocol 命令并搜索选择目标协议。
  2. 点击协议引用块右侧的「开始执行」按钮,进入协议执行模式。
  3. 系统为协议中的每个 /step 步骤显示独立的确认块,包含:
    • 步骤序号和内容描述
    • 空白的「实际操作记录」文本框(执行者填写实际参数、观测结果)
    • ✓ 确认完成」按钮和「记录偏差」按钮
  4. 按步骤顺序执行操作。每完成一步,在「实际操作记录」中填写观测到的结果(非必填,但强烈建议填写),然后点击「确认完成」。
  5. 所有步骤完成后,执行进度显示为 100%,协议执行块顶部出现绿色「执行完成」标记,记录完成时间戳。

执行进度追踪

  • 协议执行块顶部显示进度条,如「已完成 4/8 步骤」
  • 已完成步骤显示绿色对勾和完成时间戳;有偏差的步骤显示橙色警告图标
  • 中途关闭实验页面后,下次打开时执行进度自动恢复
  • 同一实验中同一协议可以多次执行(如多轮重复实验),每次执行记录独立存档

偏差记录

偏差(Deviation)是指实际操作与协议规定步骤不符的情况。在受监管实验室中,偏差必须记录、评估影响,并在必要时采取纠正措施。

何时记录偏差

以下情况应记录偏差(即使你认为影响不大):

  • 使用了不同品牌或批次的试剂
  • 操作参数(温度、时间、浓度等)与协议规定不符
  • 省略了协议中的某个步骤(如因仪器故障)
  • 使用了替代设备(如指定仪器正在维修)
  • 操作顺序与协议不同
  • 样品数量或规格与协议规定不符

记录偏差(逐步操作)

  1. 在协议执行模式中,在发现偏差的步骤旁点击「记录偏差」按钮(橙色),打开偏差记录表单。
  2. 选择「偏差类型」:
    • 材料替换:使用了不同的试剂/耗材
    • 参数调整:温度、时间、浓度等参数与规定不符
    • 步骤省略:跳过了某个协议步骤
    • 步骤变更:改变了操作顺序或操作方式
    • 仪器替代:使用了不同的仪器设备
    • 其他:不属于以上类型的偏差
  3. 填写「实际操作描述」(必填):详细描述实际执行的操作内容,以及与协议规定的具体差异。例如:「协议要求使用 Taq DNA 聚合酶(NEB),实验室库存已用尽,改用 FastTaq(Thermo Fisher)。」
  4. 填写「偏差原因」(必填):说明为什么产生了偏差。例如:「库存耗尽,补货需要 3 天,实验时间节点不允许等待。」
  5. 评估「对结果的潜在影响」:
    • — 预计对实验结果无实质影响,两种材料性能相当
    • — 可能对结果有一定影响,需要与协议规定的方法做对照实验确认
    • — 可能显著影响结果的可靠性或实验的合规性,需要质量审查
  6. 点击「保存偏差记录」。偏差记录与该步骤绑定显示,并计入实验记录的偏差汇总。
  7. 若偏差影响评级为「高」,且团队已配置相关自动化规则,系统自动弹出「创建 CAPA」提示(详见合规 → CAPA 管理)。

重要

偏差记录一旦保存不可删除,只可由 PI 或 SUPER_ADMIN 添加修正说明(附记)。所有偏差记录纳入 GLP/GMP 合规报告,并在审计追踪中永久存档。

培训记录

协议可以标记为「培训协议」,要求实验室成员在独立操作前完成学习和考核,确保所有操作人员具备必要的能力。

设置培训要求

  1. 在协议详情页,点击「设置」标签,找到「培训要求」区域。
  2. 勾选「作为培训材料」,开启培训功能。
  3. 设置「培训有效期」:培训记录在多少个月后过期(到期需重新培训)。常见设置:12 个月(年度复训)或 24 个月(两年一次)。
  4. 选择「培训方式」:
    • 自学阅读:成员自行阅读协议并确认
    • 现场培训:由培训师现场指导,由管理员记录完成情况
    • 带教实操:在带教老师监督下完成首次实际操作
  5. 点击「保存设置」。

记录成员培训完成

  1. 管理员进入「设置 → 团队成员 → 培训记录」。
  2. 找到目标成员,点击「添加培训记录」。
  3. 选择培训的协议(从已发布培训协议列表中选择)。
  4. 填写「培训完成日期」和「培训方式」,可上传培训证明文件(如签到表、考核结果)。
  5. 点击「保存」,系统记录本次培训并计算下次到期时间。

培训状态查看

  • 在协议详情页「培训」标签,可查看所有成员对该协议的培训状态(已完成 / 未培训 / 即将过期 / 已过期
  • 若成员在实验中引用了需要培训但本人尚未完成培训的协议,系统显示橙色提醒(不阻止使用,但记录在审计日志中)
  • 培训记录与仪器培训要求联动,仪器操作 SOP 的培训完成情况可作为仪器使用授权的前提条件

提示

在协议中嵌入「知识检查题」(使用步骤列表模拟多选题),帮助确认学员真正理解了操作要求,而不仅仅是阅读了文档。

模板市场

PonyLab 模板市场收录了来自社区的高质量协议模板,涵盖分子生物学、细胞培养、蛋白质组学等常见实验类型,帮助新团队快速建立标准操作规程体系。

浏览和导入模板

  1. 在左侧导航点击「模板市场」,或在协议列表页点击「浏览模板」按钮,进入模板市场页面。
  2. 使用以下方式筛选和搜索模板:
    • 在搜索框输入关键词(如「Western blot」「细胞培养」)
    • 按「研究领域」筛选:分子生物学 / 细胞生物学 / 蛋白质组学 / 基因组学 / 化学合成 / 其他
    • 按「实验类型」筛选:提取 / 检测 / 分析 / 合成 / 维护 / 其他
    • 按「步骤数量」排序(少→多 或 多→少)
    • 按「使用次数」排序(热门优先)
  3. 点击模板卡片,查看模板预览:
    • 模板描述、步骤数量、适用范围
    • 版本号和最近更新时间
    • 被使用次数和评分(社区反馈)
    • 发布团队/用户信息
    • 完整的步骤内容预览(前 5 步)
  4. 确认模板适合后,点击「导入到我的团队」,系统在你的团队中创建该模板的完整副本(不影响原始模板)。
  5. 导入的协议以「草稿」状态出现在你的协议列表中,可以自由修改内容、补充适合本团队的细节后,走正常的审核发布流程。

提示

导入模板后建议重点检查:① 试剂品牌和货号(替换为本实验室实际使用的产品);② 仪器参数(与本实验室仪器型号对应);③ 安全注意事项(补充本实验室特定规定)。

将协议发布到模板市场

  1. 在已发布协议的详情页,点击「发布到模板市场」按钮(需要 SUPER_ADMIN 权限或管理员授权)。
  2. 填写市场展示信息:
    • 模板简介:面向社区的说明,强调该协议的适用场景和特点
    • 研究领域标签:从预设标签中选择(多选)
    • 适用仪器型号:列出所需仪器的品牌和型号
    • 适用样品类型:人/鼠/细胞系/纯化蛋白等
    • 所需资质:操作该 SOP 需要的培训或经验
  3. 选择是否允许其他用户留下评论和评分(建议开启,有助于改进)。
  4. 点击「提交审核」,模板进入 PonyLab 平台的内容审核队列(通常 1–2 个工作日)。审核通过后模板公开上架。

最佳实践

分享高质量协议模板不仅有助于科研社区,也能提升实验室的学术知名度。被广泛使用的模板会在市场首页推荐展示。

AI 协议解析

通过 AI 自动从非结构化文本或 PDF 文件中提取操作步骤,无需手动逐一录入,大幅节省协议创建时间。

从文本解析(粘贴 SOP 文本)

  1. 在新建协议界面(或协议编辑器),点击「AI 解析」按钮,选择「从文本解析」。
  2. 在文本框中粘贴实验方法文本。适合粘贴的来源:
    • 论文的 Methods/Materials and Methods 部分
    • 产品说明书的操作步骤部分
    • 内部 Word 文档中的 SOP 文本
    • 邮件中描述的实验方案
  3. 点击「解析」按钮,AI 分析文本并自动识别:
    • 操作步骤(通过数字编号、「首先」「然后」「最后」等连接词识别)
    • 操作参数(温度、时间、转速、浓度等数值)
    • 所需材料(试剂名称、仪器名称)
    • 安全注意事项(含「危险」「注意」「警告」等关键词的句子)
  4. AI 解析完成后(通常 3–10 秒),结果显示在右侧预览面板中,以结构化步骤格式呈现。
  5. 仔细检查每个解析出的步骤,可直接在预览面板中编辑:
    • 点击步骤文字可直接编辑
    • 拖动步骤可调整顺序
    • 点击「+」在步骤间插入新步骤
    • 点击「✕」删除不需要的步骤
  6. 确认解析结果无误后,点击「导入到协议」,解析出的步骤填入协议编辑器。

从 PDF 解析(上传文件)

  1. 点击「AI 解析」→「上传 PDF」,或直接将 PDF 文件拖入上传区域。
  2. 系统对 PDF 进行 OCR(光学字符识别)处理,支持:
    • 中文、英文(以及中英混合)文档
    • 扫描版 PDF(通过 OCR 识别图片中的文字)
    • 含表格的 PDF(表格内容会被保留结构)
    • 多页 PDF(单次上传不超过 20 MB,页数不超过 200 页)
  3. 上传后,若 PDF 有多个章节,系统会显示章节目录,供你选择要解析哪些章节(例如只解析「操作方法」章节,跳过「背景介绍」)。
  4. AI 识别 PDF 中的操作步骤部分并提取为结构化步骤列表,流程与文本解析相同(步骤 4–6)。

AI 解析的准确性和局限性

情况解析准确性说明
编号步骤的文本(1. 2. 3.)优秀(95%+)清晰的编号格式是 AI 识别步骤的最可靠信号
段落式实验描述(论文方法)良好(80%+)AI 能识别时间顺序词,但需人工验证步骤边界
扫描版 PDF(图片格式)一般(70%)依赖 OCR 质量;手写部分或低质量扫描可能识别错误
含大量图表的 SOP一般(65%)图表中的操作描述可能被忽略;需手动补充图示步骤
涉及复杂分支逻辑(if/else)的 SOP有限(50%)AI 会提取所有步骤,但不能自动创建条件分支结构

注意

AI 解析结果必须由人工审核后才能使用。对于涉及危险品、高精度操作或合规要求的协议,必须由具有操作经验的研究人员验证每个步骤的准确性。AI 解析只是辅助工具,不能替代专业判断。

最佳实践

最佳实践

建立标准命名体系:在团队范围内统一协议命名格式,如「{类型}-{领域}-{编号}{描述}」(SOP-BIO-001:细胞复苏)。标准命名使搜索和引用更高效,也是合规审查的基本要求。

最佳实践

每个可执行步骤都用 /step 格式:创建协议时,将所有操作步骤都用 /step 命令创建为可勾选格式,而不是普通文本。这样在执行模式下操作人员可以逐步确认,避免遗漏步骤,也为审计提供精确记录。

最佳实践

定期审核和更新:建议每年审核一次所有有效协议,检查步骤是否仍然符合最新实验室规程和试剂供应情况。利用「有效期」功能设置自动提醒,避免遗忘。

最佳实践

偏差要及时记录:偏差应在操作当时或实验当天记录,而非事后追记。事后补记的偏差记录在审计日志中会有明显的时间间隔,可能被质量审查人员质疑。

提示

团队新成员入职时,先检查他们对哪些协议已完成培训。可以在「设置 → 培训记录」中批量查看新成员的培训状态,规划入职培训顺序。

典型使用场景

场景 1:新成员入职培训体系建立

实验室来了新的博士生,需要在 2 周内完成 10 个基础操作培训。

  • 将 10 个基础 SOP 标记为培训协议,设置有效期 12 个月
  • 为新成员创建「入职培训任务」,步骤为每个 SOP 的阅读和实操
  • 管理员在新成员完成每个 SOP 实操后,在培训记录中登记
  • 培训完成后,仪器使用权限自动解锁(通过仪器培训门控)

场景 2:GMP 生产环境的批次记录追踪

制药研究机构需要对每个生产批次的操作进行完整记录,满足 GMP 要求。

  • 每个生产步骤建立对应的 SOP,经 QA 审核发布
  • 生产人员在实验记录中引用 SOP 并使用执行模式逐步确认
  • 任何参数调整通过偏差记录机制记录,自动关联到批次记录
  • 批次记录完成后生成 GMP 批次报告,包含所有执行记录和偏差汇总

场景 3:从论文方法快速创建实验室 SOP

实验室想要重现一篇高影响力论文中的实验方法,需要将 Methods 部分转化为团队 SOP。

  • 复制论文 Methods 部分文本,使用 AI 解析功能提取步骤
  • 对 AI 解析结果进行审核,补充本实验室的具体试剂品牌和仪器型号
  • 添加本实验室的安全注意事项和实验技巧
  • 经 PI 审核签名后发布,供团队成员引用使用

常见问题(FAQ)

Q: 协议发布后发现有错误,如何修正?

A: 发布版本不可直接编辑。需要点击「创建新版本」,若仅是错别字或描述澄清(不影响操作步骤实质),选择「次要修订」;若是步骤内容错误,选择「主版本更新」并走完整审核流程。修正说明在变更记录中填写,确保审计追踪的完整性。

Q: 哪些角色可以发布协议?

A: 默认情况下,SUPER_ADMIN 和 PI 角色可以发布协议。RESEARCHER 角色可以创建和编辑草稿,可以提交审核,但不能直接点击「发布」按钮。角色权限可在「设置 → 角色权限」中自定义(例如允许实验室管理员角色发布次要修订)。

Q: 实验引用了某个协议后,协议被更新了,实验记录会受影响吗?

A: 不会。实验记录引用的是协议的特定版本(通过版本 ID 锁定),协议更新为新版本后,旧实验记录中的引用仍指向其引用时的版本。实验记录会显示「[协议名称] v1.2(当前最新版本为 v2.0)」的提示,便于审查时了解使用的方法版本。

Q: AI 解析能处理中文协议吗?

A: 能。AI 解析支持中文、英文和中英混合的文本。对于中文协议,AI 通过识别「步骤一」「第一步」「首先」「然后」「最后」「注意」等关键词来定位步骤边界,准确率通常在 85% 以上。

Q: 协议模板和协议有什么区别?

A: 在 PonyLab 中,「协议」是你团队内部发布和使用的 SOP;「模板」是协议的一种展示形式,经你授权发布到公共市场供其他团队导入使用。当其他团队导入你的模板后,他们得到的是你协议的副本,修改副本不会影响你的原始协议。

Q: 偏差记录会阻止实验提交或签名吗?

A: 不会自动阻止。有偏差记录的实验可以正常提交审阅和签名。但有偏差的实验在签名对话框中会显示「该实验包含 N 条偏差记录」的警告摘要,签名人确认后方可完成签名。系统确保审阅人知晓偏差存在,而不是忽略。

Q: 培训记录如何与仪器使用权限挂钩?

A: 进入「仪器管理 → [仪器名称] → 培训要求」,可以设置使用该仪器前必须完成的协议培训。设置后,若成员尝试在实验中引用该仪器,系统检查其培训记录:已完成则正常引用;未完成则显示警告「你尚未完成 [SOP 名称] 培训,请联系管理员」(不强制阻止,仅警告)。

Q: 旧版本的协议还能被执行吗?

A: 可以查看但不推荐执行。在协议版本历史中点击旧版本,可以查看其完整内容,也可以将旧版本嵌入实验记录(但会显示「该版本已过时,当前最新版本为 vX.X」的橙色警告)。若你的实验有特殊原因必须使用旧版本,请在实验记录中注明原因。

Q: 如何批量导入多个旧有协议?

A: 目前支持通过以下方式批量导入:① 使用 API(POST /protocols/batch-import)上传 JSON 格式的协议数据;② 联系 PonyLab 支持团队,提供 Excel 或 Word 格式的协议文档,由专业服务团队协助批量迁移。每个协议仍需经过审核发布流程才能正式生效。

Q: 协议中的图片和附件文件有大小限制吗?

A: 协议内嵌图片:单张不超过 10 MB,JPEG/PNG/GIF 格式;协议内嵌附件:单个文件不超过 50 MB,支持 PDF、Excel、Word 等格式;一个协议的总附件大小不超过 200 MB。超出限制时系统提示,可通过外部链接(如机构云存储)替代大文件。

Q: 模板市场的协议经过质量验证吗?

A: 模板市场的协议经过 PonyLab 内容团队的基本审核(检查完整性和格式规范),但不对科学内容的准确性负责。使用前应由具有相关实验经验的研究人员验证步骤内容。社区评分和评论是判断模板质量的重要参考。

故障排查

问题:提交审核后,审核人没有收到通知

原因:可能原因:① 审核人的通知设置关闭了邮件通知;② 审核人邮件进入垃圾箱;③ 创建协议时未正确设置审核人。

解决方法:① 在协议详情页「审核人」字段确认是否正确设置了审核人;② 点击「重新发送通知」按钮(审核状态下可用);③ 通知审核人检查垃圾邮件箱;④ 审核人也可以在协议列表中通过「待审核」状态筛选找到需要审阅的协议。

问题:AI 解析结果步骤顺序混乱

原因:通常是由于原文中步骤的编号格式不一致(如混合使用「1.」「(1)」「步骤一」等),导致 AI 对步骤边界的判断出现偏差。

解决方法:在 AI 解析预览面板中,手动拖动调整步骤顺序。对于质量较差的解析结果,建议先在原文本中统一编号格式(全部改为「1. 2. 3.」形式),再重新粘贴解析。

问题:协议无法从「已发布」状态退回到「草稿」

原因:这是设计上的限制,防止已发布的协议被未经授权地修改或撤回。已发布版本必须保持不变,以满足合规审计要求。

解决方法:若需要撤回已发布协议(如发现重大错误),方法是:① 创建新版本并紧急发布修正(快速通道);② 若需要完全停用,由 SUPER_ADMIN 将协议状态改为「已停用」(过时),该协议不再出现在选择列表中,但历史记录保留。

问题:PDF 解析失败,显示「无法识别文档内容」

原因:① PDF 为纯图片格式(扫描版),且扫描质量极低(低于 150 DPI);② PDF 使用了特殊字符集或加密保护;③ 文件损坏。

解决方法:① 使用 Adobe Acrobat 等工具提高扫描 PDF 的 OCR 质量后重试;② 检查 PDF 是否有密码保护(先去除密码);③ 尝试用 PDF 阅读器重新打开并另存为新 PDF;④ 若仍无法解析,使用复制文本的方式(从 PDF 中手动复制文本后使用「从文本解析」)。

问题:版本历史显示版本号跳跃(如从 v1.0 直接跳到 v1.3)

原因:每次保存草稿都会生成内部版本号,但只有标记为「次要修订」或「主版本更新」并发布的版本才显示在版本历史列表中。中间的草稿自动保存版本不在历史记录中显示。

解决方法:这是正常现象,不是 bug。若需要查看所有中间保存记录,在版本历史页面开启「显示草稿保存记录」开关(仅 SUPER_ADMIN 可见)。

问题:协议执行模式中,步骤已全部勾选但进度仍显示未完成

原因:可能存在隐藏步骤(嵌套在折叠的章节中)未被勾选,或因网络问题部分勾选状态未同步。

解决方法:① 展开协议中所有折叠章节,检查是否有遗漏的步骤;② 刷新页面后重新检查进度;③ 若问题持续,在协议执行面板点击「重置并重新检查」,系统重新扫描所有步骤状态。

问题:协议被删除后,历史实验中的引用出现「协议已删除」错误

原因:协议被彻底删除后,引用该协议的实验记录中对应引用失效。PonyLab 默认不允许删除有历史执行记录的协议,但 SUPER_ADMIN 可以强制删除。

解决方法:建议不要彻底删除协议,而是将其状态改为「已停用」。若已删除且实验记录引用失效,联系 PonyLab 支持团队,通过数据库恢复协议内容(仅在数据库备份周期内可恢复)。

问题:从模板市场导入的协议,内容与预览显示不一致

原因:模板作者在你导入后更新了模板,但已导入的副本不会自动同步更新(导入是快照式拷贝)。

解决方法:这是正常的设计行为。若需要使用最新版本,重新进入市场,找到该模板,再次点击「导入」(此时会提示已有导入版本,确认后导入新副本)。两个版本的协议可以并存于你的协议列表中。