前言¶
在 DeepSeek Harness（DSH）的生态中开发智能体时，处理地理数据通常需要手动解析或对接多个外部接口。xby-philippine-geocoding 插件提供了一种标准化的方式，通过模型上下文协议（MCP）直接访问菲律宾标准地理编码（PSGC）API。该插件由 xby-skill 维护，包含完整的菲律宾地理层级数据，能够满足智能体在处理菲律宾地理信息时的查询需求。
核心功能¶
该插件提供了对菲律宾地理层级数据的完整访问能力，主要功能包括：
-
基础层级查询
- 获取岛屿群、地区、省份、城市、市镇、巴朗盖和行政区列表。
- 根据代码获取特定地理实体的详细信息。 -
层级筛选查询
- 按地区获取省份、城市、市镇、巴朗盖。
- 按省份获取城市、市镇、巴朗盖。
- 按城市获取巴朗盖。
- 按行政区获取下属城市、市镇和巴朗盖。 -
辅助功能
- 搜索：通过名称搜索所有层级的地理实体。
- 层级结构：获取特定代码的完整父级层级结构。
- 代码验证：验证地理代码是否存在及其类型。
- API 配置：在聊天中设置 API 密钥，支持自动持久化。
安装与启用¶
安装此插件需要使用 dsh 命令行工具，并指定配置文件（示例中使用 web profile）。
方式一：从 GitHub 安装（推荐）¶
dsh plugin --profile web add github:xby_skill/xby-philippine-geocoding
方式二：从本地目录安装¶
dsh plugin --profile web add /absolute/path/to/xby-philippine-geocoding
获取 API 密钥¶
使用该插件前，需要在聊天中配置 API 密钥。前往小笨羊官网注册并获取密钥，然后在 DSH 会话中执行 set_xby_apikey 命令。
典型用法¶
- 配置密钥
在 DSH 聊天窗口中设置 API 密钥：
set_xby_apikey <your_api_key>
- 搜索地理实体
通过名称搜索特定地点，例如搜索“Metro Manila”：
search_by_name Metro Manila
- 获取层级信息
查询特定代码的完整地理层级：
get_hierarchy <psgc_code>
- 验证代码
验证一个 PSGC 代码是否有效：
validate_code <code>
适用场景与注意事项¶
该插件适合需要精确获取菲律宾地理层级数据（PSGC）的 DSH 智能体开发者。使用时需注意：
- 插件以当前 DSH 进程权限运行，需确保配置文件中已正确设置 API 密钥。
- 安装前建议查看源码以确认符合项目需求。
- 该插件遵循 MIT 许可证。
结语¶
xby-philippine-geocoding 插件为 DeepSeek Harness 生态中的菲律宾地理数据处理提供了标准化的解决方案，开发者无需自行维护复杂的地理数据结构，即可通过 MCP 接口实现精准的地理编码查询。
