前言¶
在 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 接口實現精準的地理編碼查詢。
