Skip to content

Hypergraph is more powerful. Transform unstructured text into structured knowledge with LLMs. Graphs, hypergraphs, and spatio-temporal extractions — with one command.

docs: 更新README和模板文档,添加图片资源

yifanfeng97d271b58f4c40
diff --git a/README.md b/README.md
index 8536dab..6cde68a 100644
--- a/README.md
+++ b/README.md
@@ -1,114 +1,153 @@
-# Hyper-Extract: The Knowledge Engine for Vertical AI Agents 🧠🚀
+# Hyper-Extract
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](pyproject.toml)
+[中文版](./README_ZH.md) · [English Version](#)
-**Hyper-Extract** is a next-generation framework designed to transform massive, unstructured domain documents into **searchable, queryable, and actionable** knowledge structures.
+---
+
+<!-- Architecture Diagram -->
+![Architecture](./docs/assets/fw.png)
-Stop treating your documents as dead text chunks. With Hyper-Extract, every PDF, report, and manual becomes a live, structured brain for your AI Agents.
+---
-[中文版 (README_ZH.md)](README_ZH.md) | [Domain Samples](examples/)
+## "Chat solved. What's next is Knowledge."
+
+Transform LLM output from scattered text into **searchable, queryable, and reasoning-enabled** structured knowledge.
---
-## 🌟 Why Hyper-Extract?
+## ❌ Before | ✅ After
-Traditional RAG often fails in professional domains because it loses the **logical structure** of knowledge. Hyper-Extract solves this by providing a unique **3-Layer Architecture**:
+<!-- Concept Diagram -->
+![Concept](./docs/assets/concept.png)
-### 🧱 Layer 1: Knowledge Primitives (`hyperextract.types`)
-The "DNA" of knowledge. We provide specialized "AutoType" structures categorized into four levels of complexity:
+| Before | After |
+| :--- | :--- |
+| LLM outputs a wall of text | Structured knowledge output |
+| ❌ Answer disappears after chat | ✅ Persistent storage |
+| ❌ Can't search precisely | ✅ Precise search |
+| ❌ Can't trace the source | ✅ Traceable provenance |
+| ❌ Fragmented, can't reuse | ✅ Knowledge accumulates |
-| Level | Primitives | Core Logic | Best For |
-| :--- | :--- | :--- | :--- |
-| **Scalar & Doc** | `AutoModel` | Many chunks -> **One** consistent object | Research reports, Infoboxes, Summaries |
-| **Collections** | `AutoList`, `AutoSet` | Many independent or unique items | Entity registries, Event logs, Glossaries |
-| **Graphs** | `AutoGraph`, `AutoHypergraph` | Pairwise or N-ary (Hyper-edge) relations | Knowledge Graphs, Complex causality reasoning |
-| **Context-Aware** | `AutoTemporalGraph`, `AutoSpatialGraph`, `AutoSpatioTemporalGraph` | Resolves relative time/space context | Timelines, History, IoT |
+---
-### ⚙️ Layer 2: Extraction Engines (`hyperextract.methods`)
-The "Brain" of the framework. Built-in SOTA algorithms that turn primitives into power:
-- **Light-RAG / GraphRAG**: High-efficiency retrieval over graph structures.
-- **Hyper-RAG**: Reasoning via complex hyper-relations.
-- **CogRAG**: Cognition-driven hierarchical extraction.
+## 🧩 8 AutoTypes
-### 🧠 Layer 3: 12+ Domain Expert Templates (`hyperextract.templates`)
-The "Expertise" you need. Out-of-the-box schemas and prompts for vertical industries:
-- **Finance, Medicine, Law, TCM, Industry, History, Biology, Literature, Travel, News, Agriculture, Food.**
+<!-- AutoTypes Diagram -->
+![AutoTypes](./docs/assets/autotypes.png)
+
+| Type | Icon | What it does |
+| :--- | :---: | :--- |
+| **AutoModel** | 📋 | Extract into a complete data model |
+| **AutoList** | 📝 | Extract as a list (keywords, items) |
+| **AutoSet** | 📦 | Extract and deduplicate (entity registry) |
+| **AutoGraph** | 🔗 | Extract as a knowledge graph (relations) |
+| **AutoTemporalGraph** | ⏱️ | Extract as timeline (events over time) |
+| **AutoSpatialGraph** | 📍 | Extract as spatial graph (locations) |
+| **AutoSpatioTemporalGraph** | 🌏 | Extract as spatiotemporal graph (time + space) |
+| **AutoHypergraph** | 🌐 | Extract as hypergraph (multi-party relations) |
---
-## 🎭 Transform Your Domain in Minutes
+## 🔬 Method Comparison
+
+| Method | Type | Model | List | Set | Graph | Temporal | Spatial | Spatiotemporal | Hypergraph |
+| :--- | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
+| **KG-Gen** | Graph | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
+| **ATOM** | Atomic | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ |
+| **Graphiti** | Temporal | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
+| **LightRAG** | Graph | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
+| **Hyper-RAG** | Hypergraph | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
+| **Hyper-Extract** | All-in-One | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+
+---
-"From static files to an intelligent agent engine."
+## 🌍 12 Domains, 200+ Templates
-| Your Domain | From Static Docs ... | To Actionable Agents 🤖 |
-| :--- | :--- | :--- |
-| **💰 Finance** | Annual reports, prospectuses | **Investment Analyst Agent** (Reasoning over valuation logic) |
-| **🏥 Medicine** | Clinical guidelines, patient records | **Diagnostic Assistant Agent** (Mapping symptoms to pathways) |
-| **⚖️ Legal** | Contracts, court rulings | **Compliance Auditor Agent** (Extracting obligations & risks) |
-| **🔧 Industry** | Maintenance logs, specs | **Ops Expert Agent** (Connecting failure modes to root causes) |
-| **📜 History** | Chronicles, biographies | **Historian Agent** (Reconstructing event timelines) |
+| Domain | Templates | Domain | Templates |
+| :--- | :---: | :--- | :---: |
+| 💰 Finance | 25+ | 📜 History | 12+ |
+| 🏥 Medicine | 20+ | 🧬 Biology | 10+ |
+| ⚖️ Legal | 15+ | 🎭 Literature | 10+ |
+| 🌿 TCM | 15+ | 📰 News | 12+ |
+| 🔧 Industry | 18+ | 🌾 Agriculture | 8+ |
+| 🍜 Food | 8+ | 🌐 General | 20+ |
---
-## 🚀 Quick Start: Build an "Askable" Knowledge Base
+## 🚀 Quick Start
```python
-from hyperextract.types import AutoGraph
from hyperextract.templates.en.finance import ResearchNoteSummary
-from langchain_openai import ChatOpenAI
+from langchain_openai import ChatOpenAI, OpenAIEmbeddings
-# 1. Load an industry-expert template
llm = ChatOpenAI(model="gpt-4o-mini")
-kb = AutoGraph.from_template(ResearchNoteSummary, llm_client=llm)
+embedder = OpenAIEmbeddings()
-# 2. Feed your domain text (Extraction happens automatically!)
-text = "Apple's valuation is driven by its services growth and iPhone 16 cycle..."
-kb.feed_text(text)
+template = ResearchNoteSummary(llm_client=llm, embedder=embedder)
+result = template.extract("Apple Q3 revenue reached $94.9 billion...")
-# 3. Chat with the Structure (Actionable Insight)
-answer = kb.chat("What are the core drivers of Apple's valuation?")
+answer = template.chat("What drove the revenue growth?")
print(answer.content)
```
-
---
-## 🎨 Domain Templates
+## 🔧 Architecture
+
+<details>
+<summary><strong>Technical Details</strong></summary>
-The `hyperextract/templates` directory provides a wealth of domain-specific definitions that you can import directly without writing prompts from scratch:
+```
+hyperextract/
+├── types/ # 8 AutoTypes
+│ ├── model.py # AutoModel
+│ ├── list.py # AutoList
+│ ├── set.py # AutoSet
+│ ├── graph.py # AutoGraph
+│ ├── hypergraph.py # AutoHypergraph
+│ ├── temporal_graph.py # AutoTemporalGraph
+│ ├── spatial_graph.py # AutoSpatialGraph
+│ └── spatio_temporal_graph.py # AutoSpatioTemporalGraph
+│
+├── methods/ # Extraction Engines
+│ ├── rag/ # RAG methods
+│ │ ├── light_rag.py
+│ │ ├── hyper_rag.py
+│ │ └── cog_rag.py
+│ └── typical/ # Reproduced methods
+│ ├── kg_gen.py # KG-Gen
+│ └── atom.py # ATOM
+│
+└── templates/ # Domain Templates
+ ├── zh/ # Chinese templates
+ │ ├── finance/ # 25+ templates
+ │ ├── medicine/ # 20+ templates
+ │ └── ...
+ └── en/ # English templates
+```
-| Category | Templates | Description |
-| :--- | :--- | :--- |
-| **General** | `General`, `IText2KG` | Versatile extraction for most daily knowledge. |
-| **Science** | `Physics`, `Chemistry`, `Biology` | Capture experiments, elements, and reactions. |
-| **Industry** | `Finance`, `Legal` | Extract compliance, risks, and entity webs. |
-| **Entertainment** | `Game`, `Movie`, `Food` | Perfect for story plots, character networks, and recipes. |
-| ... | | 15+ domains in the [templates folder](hyperextract/templates) |
+</details>
---
-## 🏗️ Core Components
+## 📚 Documentation & Resources
-- **`hyperextract.types`**: Core AutoTypes data structures (AutoModel, AutoGraph, AutoHypergraph, etc.).
-- **`hyperextract.methods`**: Extraction algorithms and RAG strategies (Hyper-RAG, Cog-RAG, iText2KG, etc.).
-- **`hyperextract.utils`**: Essential utilities for logging and merging strategies.
+- [📖 Full Documentation](docs/)
+- [💻 Examples](examples/)
+- [🏷️ Template Gallery](hyperextract/templates/)
---
-## 📚 Implemented Algorithms & Paper Demos
+## 🤝 Contributing
-- **Auto-Graph**: Schema-adaptive graph extraction.
-- **Hyper-RAG**: Retrieval Augmented Generation via Hypergraphs.
-- **Light-RAG**: Lightweight and efficient graph retrieval.
-- **IText2KG / IText2KG-Star**: Iterative Knowledge Graph generation.
-- **CogRAG**: Cognition-driven hierarchical retrieval.
+Welcome! Please feel free to submit issues and pull requests.
---
-## 🤝 Contributing
+## ⭐ Support
-We welcome Issues and Pull Requests!
+If you find this project helpful, please give us a ⭐ to show your support!
+
+---
-- **License**: [MIT LICENSE](LICENSE)
-- **Support**: If you find this project helpful, please give us a ⭐️!
+*Built with ❤️ for the AI Community*
diff --git a/README_ZH.md b/README_ZH.md
index f3330de..24389b1 100644
--- a/README_ZH.md
+++ b/README_ZH.md
@@ -1,114 +1,153 @@
-# Hyper-Extract: 垂直领域 AI Agent 的知识引擎 🧠🚀
+# Hyper-Extract
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](pyproject.toml)
+[English Version](./README.md) · [中文版](#)
-**Hyper-Extract** 是一个下一代知识提取框架,旨在将海量、非结构化的领域文档转化为**可搜索、可查询、可推理**的知识结构。
+---
+
+<!-- 架构图 -->
+![架构图](./docs/assets/fw.png)
+
+---
-不要再把你的文档当作死气沉沉的文本切片。通过 Hyper-Extract,每一份 PDF、研报、说明书都能转化为 AI Agent 动态调用的“活体大脑”。
+## "Chat 已解决,下一步是知识"
-[English (README.md)](README.md) | [示例代码](examples/)
+将 LLM 输出的文本转化为**可搜索、可查询、可推理**的结构化知识。
---
-## 🌟 为什么选择 Hyper-Extract?
+## ❌ 以前 | ✅ 现在
-传统的 RAG 模型在垂直和专业领域往往因为丢失知识的**逻辑结构**而失效。Hyper-Extract 通过独特的**三层分级架构**解决这一痛点:
+<!-- 概念图 -->
+![概念图](./docs/assets/concept.png)
-### 🧱 第一级:知识基础原语 (`hyperextract.types`)
-知识的 "DNA"。我们根据信息复杂度的不同,将 "AutoType" 结构分为四个层级:
+| 以前 | 现在 |
+| :--- | :--- |
+| LLM 输出一堆文本 | 输出结构化知识 |
+| ❌ 回答完就消失 | ✅ 可持久化存储 |
+| ❌ 无法精准检索 | ✅ 可精准搜索 |
+| ❌ 难以追溯源头 | ✅ 可追溯来源 |
+| ❌ 碎片化无法复用 | ✅ 知识沉淀复用 |
-| 层级 | 基础原语 | 核心逻辑 | 适用场景 |
-| :--- | :--- | :--- | :--- |
-| **标量与文档型** | `AutoModel` | 多个切片 -> **一个**一致性的对象 | 研报摘要、百科条目、元数据提取 |
-| **集合型** | `AutoList`, `AutoSet` | 独立项或唯一实体的去重集合 | 实体清单、术语表、RPG 手册 |
-| **图谱型** | `AutoGraph`, `AutoHypergraph` | 二元 (Pairwise) 或多元 (N-ary) 关系 | 知识图谱、多因素复杂因果推理 |
-| **时空感知型** | `AutoTemporalGraph`, `AutoSpatialGraph`, `AutoSpatioTemporalGraph` | 解析相对的时间/空间上下文 | 编年史、时政新闻、拓扑描述 |
+---
+
+## 🧩 8 种 AutoType
-### ⚙️ 第二级:核心提取引擎 (`hyperextract.methods`)
-系统的 "大脑"。内置 SOTA 算法,让数据结构产生生产力:
-- **Light-RAG / GraphRAG**: 在图谱结构上进行高效率的全局检索。
-- **Hyper-RAG / CogRAG**: 基于复杂超图和认知层级的推理问答引擎。
-- **Typical Methods**: 支持 iText2KG, KG-Gen 等经典提取逻辑。
+<!-- AutoTypes 图 -->
+![AutoTypes](./docs/assets/autotypes.png)
-### 🧠 第三级:12+ 行业领域专家模板 (`hyperextract.templates`)
-你的专业 "灵魂"。开箱即用的行业 Schema 和 Prompt:
-- **金融、医疗、法律、中医、工业、历史、生物、文学、旅游、新闻、农业、美食。**
+| 类型 | 图标 | 功能 |
+| :--- | :---: | :--- |
+| **AutoModel** | 📋 | 提取为完整的数据模型 |
+| **AutoList** | 📝 | 提取为列表 |
+| **AutoSet** | 📦 | 提取并去重 |
+| **AutoGraph** | 🔗 | 提取为知识图谱 |
+| **AutoTemporalGraph** | ⏱️ | 提取为时序图 |
+| **AutoSpatialGraph** | 📍 | 提取为空间图 |
+| **AutoSpatioTemporalGraph** | 🌏 | 提取为时空图 |
+| **AutoHypergraph** | 🌐 | 提取为超图 |
---
-## 🎭 瞬间转化:从静态文档到行业专家 Agent 🤖
+## 🔬 方法对比
-"让每一行文本都具有交互性。"
+| 方法 | 类型 | Model | List | Set | Graph | Temporal | Spatial | Spatiotemporal | Hypergraph |
+| :--- | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
+| **KG-Gen** | Graph | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
+| **ATOM** | Atomic | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ |
+| **Graphiti** | Temporal | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
+| **LightRAG** | Graph | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
+| **Hyper-RAG** | Hypergraph | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
+| **Hyper-Extract** | All-in-One | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+
+---
-| 领域 | 原始文档输入 | 转化后的 Agent 能力 |
-| :--- | :--- | :--- |
-| **💰 金融** | 研报、公告、招股书 | **投研助手 Agent** (推理各公司估值逻辑与驱动因素) |
-| **🏥 医疗** | 临床指南、病案、说明书 | **诊疗分析 Agent** (从症状推演鉴别诊断路径) |
-| **⚖️ 法律** | 合同协议、判决文书 | **合规风控 Agent** (一分钟内提取复杂责任与违约关系) |
-| **🔧 工业** | 运维日志、技术规格书 | **排故专家 Agent** (关联故障现象与其根本原因) |
-| **📜 历史** | 编年史、信札、传记 | **文史学家 Agent** (还原复杂的历史事件因果链条) |
+## 🌍 12 个领域,200+ 模板
+
+| 领域 | 模板数 | 领域 | 模板数 |
+| :--- | :---: | :--- | :---: |
+| 💰 金融 | 25+ | 📜 历史 | 12+ |
+| 🏥 医疗 | 20+ | 🧬 生物 | 10+ |
+| ⚖️ 法律 | 15+ | 🎭 文学 | 10+ |
+| 🌿 中医 | 15+ | 📰 新闻 | 12+ |
+| 🔧 工业 | 18+ | 🌾 农业 | 8+ |
+| 🍜 美食 | 8+ | 🌐 通用 | 20+ |
---
-## 🚀 快速上手:构建一个“可对话”的领域知识库
+## 🚀 快速开始
```python
-from hyperextract.types import AutoGraph
from hyperextract.templates.zh.finance import ResearchNoteSummary
-from langchain_openai import ChatOpenAI
+from langchain_openai import ChatOpenAI, OpenAIEmbeddings
-# 1. 加载一个行业模板 (例如: 金融研报摘要)
llm = ChatOpenAI(model="gpt-4o-mini")
-kb = AutoGraph.from_template(ResearchNoteSummary, llm_client=llm)
+embedder = OpenAIEmbeddings()
-# 2. “喂入” 领域文本 (自动完成知识提取与建模)
-text = "苹果公司的估值核心逻辑在于其服务收入的增长以及 iPhone 16 的换机周期..."
-kb.feed_text(text)
+template = ResearchNoteSummary(llm_client=llm, embedder=embedder)
+result = template.extract("苹果Q3营收达到949亿美元...")
-# 3. 针对结构化知识直接对话 (具有逻辑支撑的答案)
-answer = kb.chat("苹果公司的估值驱动因素有哪些?")
+answer = template.chat("营收增长的原因是什么?")
print(answer.content)
```
-
---
-## 🎨 领域模版 (Templates)
+## 🔧 技术架构
-本项目在 `hyperextract/templates` 下提供了丰富的领域定义,你可以直接导入使用,无需从头编写 Prompt 或 Schema:
+<details>
+<summary><strong>技术细节</strong></summary>
-| 领域 | 包含模版 | 描述 |
-| :--- | :--- | :--- |
-| **通用** | `General`, `IText2KG` | 适用于大多数日常知识提取。 |
-| **科学** | `Physics`, `Chemistry`, `Biology` | 捕捉科学实验、元素、反应过程。 |
-| **行业** | `Finance`, `Legal` | 提取合规、风险点、实体关联。 |
-| **娱乐** | `Game`, `Movie`, `Food` | 完美支持游戏剧情、角色关系网、食谱制作。 |
-| ... | | 更多 15+ 领域见 [templates 目录](hyperextract/templates) |
+```
+hyperextract/
+├── types/ # 8 种 AutoType
+│ ├── model.py # AutoModel
+│ ├── list.py # AutoList
+│ ├── set.py # AutoSet
+│ ├── graph.py # AutoGraph
+│ ├── hypergraph.py # AutoHypergraph
+│ ├── temporal_graph.py # AutoTemporalGraph
+│ ├── spatial_graph.py # AutoSpatialGraph
+│ └── spatio_temporal_graph.py # AutoSpatioTemporalGraph
+│
+├── methods/ # 提取引擎
+│ ├── rag/ # RAG 方法
+│ │ ├── light_rag.py
+│ │ ├── hyper_rag.py
+│ │ └── cog_rag.py
+│ └── typical/ # 复现的方法
+│ ├── kg_gen.py # KG-Gen
+│ └── atom.py # ATOM
+│
+└── templates/ # 领域模板
+ ├── zh/ # 中文模板
+ │ ├── finance/ # 25+ 模板
+ │ ├── medicine/ # 20+ 模板
+ │ └── ...
+ └── en/ # 英文模板
+```
+
+</details>
---
-## 🏗️ 核心组件
+## 📚 文档与资源
-- **`hyperextract.types`**: 核心 AutoTypes 数据类型(如 AutoModel, AutoGraph, AutoHypergraph 等)。
-- **`hyperextract.methods`**: 知识提取算法与 RAG 策略(如 Hyper-RAG, Cog-RAG, iText2KG 等)。
-- **`hyperextract.utils`**: 日志、合并策略等实用工具。
+- [📖 完整文档](docs/)
+- [💻 示例代码](examples/)
+- [🏷️ 模板 Gallery](hyperextract/templates/)
---
-## 📚 已复现论文/算法
+## 🤝 贡献
-- **Auto-Graph**: 自动 Schema 适应的图提取。
-- **Hyper-RAG**: 基于超图的检索增强生成。
-- **Light-RAG**: 轻量化、高效率的图检索。
-- **IText2KG / IText2KG-Star**: 迭代式知识图谱生成。
-- **CogRAG**: 认知驱动的层次化检索。
+欢迎提交 Issue 和 Pull Request!
---
-## 🤝 贡献与反馈
+## ⭐ 支持
+
+如果你觉得这个项目有帮助,请给我们一个 ⭐ 表示支持!
-欢迎提交 Issue 或 Pull Request 来完善这个项目!
+---
-- **开源协议**: [MIT LICENSE](LICENSE)
-- **Star我们**: 如果这个项目对你有帮助,请给一个 ⭐️ 以示支持!
+*用 ❤️ 为 AI 社区构建*
diff --git a/docs/assets/autotypes.png b/docs/assets/autotypes.png
new file mode 100644
index 0000000..0cf8505
Binary files /dev/null and b/docs/assets/autotypes.png differ
diff --git a/docs/assets/concept.png b/docs/assets/concept.png
new file mode 100644
index 0000000..8745992
Binary files /dev/null and b/docs/assets/concept.png differ
diff --git a/docs/assets/fw.png b/docs/assets/fw.png
new file mode 100644
index 0000000..8408b17
Binary files /dev/null and b/docs/assets/fw.png differ
diff --git a/hyperextract/templates/README.md b/hyperextract/templates/README.md
index 8c9d6a4..5d086a9 100644
--- a/hyperextract/templates/README.md
+++ b/hyperextract/templates/README.md
@@ -4,6 +4,40 @@ The **Hyper-Extract Domain Templates** library allows you to extract structured
This library is organized by **Domain**, ensuring that the extraction logic matches the specific vocabulary, document structures, and extraction goals of different industries.
+> 切换至 [中文版](./README_ZH.md)
+
+---
+
+## 📋 Table of Contents
+
+- [📚 General](#1-general-general-purpose)
+- [💰 Finance](#2-finance-finance)
+- [🏥 Medicine](#3-medicine-medicine)
+- [🌿 TCM](#4-tcm-traditional-chinese-medicine)
+- [⚙️ Industry](#5-industry-industry)
+- [📜 History](#6-history-history)
+- [🧬 Biology](#7-biology-biology)
+- [⚖️ Legal](#8-legal-legal)
+- [🎭 Literature](#9-literature-literature--fiction)
+- [📰 News](#10-news-news--journalism)
+- [🌾 Agriculture](#11-agriculture-agriculture)
+- [🍜 Food](#12-food-food)
+
+---
+
+## Primitive Types Overview
+
+| Primitive | Description |
+| :--- | :--- |
+| **`AutoGraph`** | Knowledge Graph - extracts entities and pairwise relationships |
+| **`AutoSet`** | Entity Set - deduplicates and collects unique entities |
+| **`AutoList`** | List - extracts arrays of values (keywords, items, etc.) |
+| **`AutoModel`** | Data Model - extracts structured data fields (like an infobox) |
+| **`AutoTemporalGraph`** | Temporal Graph - builds time-ordered event sequences |
+| **`AutoHypergraph`** | Hypergraph - models complex multi-entity relationships |
+
+---
+
## Domain Index
| Domain | Description | Key Focus |
@@ -23,405 +57,465 @@ This library is organized by **Domain**, ensuring that the extraction logic matc
---
-## Domain Details and Typical Documents
+## Domain Details
+
+### 1. 📚 `general` (General Purpose)
-### 1. `general` (General Purpose)
The default choice for unstructured text that doesn't fit a specific industry.
-* **Arbitrary Text (Universal Extraction)**: Any type of text (e.g., web content, notes, blogs) for direct entity and relationship extraction.
+* **Arbitrary Text (Universal Extraction)**: Any type of text for direct entity and relationship extraction.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`KnowledgeGraph`** | `AutoGraph` | **General Knowledge Graph**. Extracts entities and relations using a broad, universal schema. | Open-domain text, web pages |
-| **`EntityRegistry`** | `AutoSet` | **Entity Registry**. Deduplicates and compiles a list of unique entities (People, Organizations). | Entity collection, NER tasks |
-| **`KeywordList`** | `AutoList` | **Keyword List**. Extracts core concepts, main topics, or tags from the text. | Content indexing, tagging |
+| **`KnowledgeGraph`** | `AutoGraph` | General-purpose knowledge graph extraction | Open-domain text, web pages |
+| **`EntityRegistry`** | `AutoSet` | Deduplicates unique entities (People, Orgs) | Entity collection, NER tasks |
+| **`KeywordList`** | `AutoList` | Core concepts, topics, or tags | Content indexing, tagging |
-* **Wikipedia Articles / Encyclopedias**: Comprehensive descriptions of entities with structured infobox-like attributes.
+* **Wikipedia / Encyclopedias**: Comprehensive entity descriptions with structured attributes.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`EncyclopediaItem`** | `AutoModel` | **Encyclopedia Profile**. Extracts a structured profile for a single main entity (infobox style). | Wiki pages, dictionary entries |
-| **`ConceptHierarchy`** | `AutoGraph` | **Concept Hierarchy**. Builds a taxonomy graph (Subclass-Of, Part-Of relations). | Scientific wikis, textbook units |
-| **`CrossReferenceNet`** | `AutoGraph` | **Cross-Reference Net**. Maps hyperlinks and citations between different concepts. | Inter-article navigation maps |
+| **`EncyclopediaItem`** | `AutoModel` | Structured profile (infobox style) | Wiki pages, dictionaries |
+| **`ConceptHierarchy`** | `AutoGraph` | Taxonomy: Subclass-Of, Part-Of relations | Scientific wikis, textbooks |
+| **`CrossReferenceNet`** | `AutoGraph` | Hyperlinks and citations between concepts | Navigation maps |
-* **Biographies & Memoirs**: Life stories of individuals, focusing on key life events and relationships.
+* **Biographies & Memoirs**: Life stories focusing on key events and relationships.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`LifeEventTimeline`** | `AutoTemporalGraph` | **Life Timeline**. Extracts life events with timestamps, sorted chronologically. | Biographies, annals, diaries |
-| **`SocialNetwork`** | `AutoGraph` | **Social Network**. Specifically captures interpersonal relationships and interactions. | Character studies, memoirs |
-| **`PersonalProfile`** | `AutoModel` | **Personal Bio**. Aggregates static personal attributes (birth, education, career tags). | Profiles, CVs, obituary summaries |
+| **`LifeEventTimeline`** | `AutoTemporalGraph` | Chronological life events with timestamps | Biographies, diaries |
+| **`SocialNetwork`** | `AutoGraph` | Interpersonal relationships and interactions | Character studies |
+| **`PersonalProfile`** | `AutoModel` | Static attributes (birth, education, career) | Profiles, CVs |
-* **Regulations & Compliance**: Internal policies, administrative regulations, SOPs, and compliance guidelines.
+* **Regulations & Compliance**: Policies, SOPs, and compliance guidelines.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`RegulationProfile`** | `AutoModel` | **Policy Snapshot**. Extracts policy name, version, scope, effective date, and core purpose. | Policy overview, version control |
-| **`ComplianceLogic`** | `AutoHypergraph` | **Compliance Logic Map**. Models complex "Who, Under what conditions, Must/Must not do What" logic. | Compliance auditing, risk identification |
-| **`PenaltyRegistry`** | `AutoSet` | **Violation-Penalty Registry**. Aggregates unique violations and their specific consequences into a ledger. | Risk management, compliance check |
-| **`OperationalProcedure`** | `AutoGraph` | **Operational Workflow**. Extracts sequential steps for applications, approvals, or operational procedures. | SOP visualization, process guides |
-| **`PenaltyMapping`** | `AutoGraph` | **Enforcement Chain**. Describes the path from violation trigger to handling process and final consequences. | Root cause analysis, penalty logic |
-| **`ClauseList`** | `AutoList` | **Atomic Clause List**. Dissects the regulation into individual atomic clauses for quick indexing. | Clause retrieval, document comparison |
+| **`RegulationProfile`** | `AutoModel` | Policy name, version, scope, effective date | Policy overview, version control |
+| **`ComplianceLogic`** | `AutoHypergraph` | Complex "Who + Condition → Must/Must Not Do What" | Compliance auditing |
+| **`PenaltyRegistry`** | `AutoSet` | Unique violations and consequences | Risk management |
+| **`OperationalProcedure`** | `AutoGraph` | Sequential steps for applications/approvals | SOP visualization |
+| **`PenaltyMapping`** | `AutoGraph` | Violation → Process → Consequence chain | Root cause analysis |
+| **`ClauseList`** | `AutoList` | Atomic clauses for quick indexing | Clause retrieval |
+
+[↑ Back to Top](#table-of-contents)
+
+---
+
+### 2. 💰 `finance` (Finance)
-### 2. `finance` (Finance)
Optimized for complex financial relationships, market sentiment, and temporal events.
-* **SEC Filings (10-K / 10-Q / 8-K)**: Standardized regulatory filings containing financial statements, management discussion, risk factors, and material event disclosures with complex document structures (tables, narratives, exhibits).
+* **SEC Filings (10-K / 10-Q / 8-K)**: Standardized regulatory filings with financial statements, MD&A, risk factors.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`FilingFinancialSnapshot`** | `AutoModel` | **Financial Data Extraction**. Extracts key figures from income statements, balance sheets, and cash flow statements embedded in filings. | Fundamental screening, financial database population |
-| **`MDANarrativeGraph`** | `AutoGraph` | **MD&A Causal Map**. Extracts causal relationships from Management Discussion & Analysis (e.g., "Supply chain disruption -> Revenue decline -> Margin compression"). | Narrative analytics, driver attribution |
-| **`FilingRiskFactorSet`** | `AutoSet` | **Risk Factor Registry**. Deduplicates and catalogs all risk factors disclosed across Item 1A, tracking additions and removals between filing periods. | Risk evolution monitoring, cross-company risk comparison |
-| **`MaterialEventTimeline`** | `AutoTemporalGraph` | **8-K Event Timeline**. Chronologically extracts material events (executive changes, M&A announcements, restatements) from current reports. | Event-driven analysis, regulatory monitoring |
-| **`SegmentPerformanceList`** | `AutoList` | **Segment Breakdown**. Extracts revenue, operating income, and key metrics by business segment or geographic region. | Segment-level valuation, geographic exposure analysis |
-| **`FinancialDataTemporalGraph`** | `AutoTemporalGraph` | **Financial Data Timeline**. Builds a temporal graph of financial metrics across reporting periods, tracking how revenue, margins, segment contributions, and key ratios evolve over time. | Multi-period trend analysis, cross-period comparison, financial data lineage |
-| **`RiskAssessmentGraph`** | `AutoGraph` | **Risk Assessment Graph**. Systematically extracts transmission paths from risk factors to financial impacts, including likelihood, severity, and mitigation strategies. | Risk monitoring, cross-filing comparative analysis |
-| **`SupplyChainGraph`** | `AutoGraph` | **Supply Chain Graph**. Extracts supply chain entities, transaction relationships, and risk assessments to identify critical suppliers and geopolitical risks. | Supply chain resilience analysis, ESG report analysis |
+| **`FilingFinancialSnapshot`** | `AutoModel` | Key figures from financial statements | Fundamental screening |
+| **`MDANarrativeGraph`** | `AutoGraph` | Causal relationships from MD&A | Narrative analytics |
+| **`FilingRiskFactorSet`** | `AutoSet` | Risk factors from Item 1A | Risk monitoring |
+| **`MaterialEventTimeline`** | `AutoTemporalGraph` | Material events from 8-K reports | Event-driven analysis |
+| **`SegmentPerformanceList`** | `AutoList` | Revenue, income by segment/region | Segment valuation |
+| **`FinancialDataTemporalGraph`** | `AutoTemporalGraph` | Financial metrics across reporting periods | Trend analysis |
+| **`RiskAssessmentGraph`** | `AutoGraph` | Risk factor → Financial impact paths | Risk monitoring |
+| **`SupplyChainGraph`** | `AutoGraph` | Supply chain entities and risks | ESG analysis |
-* **Equity Research Reports**: Detailed analysis by analysts containing ratings, target prices, and investment logic.
+* **Equity Research Reports**: Analyst reports with ratings, target prices, investment logic.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`ResearchNoteSummary`** | `AutoModel` | **Research Core**. Extracts ratings (Buy/Sell), target price, and top-level investment logic. | Report database, screening |
-| **`FinancialForecast`** | `AutoList` | **Financial Estimates**. Extracts projected data (Revenue, EPS, PE) for future years. | Consensus analysis, modeling |
-| **`ValuationLogicMap`** | `AutoGraph` | **Valuation Logic**. Maps causal chains driving stock performance (e.g., New Market -> Growth). | Investment strategy mapping |
-| **`FactorInfluenceHypergraph`** | `AutoHypergraph` | **Multi-factor Analysis**. Models complex relationships between macro factors, industry trends, and company metrics. | Quantamental strategy, factor attribution |
-| **`RiskFactorList`** | `AutoList` | **Risk Registry**. Lists specific downside risks (Regulatory, FX, Supply Chain). | Risk monitoring, negatives scan |
+| **`ResearchNoteSummary`** | `AutoModel` | Ratings, target price, investment logic | Report database |
+| **`FinancialForecast`** | `AutoList` | Projected Revenue, EPS, PE | Consensus analysis |
+| **`ValuationLogicMap`** | `AutoGraph` | Causal chains for stock performance | Strategy mapping |
+| **`FactorInfluenceHypergraph`** | `AutoHypergraph` | Macro → Industry → Company relationships | Factor attribution |
+| **`RiskFactorList`** | `AutoList` | Downside risks | Risk monitoring |
-* **Prospectuses / IPO Filings (S-1)**: Comprehensive disclosures of company history, shareholder structure, and use of proceeds.
+* **Prospectuses / IPO (S-1)**: Company history, shareholder structure, use of proceeds.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`ShareholderStructure`** | `AutoGraph` | **Ownership Graph**. Extracts percentages, controlling paths, and parent-subsidiary relations. | Ultimate controller analysis |
-| **`ProceedsUsage`** | `AutoList` | **Fund Usage**. Details project names, allocated amounts, and estimated timelines for proceeds. | Post-IPO monitoring |
-| **`CompanyHistoryTimeline`** | `AutoTemporalGraph` | **Corporate Milestones**. Chronological extraction of founding, funding rounds, and major pivots. | Due diligence, history mapping |
+| **`ShareholderStructure`** | `AutoGraph` | Ownership percentages, controlling paths | Due diligence |
+| **`ProceedsUsage`** | `AutoList` | Project names, amounts, timelines | Post-IPO monitoring |
+| **`CompanyHistoryTimeline`** | `AutoTemporalGraph` | Founding, funding, pivots | History mapping |
-* **Earnings Call Transcripts**: Quarterly conference calls where management presents financial results and answers analyst questions, containing forward-looking guidance and sentiment signals.
+* **Earnings Call Transcripts**: Quarterly conference calls with financial results and guidance.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`EarningsCallSummary`** | `AutoModel` | **Call Overview**. Extracts reported metrics (Revenue, EPS), management guidance, and overall call tone (positive/cautious/negative). | Quarterly review dashboards, consensus tracking |
-| **`ManagementGuidanceList`** | `AutoList` | **Forward Guidance**. Extracts forward-looking statements: projected figures, strategic priorities, and qualitative outlook. | Guidance tracking, expectation management |
-| **`DiscussionGraph`** | `AutoGraph` | **Earnings Call Discussion Graph**. Extracts entities and their多元 relationships (Q&A, attention, business, financial) from earnings call transcripts. | Analyst focus analysis, Q&A tracking |
-| **`CallSentimentHypergraph`** | `AutoHypergraph` | **Topic-Sentiment Analysis**. Models multi-dimensional sentiment: `{Topic (Revenue/Margin/Guidance), Speaker, Sentiment, Driving Factor}` across the call. | Sentiment-driven trading signals, tone shift detection |
+| **`EarningsCallSummary`** | `AutoModel` | Metrics, guidance, call tone | Quarterly review |
+| **`ManagementGuidanceList`** | `AutoList` | Forward-looking statements | Guidance tracking |
+| **`DiscussionGraph`** | `AutoGraph` | Entity relationships in Q&A | Analyst focus analysis |
+| **`CallSentimentHypergraph`** | `AutoHypergraph` | Multi-dimensional sentiment analysis | Trading signals |
-* **Financial News & Market Commentary**: News articles, analyst commentaries, and social media posts conveying market sentiment, event impact, and forward-looking opinions about financial instruments or markets.
+* **Financial News & Market Commentary**: News articles and market commentary.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`MarketSentimentModel`** | `AutoModel` | **Sentiment Snapshot**. Extracts sentiment polarity (Bullish/Bearish/Neutral), mentioned entities (tickers, sectors), and expected price impact. | Real-time sentiment feeds, trading signal generation |
-| **`FinancialEventCausalGraph`** | `AutoGraph` | **Event Impact Graph**. Maps financial events to affected entities and downstream market reactions (e.g., "Fed rate hike -> Bank sector rally -> Bond yield rise"). | Event-driven strategy, macro impact analysis |
-| **`MultiSourceSentimentHypergraph`** | `AutoHypergraph` | **Cross-Source Sentiment Fusion**. Integrates sentiment signals from multiple sources: `{News Article, Social Media Post, Analyst Note} -> Aggregated Sentiment -> Affected Entity`. | Ensemble sentiment scoring, fake signal filtering |
-| **`MarketNarrativeTimeline`** | `AutoTemporalGraph` | **Narrative Evolution Timeline**. Tracks how market narratives and dominant themes evolve over time (e.g., shift from "inflation fear" to "soft landing hope"). | Thematic investing, regime detection |
+| **`MarketSentimentModel`** | `AutoModel` | Sentiment polarity, entities, price impact | Trading signals |
+| **`FinancialEventCausalGraph`** | `AutoGraph` | Event → Entity → Market reaction | Strategy analysis |
+| **`MultiSourceSentimentHypergraph`** | `AutoHypergraph` | Cross-source sentiment fusion | Ensemble scoring |
+| **`MarketNarrativeTimeline`** | `AutoTemporalGraph` | Narrative evolution over time | Thematic investing |
-### 3. `medicine` (Medicine)
-Focuses on causality, standardized terminology (UMLS mappings), and precise relationships.
+[↑ Back to Top](#table-of-contents)
-* **Medical Textbooks & Monographs**: Systematized knowledge of anatomy, pathology, and treatment protocols.
+---
+
+### 3. 🏥 `medicine` (Medicine)
+
+Focuses on causality, standardized terminology (UMLS), and precise relationships.
+
+* **Medical Textbooks**: Anatomy, pathology, treatment protocols.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`PathologyHypergraph`** | `AutoHypergraph` | **Pathology Mechanism**. Models complex "Gene + Env + Trigger -> Disease" logic. | Research, clinical knowledge base |
-| **`MedicalConceptNet`** | `AutoGraph` | **Medical Concept Net**. Extracts terminology and semantic relations (Is-A, Defined-As). | Taxonomy building, semantic search |
-| **`PharmacologyGraph`** | `AutoGraph` | **Pharmacology Action**. Maps interactions between drugs, receptors, and physiological responses. | Drug mechanism analysis |
-| **`AnatomyHierarchy`** | `AutoGraph` | **Anatomy Tree**. Builds hierarchical positions (Part-Of) and connectivity. | Anatomy atlases, surgical planning |
-| **`SymptomDifferential`** | `AutoSet` | **Differential Table**. Summarizes symptoms and their corresponding differentiator diseases. | Diagnostic support, education |
+| **`PathologyHypergraph`** | `AutoHypergraph` | Gene + Env + Trigger → Disease | Research KB |
+| **`MedicalConceptNet`** | `AutoGraph` | Medical terms and semantic relations | Taxonomy building |
+| **`PharmacologyGraph`** | `AutoGraph` | Drug-receptor-physiology interactions | Drug mechanism analysis |
+| **`AnatomyHierarchy`** | `AutoGraph` | Hierarchical anatomy positions | Surgical planning |
+| **`SymptomDifferential`** | `AutoSet` | Symptoms → Differential diseases | Diagnostic support |
-* **Clinical Practice Guidelines**: Standardized procedures for treating diseases, defining decision trees.
+* **Clinical Practice Guidelines**: Standardized treatment decision trees.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`TreatmentRegimenMap`** | `AutoHypergraph` | **Therapy Regimen**. Extracts multi-modal treatments comprising Drugs, Therapy, and Lifestyle. | Oncology protocols, chronic care |
-| **`ClinicalPathway`** | `AutoGraph` | **Decision Pathway**. Extracts "If-Then-Else" structures for clinical decision trees. | Pathway management, standardization |
-| **`LevelOfEvidence`** | `AutoList` | **Evidence Grading**. Extracts recommendations with associated Grade/Level of Evidence. | Clinical QA, research citations |
+| **`TreatmentRegimenMap`** | `AutoHypergraph` | Multi-modal treatments | Oncology protocols |
+| **`ClinicalPathway`** | `AutoGraph` | If-Then-Else clinical decisions | Pathway management |
+| **`LevelOfEvidence`** | `AutoList` | Recommendations with evidence grades | Clinical QA |
-* **Discharge Summaries**: Narrative records of a patient's hospital stay.
+* **Discharge Summaries**: Patient hospital stay narratives.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`SurgicalEventGraph`** | `AutoHypergraph` | **Surgical Event**. Models surgery as a complex event involving {Surgeon, Site, Procedure, Tools}. | Quality control, performance audit |
-| **`HospitalCourseTimeline`** | `AutoTemporalGraph` | **Hospital Timeline**. Chronologically extracts admission, tests, procedures, and outcomes. | Case review, dispute tracing |
-| **`DischargeInstruction`** | `AutoModel` | **Discharge Summary**. Extracts medications, follow-ups, and rehabilitation guidance. | Patient follow-up, management |
+| **`SurgicalEventGraph`** | `AutoHypergraph` | Surgery as {Surgeon, Site, Procedure, Tools} | Quality control |
+| **`HospitalCourseTimeline`** | `AutoTemporalGraph` | Admission → Tests → Procedures → Outcomes | Case review |
+| **`DischargeInstruction`** | `AutoModel` | Medications, follow-ups, rehabilitation | Patient management |
-* **Pathology Reports**: Microscopic descriptions of tissue samples.
+* **Pathology Reports**: Microscopic tissue descriptions.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`TumorStagingItem`** | `AutoModel` | **TNM Staging**. Extracts Tumor size (T), Node (N), Metastasis (M), and Stage. | Tumor registry, prognosis |
-| **`MicroscopicFeatureSet`** | `AutoSet` | **Biomarker Registry**. Extracts immunohistochemistry (IHC) results and mutations. | Targeted therapy, research screening |
+| **`TumorStagingItem`** | `AutoModel` | TNM staging (T, N, M, Stage) | Tumor registry |
+| **`MicroscopicFeatureSet`** | `AutoSet` | IHC results and mutations | Targeted therapy |
-* **Drug Package Inserts**: Legal documents listing indications, contraindications, and interactions.
+* **Drug Package Inserts**: Indications, contraindications, interactions.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`ComplexInteractionNet`** | `AutoHypergraph` | **Conditional Interaction**. Models high-order "Drug A + B + condition -> Reaction" logic. | CDSS, clinical safety |
-| **`ContraindicationList`** | `AutoList` | **Contraindications**. Explicitly lists absolute contraindications (Pregnancy, etc.). | Prescription blocking |
-| **`AdverseReactionStats`** | `AutoList` | **Adverse Reaction Stats**. Extracts reactions by system with frequency descriptions. | Pharmacovigilance |
+| **`ComplexInteractionNet`** | `AutoHypergraph` | Drug A + B + condition → Reaction | CDSS |
+| **`ContraindicationList`** | `AutoList` | Absolute contraindications | Prescription blocking |
+| **`AdverseReactionStats`** | `AutoList` | Reactions by system with frequency | Pharmacovigilance |
+
+[↑ Back to Top](#table-of-contents)
+
+---
-### 4. `tcm` (Traditional Chinese Medicine)
-Specialized for the unique logic of syndrome differentiation (`Bian Zheng`) and herbal compatibility.
+### 4. 🌿 `tcm` (Traditional Chinese Medicine)
-* **Medical Case Records (Yi An)**: Clinical records from famous practitioners detailing symptoms, pattern differentiation logic, and the reasoning behind prescribed formulas.
+Specialized for syndrome differentiation (`Bian Zheng`) and herbal compatibility.
-| Template | Primitive | Description | Typical Use Case |
+* **Medical Case Records (Yi An)**: Clinical records with symptoms, pattern differentiation, and formulas.
+
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`SyndromeReasoningGraph`** | `AutoHypergraph` | **Reasoning Logic Graph**. Models the chain of `{Symptoms} -> Syndrome -> Principle -> {Formula}`. | Mining clinical experience, inheritance of TCM experts |
-| **`PrescriptionModification`** | `AutoGraph` | **Formula Modification Logic**. Extracts additions/subtractions to a base formula based on specific symptoms. | Analysis of clinical medication rules |
-| **`PulseTongueRecord`** | `AutoList` | **Pulse & Tongue Features**. Structured extraction of tongue body/coating and pulse characteristics. | Objectification of TCM diagnosis |
+| **`SyndromeReasoningGraph`** | `AutoHypergraph` | Symptoms → Syndrome → Principle → Formula | Experience mining |
+| **`PrescriptionModification`** | `AutoGraph` | Base formula modifications by symptoms | Clinical rules analysis |
+| **`PulseTongueRecord`** | `AutoList` | Tongue and pulse characteristics | Diagnosis objectification |
-* **Herbal Compendiums (Ben Cao)**: Encyclopedic entries for single herbs describing their nature (Qi), flavor, meridian tropism, and functions.
+* **Herbal Compendiums (Ben Cao)**: Herb properties, flavors, meridian tropism.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`HerbPropertyModel`** | `AutoModel` | **Herb Properties**. Extracts the Four Natures, Five Flavors, Meridian Tropism, and Toxicity. | TCM Basic Database Construction |
-| **`CompatibilityNet`** | `AutoGraph` | **Compatibility Network**. Extracts "Seven Emotions" (Reinforcement, Counteraction, Incompatibility, etc.). | Contraindication warning, formula network analysis |
-| **`ProcessingMethod`** | `AutoList` | **Processing Methods (Pao Zhi)**. Lists different processing methods (e.g., Honey-fried) and their effects. | TCM processing standards |
+| **`HerbPropertyModel`** | `AutoModel` | Four Natures, Five Flavors, Toxicity | TCM database |
+| **`CompatibilityNet`** | `AutoGraph` | Seven Emotions relationships | Contraindication warning |
+| **`ProcessingMethod`** | `AutoList` | Processing methods and effects | Processing standards |
-* **Prescription Formularies (Fang Zhu)**: Documents defining herbal formulas, including the role of each ingredient (Monarch, Minister, Assistant, Envoy).
+* **Prescription Formularies (Fang Zhu)**: Formula composition with Monarch/Minister/Assistant/Envoy roles.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`FormulaComposition`** | `AutoHypergraph` | **Structural Composition**. Models the formula as a hierarchy of roles: `{Monarch, Minister, Assistant, Envoy}`. | Formula structure analysis |
-| **`FunctionIndicationMap`** | `AutoGraph` | **Function-Indication Map**. Links Formula -> Functions -> Indicated Syndromes/Symptoms. | Formula recommendation systems |
+| **`FormulaComposition`** | `AutoHypergraph` | Formula hierarchy (Monarch, Minister, Assistant, Envoy) | Structure analysis |
+| **`FunctionIndicationMap`** | `AutoGraph` | Formula → Functions → Indications | Recommendation systems |
-* **Meridian & Acupoint Treatises**: Texts defining the anatomical location of acupoints and their specific therapeutic effects.
+* **Meridian & Acupoint Treatises**: Acupoint locations and therapeutic effects.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`AcupointLocationMap`** | `AutoGraph` | **Acupoint Spatial Map**. Extracts relative locations based on anatomical landmarks (e.g., "2 cun lateral to navel"). | Acupuncture teaching, Acupoint Atlases |
-| **`MeridianFlowGraph`** | `AutoGraph` | **Meridian Flow Graph**. Extracts the pathway and flow sequence of the twelve meridians. | Meridian theory education |
+| **`AcupointLocationMap`** | `AutoGraph` | Acupoint spatial relationships | Acupuncture teaching |
+| **`MeridianFlowGraph`** | `AutoGraph` | Twelve meridian pathways | Meridian theory |
+
+[↑ Back to Top](#table-of-contents)
+
+---
-### 5. `industry` (Industry)
-Focuses on unstructured operational data in manufacturing, energy, and power sectors.
+### 5. ⚙️ `industry` (Industry)
-* **Management Specifications**: Safety procedures, emergency plans and other management documents.
+Focuses on operational data in manufacturing, energy, and power sectors.
-| Template | Primitive | Description | Typical Use Case |
+* **Management Specifications**: Safety procedures, emergency plans.
+
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`SafetyControlGraph`** | `AutoGraph` | **Safety Control Graph**. Extracts hazard sources, risk points, and control measures. | Safety procedures |
-| **`EmergencyResponseGraph`** | `AutoGraph` | **Emergency Response Graph**. Extracts incident scenarios, response actions, and departments. | Emergency plans |
-| **`IncidentCausalityMap`** | `AutoHypergraph` | **Incident Causality**. Models hazard, trigger, violation, consequence. | Risk prevention |
-| **`SafetyTimeline`** | `AutoTemporalGraph` | **Incident Timeline**. Reconstructs operations and response sequences. | Accident review |
+| **`SafetyControlGraph`** | `AutoGraph` | Hazard sources, risk points, controls | Safety procedures |
+| **`EmergencyResponseGraph`** | `AutoGraph` | Incident scenarios, response actions | Emergency plans |
+| **`IncidentCausalityMap`** | `AutoHypergraph` | Hazard → Trigger → Violation → Consequence | Risk prevention |
+| **`SafetyTimeline`** | `AutoTemporalGraph` | Operations and response sequences | Accident review |
-* **Technical Specifications / Datasheets**: Semi-structured text describing equipment parameters, design standards, and performance curves.
+* **Technical Specifications / Datasheets**: Equipment parameters, design standards.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`SystemTopologyGraph`** | `AutoGraph` | **System Topology Graph**. Extracts factory areas, systems, subsystems, equipment hierarchy. | System manuals |
-| **`EquipmentTopologyGraph`** | `AutoGraph` | **Equipment Topology Graph**. Extracts equipment entities and connections. | Equipment diagrams |
-| **`SpecParameterTable`** | `AutoModel` | **Key Specs Table**. Extracts rated power, materials, tolerances. | Equipment records |
-| **`SystemCompatibilityGraph`** | `AutoHypergraph` | **Compatibility Hypergraph**. Extracts device-environment relationships. | Selection assistance |
+| **`SystemTopologyGraph`** | `AutoGraph` | Factory areas, systems, equipment hierarchy | System manuals |
+| **`EquipmentTopologyGraph`** | `AutoGraph` | Equipment entities and connections | Equipment diagrams |
+| **`SpecParameterTable`** | `AutoModel` | Rated power, materials, tolerances | Equipment records |
+| **`SystemCompatibilityGraph`** | `AutoHypergraph` | Device-environment relationships | Selection assistance |
-* **Operations**: Equipment operating procedures, mode switching, etc.
+* **Operations**: Operating procedures, mode switching.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`OperationFlowGraph`** | `AutoGraph` | **Operation Flow Graph**. Extracts operation steps, states, and expected results. | Operating procedures |
-| **`OperatingModeGraph`** | `AutoGraph` | **Operating Mode Graph**. Extracts operating modes and switching conditions. | Mode switching docs |
-| **`MaintenaceOperationMap`** | `AutoHypergraph` | **Maintenance Operation Map**. Links operator, tool, object, duration. | SOP standardization |
+| **`OperationFlowGraph`** | `AutoGraph` | Operation steps, states, results | Operating procedures |
+| **`OperatingModeGraph`** | `AutoGraph` | Operating modes and switching conditions | Mode switching |
+| **`MaintenaceOperationMap`** | `AutoHypergraph` | Operator, tool, object, duration | SOP standardization |
-* **Maintenance**: Inspection records, failure cases, spare parts replacement.
+* **Maintenance**: Inspection records, failure cases, spare parts.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`InspectionRecordGraph`** | `AutoGraph` | **Inspection Record Graph**. Extracts equipment and inspection items. | Inspection logs |
-| **`FailureCaseGraph`** | `AutoGraph` | **Failure Case Graph**. Extracts phenomena, causes, measures, lessons. | Failure case libraries |
-| **`FailureKnowledgeHypergraph`** | `AutoHypergraph` | **Failure Hypergraph**. Models phenomena, causes, components, solutions. | Fault diagnosis |
-| **`PartReplacementList`** | `AutoList` | **Spare Parts List**. Extracts part numbers, quantities, reasons. | Spare parts management |
+| **`InspectionRecordGraph`** | `AutoGraph` | Equipment and inspection items | Inspection logs |
+| **`FailureCaseGraph`** | `AutoGraph` | Phenomena, causes, measures, lessons | Failure case libraries |
+| **`FailureKnowledgeHypergraph`** | `AutoHypergraph` | Phenomena, causes, components, solutions | Fault diagnosis |
+| **`PartReplacementList`** | `AutoList` | Part numbers, quantities, reasons | Spare parts management |
-* **HSE Incident Reports**: Investigations into safety incidents, detailing the sequence of events, root causes, and corrective actions.
+* **HSE Incident Reports**: Safety incident investigations.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`IncidentCausalityMap`** | `AutoHypergraph` | **Incident Causality**. Models hazard, trigger, violation, consequence. | Accident simulation |
-| **`SafetyTimeline`** | `AutoTemporalGraph` | **Incident Timeline**. Reconstructs operations and response sequences. | Accident review |
+| **`IncidentCausalityMap`** | `AutoHypergraph` | Hazard, trigger, violation, consequence | Accident simulation |
+| **`SafetyTimeline`** | `AutoTemporalGraph` | Operations and response sequences | Accident review |
+
+[↑ Back to Top](#table-of-contents)
+
+---
+
+### 6. 📜 `history` (History)
-### 6. `history` (History)
Focuses on long-span timelines and social network reconstruction.
-* **Historical Monographs**: Academic books analyzing specific periods, events, or figures with causal depth.
+* **Historical Monographs**: Academic analysis of periods, events, figures.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`HistoricalKnowledgeGraph`** | `AutoGraph` | **General History Graph**. Extracts basic relationships (Kinship, Minister-Ruler) and causality. | Historical Social Network Analysis |
-| **`MultiParticipantEventMap`** | `AutoHypergraph` | **Multi-Participant Event Map**. Models events as hyperedges connecting all participants (e.g., "Feast at Hong Gate"). | Complex event reconstruction |
+| **`HistoricalKnowledgeGraph`** | `AutoGraph` | Kinship, Minister-Ruler, causality | Social network analysis |
+| **`MultiParticipantEventMap`** | `AutoHypergraph` | Events as hyperedges connecting participants | Event reconstruction |
-* **Chronicles**: Strictly chronological records focusing on temporal evolution.
+* **Chronicles**: Strictly chronological records.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`ChronologicalEventChain`** | `AutoTemporalGraph` | **Event Chain**. Extracts atomic events with precise timestamps. | Timeline generation |
-| **`HistoricalContextGraph`** | `AutoGraph` | **Historical Context Graph**. Extracts static relationships (kinship, alliances) underlying the events. | Background mining |
-| **`PoliticalStruggleHypergraph`** | `AutoHypergraph` | **Political Struggle Hypergraph**. Models `{Attacker, Defender, Planner, Traitor}` in battles or coups. | Faction analysis, Battle review |
+| **`ChronologicalEventChain`** | `AutoTemporalGraph` | Atomic events with timestamps | Timeline generation |
+| **`HistoricalContextGraph`** | `AutoGraph` | Static relationships (kinship, alliances) | Background mining |
+| **`PoliticalStruggleHypergraph`** | `AutoHypergraph` | {Attacker, Defender, Planner, Traitor} in battles | Faction analysis |
-* **Oral History**: First-person memoirs containing non-linear narratives and personal details.
+* **Oral History**: First-person memoirs with non-linear narratives.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`PersonalTrajectoryHypergraph`** | `AutoHypergraph` | **Personal Trajectory Hypergraph**. Models life stages as hyperedges: `{Period, Location, Peers, Experience}`. | Biography writing, Life course research |
-| **`NarrativeRelationGraph`** | `AutoGraph` | **Narrative Relation Graph**. Extracts interpersonal interactions and evaluations from the narrator's perspective. | Oral history social network analysis |
-| **`MemoryFlashbackList`** | `AutoList` | **Memory Flashbacks**. Extracts specific anecdotes, feelings, or side descriptions of historical moments. | Historical detail supplementation |
+| **`PersonalTrajectoryHypergraph`** | `AutoHypergraph` | Life stages as {Period, Location, Peers, Experience} | Biography writing |
+| **`NarrativeRelationGraph`** | `AutoGraph` | Interpersonal interactions from narrator's view | Social network analysis |
+| **`MemoryFlashbackList`** | `AutoList` | Specific anecdotes, feelings, side descriptions | Historical detail |
-* **Archival Correspondence**: Letters between historical figures revealing hidden social networks.
+* **Archival Correspondence**: Letters revealing hidden social networks.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`EpistolaryKnowledgeGraph`** | `AutoGraph` | **Epistolary Content Graph**. Extracts entities and relations mentioned *within* the letter text, rather than just sender/receiver metadata. | Historical material mining |
+| **`EpistolaryKnowledgeGraph`** | `AutoGraph` | Entities and relations within letter content | Historical material mining |
+
+[↑ Back to Top](#table-of-contents)
+
+---
+
+### 7. 🧬 `biology` (Biology)
-### 7. `biology` (Biology)
-Goes beyond genomics to include proteomics, metabolism, and ecology.
+Beyond genomics: proteomics, metabolism, and ecology.
-* **Biological Monographs**: Specialized books detailing species taxonomy, evolutionary history, or complex biological systems.
+* **Biological Monographs**: Species taxonomy, evolutionary history.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`SpeciesInteractionWeb`** | `AutoGraph` | **Species Interaction Network**. Extracts predation, parasitism, competition, and symbiosis relations. | Food web analysis, Ecosystem modeling |
-| **`TaxonomicTree`** | `AutoGraph` | **Taxonomic Tree**. Builds hierarchical relationships (Kingdom -> Phylum -> ... -> Species). | Biological taxonomy database |
+| **`SpeciesInteractionWeb`** | `AutoGraph` | Predation, parasitism, competition, symbiosis | Food web analysis |
+| **`TaxonomicTree`** | `AutoGraph` | Kingdom → Phylum → ... → Species hierarchy | Taxonomy database |
-* **Protein Structure Summaries**: Descriptions of protein crystal structures, ligand binding sites, and post-translational modifications.
+* **Protein Structure Summaries**: Crystal structures, binding sites.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`ProteinComplexMap`** | `AutoHypergraph` | **Protein Complex Hypergraph**. Models multi-subunit assemblies: `{SubunitA, SubunitB, Cofactor}` forming one functional complex. | Complex databases, Structural research |
-| **`BindingSiteModel`** | `AutoModel` | **Binding Site Profile**. Extracts active site residues, binding pocket chemistry, and functional annotations. | Drug design, Mutation analysis |
+| **`ProteinComplexMap`** | `AutoHypergraph` | Multi-subunit assemblies | Complex databases |
+| **`BindingSiteModel`** | `AutoModel` | Active site residues, binding pocket chemistry | Drug design |
-* **Metabolic Pathway Descriptions**: Texts explaining biochemical cascades, detailing enzymes, substrates, products, and regulation mechanisms.
+* **Metabolic Pathway Descriptions**: Biochemical cascades.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`BiochemicalReactionHypergraph`** | `AutoHypergraph` | **Reaction Hypergraph**. Precisely models multi-input/output reactions: `{Enzyme + SubstrateA + SubstrateB -> ProductC + ProductD}`. | Pathway mapping, Metabolic engineering |
-| **`RegulatoryNetwork`** | `AutoGraph` | **Gene Regulatory Network**. Extracts transcription factor -> promoter -> gene expression relationships (activation, inhibition, cooperation). | Gene regulation analysis, Systems biology |
+| **`BiochemicalReactionHypergraph`** | `AutoHypergraph` | Enzyme + Substrate → Product reactions | Pathway mapping |
+| **`RegulatoryNetwork`** | `AutoGraph` | TF → Promoter → Gene expression | Gene regulation analysis |
-* **Ecological Surveys**: Detailed physical characterizations and systematic relationships of organisms, as well as species distribution and habitat characteristics from field surveys.
+* **Ecological Surveys**: Species distribution, habitat characteristics.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`PhylogeneticRelationGraph`** | `AutoGraph` | **Phylogenetic Relations**. Extracts evolutionary relationships, divergence distances, and branching patterns. | Molecular systematics, Evolutionary tree building |
-| **`BiodiversityRegistry`** | `AutoSet` | **Species Registry**. Deduplicates and consolidates observed species and population information from survey reports. | Biodiversity assessment, Conservation prioritization |
+| **`PhylogeneticRelationGraph`** | `AutoGraph` | Evolutionary relationships, branching patterns | Phylogenetic trees |
+| **`BiodiversityRegistry`** | `AutoSet` | Observed species and populations | Biodiversity assessment |
-### 8. `legal` (Legal)
-Handles precise logical conditions, obligations, and citations.
+[↑ Back to Top](#table-of-contents)
+
+---
-* **Legal Treatises / Commentaries**: Scholarly books analyzing legal principles, statutes, and case law logic.
+### 8. ⚖️ `legal` (Legal)
-| Template | Primitive | Description | Typical Use Case |
+Precise logical conditions, obligations, and citations.
+
+* **Legal Treatises**: Analysis of legal principles and case law.
+
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`LegalConceptOntology`** | `AutoGraph` | **Legal Concept Ontology**. Extracts definitions, hierarchical relationships (Is-A), and statutory interpretations from academic texts. | Legal research, Educational systems |
-| **`CaseLawCitationNet`** | `AutoGraph` | **Citation Network**. Maps how cases cite, distinguish, or overrule previous precedents. | Precedent analysis, Legal history map |
+| **`LegalConceptOntology`** | `AutoGraph` | Definitions, Is-A relations, interpretations | Legal research |
+| **`CaseLawCitationNet`** | `AutoGraph` | Case citations, distinguish, overrule | Precedent analysis |
-* **Master Service Agreements (MSA)**: Contracts defining long-term business relationships, liability limits, and intellectual property rights.
+* **Master Service Agreements (MSA)**: Long-term contracts, liability, IP rights.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`ContractObligationHypergraph`** | `AutoHypergraph` | **Obligation Hypergraph**. Models complex conditional obligations: `{Party, Duty, Trigger Condition, Exception, Penalty}`. | Contract review, Compliance automation |
-| **`DefinedTermRegistry`** | `AutoSet` | **Defined Terms Registry**. Deduplicates definitions of capitalized terms (e.g., "Confidential Information") across the document. | Contract consistency check |
-| **`LiabilityClauseList`** | `AutoList` | **Liability Clauses**. Extracts specific clauses regarding indemnification, limitations of liability, and warranties. | Risk assessment, Deal comparison |
+| **`ContractObligationHypergraph`** | `AutoHypergraph` | {Party, Duty, Trigger, Exception, Penalty} | Contract review |
+| **`DefinedTermRegistry`** | `AutoSet` | Defined capitalized terms | Consistency check |
+| **`LiabilityClauseList`** | `AutoList` | Indemnification, limitations, warranties | Risk assessment |
-* **Court Judgments**: Final rulings by judges, containing fact-finding sections, legal reasoning, and citations of precedents.
+* **Court Judgments**: Rulings with fact-finding and reasoning.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`CaseFactTimeline`** | `AutoTemporalGraph` | **Fact Timeline**. Reconstructs the chronological sequence of events leading to the dispute from the "Findings of Fact" section. | Case analysis, Evidence marshalling |
-| **`AdjudicationLogic`** | `AutoHypergraph` | **Reasoning Hypergraph**. Models the judicial logic: `{Proven Fact + Applicable Law -> Legal Conclusion}`. | Judgment prediction, Legal reasoning Support |
-| **`LitigationParticipantMap`** | `AutoGraph` | **Participant Map**. Maps relationships between plaintiffs, defendants, counsel, and witnesses. | Conflict of interest check |
+| **`CaseFactTimeline`** | `AutoTemporalGraph` | Chronological sequence of events | Case analysis |
+| **`AdjudicationLogic`** | `AutoHypergraph` | {Proven Fact + Law → Conclusion} | Judgment prediction |
+| **`LitigationParticipantMap`** | `AutoGraph` | Plaintiff, defendant, counsel, witness relations | Conflict check |
-* **Regulatory Compliance Filings**: Detailed reports submitted to government bodies regarding data privacy, anti-money laundering, or environmental impact.
+* **Regulatory Compliance Filings**: Data privacy, AML, environmental reports.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`ComplianceRequirementList`** | `AutoList` | **Requirement Checklist**. Extracts specific affirmative duties or negative covenants mandated by the filing. | Regulatory gap analysis |
-| **`BeneficialOwnershipGraph`** | `AutoGraph` | **Ownership Structure**. Traces complex corporate ownership layers to identify Ultimate Beneficial Owners (UBO). | AML/KYC screening, Sanctions check |
+| **`ComplianceRequirementList`** | `AutoList` | Specific affirmative/negative duties | Gap analysis |
+| **`BeneficialOwnershipGraph`** | `AutoGraph` | Corporate ownership layers to UBO | AML/KYC screening |
-### 9. `literature` (Literature & Fiction)
-Focuses on narrative structure, character interactions, and world-building.
+[↑ Back to Top](#table-of-contents)
+
+---
-* **Screenplays / Scripts**: Highly structured texts (Scene Heading, Action, Dialogue) ideal for extracting character interaction graphs.
+### 9. 🎭 `literature` (Literature & Fiction)
-| Template | Primitive | Description | Typical Use Case |
+Narrative structure, character interactions, world-building.
+
+* **Screenplays / Scripts**: Highly structured (Scene, Action, Dialogue).
+
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`SceneEventHypergraph`** | `AutoHypergraph` | **Scene Event Hypergraph**. Models a scene as a hyperedge connecting `{Characters, Location, Props, Key Actions}`. | Scene complexity analysis, Shooting schedule planning |
-| **`CharacterArcTimeline`** | `AutoTemporalGraph` | **Character Arc Timeline**. Tracks a character's location, emotional state, or key actions chronologically through the script. | Character development analysis, Continuity check |
+| **`SceneEventHypergraph`** | `AutoHypergraph` | Scene as {Characters, Location, Props, Actions} | Scene analysis |
+| **`CharacterArcTimeline`** | `AutoTemporalGraph` | Character location, emotion, actions over time | Development analysis |
-* **Novels**: Texts with complex plots, numerous characters, and interwoven relationships.
+* **Novels**: Complex plots, numerous characters.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`ComplexCharacterRelation`** | `AutoHypergraph` | **Complex Character Relation**. Models multi-party social structures (e.g., Love Triangles, Alliances, Factions) beyond simple pairwise links. | Ensemble analysis, Fan wiki consistency |
-| **`StoryEntityGraph`** | `AutoGraph` | **Story Entity Graph**. Focuses on key items, locations, and their ownership/location, distinct from character relations. | World-building database, Licensed game adaptation |
-| **`NarrativeEventChain`** | `AutoTemporalGraph` | **Narrative Event Chain**. Extracts key plot points strictly following the story's internal timeline. | Synopsis generation, Timeline reconstruction |
+| **`ComplexCharacterRelation`** | `AutoHypergraph` | Multi-party structures (triangles, alliances) | Ensemble analysis |
+| **`StoryEntityGraph`** | `AutoGraph` | Items, locations, ownership | World-building DB |
+| **`NarrativeEventChain`** | `AutoTemporalGraph` | Key plot points by internal timeline | Synopsis generation |
-* **Literary Criticism**: Analytical texts exploring themes, motifs, and intertextuality.
+* **Literary Criticism**: Themes, motifs, intertextuality.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`MotifAssociationNet`** | `AutoGraph` | **Motif Association Net**. Links recurring symbols and motifs (nodes are all "Motifs") based on co-occurrence. | Systematic text analysis, Semiotics |
-| **`CritiqueArgumentHypergraph`** | `AutoHypergraph` | **Argument Hypergraph**. Models complex argumentation: `{Evidence1, Evidence2, Quoted Text} -> Core Thesis`. | Academic paper analysis, Thesis extraction |
-| **`NarrativeStructureTree`** | `AutoGraph` | **Narrative Structure Tree**. Maps the hierarchical structure of the narrative (e.g., Frame Story -> Main Plot -> Subplot). | Narratology, Structure analysis |
+| **`MotifAssociationNet`** | `AutoGraph` | Recurring symbols and motifs | Semiotics |
+| **`CritiqueArgumentHypergraph`** | `AutoHypergraph` | {Evidence1, Evidence2, Quote} → Thesis | Paper analysis |
+| **`NarrativeStructureTree`** | `AutoGraph` | Hierarchical narrative structure | Narratology |
-### 10. `news` (News & Journalism)
-Focuses on the "5Ws" (Who, What, Where, When, Why), event causality, and viewpoint analysis.
+[↑ Back to Top](#table-of-contents)
-* **Investigative Journalism**: Long-form reporting revealing complex societal relationships or hidden truths.
+---
-| Template | Primitive | Description | Typical Use Case |
+### 10. 📰 `news` (News & Journalism)
+
+Focuses on 5Ws (Who, What, Where, When, Why), event causality, viewpoint analysis.
+
+* **Investigative Journalism**: Long-form reporting revealing complex truths.
+
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`InvestigativeContextGraph`** | `AutoGraph` | **Investigation Context Graph**. Extracts baseline static relationships (employment, kinship, location) between all entities mentioned in the report. | Entity mapping, Stakeholder identification |
-| **`ComplexRelationNet`** | `AutoHypergraph` | **Complex Relationship Network**. Models multi-party social connections (e.g., family ties, political alliances, business partnerships) involving three or more entities. | Political analysis, feature stories |
-| **`KeyEventSequence`** | `AutoGraph` | **Investigative Timeline**. Traces the chronological sequence of critical events discovered during an investigation. | Retrospective reports, backgrounders |
+| **`InvestigativeContextGraph`** | `AutoGraph` | Baseline relationships (employment, kinship) | Entity mapping |
+| **`ComplexRelationNet`** | `AutoHypergraph` | Multi-party connections (family, political, business) | Political analysis |
+| **`KeyEventSequence`** | `AutoGraph` | Chronological sequence of critical events | Backgrounders |
-* **Breaking News Wires**: Short, factual updates focusing on immediate events and entities.
+* **Breaking News Wires**: Short, factual updates.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`NewsEntityGraph`** | `AutoGraph` | **Core Entity Graph**. Extracts key entities (people, organizations, locations, products, events, states, etc.) and their actions or relations from news text. | News feeds, entity linking |
-| **`NewsSummaryModel`** | `AutoModel` | **Structured Summary**. Standardized extraction of 5W1H elements (Who, What, When, Where, Why, How). | News aggregation, Ticker generation |
-| **`LiveUpdateTimeline`** | `AutoGraph` | **Live Event Timeline**. Extracts minute-by-minute updates of an unfolding situation (e.g., press conferences, emergencies). | Live blog summary, Crisis monitoring |
+| **`NewsEntityGraph`** | `AutoGraph` | Key entities (people, orgs, locations, events) | News feeds |
+| **`NewsSummaryModel`** | `AutoModel` | 5W1H extraction | News aggregation |
+| **`LiveUpdateTimeline`** | `AutoGraph` | Minute-by-minute updates | Live blog summary |
-* **Policy Analysis & Editorials**: Analytical pieces focusing on opinions, arguments, and future impacts.
+* **Policy Analysis & Editorials**: Opinions, arguments, future impacts.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`ViewpointStructure`** | `AutoHypergraph` | **Argument Structure**. Models the logical structure of an editorial: `{Claim, Premises/Evidence, Conclusion}`. | Opinion mining, editorial analysis |
-| **`ImpactChain`** | `AutoGraph` | **Policy Impact Chain**. Extracts causal chains predicting how a policy or event affects specific groups or sectors. | Policy reviews, trend analysis |
+| **`ViewpointStructure`** | `AutoHypergraph` | {Claim, Premises, Conclusion} | Opinion mining |
+| **`ImpactChain`** | `AutoGraph` | Policy → Affected Groups → Consequences | Policy reviews |
+
+[↑ Back to Top](#table-of-contents)
+
+---
+
+### 11. 🌾 `agriculture` (Agriculture)
-### 11. `agriculture` (Agriculture)
-Focuses on crop lifecycle management, field monitoring, and soil health data.
+Crop lifecycle, field monitoring, soil health.
-* **Agricultural Manuals**: Technical guides on crop planting standards, field management practices, and pest/disease control techniques.
+* **Agricultural Manuals**: Planting standards, pest control.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`CropGrowthCycle`** | `AutoTemporalGraph` | **Crop Growth Cycle Timeline**. Extracts key farming operations and environmental conditions required at each growth stage (seeding, tillering, maturation, etc.). | Planting calendar generation, Task scheduling |
-| **`PestControlHypergraph`** | `AutoHypergraph` | **Pest Control Logic**. Models complex intervention rules: `{Crop, Growth Stage, Adverse Factor} -> {Target Disease/Pest, Recommended Agent, Dosage, Safe Interval}`. | Smart crop protection systems, Pesticide recommendation |
+| **`CropGrowthCycle`** | `AutoTemporalGraph` | Farming operations per growth stage | Planting calendar |
+| **`PestControlHypergraph`** | `AutoHypergraph` | {Crop, Stage, Factor} → {Target, Agent, Dosage} | Smart crop protection |
-* **Crop Scouting Reports**: Field observation records of crop growth stages and pest/disease conditions.
+* **Crop Scouting Reports**: Field observations.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`FieldObservationList`** | `AutoList` | **Field Observation Log**. Structured extraction of scouting records: `{Field ID, Crop, Growth Stage, Observed Issue (Weed/Pest), Severity, Recommendation}`. | Scouting digitization, Pest/disease early warning |
+| **`FieldObservationList`** | `AutoList` | {Field ID, Crop, Stage, Issue, Severity, Recommendation} | Pest early warning |
-* **Soil Analysis Reports**: Reports describing soil chemical composition and corresponding fertilization recommendations.
+* **Soil Analysis Reports**: Soil chemistry and fertilization recommendations.
-| Template | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`SoilNutrientModel`** | `AutoModel` | **Soil Nutrient Profile**. Extracts core physicochemical indicators (pH, Organic Matter, N-P-K, micronutrients). | Soil-testing-based fertilizer prescription, Soil fertility grading |
-| **`AmendmentPlan`** | `AutoGraph` | **Soil Amendment Plan**. Maps the logic: `{Test Result -> Limiting Factor -> Amendment Method -> Target Outcome}`. | Precision agriculture prescription generation |
+| **`SoilNutrientModel`** | `AutoModel` | pH, Organic Matter, N-P-K, micronutrients | Fertilizer prescription |
+| **`AmendmentPlan`** | `AutoGraph` | Test Result → Limiting Factor → Method → Outcome | Precision agriculture |
-### 12. `food` (Food)
-Focuses on recipe standardization, ingredient pairing logic, and food review data.
+[↑ Back to Top](#table-of-contents)
-* **Standardized Recipes**: Structured texts containing ingredient lists, cooking steps, and critical control points.
+---
+
+### 12. 🍜 `food` (Food)
+
+Recipe standardization, ingredient pairing, food reviews.
+
+* **Standardized Recipes**: Ingredient lists, cooking steps.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`RecipeCollection`** | `AutoSet` | **Recipe Catalog**. Deduplicates and extracts all unique dish entities and basic classifications from text. | Menu digitization, dish index construction |
-| **`StandardRecipeCard`** | `AutoModel` | **Standard Recipe Card**. Extracts complete ingredient list, step-by-step instructions, and key TIPS for a single dish. | Kitchen SOP cards, cooking instruction |
-| **`IngredientCompositionHypergraph`** | `AutoHypergraph` | **Ingredient Pairing Hypergraph**. Models the complex combination of `{Dish, Main Ingredient, Accessory, Seasoning}`. | Cost calculation, allergen management, R&D |
+| **`RecipeCollection`** | `AutoSet` | Unique dish entities and classifications | Menu digitization |
+| **`StandardRecipeCard`** | `AutoModel` | Complete ingredients, steps, tips | Kitchen SOP cards |
+| **`IngredientCompositionHypergraph`** | `AutoHypergraph` | {Dish, Main, Accessory, Seasoning} relationships | Cost, allergen management |
-* **Food Reviews**: Detailed evaluation records by professional food critics or R&D teams.
+* **Food Reviews**: Professional evaluations.
-| Template Name | Primitive | Description | Typical Use Case |
+| Template | Primitive | Description | Use Case |
| :--- | :--- | :--- | :--- |
-| **`DishReviewSummary`** | `AutoList` | **Dish Review Summary**. Extracts core review points, recommendation level, and price perception by dish. | Structured exploration notes, must-try lists |
-| **`SensoryEvaluationGraph`** | `AutoGraph` | **Sensory Evaluation Graph**. Extracts `{Dish} -[has feature]-> {Taste/Texture} -[attributed to]-> {Ingredient/Technique}` evaluation logic. | Flavor attribution analysis, R&D feedback |
+| **`DishReviewSummary`** | `AutoList` | Core points, recommendation level, price | Must-try lists |
+| **`SensoryEvaluationGraph`** | `AutoGraph` | Dish → Taste/Texture → Ingredient/Technique | Flavor analysis |
+
+[↑ Back to Top](#table-of-contents)
+
+---
diff --git a/hyperextract/templates/README_ZH.md b/hyperextract/templates/README_ZH.md
index 9b8da95..a673630 100644
--- a/hyperextract/templates/README_ZH.md
+++ b/hyperextract/templates/README_ZH.md
@@ -2,7 +2,41 @@
**Hyper-Extract 领域模板库** 旨在为不同垂直行业提供专业的非结构化文本抽取能力。
-本库按 **领域 (Domain)** 组织,每个领域针对其特定的文档类型、行业术语和业务逻辑进行了优化。以下是各领域及其典型处理文档的介绍。
+本库按 **领域 (Domain)** 组织,每个领域针对其特定的文档类型、行业术语和业务逻辑进行了优化。
+
+> 切换至 [English Version](./README.md)
+
+---
+
+## 📋 目录
+
+- [📚 通用](#1-general-通用general-purpose)
+- [💰 金融](#2-finance-金融)
+- [🏥 医疗](#3-medicine-医学)
+- [🌿 中医](#4-tcm-中医中药)
+- [⚙️ 工业](#5-industry-工业)
+- [📜 历史](#6-history-历史)
+- [🧬 生物](#7-biology-生物科学)
+- [⚖️ 法律](#8-legal-法律)
+- [🎭 文学](#9-literature-文学与影视)
+- [📰 新闻](#10-news-新闻传媒)
+- [🌾 农业](#11-agriculture-农业)
+- [🍜 美食](#12-food-美食餐饮)
+
+---
+
+## 底层原语说明
+
+| 原语 | 说明 |
+| :--- | :--- |
+| **`AutoGraph`** | 知识图谱 - 提取实体及成对关系 |
+| **`AutoSet`** | 实体集合 - 去重并汇总唯一实体 |
+| **`AutoList`** | 列表 - 提取数值数组(关键词、条目等)|
+| **`AutoModel`** | 数据模型 - 提取结构化字段(如信息框)|
+| **`AutoTemporalGraph`** | 时序图谱 - 构建时间有序的事件序列 |
+| **`AutoHypergraph`** | 超图 - 建模复杂的多实体关系 |
+
+---
## 领域索引
@@ -23,406 +57,465 @@
---
-## 领域详情与典型文档
+## 领域详情
+
+### 1. 📚 `general` (通用)
-### 1. `general` (General Purpose)
适用于无法归类或多领域交叉的文本,通过提取基础实体和SPO关系构建通用图谱。
-* **任意文本 (通用提取)**:适用于任何类型的文本(如网页内容、日常笔记、博客文章),直接提取其中的实体及关系。
+* **任意文本 (通用提取)**:适用于任何类型的文本,直接提取其中的实体及关系。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`KnowledgeGraph`** | `AutoGraph` | **通用知识图谱**。使用通用的 Schema 提取实体与关系。 | 任意文本、网页抓取内容 |
-| **`EntityRegistry`** | `AutoSet` | **实体注册表**。去重并汇总文本中出现的所有唯一实体(如人名、机构)。 | 实体发现、命名实体识别 |
-| **`KeywordList`** | `AutoList` | **关键词列表**。提取文本的核心概念、重要主题或标签。 | 内容打标、索引生成 |
+| **`KnowledgeGraph`** | `AutoGraph` | 通用知识图谱提取 | 任意文本、网页内容 |
+| **`EntityRegistry`** | `AutoSet` | 去重唯一实体(人名、机构) | 实体发现、NER任务 |
+| **`KeywordList`** | `AutoList` | 核心概念、主题或标签 | 内容打标、索引生成 |
-* **维基百科/百度百科条目**:对实体(人物、组织、地点)的综合性描述,包含结构化的属性信息。
+* **百科条目**:对实体的综合性描述,包含结构化属性信息。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`EncyclopediaItem`** | `AutoModel` | **百科条目**。针对单一主体提取结构化的属性信息(类似信息框 Infobox)。 | 维基百科、专业词典词条 |
-| **`ConceptHierarchy`** | `AutoGraph` | **概念层级图**。构建上下位关系(Subclass-Of)或组成关系(Part-Of)。 | 科学学科、教材知识点 |
-| **`CrossReferenceNet`** | `AutoGraph` | **交叉引用网络**。映射概念之间的超链接或相互引用关系。 | 百科内链、跨词条关联图 |
+| **`EncyclopediaItem`** | `AutoModel` | 结构化属性信息(信息框风格)| 百科词典词条 |
+| **`ConceptHierarchy`** | `AutoGraph` | 上下位/组成关系 | 科学教材知识点 |
+| **`CrossReferenceNet`** | `AutoGraph` | 超链接与相互引用 | 跨词条关联 |
-* **人物传记与回忆录**:记录个人生平事迹、主要成就及社会关系的叙事性文本。
+* **人物传记与回忆录**:记录个人生平事迹、主要成就及社会关系。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`LifeEventTimeline`** | `AutoTemporalGraph` | **生平时序图**。提取带时间戳的事件,并按时间顺序排列。 | 人物传记、年表、回忆录 |
-| **`SocialNetwork`** | `AutoGraph` | **社交网络图**。专注于提取人际关系、互动与组织隶属。 | 传记分析、人物设定研究 |
-| **`PersonalProfile`** | `AutoModel` | **个人档案**。聚合人物的静态属性(生卒年、学历、核心身份)。 | 简历、人物简介、讣告摘要 |
+| **`LifeEventTimeline`** | `AutoTemporalGraph` | 带时间戳的生平事件 | 传记、年表 |
+| **`SocialNetwork`** | `AutoGraph` | 人际关系与互动 | 人物分析 |
+| **`PersonalProfile`** | `AutoModel` | 静态属性(生卒年、学历)| 简历、简介 |
-* **规章制度与合规文档**:公司内部管理制度、行政法规、操作手册、合规指南。
+* **规章制度与合规文档**:公司制度、操作手册、合规指南。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`RegulationProfile`** | `AutoModel` | **规章元数据快照**。提取制度的名称、版本、适用范围、生效日期及核心宗旨。 | 制度概览、版本管理 |
-| **`ComplianceLogic`** | `AutoHypergraph` | **合规行为超图**。建模“在何种条件下,何种主体,必须/禁止执行何种操作”的复杂逻辑。 | 合规审计、风险识别 |
-| **`PenaltyRegistry`** | `AutoSet` | **违规处罚对照表**。去重汇总特定的违规行为及其对应的后果,形成清晰的处罚台账。 | 内部风控、合规检查 |
-| **`OperationalProcedure`** | `AutoGraph` | **执行程序流程图**。提取规章中规定的申报、审批或操作的具体先后步骤。 | 操作导引、SOP 流程可视化 |
-| **`PenaltyMapping`** | `AutoGraph` | **违规处罚因果链**。描述从“违规行为”到“处理程序”再到“最终结果”的演变路径。 | 风险溯源、处罚逻辑分析 |
-| **`ClauseList`** | `AutoList` | **规章条文清单**。将规章制度拆解为逐条的原子化条文,方便快速索引。 | 条文检索、全文比对 |
+| **`RegulationProfile`** | `AutoModel` | 制度名称、版本、生效日期 | 制度概览 |
+| **`ComplianceLogic`** | `AutoHypergraph` | 条件性行为逻辑 | 合规审计 |
+| **`PenaltyRegistry`** | `AutoSet` | 违规行为与后果 | 风险管控 |
+| **`OperationalProcedure`** | `AutoGraph` | 申报审批具体步骤 | SOP流程 |
+| **`PenaltyMapping`** | `AutoGraph` | 违规到结果的演变路径 | 风险溯源 |
+| **`ClauseList`** | `AutoList` | 原子化条文 | 条文检索 |
+
+[↑ 返回目录](#目录)
+
+---
+
+### 2. 💰 `finance` (金融)
-### 2. `finance` (金融)
专注于提取复杂的交易关系、市场观点及时间敏感事件。
-* **SEC财报 (10-K / 10-Q / 8-K)**:提交给监管机构的标准化财务申报文件,涵盖财务报表、管理层讨论与分析 (MD&A)、风险因素及重大事件披露,具有复杂的文档结构(表格、叙述文本、附件)。
+* **SEC财报 (10-K / 10-Q / 8-K)**:标准化财务申报文件,涵盖财务报表、MD&A、风险因素。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`FilingFinancialSnapshot`** | `AutoModel` | **财务数据快照**。从申报文件中嵌入的利润表、资产负债表及现金流量表中提取关键财务数据。 | 基本面筛选、财务数据库构建 |
-| **`MDANarrativeGraph`** | `AutoGraph` | **MD&A 因果图谱**。从管理层讨论与分析部分提取因果关系(如"供应链中断 -> 营收下降 -> 利润率压缩")。 | 叙事分析、业绩驱动因素归因 |
-| **`FilingRiskFactorSet`** | `AutoSet` | **风险因素登记册**。去重汇总 Item 1A 中披露的所有风险因素,跟踪各报告期的新增与删除变化。 | 风险演变监控、跨公司风险对标 |
-| **`MaterialEventTimeline`** | `AutoTemporalGraph` | **重大事件时间轴**。按时间顺序提取 8-K 当期报告中的重大事件(高管变动、并购公告、财务重述等)。 | 事件驱动分析、合规监控 |
-| **`SegmentPerformanceList`** | `AutoList` | **分部业绩明细**。按业务分部或地理区域提取营收、经营利润等关键指标。 | 分部估值、区域风险敞口分析 |
-| **`FinancialDataTemporalGraph`** | `AutoTemporalGraph` | **财务数据时序图谱**。构建跨报告期的财务指标时序图谱,追踪营收、利润率、分部贡献及关键比率随时间的演变。 | 多期趋势分析、跨期对比、财务数据溯源 |
-| **`RiskAssessmentGraph`** | `AutoGraph` | **风险评估图谱**。系统性提取风险因素到财务影响的传导路径,包含可能性、严重性及缓解措施。 | 风险监控、多报告期对比分析 |
-| **`SupplyChainGraph`** | `AutoGraph` | **供应链图谱**。提取供应链主体、交易关系及风险评估,识别关键供应商和地缘政治风险。 | 供应链韧性分析、ESG 报告分析 |
+| **`FilingFinancialSnapshot`** | `AutoModel` | 关键财务数据 | 基本面筛选 |
+| **`MDANarrativeGraph`** | `AutoGraph` | MD&A因果关系 | 叙事分析 |
+| **`FilingRiskFactorSet`** | `AutoSet` | 风险因素登记 | 风险监控 |
+| **`MaterialEventTimeline`** | `AutoTemporalGraph` | 重大事件时间轴 | 事件驱动分析 |
+| **`SegmentPerformanceList`** | `AutoList` | 分部/区域业绩 | 分部估值 |
+| **`FinancialDataTemporalGraph`** | `AutoTemporalGraph` | 跨期财务指标 | 趋势分析 |
+| **`RiskAssessmentGraph`** | `AutoGraph` | 风险传导路径 | 风险监控 |
+| **`SupplyChainGraph`** | `AutoGraph` | 供应链主体与风险 | ESG分析 |
-* **股票研究报告 (Equity Research)**:分析师撰写的深度报告,包含评级、目标价及投资逻辑相关内容。
+* **股票研究报告**:分析师深度报告,包含评级、目标价及投资逻辑。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`ResearchNoteSummary`** | `AutoModel` | **研报核心摘要**。提取评级(买入/卖出)、目标价及核心投资逻辑摘要。 | 研报数据库、快速筛选 |
-| **`FinancialForecast`** | `AutoList` | **财务预测表**。提取分析师对未来几年的营收、EPS、PE 等关键指标预测。 | 一致性预期分析、估值建模 |
-| **`ValuationLogicMap`** | `AutoGraph` | **估值逻辑图**。提取驱动股价变化的因果链条(如:新产品发布 -> 营收增长)。 | 投资逻辑图志、归因分析 |
-| **`FactorInfluenceHypergraph`** | `AutoHypergraph` | **多因子影响分析**。建模宏观因素、行业趋势与公司指标之间的复杂关联。 | 量化基本面分析、因子归因 |
-| **`RiskFactorList`** | `AutoList` | **风险清单**。提取报告中的具体下行风险点(监管、汇率、供应链风险等)。 | 风险监控、负面因素扫描 |
+| **`ResearchNoteSummary`** | `AutoModel` | 评级、目标价、投资逻辑 | 研报数据库 |
+| **`FinancialForecast`** | `AutoList` | 营收、EPS、PE预测 | 一致性预期 |
+| **`ValuationLogicMap`** | `AutoGraph` | 股价驱动因果链 | 策略映射 |
+| **`FactorInfluenceHypergraph`** | `AutoHypergraph` | 宏观→行业→公司关联 | 因子归因 |
+| **`RiskFactorList`** | `AutoList` | 下行风险点 | 风险监控 |
-* **招股说明书 (Prospectus/IPO)**:企业上市前的全面披露文件,详述股权结构、募集资金用途等。
+* **招股说明书 (IPO)**:企业上市前披露文件,详述股权结构、募集资金用途。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`ShareholderStructure`** | `AutoGraph` | **股权结构图**。提取股东占比、层级关系及最终实际控制人路径。 | 穿透式监管、关联方识别 |
-| **`ProceedsUsage`** | `AutoList` | **募资投向**。详细提取募投项目的名称、计划金额分配及预计时间表。 | 投后管理、资金使用合规 |
-| **`CompanyHistoryTimeline`** | `AutoTemporalGraph` | **公司大事记**。按时间轴提取公司成立以来的融资、并购、管理层变更等里程碑。 | 投研尽调、企业图鉴 |
+| **`ShareholderStructure`** | `AutoGraph` | 股东占比、层级关系 | 尽职调查 |
+| **`ProceedsUsage`** | `AutoList` | 募投项目、金额、时间表 | 投后管理 |
+| **`CompanyHistoryTimeline`** | `AutoTemporalGraph` | 成立、融资、并购大事 | 企业历史 |
-* **财报电话会议 (Earnings Call Transcripts)**:管理层按季度发布的业绩说明会实录,包含财务数据解读、前瞻性指引及分析师问答,蕴含丰富的情感信号与预期信息。
+* **财报电话会议**:管理层业绩说明会实录,包含前瞻性指引。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`EarningsCallSummary`** | `AutoModel` | **电话会议概览**。提取核心披露指标(营收、EPS)、管理层指引及整体会议基调(积极/审慎/消极)。 | 季度回顾看板、一致性预期跟踪 |
-| **`ManagementGuidanceList`** | `AutoList` | **前瞻性指引**。提取管理层的前瞻性声明:预期数据、战略优先级及定性展望。 | 业绩指引跟踪、预期差分析 |
-| **`DiscussionGraph`** | `AutoGraph` | **财报会议讨论图谱**。提取财报会议中讨论的实体及它们之间的多元关系(问答、关注、业务、财务等),支持分析师关注点分析。 | 分析师关注点分析、问答互动追踪 |
-| **`CallSentimentHypergraph`** | `AutoHypergraph` | **话题-情感分析超图**。建模多维情感信号:`{话题(营收/利润率/指引), 发言人, 情感倾向, 驱动因素}` 的复杂关联。 | 情感驱动交易信号、基调变化检测 |
+| **`EarningsCallSummary`** | `AutoModel` | 核心指标、指引、会议基调 | 季度回顾 |
+| **`ManagementGuidanceList`** | `AutoList` | 前瞻性声明 | 业绩指引跟踪 |
+| **`DiscussionGraph`** | `AutoGraph` | 讨论实体及多元关系 | 分析师关注分析 |
+| **`CallSentimentHypergraph`** | `AutoHypergraph` | 多维情感信号 | 交易信号 |
-* **金融新闻与市场评论 (Financial News & Market Commentary)**:传递市场情绪、事件影响及前瞻性观点的新闻报道、分析师评论及社交媒体帖子。
+* **金融新闻与市场评论**:传递市场情绪、事件影响的新闻报道。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`MarketSentimentModel`** | `AutoModel` | **情绪快照**。提取情感极性(看涨/看跌/中性)、涉及实体(股票代码、板块)及预期价格影响方向。 | 实时情绪数据流、交易信号生成 |
-| **`FinancialEventCausalGraph`** | `AutoGraph` | **事件影响图谱**。映射金融事件到受影响实体及下游市场反应的因果链(如"美联储加息 -> 银行板块上涨 -> 债券收益率上升")。 | 事件驱动策略、宏观影响分析 |
-| **`MultiSourceSentimentHypergraph`** | `AutoHypergraph` | **多源情绪融合超图**。融合多渠道情绪信号:`{新闻报道, 社交媒体, 分析师研报} -> 聚合情绪 -> 受影响实体` 的多因素模型。 | 集成情绪评分、虚假信号过滤 |
-| **`MarketNarrativeTimeline`** | `AutoTemporalGraph` | **市场叙事演变轴**。追踪市场主流叙事与主题如何随时间演变(如从"通胀恐慌"转向"软着陆预期")。 | 主题投资、市场状态识别 |
+| **`MarketSentimentModel`** | `AutoModel` | 情感极性、实体、价格影响 | 交易信号 |
+| **`FinancialEventCausalGraph`** | `AutoGraph` | 事件→实体→市场反应 | 策略分析 |
+| **`MultiSourceSentimentHypergraph`** | `AutoHypergraph` | 多源情绪融合 | 集成评分 |
+| **`MarketNarrativeTimeline`** | `AutoTemporalGraph` | 市场叙事演变 | 主题投资 |
+
+[↑ 返回目录](#目录)
+
+---
+
+### 3. 🏥 `medicine` (医学)
-### 3. `medicine` (医学)
专注于疾病诊疗逻辑、标准化术语映射及因果关系提取。
-* **医学教科书与专著**:系统性阐述解剖、病理、药理及治疗原则的专业书籍。
+* **医学教科书与专著**:系统性阐述解剖、病理、治疗原则。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`PathologyHypergraph`** | `AutoHypergraph` | **多因素病理机制图**。建模“基因+环境+诱因 -> 疾病”的复杂致病逻辑。 | 疾病原理研究、知识库构建 |
-| **`MedicalConceptNet`** | `AutoGraph` | **医学概念网络**。提取医学术语及其关联属性(如:属于、定义为)。 | 术语标准化、语义搜索 |
-| **`PharmacologyGraph`** | `AutoGraph` | **药理机制图**。提取药物、受体、靶点及生理反应之间的相互作用路径。 | 药理逻辑梳理、新药研发 |
-| **`AnatomyHierarchy`** | `AutoGraph` | **解剖层级树**。构建解剖位置的包含 (Part-Of) 和毗邻 (Connected-To) 关系。 | 解剖学图谱、手术导航基础 |
-| **`SymptomDifferential`** | `AutoSet` | **鉴别诊断表**。汇总症状与其对应的鉴别疾病列表,形成症状-疾病映射。 | CDSS 辅助诊断、教学系统 |
+| **`PathologyHypergraph`** | `AutoHypergraph` | 基因+环境+诱因→疾病 | 研究知识库 |
+| **`MedicalConceptNet`** | `AutoGraph` | 医学术语及语义关系 | 术语标准化 |
+| **`PharmacologyGraph`** | `AutoGraph` | 药物-受体-生理反应 | 药理分析 |
+| **`AnatomyHierarchy`** | `AutoGraph` | 解剖位置层级 | 手术导航 |
+| **`SymptomDifferential`** | `AutoSet` | 症状→鉴别疾病 | 辅助诊断 |
-* **临床诊疗指南 (Clinical Guidelines)**:权威机构发布的标准化文档,定义了决策路径。
+* **临床诊疗指南**:标准化治疗决策路径。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`TreatmentRegimenMap`** | `AutoHypergraph` | **综合治疗方案图**。提取由“药物组合+理疗+生活干预”构成的多因素治疗方案。 | 肿瘤化疗方案、慢病管理 |
-| **`ClinicalPathway`** | `AutoGraph` | **临床路径图**。提取“If 症状A Then 检查B Else 治疗C”的决策树结构。 | 临床路径管理、诊疗规范化 |
-| **`LevelOfEvidence`** | `AutoList` | **证据评级表**。提取指南中的具体推荐意见及其对应的证据等级。 | 设计临床质控方案、科研引用 |
+| **`TreatmentRegimenMap`** | `AutoHypergraph` | 多因素治疗方案 | 肿瘤化疗方案 |
+| **`ClinicalPathway`** | `AutoGraph` | 临床决策树 | 诊疗规范化 |
+| **`LevelOfEvidence`** | `AutoList` | 推荐意见及证据等级 | 临床质控 |
-* **出院小结 (Discharge Summaries)**:患者住院全过程的叙述性记录。
+* **出院小结**:患者住院全过程的叙述性记录。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`SurgicalEventGraph`** | `AutoHypergraph` | **手术事件超图**。将手术建模为 {医生, 部位, 术式, 器械} 共同参与的复杂事件。 | 手术质控、绩效评估 |
-| **`HospitalCourseTimeline`** | `AutoTemporalGraph` | **住院病程时间轴**。严格按时间顺序提取入院、检查、治疗、转归等节点。 | 病历质控、医疗纠纷溯源 |
-| **`DischargeInstruction`** | `AutoModel` | **出院医嘱摘要**。提取出院带药、复诊计划及康复建议的结构化信息。 | 患者随访、慢病续方 |
+| **`SurgicalEventGraph`** | `AutoHypergraph` | 手术复杂事件 | 手术质控 |
+| **`HospitalCourseTimeline`** | `AutoTemporalGraph` | 入院→检查→治疗→转归 | 病历质控 |
+| **`DischargeInstruction`** | `AutoModel` | 出院带药、复诊、康复 | 患者随访 |
-* **病理报告 (Pathology Reports)**:对组织样本的微观描述。
+* **病理报告**:对组织样本的微观描述。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`TumorStagingItem`** | `AutoModel` | **TNM 分期表**。提取肿瘤大小(T)、淋巴结(N)、转移(M)及分期结果。 | 肿瘤登记、预后评估 |
-| **`MicroscopicFeatureSet`** | `AutoSet` | **微观特征集**。提取免疫组化指标(如 HER2+, Ki67)及基因突变状态。 | 靶向药匹配、科研入组筛选 |
+| **`TumorStagingItem`** | `AutoModel` | TNM分期 | 肿瘤登记 |
+| **`MicroscopicFeatureSet`** | `AutoSet` | 免疫组化、基因突变 | 靶向药匹配 |
-* **药品说明书 (Package Inserts)**:法律规定的药品文档,包含适应症、禁忌症等内容。
+* **药品说明书**:包含适应症、禁忌症等专业信息。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`ComplexInteractionNet`** | `AutoHypergraph` | **条件性相互作用网**。建模“药A+药B+特定体质 -> 不良反应”的高阶依赖。 | 合理用药系统 (高级版) |
-| **`ContraindicationList`** | `AutoList` | **禁忌症清单**。提取绝对禁忌(如孕妇、严重肾衰竭等)的明确列表。 | 处方拦截、用药安全监测 |
-| **`AdverseReactionStats`** | `AutoList` | **不良反应统计**。提取各系统的不良反应表现及其发生率描述。 | 药物警戒、安全性评价 |
+| **`ComplexInteractionNet`** | `AutoHypergraph` | 药物相互作用 | CDSS |
+| **`ContraindicationList`** | `AutoList` | 绝对禁忌 | 处方拦截 |
+| **`AdverseReactionStats`** | `AutoList` | 不良反应及发生率 | 药物警戒 |
+
+[↑ 返回目录](#目录)
+
+---
+
+### 4. 🌿 `tcm` (中医中药)
-### 4. `tcm` (中医中药)
针对中医特有的辨证论治逻辑和药性理论进行优化。
-* **名医医案 (Medical Case Records)**:记录“望闻问切”症状、辨证分析(理)、治法(法)及处方(方药)的临床实录。
+* **名医医案**:记录症状、辨证分析、治法及处方的临床实录。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`SyndromeReasoningGraph`** | `AutoHypergraph` | **辨证论治逻辑图**。建模 `{症状群} -> 证型 -> 治则 -> {处方}` 的完整推理链条。 | 医案数据挖掘、名老中医经验传承 |
-| **`PrescriptionModification`** | `AutoGraph` | **处方加减逻辑**。提取基于特定症状对基础方剂进行的药物加减(如“随证加减”)。 | 临证用药规律分析 |
-| **`PulseTongueRecord`** | `AutoList` | **舌脉特征提取**。结构化提取舌象(质、苔)与脉象描述,用于统计分析。 | 中医诊断客观化研究 |
+| **`SyndromeReasoningGraph`** | `AutoHypergraph` | 症状→证型→治则→处方 | 医案挖掘 |
+| **`PrescriptionModification`** | `AutoGraph` | 处方加减逻辑 | 用药规律分析 |
+| **`PulseTongueRecord`** | `AutoList` | 舌象与脉象特征 | 诊断客观化 |
-* **本草典籍 (Herbal Compendiums)**:描述单味药的四气五味、归经、功效主治及配伍禁忌的文本。
+* **本草典籍**:描述单味药的四气五味、归经、功效。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`HerbPropertyModel`** | `AutoModel` | **药物性味归经**。提取单味药的四气五味、归经、毒性及推荐剂量。 | 中药基础数据库构建 |
-| **`CompatibilityNet`** | `AutoGraph` | **七情配伍网络**。提取药物间的相须、相使、相畏、相杀、十八反十九畏关系。 | 配伍禁忌预警、方剂组网分析 |
-| **`ProcessingMethod`** | `AutoList` | **炮制方法列表**。提取药物的不同炮制方法(如蜜炙、酒炒)及其对药效的影响。 | 中药炮制规范、饮片管理 |
+| **`HerbPropertyModel`** | `AutoModel` | 四气五味、归经、毒性 | 中药数据库 |
+| **`CompatibilityNet`** | `AutoGraph` | 七情配伍关系 | 配伍禁忌 |
+| **`ProcessingMethod`** | `AutoList` | 炮制方法及影响 | 炮制规范 |
-* **方剂规范 (Prescription Formularies)**:记载方剂组成的文档,包含君臣佐使的配伍结构及煎服法。
+* **方剂规范**:记载方剂组成,包含君臣佐使配伍结构。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`FormulaComposition`** | `AutoHypergraph` | **君臣佐使结构图**。将方剂建模为 `{君药, 臣药, 佐药, 使药}` 的层级化超边结构。 | 方剂结构解析、组方规律研究 |
-| **`FunctionIndicationMap`** | `AutoGraph` | **主治功效映射**。关联 方剂 -> 功能(如清热解毒) -> 主治证候。 | 方剂推荐系统 |
+| **`FormulaComposition`** | `AutoHypergraph` | 君臣佐使层级结构 | 方剂解析 |
+| **`FunctionIndicationMap`** | `AutoGraph` | 方剂→功能→主治 | 推荐系统 |
-* **经络腧穴专著 (Meridian Treatises)**:描述穴位解剖定位、归经及其特定主治功能的文本。
+* **经络腧穴专著**:描述穴位定位、归经及主治功能。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`AcupointLocationMap`** | `AutoGraph` | **腧穴空间定位**。基于人体解剖标志提取穴位的相对位置关系(如“脐旁2寸”)。 | 针灸教学可视化、穴位图谱 |
-| **`MeridianFlowGraph`** | `AutoGraph` | **经络流注图**。提取十二经脉的循行路线及经气流注次序。 | 经络理论教学 |
+| **`AcupointLocationMap`** | `AutoGraph` | 腧穴空间定位 | 针灸教学 |
+| **`MeridianFlowGraph`** | `AutoGraph` | 十二经脉循行 | 经络理论 |
+
+[↑ 返回目录](#目录)
+
+---
-### 5. `industry` (工业)
-专注于电力,制造、能源等行业的运维数据与非结构化日志分析。
+### 5. ⚙️ `industry` (工业)
-* **管理规范 (Management Specifications)**:安全规程、应急预案等管理性文档。
+专注于电力、制造、能源等行业的运维数据与日志分析。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+* **管理规范**:安全规程、应急预案等。
+
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`SafetyControlGraph`** | `AutoGraph` | **安全管控图**。提取危险源、风险点和管控措施。 | 安全规程 |
-| **`EmergencyResponseGraph`** | `AutoGraph` | **应急预案图**。提取事故场景、响应动作和部门。 | 应急预案 |
-| **`IncidentCausalityMap`** | `AutoHypergraph` | **事故因果链超图**。建模隐患、触发条件、违章行为、事故后果。 | 风险预防 |
-| **`SafetyTimeline`** | `AutoTemporalGraph` | **事故时序图**。还原事故发生前后的操作与响应序列。 | 事故复盘 |
+| **`SafetyControlGraph`** | `AutoGraph` | 危险源、风险点、管控 | 安全规程 |
+| **`EmergencyResponseGraph`** | `AutoGraph` | 事故场景、响应动作 | 应急预案 |
+| **`IncidentCausalityMap`** | `AutoHypergraph` | 隐患→触发→违章→后果 | 风险预防 |
+| **`SafetyTimeline`** | `AutoTemporalGraph` | 操作与响应序列 | 事故复盘 |
-* **技术规格书 (Technical Specifications)**:描述设备额定参数、材质标准及性能曲线的半结构化文本。
+* **技术规格书**:设备额定参数、设计标准。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`SystemTopologyGraph`** | `AutoGraph` | **系统拓扑图**。提取工厂的厂区、系统、子系统、设备等层级结构。 | 系统说明书 |
-| **`EquipmentTopologyGraph`** | `AutoGraph` | **设备拓扑图**。提取工业设备的实体及其相互连接关系。 | 设备系统图 |
-| **`SpecParameterTable`** | `AutoModel` | **核心规格表**。提取额定功率、材质、尺寸精度等关键技术指标。 | 设备台账 |
-| **`SystemCompatibilityGraph`** | `AutoHypergraph` | **系统兼容性超图**。提取设备与环境、介质的对应关系。 | 选型辅助 |
+| **`SystemTopologyGraph`** | `AutoGraph` | 厂区、系统、设备层级 | 系统说明书 |
+| **`EquipmentTopologyGraph`** | `AutoGraph` | 设备实体及连接 | 设备图纸 |
+| **`SpecParameterTable`** | `AutoModel` | 额定功率、材质、精度 | 设备台账 |
+| **`SystemCompatibilityGraph`** | `AutoHypergraph` | 设备与环境关系 | 选型辅助 |
-* **操作运维 (Operations)**:设备运行规程、工况切换等操作相关知识。
+* **操作运维**:设备运行规程、工况切换。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`OperationFlowGraph`** | `AutoGraph` | **操作流程图**。提取操作步骤、设备状态和预期结果。 | 运行规程 |
-| **`OperatingModeGraph`** | `AutoGraph` | **工况切换图**。提取工况类型和切换条件。 | 工况切换说明书 |
-| **`MaintenaceOperationMap`** | `AutoHypergraph` | **维修作业图**。关联操作人、工具、对象、耗时。 | 维修标准化 |
+| **`OperationFlowGraph`** | `AutoGraph` | 操作步骤、状态、结果 | 运行规程 |
+| **`OperatingModeGraph`** | `AutoGraph` | 工况类型和切换条件 | 工况切换 |
+| **`MaintenaceOperationMap`** | `AutoHypergraph` | 操作人、工具、对象、耗时 | 维修标准化 |
-* **设备维护 (Maintenance)**:巡检记录、故障案例、备件更换等维护知识。
+* **设备维护**:巡检记录、故障案例、备件更换。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`InspectionRecordGraph`** | `AutoGraph` | **巡检记录图**。提取设备和巡检项。 | 巡检记录本 |
-| **`FailureCaseGraph`** | `AutoGraph` | **故障案例图**。提取故障现象、原因、措施和教训。 | 故障案例库 |
-| **`FailureKnowledgeHypergraph`** | `AutoHypergraph` | **故障知识超图**。建模故障现象、根因、部件、解决方案。 | 故障诊断 |
-| **`PartReplacementList`** | `AutoList` | **备件消耗清单**。提取零件型号、数量、原因。 | 备件管理 |
+| **`InspectionRecordGraph`** | `AutoGraph` | 设备和巡检项 | 巡检记录 |
+| **`FailureCaseGraph`** | `AutoGraph` | 现象、原因、措施、教训 | 故障案例库 |
+| **`FailureKnowledgeHypergraph`** | `AutoHypergraph` | 现象、根因、部件、方案 | 故障诊断 |
+| **`PartReplacementList`** | `AutoList` | 零件型号、数量、原因 | 备件管理 |
-* **HSE事故报告 (Incident Reports)**:对生产事故的调查报告,包含事件时间线、根本原因分析及整改措施。
+* **HSE事故报告**:生产事故调查报告。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`IncidentCausalityMap`** | `AutoHypergraph` | **事故因果链超图**。建模隐患、触发条件、违章行为、事故后果。 | 事故推演 |
-| **`SafetyTimeline`** | `AutoTemporalGraph` | **事故时序图**。还原事故发生前后的操作与响应序列。 | 事故复盘 |
+| **`IncidentCausalityMap`** | `AutoHypergraph` | 隐患→触发→违章→后果 | 事故推演 |
+| **`SafetyTimeline`** | `AutoTemporalGraph` | 操作与响应序列 | 事故复盘 |
+
+[↑ 返回目录](#目录)
-### 6. `history` (历史)
-专注于长跨度的时间线梳理及人物社会网络构建。
+---
-* **历史专著 (Historical Monographs)**:对特定断代、事件或人物进行深度因果分析与考证的学术书籍。
+### 6. 📜 `history` (历史)
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+专注于长跨度时间线梳理及人物社会网络构建。
+
+* **历史专著**:对特定断代、事件或人物的深度分析。
+
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`HistoricalKnowledgeGraph`** | `AutoGraph` | **通用历史图谱**。提取基础的人物关系(亲属、君臣、敌友)及事件因果。 | 历史人物关系网构建 |
-| **`MultiParticipantEventMap`** | `AutoHypergraph` | **多方事件超图**。将历史事件建模为连接多个参与者的超边(如“鸿门宴”连接项羽、刘邦等)。 | 复杂历史事件还原、群像分析 |
+| **`HistoricalKnowledgeGraph`** | `AutoGraph` | 人物关系、事件因果 | 社会网络分析 |
+| **`MultiParticipantEventMap`** | `AutoHypergraph` | 多方参与事件 | 事件还原 |
-* **编年史 (Chronicles)**:按严格时间顺序记录的历史事件,侧重于时序演变。
+* **编年史**:按时间顺序记录的历史事件。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`ChronologicalEventChain`** | `AutoTemporalGraph` | **编年事件链**。提取带精确时间戳的原子事件,严格还原时间线。 | 历史大事年表生成 |
-| **`HistoricalContextGraph`** | `AutoGraph` | **历史背景关联图**。提取事件背后的人物关系、地缘政治等静态关联。 | 历史事件背景挖掘 |
-| **`PoliticalStruggleHypergraph`** | `AutoHypergraph` | **政治博弈超图**。针对战役或政争,提取 `{攻方, 守方, 策划者, 变节者}` 的复杂互动。 | 战役复盘、派系斗争分析 |
+| **`ChronologicalEventChain`** | `AutoTemporalGraph` | 带时间戳的原子事件 | 年表生成 |
+| **`HistoricalContextGraph`** | `AutoGraph` | 静态关联(亲属、联盟)| 背景挖掘 |
+| **`PoliticalStruggleHypergraph`** | `AutoHypergraph` | 攻守方、策划者、变节者 | 派系分析 |
-* **口述历史 (Oral History)**:亲历者的第一人称回忆录,包含非线性叙事及个人视角细节。
+* **口述历史**:第一人称回忆录。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`PersonalTrajectoryHypergraph`** | `AutoHypergraph` | **个人轨迹超图**。以人生阶段为超边,关联 `{时期, 地点, 同行人物, 核心经历}`。 | 人物传记编撰、生命历程研究 |
-| **`NarrativeRelationGraph`** | `AutoGraph` | **叙事关系图**。提取口述者主观视角下的人物互动与评价关系。 | 口述史社会网络分析 |
-| **`MemoryFlashbackList`** | `AutoList` | **回忆片段清单**。提取口述中提到的具体轶事、感悟或对特定历史时刻的侧面描写。 | 历史细节补充、情感分析 |
+| **`PersonalTrajectoryHypergraph`** | `AutoHypergraph` | 人生阶段超边 | 传记编撰 |
+| **`NarrativeRelationGraph`** | `AutoGraph` | 主观视角人物互动 | 社会网络分析 |
+| **`MemoryFlashbackList`** | `AutoList` | 轶事、感悟、侧面描写 | 历史细节 |
-* **档案馆藏信札 (Archival Correspondence)**:历史人物间的往来书信,揭示隐秘的社交网络和事件细节。
+* **档案信札**:历史人物往来书信。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`EpistolaryKnowledgeGraph`** | `AutoGraph` | **信札内容图谱**。提取信件正文中提到的人物、事件及其相互关系,而非仅仅是发信和收信关系。 | 史料挖掘、事件考证 |
+| **`EpistolaryKnowledgeGraph`** | `AutoGraph` | 信件内容中的人物事件 | 史料挖掘 |
-### 7. `biology` (生物科学)
-从单一的基因组扩展到蛋白质组学、代谢通路及生态学。
+[↑ 返回目录](#目录)
+
+---
-* **生物学专著 (Biological Monographs)**:详述物种分类、进化历史或复杂生物系统机制的学术书籍。
+### 7. 🧬 `biology` (生物科学)
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+从基因组扩展到蛋白质组学、代谢通路及生态学。
+
+* **生物学专著**:物种分类、进化历史。
+
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`SpeciesInteractionWeb`** | `AutoGraph` | **物种相互作用网**。提取捕食、寄生、竞争、互利共生等关系。 | 食物网构建、生态关系分析 |
-| **`TaxonomicTree`** | `AutoGraph` | **分类学树**。提取界门纲目科属种的层级包含关系。 | 生物分类学数据库 |
+| **`SpeciesInteractionWeb`** | `AutoGraph` | 捕食、寄生、竞争、共生 | 食物网分析 |
+| **`TaxonomicTree`** | `AutoGraph` | 界门纲目科属种层级 | 分类学数据库 |
-* **蛋白质结构摘要 (Protein Structure Summaries)**:描述蛋白质晶体结构、配体结合位点及修饰位点的文本。
+* **蛋白质结构摘要**:晶体结构、配体结合位点。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`ProteinComplexMap`** | `AutoHypergraph` | **蛋白质复合物超图**。建模 `{亚基A, 亚基B, 辅因子}` 共同组成功能复合物的多亚基结构。 | 蛋白质复合物数据库、结构研究 |
-| **`BindingSiteModel`** | `AutoModel` | **关键位点模型**。提取活性位点、结合位点的残基编号、化学性质及功能注解。 | 药物设计、位点突变分析 |
+| **`ProteinComplexMap`** | `AutoHypergraph` | 多亚基复合物 | 蛋白数据库 |
+| **`BindingSiteModel`** | `AutoModel` | 活性位点、化学性质 | 药物设计 |
-* **代谢通路描述 (Metabolic Pathways)**:解释生物化学反应级联的文本,涉及酶、底物、产物及调控机制。
+* **代谢通路描述**:生化反应级联。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`BiochemicalReactionHypergraph`** | `AutoHypergraph` | **生化反应超图**。精准建模 `{酶 + 底物A + 底物B -> 产物C + 产物D}` 的多输入多输出反应。 | 代谢通路图谱、代谢工程 |
-| **`RegulatoryNetwork`** | `AutoGraph` | **基因调控网络**。提取转录因子、启动子及其对基因表达的促进、抑制、协同作用。 | 基因调控分析、系统生物学 |
+| **`BiochemicalReactionHypergraph`** | `AutoHypergraph` | 酶+底物→产物反应 | 通路图谱 |
+| **`RegulatoryNetwork`** | `AutoGraph` | 转录因子→启动子→基因表达 | 基因调控分析 |
-* **生态调查 ( Ecological Surveys)**:对物种形态特征、鉴别要点及系统发育关系的详细记录,以及特定区域内物种分布与生境特征的考察。
+* **生态调查**:物种形态、分布、生境特征。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`PhylogeneticRelationGraph`** | `AutoGraph` | **系统发育关系图**。提取物种间的亲缘关系、演化距离及分支点。 | 分子系统学、进化树构建 |
-| **`BiodiversityRegistry`** | `AutoSet` | **物种名录**。去重汇总调查报告中观测到的所有物种及其种群数量信息。 | 物种清单制作、保护优先级评估 |
+| **`PhylogeneticRelationGraph`** | `AutoGraph` | 亲缘关系、演化距离 | 系统发育树 |
+| **`BiodiversityRegistry`** | `AutoSet` | 观测物种及种群 | 生物多样性评估 |
+
+[↑ 返回目录](#目录)
-### 8. `legal` (法律)
-专注于提取权利义务逻辑、条件约束及法律事实。
+---
+
+### 8. ⚖️ `legal` (法律)
-* **法学专著与评注**:对法律原则、法条逻辑及判例法进行深度学理解析的书籍。
+专注于权利义务逻辑、条件约束及法律事实。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+* **法学专著与评注**:法律原则、法条逻辑分析。
+
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`LegalConceptOntology`** | `AutoGraph` | **法律概念本体**。提取法律术语的定义、上下位关系及法理阐释。 | 法律检索增强、法学教育 |
-| **`CaseLawCitationNet`** | `AutoGraph` | **判例引用网络**。映射案件之间的引用、区分(Distinguish)或推翻(Overrule)关系。 | 判例法研究、类案检索 |
+| **`LegalConceptOntology`** | `AutoGraph` | 术语定义、上下位关系 | 法律检索 |
+| **`CaseLawCitationNet`** | `AutoGraph` | 案件引用关系 | 判例研究 |
-* **主服务协议 (MSA)**:定义长期商业合作框架的合同,包含责任限制、知识产权归属及违约条款。
+* **主服务协议 (MSA)**:长期商业合同。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`ContractObligationHypergraph`** | `AutoHypergraph` | **合同义务超图**。建模复杂的条件性义务:`{主体, 义务, 触发条件, 例外情形, 违约责任}`。 | 同时履行抗辩权分析、合同审查 |
-| **`DefinedTermRegistry`** | `AutoSet` | **术语定义表**。去重并汇总合同中定义的所有专有名词(如“机密信息”、“不可抗力”)。 | 术语一致性检查、合同摘要 |
-| **`LiabilityClauseList`** | `AutoList` | **责任条款清单**。提取关于赔偿、责任限制、保证及免责声明的具体条款。 | 合同风险评估、法务审核 |
+| **`ContractObligationHypergraph`** | `AutoHypergraph` | 主体+义务+条件+例外+责任 | 合同审查 |
+| **`DefinedTermRegistry`** | `AutoSet` | 定义的专有名词 | 一致性检查 |
+| **`LiabilityClauseList`** | `AutoList` | 赔偿、责任限制条款 | 风险评估 |
-* **法院判决书 (Judgments)**:法官对案件的最终裁定,包含事实认定、法律推理及判例引用。
+* **法院判决书**:法官最终裁定。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`CaseFactTimeline`** | `AutoTemporalGraph` | **案件事实时序图**。从“经审理查明”部分还原导致纠纷的按时间顺序排列的事实链条。 | 案情复盘、证据链梳理 |
-| **`AdjudicationLogic`** | `AutoHypergraph` | **裁判逻辑超图**。建模法官的推理过程:`{认定事实 + 适用法律 -> 裁判结论}`。 | 类案推送、判决预测辅助 |
-| **`LitigationParticipantMap`** | `AutoGraph` | **诉讼参与人图谱**。提取原告、被告、第三人、代理律师及证人之间的关系。 | 利益冲突检索、关联案件分析 |
+| **`CaseFactTimeline`** | `AutoTemporalGraph` | 时间顺序的事实链条 | 案情分析 |
+| **`AdjudicationLogic`** | `AutoHypergraph` | 事实+法律→结论 | 判决预测 |
+| **`LitigationParticipantMap`** | `AutoGraph` | 原告被告律师证人关系 | 利益冲突 |
-* **合规申报文件 (Compliance Filings)**:企业提交给监管机构的关于数据合规、反洗钱或环境影响的详细陈述。
+* **合规申报文件**:数据合规、反洗钱报告。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`ComplianceRequirementList`** | `AutoList` | **合规要求清单**。提取文件中承诺遵守的具体义务或整改措施。 | 合规差距分析、监管应对 |
-| **`BeneficialOwnershipGraph`** | `AutoGraph` | **受益所有权图谱**。穿透多层股权结构,识别最终受益人 (UBO) 和控制人。 | 反洗钱 (AML)、制裁筛查 |
+| **`ComplianceRequirementList`** | `AutoList` | 具体义务或整改措施 | 合规分析 |
+| **`BeneficialOwnershipGraph`** | `AutoGraph` | 股权穿透至UBO | AML/KYC |
+[↑ 返回目录](#目录)
+
+---
+
+### 9. 🎭 `literature` (文学与影视)
-### 9. `literature` (文学与影视)
专注于叙事结构分析、角色互动及世界观设定。
-* **影视剧本 (Screenplays)**:格式严格的文本(场景头、动作、对白),适合提取角色互动图谱。
+* **影视剧本**:格式严格的文本(场景、对白)。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`SceneEventHypergraph`** | `AutoHypergraph` | **场景事件超图**。将一场戏建模为连接 `{出场角色, 场景地点, 关键道具, 核心动作}` 的超边。 | 剧本统筹、场次复杂度分析 |
-| **`CharacterArcTimeline`** | `AutoTemporalGraph` | **角色弧光时序图**。按剧本时间线提取角色在不同场次中的位置、情绪状态或关键行为。 | 人物成长路径分析、连戏检查 |
+| **`SceneEventHypergraph`** | `AutoHypergraph` | 场景超边 | 剧本统筹 |
+| **`CharacterArcTimeline`** | `AutoTemporalGraph` | 角色成长路径 | 人物分析 |
-* **长篇小说 (Novels)**:情节复杂、人物众多且关系交织的文本。
+* **长篇小说**:复杂情节、众多人物。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`ComplexCharacterRelation`** | `AutoHypergraph` | **复杂人物关系网**。超越两两关系,提取涉及多方的社会结构(如三角恋、结盟、家族派系)。 | 人物群像分析、粉丝维基构建 |
-| **`StoryEntityGraph`** | `AutoGraph` | **故事实体图谱**。专注于提取关键物品、地点及其归属或位置关系,与人物关系分离。 | 世界观设定整理、RPG 游戏改编 |
-| **`NarrativeEventChain`** | `AutoTemporalGraph` | **叙事事件链**。按故事内部时间线提取关键情节转折点 (Plot Points)。 | 故事梗概生成、时间线梳理 |
+| **`ComplexCharacterRelation`** | `AutoHypergraph` | 多方社会结构 | 群像分析 |
+| **`StoryEntityGraph`** | `AutoGraph` | 物品、地点归属 | 世界观设定 |
+| **`NarrativeEventChain`** | `AutoTemporalGraph` | 关键情节转折 | 梗概生成 |
-* **文学评论 (Literary Criticism)**:对作品主题、意象及结构的深度剖析。
+* **文学评论**:主题、意象、结构分析。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`MotifAssociationNet`** | `AutoGraph` | **意象关联网络**。提取文本中反复出现的符号、意象之间的关联,节点类型统一为“意象”。 | 文本细读辅助、符号学分析 |
-| **`CritiqueArgumentHypergraph`** | `AutoHypergraph` | **评论论证超图**。建模复杂的论证逻辑:`{论据1, 论据2, 引用文本} -> 核心观点`。 | 学术论文分析、观点提炼 |
-| **`NarrativeStructureTree`** | `AutoGraph` | **叙事结构树**。构建作品的结构层级(如主线、支线、插叙部分)。 | 叙事学研究、结构拆解 |
+| **`MotifAssociationNet`** | `AutoGraph` | 反复出现的意象 | 符号学分析 |
+| **`CritiqueArgumentHypergraph`** | `AutoHypergraph` | 论据→观点 | 论文分析 |
+| **`NarrativeStructureTree`** | `AutoGraph` | 叙事结构层级 | 叙事学研究 |
+
+[↑ 返回目录](#目录)
+
+---
+
+### 10. 📰 `news` (新闻传媒)
-### 10. `news` (新闻传媒)
专注于新闻要素 (5W1H)、事件因果链及观点分析。
-* **深度调查报道 (Investigative Journalism)**:揭示复杂社会关系或深层真相的长篇报道。
+* **深度调查报道**:揭示复杂社会关系的长篇报道。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`InvestigativeContextGraph`** | `AutoGraph` | **调查背景图谱**。提取报道中涉及的所有人物、机构、地点及其表层的静态关系(如任职、亲属、所在地)。 | 实体关系梳理、利益相关方识别 |
-| **`ComplexRelationNet`** | `AutoHypergraph` | **复杂关系网络**。建模涉及多方(三人及以上)的社会关联(如家族、政治盟友、商业伙伴),而非简单的点对点关系。 | 人物特稿、政商关系分析 |
-| **`KeyEventSequence`** | `AutoGraph` | **调查事件脉络**。按时间顺序还原调查中揭露的关键事件节点,梳理前因后果。 | 深度回顾、历史遗留问题揭秘 |
+| **`InvestigativeContextGraph`** | `AutoGraph` | 静态关系(任职、亲属)| 实体映射 |
+| **`ComplexRelationNet`** | `AutoHypergraph` | 多方社会关联 | 政商分析 |
+| **`KeyEventSequence`** | `AutoGraph` | 关键事件时间线 | 深度回顾 |
-* **突发新闻与电讯 (Breaking News & Wire Stories)**:注重时效性和核心事实的短消息。
+* **突发新闻与电讯**:注重时效性的短消息。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`NewsEntityGraph`** | `AutoGraph` | **新闻实体图谱**。提取新闻文本中的核心实体(人物、机构、地点、产品、事件、状态等)及其动作或关系。 | 即时新闻流、实体链接 |
-| **`NewsSummaryModel`** | `AutoModel` | **结构化摘要**。标准化提取 5W1H 要素(Who, What, When, Where, Why, How)。 | 新闻聚合、自动简报 |
-| **`LiveUpdateTimeline`** | `AutoGraph` | **实时动态时间轴**。针对正在发生的事件(如由于发布会、突发事态),提取分钟级更新。 | 直播贴整理、实时监控 |
+| **`NewsEntityGraph`** | `AutoGraph` | 核心实体及关系 | 新闻流 |
+| **`NewsSummaryModel`** | `AutoModel` | 5W1H提取 | 新闻聚合 |
+| **`LiveUpdateTimeline`** | `AutoGraph` | 分钟级更新 | 直播整理 |
-* **政策解读与社论 (Policy Analysis & Editorials)**:侧重观点、论证逻辑及未来影响分析的文章。
+* **政策解读与社论**:观点、论证逻辑分析。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`ViewpointStructure`** | `AutoHypergraph` | **观点逻辑结构**。建模文章的论证逻辑:`{核心观点, 支撑论据, 背景引用}`。 | 社论分析、舆情观点聚类 |
-| **`ImpactChain`** | `AutoGraph` | **影响推演链**。提取“政策/事件 -> 影响群体 -> 预期后果”的因果预测链条。 | 宏观政策解读、行业影响评估 |
+| **`ViewpointStructure`** | `AutoHypergraph` | 观点→论据→结论 | 舆情分析 |
+| **`ImpactChain`** | `AutoGraph` | 政策→影响群体→后果 | 政策解读 |
+
+[↑ 返回目录](#目录)
+
+---
+
+### 11. 🌾 `agriculture` (农业)
-### 11. `agriculture` (农业)
专注于作物全生命周期管理、田间监测及土壤健康数据。
-* **农业技术手册 (Agricultural Manuals)**:关于作物种植规范、田间管理标准及病虫害防治技术的指导书。
+* **农业技术手册**:种植规范、病虫害防治。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`CropGrowthCycle`** | `AutoTemporalGraph` | **作物生长周期图**。以时间为轴,提取作物各生长阶段(播种、分蘖、成熟等)对应的关键农事操作与环境要求。 | 种植日历生成、农事任务规划 |
-| **`PestControlHypergraph`** | `AutoHypergraph` | **病虫害防治超图**。建模复杂的防治逻辑:`{作物, 阶段, 不良诱因} -> {防治对象(病/虫), 推荐药剂, 剂量, 安全间隔期}`。 | 智能植保系统、农药推荐 |
+| **`CropGrowthCycle`** | `AutoTemporalGraph` | 各生长阶段农事操作 | 种植日历 |
+| **`PestControlHypergraph`** | `AutoHypergraph` | 作物+阶段+诱因→防治方案 | 智能植保 |
-* **巡田报告 (Crop Scouting Reports)**:对作物生长阶段及病虫害情况的实地观察记录。
+* **巡田报告**:作物生长阶段及病虫害实地观察。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`FieldObservationList`** | `AutoList` | **田间观测清单**。结构化提取每一次巡田的核心记录:`{地块编号, 作物, 生长阶段, 观测问题(杂草/虫害), 严重等级, 建议措施}`。 | 巡田日志数字化、病虫害预警 |
+| **`FieldObservationList`** | `AutoList` | 地块、作物、问题、建议 | 病虫害预警 |
-* **土壤分析报告 (Soil Analysis)**:描述土壤化学成分及对应施肥建议的文本。
+* **土壤分析报告**:化学成分及施肥建议。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`SoilNutrientModel`** | `AutoModel` | **土壤养分模型**。提取核心理化指标(pH、有机质、N-P-K含量、微量元素)。 | 测土配方施肥、地力等级评价 |
-| **`AmendmentPlan`** | `AutoGraph` | **改良方案图**。提取 `{检测结果 -> 限制因子 -> 改良措施 -> 预期目标}` 的逻辑链条。 | 精准农业处方生成 |
+| **`SoilNutrientModel`** | `AutoModel` | pH、有机质、N-P-K | 配方施肥 |
+| **`AmendmentPlan`** | `AutoGraph` | 检测→限制因子→措施→目标 | 精准农业 |
+
+[↑ 返回目录](#目录)
+
+---
+
+### 12. 🍜 `food` (美食餐饮)
-### 12. `food` (美食餐饮)
专注于食谱标准化、食材配伍逻辑及美食评价数据。
-* **标准化食谱 (Standardized Recipes)**:包含配料表、烹饪步骤及关键控制点的结构化文本。
+* **标准化食谱**:配料表、烹饪步骤。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`RecipeCollection`** | `AutoSet` | **菜谱名录**。去重提取文本中出现的所有独立菜品实体及基本分类。 | 菜单数字化、菜品库索引构建 |
-| **`StandardRecipeCard`** | `AutoModel` | **单品标准食谱**。针对单个菜品提取完整的配料表、步骤说明及关键TIPS。 | 后厨 SOP 卡片、烹饪教学 |
-| **`IngredientCompositionHypergraph`** | `AutoHypergraph` | **食材配伍超图**。建模菜品与其 `{主料, 辅料, 调味品}` 的复杂组合关系。 | 成本核算、过敏原管理、新菜研发 |
+| **`RecipeCollection`** | `AutoSet` | 唯一菜品实体及分类 | 菜单数字化 |
+| **`StandardRecipeCard`** | `AutoModel` | 完整配料、步骤、技巧 | 后厨SOP |
+| **`IngredientCompositionHypergraph`** | `AutoHypergraph` | 菜品主料辅料调味关系 | 成本过敏原管理 |
-* **美食评论与感官评价 (Food Reviews & Sensory Evaluation)**:专业食评人或研发团队对菜品的详细评价记录。
+* **美食评论与感官评价**:专业食评人或研发团队评价。
-| 模板名称 | 底层原语 | 描述 | 典型应用场景 |
+| 模板 | 原语 | 描述 | 应用场景 |
| :--- | :--- | :--- | :--- |
-| **`DishReviewSummary`** | `AutoList` | **食评摘要清单**。按菜品提取核心评价点、推荐等级及价格感知。 | 探店笔记结构化、必吃榜单生成 |
-| **`SensoryEvaluationGraph`** | `AutoGraph` | **感官评价图谱**。提取 `{菜品} -[具有特征]-> {口感/味道} -[归因于]-> {食材/技法}` 的评价逻辑。 | 风味归因分析、新品研发反馈 |
+| **`DishReviewSummary`** | `AutoList` | 核心评价点、推荐等级 | 必吃榜单 |
+| **`SensoryEvaluationGraph`** | `AutoGraph` | 菜品→口感→食材/技法 | 风味归因 |
+
+[↑ 返回目录](#目录)
+
+---