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 仓库。
