- name
- fmtwiki
- description
- >
FMTWiki Skill
项目定位
FMTWiki 是面向临床医生、医学生、研究人员、患者的垂直领域循证知识库，聚焦粪菌移植（Fecal Microbiota Transplantation，FMT）。
部署地址： https://pvphcoybalzc.space.minimaxi.com 项目路径： /workspace/projects/fmtwiki/fmtwiki-query/ GitHub： zmy1006-sudo/fmtwiki-query
核心原则（强制执行）
| 原则 | 说明 | 违反后果 |
|---|---|---|
| 循证优先 | 所有词条必须有原始文献引用（PMID/DOI/Science） | 禁止 |
| 来源必链 | 所有信息必须附来源链接，禁止无链接断言 | 禁止 |
| M-DQA 强制 | 医学内容新增/修改必须经 Generator→Evaluator 双代理 QA | 强制 |
| PMID 验证 | 通过 PubMed 搜索标题+期刊+年份验证，不使用猜测 PMID | 强制 |
| 双标签分级 | Oxford（研究设计）+ GRADE（证据质量）双标签 | 强制 |
项目结构
fmtwiki-query/
├── src/
│ ├── data/ ← 知识库数据（TypeScript 常量）
│ │ ├── diseases.ts 14个适应证（含临床方案、PMID溯源）
│ │ ├── teams.ts 21个国内研究团队
│ │ ├── aiApps.ts 19个AI×FMT应用
│ │ ├── science.ts 7篇 Science 期刊论文
│ │ ├── patientEdu.ts 35篇患者科普
│ │ ├── patient.ts 6个患者版适应证（通俗版）
│ │ ├── decisionTree.ts 15节点临床决策树（PMID已验证）
│ │ ├── drugInteractions.ts 15条药物相互作用
│ │ ├── hospitalMap.ts 10家全国FMT医院
│ │ └── searchIndex.ts 全站搜索索引（BM25+同义词）
│ ├── lib/
│ │ ├── aiSearch.ts GLM API 调用（含无Key降级）
│ │ └── utils.ts 工具函数
│ └── components/
│ ├── App.tsx 路由状态机
│ ├── LoginPage.tsx 双入口（医生蓝/患者薄荷绿）
│ ├── DoctorPortal.tsx 医生五Tab（适应证/患者版/团队/AI应用/Science）
│ ├── PatientPortal.tsx 患者九Tab + 顶部搜索栏
│ ├── AISearchPanel.tsx AI搜索界面（双栏+证据卡片）
│ └── EvidenceGuide.tsx 证据等级说明（Oxford/GRADE）
├── wiki/ ← 源文档层（raw markdown，Generator来源）
│ ├── diseases/
│ ├── teams/
│ ├── science/
│ └── ai-apps/
├── scripts/ ← 定时任务脚本
│ ├── tracker.ts 状态追踪器
│ └── reports/ 执行报告
└── dist/ ← 部署产物数据文件字段定义
diseases.ts
interface Disease {
id: string; // 英文ID，如 "rCDI"
name: string; // 中文名，如 "复发性艰难梭菌感染"
nameEn: string; // 英文名
category: string; // 分类，如 "感染性疾病"
evidenceGrade: string; // "Oxford 1b · GRADE A" 格式
gradeLabel: string; // "A级"
gradeColor: string; // Tailwind 配色类
efficacy: string; // 疗效摘要
routes: string; // 给药途径
summary: string; // 循证摘要
administrationRoute: string; // 临床方案：途径
dosage: string; // 临床方案：剂量
frequency: string; // 临床方案：疗程
protocolNote?: string; // 临床方案：备注
sources: Source[]; // 循证文献列表
keyRef: string; // 关键引用说明
contraindications: string; // 禁忌证
warnings?: string; // 警示
}
interface Source {
type: 'PMID' | 'NCT' | 'DOI' | 'URL';
label: string;
url: string;
}teams.ts / aiApps.ts / science.ts
类似结构，参考现有文件格式。
GLM API Key 配置（Step 5）
当前状态
AI 搜索面板已接入 GLM API（MiniMax），当前为演示模式（未配置 Key 时降级）。
配置步骤
Step 1：获取 API Key
- 访问 https://www.minimaxi.com/document
- 注册/登录 MiniMax 账号
- 创建 API Key（abab5.5-chat 模型）
Step 2：创建 .env 文件
# 在 /workspace/projects/fmtwiki/fmtwiki-query/ 下创建 .env
VITE_GLM_API_KEY=your_api_key_hereStep 3：重新构建部署
cd /workspace/projects/fmtwiki/fmtwiki-query
pnpm run build
# 构建完成后自动部署验证： 访问 AI 搜索面板，发送问题，观察是否从"[演示模式]"切换为真实 GLM 回复。
aiSearch.ts 关键参数
const API_URL = 'https://api.minimaxi.com/v1/text/chatcompletion_v2';
const model = 'abab5.5-chat';
temperature = 0.3; // 专业回答用低温
max_tokens = 800; // 控制响应长度M-DQA SOP（Generator → Evaluator 双代理审查）
触发条件： 任何疾病词条、团队、AI应用、Science论文数据的新增或修改。
流程：
Step 1: Generator（写作代理）
→ 撰写新内容/修改，列出所有 PMID
→ 输出：草稿 + PMID 列表
Step 2: Evaluator（审查代理）
→ 独立审查内容准确性
→ 通过 PubMed 逐条验证每个 PMID（标题+期刊+年份匹配）
→ 拒绝任何无法验证的 PMID
Step 3: 写入数据文件
→ 仅在 Evaluator 通过后写入 src/data/*.tsPMID 验证方法：
- 访问
https://pubmed.ncbi.nlm.nih.gov/?term={PMID} - 核对：标题、期刊、年份完全匹配
- 不匹配 → 废弃该 PMID，重新搜索正确文献
定时任务
| 任务 | 触发 | 内容 | 脚本 |
|---|---|---|---|
fmtwiki-littracker-001 | 周六 09:00 | PubMed 新文献扫描 | scripts/tracker.ts |
fmtwiki-teams-update | 每3天 09:30 | 团队最新动态 | 同上 |
fmtwiki-aiapps-update | 每日 22:00 | AI应用动态 | 同上 |
fmtwiki-science-tracker | 每日 08:00 | Science期刊追踪 | 同上 |
首页版本管理
| 方案 | 文件 | 状态 |
|---|---|---|
| Effect A | LandingPage.tsx | 备选（粒子宇宙暗色） |
| Effect B | LandingPageB.tsx | 备选（数据仪表盘） |
| Effect C | LandingPageC.tsx | 备选（DNA双螺旋） |
| Effect D | LandingPageD.tsx | 备选（暗场显微镜） |
| Effect E | LandingPageE.tsx | ✅ 主版本（融合版） |
Effect E = Effect A 视觉骨架 + Effect D 文案内容 + GRADE四宫格/Oxford进度条/运行状态面板。
维护 Checklist
- [ ] 新增疾病词条：Generator→Evaluator→PubMed验证→写入 diseases.ts
- [ ] 更新团队信息：Generator→Evaluator→写入 teams.ts
- [ ] 添加AI应用：Generator→Evaluator→来源链接验证→写入 aiApps.ts
- [ ] PubMed文献追踪：tracker.ts 执行→报告→Generator→Evaluator→写入 science.ts
- [ ] GLM API Key 配置：创建 .env → build → 验证 AI 搜索面板
- [ ] 首页归档：保留 Effect E，删除 LandingPage/B/C/D
联系方式
- 项目负责人：赵铭远
- 医学顾问：苏州市立医院 FMT 团队
- 技术栈：React + TypeScript + TailwindCSS + Vite + MiniMax GLM API