Golang on 我的绕地飞行记录

微信公众号开发指南 - 1

Mon, 15 Jul 2024 17:20:42 +0800

准备一个微信公众号订阅号, 没有的需要先申请一个或者选用测试号. 准备一个服务器, 一个域名.

参考接入指南,开发者需要按照如下步骤完成：

填写服务器配置
验证服务器地址的有效性
依据接口文档实现业务逻辑目前先完成前两步, 后续再进行接口业务开发.

准备工作:

如果使用自己的公众号: 首先登录微信公众号后台, 左栏依次打开 设置与开发-> 基本配置. 在右栏中生成 开发者密码(AppSecret), 并配置服务器IP或调试用机器的IP为 IP白名单. 记下此页面的 开发者ID(AppID), 开发者密码(AppSecret)
使用测试号, 登录测试公众号,记下此页面的 开发者ID(AppID), 开发者密码(AppSecret), 在接口配置信息处填入准备的域名和32位token(通过在线生成工具或其他方法生成)

1 搭建服务器配置消息验证服务

在前文准备工作中, 接口配置信息或基本配置中准备的参考域名为http://xiaoyangge.inith271.top/verify, token为2zeCr3Tco8J8q8s30GjfphpZwBHMFiGz. 现在编写一个web服务用于接收微信的URL验证请求, 请求方式为GET.

这里使用golang 编写一个用于验证服务器URL有效性的web服务, 参数验证逻辑来自微信消息推送-开发者服务器接收消息推送.

package main

import (
	"crypto/sha1"
	"encoding/hex"
	"log"
	"net/http"
	"sort"
	"strings"

	"github.com/gin-gonic/gin"
)

// token由其他工具生成
var token = "AAAAA"

func main() {
	router := gin.Default()

	router.GET("/verify", func(ctx *gin.Context) {
		signature := ctx.Query("signature")
		timestamp := ctx.Query("timestamp")
		nonce := ctx.Query("nonce")
		echostr := ctx.Query("echostr")
		// 验证签名
		tmpArr := []string{token, timestamp, nonce}
		sort.Strings(tmpArr)
		tmpStr := strings.Join(tmpArr, "")
		hasher := sha1.New()
		hasher.Write([]byte(tmpStr))
		hexStr := hex.EncodeToString(hasher.Sum(nil))
		
		if hexStr == signature {
			log.Println("[/]:  the signature is valid")
			// 验证成功返回传入的echoStr字符串
			ctx.String(http.StatusOK, echostr)
			return
		}
		ctx.String(http.StatusOK, "Bad signature")
		log.Println("[/]: Bad signature")
	})

	log.Fatal(router.Run(":8080"))
}

在服务上运行上述服务, 这里运行在8080端口.

构建自己的Kimi Ai终端助手

Fri, 05 Jul 2024 13:58:18 +0800

获取Moonshot API key并配置到环境变量

登录Moonshot AI开放平台, 在API管理 -> 新建 -> 输入key名, 确定-> 复制密钥sk-HL...Ehvcn.

将以下环境变量写入系统环境变量

1
2
3

GPT_BASE_URL=https://api.moonshot.cn/v1
GPT_API_KEY=sk-HLdyzmmUgXQnM5RbhyOBJs0Y5nvPlEdSBa8lWJGZ0GcEhvcn
GPT_MODEL=moonshot-v1-8k

或者写入项目下的.env文件并用github.com/joho/godotenv之类的库进行读取

读取环境变量代码:

// 如果有.env文件, 则导入库 go get -u github.com/joho/godotenv
godotenv.Load()

apiKey := os.Getenv("GPT_API_KEY")
baseUrl := os.Getenv("GPT_BASE_URL")
model := os.Getenv("GPT_MODEL")

使用go-gpt3构建Client

获取go-gpt3库 go get -u github.com/PullRequestInc/go-gpt3, go-gpt3是一个兼容OPEN-AI GPT3 API的开源库. 支持stream和non stream的completion请求.

单轮对话示例

构建gpt3.Client实例

`1`	`client := gpt3.NewClient(apiKey, gpt3.WithBaseURL(baseUrl))`

初始化一个对话, 这里使用moonshot文档提供的prompt

var history []gpt3.ChatCompletionRequestMessage = []gpt3.ChatCompletionRequestMessage{
	{
		Role:    "system",
		Content: "你是 Kimi，由 Moonshot AI 提供的人工智能助手，你更擅长中文和英文的对话。你会为用户提供安全，有帮助，准确的回答。同时，你会拒绝一切涉及恐怖主义，种族歧视，黄色暴力等问题的回答。Moonshot AI 为专有名词，不可翻译成其他语言。",
	},
}

添加一个问题到对话中, moonshoot ai支持的对话Role为system, user, assistant, tool

GRPC Gateway使用示例

Sat, 29 Jun 2024 10:54:55 +0800

gRPC-Gateway使用示例

grpc 相比REST HTTP服务没有默认的速度优势, 但是它提供了一些可选的能提高速度的方式:

选择性消息压缩
负载均衡
等 grpc并不是万能的工具. 比如因为兼容性易维护的等需求, 我想提供一个传统的HTTP/JSON式的API.但是另写一份HTTP/JSON的API服务又是非常耗时的一件事. 社区提出的gRPC-Gateway项目解决了这个问题.

gRPC-Gateway是protoc编译器的一个插件, 它读取protobuf的服务定义并生成一个反向代理服务器, 反向代理会将RESTful HTTP API翻译为gRPC. gRPC-Gateway帮助一次性同时开发HTTP/JSON和gRPC API. 所以gRPC-Gateway的介绍如下:

protobuf编译器的插件
从protobuf中生成代理代码
翻译HTTP/JSON 调用为gRPC

使用示例

创建项目安装工具

mkdir grpc_gateway && cd grpc_gateway 
go mod init grpcgateway

# 安装protoc的插件: go gRPC, gRPC Gateway
go install github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway@latest
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
go install github.com/bufbuild/buf/cmd/buf@v1.28.1

# 安装grpcurl工具
scoop install grpcurl

使用protocol buffers定义helloworld gRPC服务

编辑proto文件