内容
# 眼科数据中心
眼科数据中心是一个版本化的、社区可扩展的、具有许可证和访问意识的命令行工具，背后支持的是一个手动策划的眼科数据集快照。它帮助用户从官方来源查找、检查、引用、预检和获取支持的资源。
眼科数据中心 **不**托管或重新分发索引的第三方数据集。它不接受用户源条款或确定法律许可、伦理可接受性、数据质量、临床有效性或科学适用性。
[](LICENSE)
[](pyproject.toml)
[](DATASETS.md)
[](tests)
## 快速概览
当前目录包含 251 条手动源检查记录，跨越 18 个主要类别。在 2026 年 7 月 25 日的最后一次目录更新中：
- 171 条路由是匿名的直接访问；
- 34 条需要立即自助服务身份验证；
- 11 条需要用户点击；
- 27 条需要受控或手动访问；
- 8 条需要作者联系。
获取支持与访问是分开的：一个官方存款完成了端到端的传输测试，13 条路由通过了部分 API 或文件列表检查，所有其他加载器状态都标有其实际测试范围。
## 安装
```bash
python -m pip install "git+https://github.com/pooyakhosravi/EyeDataHub.git@v0.2.2"
```
对于开发：
```bash
git clone https://github.com/pooyakhosravi/EyeDataHub.git
cd EyeDataHub
python -m pip install -e .
```
可选平台客户端可通过 `.[kaggle]`、`.[huggingface]`、`.[synapse]` 或 `.[full]` 获得。
## 安全的命令行工作流程
```bash
# 只读发现
eyehub search --modality oct --access anonymous_direct
eyehub search --task segmentation --source-terms standard-no-nc --json
# 只读记录和引用检查
eyehub show fives --json
eyehub cite fives --type dataset --format bibtex
# 只读获取预检
eyehub download fives --data-dir ./data --dry-run --json
# 从表示的官方源显式传输
eyehub download fives --data-dir ./data --json
```
搜索、`show`、`cite`、Python 查询、JSON、JSON-LD 和可选的 MCP 服务器都是只读的。只有显式的非 dry-run `download` 命令才能启动传输。手动、受控、作者联系、不可用和不支持的路由返回结构化状态和指令，而不是模仿成功。
## “许可证感知” 的含义
在获取之前，眼科数据中心显示：
- 原始源声明的条款和证据 URL；
- 术语似乎适用于数据、元数据、代码、出版物、挑战参与、混合组件或未知范围；
- 注册、身份验证、令牌、点击、手动批准、协议、作者联系和机构限制；
- 路由验证日期和加载器测试范围；
- 未知、仅研究、非商业、非衍生或混合术语的警告。
该工具阻止手动授权路由，从不接受协议，并在成功传输后写入 provenance 清单。此行为不是法律建议。描述性的 `standard-no-nc` 过滤器意味着仅标准化源标签不包含明确的非商业条款；它不为拟议的使用建立许可。
## Python
```python
from pathlib import Path
from eyedatahub.acquisition import acquire_dataset, preflight_dataset
from eyedatahub.datasets.registry import REGISTRY
dataset = REGISTRY.get_dataset("ophthalwechat")
data_dir = Path("./data")
plan = preflight_dataset(dataset, data_dir) # 只读
result = acquire_dataset(dataset, data_dir) # 显式传输请求
print(result.status, result.manifest_path)
```
`REGISTRY` 是保留的内部 Python 类名。公开发布的版本产物使用 *catalog* 和 *snapshot*，因为眼科数据中心不是数据仓库。
## 凭证和安全
复制 [.env.example](.env.example) 到私有 `.env` 文件或使用每个平台支持的凭证机制。眼科数据中心仅记录身份验证类别或凭证存在，从不记录凭证值。`.env` 和获取的数据目录不得提交。
支持的后端包括官方 Figshare、Zenodo、Mendeley Data、Dryad、Kaggle、Hugging Face、PhysioNet、Dataverse、Synapse、GitHub、Google Drive 和直接文件路由。支持因记录而异，并通过 `acquisition_support` 和 `loader_test_scope` 公开。
## 存档的科学输出
当前的科学数据证据包位于 [`release/v0.2.2`](release/v0.2.2) 下，并存档在 [doi:10.5281/zenodo.21587937](https://doi.org/10.5281/zenodo.21587937)。使用以下命令重新生成其计数、表格和图表：
```bash
python release/v0.2.2/regenerate_submission.py
```
前一个 250 记录的包仍然位于 [`release/v0.2.1`](release/v0.2.1) 下，早期包仍然位于 [`release/v0.2.0`](release/v0.2.0) 下，用于历史重现。早期包可以使用以下命令重新生成：
```bash
python -m pytest -q
python release/v0.2.0/regenerate_submission.py
```
存档包含目录元数据、验证日志、图表源数据、架构和重现说明—不包括索引数据集。参见 [CONTRIBUTING.md](CONTRIBUTING.md) 以获取评审添加和 [CLAUDE.md](CLAUDE.md) 以获取规范代理指南。
## 引用和许可证
使用 [CITATION.cff](CITATION.cff) 获取软件引用，并从官方来源引用获取的每个数据集。眼科数据中心代码使用 MIT 许可证；元数据和手稿证据使用 CC BY 4.0。第三方数据仍然在其特定来源的条款和访问控制之下。
MCP 市场