添加项目说明文档

This commit is contained in:
PeterZhong 2025-04-27 11:20:52 +08:00
parent 58455ca979
commit a003820952
2 changed files with 72 additions and 1 deletions

View File

@ -37,7 +37,6 @@ namespace LinkToolAddin
/// <returns>False to prevent Pro from closing, otherwise True</returns> /// <returns>False to prevent Pro from closing, otherwise True</returns>
protected override bool CanUnload() protected override bool CanUnload()
{ {
//TODO - add your business logic
//return false to ~cancel~ Application close //return false to ~cancel~ Application close
return true; return true;
} }

72
README.md Normal file
View File

@ -0,0 +1,72 @@
# LinkToolAddin灵图插件
## 介绍
灵图是一个将LLM运用MCP技术与ArcGIS Pro结合的插件该插件实现以下功能
- 以自然语言对话的形式接收用户输入的需求并与模型进行交互
- 根据需要调用ArcGIS Pro地理处理工具的API或者执行arcpy代码实现对地理数据的处理完成用户需求
- 将处理结果以自然语言的形式反馈给用户
## 开发协作
### 首次贡献前准备
本项目为.NET 8.0开发使用C#语言编写使用Visual Studio 2022或Rider 2024及以上进行开发。
协作时需要先拉取主分支代码,通过以下命令进行拉取:
```bash
git clone xxx.git
```
然后在本地创建一个新的分支进行开发,以功能或模块进行命名,请修改下面命令的`branch_name`为你要创建的分支名称:
```bash
git checkout -b branch_name
```
### 开发流程
完成开发后,使用以下命令将代码提交到本地分支,请修改下面命令的`commit message`为你的提交信息,简要说明本次提交修改了什么:
```bash
git add .
git commit -m "your commit message"
```
然后将本地分支推送到远程分支,请修改下面命令的`branch_name`为你要推送的分支名称:
```bash
git push origin branch_name
```
### 提交PR合并请求
在Gitea网站上进入到你的分支页面点击“创建拉取请求”按钮填写PR的标题和描述详细描述本次PR的修改内容选择要合并到的主分支`master`),然后点击“创建拉取请求”按钮。
PR创建后微信群内通报等待其他开发者进行代码审查和合并。审查通过后PR将被合并到主分支。
### 提交要求
1. 确保代码跑的通才提交commit未完成的请通过stage存档不要commit不完整的代码。
2. 勤提交,单个模块提交一次,避免一次性提交过多代码,严禁在一次提交中修改多个模块的代码。
3. 提交消息统一用中文,简要描述本次提交的修改内容。
4. 提交代码前确保代码格式化完成使用VS2022或Rider2024的格式化功能进行格式化严禁提交不格式化的代码。
5. 特殊情况下如需提交测试未通过的代码,请提交到新的分支临时用于协作
## 代码规范
代码命名规范
- 文件命名:使用大驼峰命名法,文件名与类名一致,文件后缀为.cs
- 类命名:使用大驼峰命名法,类名与文件名一致
- 方法命名:使用大驼峰命名法,方法名以动词开头,描述方法的功能
- 变量命名:使用小驼峰命名法,变量名以小写字母开头,描述变量的含义
- 常量命名:使用大驼峰命名法,常量名以大写字母开头,描述常量的含义
代码或文档中待办事项使用`TODO`标记,格式为`// TODO: 待办事项描述`,如:
```csharp
// TODO: 待办事项描述
```