# SuperMap-ClientX-AI-context

**Repository Path**: isupermap/supermap-clientx-ai-context

## Basic Information

- **Project Name**: SuperMap-ClientX-AI-context
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-19
- **Last Updated**: 2026-05-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SuperMap ClientX AI Context

<p align="center">
  <img src="https://img.shields.io/badge/3D-WebGIS-green" alt="3D WebGIS">
  <img src="https://img.shields.io/badge/License-MIT-yellow" alt="License">
  <img src="https://img.shields.io/badge/Version-12.1.0-blue" alt="Version">
</p>

## 项目简介

本项目基于 [SuperMap ClientX](https://iclient.supermap.io/) 开发，提供实用的二次开发技巧、功能示例、场景代码，帮助 GIS 开发者快速上手 3D WebGIS 开发。这是一个针对 SDK 开发的提升用户 AI 辅助开发效率的 skills 项目。

**技能标准**：本项目的 skills 遵循 [agentskills.io 规范](https://agentskills.io/specification) 中的标准。

## 功能特性

- 🚀 **快速上手** - 提供丰富的代码示例和最佳实践
- 📚 **开发技巧** - 汇总实用的二次开发技巧
- 🎯 **场景示例** - 覆盖常见 3D WebGIS 应用场景
- 🤖 **AI 辅助** - 提升开发效率的 AI 技能支持


## Skills 技能列表

### ClientX 技能集

| 技能名称 | 功能描述 | 适用场景 |
|---------|---------|---------|
| **clientx-viewer-setup** | Viewer 初始化、Widget、UI 控件配置、Scene 配置、SceneMode | 初始化 ClientX 应用、配置控件、设置渲染模式 |
| **clientx-camera** | 相机定位、flyTo、lookAt、setView、导航约束、实体跟踪 | 相机动画、飞行过渡、视角控制、实体追踪 |
| **clientx-entities** | Entity API、GeoJSON/KML/CZML 加载、16 种 Graphics 类型 | 添加点/标签/模型/多边形、加载地理数据 |
| **clientx-3d-tiles** | 3D Tiles 加载、样式、元数据、体素、点云、裁剪平面 | 加载倾斜摄影、建筑模型、点云数据 |
| **clientx-imagery** | 影像 provider、图层管理、分屏比较 | 添加/交换基础地图、配置影像服务 |
| **clientx-imagery-load** | 各类影像服务加载 | 加载在线/离线影像数据源 |
| **clientx-globe-terrain** | 地形 provider、Globe、大气、天空、光照 | 加载地形服务、配置地球外观 |
| **clientx-primitives** | 高性能静态几何图形、自定义图形、广告牌 | 创建大量静态几何对象 |
| **clientx-materials-shaders** | 材质、后处理特效、泛光、色调映射 | 自定义材质、添加视觉效果 |
| **clientx-interaction** | 用户点击、实体选择、悬停效果、拖动交互 | 实现用户交互功能 |
| **clientx-time-properties** | 时间动态属性、模拟时钟、插值、采样/回调属性 | 创建时间动态效果 |
| **clientx-spatial-math** | 坐标转换、椭球几何、模型矩阵、相交测试 | 空间计算、坐标转换 |
| **clientx-models** | glTF/GLB 模型加载、动画控制 | 加载 3D 模型资源 |
| **clientx-core-utilities** | HTTP 请求、颜色、事件、错误处理 | 核心工具函数 |
| **clientx-vectortilesmap-load** | 矢量瓦片地图加载 | 加载矢量底图服务 |
| **clientx-vectortilsmap-operation** | 矢量瓦片操作、风格布局、查询定位 | 矢量瓦片交互 |
| **clientx-s3mtiles-basic** | S3M 图层基础属性设置 | 配置 S3M 图层参数 |
| **clientx-s3mtiles-load** | 加载各类 S3M 切片数据 | 加载倾斜摄影、精模、BIM、点云 |
| **clientx-s3mtiles-effect** | S3M 图层特效设置 | 添加视觉特效 |
| **clientx-s3mtiles-style** | S3M 图层风格设置 | 自定义图层样式 |
| **clientx-s3mtiles-operation** | S3M 图层裁剪、压平操作 | 空间分析操作 |
| **clientx-s3mtiles-selection** | S3M 图层对象选中 | 对象交互选择 |

### 使用技能

1. **浏览技能文档**：直接查看 `skills/12.1.0/ClientX/{skill-name}/SKILL.md` 文件
2. **复制代码示例**：根据需求复制相应的代码片段到您的项目中
3. **调整参数**：根据实际场景修改配置参数


## MCP 工具

本项目包含 Model Context Protocol (MCP) 工具，用于增强 AI 助手的能力：

- **mcp/supermap-iclientx-mcp-tools/**：MCP 核心工具包
- **mcp/supermap-iclientx-ai-assistant-demo/**：AI 助手演示应用

## 相关资源

- [SuperMap ClientX 官方文档](http://support.supermap.com.cn:8090/webgl/web/index.html)
- [SuperMap ClientX API 参考](http://support.supermap.com.cn:8090/webgl/docs/index.html)
- [SuperMap 官网](https://www.supermap.com/)
- [agentskills.io 规范](https://agentskills.io/specification)



## 开源协议

本项目基于 [MIT](LICENSE) 协议开源。

## 联系方式

如有问题或建议，欢迎通过以下方式联系：

- 提交 Issue
- 发起 Pull Request
- 访问 [SuperMap 技术社区](https://www.supermap.com/community/)

---

<p align="center">
  Made with ❤️ by SuperMap ClientX Community
</p>