添加项目说明文档
This commit is contained in:
parent
58455ca979
commit
a003820952
@ -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
72
README.md
Normal 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: 待办事项描述
|
||||||
|
```
|
||||||
Loading…
Reference in New Issue
Block a user