# GlobalHealthAtlas Public Model（中文说明）

本仓库包含 GlobalHealthAtlas Public Model 项目的代码与资源，项目包含一个微调的问答模型，用于回答公共卫生相关的问题并提供信息性回复。

## 概述

本项目提供用于回答公共卫生文档与主题相关问题的问答模型与配置。仓库包含微调后的模型、分词器配置、示例提示与输出，以及用于推理的脚本。

## 文件与目录

- **adapter_config.json**：adapter 模型的配置。
- **adapter_model.safetensors**：微调后的 adapter 模型权重。
- **added_tokens.json**：新增词表的映射。
- **all_results.json**：推理的输出示例与问答示例。
- **train_results.json**：训练与验证的指标与明细。
- **trainer_log.jsonl**：训练日志。
- **trainer_state.json**：训练器状态。
- **checkpoint-990/**：模型检查点目录。

## 使用方法

克隆仓库后，请参考主仓库（https://github.com/Jan8217/GlobalHealthAtlas）中的使用示例和工具链进行部署与推理。确保安装并配置好相应的依赖环境，然后按需加载 `adapter_model.safetensors` 与分词器文件执行推理（问答）。可以运行仓内提供的推理脚本或使用自己的提示循环进行交互式问答。该模型用于研究与信息查询场景，不应用作临床诊断或其他高风险决策。

## 模型说明

该模型是在 Qwen/Qwen3-8B 基础模型上，使用 `GlobalHealthAtlas` 数据集微调得到的：

This model is a fine-tuned version of [/root/Qwen3-8B](https://huggingface.co//root/Qwen3-8B) on the GlobalHealthAtlas dataset.

**说明**：这是一个用于问答和信息检索的模型（Q&A）。具体使用与任务设置详见： https://github.com/Jan8217/GlobalHealthAtlas 。

## 使用限制

该模型适用于自动化评分与排序任务，不适用于临床诊断或高风险决策场景。部署前请在目标数据集上验证模型性能，注意可能存在的偏差，并在需要时由领域专家进行结果复核。

## 训练与评估数据

微调使用了 `GlobalHealthAtlas` 数据集；模型被调整用于问答与响应生成的任务。评估采用留出验证集进行，详细指标与示例输出记录在 `train_results.json` 和 `all_results.json` 中。有关数据预处理与任务设置的更多细节，请参阅 `Public_health/` 目录与 Global Health Atlas 项目页面。

## 训练超参数（概要）

- learning_rate: 5e-05
- train_batch_size: 1
- eval_batch_size: 8
- gradient_accumulation_steps: 8
- num_epochs: 2

## 训练结果

训练完成 2 个 epoch。最终评估指标和分阶段日志保存在 `train_results.json`（数值指标）和 `trainer_log.jsonl`（训练日志）。

## 环境依赖

- PEFT 0.15.1
- Transformers 4.51.3
- Pytorch 2.3.0+cu121
- Datasets 3.2.0
- Tokenizers 0.21.0

## 许可证

本项目使用 MIT License（详见 LICENSE 文件）。

## 致谢

感谢所有贡献者与社区支持。如需进一步说明或帮助，请在仓库中提 issue。