前言¶

在 DeepSeek Harness（DSH）裏做地理空間、OSINT 或態勢類工作流時，常見做法是開瀏覽器標籤訪問地球類應用，或在對話裏貼靜態截圖。Agent 難以穩定控制相機、圖層和地圖源，進程與端口也容易和 DSH 主界面脫節。維護者 WilShi 的 @wilshi/dsh-gods-eye-view 把上游 God’s Eye View 以完整形態嵌進 DSH 中央主面板，並提供 Agent 工具、進程託管與國內/國際地圖切換；在目錄 skillhub.cn 中歸類爲工作流。下面介紹其定位、能力與安裝用法。

這是什麼¶

@wilshi/dsh-gods-eye-view 是面向 Cordis/DSH 兼容環境的 npm 插件（當前資料版本 1.0.2，MIT 許可證）。它在 DSH 主面板中運行完整上游應用，而不是簡化地球、瀏覽器標籤或靜態圖。插件負責拉取固定上游 commit、應用 DSH 補丁、本地啓動上游服務，並通過官方視圖協議橋讓 Host 側工具與 Client 主面板協同。

核心功能¶

完整上游能力¶

沿用上游的實景影像、航班、衛星、地震、CCTV、街景、交通、天氣、基礎設施、目標跟蹤、駕駛艙與視覺樣式等模塊，在 DSH 內嵌展示，無獨立瀏覽器標籤、地址欄或分欄外殼。

DSH 側適配¶

• 國內 / 國際：可在 OSM 與 Esri 影像等地圖源之間切換。
• 專注模式：收起 DSH 左側欄，擴大地圖工作區。
• 重新加載：重新載入上游界面。
• 系統瀏覽器打開：適用於語音、下載或複雜 GPU 等更適合系統瀏覽器的場景。
• 狀態提示與進程託管：默認檢查 http://127.0.0.1:4173/，未運行時自動啓動；已有同端口服務會被複用且不會被誤終止，僅插件自啓進程在卸載時結束。

Agent 工具 gods_eye_view¶

Agent 可通過該工具控制相機飛行、圖層、地圖源、視覺樣式、目標跟蹤與地圖標註。視圖請求入隊後異步應用，由上游通過 gev:ready → gev:view → gev:view-applied 一類協議回執確認，而非簡化 mock。

工具參數示例（相機、圖層、樣式、地圖）：

{
  "camera": {
    "lat": 31.2304,
    "lon": 121.4737,
    "altitude_m": 1200000,
    "heading_deg": 0,
    "pitch_deg": -90
  },
  "layers": ["satellites"],
  "style": "normal",
  "map": "esri-imagery"
}

資料還提到支持 follow、annotations 及其他 camera 字段。對 Agent 的自然語言指令示例如：「用上帝視角飛到上海，開啓衛星圖層。」

安全與邊界（簡述）¶

上游默認僅監聽 127.0.0.1；?embed=full 嵌入受 GEV_EMBED_FRAME_ANCESTORS 所限。當前基於 Vite 本地開發服務，不宜直接暴露公網。公開數據可能有延遲或不完整，不應用於導航或應急等安全關鍵決策。

安裝與啓用¶

環境要求¶

• DeepSeek Harness 兼容的 Cordis/插件運行環境。
• Node.js 24.x 或 26.x（package.json 要求 >=24.14.0 <25 || >=26 <27）。
• Git，以及安裝時能訪問 GitHub、npm 與公共數據服務的網絡。

安裝步驟¶

1、在 DSH 插件管理器中安裝包名 @wilshi/dsh-gods-eye-view。若 DSH 提示批准安裝腳本，需允許：腳本僅執行本項目的 scripts/install-upstream.mjs，用於拉取上游、應用 DSH 補丁並運行 npm ci。

2、也可在項目目錄手動安裝：

npm install @wilshi/dsh-gods-eye-view

3、安裝完成後，在 DSH 左側點擊 「上帝視角」。插件會檢查本地 http://127.0.0.1:4173/，未運行則自動啓動上游。

配置¶

默認 cordis.patch.yml 僅設置端口：

port: 4173

可選 upstreamDir、nodePath 用於自定義上游目錄與 Node 24/26 可執行文件；默認上游位於安裝包內 vendor/gods-eye-view（安裝時生成，不隨倉庫提交）。

典型用法¶

1、在主面板內手動切換國內 OSM / 國際 Esri，按需開啓專注模式或重新加載。
2、通過 Agent 調用 gods_eye_view 下發視圖 JSON，等待上游回執。
3、需要系統瀏覽器能力時，使用「系統瀏覽器打開」。

基礎啓動不需要 API Key。Google Photorealistic 3D、Cesium ion 地形、AI 語音、AIS、NASA FIRMS、TomTom 等可選能力，需在上游項目的 POWER UP / Provider Settings 中配置；密鑰勿寫入本倉庫或公開 cordis.patch.yml。

適用場景與注意¶

適合：已在 DSH 中編排 Agent 工作流、需要可編程控制三維地球與多圖層態勢、並希望界面與 Cordis 主面板一體的開發者或分析場景。

注意：

• 插件以當前 DSH/Cordis 進程權限在本地運行；安裝前建議閱讀 GitHub 倉庫 源碼、LICENSE 與 THIRD_PARTY_NOTICES.md，確認與組織安全策略一致。
• 代碼與依賴在本地執行，但 Esri、OSM、Google、Cesium ion、OpenSky、CelesTrak 等仍訪問各自服務商；中國大陸可達性取決於運營商與上游狀態。上游對部分備用源會明確標註「備用」。
• DSH 生態奉行「一切皆插件」；社區目錄站點與 DeepSeek / 幻方無從屬關係，本文不構成官方背書。

結尾¶

@wilshi/dsh-gods-eye-view 的價值在於：把完整 God’s Eye View 納入 DSH 主面板，並用 gods_eye_view 與視圖協議把 Agent 控制落到可驗證的回執上，同時處理端口複用與國內/國際底圖切換。進一步瞭解可訪問目錄頁 skillhub.cn/plugins/WilShi/dsh-gods-eye-view 與倉庫 github.com/WilShi/dsh-gods-eye-view。