插件端使用说明

.vscode/settings.json

@@ -2,8 +2,11 @@
     "pasteImage.basePath": "${projectRoot}/assets",
     "pasteImage.defaultName": "x",
     "pasteImage.encodePath": "none",
-    "pasteImage.namePrefix": "img",
-    "pasteImage.insertPattern": "![](${imageFilePath})",
+    "pasteImage.namePrefix": "",
+    "pasteImage.insertPattern": "![](../../assets/${imageFilePath})",
     "pasteImage.path": "${projectRoot}/assets",
-    "pasteImage.prefix": "img"
+    "pasteImage.prefix": "",
+    "markdown.copyFiles.destination": {
+        "**/*.md": "./assets/${documentBaseName}/${fileName}"
+    }
 }

plugin/usage/introduction.md

@@ -2,8 +2,38 @@
 
 ## 简介
 
-介绍插件能干什么、用在哪
+LinkTool插件当前支持ArcGIS Pro 3.4及以上版本，以拓展插件的形式依托ArcGIS Pro强大的地理处理能力和丰富的数据结构兼容性提供智能化的地理处理体验。用户安装LinkTool插件后，只需要在对话面板中输入需求，例如：“我想要统计一下广州市海珠区人口分布与道路等公共设施的匹配情况，以揭示公共设施分布的公平性”，并在项目默认数据库中提供相应的数据，LinkTool就能够自主思考、自主规划、自主完成相应的地理处理任务，例如创建缓冲区、进行叠加分析、栅格分区统计、裁剪、全局空间自相关计算等，并在执行的过程中不断修正错误，最终生成符合用户需要的结果。
+
+## 开发背景
+
+在当前地理信息系统广泛应用的背景下，ArcGIS Pro等平台已具备强大的空间数据处理与分析能力。然而，面对日益复杂的数据结构与分析任务，传统的GIS操作模式在参数配置、工具选择、流程调试等方面仍较为繁琐，对非专业用户或初学者具有一定使用门槛，也不利于高效支持多步骤、多工具组合的综合空间分析流程。
+
+地理信息系统（GIS）技术作为支撑空间决策的核心工具，其功能日益强大且复杂，但专业级平台如ArcGIS Pro的操作门槛与复杂流程，在一定程度上限制了其在教学普及、跨学科应用及效率提升中的发挥。对于非专业用户或初学者而言，掌握其丰富功能集和操作流程存在难度，执行涉及多步骤、多工具组合的高阶空间分析任务时，往往需要投入大量时间进行参数配置与流程调试，而传统的批量化处理方式如模型构建器（Model Builder）和Python脚本接口（如ArcPy），通常要求用户具备一定的脚本编程基础或工具逻辑理解能力，对初学者或非编程背景的使用者来说，学习成本高、调试过程复杂，难以灵活应对实际应用中的多变需求，同时，空间数据处理与分析常涉及多个工具的组合使用和复杂操作流程，面对大批量、多类型数据时，用户需反复执行图层叠加、缓冲区分析等步骤，还可能结合外部工具进行数据整理，进一步加重操作负担，许多非标准化的空间分析任务也依赖人工判断，难以通过传统脚本实现全过程自动化。为此，本项目创新性地开发了基于模型上下文协议（MCP）的ArcGIS Pro大语言模型（LLM）拓展组件，通过自然语言交互简化GIS操作，用户以自然语言表达空间分析需求后，组件可智能识别意图、规划任务，并自主调用ArcGIS Pro工具链完成时空数据分析，实现从需求表达到任务执行的自动化闭环，该组件支持超1450个GIS工具，涵盖矢量、栅格、网络数据的空间分析（如相交、P中值分析、全局空间自相关等），还具备数据统计、可视化及智能问答功能，应用场景广泛覆盖自然资源管理、城市规划等多个领域，为GIS教学与科研提供高效、便捷的创新解决方案。
+
+本项目以“自然语言交互+GIS模型工具链”为核心，旨在解决GIS技术普及与效率提升的痛点，通过深度融合自然语言交互与GIS工具链能力，响应行业智能化转型的需求，展现地理信息科学与人工智能交叉领域的探索潜力。其开发目标明确，一是降低GIS使用门槛，通过自然语言交互替代复杂操作流程，让非专业用户或初学者无需编程基础即可完成高阶空间分析任务；二是提升分析效率，实现空间分析任务的自动化规划与执行，减少重复劳动，解决多工具组合、跨软件协同的操作负担；三是拓展GIS应用场景，覆盖多类型数据处理，支持自然资源管理、城市规划等领域的教学与科研需求，推动GIS技术的普及与智能化转型；四是创新技术融合，通过独特的技术框架探索地理信息科学与人工智能交叉领域的技术潜力，提供具备极强实用性与推广潜力的智能化GIS解决方案。
 
 ## 安装使用
 
-介绍插件如何安装、如何使用，界面交互、按钮功能等
+### 安装方法
+
+LinkTool基于ArcGIS Pro SDK for .NET进行开发，以`esriAddinX`文件的形式提供安装包，用户需要首先安装ArcGIS Pro 3.4或以上版本，并确保软件已获得授权、各项分析功能可用，随后双击esriAddinX文件，点击`确认安装`。
+
+![](../../assets/1752586761378.png)
+
+等待一会儿，软件弹出提示“安装成功”即代表完成安装工作。
+
+![](../../assets/1752586773334.png)
+
+如果没有弹出安装成功的相关提示，可能是此前已安装过LinkTool旧版本，由于ArcGIS Pro的插件安装机制导致偶发性异常情况，需要进入ArcGIS Pro的加载项管理器中卸载旧版本的插件后重新按照上述步骤操作再次安装。
+
+![](../../assets/1752586952054.png)
+
+### 使用方法
+
+安装成功后，进入ArcGIS Pro，打开一个工程项目，通过顶部工具栏的LinkTool标签页，点击`对话面板`按钮，即可在软件右侧打开对话面板。
+
+![](../../assets/1752587131735.png)
+
+随后就可以在软件的对话面板中与智能体对话，提出地理分析的需求，等待其自主完成分析操作。
+
+![](../../assets/1752587266974.png)