integrate-wsi-viewer

QoderWork Agent Skill — 将 D:\wsi-viewer 作为独立切片微服务集成到 FastAPI+React 项目中。

简介

将 wsi-viewer（FastAPI + OpenSlide + OpenSeadragon 的成熟数字病理切片服务）作为独立微服务，通过 httpx 代理集成到其他 FastAPI+React Web 项目中，实现 WSI（Whole Slide Image）数字病理读片功能。

适用场景

• 给现有 Web 系统添加 WSI 数字病理读片功能
• 集成 OpenSeadragon 切片浏览器
• 对接 wsi-viewer 服务

集成流程

1. 配置 wsi-viewer 数据目录 — 修改 config.yml 添加目标项目切片目录
2. 后端 httpx 代理层 — 代理 DZI 瓦片、缩略图、元数据 API
3. 前端 OpenSeadragon 集成 — React 组件 + Vite 代理配置
4. 功能扩展（可选） — 标注系统、读片练习、AI 视觉分析
5. 双服务启动与验证 — wsi-viewer(:8010) + 目标项目(:8000/:5173)

文件说明

文件	说明
SKILL.md	技能主文件，包含完整集成工作流和常见陷阱
reference.md	参考手册，包含 API 端点表、配置字段、代码示例

安装

在 QoderWork 中安装此技能后，agent 会在需要集成 wsi-viewer 时自动调用此技能指导完成集成。

License

MIT