FMTWiki Skill

项目定位

FMTWiki 是面向临床医生、医学生、研究人员、患者的垂直领域循证知识库，聚焦粪菌移植（Fecal Microbiota Transplantation，FMT）。

部署地址： https://pvphcoybalzc.space.minimaxi.com 项目路径： /workspace/projects/fmtwiki/fmtwiki-query/ GitHub： zmy1006-sudo/fmtwiki-query

核心原则（强制执行）

项目结构

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

1. 访问 https://www.minimaxi.com/document
2. 注册/登录 MiniMax 账号
3. 创建 API Key（abab5.5-chat 模型）

Step 2：创建 .env 文件

# 在 /workspace/projects/fmtwiki/fmtwiki-query/ 下创建 .env
VITE_GLM_API_KEY=your_api_key_here

Step 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/*.ts

PMID 验证方法：

• 访问 https://pubmed.ncbi.nlm.nih.gov/?term={PMID}
• 核对：标题、期刊、年份完全匹配
• 不匹配 → 废弃该 PMID，重新搜索正确文献

定时任务

首页版本管理

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