前言¶

DeepSeek Harness (DSH) 的核心設計理念是插件化。如果你需要爲智能體接入一個包含特定領域（如共扼譜幾何 CSG）的本地知識庫，無需自行搭建檢索系統或管理向量數據庫，直接安裝 dsh-geometry-knowledge 即可。該插件將知識庫封裝爲 31 個 DSH 原生工具，使 Agent 能直接在對話中檢索原文、驗證公式並管理狀態。

插件簡介¶

dsh-geometry-knowledge 是 Conjugate Spectral Geometry（共扼譜幾何）知識庫插件，由開發者 sdoygb 維護，遵循 MIT 許可證。

其核心能力包括：
* 離線檢索：基於 BM25 算法，包含 251 篇文章全文、4204 個分塊以及 869 條真理記錄。
* 原生工具：提供 31 個 DSH 原生工具（geo_*），覆蓋檢索、驗證、審計與文件操作。
* 符號驗證：支持通過 SymPy 進行嚴格的符號公式驗證。
* 服務複用：同一內核可作爲 MCP 服務供其他客戶端複用。

安裝與配置¶

插件默認零配置，安裝後直接讀取包內 data/ 索引即可使用。

通過 npm 安裝：

    dsh plugin add dsh-geometry-knowledge

或從 GitHub 安裝：

    dsh plugin add github:sdoygb/dsh-geometry-knowledge

若需自定義數據路徑，可在 DSH 的 cordis.patch.yml 中覆蓋配置：

- id: geometry-knowledge
  config:
    dataDir: /absolute/path/to/codex++-data
    sourceArticlesDir: /absolute/path/to/app/articles
    stateDir: /absolute/path/to/.geometry-knowledge
    allowShell: false

核心功能¶

插件主要提供三類能力：離線檢索、深度驗證與狀態管理。

離線檢索與閱讀¶

BM25 檢索：支持對文章分塊（scope=articles）和真理層（scope=truth）進行語義檢索。
文章閱讀：geo_read 工具支持讀取指定文章，可精確定位章節或查看結構摘要。
真理查詢：geo_truth 用於檢索當前有效的真理層，包含永久編號與證明摘要。

深度驗證與審計¶

符號驗證：geo_verify 支持對公式進行符號化簡驗證（需本地安裝 Python 和 SymPy），或進行數值抽樣檢查。
依賴圖審計：geo_claim 可查詢類型化主張依賴圖，分析引用關係與邏輯一致性。
一致性檢查：geo_audit 用於檢測定義衝突、懸空引用及邏輯環。

工作區與狀態管理¶

文件操作：支持對本地項目文件進行列表、讀取（單文件上限 2.5MB）和寫入。
Git 集成：提供 geo_git_* 系列工具，用於提交歷史與狀態管理。
個人庫：支持讀寫個人記憶、情緒及被糾正的錯誤表述。

典型用法¶

以下爲常用命令示例：

# 檢索文章分塊
geo_search "弱混合角"
geo_search "譜剛性" scope=truth

# 讀取文章
geo_read "10.8" section="Strouhal"
geo_read "7.5" whole=true

# 數學計算
geo_calc "57.93+26.16+5.91"
geo_calc "D=10/7821; D*2"

# 公式驗證（需 SymPy）
geo_verify lhs="sin(x)^2+cos(x)^2" rhs="1" variables='["x"]'

注意事項¶

零依賴運行：默認情況下，檢索、閱讀、寫入等核心功能不依賴外部 API 或網絡。
安全限制：geo_shell_execute 禁止讀取 .md 文章或執行高危黑名單命令。
依賴要求：geo_verify 需要本地安裝 Python 和 SymPy 才能進行嚴格符號驗證，否則會報錯。
網絡與權限：geo_web_search 需要外網訪問；geo_chat_history 僅讀取 Open WebUI 的 webui.db（只讀）。

生態定位¶

本插件是 DeepSeek Harness 生態的一部分。DSH 理念是“一切皆插件”，社區目錄提供插件索引，與 DeepSeek 官方無隸屬關係。

附錄¶

源碼地址：https://github.com/sdoygb/dsh-geometry-knowledge
插件目錄：https://www.skillhub.cn/plugins/sdoygb/dsh-geometry-knowledge

dsh-geometry-knowledge

前言¶