Markdown 知識庫在搜索引擎和生成式引擎中的表現，往往取決於內容的結構化程度和可解釋性。在沒有自動化工具的情況下，進行 SEO（搜索引擎優化）、GEO（生成式引擎優化）和 AEO（答案引擎優化）檢查是一項繁瑣的工作。DeepSeek Harness 提供了插件化能力，dsh-geo 作爲其中的一個 Bundle，將這套優化流程標準化，讓 Agent 可以直接對知識庫進行審計和規劃。
插件定位¶
dsh-geo 是一個 DeepSeek Harness Bundle，由 winyh 維護。它專注於爲 Markdown 知識庫提供可解釋的 SEO、GEO 和 AEO 工具。
該插件屬於「聯網工具」分類，使用 MIT 許可證。它不涉及登錄、表單提交或批量發佈，而是專注於內容審計、元數據檢查和內容大綱生成，幫助開發者將產品語言轉化爲搜索引擎和 AI 引擎能夠理解、信任並引用的內容。
核心功能¶
dsh-geo 主要處理內容發現性和可檢索性，核心能力包括：
- 單筆記審計：對單個 Markdown 筆記進行 SEO、GEO 和 AEO 就緒度檢查。
- 知識庫掃描：掃描整個 Vault，識別元數據缺失、來源缺失、知識結構斷裂、孤立筆記和重複標題。
- 項目報告：在掃描前檢查配置的根目錄，並生成可分享的項目報告。
- 內容大綱：根據查詢意圖、目標受衆、大綱、問題列表和來源缺口，構建內容大綱。
- 全流程工作流：支持從公開網站 URL、公開賬號 URL、Markdown 導出或 HTML 快照直接運行完整工作流。
- 關鍵詞規劃：基於源信號、可選種子詞和 Harness 網絡搜索結果，構建定性關鍵詞計劃（不會憑空編造）。
安裝與啓用¶
安裝前需確保 Node.js 版本滿足要求：
node --version
# 需滿足 ^22.19.0 || >=24.0.0
安裝命令如下。請確保安裝到你實際啓動的 Profile 中。例如，如果你使用 dsh web，則安裝到 web profile；如果你使用 dsh default，則必須安裝到 default，但安裝到 default 不會自動在 web 中啓用。
# 安裝到 web profile
dsh plugin --profile web add github:winyh/dsh-geo
插件已測試兼容 DeepSeek Harness 0.1.5-rc.2。DSH 的 peer 依賴包已鎖定在該測試版本，若使用其他發佈渠道需重新檢查兼容性。
典型用法¶
在 DSH 的多插件協作體系中，dsh-geo 通常作爲內容層介入。啓動跨插件工作流時，可使用以下接口：
# 接收上游任務或進行交接
geo_handoff_receive
如果是通過 GitHub 源碼安裝，需要使用 prepare 腳本來構建入口點。如果遇到 pnpm 構建阻塞，需要在 profile 的 pnpm-workspace.yaml 的 allowBuilds 中添加對應包鍵並重試。爲了可復現性，建議鎖定審查過的 Git 提交。
注意事項¶
- 權限範圍：插件以當前 DSH 進程的權限運行。它不會登錄網站、提交表單或進行批量發帖。
- 私有文件：私有
docs/文件會被排除在 Git 和打包內容之外。 - Profile 邏輯：安裝到
defaultprofile 不會讓插件在webprofile 中生效，必須保持一致。 - 依賴版本：DSH peer 包已鎖定在測試版本，不要混用不同發佈通道的包。
總結¶
dsh-geo 解決了 Markdown 知識庫在 SEO、GEO 和 AEO 方面的工具化落地問題。它通過審計、掃描和內容大綱構建，幫助開發者從產品事實和商業目標出發，生成高質量的、可被引擎檢索和引用的內容資產。對於需要構建可解釋知識庫的開發者，這是一個直接可用的工具集。
更多細節與源碼，可參考 GitHub 倉庫。
