Go 语言命令行 AI 对话客户端开发与部署实战

执行后验证返回 go1.23.6 linux/amd64 即表示环境就绪。

云端接入配置

本项目调用 MaaS（Model as a Service）服务接入大模型。这种模式将推理任务托管在云端，客户端仅需轻量级 HTTP 请求。

凭证与端点

访问服务商控制台注册并创建 API Key。这是通信的身份令牌，务必保密，生产环境中建议通过环境变量注入而非硬编码。

选择模型时，通常选用兼容 OpenAI 协议的端点。例如通用接口地址为 https://api.example.com/v1/chat/completions，具体模型 ID 根据服务商文档确定。

核心代码实现

项目采用 Go Modules 管理依赖，结构清晰。

初始化模块

go mod init go_line

go.mod 声明模块名称与锁定版本，确保构建一致性。

数据结构设计

与 API 交互需定义严格对应的 Go 结构体：

type Message struct {
    Role    string `json:"role"`
    Content string `json:"content"`
}

type ChatRequest struct {
    Model  string   `json:"model"`
    Messages []Message `json:"messages"`
}

type ChatResponse struct {
    Choices []struct {
        Message Message `json:"message"`
    } `json:"choices"`
    Error *struct {
        Message string `json:"message"`
    } `json:"error,omitempty"`
}

• Message: 单条对话记录，区分角色与内容。
• ChatRequest: 请求体，包含模型 ID 与完整历史，是实现上下文记忆的关键。
• ChatResponse: 响应体，提取核心回复并处理潜在错误。

网络通信层

封装 HTTP 请求流程，注意资源释放与错误处理：

func chat(history []Message) (string, error) {
    body, err := json.Marshal(ChatRequest{Model: model, Messages: history})
    if err != nil {
        return "", err
    }

    req, err := http.NewRequest("POST", apiURL, bytes.NewReader(body))
    if err != nil {
        return "", err
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer "+apiKey)

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        return "", err
    }
    defer resp.Body.Close()

    raw, err := io.ReadAll(resp.Body)
    if err != nil {
        return "", err
    }

    var cr ChatResponse
    if err := json.Unmarshal(raw, &cr); err != nil {
        return "", fmt.Errorf("parse error: %w\nraw: %s", err, raw)
    }

    if cr.Error != nil {
        return "", fmt.Errorf("API error: %s", cr.Error.Message)
    }
    if len(cr.Choices) == 0 {
        return "", fmt.Errorf("no choices returned")
    }

    return cr.Choices[0].Message.Content, nil
}

这里展示了 Go 处理网络的标准范式：序列化、构建请求、设置鉴权头、读取响应并反序列化。defer 确保连接关闭，防止内存泄漏。

交互控制层

利用 bufio 实现高效输入读取，维护对话状态：

func main() {
    scanner := bufio.NewScanner(os.Stdin)
    var history []Message

    fmt.Println("AI Chat - type 'exit' to quit, 'clear' to reset history")
    fmt.Println("---")

    for {
        fmt.Print("You: ")
        if !scanner.Scan() {
            break
        }
        input := strings.TrimSpace(scanner.Text())

        if input == "" {
            continue
        }
        if input == "exit" {
            fmt.Println("Bye!")
            break
        }
        if input == "clear" {
            history = nil
            fmt.Println("History cleared.")
            continue
        }

        history = append(history, Message{Role: "user", Content: input})
        reply, err := chat(history)
        if err != nil {
            fmt.Fprintf(os.Stderr, "Error: %v\n", err)
            history = history[:len(history)-1]
            continue
        }

        history = append(history, Message{Role: "assistant", Content: reply})
        fmt.Printf("AI: %s\n\n", reply)
    }
}

设计亮点在于上下文管理：history 切片随对话增长，每次请求携带完整历史，让模型理解上下文。鲁棒性方面，网络失败时回滚历史记录，避免污染上下文窗口。

编译与运行

代码完成后，编译为独立二进制文件：

go build -o go_line .
./go_line

Go 是静态编译语言，生成的文件不依赖外部库，具备极强移植性。启动后进入交互模式，输入问题发送至云端，解析结果打印输出，完成从本地到云端的闭环。

程序支持 exit 退出和 clear 清空历史，提升了用户体验。实际运行中，用户输入自然语言，AI 结合上下文给出精准回答，验证了程序连通性与逻辑正确性。