前言¶

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

前言¶