前言¶
在 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。
