Hypergraph is more powerful. Transform unstructured text into structured knowledge with LLMs. Graphs, hypergraphs, and spatio-temporal extractions — with one command.
docs: restructure README — Quick Start first, What's New folded to bottom
yifanfeng975337459b5ca6
diff --git a/README.md b/README.mdindex 88b978c..ebe7545 100644--- a/README.md+++ b/README.md@@ -54,47 +54,89 @@<br/></div>-## 📰 What's New+## ⚡ 30-Second Quick Start-<!-- News snippets are derived from the latest merged PRs. Update as new releases land. -->+**1. Install:**-### v0.8.1 / v0.8.2+```bash+# Install uv first (if you haven't)+curl -LsSf https://astral.sh/uv/install.sh | sh-- **🏷️ Source Tags & Scoped Search** — `he tag ./ka/ --source doc-1 --add legal`, then `he search ./ka/ "query" --tag legal` to retrieve only within tagged documents. Works for graph, hypergraph, and set KAs. *(#89, #84)*-- **🛡️ Input Validation** — `he parse` / `he feed` now reject unsupported file types (PDF/Office) with a conversion hint instead of silently ingesting garbage. *(#88)*-- **📦 Document Archive Fix** — re-feeding the same source from a differently-named file no longer accumulates stale copies. *(#89)*+# Install Hyper-Extract CLI+uv tool install hyperextract+# or: pipx install hyperextract+```-### v0.8.0+**2. Configure your provider** (pick one):-- **🔄 Document Upsert** — re-feed an attributed document and its previous version is rolled back automatically: removed facts disappear, shared keys re-merge from surviving sources. *(#84)*-- **📁 Per-File Source Attribution** — `he parse ./docs/` attributes each file by its name automatically; roll back or audit any single file later. An explicit `--source` still overrides.-- **⏱️ Spatiotemporal Provenance** — temporal/spatial/spatio-temporal graphs fully support source attribution and rollback, with deterministic (MERGE_FIELD) replay tests.+**OpenAI:**+```bash+he config init -p openai -k YOUR_OPENAI_API_KEY+```++**Anthropic (Claude):**+```bash+he config llm -p anthropic -k YOUR_ANTHROPIC_API_KEY+he config embedder -p openai -k YOUR_OPENAI_API_KEY+```++**DeepSeek:**+```bash+he config llm -p deepseek -k YOUR_DEEPSEEK_API_KEY+he config embedder -p openai -k YOUR_OPENAI_API_KEY+```++**Bailian (Alibaba Cloud):**+```bash+he config init -p bailian -k YOUR_BAILIAN_API_KEY+```++**Local vLLM:**+```bash+he config llm -p vllm -u http://localhost:8000/v1 -k dummy -m Qwen/Qwen3.5-9B+he config embedder -p vllm -u http://localhost:8001/v1 -k dummy -m BAAI/bge-m3+```++**3. Extract, query & visualize:**++```bash+# Extract knowledge from a document+he parse examples/en/tesla.md -t general/biography_graph -o ./output/ -l en++# Query it+he search ./output/ "What are Tesla's major achievements?"++# Visualize+he show ./output/++# Export to an Obsidian vault (Markdown notes + [[wikilinks]])+he export obsidian ./output/ -o ./vault/+```++> **Which provider should I use?** OpenAI and Bailian provide both LLM and embedding models in one API. Anthropic and DeepSeek are LLM-only (pair them with an OpenAI embedder for search/chat). Local vLLM is free but requires a GPU. DeepSeek is the most cost-effective option (~$0.001-0.005/page vs ~$0.01-0.05/page for OpenAI gpt-4o-mini).<details>-<summary><b>v0.5.0 – v0.7.0</b> — provenance, deletion, incremental index, template validator, GraphML/CSV export</summary>+<summary><b>🐍 Python API</b> (click to expand)</summary>+<br>-- **🗑️ Two-Tier Knowledge Deletion** — hard-delete by key (`he remove --node/--edge`, orphan edges pruned) or remove a single wrong fact via LLM-assisted editing (`he remove --edit-node --fact`), with dry-run, key-invariance checks, and automatic backups. *(#84)*-- **📜 Source Attribution & Provenance** — `he feed --source` / `he parse --source` record each document's raw contributions; `he remove --document` rolls back exactly what one document contributed; `he info --sources` shows the ledger. *(#84)*-- **📈 Incremental Everything** — feed/parse/removal/edit patch the vector index in place (only affected vectors re-embedded); `he feed` skips documents whose content hash is unchanged (`--refeed` to force). *(#84)*-- **🧪 `he template validate`** — catch semantic template errors before paying for LLM calls: 9 diagnostic rules, `--json` for CI, `--all` for directories. *(#77)*-- **📊 GraphML & CSV Export** — desktop graph tools and spreadsheets; hypergraphs get a hyperedges table. *(#85)*-- **🌐 OrcaRouter Provider** — one key for 150+ models via `create_client("orcarouter")`. *(#71)*-- **🔐 Config File Permissions** — `~/.he/config.toml` saved `0600`. *(#86)*-- **🔗 Obsidian wikilink fix** — aliases no longer break on `[ ] | # ^`. *(#87)*-- **🛡️ Chunk-Level Fault Isolation** — one failed chunk no longer discards the rest of a multi-chunk extraction. *(#78)*-- **⚡ MCP Python SDK 2.x** — `he-mcp` works on mcp 1.x and 2.x. *(#72, #82)*-- **🔀 Directed-Edge Fix** — `(source, target)` order preserved; custom endpoint field names. *(#74)*-- **🔑 DeepSeek API Key Fix** — `DEEPSEEK_API_KEY` honored on the OpenAI-compatible path. *(#76)*-- **🎓 Education Templates** — `course_concept_graph` + `curriculum_structure`. *(#80)*-- **🧭 Smaller Fixes** — Graph_RAG.search 3-tuple; `he talk -i --top-k`; onboarding/docs overhaul. *(#70, #73, #57)*+```bash+uv pip install hyperextract+```-</details>+```python+from hyperextract import Template-### Archived+ka = Template.create("general/biography_graph")-See the full changelog in the [GitHub releases](https://github.com/yifanfeng97/hyper-extract/releases).+with open("examples/en/tesla.md") as f:+ result = ka.parse(f.read())++result.show()+```++> 🔗 More examples: [examples/en](./examples/en/)-Hyper-Extract is an intelligent, LLM-powered knowledge extraction and evolution framework. It radically simplifies transforming highly unstructured texts into persistent, predictable, and strongly-typed **Knowledge Abstracts**. It effortlessly extracts information into a wide spectrum of formats—ranging from simple **Collections** (Lists/Sets) and **Pydantic Models**, to complex **Knowledge Graphs**, **Hypergraphs**, and even **Spatio-Temporal Graphs**.+</details>## ✨ Core Features@@ -180,90 +222,6 @@ Hyper-Extract uses LangChain structured output with **function calling**. The mo> 📖 Full guide: [Provider System & Local Model Support](https://yifanfeng97.github.io/Hyper-Extract/latest/concepts/provider-system/)-## ⚡ 30-Second Quick Start--**1. Install:**--```bash-# Install uv first (if you haven't)-curl -LsSf https://astral.sh/uv/install.sh | sh--# Install Hyper-Extract CLI-uv tool install hyperextract-# or: pipx install hyperextract-```--**2. Configure your provider** (pick one):--**OpenAI:**-```bash-he config init -p openai -k YOUR_OPENAI_API_KEY-```--**Anthropic (Claude):**-```bash-he config llm -p anthropic -k YOUR_ANTHROPIC_API_KEY-he config embedder -p openai -k YOUR_OPENAI_API_KEY-```--**DeepSeek:**-```bash-he config llm -p deepseek -k YOUR_DEEPSEEK_API_KEY-he config embedder -p openai -k YOUR_OPENAI_API_KEY-```--**Bailian (Alibaba Cloud):**-```bash-he config init -p bailian -k YOUR_BAILIAN_API_KEY-```--**Local vLLM:**-```bash-he config llm -p vllm -u http://localhost:8000/v1 -k dummy -m Qwen/Qwen3.5-9B-he config embedder -p vllm -u http://localhost:8001/v1 -k dummy -m BAAI/bge-m3-```--**3. Extract, query & visualize:**--```bash-# Extract knowledge from a document-he parse examples/en/tesla.md -t general/biography_graph -o ./output/ -l en--# Query it-he search ./output/ "What are Tesla's major achievements?"--# Visualize-he show ./output/--# Export to an Obsidian vault (Markdown notes + [[wikilinks]])-he export obsidian ./output/ -o ./vault/-```--> **Which provider should I use?** OpenAI and Bailian provide both LLM and embedding models in one API. Anthropic and DeepSeek are LLM-only (pair them with an OpenAI embedder for search/chat). Local vLLM is free but requires a GPU. DeepSeek is the most cost-effective option (~$0.001-0.005/page vs ~$0.01-0.05/page for OpenAI gpt-4o-mini).--<details>-<summary><b>🐍 Python API</b> (click to expand)</summary>-<br>--```bash-uv pip install hyperextract-```--```python-from hyperextract import Template--ka = Template.create("general/biography_graph")--with open("examples/en/tesla.md") as f:- result = ka.parse(f.read())--result.show()-```--> 🔗 More examples: [examples/en](./examples/en/)--</details>-## 📈 Why Hyper-Extract?| Feature | GraphRAG | LightRAG | KG-Gen | ATOM | **Hyper-Extract** |@@ -333,6 +291,46 @@ identifiers:</details>+## 📰 What's New++<!-- News snippets are derived from the latest merged PRs. Update as new releases land. -->++### v0.8.1 / v0.8.2++- **🏷️ Source Tags & Scoped Search** — `he tag ./ka/ --source doc-1 --add legal`, then `he search ./ka/ "query" --tag legal` to retrieve only within tagged documents. Works for graph, hypergraph, and set KAs. *(#89, #84)*+- **🛡️ Input Validation** — `he parse` / `he feed` now reject unsupported file types (PDF/Office) with a conversion hint instead of silently ingesting garbage. *(#88)*+- **📦 Document Archive Fix** — re-feeding the same source from a differently-named file no longer accumulates stale copies. *(#89)*++### v0.8.0++- **🔄 Document Upsert** — re-feed an attributed document and its previous version is rolled back automatically: removed facts disappear, shared keys re-merge from surviving sources. *(#84)*+- **📁 Per-File Source Attribution** — `he parse ./docs/` attributes each file by its name automatically; roll back or audit any single file later. An explicit `--source` still overrides.+- **⏱️ Spatiotemporal Provenance** — temporal/spatial/spatio-temporal graphs fully support source attribution and rollback, with deterministic (MERGE_FIELD) replay tests.++<details>+<summary><b>v0.5.0 – v0.7.0</b> — provenance, deletion, incremental index, template validator, GraphML/CSV export</summary>++- **🗑️ Two-Tier Knowledge Deletion** — hard-delete by key (`he remove --node/--edge`, orphan edges pruned) or remove a single wrong fact via LLM-assisted editing (`he remove --edit-node --fact`), with dry-run, key-invariance checks, and automatic backups. *(#84)*+- **📜 Source Attribution & Provenance** — `he feed --source` / `he parse --source` record each document's raw contributions; `he remove --document` rolls back exactly what one document contributed; `he info --sources` shows the ledger. *(#84)*+- **📈 Incremental Everything** — feed/parse/removal/edit patch the vector index in place (only affected vectors re-embedded); `he feed` skips documents whose content hash is unchanged (`--refeed` to force). *(#84)*+- **🧪 `he template validate`** — catch semantic template errors before paying for LLM calls: 9 diagnostic rules, `--json` for CI, `--all` for directories. *(#77)*+- **📊 GraphML & CSV Export** — desktop graph tools and spreadsheets; hypergraphs get a hyperedges table. *(#85)*+- **🌐 OrcaRouter Provider** — one key for 150+ models via `create_client("orcarouter")`. *(#71)*+- **🔐 Config File Permissions** — `~/.he/config.toml` saved `0600`. *(#86)*+- **🔗 Obsidian wikilink fix** — aliases no longer break on `[ ] | # ^`. *(#87)*+- **🛡️ Chunk-Level Fault Isolation** — one failed chunk no longer discards the rest of a multi-chunk extraction. *(#78)*+- **⚡ MCP Python SDK 2.x** — `he-mcp` works on mcp 1.x and 2.x. *(#72, #82)*+- **🔀 Directed-Edge Fix** — `(source, target)` order preserved; custom endpoint field names. *(#74)*+- **🔑 DeepSeek API Key Fix** — `DEEPSEEK_API_KEY` honored on the OpenAI-compatible path. *(#76)*+- **🎓 Education Templates** — `course_concept_graph` + `curriculum_structure`. *(#80)*+- **🧭 Smaller Fixes** — Graph_RAG.search 3-tuple; `he talk -i --top-k`; onboarding/docs overhaul. *(#70, #73, #57)*++</details>++### Archived++See the full changelog in the [GitHub releases](https://github.com/yifanfeng97/hyper-extract/releases).+## 📚 Documentation & Resources| Resource | Link |diff --git a/README_ZH.md b/README_ZH.mdindex 2f862f4..cfa727c 100644--- a/README_ZH.md+++ b/README_ZH.md@@ -54,47 +54,89 @@<br/></div>-## 📰 最新动态+## ⚡ 30 秒快速上手-<!-- 以下摘要来自最近合并的 PR,随版本更新而更新。 -->+**1. 安装:**-### v0.8.1 / v0.8.2+```bash+# 先安装 uv(如果还没有)+curl -LsSf https://astral.sh/uv/install.sh | sh-- **🏷️ 来源标签与范围检索** — `he tag ./ka/ --source doc-1 --add legal`,然后 `he search ./ka/ "query" --tag legal` 即可只在已标注文档范围内检索。适用于 graph、hypergraph 和 set。*(#89, #84)*-- **🛡️ 输入类型校验** — `he parse` / `he feed` 现在会拒绝不支持的文件类型(PDF/Office)并给出转换提示,而不是静默摄入乱码。*(#88)*-- **📦 文档存档修复** — 同一来源换文件名重喂不再积累陈旧副本。*(#89)*+# 安装 Hyper-Extract CLI+uv tool install hyperextract+# 或:pipx install hyperextract+```-### v0.8.0+**2. 配置你的 provider**(任选其一):-- **🔄 文档级 Upsert** — 重新喂入已标注的文档时自动回滚其旧版本:更新后删掉的事实不再残留,共享 key 从幸存来源重新合并。*(#84)*-- **📁 逐文件来源标注** — `he parse ./docs/` 自动按文件名标注每个文件;之后可单独回滚或审计任意文件。显式 `--source` 仍可覆盖。*(#84)*-- **⏱️ 时空图谱溯源** — 时序/空间/时空图谱完整支持来源标注与回滚,MERGE_FIELD 重放测试保证确定性。*(#84)*+**OpenAI:**+```bash+he config init -p openai -k YOUR_OPENAI_API_KEY+```++**Anthropic (Claude):**+```bash+he config llm -p anthropic -k YOUR_ANTHROPIC_API_KEY+he config embedder -p openai -k YOUR_OPENAI_API_KEY+```++**DeepSeek:**+```bash+he config llm -p deepseek -k YOUR_DEEPSEEK_API_KEY+he config embedder -p openai -k YOUR_OPENAI_API_KEY+```++**百炼(阿里云):**+```bash+he config init -p bailian -k YOUR_BAILIAN_API_KEY+```++**本地 vLLM:**+```bash+he config llm -p vllm -u http://localhost:8000/v1 -k dummy -m Qwen/Qwen3.5-9B+he config embedder -p vllm -u http://localhost:8001/v1 -k dummy -m BAAI/bge-m3+```++**3. 提取、查询与可视化:**++```bash+# 从文档提取知识+he parse examples/zh/sushi.md -t general/biography_graph -o ./output/ -l zh++# 查询+he search ./output/ "苏轼有哪些重要的作品?"++# 可视化+he show ./output/++# 导出为 Obsidian 知识库(Markdown 笔记 + [[双向链接]])+he export obsidian ./output/ -o ./vault/+```++> **该用哪个 provider?** OpenAI 和百炼同时提供 LLM 和 embedding 模型。Anthropic 和 DeepSeek 仅提供 LLM(搜索/聊天功能需搭配 OpenAI 的 embedder)。本地 vLLM 免费但需要 GPU。DeepSeek 最经济(约 $0.001-0.005/页,而 OpenAI gpt-4o-mini 约 $0.01-0.05/页)。<details>-<summary><b>v0.5.0 – v0.7.0</b> — 溯源、删除、增量索引、模板校验、GraphML/CSV 导出</summary>+<summary><b>🐍 Python API</b>(点击展开)</summary>+<br>-- **🗑️ 两级知识删除** — 按 key 硬删除(`he remove --node/--edge`,孤儿边自动清理),或借助大模型移除单条错误事实(`he remove --edit-node --fact`),支持 dry-run、key 不变性校验与自动备份。*(#84)*-- **📜 来源标注与溯源** — `he feed --source` / `he parse --source` 记录每份文档的原始贡献;`he remove --document` 精确回滚单份文档的贡献;`he info --sources` 查看来源账本。*(#84)*-- **📈 全链路增量** — feed/parse/删除/编辑均原地修补向量索引(只重嵌受影响向量);`he feed` 对内容哈希未变的文档自动跳过(`--refeed` 强制重喂)。*(#84)*-- **🧪 `he template validate`** — 在调用大模型前发现模板语义错误:9 条诊断规则、`--json` 接入 CI、`--all` 批量校验。*(#77)*-- **📊 GraphML 与 CSV 导出** — 对接桌面图分析工具与表格软件;超图附带超边表。*(#85)*-- **🌐 OrcaRouter 提供商** — 一个 key 调用 150+ 模型:`create_client("orcarouter")`。*(#71)*-- **🔐 配置文件权限** — `~/.he/config.toml` 以 `0600` 保存。*(#86)*-- **🔗 Obsidian 链接修复** — wikilink 别名不再因 `[ ] | # ^` 断链。*(#87)*-- **🛡️ Chunk 级故障隔离** — 单个 chunk 失败不再丢弃多 chunk 抽取的其余结果。*(#78)*-- **⚡ MCP Python SDK 2.x** — `he-mcp` 同时兼容 mcp 1.x / 2.x。*(#72, #82)*-- **🔀 有向边修复** — 保留 `(source, target)` 方向;支持自定义端点字段名。*(#74)*-- **🔑 DeepSeek API Key 修复** — OpenAI 兼容路径正确读取 `DEEPSEEK_API_KEY`。*(#76)*-- **🎓 教育领域模板** — `course_concept_graph` 与 `curriculum_structure`。*(#80)*-- **🧭 其他修复** — Graph_RAG.search 3-tuple;`he talk -i` 支持 `--top-k`;入门/开发安装/结构化输出文档更新。*(#70, #73, #57)*+```bash+uv pip install hyperextract+```-</details>+```python+from hyperextract import Template-### 更早版本+ka = Template.create("general/biography_graph")-完整更新日志请参阅 [GitHub releases](https://github.com/yifanfeng97/hyper-extract/releases)。+with open("examples/zh/sushi.md") as f:+ result = ka.parse(f.read())++result.show()+```++> 🔗 更多示例:[examples/zh](./examples/zh/)-Hyper-Extract 是一个智能的、由大语言模型(LLM)驱动的知识提取与演进框架。它极大地简化了将杂乱不堪的文本转化为持久化、强类型的**知识摘要(Knowledge Abstracts)**的过程。无论从基础的**集合(Collection/List)和**结构化模型(Model),还是到高阶复杂的**知识图谱(Knowledge Graph)**、**超图(Hypergraph)**,甚至是**时空图谱(Spatio-Temporal Graph)**,它都能轻松拿捏。+</details>## ✨ 核心亮点@@ -180,90 +222,6 @@ Hyper-Extract 通过 LangChain 结构化输出的 **function calling** 方法工> 📖 完整指南:[Provider 系统与本地模型支持](https://yifanfeng97.github.io/Hyper-Extract/latest/zh/concepts/provider-system/)-## ⚡ 30 秒快速上手--**1. 安装:**--```bash-# 先安装 uv(如果还没有)-curl -LsSf https://astral.sh/uv/install.sh | sh--# 安装 Hyper-Extract CLI-uv tool install hyperextract-# 或:pipx install hyperextract-```--**2. 配置你的 provider**(任选其一):--**OpenAI:**-```bash-he config init -p openai -k YOUR_OPENAI_API_KEY-```--**Anthropic (Claude):**-```bash-he config llm -p anthropic -k YOUR_ANTHROPIC_API_KEY-he config embedder -p openai -k YOUR_OPENAI_API_KEY-```--**DeepSeek:**-```bash-he config llm -p deepseek -k YOUR_DEEPSEEK_API_KEY-he config embedder -p openai -k YOUR_OPENAI_API_KEY-```--**百炼(阿里云):**-```bash-he config init -p bailian -k YOUR_BAILIAN_API_KEY-```--**本地 vLLM:**-```bash-he config llm -p vllm -u http://localhost:8000/v1 -k dummy -m Qwen/Qwen3.5-9B-he config embedder -p vllm -u http://localhost:8001/v1 -k dummy -m BAAI/bge-m3-```--**3. 提取、查询与可视化:**--```bash-# 从文档提取知识-he parse examples/zh/sushi.md -t general/biography_graph -o ./output/ -l zh--# 查询-he search ./output/ "苏轼有哪些重要的作品?"--# 可视化-he show ./output/--# 导出为 Obsidian 知识库(Markdown 笔记 + [[双向链接]])-he export obsidian ./output/ -o ./vault/-```--> **该用哪个 provider?** OpenAI 和百炼同时提供 LLM 和 embedding 模型。Anthropic 和 DeepSeek 仅提供 LLM(搜索/聊天功能需搭配 OpenAI 的 embedder)。本地 vLLM 免费但需要 GPU。DeepSeek 最经济(约 $0.001-0.005/页,而 OpenAI gpt-4o-mini 约 $0.01-0.05/页)。--<details>-<summary><b>🐍 Python API</b>(点击展开)</summary>-<br>--```bash-uv pip install hyperextract-```--```python-from hyperextract import Template--ka = Template.create("general/biography_graph")--with open("examples/zh/sushi.md") as f:- result = ka.parse(f.read())--result.show()-```--> 🔗 更多示例:[examples/zh](./examples/zh/)--</details>-## 📈 为什么选择 Hyper-Extract?| 特性 | GraphRAG | LightRAG | KG-Gen | ATOM | **Hyper-Extract** |@@ -333,6 +291,46 @@ identifiers:</details>+## 📰 最新动态++<!-- 以下摘要来自最近合并的 PR,随版本更新而更新。 -->++### v0.8.1 / v0.8.2++- **🏷️ 来源标签与范围检索** — `he tag ./ka/ --source doc-1 --add legal`,然后 `he search ./ka/ "query" --tag legal` 即可只在已标注文档范围内检索。适用于 graph、hypergraph 和 set。*(#89, #84)*+- **🛡️ 输入类型校验** — `he parse` / `he feed` 现在会拒绝不支持的文件类型(PDF/Office)并给出转换提示,而不是静默摄入乱码。*(#88)*+- **📦 文档存档修复** — 同一来源换文件名重喂不再积累陈旧副本。*(#89)*++### v0.8.0++- **🔄 文档级 Upsert** — 重新喂入已标注的文档时自动回滚其旧版本:更新后删掉的事实不再残留,共享 key 从幸存来源重新合并。*(#84)*+- **📁 逐文件来源标注** — `he parse ./docs/` 自动按文件名标注每个文件;之后可单独回滚或审计任意文件。显式 `--source` 仍可覆盖。*(#84)*+- **⏱️ 时空图谱溯源** — 时序/空间/时空图谱完整支持来源标注与回滚,MERGE_FIELD 重放测试保证确定性。*(#84)*++<details>+<summary><b>v0.5.0 – v0.7.0</b> — 溯源、删除、增量索引、模板校验、GraphML/CSV 导出</summary>++- **🗑️ 两级知识删除** — 按 key 硬删除(`he remove --node/--edge`,孤儿边自动清理),或借助大模型移除单条错误事实(`he remove --edit-node --fact`),支持 dry-run、key 不变性校验与自动备份。*(#84)*+- **📜 来源标注与溯源** — `he feed --source` / `he parse --source` 记录每份文档的原始贡献;`he remove --document` 精确回滚单份文档的贡献;`he info --sources` 查看来源账本。*(#84)*+- **📈 全链路增量** — feed/parse/删除/编辑均原地修补向量索引(只重嵌受影响向量);`he feed` 对内容哈希未变的文档自动跳过(`--refeed` 强制重喂)。*(#84)*+- **🧪 `he template validate`** — 在调用大模型前发现模板语义错误:9 条诊断规则、`--json` 接入 CI、`--all` 批量校验。*(#77)*+- **📊 GraphML 与 CSV 导出** — 对接桌面图分析工具与表格软件;超图附带超边表。*(#85)*+- **🌐 OrcaRouter 提供商** — 一个 key 调用 150+ 模型:`create_client("orcarouter")`。*(#71)*+- **🔐 配置文件权限** — `~/.he/config.toml` 以 `0600` 保存。*(#86)*+- **🔗 Obsidian 链接修复** — wikilink 别名不再因 `[ ] | # ^` 断链。*(#87)*+- **🛡️ Chunk 级故障隔离** — 单个 chunk 失败不再丢弃多 chunk 抽取的其余结果。*(#78)*+- **⚡ MCP Python SDK 2.x** — `he-mcp` 同时兼容 mcp 1.x / 2.x。*(#72, #82)*+- **🔀 有向边修复** — 保留 `(source, target)` 方向;支持自定义端点字段名。*(#74)*+- **🔑 DeepSeek API Key 修复** — OpenAI 兼容路径正确读取 `DEEPSEEK_API_KEY`。*(#76)*+- **🎓 教育领域模板** — `course_concept_graph` 与 `curriculum_structure`。*(#80)*+- **🧭 其他修复** — Graph_RAG.search 3-tuple;`he talk -i` 支持 `--top-k`;入门/开发安装/结构化输出文档更新。*(#70, #73, #57)*++</details>++### 更早版本++完整更新日志请参阅 [GitHub releases](https://github.com/yifanfeng97/hyper-extract/releases)。+## 📚 文档与资源| 资源 | 链接 |