MedHelp®
把研究上下文放在一起
研究主题、PICO、论文、数据字典、代码和已有结果都归入同一项目，减少跨工具复制与上下文丢失。
临床研究自动化平台 · 官方使用说明
从一个问题，到一套
可复现的研究产物
MedHelp 把智能体对话、文献追踪、数据库与变量资源、任务流水线、项目文件和计算环境放进同一个研究工作台。本指南覆盖第一次登录到论文与汇报产出的完整路径。
START HERE第一次使用
用 5 个步骤完成项目、会话和第一项研究任务。
01 CORE如何对话选会话类型、附加材料、调用技能并获得可执行产物。
02 EVIDENCE查文献与资源从 PubMed 动态到变量证据和数据库字段定位。
03 RECORDS找回对话记录按项目查看、重命名、分享、归档和继续历史会话。
04没有找到相关内容。可尝试“对话记录”“PubMed”“试用”或“变量检索”。
01 · Platform overview
认识 MedHelp：它不是一个单次问答框
MedHelp 是围绕临床与生物医学研究生命周期设计的统一工作区。一个研究项目可以同时承载问题讨论、原始材料、文献证据、数据提取、分析代码、图表、论文草稿与任务状态。
由技能与智能体执行
对话会根据任务调用文献、数据库、统计、可视化、写作等科研技能，复杂任务可拆成多阶段任务。
交付可复查的产物
结果不只停留在聊天文本，还可以写入项目文件，形成表格、代码、图、报告、论文与可追踪证据。
示意图 A · 完整研究路径每个节点都可以返回对话继续修订
研究入口临床问题、论文复现、数据库队列、已有数据或待完善稿件
证据与资源文献检索、证据矩阵、数据库匹配、变量与字段定位
分析执行队列构建、预分析、统计建模、敏感性分析与可视化
研究报告表格、图注、结果解释、论文结构、引用核验与审稿回复
成果传播幻灯片、海报、图形摘要、网页与团队可复用资产
真实产品画面
截图取自当前产品演示，用于说明典型工作流；界面文字与布局可能随版本、账号权限和窗口尺寸变化。点击图片可查看大图。
最重要的使用原则
先创建项目，再在项目内开始会话。项目是研究资料与产物的容器；会话是一次具体工作过程。把同一研究的所有会话留在同一项目中，后续查找和复现会轻松很多。
02 · Quick start
5 分钟完成第一次研究任务
如果你刚进入平台，不必先配置所有选项。按下面顺序就能完成一个最小闭环。
登录并确认试用状态
注册申请通过后登录。先查看账号是否在有效试用期内；试用剩余时间与实际权限以账号页面显示为准。
创建一个研究项目
项目名建议使用“疾病/主题 + 数据源 + 目标”，例如“ICU 脓毒症早期风险预测”。名称以后仍可修改。
新建“研究会话”
研究设计、文献、数据、统计和论文任务选择“研究会话”；只想询问代码仓库或某个文件时选择“项目问答”。
给出研究边界和期望产物
至少说明人群、暴露/干预、结局、数据源、时间范围和期望输出。信息不足时，智能体会先提出澄清问题。
审阅、保存并继续下一步
检查证据来源、变量定义、统计假设和文件路径。让智能体把关键结论写入项目文件，再从任务面板或历史会话继续。
可直接复制的首轮提示
我准备开展一项临床研究。请先不要直接写论文，先帮我建立研究简报并列出必须澄清的问题。
研究主题：
目标人群：
暴露/干预：
主要结局：
候选数据源：
期望产物：研究问题、PICO、变量清单、最小分析方案和下一步任务。
请优先使用 medhelp-pipeline-planner，把工作拆成可追踪的五阶段研究流水线。
03 · Workspace
工作台、项目与会话之间是什么关系
工作台是入口，项目是长期容器，会话是某一轮协作。文件、任务、Git 和终端都围绕当前选中的项目工作。
示意图 B · 典型工作台布局实际布局会随窗口宽度和所选功能变化
对话研究文件
请帮我建立研究问题、变量清单与分析路径。
我会先确认 PICO、数据源、时间窗和主要结局，再生成任务。
已生成研究简报和五阶段任务，可在分析工作台查看。
输入任务 · 附加文件 / 文献 / 图片 · 选择技能
| 概念 | 用途 | 建议做法 | 常见误区 |
|---|---|---|---|
| 项目 | 保存一个研究主题的长期上下文、文件与会话 | 一项主研究一个项目；名称具体、稳定 | 每问一个问题都新建项目，导致资料分散 |
| 研究会话 | 处理文献、方案、统计、写作等研究任务 | 按可交付任务拆分，例如“变量定义”“主模型” | 把整个研究塞进一条极长会话而不阶段性归档 |
| 项目问答 | 解释代码、文件、模块或定位实现问题 | 提供文件路径或明确要追踪的模块 | 用项目问答触发完整研究规划 |
| 任务/产物 | 追踪五阶段进度和生成文件 | 完成一步就回写文件并更新状态 | 只看聊天结论，不保存关键定义和分析口径 |
项目管理常用操作
- 点击“新建项目”从空白工作区开始，或导入已有项目目录进行分析。
- 使用星标固定主力项目；项目较多时用搜索框按名称筛选。
- 可重命名项目与会话。建议在首轮任务完成后把“未命名会话”改成可识别名称。
- 删除项目通常先进入回收站；永久删除前确认项目文件与研究产物已备份。
- 切换项目后，先确认页面显示的当前项目，再上传文件、开终端或发送任务。
04 · Account & trial
注册、登录与试用账号
账号用于隔离个人工作区、项目、会话与配置。平台可根据运营设置开放直接注册或启用申请审核。
首次注册
- 填写可识别的账号信息并提交。
- 若当前启用审核，等待管理员通过后再登录。
- 审核通过时可能写入默认试用天数。
试用期说明
- 试用时长、到期日和可用功能以账号页面为准。
- 管理员可调整试用天数或设置长期账号。
- 到期后如无法继续使用，请联系平台管理员续期。
不要根据文档猜测剩余天数
不同账号可能有不同试用期限与权限。请以登录后账号/设置页面显示的“试用到期”信息为准。本指南不承诺固定免费天数或固定额度。
账号安全建议
- 不要多人共用同一账号；研究文件、会话历史和个人 API 配置应按用户隔离。
- 不要把密码、数据库凭据、API Key 直接写进对话或项目中的普通文本文件。
- 使用自有模型或第三方服务时，在“设置”中保存凭据，并确认对应服务的数据政策。
- 公共或共享电脑使用后请退出登录；发现异常会话及时修改密码并联系管理员。
05 · Agent chat
智能体对话：从“回答我”升级为“帮我完成”
高质量对话的核心不是把提示写得很长，而是把研究边界、可用材料、判断标准和期望产物讲清楚，并让重要结论进入项目文件。
1. 选择正确的会话类型
研究会话
适合研究选题、文献综述、数据库提取、统计建模、图表、论文、基金和学术汇报。会显示研究流程提示与科研技能入口。
项目问答
适合解释项目文件、追踪代码路径、排查错误和做定点修改。它会聚焦仓库问题，除非你明确要求开始研究规划。
2. 一条好任务应包含什么
| 要素 | 应该说明 | 示例 |
|---|---|---|
| 目标 | 这轮要解决什么，不要只说大主题 | 比较两个脓毒症定义对 28 天死亡预测的影响 |
| 对象 | 人群、数据源、时间窗、纳排范围 | MIMIC-IV 成人首次 ICU 入院，排除停留不足 24h |
| 变量 | 暴露、结局、协变量和关键时间语义 | 暴露取入 ICU 后 6h 内；结局为 28 天死亡 |
| 标准 | 判断成功的统计、格式或质量要求 | 报告效应量、95% CI、模型诊断和敏感性分析 |
| 产物 | 希望输出聊天答案还是项目文件 | 生成 analysis_plan.md 与 variables.csv |
| 边界 | 不能做什么、哪些信息仍待确认 | 本轮只做方案，不运行全量数据、不编造结果 |
3. 附加上下文
- 附加文件：上传 PDF、文本、表格、代码或图片；也可从项目文件树加入当前/新对话。
- 附加文献：从文献库、Zotero 或已有文献条目中选择，让智能体基于明确文献工作。
- 附加图片：适合图表解读、版式审阅、流程图或图形摘要任务。
- 上下文侧栏：用于查看当前会话引用的文件和材料；文件移动或删除后，历史引用路径可能失效。
4. 发送、停止与继续
发送
通常按 Enter 发送、Shift + Enter 换行；界面底部会显示当前快捷键。长任务发送前先检查当前项目和模型。
停止
发现方向错误、任务范围过大或可能修改错误文件时立即停止，再明确边界后继续。已生成的部分内容需人工检查。
继续
在同一会话追问可保留上下文；开始独立交付物时新建会话，并引用上一轮沉淀的文件。
5. 推荐的四轮协作法
- 澄清：先让智能体列出缺失信息和关键假设。
- 计划：要求输出步骤、文件、验证方式和风险。
- 执行：授权完成明确的检索、分析或文件修改。
- 验收：要求说明做了什么、证据在哪、哪些仍不确定、如何复现。
医学科研内容必须复核
智能体可以提高检索、分析和写作效率，但不能替代研究者对研究设计、变量定义、数据质量、统计假设、引用真实性、伦理审批与临床解释的责任。
06 · Literature monitoring
文献动态：发现最新证据，再进入研究
“文献动态”面向近期医学文献监测。当前核心来源是 PubMed，并可根据版本与配置接入 Europe PMC、medRxiv、arXiv 或内容型来源。正式医学证据应优先核对论文原文与权威数据库记录。
设定监测问题疾病 / 暴露 / 结局 / 方法 / 队列 / 时间窗
→
配置关键词设置回溯天数选择来源设定扫描上限
→
筛选与转化看摘要和信号 → 纳入项目 → 在对话中生成下一步
标准操作流程
先选目标项目
文献动态中发送到对话或形成研究线索时，需要知道要纳入哪个项目。确认页面显示的“当前纳入目标项目”。
打开设置
填写疾病、队列、暴露、结局或方法学关键词；设置回溯天数、显示条数和最大扫描数。关键词可用中英文及常见缩写。
开始搜索
PubMed 会获取近期带摘要文献并按相关性、时效性、来源信号和摘要质量整理。请求过快可能触发 NCBI 限流。
逐条筛选
查看题目、作者、期刊、日期、摘要和评分信号。评分用于辅助排序，不等于证据质量分级，也不能替代全文阅读。
进入对话或知识库
把代表性文献送入当前项目，要求智能体提取 PICO、变量定义、结果和局限；候选变量需人工审核后再沉淀。
检索式写法示例
研究问题：GLP-1 受体激动剂是否与肥胖成人的心血管结局改善相关？
请先拆分 PICO，给出 PubMed 可复查检索式；时间范围为近 5 年，优先系统综述、随机试验和大型真实世界队列。输出：
1. 检索式与同义词；
2. 纳排标准；
3. 候选文献表（PMID/DOI/设计/人群/主要结局）；
4. 尚不能确定的证据缺口。
不要根据标题推测研究结果。
“最新”需要实时获取
文献动态结果取决于检索时间、数据源网络状态与关键词设置。若出现超时或限流，缩小扫描范围、稍后重试，并用 PMID/DOI 到原始数据库核对。预印本不应与同行评议论文等同解读。
07 · Resource library
资源库：从“有什么数据”到“字段怎么用”
资源库用于浏览数据库家族、变量/指标、药物、疾病概念、证据关系和 PubMed 自动发现候选。它帮助定位研究资源，但不代表平台向用户分发任何第三方原始数据。
资源库可以解决四类问题
发现可研究指标
按中文名、英文名、缩写、数据库、PMID 或临床领域搜索指标，查看新颖性、证据数量与相关概念。
匹配数据库
判断指标可能出现在哪个数据库/队列、问卷波次、模块或事件表中，并识别版本与表粒度风险。
核实定义与公式
结合 PMID、证据句、论文公式和数据字典核对原始字段、派生逻辑、时间窗、单位与缺失编码。
发送到项目对话
选中变量后发送到当前项目，让智能体给出最小可执行的字段检索、表连接、代码校验和下一步。
示意图 C · 从文献候选到可用变量候选不直接进入稳定变量库
PubMed 检索按主题返回标题、摘要、PMID 与文献元数据
候选抽取识别变量、评分、终点、药物、疾病与定义线索
人工审核加入候选池、合并证据、标记歧义或忽略
字段核实核对数据字典、版本、表关系、单位与派生公式
研究使用写入变量清单、提取脚本、分析计划与引用记录
主要数据库家族与检索重点
| 数据库家族 | 适合问题 | 检索与抽取时重点确认 |
|---|---|---|
| ICU / EHR | MIMIC-III、MIMIC-IV、eICU、NWICU、PIC 等 | patient / admission / stay 粒度、事件表、时间语义、单位、版本 schema；不同版本不可套用同一表结构假设 |
| 全国调查 | NHANES 等复杂抽样调查 | cycle、问卷/体检/实验室模块、合并键、抽样权重、分层与 PSU |
| 大型队列 | UK Biobank 等前瞻性多模态队列 | field、instance、array、基线/重复测量、endpoint source 和访问权限 |
| 国际老龄化 | HRS、SHARE、ELSA、KLoSA、LASI、MHAS 等 | 国家、wave、个人/家庭粒度、代理访谈、权重与跨库可比性 |
| 中国健康/社会调查 | CHARLS、CLHLS、CHNS、CFPS、CGSS 等 | panel 与重复横截面、wave、问卷模块、家庭/个人/社区层级和权重 |
| 金融/收入/劳动力 | CHFS、CHIP、CLDS、CSS 等 | 研究单位、年份口径、收入构成、家庭与个人连接、调查权重 |
把资源变量发送到对话后怎么问
我在资源库中选中了指标“[指标名]”，计划用于“[数据库及版本]”。
请不要只给概念解释，按可复现顺序核实：
1. 可能的原始字段、问卷模块或表；
2. 数据粒度、连接键和时间语义；
3. 单位、缺失值和异常编码；
4. 是否需要按文献公式派生，并列出 PMID/DOI 依据；
5. 最小字段检索关键词和验证代码；
6. 当前仍存在的歧义。
若本地资源中找不到真实字段，请明确说“未确认”，不要编造字段名。
资源条目 ≠ 数据授权
能在资源库看到某数据库或变量介绍，不表示当前账号已经获得该数据库原始数据。访问、下载、存储、引用和再分发都必须遵守数据持有方的最新协议和机构要求。
08 · Knowledge & materials
资料查找与知识沉淀
平台内的“知识”不是一个单一页面，而是由项目文件、文献条目、变量证据、会话上下文、研究产物与可选 Zotero 同步共同组成。查找时先判断你要找的是“外部证据”还是“项目内材料”。
| 你要找什么 | 推荐入口 | 推荐操作 |
|---|---|---|
| 最新医学论文 | 文献动态 | 设置主题与回溯时间，筛选后纳入项目对话 |
| 已知论文或引用 | 对话 + 文献技能 / Zotero | 提供 PMID、DOI、标题或 .bib，要求核对元数据与引用 |
| 数据库或变量 | 资源库 | 按数据库、指标、缩写、PMID 或临床领域筛选 |
| 以前讨论过的结论 | 对话记录 / 项目会话 | 按项目、会话名、时间和关键词定位 |
| 项目生成的表、图、代码 | 文件树 / 研究总览 / 产物预览 | 按阶段目录和文件类型查看，并回到对话追问 |
| 团队 SOP 或专用方法 | 科研技能库 | 搜索技能名、能力、领域或标签，查看说明后调用 |
建议的项目资料结构
project/
├── 00_brief/ # 研究简报、PICO、范围与决策记录
├── 01_literature/ # 检索式、筛选表、证据矩阵、BibTeX
├── 02_data/ # 数据字典、变量清单、队列流程（避免提交敏感原始数据）
├── 03_analysis/ # 预分析、模型代码、日志与环境说明
├── 04_results/ # 表格、图、模型输出与敏感性分析
├── 05_manuscript/ # 论文、补充材料、投稿信与回复
└── README.md # 项目入口、复现步骤、负责人和更新时间
沉淀时至少保留这些信息
- 文献：PMID/DOI、题目、年份、研究设计、纳排、主要变量、证据句、局限与获取日期。
- 变量：来源表/问卷、字段、单位、时间窗、编码、缺失规则、派生公式和验证记录。
- 分析：软件与版本、随机种子、输入/输出路径、模型公式、诊断、异常处理和运行时间。
- 决策：为什么选择某定义/模型、替代方案是什么、谁在何时确认。
09 · Conversation history
对话记录：查找、继续、分享与删除
每条研究会话都是项目过程记录。良好的命名和阶段性归档能让团队知道“做过什么、为什么这样做、产物在哪里”。
在哪里查看历史对话
- 项目侧栏：展开某个项目，可看到其分析会话；“显示更多”用于加载更早记录。
- 对话记录页：跨项目浏览近期会话，适合按时间、项目或状态快速回顾。
- 研究总览：从任务或产物回到产生它的会话，理解上下文与执行过程。
继续会话
打开原会话后直接追问，可继承当前会话上下文。若相关文件已移动，重新附加新路径并说明变化。
分享只读快照
可生成公开或私有链接。公开链接拿到链接的人即可查看；分享前删除敏感信息并确认访问方式。
删除会话
会话删除可能不可恢复；项目删除通常先进入回收站。执行前确认关键结论与产物已经写入文件并备份。
推荐命名规则
[阶段]_[具体任务]_[版本或日期]
示例：
文献_脓毒症定义证据矩阵_2026-07
方案_MIMIC-IV变量与时间窗_v2
实验_Cox主模型与诊断_v1
发表_Results与Figure2联动修改_v3
历史对话不是唯一备份
对话适合保留过程，但正式变量定义、分析计划、代码、表图和最终文本应保存到项目文件并纳入版本管理。不要把唯一一份关键结果只留在聊天气泡里。
10 · Five-stage pipeline
五阶段研究流水线：把长期研究变成可追踪任务
研究流水线用于把“大而模糊”的研究目标拆为证据采集、方案设计、研究执行、报告撰写和成果传播。阶段并非严格单向：发现数据问题时可以回到文献或方案阶段修订。
① 文献 / 调研证据范围、研究空白、定义、引用与文献基线
② 构思 / 方案PICO、假设、创新点、数据源、纳排与最小可行方案
③ 实验 / 执行数据提取、预分析、建模、诊断、稳健性与结果图表
④ 发表 / 报告论文、补充材料、引用核验、投稿信与审稿回复
⑤ 推广 / 传播汇报、幻灯片、海报、图形摘要、网页和团队交付
如何启动流水线
在研究会话中提出项目目标
说明主题、边界、目标期刊/会议、候选数据源、主要方法和评估标准；信息不完整也可以先生成初稿。
调用流水线规划技能
请求优先使用 medhelp-pipeline-planner，生成研究简报和按阶段组织的任务列表。
审阅研究简报
先确认核心约束、主要终点、边界和评估指标。研究简报是后续任务生成与刷新时的重要基线。
在分析工作台执行任务
查看五阶段进度，点击任务上的“前往对话/在对话中使用”，按优先级执行并生成产物。
刷新并验收产物
完成任务后刷新研究总览，打开产物预览，核对内容、文件路径、阶段归属和下一项任务。
每个阶段的完成标准
| 阶段 | 至少应有的产物 | 进入下一阶段前要确认 |
|---|---|---|
| 文献 | 检索式、筛选口径、证据矩阵、核心引用 | 证据缺口真实存在；引用可核验；关键定义有出处 |
| 构思 | 研究简报、PICO、DAG/概念模型、变量与分析计划 | 数据可得；主要结局明确；样本量/事件数大致可行 |
| 实验 | 队列流程、分析代码、Table 1、主模型、诊断与敏感性分析 | 代码可运行；时间语义正确；效应量和不确定性完整 |
| 发表 | 主文、图表、补充材料、引用库、检查清单 | 文图表一致；因果表述不过度；符合目标期刊规范 |
| 推广 | 演示文稿、海报、图形摘要或项目网页 | 受众、时长、核心信息和数据披露边界明确 |
11 · Files, shell & compute
文件、预览、终端、Git 与计算资源
MedHelp 不只展示答案，还可以在项目工作区中创建和修改文件、运行命令、查看版本差异并连接计算节点。执行能力取决于部署方式、当前权限和所选模型后端。
文件树与预览
浏览、搜索、上传、下载和预览项目文件；可把文件或文件夹加入新对话，让智能体解释、修改或继续分析。
终端
在项目目录运行命令、安装依赖、执行脚本和查看日志。先确认工作目录；删除和覆盖操作需格外谨慎。
Git
查看变更、历史和差异，把研究代码与文本纳入版本控制。提交前检查是否意外包含原始数据、密钥或大文件。
计算资源
查看本机与已配置节点，按项目需要连接计算环境。项目同步、GPU 和远程节点能力取决于管理员配置。
产物预览
把文件放回研究流程理解：它来自哪个会话、属于哪个阶段、有哪些相关变更、下一步应做什么。
本地 Kernel
网页版连接本地工作区时需启动本地 Kernel，并允许浏览器的本地网络访问。状态异常时按页面提示重新检测。
安全运行清单
- 运行脚本前确认输入路径、输出路径、样本范围和预计资源消耗。
- 先在小样本或干运行模式验证，再处理全量数据。
- 高耗时任务保存日志、环境和随机种子；中断后明确能否续跑。
- 任何删除、覆盖、批量移动、数据库写入或外部发布动作都先人工确认目标。
- 不要把受限数据、个人信息或密钥提交到 Git 或公开分享链接。
12 · Research skills
科研技能：把常用方法变成可复用流程
技能是带有方法、边界和执行步骤的科研能力包。你可以让平台自动选择，也可以在对话中指定一个或多个技能。选择越贴近任务，输出通常越稳定。
- 研究路径规划
- 系统综述
- 深度文献检索
- 引用追踪
- 论文精读
- 数据库提取
- 研究选题
- 临床预分析
- 基线表
- 统计建模
- 医学可视化
- 结果整合
- 论文写作
- 论文审评
- 基金申请
- 学术汇报
三种调用方式
自动选择
适合你知道目标但不确定该用哪个技能。清楚描述任务，让平台按研究阶段路由到最小必要技能组合。
手动选择
从技能快捷方式或技能列表选择，系统会把调用意图写入对话。适合方法和产物已经明确的任务。
在提示中指定
直接写“请使用 citation-management 核验引用”。适合熟悉技能名、需要严格控制执行路径的用户。
不要一次选中所有技能
技能越多不一定越好。统计问题先明确目标，再选择方案、建模、生存分析或机器学习中的最小组合；文献问题也应区分检索、精读、引用追踪和综述。
团队技能与外部能力
平台可上传个人/团队技能，并通过 MCP 服务器或插件扩展工具与资源。上传前应检查说明文件、脚本权限、数据访问范围和依赖。来源未知的技能不要直接用于敏感工作区或自动执行高风险命令。
13 · Settings & integrations
设置：模型、账号、集成与运行环境
大多数用户可以先使用默认配置。只有在需要自有模型额度、文献同步、外部工具、通知或本地/远程执行时再进入相应设置。
| 设置类别 | 作用 | 注意事项 |
|---|---|---|
| 账号与个人资料 | 头像、账号信息、密码和登录状态 | 不要共用账号；异常时及时修改密码 |
| AI 后端 | Claude、Codex、Gemini 等可用模型与映射 | 模型能力、速度、额度和数据政策不同 |
| API Key | 覆盖服务器默认配置或连接第三方服务 | 只在受控设置中保存，不写入对话/代码仓库 |
| Zotero | 同步全局文献库，支持本地或云端连接 | 本地模式需启动 Zotero 并允许其他应用通信 |
| MCP / 插件 | 为智能体增加工具、资源和团队工作流 | 检查来源、权限、命令和数据流向 |
| Git | 设置提交名称、邮箱和可选 GitHub 认证 | 令牌按用户保存；提交前排除敏感文件 |
| 计算与 Kernel | 连接本地目录、节点和执行环境 | 校验路径存在、网络可达和项目权限 |
| 通知/自动调研 | 设置通知邮箱和完成提醒 | 发送服务与密钥由管理员或用户配置 |
| 外观与预览 | 主题、语言、Markdown 字号等 | 不影响研究内容，仅改变显示 |
14 · Best practices
让结果更可靠的 10 条使用方法
任务一次只交付一个主目标
把“查文献 + 取数 + 建模 + 写论文”拆成可验收的阶段，减少隐含假设。
给出明确的“不做什么”
例如“本轮不运行全量数据、不推断因果、不编造字段、不写最终结论”。
要求列出证据与不确定性
让智能体区分已核实、推断、缺失和需要人工确认的内容。
真实引用要有标识符
优先保留 PMID、DOI、数据集版本和访问日期，并回到原始页面核对。
变量定义必须带时间语义
字段名之外还要确认单位、测量窗口、聚合方式、缺失编码和基线/随访关系。
代码输出要可复现
保存环境、依赖、随机种子、输入输出路径、日志和异常处理。
先小样本，再全量
数据提取和模型运行先用少量记录验证连接、类型、时间窗与输出。
结论与产物写入文件
研究简报、变量表、分析计划和最终文本都应归档，避免只存在于对话。
每轮结束做验收
要求汇总修改文件、运行验证、剩余风险和下一步，不要直接跳到新任务。
把人放在最终决策环
研究者对伦理、合规、科学判断、临床解释、署名与发表承担最终责任。
15 · Data & compliance
数据、版权与研究合规
MedHelp 提供科研工作区、清洗、统计、建模和 AI 写作辅助。第三方数据库、文献全文和机构数据的所有权、授权与使用边界仍由各数据持有方和相关协议决定。
第三方数据库
MIMIC、eICU、NWICU、PIC、UK Biobank、NHANES、SHARE/HRS-family、CHARLS、CFPS、CGSS 等数据库的申请、访问、引用和再分发规则以官方最新条款为准。
用户研究成果
用户上传的数据、统计结果、报告、论文草稿和研究产物的权利按适用法律、机构协议和数据来源条款确定。平台处理这些内容仅为提供工作区能力。
敏感信息
上传前完成去标识化与最小化；不要在公开分享、Git、提示词或第三方模型中暴露患者身份、受限字段、密钥和未公开机构信息。
发表与引用
按数据持有方要求引用数据库、版本和访问路径。MedHelp 可被描述为分析工具/工作流平台，不应被标注为第三方数据库的数据来源。
用于真实患者数据前
确认伦理审批、数据使用协议、最小权限、存储位置、跨境/跨机构限制、模型服务数据流向、去标识化标准和事件响应流程。若任一项不清楚，暂停上传或执行并咨询本机构负责人。
16 · Troubleshooting & FAQ
常见问题与排查
登录后看不到项目或会话怎么办？
先确认登录的是正确账号，再刷新项目和会话。检查是否误用了搜索过滤、项目是否在回收站、网络连接是否正常。若使用本地 Kernel，确认 Kernel 正在运行且浏览器允许本地网络访问。
试用到期或功能不可用怎么办？
以账号页面显示的到期日和权限为准。试用到期后联系管理员延长试用或开通正式权限。若尚未到期但仍不可用，重新登录并向管理员提供账号、发生时间和页面提示。
为什么智能体一直处理但没有输出？
先等待当前工具调用完成；若明显卡住，使用停止按钮。可以在设置中重置运行时以中断活跃会话和清空内存缓存；该操作不应删除历史记录。重新开始时缩小任务、减少附件，并检查模型后端登录与额度。
文献搜索超时或提示 NCBI 限流怎么办？
缩短回溯天数、降低最大扫描条数并稍后重试。避免短时间重复请求。记录检索式后也可直接在 PubMed 核验。网络代理不稳定时需要管理员检查服务器连接。
为什么文献结果没有抽取到候选变量？
可能是摘要缺失、关键词过宽、文献本身不报告变量定义，或模型 JSON 抽取未完成。先检查检索命中是否相关，再缩小主题、加入指标/终点/评分关键词，必要时手动选择代表性文章精读。
资源库里的字段可以直接拿来分析吗？
不建议。资源库提供定位线索和证据关系。正式使用前必须在当前数据库版本的数据字典、真实表结构和样本记录中核对字段、连接键、单位、时间窗、缺失编码与派生逻辑。
历史对话引用的文件显示不可用怎么办？
文件可能被删除、重命名、移动或来自较早项目状态。通过文件树或 Git 历史定位当前路径，再把文件重新附加到会话，并说明旧路径与新路径的对应关系。
如何把一篇文献继续交给对话分析？
在文献动态或文献库中选择条目并发送到当前项目；也可附加 PDF、BibTeX，或直接提供 PMID/DOI。要求先核验元数据，再提取研究设计、变量、结果与局限。
如何避免对话越来越长、上下文混乱？
每完成一个交付物就把结论写入文件并做阶段总结。下一项独立任务新建会话，附加上轮产物和简短交接说明。会话名使用“阶段_任务_版本”。
分享链接安全吗？
公开链接拿到链接的人都可查看只读快照；私有链接需要登录且受访问控制。任何分享前都要检查患者信息、未公开结果、密钥、路径、机构信息和附件内容，必要时先制作脱敏副本。
网页、桌面端和本地 Kernel 有什么区别？
网页提供统一界面；桌面端可更紧密地访问本机能力；本地 Kernel 让网页在授权后连接本地工作区与执行环境。实际可用功能由部署方式、操作系统、权限和管理员配置决定。
生成的统计结果或论文能直接发表吗？
不能直接视为已验证成果。研究团队必须复核数据、代码、统计假设、效应量、图表一致性、引用真实性、伦理和目标期刊要求，并完成必要的同行审阅与作者确认。
报告问题时请提供
- 发生时间、账号（不要提供密码）、页面或功能名称。
- 当前项目与会话名称、使用的模型后端。
- 完整错误提示或脱敏截图，以及可重复的最少步骤。
- 是否使用本地 Kernel、远程节点、代理或自定义 API。
- 问题发生前最近一次正常操作；不要在工单中附敏感原始数据或密钥。