change design API doc & interface & simple complete roadmap

Author: Fishicat

milestone1/design-kuro-mod.md

@@ -1,30 +1,66 @@
 # mod设计文档
-`github.com/go-kuro/kuro/mod` 
+
+`github.com/go-kuro/kuro/mod`
 
 ## 目标
-在`kuro build`的过程中，解析go.mod和go.sum文件，获取所有涉及到的包，并加载到内存中
 
-## 流程
-大致流程如下(这里后面找一个图工具)：
-Step 1.命令
-	`kuro build`
+在`kuro build`的过程中，可以通过解析go.mod和go.sum文件，获取所有涉及到的包的物理文件地址(一般为github.com的包地址)，
+方便后续按需加载(暂时不确定是手动加载还是自动加载)
 
-Step 2.绑架`go build`，在`go build`之前，先使用`go mod`流程把所涉及的相关包更新到最新
+## 实现思路
 
-Step 3.根据`go mod`包的逻辑，将go.mod文件中涉及的包，以及go.sum中涉及到的对应包的包版本，下载并倒入到内存
+分两种情况：
+
+第一种 自动解析go.mod和go.sum
+
+Step 1.检查go files，更新一波go.mod和go.sum文件，看下是否有包漏加；有需要的话，进行一次write in mod
+
+Step 2.解析go.mod和go.sum文件；其中，go.mod主要需要解析path，比如`golang.org/x/text`，go.sum主要解析version
+
+Step 3.用得到的path和version生成`[]Version`
 
-## TODO
-1.抽取`go build`中更新go.mod和go.sum的流程，用以更新这两个文件
-2.这里有一个小问题
-```
-	在go build的时候，两个文件中对应的包，应该都已经在内存中了，然后才能很好的参与编译<个人猜想>，否则可能会造成package not find问题
-```
-3.这里提供目前想到的两种实现方式
-```
-	idea 1.截取go build流程中的go mod流程+倒入内存流程
 ```
+type Version struct {
+    Path string
+    Version string `json:",omitempty"`
+}
 ```
-	idea 2.自己根据go mod再造个轮子
+
+Step 4.使用得到的`[]Version`，load对应的包
+
+## API Documentation
+
+参数说明：
+
+`ParseGoMod(cmd kuro.Command, args []string, version *Version)`
+
+   cmd：kuro的命令结构体
+
+   args：kuro的命令参数
+
+   version：是否指定加载某个包的某个版本，为Version结构体的指针
+
+## 接口
+
+粗略的接口实现如下：
+
 ```
+import "cmd/go/internal/modload"
 
+func ParseGoMod(cmd kuro.Command, args []string, version *Version) {
+    // 解析go.mod和go.sum文件得到buildList
+    var buildList []Version
+    if version == nil || version == &Version{} {
+        buildList = modload.LoadBuildList()
+    } else if version.Path != "" {
+        buildList = []Version{
+            {Path:version.Path, Version:version.Version}
+        }
+    } else {
+        throw("...")
+    }
 
+    // 改写modget.runGet函数, 主体流程不变
+    modget.runGet(cmd, args, buildList)
+}
+```