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 分钟完成第一次研究任务
如果你刚进入平台，不必先配置所有选项。按下面顺序就能完成一个最小闭环。
登录并连接桌面 App
注册通过后登录，并确认账号在有效试用期内（以账号页面为准）。请安装并打开 MedHelp 桌面 App；网页登录后会自动连接桌面端内置的本地引擎（详见第 03 节）。
创建一个研究项目
项目名建议使用“疾病/主题 + 数据源 + 目标”，例如“ICU 脓毒症早期风险预测”。名称以后仍可修改。
新建“研究会话”
研究设计、文献、数据、统计和论文任务选择“研究会话”；只想询问代码仓库或某个文件时选择“项目问答”。
给出研究边界和期望产物
至少说明人群、暴露/干预、结局、数据源、时间范围和期望输出。信息不足时，智能体会先提出澄清问题。
审阅、保存并继续下一步
检查证据来源、变量定义、统计假设和文件路径。让智能体把关键结论写入项目文件，再从任务面板或历史会话继续。
可直接复制的首轮提示
我准备开展一项临床研究。请先不要直接写论文，先帮我建立研究简报并列出必须澄清的问题。
研究主题：
目标人群：
暴露/干预：
主要结局：
候选数据源：
期望产物：研究问题、PICO、变量清单、最小分析方案和下一步任务。
请优先使用 medhelp-pipeline-planner，把工作拆成可追踪的五阶段研究流水线。
03 · Desktop app & web sign-in
安装桌面 App，网页登录自动连接
MedHelp 现在只提供 Windows 和 macOS 桌面安装包。本地引擎随桌面 App 一起安装和更新，不再提供需要命令行单独安装的“网页 Kernel”。app.medtimehelp.com 继续负责账号登录与权限，研究文件、智能体和计算仍运行在当前电脑。
| 桌面版 | 适用系统 | 如何获得 | 网页连接方式 |
|---|---|---|---|
| MedHelp Desktop for Windows | Windows 10 / 11（64 位） | 下载中心获取 .exe 安装包 | 打开桌面 App 后，网页登录会自动检测并连接 |
| MedHelp Desktop for macOS | Apple Silicon Mac | 下载中心获取 .dmg 安装包 | 打开桌面 App 后，网页登录会自动检测并连接 |
桌面端可以保持在线
点击窗口关闭按钮时，MedHelp 会隐藏到系统托盘（macOS 为菜单栏），内置本地引擎继续运行。需要完全停止时，请从托盘菜单选择“退出 MedHelp”。
安装与连接
下载安装包
在下载中心选择 Windows 或 macOS 桌面安装包，并可使用页面提供的 SHA-256 校验完整性。
安装并打开
按向导完成安装后打开 MedHelp。客户端会自动启动并连接内置本地引擎，无需运行任何终端命令。
网页登录
在浏览器打开 app.medtimehelp.com 并登录。页面会自动查找桌面端，并用当前账号建立安全的本机会话。
允许本地网络访问
Chrome / Edge 首次连接时可能询问是否允许本站访问本地网络。选择允许后点“重新检测”；该权限只用于连接本机 127.0.0.1。
下载中心
Windows、macOS 桌面版与 CC Switch 都可在下载中心获取。打开下载中心 →
连接不上桌面端？
先确认 MedHelp 图标仍在系统托盘或菜单栏，再检查浏览器的本地网络权限以及安全软件/防火墙。随后点“重新检测”；仍失败时完全退出并重新打开 MedHelp。
安全边界
云端登录只用于连接账号与订阅，所有执行能力、项目文件和数据都留在桌面 App 内置的本地引擎里。请只从平台下载中心获取桌面安装包。
04 · Agents & model API
三个智能体，以及模型 API 怎么配置
当前设置中有 Pi、Claude、Codex 三个智能体。它们共享 MedHelp 的项目与工作流，但运行时、登录方式和模型来源彼此独立。切换智能体不会自动复制另一智能体的账号、API Key 或模型设置。
内置多供应商智能体
可直接在 MedHelp 中添加自己的 OpenAI 兼容、Anthropic 兼容或本地 OpenAI 兼容 API；还能管理模型清单、默认模型和当前供应商。
Claude Code 智能体
使用 Claude Code 的登录或 API 配置及其可用模型。Pi 页面中添加的供应商不会自动改写 Claude Code 配置。
Codex 智能体
使用 Codex / OpenAI 的登录与模型配置，适合代码实现、仓库修改和结果复核。它与 Pi 的 API 提供商列表分开管理。
Pi 的“API 提供商”能做什么
厂商快捷配置
按中国站、套餐订阅、国际站等分组选择厂商，自动填入对应 Base URL、兼容协议和预置模型，减少地址与模型 ID 填错。
自定义兼容 API
支持 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages，以及不要求密钥的本地 OpenAI 兼容服务。
连接测试与模型发现
“测试连接”会校验 Base URL、协议和密钥，并在端点支持时发现模型；失败时会区分超时、不可达、拒绝访问等原因。
启用、切换与模型控制
同一账号可保存多个提供商，用“使用”切换当前提供商；在“模型”页启用或移除模型，并指定 Pi 的默认模型。
添加并启用一个模型 API
进入 Pi → API 提供商
打开“设置 → 智能体”，选中 Pi，再进入“API 提供商”。Claude 和 Codex 的账号配置请分别进入各自标签。
选择厂商预设或自定义
预设会自动填写正确的服务地址并加入支持模型；没有对应厂商时选“自定义”，手动选择 API 兼容性与模型协议。
填写 API Key 并测试
确认 Base URL 后填写自己的 Key，先点“测试连接”。编辑已保存的提供商时，Key 留空表示继续使用原密钥。
保存、选择模型并使用
测试成功后保存；到“模型”页检查启用模型与默认模型。若该提供商不是当前使用项，再点列表中的“使用”。新建会话即可按新配置运行。
截图中的厂商、模型数量和版本会随当前发布与端点能力变化，以设置页面实时显示为准。点击图片可查看大图。
什么时候还需要 CC Switch
Pi 已可在 MedHelp 内直接管理供应商。若你需要切换 Claude Code 或 Codex 使用的本机外部配置，可选用 CC Switch；它写入的是对应命令行智能体的本机配置，不会改变 MedHelp 账号或 Pi 提供商。
- 下载：MedHelp 下载中心，或 CC Switch GitHub Releases。
- 生效：切换后新建智能体会话；旧会话可能继续沿用启动时读取的配置。
- 排查：检查 Base URL、Key、额度和协议是否匹配，随后使用设置页或 CC Switch 自带的测试功能验证。
API Key 是只写凭据
保存后设置接口不会返回完整密钥，只显示配置状态或末四位。不要把 Key 写进对话、项目文件、截图或公开分享链接；第三方中转服务的数据政策与稳定性需由使用者自行评估。
05 · Workspace
工作台、项目与会话之间是什么关系
工作台是入口，项目是长期容器，会话是某一轮协作。文件、任务、Git 和终端都围绕当前选中的项目工作。
示意图 B · 典型工作台布局实际布局会随窗口宽度和所选功能变化
对话研究文件
请帮我建立研究问题、变量清单与分析路径。
我会先确认 PICO、数据源、时间窗和主要结局，再生成任务。
已生成研究简报和五阶段任务，可在分析工作台查看。
输入任务 · 附加文件 / 文献 / 图片 · 选择技能
| 概念 | 用途 | 建议做法 | 常见误区 |
|---|---|---|---|
| 项目 | 保存一个研究主题的长期上下文、文件与会话 | 一项主研究一个项目；名称具体、稳定 | 每问一个问题都新建项目，导致资料分散 |
| 研究会话 | 处理文献、方案、统计、写作等研究任务 | 按可交付任务拆分，例如“变量定义”“主模型” | 把整个研究塞进一条极长会话而不阶段性归档 |
| 项目问答 | 解释代码、文件、模块或定位实现问题 | 提供文件路径或明确要追踪的模块 | 用项目问答触发完整研究规划 |
| 任务/产物 | 追踪五阶段进度和生成文件 | 完成一步就回写文件并更新状态 | 只看聊天结论，不保存关键定义和分析口径 |
项目管理常用操作
- 点击“新建项目”从空白工作区开始，或导入已有项目目录进行分析。
- 使用星标固定主力项目；项目较多时用搜索框按名称筛选。
- 可重命名项目与会话。建议在首轮任务完成后把“未命名会话”改成可识别名称。
- 删除项目通常先进入回收站；永久删除前确认项目文件与研究产物已备份。
- 切换项目后，先确认页面显示的当前项目，再上传文件、开终端或发送任务。
06 · Account & trial
注册、登录与试用账号
账号用于隔离个人工作区、项目、会话与配置。平台可根据运营设置开放直接注册或启用申请审核。
首次注册
- 填写可识别的账号信息并提交。
- 若当前启用审核，等待管理员通过后再登录。
- 审核通过时可能写入默认试用天数。
试用期说明
- 试用时长、到期日和可用功能以账号页面为准。
- 管理员可调整试用天数或设置长期账号。
- 到期后如无法继续使用，请联系平台管理员续期。
不要根据文档猜测剩余天数
不同账号可能有不同试用期限与权限。请以登录后账号/设置页面显示的“试用到期”信息为准。本指南不承诺固定免费天数或固定额度。
账号安全建议
- 不要多人共用同一账号；研究文件、会话历史和个人 API 配置应按用户隔离。
- 不要把密码、数据库凭据、API Key 直接写进对话或项目中的普通文本文件。
- 使用自有模型或第三方服务时，在“设置”中保存凭据，并确认对应服务的数据政策。
- 公共或共享电脑使用后请退出登录；发现异常会话及时修改密码并联系管理员。
07 · 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. 推荐的四轮协作法
- 澄清：先让智能体列出缺失信息和关键假设。
- 计划：要求输出步骤、文件、验证方式和风险。
- 执行：授权完成明确的检索、分析或文件修改。
- 验收：要求说明做了什么、证据在哪、哪些仍不确定、如何复现。
医学科研内容必须复核
智能体可以提高检索、分析和写作效率，但不能替代研究者对研究设计、变量定义、数据质量、统计假设、引用真实性、伦理审批与临床解释的责任。
08 · Literature monitoring
文献动态：发现最新证据，再进入研究
“文献动态”面向近期医学文献监测。当前核心来源是 PubMed，并可根据版本与配置接入 Europe PMC、medRxiv、arXiv 或内容型来源。正式医学证据应优先核对论文原文与权威数据库记录。
设定监测问题疾病 / 暴露 / 结局 / 方法 / 队列 / 时间窗
→
配置关键词设置回溯天数选择来源设定扫描上限
→
筛选与转化看摘要和信号 → 纳入项目 → 在对话中生成下一步
标准操作流程
先选目标项目
文献动态中发送到对话或形成研究线索时，需要知道要纳入哪个项目。确认页面显示的“当前纳入目标项目”。
打开设置
填写疾病、队列、暴露、结局或方法学关键词；设置回溯天数、显示条数和最大扫描数。关键词可用中英文及常见缩写。
开始搜索
PubMed 会获取近期带摘要文献并按相关性、时效性、来源信号和摘要质量整理。请求过快可能触发 NCBI 限流。
逐条筛选
查看题目、作者、期刊、日期、摘要和评分信号。评分用于辅助排序，不等于证据质量分级，也不能替代全文阅读。
进入对话或知识库
把代表性文献送入当前项目，要求智能体提取 PICO、变量定义、结果和局限；候选变量需人工审核后再沉淀。
检索式写法示例
研究问题：GLP-1 受体激动剂是否与肥胖成人的心血管结局改善相关？
请先拆分 PICO，给出 PubMed 可复查检索式；时间范围为近 5 年，优先系统综述、随机试验和大型真实世界队列。输出：
1. 检索式与同义词；
2. 纳排标准；
3. 候选文献表（PMID/DOI/设计/人群/主要结局）；
4. 尚不能确定的证据缺口。
不要根据标题推测研究结果。
“最新”需要实时获取
文献动态结果取决于检索时间、数据源网络状态与关键词设置。若出现超时或限流，缩小扫描范围、稍后重试，并用 PMID/DOI 到原始数据库核对。预印本不应与同行评议论文等同解读。
09 · 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 等 | 研究单位、年份口径、收入构成、家庭与个人连接、调查权重 |
截图中当前收录 26 个数据库；目录数量会随平台版本更新。分类用于快速定位入口，真正提取前仍需核对具体版本、表结构、字段粒度和数据授权。
连接数据库 API：让智能体访问已授权数据源
数据库 API 与上面的“资源库”用途不同：资源库用于发现数据库和核实变量线索；数据库 API 使用你自己的 Bearer PAT 连接远程数据服务，让当前账号的智能体在授权范围内读取数据源清单，并调用兼容的 /api/v1 数据集接口。默认线上地址为 https://api.medtimehelp.com。
验证真实授权范围
“测试连接”会请求远程数据源清单，区分 PAT 无效、无访问权限、服务不可达和响应不兼容，并显示当前 PAT 可访问的数据源数量。
自动供当前用户的智能体使用
验证并保存后，Base URL 与 PAT 会按用户注入受管智能体会话；无需把令牌贴进对话，也不会注入其他用户的会话。
调用数据集下载接口
页面会生成带 Bearer 认证的 curl 示例。把 <dataset_id> 替换为有权限的数据集 ID，即可从兼容端点下载数据。
按账号保存与清除
PAT 保存在当前用户凭据库，设置接口不会回传明文。点击“清除”会移除连接凭据和验证状态，但不会删除远程数据。
数据库 API 配置步骤
进入连接器
打开“设置 → 连接器 → MedHelp 数据库连接”。API Base URL 保持默认线上地址即可；自建兼容服务时再替换。
填写 Bearer PAT
粘贴以 mdpat_ 开头的个人访问令牌。已保存过 PAT 时输入框留空表示继续使用原令牌。
先测试连接
点击“测试连接”，确认显示“已连接”以及可访问数据源数量。数量是动态结果，以 PAT 的实际授权为准。
连接并保存
测试成功后点击“连接并保存”。之后新启动的智能体会话会自动获得该连接；若更换 PAT 或 Base URL，请重新测试并保存。
可访问数据源数量、数据集 ID、字段与下载权限均由 PAT 和远程服务决定；截图中的数量只是当时测试结果。点击图片可查看大图。
智能体如何调用数据库
直接描述研究问题与目标数据库
在研究会话中说明数据库、研究人群、暴露/结局和期望产物，例如“查找 CHARLS 中精神疾病相关结局及可用字段”。
选择“数据库提取”方向
进入实验阶段的“数据库提取”，平台会展示数据库 API 底座、各数据库独立技能以及可选的跨库路由能力。
选择推荐技能
一般先保留 medhelp-database-api-access，再选择目标数据库对应技能；跨多个数据库比较时才使用多个技能或跨库 router，避免无关调用。
智能体定位、核验并提取
智能体优先调用线上数据库 API，结合对应数据库的结构知识定位真实表、字段、连接键、时间语义和编码规则，只提取当前任务需要的数据并记录来源路径。
数据库名称、推荐技能和技能数量会动态更新。选择越聚焦，智能体越容易准确核对目标库的表结构与字段语义。
连接成功不等于可以任意使用数据
PAT 只证明技术访问授权。下载、存储、分析、跨境、共享和发表仍须符合数据持有方协议、伦理审批和机构安全要求。不要把 PAT 放入命令历史、项目文件或聊天消息。
把资源变量发送到对话后怎么问
我在资源库中选中了指标“[指标名]”，计划用于“[数据库及版本]”。
请不要只给概念解释，按可复现顺序核实：
1. 可能的原始字段、问卷模块或表；
2. 数据粒度、连接键和时间语义；
3. 单位、缺失值和异常编码；
4. 是否需要按文献公式派生，并列出 PMID/DOI 依据；
5. 最小字段检索关键词和验证代码；
6. 当前仍存在的歧义。
若本地资源中找不到真实字段，请明确说“未确认”，不要编造字段名。
资源条目 ≠ 数据授权
能在资源库看到某数据库或变量介绍，不表示当前账号已经获得该数据库原始数据。访问、下载、存储、引用和再分发都必须遵守数据持有方的最新协议和机构要求。
10 · 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、题目、年份、研究设计、纳排、主要变量、证据句、局限与获取日期。
- 变量：来源表/问卷、字段、单位、时间窗、编码、缺失规则、派生公式和验证记录。
- 分析：软件与版本、随机种子、输入/输出路径、模型公式、诊断、异常处理和运行时间。
- 决策：为什么选择某定义/模型、替代方案是什么、谁在何时确认。
11 · Conversation history
对话记录：查找、继续、分享与删除
每条研究会话都是项目过程记录。良好的命名和阶段性归档能让团队知道“做过什么、为什么这样做、产物在哪里”。
在哪里查看历史对话
- 项目侧栏：展开某个项目，可看到其分析会话；“显示更多”用于加载更早记录。
- 对话记录页：跨项目浏览近期会话，适合按时间、项目或状态快速回顾。
- 研究总览：从任务或产物回到产生它的会话，理解上下文与执行过程。
继续会话
打开原会话后直接追问，可继承当前会话上下文。若相关文件已移动，重新附加新路径并说明变化。
分享只读快照
可生成公开或私有链接。公开链接拿到链接的人即可查看；分享前删除敏感信息并确认访问方式。
删除会话
会话删除可能不可恢复；项目删除通常先进入回收站。执行前确认关键结论与产物已经写入文件并备份。
推荐命名规则
[阶段]_[具体任务]_[版本或日期]
示例：
文献_脓毒症定义证据矩阵_2026-07
方案_MIMIC-IV变量与时间窗_v2
实验_Cox主模型与诊断_v1
发表_Results与Figure2联动修改_v3
历史对话不是唯一备份
对话适合保留过程，但正式变量定义、分析计划、代码、表图和最终文本应保存到项目文件并纳入版本管理。不要把唯一一份关键结果只留在聊天气泡里。
12 · Five-stage pipeline
五阶段研究流水线：把长期研究变成可追踪任务
研究流水线用于把“大而模糊”的研究目标拆为证据采集、方案设计、研究执行、报告撰写和成果传播。阶段并非严格单向：发现数据问题时可以回到文献或方案阶段修订。
① 文献 / 调研证据范围、研究空白、定义、引用与文献基线
② 构思 / 方案PICO、假设、创新点、数据源、纳排与最小可行方案
③ 实验 / 执行数据提取、预分析、建模、诊断、稳健性与结果图表
④ 发表 / 报告论文、补充材料、引用核验、投稿信与审稿回复
⑤ 推广 / 传播汇报、幻灯片、海报、图形摘要、网页和团队交付
如何启动流水线
在研究会话中提出项目目标
说明主题、边界、目标期刊/会议、候选数据源、主要方法和评估标准；信息不完整也可以先生成初稿。
调用流水线规划技能
请求优先使用 medhelp-pipeline-planner，生成研究简报和按阶段组织的任务列表。
审阅研究简报
先确认核心约束、主要终点、边界和评估指标。研究简报是后续任务生成与刷新时的重要基线。
在分析工作台执行任务
查看五阶段进度，点击任务上的“前往对话/在对话中使用”，按优先级执行并生成产物。
刷新并验收产物
完成任务后刷新研究总览，打开产物预览，核对内容、文件路径、阶段归属和下一项任务。
每个阶段的完成标准
| 阶段 | 至少应有的产物 | 进入下一阶段前要确认 |
|---|---|---|
| 文献 | 检索式、筛选口径、证据矩阵、核心引用 | 证据缺口真实存在；引用可核验；关键定义有出处 |
| 构思 | 研究简报、PICO、DAG/概念模型、变量与分析计划 | 数据可得；主要结局明确；样本量/事件数大致可行 |
| 实验 | 队列流程、分析代码、Table 1、主模型、诊断与敏感性分析 | 代码可运行；时间语义正确；效应量和不确定性完整 |
| 发表 | 主文、图表、补充材料、引用库、检查清单 | 文图表一致；因果表述不过度；符合目标期刊规范 |
| 推广 | 演示文稿、海报、图形摘要或项目网页 | 受众、时长、核心信息和数据披露边界明确 |
13 · Files, shell & compute
文件、预览、终端、Git 与计算资源
MedHelp 不只展示答案，还可以在项目工作区中创建和修改文件、运行命令、查看版本差异并连接计算节点。执行能力取决于部署方式、当前权限和所选模型后端。
文件树与预览
浏览、搜索、上传、下载和预览项目文件；可把文件或文件夹加入新对话，让智能体解释、修改或继续分析。
终端
在项目目录运行命令、安装依赖、执行脚本和查看日志。先确认工作目录；删除和覆盖操作需格外谨慎。
Git
查看变更、历史和差异，把研究代码与文本纳入版本控制。提交前检查是否意外包含原始数据、密钥或大文件。
计算资源
查看本机与已配置节点，按项目需要连接计算环境。项目同步、GPU 和远程节点能力取决于管理员配置。
产物预览
把文件放回研究流程理解：它来自哪个会话、属于哪个阶段、有哪些相关变更、下一步应做什么。
本地引擎
网页版连接本地工作区时需启动本地引擎，并允许浏览器访问本地网络；桌面版内置引擎自动连接。安装与排查见第 03 节。
安全运行清单
- 运行脚本前确认输入路径、输出路径、样本范围和预计资源消耗。
- 先在小样本或干运行模式验证，再处理全量数据。
- 高耗时任务保存日志、环境和随机种子；中断后明确能否续跑。
- 任何删除、覆盖、批量移动、数据库写入或外部发布动作都先人工确认目标。
- 不要把受限数据、个人信息或密钥提交到 Git 或公开分享链接。
14 · Research skills
科研技能：把常用方法变成可复用流程
技能是带有方法、边界和执行步骤的科研能力包。你可以让平台自动选择，也可以在对话中指定一个或多个技能。选择越贴近任务，输出通常越稳定。
- 研究路径规划
- 系统综述
- 深度文献检索
- 引用追踪
- 论文精读
- 数据库提取
- 研究选题
- 临床预分析
- 基线表
- 统计建模
- 医学可视化
- 结果整合
- 论文写作
- 论文审评
- 基金申请
- 学术汇报
三种调用方式
自动选择
适合你知道目标但不确定该用哪个技能。清楚描述任务，让平台按研究阶段路由到最小必要技能组合。
手动选择
从技能快捷方式或技能列表选择，系统会把调用意图写入对话。适合方法和产物已经明确的任务。
在提示中指定
直接写“请使用 citation-management 核验引用”。适合熟悉技能名、需要严格控制执行路径的用户。
不要一次选中所有技能
技能越多不一定越好。统计问题先明确目标，再选择方案、建模、生存分析或机器学习中的最小组合；文献问题也应区分检索、精读、引用追踪和综述。
团队技能与外部能力
平台可上传个人/团队技能，并通过 MCP 服务器或插件扩展工具与资源。上传前应检查说明文件、脚本权限、数据访问范围和依赖。来源未知的技能不要直接用于敏感工作区或自动执行高风险命令。
15 · Settings & integrations
设置：模型、账号、集成与运行环境
大多数用户可以先使用默认配置。只有在需要自有模型额度、文献同步、外部工具、通知或本地/远程执行时再进入相应设置。
| 设置类别 | 作用 | 注意事项 |
|---|---|---|
| 账号与个人资料 | 头像、账号信息、密码和登录状态 | 不要共用账号；异常时及时修改密码 |
| 智能体 | Pi、Claude、Codex 的账号、API 提供商、模型与权限 | 三个运行时彼此独立；Pi 可在应用内配置兼容 API，Claude/Codex 使用各自登录或本机配置（见第 04 节） |
| 模型 API Key | 给 Pi 添加厂商预设或自定义 OpenAI / Anthropic 兼容服务 | 先测试再保存；Key 只写入，不会由设置接口回传完整明文 |
| 数据库 API | 用 Base URL 与 Bearer PAT 连接已授权数据源，并供当前用户的智能体使用 | 测试结果和数据源数量是动态的；访问仍受 PAT、数据协议与伦理要求约束（见第 09 节） |
| Zotero | 同步全局文献库，支持本地或云端连接 | 本地模式需启动 Zotero 并允许其他应用通信 |
| MCP / 插件 | 为智能体增加工具、资源和团队工作流 | 检查来源、权限、命令和数据流向 |
| Git | 设置提交名称、邮箱和可选 GitHub 认证 | 令牌按用户保存；提交前排除敏感文件 |
| 计算与本地引擎 | 连接本地目录、节点和执行环境 | 校验路径存在、网络可达和项目权限 |
| 通知/自动调研 | 设置通知邮箱和完成提醒 | 发送服务与密钥由管理员或用户配置 |
| 外观与预览 | 主题、语言、Markdown 字号等 | 不影响研究内容，仅改变显示 |
16 · Best practices
让结果更可靠的 10 条使用方法
任务一次只交付一个主目标
把“查文献 + 取数 + 建模 + 写论文”拆成可验收的阶段，减少隐含假设。
给出明确的“不做什么”
例如“本轮不运行全量数据、不推断因果、不编造字段、不写最终结论”。
要求列出证据与不确定性
让智能体区分已核实、推断、缺失和需要人工确认的内容。
真实引用要有标识符
优先保留 PMID、DOI、数据集版本和访问日期，并回到原始页面核对。
变量定义必须带时间语义
字段名之外还要确认单位、测量窗口、聚合方式、缺失编码和基线/随访关系。
代码输出要可复现
保存环境、依赖、随机种子、输入输出路径、日志和异常处理。
先小样本，再全量
数据提取和模型运行先用少量记录验证连接、类型、时间窗与输出。
结论与产物写入文件
研究简报、变量表、分析计划和最终文本都应归档，避免只存在于对话。
每轮结束做验收
要求汇总修改文件、运行验证、剩余风险和下一步，不要直接跳到新任务。
把人放在最终决策环
研究者对伦理、合规、科学判断、临床解释、署名与发表承担最终责任。
17 · Data & compliance
数据、版权与研究合规
MedHelp 提供科研工作区、清洗、统计、建模和 AI 写作辅助。第三方数据库、文献全文和机构数据的所有权、授权与使用边界仍由各数据持有方和相关协议决定。
第三方数据库
MIMIC、eICU、NWICU、PIC、UK Biobank、NHANES、SHARE/HRS-family、CHARLS、CFPS、CGSS 等数据库的申请、访问、引用和再分发规则以官方最新条款为准。
用户研究成果
用户上传的数据、统计结果、报告、论文草稿和研究产物的权利按适用法律、机构协议和数据来源条款确定。平台处理这些内容仅为提供工作区能力。
敏感信息
上传前完成去标识化与最小化；不要在公开分享、Git、提示词或第三方模型中暴露患者身份、受限字段、密钥和未公开机构信息。
发表与引用
按数据持有方要求引用数据库、版本和访问路径。MedHelp 可被描述为分析工具/工作流平台，不应被标注为第三方数据库的数据来源。
用于真实患者数据前
确认伦理审批、数据使用协议、最小权限、存储位置、跨境/跨机构限制、模型服务数据流向、去标识化标准和事件响应流程。若任一项不清楚，暂停上传或执行并咨询本机构负责人。
18 · Troubleshooting & FAQ
常见问题与排查
登录后看不到项目或会话怎么办？
先确认登录的是正确账号，再刷新项目和会话。检查是否误用了搜索过滤、项目是否在回收站、网络连接是否正常。若使用网页版，确认本地引擎正在运行且浏览器允许本地网络访问（见第 03 节）。
试用到期或功能不可用怎么办？
以账号页面显示的到期日和权限为准。试用到期后联系管理员延长试用或开通正式权限。若尚未到期但仍不可用，重新登录并向管理员提供账号、发生时间和页面提示。
为什么智能体一直处理但没有输出？
先等待当前工具调用完成；若明显卡住，使用停止按钮。可以在设置中重置运行时以中断活跃会话和清空内存缓存；该操作不应删除历史记录。重新开始时缩小任务、减少附件，并检查模型后端登录与额度。
文献搜索超时或提示 NCBI 限流怎么办？
缩短回溯天数、降低最大扫描条数并稍后重试。避免短时间重复请求。记录检索式后也可直接在 PubMed 核验。网络代理不稳定时需要管理员检查服务器连接。
为什么文献结果没有抽取到候选变量？
可能是摘要缺失、关键词过宽、文献本身不报告变量定义，或模型 JSON 抽取未完成。先检查检索命中是否相关，再缩小主题、加入指标/终点/评分关键词，必要时手动选择代表性文章精读。
资源库里的字段可以直接拿来分析吗？
不建议。资源库提供定位线索和证据关系。正式使用前必须在当前数据库版本的数据字典、真实表结构和样本记录中核对字段、连接键、单位、时间窗、缺失编码与派生逻辑。
历史对话引用的文件显示不可用怎么办？
文件可能被删除、重命名、移动或来自较早项目状态。通过文件树或 Git 历史定位当前路径，再把文件重新附加到会话，并说明旧路径与新路径的对应关系。
如何把一篇文献继续交给对话分析？
在文献动态或文献库中选择条目并发送到当前项目；也可附加 PDF、BibTeX，或直接提供 PMID/DOI。要求先核验元数据，再提取研究设计、变量、结果与局限。
如何避免对话越来越长、上下文混乱？
每完成一个交付物就把结论写入文件并做阶段总结。下一项独立任务新建会话，附加上轮产物和简短交接说明。会话名使用“阶段_任务_版本”。
分享链接安全吗？
公开链接拿到链接的人都可查看只读快照；私有链接需要登录且受访问控制。任何分享前都要检查患者信息、未公开结果、密钥、路径、机构信息和附件内容，必要时先制作脱敏副本。
Pi、Claude、Codex 的 API 配置为什么不互通？
它们是三个独立运行时。Pi 使用 MedHelp“API 提供商”中保存的兼容 API 与模型；Claude 和 Codex 使用各自账号、登录或本机配置。请先确认当前会话选中了哪个智能体，再到对应标签排查。详见第 04 节。
数据库 API 测试成功后，为什么智能体还不能访问？
使用新填写的 PAT 点“测试连接”只负责验证，不会自动保存；还需点击“连接并保存”，然后新建智能体会话。若仍失败，确认状态为“已连接”、可访问数据源数量大于 0，并检查 PAT 是否过期或被撤销。详见第 09 节。
Windows、macOS 桌面版和本地引擎是什么关系？
Windows 与 macOS 桌面 App 都已内置本地引擎；打开 App 后，网页登录会自动连接当前电脑上的引擎。研究文件与执行能力留在本机，云端负责账号登录和权限。详见第 03 节。
本地引擎连接不上 / 浏览器拦截本地网络怎么办？
确认 MedHelp 桌面 App 仍在系统托盘或菜单栏运行，并在浏览器提示或本站设置中允许 app.medtimehelp.com 访问本地网络（loopback），然后点“重新检测”。若被安全软件或防火墙拦截需放行；仍失败时完全退出并重新打开 MedHelp。
用 CC Switch 切换后不生效怎么办？
先确认要切换的是 Claude 或 Codex 的本机配置；Pi 应直接在 MedHelp 的“API 提供商”页面切换。CC Switch 修改后请新建对应智能体会话，并检查 Base URL、Key、协议和额度。详见第 04 节。
生成的统计结果或论文能直接发表吗？
不能直接视为已验证成果。研究团队必须复核数据、代码、统计假设、效应量、图表一致性、引用真实性、伦理和目标期刊要求，并完成必要的同行审阅与作者确认。
报告问题时请提供
- 发生时间、账号（不要提供密码）、页面或功能名称。
- 当前项目与会话名称、使用的模型后端。
- 完整错误提示或脱敏截图，以及可重复的最少步骤。
- 操作系统与桌面 App 版本、当前智能体（Pi / Claude / Codex）、远程节点、代理或自定义 API 提供商。
- 问题发生前最近一次正常操作；不要在工单中附敏感原始数据或密钥。