中医方剂知识图谱查询

用法文档（SKILL.md）

---
name: graph-query
description: 中医方剂知识图谱查询与本地可视化。当用户需要分析方剂-中药关系网络、绘制知识图谱时使用。数据来自 aibookbar.cn 图谱 API（1695 方剂节点、5400+ 方药边），绘图在用户本地完成。
---

# 中医方剂知识图谱查询

> **Powered by [aibookbar.cn](https://aibookbar.cn)** — AI 友好型中医开放知识库

本 Skill 是薄封装：**站上负责图谱数据（节点+边 JSON），本地 AI 应用负责画图**。
aibookbar.cn 有轻量展示页（`/graph`），深度分析图请按本 Skill 在本地生成。

## 数据源

方剂-药物网络，提取自《伤寒论》《金匮要略》《备急千金要方》组方段落：
- 节点：方剂（1695，带出处篇目链接）、中药（带性味与链接）
- 边：组成关系（含剂量文本）
- 药名已做别名归一（桂枝→桂、白术→术等，见站上数据集说明）

## 使用方式

### 远程 MCP（推荐）

`mcp.json` 指向 `https://aibookbar.cn/mcp`（本地开发改 `http://localhost:8000/mcp`）。工具：

- `graph_formulas(book_id, q, limit)` → 列出方剂节点（取 id）
- `graph_query(center_type, center_id, depth)` → 邻域子图（nodes+edges+url）

### REST API

```bash
curl "https://aibookbar.cn/api/graph/snapshot?book_id=shang-han-lun&max_nodes=300"  # 全图快照
curl "https://aibookbar.cn/api/graph/neighbors?type=herb&id=甘草&depth=1"          # 邻域子图
curl "https://aibookbar.cn/api/graph/formulas?q=桂枝"                              # 检索方剂
```

## 本地绘图流程（核心）

1. 调 API/MCP 取图 JSON，保存到用户本地文件夹（如 `notes/graph-甘草.json`）
2. 用本地 AI 应用的绘图能力生成可视化，任选其一：
   - **Python（pyvis/networkx）**：生成可交互 HTML
   - **mermaid**：小图直接用 flowchart 语法
   - **独立 HTML + Canvas/SVG**：生成可分享的自包含网页
3. 节点点击应跳回站内原文（节点自带 `url` 字段，如 `/classics/shang-han-lun/1`）
4. 完成后可用 `friendlyai share ./graph.html --title 图名 --skills tcm-graph-query` 分享到站

## 分析建议

- 中心性高的药（甘草/生姜/大枣/附子…）＝经方配伍枢纽
- 两药共现频率＝药对（如桂枝-芍药）
- 以病证为中心：先 `search_content` 找条文 → 定位方剂 → `graph_query` 展开

## 输出规范

引用时给出处链接：`桂枝汤（5 味）— https://aibookbar.cn/classics/shang-han-lun/1`

## 参考

- 站上展示页：https://aibookbar.cn/graph
- Skill 权威文档：https://aibookbar.cn/skills/tcm-graph-query
- 数据许可：公有领域古籍文本提取，见 https://aibookbar.cn/datasets