前言¶
在 DSH 里使用外部 agent skill，通常要先确认三件事：skill 包从哪里来、如何被 DSH 发现、运行脚本依赖哪些环境。xuboboo/dsh-grok-geo 提供的是一个 DSH bundle 插件：安装后，DSH 的 skill 工具即可发现并加载 grok-geo，用于对单一品牌做 AI 搜索 / GEO 审计。
DSH 生态强调“一切皆插件”；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。下面按安装、使用和能力边界介绍这个插件。
这是什么¶
xuboboo/dsh-grok-geo 是一个 DSH bundle，维护者为 xuboboo，许可证为 MIT。
它把 grok-geo 以 bundled skill provider 形态注册到 DSH，并随插件分发完整 skill 包。主要面向单一品牌的 AI 搜索 / GEO 审计，覆盖：
- 可见性
- 推荐与引用
- 竞品对比
- 事实准确性
- 内容缺口
已核实的引擎范围包括 17+ 主流 AI 搜索引擎，即 8 个国际 + 9 个中文引擎，例如 ChatGPT / Perplexity / Claude / Gemini / 豆包 / DeepSeek / Kimi / 文心一言…
核心能力¶
dsh-grok-geo 的已核实能力如下：
- 对单一品牌执行 AI 搜索 / GEO 审计：可见性、推荐与引用、竞品对比、事实准确性、内容缺口。
- 支持 17+ 主流 AI 搜索引擎，包括 8 个国际引擎和 9 个中文引擎。
- 以 DSH bundle 插件形态注册 bundled skill provider，并随插件分发完整 skill 包。
- 流水线为：输入收集（Inversion）→ 校验初始化 → 搜索执行 → 指标计算 → 报告渲染 → 质量审查。
- 当
web_search不可用时，自动切换OFFLINE_IMPORT模式。 - 插件本身不依赖 Python；skill 脚本需要 Python 3.11+，仅使用标准库。
- 提供可选 MCP 工具接入示例，可按
mcp__grok_geo__*形式注册进ctx.tools。
安装与启用¶
使用 DSH 安装：
dsh plugin --profile web add "github:xuboboo/dsh-grok-geo"
安装后重启 DSH 生效。进入“设置 → 插件面板”可以查看或卸载该插件。
典型用法¶
在对话中提及 GEO 审计、AI 搜索可见性 / 引用分析等场景时，模型会自动调用该 skill。也可以直接提出任务：
- “对某品牌做一次 GEO 快速审计（quick 模式）”
- “分析我们品牌在 ChatGPT / Perplexity / 豆包 / DeepSeek 里的可见性与引用”
- “对比我们与竞品在 AI 引擎中的推荐表现”
- “做标准模式全量诊断”
如果要单独校验输入示例，可以运行：
python scripts/validate_input.py --input examples/input.minimal.json --output /tmp/normalized.json
这条命令用于读取示例输入，并把规范化结果写入 /tmp/normalized.json。
运行目录默认是 ./geo-audit-runs，也可以用环境变量 GEO_AUDIT_RUNS_DIR 覆盖。
可选 MCP 接入¶
默认形态下，插件以 DSH bundle skill provider 方式提供 grok-geo 能力。如果希望工具以 mcp__grok_geo__* 形式注册进 ctx.tools，可选 MCP 接入示例需要先安装：
dsh plugin --profile web add @deepseek-ai/dsh-mcp-client
适用场景与注意¶
这个插件适合需要检查单一品牌在多个 AI 搜索引擎中表现的场景，例如：
- 检查品牌在 ChatGPT / Perplexity / 豆包 / DeepSeek 等引擎中的可见性
- 分析品牌是否被推荐或被引用
- 对比竞品在 AI 引擎中的推荐表现
- 发现品牌内容在 AI 搜索场景中的缺口
它不适合用于：
- 普通文案
- 泛 SEO 关键词研究
- 社交媒体抓取
- 保证排名
- 内容发布
该插件继承原 skill 的硬规则：绝不编造搜索结果或引用；当 web_search 不可用时，切换 OFFLINE_IMPORT 模式。
由于插件会以当前 DSH 进程权限运行，安装前建议检查源码、许可证，以及上游 skill 的使用边界。
结尾¶
xuboboo/dsh-grok-geo 的价值，是把 grok-geo 品牌 GEO 审计能力以 DSH bundle 插件形式接入，让 DSH 可以直接发现、加载并执行相关 skill。
相关链接：
- GitHub：https://github.com/xuboboo/dsh-grok-geo
- 目录页：已核实资料未给出具体目录页地址；如需在 DSH 社区目录中查找，可搜索
xuboboo/dsh-grok-geo
