结果边界、常见问题与反馈
复核对象、来源、状态和版本，排查体验版常见问题并提交脱敏反馈。
体验版用户指南 V1.3 · 体验版 0.9.98 结果边界、常见问题与反馈
8.1 结果复核清单
| 检查项 | 要确认什么 | 不满足时怎么做 |
|---|---|---|
| 对象 | 菌株、样本、物种和数据范围正确 | 重新限定对象或数据源 |
| 来源 | 结果可追溯到数据库、记录或文件 | 要求列出来源与版本 |
| 状态 | 任务成功且无未处理错误 | 记录 request_id / run ID / Job ID |
| 版本 | 数据、模型、Skill 与 Workflow 版本明确 | 更新后重跑关键任务 |
| 边界 | 事实、推断与待验证假设已区分 | 加入人工与实验复核 |
8.2 常见问题
| 问题 | 排查建议 |
|---|---|
| 安装后打不开 | 核对安装包来源、系统版本和组织 IT 安全要求 |
| 模型没有响应 | 检查服务地址、Key、model-id、配额和模型选择 |
| SkillHub 连接失败 | 检查地址、Token 有效期、权限范围和网络 |
| Skill 可见但不可用 | 确认已启用、检测通过、后端服务可访问 |
| Workflow 停滞 | 查看失败节点、依赖、输入或远程作业等待状态 |
| xSAFETY 读取失败 | 查看作业日志和实际输出文件名，再重试读取 |
8.3 数据、凭据与反馈
API Key、访问令牌只在受控设备与客户端中配置。
体验任务只使用获准的数据，不上传未授权的人体、临床、商业秘密或个人信息。
截图和录屏必须遮蔽密码、密钥、Token、内部地址与敏感数据。
反馈时提供客户端版本、操作系统、问题时间、复现步骤、脱敏截图，以及 request_id、run ID 或 Job ID。
| 不可直接替代 xBiomeOS 输出不直接替代临床、法规、知识产权、生产放行或重大研发决策中的专业判断。 |
|---|
修订记录
| 版本 | 修订日期 | 修订内容 | 起草人 | 审核人 | 签发人 |
|---|---|---|---|---|---|
| V1.0 | 2026.08.22 | 建立体验版指南框架，覆盖下载安装、模型、SkillHub、Skill、菌株查询、Workflow 与 xSAFETY。 | 王翕 | 殷晓晨 | 王翕 |
| V1.1 | 2026.08.22 | 依据 01_新录屏补充并核实 Mac/Windows、模型配置、SkillHub Token、XA-PB0037、基因组注释 Workflow 和 XA-2764 xSAFETY。 | 王翕 | 殷晓晨 | 王翕 |
| V1.2 | 2026.08.22 | 将 14 张录屏截图改为完整画面，统一为 2560×1440、16:9 和相同页面宽度。 | 王翕 | 殷晓晨 | 王翕 |
| V1.3 | 2026.08.24 | 参照正式版指南补充封面责任信息与结构化修订记录。 | 王翕 | 殷晓晨 | 王翕 |