> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quanux.org/symphony/llms.txt
> Use this file to discover all available pages before exploring further.

# SHV 引擎：Symphony Hardware Vector 來源與圖形

> SHV 引擎為 CPU、GPU、NIC、記憶體與儲存裝置建立目錄，並提供保留來源重播、需求評估、PDF 擷取，以及 DuckDB 持久圖形。

Symphony Hardware Vector（SHV）引擎會為處理器、CPU 拓撲、快取、GPU、NIC 與光纖介面、主機板、RAM 及 NVMe 建立目錄。預設的策展方式優先處理原始元件與有證據支持的變體。每個引擎都可獨立安裝，且為唯讀。

## 引擎

> [card] shv-engine
>
> 硬體核心：由呼叫者定義的涵蓋範圍、保留來源目錄重播、需求評估與圖形投影。

> [card] shv-source-engine
>
> 硬體證據的來源擷取與修訂版本處理。

> [card] shv-profile-engine
>
> 元件與系統設定檔評估。

> [card] shv-partition-engine
>
> 將已編目的硬體分割，以利可重現的選擇。

> [card] shv-publication-engine
>
> 受治理的本機目錄發布與選擇。

> [card] shv-graph-adapter
>
> 明確的圖形傳輸介面。

> [card] shv-graph-duckdb-connector
>
> 透過 qxctl 管理、以 DuckDB 為後端的持久圖形儲存。

> [card] shv-pdf-adapter
>
> 針對硬體規格書的 PDF 來源解讀。

## 管理重點

* **持久儲存**只能透過 `shv graph store inspect|prepare|commit|status|query|export|schema|template` 管理。使用保留的預期意圖摘要執行 `commit` 同時也是復原操作；沒有另外的復原別名。
* **目錄發布**只能透過 `shv catalogue publication inspect|plan|apply|status|schema|template` 管理。復原方式為 `apply --operation-id`，且與 `--input` 互斥。
* **清查**（0.2 版）新增 `shv graph store inventory`：一種繫結於修訂版本的邏輯讀取，並具有明確保留的寫入者身分。舊版 0.1 的選擇方式仍受支援。

> [!NOTE]
>
> 硬體類別屬於呼叫者對應與設定檔資料，而非重複的指令樹。`--version` 選擇確切的主要擁有者；`--source-version` 與 `--adapter-version` 則指定不同的所選相依項。結構描述與對應的修訂版本是資料身分，而非已安裝引擎版本的別名。

## 相關介面

> [card] [SHV vector](https://docs.quanux.org/symphony/zh-Hant/vectors/shv.md)
>
> 這些引擎所實作的 Hardware Vector 合約。

> [card] [qxctl vector 指令](https://docs.quanux.org/symphony/zh-Hant/qxctl/vector-commands.md)
>
> 完整的 `shv ...` 文法參考。


## Related topics

- [Symphony Vector 與交付階段](https://docs.quanux.org/symphony/zh-Hant/concepts/vectors.md)
- [Symphony Vector 引擎：獨立安裝概觀](https://docs.quanux.org/symphony/zh-Hant/engines/overview.md)
- [SCV 來源知識引擎：Symphony 的供應商實況](https://docs.quanux.org/symphony/zh-Hant/engines/scv-source-engines.md)
- [Symphony 硬體向量：硬體能力知識](https://docs.quanux.org/symphony/zh-Hant/vectors/shv.md)
- [SSFV：Symphony 語意功能向量與登錄檔](https://docs.quanux.org/symphony/zh-Hant/skv/ssfv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.