快速入门指南
本指南将带你完成账号注册、引导向导、团队创建、成员邀请、AI 配置,以及创建第一个实验的完整流程。每个步骤配有详细的字段说明和操作截图描述。预计完成时间:15 分钟。
开始之前,请确认:
- 现代浏览器(Chrome 90+、Firefox 88+、Edge 91+ 或 Safari 14+)
- 有效的电子邮件地址(用于账号注册与邮件验证)
- 无需安装任何软件 — PonyLab 完全基于 Web
- 如需 AI 功能,需准备 Anthropic、OpenAI 或 OpenRouter 的 API Key
- 稳定的网络连接(实时协作功能需要持续连接)
功能概览
PonyLab 是一款 AI 原生的开源实验室信息管理系统(LIMS + ELN),专为现代科研团队设计。它将电子实验记录本(ELN)、样品管理、仪器预约、合规审计和 AI 辅助分析集成在统一平台上。
| 核心模块 | 解决的问题 | 典型用户 |
|---|---|---|
| 实验记录(ELN) | 替代纸质实验记录本,支持实时协作和电子签名 | 研究员、博士生 |
| 样品管理 | 追踪样品位置、谱系和状态,扫码即可定位 | 所有实验室成员 |
| 库存管理 | 试剂耗材低库存预警,自动预测补货时间 | 实验技术员、PI |
| 仪器管理 | 仪器预约防冲突,维护记录,IQ/OQ/PQ 鉴定 | 所有成员、设备管理员 |
| 合规与审计 | 符合 21 CFR Part 11 / GLP / GMP 的不可篡改审计追踪 | PI、质量经理 |
| AI 助手 | 自然语言搜索、自动报告生成、异常检测 | 所有成员 |
PonyLab 采用 团队隔离 模型:每个团队的所有数据(实验、样品、仪器)完全隔离,不同团队之间无法互相访问数据。
核心概念
团队(Team)
团队是 PonyLab 的顶层组织单位,对应一个实验室或研究组。所有资源(实验、样品、仪器、成员)都属于某个团队。每位用户可以属于多个团队,在不同团队中可以有不同的角色。
提示
角色体系
PonyLab 采用四级角色体系,权限从高到低依次为:
| 角色 | 对应职位 | 核心权限 |
|---|---|---|
| SUPER_ADMIN | 实验室负责人、系统管理员 | 全部权限,包括计费、成员管理、所有数据访问 |
| PI | 课题组长、主任 | 审阅和签署实验、管理研究方向、查看所有数据 |
| RESEARCHER | 研究员、博士生、硕士生 | 创建和编辑实验、样品、任务,不可修改团队设置 |
| TECHNICIAN | 实验技术员、助理研究员 | 操作仪器和样品、执行协议,不可创建实验 |
角色层级图
实验(Experiment)
实验是 ELN 的核心单元,对应一次具体的科学实验活动。每个实验有唯一 ID、完整的版本历史和生命周期状态(DRAFT → IN_PROGRESS → COMPLETED → SUBMITTED → SIGNED → WITNESSED)。实验内容在签名后永久锁定,符合 21 CFR Part 11 要求。
研究方向(Research Direction)
研究方向是用于对实验进行层级归类的分组容器,类似于项目文件夹。一个研究方向下可以包含多个实验。例如:“BRCA1 基因功能研究”下包含多轮 PCR 实验。
创建账号(详细)
访问 ponylab.io/register 开始注册流程。PonyLab 提供两种注册方式:
方式一:邮箱注册
- 姓名(必填):输入你的全名,例如“张三”或“San Zhang”。此名称将显示在实验记录、审计追踪和电子签名中,建议使用真实姓名。最长 100 字符。
- 邮箱地址(必填):输入有效的邮箱地址。系统会发送验证邮件到此地址,必须验证后方可登录。建议使用机构邮箱(.edu 或 .org 结尾),便于团队管理员识别身份。邮箱地址不区分大小写,但必须格式正确(包含 @ 和域名)。
- 密码(必填):密码须满足以下所有条件:
- 至少 8 个字符
- 至少包含 1 个大写字母(A-Z)
- 至少包含 1 个数字(0-9)
- 建议包含特殊字符(!@#$%)以提高安全性
- 不允许使用常见弱密码(如“Password1”)
- 机构名称(可选):填写所在大学或研究机构名称,用于团队搜索时的身份展示。
- 点击蓝色「注册」按钮提交表单。系统在 30 秒内向你填写的邮箱发送验证邮件。
- 验证邮箱:打开收件箱,找到标题为“验证你的 PonyLab 账号”的邮件(如未收到,检查垃圾箱)。点击邮件中的蓝色「验证邮箱」按钮,有效期 24 小时。验证成功后自动跳转回登录页。
完成
方式二:Google 快捷登录
- 在注册页面点击「使用 Google 登录」按钮(显示 Google 徽标的白色按钮)。
- 浏览器弹出 Google 授权窗口,选择你的 Google 账号(如已登录多账号,选择正确的机构账号)。
- 点击「允许」授权 PonyLab 访问你的基本信息(姓名和邮箱地址)。PonyLab 不会访问你的 Google Drive 或其他 Google 服务。
- 首次 Google 登录后,系统会要求你填写「机构名称」(可选),然后自动进入引导向导。
提示
登录已有账号
- 访问 ponylab.io/login。
- 输入注册时使用的邮箱地址(不区分大小写)。
- 输入密码(区分大小写)。
- 可选勾选「记住我 30 天」,在此设备上保持登录状态。
- 点击「登录」按钮,系统验证凭据后跳转到仪表盘。
注意
重置密码
- 在登录页面点击「忘记密码?」链接。
- 输入注册时使用的邮箱地址,点击「发送重置邮件」。
- 检查收件箱,找到密码重置邮件,有效期 1 小时。
- 点击邮件中的「重置密码」链接,输入新密码(须满足密码要求)。
- 点击「确认新密码」,页面跳转回登录,使用新密码登录。
引导向导(4 步)
首次登录后系统自动启动 引导向导,帮助你完成基础配置。向导共 4 步,预计 5 分钟完成。向导中途关闭后,可通过右上角「完成配置」按钮(橙色提示条)重新进入。
创建或加入团队
选择你的使用方式:
创建新团队
你是第一个注册的,负责建立实验室的 PonyLab 账号
加入已有团队
你的同事已经创建了团队,使用邀请码加入
下一步发生什么:如选择“创建新团队”,系统跳转到团队名称填写;如选择“加入已有团队”,系统显示邀请码输入框。
配置实验室信息
填写实验室基本信息,这些信息将出现在合规报告和导出文档的抬头中:
- 团队名称(必填):例如“蛋白质组学研究组”或“Zhang Lab”。最长 100 字符,不允许使用特殊符号(除连字符和下划线)。
- 研究领域(必选):从下拉菜单选择主要研究方向:生物学 / 化学 / 材料科学 / 临床研究 / 环境科学 / 物理 / 其他。选择后影响 AI 功能的默认提示模板。
- 机构名称(可选):所属大学或研究机构,用于报告生成时填写抬头。
- 联系邮箱(可选):团队公共联系邮箱,用于系统通知。
- 团队 Logo(可选):上传 PNG/JPEG 格式的实验室标志(建议 200×200 像素),将显示在导出报告中。
完成
邀请团队成员(可跳过)
输入同事的邮箱地址和角色,系统立即发送邀请邮件。每次可以添加多个邮箱(点击「添加更多」按钮)。如果现在没有准备好,点击「稍后邀请」跳过此步骤,后续可在「设置 → 团队成员」中发送邀请。
下一步发生什么:被邀请成员会收到邮件,邀请链接有效期 7 天。成员点击链接后完成注册或登录,自动加入你的团队并获得分配的角色。
功能导览,进入控制台
系统播放约 2 分钟的交互式功能导览,展示主要模块的位置和用途。导览包含 6 个核心区域的高亮提示:仪表盘、实验记录、样品管理、仪器管理、AI 功能入口、设置。
点击「进入控制台」完成向导,系统跳转到仪表盘。向导结束后可随时通过「设置 → 帮助」重新播放功能导览。
创建新团队 vs 加入已有团队
在引导向导第 1 步,你需要做出这个决定。以下指南帮助你判断:
| 情境 | 推荐操作 | 原因 |
|---|---|---|
| 你是实验室 PI 或负责人,第一个注册 | 创建新团队 | 你将成为 SUPER_ADMIN,负责管理团队和邀请其他成员 |
| 你的导师/PI 已发送邀请链接给你 | 使用邀请链接加入 | 邀请链接直接加入,无需输入邀请码 |
| 你有团队管理员给你的邀请码 | 选择“加入团队”输入邀请码 | 邀请码为 8 位字母数字组合 |
| 你是多个项目的负责人,需要数据隔离 | 为每个项目分别创建团队 | 不同课题组的数据完全隔离,清晰管理 |
| 你是既有团队的新成员,但没有邀请码 | 联系团队管理员发送邀请 | 自行创建团队会导致数据分散,与同事无法共享 |
重要
创建账号
详细步骤见上方「创建账号」部分。
提示
创建第一个团队
如果你是第一个注册的(PI 或管理员),在引导向导中选择「创建新团队」,填写以下信息:
- 团队名称(必填):例如“蛋白质组学研究组 2026”。名称将显示在所有报告抬头,建议包含实验室或导师姓名。
- 研究领域(必选):从下拉列表中选择,影响 AI 功能的默认建议。
- 订阅计划(必选):
- 免费版:最多 5 名成员,5 GB 存储,基础 ELN 功能,无 AI 功能,无需信用卡
- 专业版:无成员上限,100 GB 存储,完整 AI 功能,电子签名合规套件,按月计费
- 企业版:私有化部署,无限存储,专属支持,联系销售获取报价
- 点击「创建团队」按钮。系统自动将你的账号设为该团队的 SUPER_ADMIN 角色,并跳转到向导第 2 步。
完成
邀请团队成员
前往 设置 → 团队成员,点击右上角「邀请成员」按钮(蓝色)。
- 邮箱地址(必填):输入被邀请成员的邮箱地址。支持一次输入多个邮箱(用逗号分隔,或点击「添加更多」添加行)。
- 角色(必选):从下拉菜单为每个被邀请人分配角色(见下方角色说明)。
- 个性化邀请消息(可选):填写简短欢迎语,会附在邀请邮件正文中。
- 点击「发送邀请」。系统立即发送邀请邮件,邀请链接有效期 7 天。
被邀请成员在邮件中点击「加入团队」链接后,如已有账号则直接加入;如没有账号则完成快速注册后加入。
| 角色 | 典型用户 | 权限说明 |
|---|---|---|
| SUPER_ADMIN | 实验室负责人 | 全部权限:计费、团队设置、成员管理、所有数据 |
| PI | 课题组长 | 可审阅和签署实验,管理研究方向,查看全部数据 |
| RESEARCHER | 研究员 / 博士生 | 创建和编辑实验、样品、任务,不可修改团队设置 |
| TECHNICIAN | 实验技术员 | 操作仪器和样品,执行协议,不可创建实验 |
注意
配置 AI
PonyLab 的 AI 功能(实验对话、报告生成、异常检测等)需要团队 SUPER_ADMIN 提供第三方 AI API Key。AI 功能为可选项,不影响其他功能正常使用。
- 前往 设置 → AI 配置(仅 SUPER_ADMIN 可见)。
- 选择 AI 提供商:
- Anthropic(推荐):使用 Claude 模型,在科研文本理解和中文支持方面表现最佳。API Key 格式为
sk-ant-api03-...,前往 console.anthropic.com 获取。 - OpenAI:使用 GPT-4o 等模型。API Key 格式为
sk-proj-...,前往 platform.openai.com 获取。 - OpenRouter:统一入口访问多种模型,API Key 格式为
sk-or-v1-...,支持按需选择最经济的模型。
- Anthropic(推荐):使用 Claude 模型,在科研文本理解和中文支持方面表现最佳。API Key 格式为
- 粘贴 API Key:将 Key 粘贴到文本框中。Key 提交后使用 AES-256 加密存储,团队任何成员(包括其他管理员)均无法查看原始值,只能覆盖或删除。
- 选择模型(可选):部分提供商支持选择具体模型版本。推荐 Anthropic 的
claude-3-5-sonnet(平衡性能与成本)或claude-3-opus(最高质量,成本更高)。 - 点击「验证并保存」按钮,系统发送一个小型测试请求验证 Key 有效性(消耗极少 Token,约 0.001 美元)。
- 验证结果:
- 绿色「AI 已配置」:Key 有效,所有 AI 功能立即可用
- 红色「验证失败」:Key 无效或额度不足,请检查 Key 是否完整复制
提示
完整权限矩阵
以下表格列出了 PonyLab 所有主要功能与各角色的权限关系。「是」表示可执行,「否」表示无权限,「仅自己」表示只能操作自己创建的内容。
| 功能 | SUPER_ADMIN | PI | RESEARCHER | TECHNICIAN |
|---|---|---|---|---|
| 团队管理 | ||||
| 修改团队设置 | 是 | 否 | 否 | 否 |
| 邀请和删除成员 | 是 | 否 | 否 | 否 |
| 修改成员角色 | 是 | 否 | 否 | 否 |
| 配置 AI API Key | 是 | 否 | 否 | 否 |
| 查看账单和用量 | 是 | 否 | 否 | 否 |
| 实验记录 | ||||
| 创建实验 | 是 | 是 | 是 | 否 |
| 编辑实验内容 | 是 | 是 | 是 | 否 |
| 查看所有实验 | 是 | 是 | 仅自己 | 仅自己 |
| 签署实验(电子签名) | 是 | 是 | 是 | 否 |
| 删除实验 | 是 | 否 | 否 | 否 |
| 样品与库存 | ||||
| 创建和编辑样品 | 是 | 是 | 是 | 是 |
| 调整库存数量 | 是 | 是 | 是 | 是 |
| 删除样品/库存 | 是 | 是 | 否 | 否 |
| 仪器管理 | ||||
| 添加和编辑仪器 | 是 | 是 | 否 | 否 |
| 预约仪器 | 是 | 是 | 是 | 是 |
| 记录维护 | 是 | 是 | 否 | 是 |
| 进行 IQ/OQ/PQ 鉴定 | 是 | 是 | 否 | 否 |
| 合规与审计 | ||||
| 查看审计追踪 | 是 | 是 | 否 | 否 |
| 导出合规报告 | 是 | 是 | 否 | 否 |
| 创建和管理 CAPA | 是 | 是 | 否 | 否 |
仪表盘详解
登录后默认进入 仪表盘,提供实验室运行状态的整体视图。仪表盘内容每 5 分钟自动刷新,也可点击右上角刷新图标手动刷新。
统计卡片(顶部行)
| 卡片名称 | 显示内容 | 点击行为 |
|---|---|---|
| 活跃实验 | 状态为 IN_PROGRESS 的实验总数(蓝色数字),及与上周相比的增减百分比 | 跳转到实验列表,自动筛选 IN_PROGRESS 状态 |
| 待处理任务 | 分配给当前用户且未完成的任务数,按截止日期排序,红色表示逾期 | 跳转到任务列表,自动筛选“分配给我” |
| 库存预警 | 低于最低阈值的库存条目数 + 30 天内到期的样品数 | 跳转到库存管理,自动筛选预警状态 |
| 待签名实验 | 状态为 COMPLETED 或 SUBMITTED、等待当前用户签名的实验数 | 跳转到实验列表,自动筛选待签名 |
图表区域(中部)
| 图表 | 说明 | 交互 |
|---|---|---|
| 实验活动趋势 | 过去 30 天每日新建实验数(折线图),可切换为近 7 天或近 90 天 | 悬停显示当日详情,可点击日期跳转到该日实验列表 |
| 实验状态分布 | 所有实验按状态分布的饼图(DRAFT/IN_PROGRESS/COMPLETED/SIGNED/WITNESSED) | 点击饼图片段,跳转到对应状态的实验列表 |
| 仪器预约日历 | 今日及未来 7 天的仪器预约情况,每行一台仪器,时间轴展示预约区块 | 点击预约区块查看详情;点击空白区块快速创建预约 |
最近活动(右侧面板)
实时显示团队成员的最近操作,每条记录包含:操作人头像、操作描述(如“张三 创建了实验 PCR-001”)、时间戳(相对时间,如“5 分钟前”)。最多显示 50 条,点击「查看全部活动」跳转到审计追踪页面。
提示
创建第一个实验(完整教程)
完成账号注册和团队设置后,按以下步骤创建并完成第一个实验记录:
进入实验列表
在左侧导航点击「实验记录」。默认显示“我的实验”视图,可切换到“全部实验”查看团队所有成员的实验。右上角可切换列表视图(默认)和网格视图。
点击「新建实验」
点击页面右上角蓝色「+ 新建实验」按钮,弹出创建对话框。
填写以下字段:
- 实验标题(必填):输入实验名称。建议格式:“YYYY-MM-DD 实验类型 关键词”,例如“2026-03-20 PCR 扩增 BRCA1 基因”。最长 200 字符。
- 研究方向(可选):从下拉菜单选择,用于归类管理。如未创建研究方向,可点击“新建研究方向”快速创建。
- 模板(可选):选择团队预设模板快速填充章节结构。首次使用可选“空白实验”,之后可导入社区模板。
- 负责人(可选):默认为当前登录用户,可修改为其他成员。
点击「创建」,进入编辑器
点击蓝色「创建」按钮,对话框关闭,页面跳转到实验编辑器。实验初始状态为 DRAFT(草稿),显示在标题下方的状态标签中。
填写实验内容
在富文本编辑器中记录实验内容。一个标准的实验记录通常包含以下章节:
- 目的:本次实验要解决的科学问题或验证的假设
- 材料与试剂:使用的样品(用
/sample插入实时样品卡片)、试剂和耗材清单 - 实验方案:详细的操作步骤(可使用有序列表),可关联已有协议(SOP)
- 结果与数据:实验观察、数值数据(可插入表格)、图片(拖拽上传)
- 讨论与结论:对结果的分析和下一步计划
提示
推进实验状态
点击实验标题旁的状态标签(蓝色药丸形),从下拉菜单选择新状态:
- 实验开始执行:将状态从
DRAFT改为IN_PROGRESS - 实验完成数据采集:将状态从
IN_PROGRESS改为COMPLETED - 提交给 PI 审阅(可选):将状态改为
SUBMITTED
完成
电子签名(可选,合规必须)
实验达到 COMPLETED 状态后,点击顶部「签署实验」按钮,输入账号密码(二次身份验证),完成电子签名。签名后实验内容永久锁定,状态变为 SIGNED。详见 实验记录完整指南 → 电子签名。
最佳实践
命名规范
- 实验标题包含日期前缀:
YYYY-MM-DD,便于按时间排序 - 样品名称使用统一前缀标识类型,例如:
CELL-(细胞系)、DNA-(DNA 提取物) - 批次号包含年份,例如:
BATCH-2026-01 - 仪器名称包含型号和资产编号,例如:
PCR 仪 ABI 7500 [资产 A-0023]
善用模板
- 为实验室最常用的 5-10 种实验类型创建标准模板,避免每次从头填写章节结构
- 模板中预填“材料与试剂”章节的表格格式,便于规范数据录入
- 将 SOP 以协议形式维护,在模板中引用 SOP 而非复制粘贴,确保版本统一
样品管理习惯
- 领取样品前在 PonyLab 中先更新库存,避免实验开始后才发现样品不足
- 每次分装时使用“派生样品”功能,保持谱系记录完整
- 给每个冻存管打印条码标签,扫码比手动搜索快 10 倍
AI 功能使用
- 实验完成后立即使用「生成 AI 摘要」功能起草结论段落,再人工润色,节省写作时间
- 上传 CSV 数据文件时,等待异常检测报告,重点关注标注为“离群值”的数据点
- 在 AI 对话中使用具体问题,例如“这组 Western Blot 数据的背景噪声是否在可接受范围内?”
合规习惯
- 实验完成后 24 小时内完成签名,避免时间跨度过长影响数据完整性认定
- 见证人签名不能使用主签名者的同一账号(系统会强制检查)
- 不要在草稿期间(DRAFT 状态)记录不真实内容,所有状态变更均不可逆
常见问题(FAQ)
Q:如何重置密码?
在登录页面点击「忘记密码?」,输入注册邮箱,系统发送重置链接(有效期 1 小时)。如果没有收到邮件,检查垃圾箱,或确认注册时使用的邮箱地址是否正确。
Q:我可以同时属于多个团队吗?
可以。一个 PonyLab 账号可以属于多个团队,在不同团队中可以有不同的角色(例如:在团队 A 是 RESEARCHER,在团队 B 是 PI)。切换团队通过顶部导航栏的团队选择器进行。
Q:PI 和 RESEARCHER 角色有什么区别?
核心区别有三点:1)PI 可以查看团队所有成员的实验,RESEARCHER 只能看自己的;2)PI 可以对他人的实验进行电子签名,RESEARCHER 只能签署自己参与的实验;3)PI 可以删除样品和库存,RESEARCHER 不能删除。
Q:如何将 RESEARCHER 升级为 PI?
只有 SUPER_ADMIN 可以修改角色。前往「设置 → 团队成员」,找到该成员,点击其角色标签,从下拉菜单选择新角色,立即生效。
Q:收不到验证邮件或邀请邮件怎么办?
1) 检查垃圾邮件文件夹;2) 确认邮件地址没有拼写错误;3) 等待 5 分钟后再检查(极少情况下邮件服务器有延迟);4) 在注册页面点击「重新发送验证邮件」;5) 如仍未收到,联系 [email protected] 并提供你的注册邮箱地址。
Q:仪表盘的数据多久更新一次?
统计卡片每 5 分钟自动刷新。最近活动面板实时更新(基于 WebSocket 推送)。如需立即刷新,点击仪表盘右上角的刷新图标。
Q:免费版有哪些限制?专业版值得升级吗?
免费版限制:最多 5 名成员、5 GB 存储、无 AI 功能、无电子签名合规套件(基础签名可用但无法导出合规报告)。如果你的实验室超过 5 人,或需要 AI 辅助和 GLP/GMP 合规报告,专业版是必要的。
Q:如何导出所有数据?数据可以迁移吗?
前往「设置 → 数据管理 → 导出全部数据」,系统打包所有实验(PDF + JSON)、样品列表(CSV)和审计追踪(CSV)为 ZIP 文件,通过邮件发送下载链接。企业版支持直接数据库导出工具(PostgreSQL dump)。
Q:可以用 API 与其他系统集成吗?
是的。PonyLab 提供完整的 REST API,支持读写实验、样品、库存等所有核心数据。前往「设置 → API 密钥」创建 Token,详细接口文档见 /docs/api 页面。
Q:实验签名后发现有错误怎么办?
签名后的实验内容不可修改(这是合规要求)。正确做法是:1) 创建一个新实验,标题注明「[更正版] 原实验标题」;2) 在新实验开头说明更正原因和原实验 ID;3) 在原实验的评论中注明已创建更正版(评论不影响签名完整性)。
Q:如何处理团队成员离职?
前往「设置 → 团队成员」,找到该成员,点击「停用账号」。停用后该成员无法再登录,但其历史实验和签名记录完整保留(合规要求)。不要直接删除账号,这会破坏审计追踪的完整性。
Q:PonyLab 是否符合 HIPAA 要求?
PonyLab 符合 21 CFR Part 11(电子记录和签名)和 GLP/GMP 要求。HIPAA 合规性取决于你的部署方式:专业版 SaaS 版本通过 SOC 2 Type II 认证,但如需完整 HIPAA BAA(商业合作协议),请联系企业版获取专属部署方案。
Q:使用哪个浏览器最稳定?
推荐 Chrome 最新版,PonyLab 在 Chrome 上进行最完整的测试。Firefox 88+ 和 Edge 91+ 完全支持。Safari 14+ 支持所有核心功能,但实时协作偶有轻微延迟。不支持 Internet Explorer 任何版本。
故障排除
问题:登录后页面一直显示加载中
原因:浏览器缓存与最新版本不兼容,或 Session Token 过期但未正常清除。
解决步骤:1) 强制刷新页面(Ctrl/⌘+Shift+R);2) 如仍无效,打开开发者工具 → Application → Cookies → 删除 ponylab.io 相关 Cookie;3) 重新登录。
问题:注册后 24 小时未收到验证邮件
原因:邮件被拦截为垃圾邮件,或邮箱域名有 SPF/DKIM 过滤规则。
解决步骤:1) 检查垃圾邮件文件夹;2) 将 [email protected] 加入白名单;3) 在登录页点击「重新发送验证邮件」;4) 如仍无效,改用 Google 快捷登录绕过邮箱验证。
问题:邀请链接点击后显示「链接已失效」
原因:邀请链接默认有效期 7 天,已过期;或链接被使用过一次(每个链接只能使用一次)。
解决步骤:联系团队 SUPER_ADMIN 重新发送邀请。管理员前往「设置 → 团队成员 → 待处理邀请」,点击对应邀请旁的「重新发送」按钮。
问题:侧边栏导航项目有些显示为灰色无法点击
原因:当前角色没有该功能的访问权限,或该功能需要升级订阅计划。
解决步骤:悬停在灰色菜单项上,Tooltip 会显示“需要 PI 角色”或“需要专业版”等提示。根据提示联系 SUPER_ADMIN 修改角色或升级计划。
问题:AI 功能入口显示灰色或报错「AI 未配置」
原因:团队 SUPER_ADMIN 还未配置 AI API Key,或 Key 已失效(额度耗尽或被撤销)。
解决步骤:联系 SUPER_ADMIN 前往「设置 → AI 配置」重新配置或更新 API Key。
问题:在手机/平板上界面显示异常
原因:PonyLab 主要针对桌面端(1024px 以上屏幕)优化,移动端支持有限。
解决步骤:在移动设备上,建议使用「条码扫描」和「快速库存调整」等专门针对移动端优化的功能。完整的实验编辑操作建议在桌面浏览器上进行。
问题:上传文件时一直显示「上传中」不完成
原因:文件超过 100 MB 限制,或网络连接不稳定导致上传中断。
解决步骤:1) 检查文件大小是否超过 100 MB;2) 超大文件先使用压缩工具(如 7-Zip)压缩;3) 如文件符合大小要求,检查网络连接,尝试切换到有线网络重新上传。
问题:页面在操作过程中突然崩溃,担心数据丢失
原因:浏览器内存不足(通常是标签页过多),或网络断开导致自动保存失败。
解决步骤:重新打开 PonyLab,进入对应实验。编辑器的自动保存每 1 秒执行一次,最多丢失 1 秒内的改动。查看实验版本历史确认最近保存的内容。
键盘快捷键
| 快捷键 | 功能 | 适用场景 |
|---|---|---|
| ⌘K / Ctrl+K | 打开全局搜索 | 任意页面 |
| ⌘B / Ctrl+B | 粗体 | 实验编辑器 |
| ⌘I / Ctrl+I | 斜体 | 实验编辑器 |
| ⌘Z / Ctrl+Z | 撤销 | 实验编辑器 |
| ⌘⇧Z / Ctrl+Shift+Z | 重做 | 实验编辑器 |
| ⌘⇧R / Ctrl+Shift+R | 强制刷新(绕过缓存) | 任意页面(故障排除用) |
| Esc | 关闭对话框/搜索面板 | 打开模态框时 |
| Tab | 表格中跳到下一单元格 / 增加缩进 | 实验编辑器表格 |
| ## + Space | 插入 H2 标题(Markdown 语法) | 实验编辑器 |
| - + Space | 插入无序列表 | 实验编辑器 |
| 1. + Space | 插入有序列表 | 实验编辑器 |
| ``` + Enter | 插入代码块 | 实验编辑器 |
典型使用场景
场景 1:课题组从纸质记录迁移到 PonyLab
张教授的蛋白质组学实验室有 8 名成员,一直使用纸质实验记录本。迁移步骤:1) PI 创建团队,邀请所有成员;2) 将常用实验类型(Western Blot、IP 实验等)制作为模板;3) 将历史样品通过 CSV 导入到系统;4) 新实验开始使用 PonyLab 记录,旧实验扫描归档到对应实验的附件。过渡期 2 周内完成全面迁移。
场景 2:GMP 环境下的合规实验记录
某生物制药公司质检部门需要满足 21 CFR Part 11 要求。配置方案:1) 为每位分析师创建独立账号(禁止共用);2) 所有分析实验必须在 COMPLETED 状态后由分析师和另一位同事分别签名;3) 每季度导出审计追踪报告用于监管检查;4) 仪器的 IQ/OQ/PQ 记录在 PonyLab 中统一管理,附上原始校准证书。
场景 3:多人协作大型项目
4 名博士生协同进行为期 6 个月的癌症标志物研究项目。使用方式:1) 创建「癌症标志物研究」研究方向,所有相关实验归入其中;2) 共享样品库,每次分装通过“派生样品”功能记录;3) 在实验编辑器中 @提及需要审阅的同学,系统发送通知;4) 每轮实验完成后使用 AI 生成进展摘要,导出 PDF 分享给导师。
快速参考卡片
重要 URL
/register— 注册/login— 登录/dashboard— 仪表盘/settings— 设置
角色层级
- SUPER_ADMIN(最高)
- PI
- RESEARCHER
- TECHNICIAN(最低)
实验状态
- DRAFT → IN_PROGRESS
- → COMPLETED
- → SUBMITTED(可选)
- → SIGNED → WITNESSED