From 1138aa48e45d8eb7b9e96b26058a884b7dd01073 Mon Sep 17 00:00:00 2001
From: goodliu <zenghao235711@gmail.com>
Date: Mon, 23 Oct 2023 17:27:16 +0800
Subject: [PATCH 01/16] readme: update description of trpc-go to keep it
 concise and clear.

and keep it consistent with PR: https://github.com/avelino/awesome-go/pull/5075
---
 README.md       | 2 +-
 README.zh_CN.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 0d6a52b..0e671ef 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,7 @@ English | [中文](README.zh_CN.md)
 [![Coverage](https://codecov.io/gh/trpc-group/trpc-go/branch/main/graph/badge.svg)](https://app.codecov.io/gh/trpc-group/trpc-go/tree/main)
 
 
-tRPC-Go, as the [Go][] language implementation of [tRPC][], is a battle-tested microservices framework that has been extensively validated in production environments. It not only delivers high performance but also offers ease of use and testability.
+tRPC-Go, is the [Go][] language implementation of [tRPC][], which is a pluggable, high-performance RPC framework.
 
 For more information, please refer to the [quick start guide][quick start] and [detailed documentation][docs].
 
diff --git a/README.zh_CN.md b/README.zh_CN.md
index 2df6b4a..c6bbb84 100644
--- a/README.zh_CN.md
+++ b/README.zh_CN.md
@@ -11,7 +11,7 @@
 [![Coverage](https://codecov.io/gh/trpc-group/trpc-go/branch/main/graph/badge.svg)](https://app.codecov.io/gh/trpc-group/trpc-go/tree/main)
 
 
-tRPC-Go，作为 [tRPC][] 的 [Go][] 语言版本，是经过大规模线上业务使用验证过的微服务框架，它不仅性能高，而且易于使用和测试。
+tRPC-Go，是 [tRPC][] 的 [Go][] 语言实现，它是一个可插拔的高性能 RPC 框架。
 
 更多信息见：[快速上手][quick start] 以及 [详细文档][docs] 
 

From ad4851b3b351b340f07491c2f3b8e2d52fc00c38 Mon Sep 17 00:00:00 2001
From: goodliu <zenghao235711@gmail.com>
Date: Tue, 24 Oct 2023 17:54:37 +0800
Subject: [PATCH 02/16] workflow: add proposal process link for proposal issue
 template

---
 .github/ISSUE_TEMPLATE/03-proposal.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/ISSUE_TEMPLATE/03-proposal.md b/.github/ISSUE_TEMPLATE/03-proposal.md
index 23e5cc1..8602906 100644
--- a/.github/ISSUE_TEMPLATE/03-proposal.md
+++ b/.github/ISSUE_TEMPLATE/03-proposal.md
@@ -7,5 +7,5 @@ labels: Proposal
 
 <!--
 Our proposal process is documented here:
-todo
+https://github.com/trpc-group/trpc/tree/main/proposal
 -->

From bb1f48afa7c918e7b19eacb877e2cfd01006673d Mon Sep 17 00:00:00 2001
From: Longyue Li <longyueli0521@gmail.com>
Date: Fri, 27 Oct 2023 15:38:22 +0800
Subject: [PATCH 03/16] docs: fix label name in 03-proposal.md and add question
 issue template (#125)

update issue template

Signed-off-by: longyue0521 <longyueli0521@gmail.com>
---
 .github/ISSUE_TEMPLATE/02-question.md | 27 +++++++++++++++++++++++++++
 .github/ISSUE_TEMPLATE/03-proposal.md |  2 +-
 2 files changed, 28 insertions(+), 1 deletion(-)
 create mode 100644 .github/ISSUE_TEMPLATE/02-question.md

diff --git a/.github/ISSUE_TEMPLATE/02-question.md b/.github/ISSUE_TEMPLATE/02-question.md
new file mode 100644
index 0000000..2ca4c2a
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/02-question.md
@@ -0,0 +1,27 @@
+---
+name: Questions
+about: questions or inquiries about the project
+title: "question: affected/package: "
+labels: question
+---
+
+### Preliminary Research
+
+<!--
+Please confirm the following before submitting your issue. Thanks!
+-->
+
+- [ ] I have read the project's documentation.
+- [ ] I have searched [existing issues](https://github.com/trpc-group/trpc-go/issues) for similar questions to see if my question has already been addressed.
+
+### Question
+
+<!--
+Ask your question or describe the issue you're facing. Be as clear and concise as possible.
+-->
+
+### Additional Information
+
+<!--
+If applicable, provide any additional information that may help clarify your question or inquiry.
+-->
diff --git a/.github/ISSUE_TEMPLATE/03-proposal.md b/.github/ISSUE_TEMPLATE/03-proposal.md
index 8602906..453d3f8 100644
--- a/.github/ISSUE_TEMPLATE/03-proposal.md
+++ b/.github/ISSUE_TEMPLATE/03-proposal.md
@@ -2,7 +2,7 @@
 name: Proposals
 about: New external API or other notable changes
 title: "proposal: affected/package: "
-labels: Proposal
+labels: proposal
 ---
 
 <!--

From c049a3436ce760915edd134d04cccd3ecaa209b7 Mon Sep 17 00:00:00 2001
From: Longyue Li <longyueli0521@gmail.com>
Date: Sun, 29 Oct 2023 12:14:22 +0800
Subject: [PATCH 04/16] test(healthcheck): fix flaky tests by adding clean up
 operation in watch_test.go file (#126)

fix  flaky test

---------

Signed-off-by: longyue0521 <longyueli0521@gmail.com>
---
 healthcheck/watch_test.go | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/healthcheck/watch_test.go b/healthcheck/watch_test.go
index f9b30d4..db47845 100644
--- a/healthcheck/watch_test.go
+++ b/healthcheck/watch_test.go
@@ -20,13 +20,17 @@ import (
 )
 
 func TestWatch(t *testing.T) {
-	require.Nil(t, watchers["testService"], "testService watcher")
-	Watch("testService", func(status Status) {})
-	require.NotNil(t, watchers["testService"], "testService watcher")
+	serviceName := t.Name()
+	require.Nil(t, watchers[serviceName])
+	Watch(serviceName, func(status Status) {})
+	require.NotNil(t, watchers[serviceName])
+	delete(watchers, serviceName)
 }
 
 func TestGetWatchers(t *testing.T) {
-	Watch("testService", func(status Status) {})
+	serviceName := t.Name()
+	Watch(serviceName, func(status Status) {})
 	ws := GetWatchers()
-	require.NotNil(t, ws["testService"])
+	require.NotNil(t, ws[serviceName])
+	delete(ws, serviceName)
 }

From 487b1ef087c6fd7c6eca548679e7f32c034b5246 Mon Sep 17 00:00:00 2001
From: lbbniu <lbbniu@gmail.com>
Date: Mon, 30 Oct 2023 10:50:19 +0800
Subject: [PATCH 05/16] examples: fix plugin and metadata sample code (#128)

---
 examples/features/metadata/client/main.go |  5 +-
 examples/features/plugin/client_test.go   | 64 +++++++++++------------
 examples/features/plugin/main.go          | 27 ----------
 3 files changed, 35 insertions(+), 61 deletions(-)
 delete mode 100644 examples/features/plugin/main.go

diff --git a/examples/features/metadata/client/main.go b/examples/features/metadata/client/main.go
index cbd1a9c..39b5663 100644
--- a/examples/features/metadata/client/main.go
+++ b/examples/features/metadata/client/main.go
@@ -19,6 +19,7 @@ import (
 	"trpc.group/trpc-go/trpc-go/client"
 	"trpc.group/trpc-go/trpc-go/log"
 	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
+	trpcpb "trpc.group/trpc/trpc-protocol/pb/go/trpc"
 )
 
 func main() {
@@ -29,7 +30,7 @@ func main() {
 
 	// Call SayHello.
 	// Client obtain server metadata by setting a response head of each protocol.
-	helloHead := &trpc.ResponseProtocol{}
+	helloHead := &trpcpb.ResponseProtocol{}
 	sayHelloOpts := []client.Option{
 		client.WithMetaData("key1", []byte("val1")),
 		client.WithMetaData("key2", []byte("val2")),
@@ -44,7 +45,7 @@ func main() {
 	log.Debugf("say hello trans info: key: say-hello-server, val: %s", string(helloHead.TransInfo["say-hello-server"]))
 
 	// Call SayHi.
-	hiHead := &trpc.ResponseProtocol{}
+	hiHead := &trpcpb.ResponseProtocol{}
 	sayHiOpts := []client.Option{
 		client.WithMetaData("key1", []byte("val1")),
 		client.WithMetaData("key2", []byte("val2")),
diff --git a/examples/features/plugin/client_test.go b/examples/features/plugin/client_test.go
index 96a5821..8d8fa3e 100644
--- a/examples/features/plugin/client_test.go
+++ b/examples/features/plugin/client_test.go
@@ -11,57 +11,57 @@
 //
 //
 
-package main
+package plugin
 
 import (
-    "context"
-    "testing"
-    "time"
+	"context"
+	"testing"
+	"time"
 
-    "github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/assert"
 
-    _ "trpc.group/trpc-go/trpc-go"
-    "trpc.group/trpc-go/trpc-go/client"
-    pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
+	_ "trpc.group/trpc-go/trpc-go"
+	"trpc.group/trpc-go/trpc-go/client"
+	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
 )
 
 var addr = "ip://127.0.0.1:8000"
 
 func TestSayHello(t *testing.T) {
 
-    ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-    defer cancel()
+	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
+	defer cancel()
 
-    opts := []client.Option{
-        client.WithTarget(addr),
-    }
+	opts := []client.Option{
+		client.WithTarget(addr),
+	}
 
-    clientProxy := pb.NewGreeterClientProxy(opts...)
+	clientProxy := pb.NewGreeterClientProxy(opts...)
 
-    req := &pb.HelloRequest{
-        Msg: "trpc-go-client",
-    }
+	req := &pb.HelloRequest{
+		Msg: "trpc-go-client",
+	}
 
-    rsp, err := clientProxy.SayHello(ctx, req)
-    t.Log(rsp, err)
-    assert.NotNil(t, err)
+	rsp, err := clientProxy.SayHello(ctx, req)
+	t.Log(rsp, err)
+	assert.NotNil(t, err)
 }
 
 func TestSayHi(t *testing.T) {
 
-    ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-    defer cancel()
+	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
+	defer cancel()
 
-    opts := []client.Option{
-        client.WithTarget(addr),
-    }
+	opts := []client.Option{
+		client.WithTarget(addr),
+	}
 
-    clientProxy := pb.NewGreeterClientProxy(opts...)
+	clientProxy := pb.NewGreeterClientProxy(opts...)
 
-    req := &pb.HelloRequest{
-        Msg: "trpc-go-client",
-    }
-    rsp, err := clientProxy.SayHi(ctx, req)
-    t.Log(rsp, err)
-    assert.NotNil(t, err)
+	req := &pb.HelloRequest{
+		Msg: "trpc-go-client",
+	}
+	rsp, err := clientProxy.SayHi(ctx, req)
+	t.Log(rsp, err)
+	assert.NotNil(t, err)
 }
diff --git a/examples/features/plugin/main.go b/examples/features/plugin/main.go
deleted file mode 100644
index 224e6ec..0000000
--- a/examples/features/plugin/main.go
+++ /dev/null
@@ -1,27 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-// Package main is the main package.
-package main
-
-import (
-    trpc "trpc.group/trpc-go/trpc-go"
-    "trpc.group/trpc-go/trpc-go/examples/features/common"
-    pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-func main() {
-    s := trpc.NewServer()
-    pb.RegisterGreeterService(s, &common.GreeterServerImpl{})
-    s.Serve()
-}

From 369c60d294e61e6649cdc10546021553ef9c101a Mon Sep 17 00:00:00 2001
From: cyhone <cyhone@qq.com>
Date: Mon, 30 Oct 2023 10:52:10 +0800
Subject: [PATCH 06/16] [http, log]: Use errors.New instead of fmt.Errorf
 (#127)

Use erros.New instead of
fmt.Errorf
---------

Co-authored-by: wineandchord <guoqizhou123123@qq.com>
---
 http/transport.go    | 2 +-
 log/log.go           | 4 ++--
 test/service_impl.go | 3 ++-
 3 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/http/transport.go b/http/transport.go
index baaa5c5..b3d9331 100644
--- a/http/transport.go
+++ b/http/transport.go
@@ -201,7 +201,7 @@ func (t *ServerTransport) getListener(network, addr string) (net.Listener, error
 		}
 		ln, ok = pln.(net.Listener)
 		if !ok {
-			return nil, fmt.Errorf("invalid net.Listener")
+			return nil, fmt.Errorf("invalid listener type, want net.Listener, got %T", pln)
 		}
 		return ln, nil
 	}
diff --git a/log/log.go b/log/log.go
index dbb46a6..311dc95 100644
--- a/log/log.go
+++ b/log/log.go
@@ -16,7 +16,7 @@ package log
 
 import (
 	"context"
-	"fmt"
+	"errors"
 	"os"
 
 	"go.uber.org/zap"
@@ -93,7 +93,7 @@ func RedirectStdLogAt(logger Logger, level zapcore.Level) (func(), error) {
 		return zap.RedirectStdLogAt(l.logger, level)
 	}
 
-	return nil, fmt.Errorf("log: only supports redirecting std logs to trpc zap logger")
+	return nil, errors.New("log: only supports redirecting std logs to trpc zap logger")
 }
 
 // Trace logs to TRACE log. Arguments are handled in the manner of fmt.Print.
diff --git a/test/service_impl.go b/test/service_impl.go
index 6d8385b..b3e2d39 100644
--- a/test/service_impl.go
+++ b/test/service_impl.go
@@ -15,6 +15,7 @@ package test
 
 import (
 	"context"
+	"errors"
 	"fmt"
 	"io"
 	"time"
@@ -196,7 +197,7 @@ func newPayload(t testpb.PayloadType, size int32) (*testpb.Payload, error) {
 			Body: make([]byte, size),
 		}, nil
 	case testpb.PayloadType_UNCOMPRESSABLE:
-		return nil, fmt.Errorf("PayloadType UNCOMPRESSABLE is not supported")
+		return nil, errors.New("PayloadType UNCOMPRESSABLE is not supported")
 	default:
 		return nil, errs.New(retUnsupportedPayload, fmt.Sprintf("unsupported payload type: %d", t))
 	}

From d9b904d8e3ddf52565855bd041890695b5ce5ea9 Mon Sep 17 00:00:00 2001
From: Leo <leoyoungxh@gmail.com>
Date: Tue, 31 Oct 2023 17:20:43 +0800
Subject: [PATCH 07/16] {stream,transport}: fix connection overwriting when a
 client uses the same port to connect. (#131)

The server's transport maintains an `addrToConn` map based only on the
client's IP-Port. When a client connects to different ports on the
server using the same local IP-port, it causes the connections in the
server transport's `addrToConn` map to be overwritten, leading to a
"Can't find conn by addr" error in the streaming service.

So now, the combination of the client's IP-Port and the server's IP-Port
is used as the `addrToConn` map key.
---
 codec_stream.go                             | 12 ++--
 codec_stream_test.go                        | 75 +++++++++++++++++++++
 internal/addrutil/addrutil.go               | 12 ++++
 internal/addrutil/addrutil_test.go          | 18 +++++
 stream/server.go                            |  4 ++
 transport/server_transport_stream.go        | 19 +++---
 transport/server_transport_stream_test.go   | 12 ++--
 transport/server_transport_tcp.go           |  5 +-
 transport/tnet/server_transport.go          | 22 +++---
 transport/tnet/server_transport_tcp.go      |  5 +-
 transport/tnet/server_transport_tcp_test.go |  3 +
 11 files changed, 152 insertions(+), 35 deletions(-)
 create mode 100644 internal/addrutil/addrutil.go
 create mode 100644 internal/addrutil/addrutil_test.go

diff --git a/codec_stream.go b/codec_stream.go
index 4d563d6..a7e6bad 100644
--- a/codec_stream.go
+++ b/codec_stream.go
@@ -16,13 +16,13 @@ package trpc
 import (
 	"errors"
 	"fmt"
-	"net"
 	"os"
 	"path"
 	"sync"
 
 	"trpc.group/trpc-go/trpc-go/codec"
 	"trpc.group/trpc-go/trpc-go/errs"
+	"trpc.group/trpc-go/trpc-go/internal/addrutil"
 	icodec "trpc.group/trpc-go/trpc-go/internal/codec"
 	trpcpb "trpc.group/trpc/trpc-protocol/pb/go/trpc"
 
@@ -46,7 +46,7 @@ var (
 
 // NewServerStreamCodec initializes and returns a ServerStreamCodec.
 func NewServerStreamCodec() *ServerStreamCodec {
-	return &ServerStreamCodec{initMetas: make(map[net.Addr]map[uint32]*trpcpb.TrpcStreamInitMeta), m: &sync.RWMutex{}}
+	return &ServerStreamCodec{initMetas: make(map[string]map[uint32]*trpcpb.TrpcStreamInitMeta), m: &sync.RWMutex{}}
 }
 
 // NewClientStreamCodec initializes and returns a ClientStreamCodec.
@@ -58,7 +58,7 @@ func NewClientStreamCodec() *ClientStreamCodec {
 // Used for trpc server streaming codec.
 type ServerStreamCodec struct {
 	m         *sync.RWMutex
-	initMetas map[net.Addr]map[uint32]*trpcpb.TrpcStreamInitMeta // addr->streamID->TrpcStreamInitMeta
+	initMetas map[string]map[uint32]*trpcpb.TrpcStreamInitMeta // addr->streamID->TrpcStreamInitMeta
 }
 
 // ClientStreamCodec is an implementation of codec.Codec.
@@ -372,7 +372,7 @@ func (s *ServerStreamCodec) decodeFeedbackFrame(msg codec.Msg, reqBuf []byte) ([
 // setInitMeta finds the InitMeta and sets the ServerRPCName by the server handler in the InitMeta.
 func (s *ServerStreamCodec) setInitMeta(msg codec.Msg) error {
 	streamID := msg.StreamID()
-	addr := msg.RemoteAddr()
+	addr := addrutil.AddrToKey(msg.LocalAddr(), msg.RemoteAddr())
 	s.m.RLock()
 	defer s.m.RUnlock()
 	if streamIDToInitMeta, ok := s.initMetas[addr]; ok {
@@ -388,7 +388,7 @@ func (s *ServerStreamCodec) setInitMeta(msg codec.Msg) error {
 
 // deleteInitMeta deletes the cached info by msg.
 func (s *ServerStreamCodec) deleteInitMeta(msg codec.Msg) {
-	addr := msg.RemoteAddr()
+	addr := addrutil.AddrToKey(msg.LocalAddr(), msg.RemoteAddr())
 	streamID := msg.StreamID()
 	s.m.Lock()
 	defer s.m.Unlock()
@@ -447,7 +447,7 @@ func (s *ServerStreamCodec) decodeInitFrame(msg codec.Msg, reqBuf []byte) ([]byt
 // storeInitMeta stores the InitMeta every time when a new frame is received.
 func (s *ServerStreamCodec) storeInitMeta(msg codec.Msg, initMeta *trpcpb.TrpcStreamInitMeta) {
 	streamID := msg.StreamID()
-	addr := msg.RemoteAddr()
+	addr := addrutil.AddrToKey(msg.LocalAddr(), msg.RemoteAddr())
 	s.m.Lock()
 	defer s.m.Unlock()
 	if _, ok := s.initMetas[addr]; ok {
diff --git a/codec_stream_test.go b/codec_stream_test.go
index a9c8f79..66b361c 100644
--- a/codec_stream_test.go
+++ b/codec_stream_test.go
@@ -15,6 +15,7 @@ package trpc_test
 
 import (
 	"context"
+	"net"
 	"testing"
 
 	"github.com/stretchr/testify/assert"
@@ -52,6 +53,12 @@ func TestStreamCodecInit(t *testing.T) {
 	msg.WithStreamID(100)
 	msg.WithCallerServiceName("trpc.app.server.service")
 	msg.WithClientRPCName("/trpc.test.helloworld.Greeter/SayHello")
+	laddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10000")
+	assert.Nil(t, err)
+	raddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10001")
+	assert.Nil(t, err)
+	msg.WithLocalAddr(laddr)
+	msg.WithRemoteAddr(raddr)
 	initBuf, err := clientCodec.Encode(msg, nil)
 	assert.Nil(t, err)
 	assert.Equal(t, initResult, initBuf)
@@ -77,6 +84,8 @@ func TestStreamCodecInit(t *testing.T) {
 	// server Decode
 	serverCtx := context.Background()
 	_, serverMsg := codec.WithNewMessage(serverCtx)
+	serverMsg.WithLocalAddr(laddr)
+	serverMsg.WithRemoteAddr(raddr)
 	init, err := serverCodec.Decode(serverMsg, initResult)
 	assert.Nil(t, err)
 	assert.Nil(t, init)
@@ -138,6 +147,12 @@ func TestStreamCodecData(t *testing.T) {
 	// server Decode
 	serverCtx := context.Background()
 	_, serverMsg := codec.WithNewMessage(serverCtx)
+	laddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10000")
+	assert.Nil(t, err)
+	raddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10001")
+	assert.Nil(t, err)
+	serverMsg.WithLocalAddr(laddr)
+	serverMsg.WithRemoteAddr(raddr)
 	init, err := serverCodec.Decode(serverMsg, initResult)
 	assert.Nil(t, err)
 	assert.Nil(t, init)
@@ -162,6 +177,8 @@ func TestStreamCodecData(t *testing.T) {
 	// Server Decode
 	serverCtx = context.Background()
 	_, serverMsg = codec.WithNewMessage(serverCtx)
+	serverMsg.WithLocalAddr(laddr)
+	serverMsg.WithRemoteAddr(raddr)
 	dataDecode, err := serverCodec.Decode(serverMsg, dataResult)
 	assert.Nil(t, err)
 	assert.Equal(t, dataDecode, data)
@@ -170,6 +187,8 @@ func TestStreamCodecData(t *testing.T) {
 	// server Encode
 	ctx = context.Background()
 	_, encodeMsg := codec.WithNewMessage(ctx)
+	encodeMsg.WithLocalAddr(laddr)
+	encodeMsg.WithRemoteAddr(raddr)
 	serverFrameHead := &trpc.FrameHead{
 		FrameType:       uint8(trpcpb.TrpcDataFrameType_TRPC_STREAM_FRAME),
 		StreamFrameType: uint8(trpcpb.TrpcStreamFrameType_TRPC_STREAM_FRAME_DATA),
@@ -223,6 +242,12 @@ func TestStreamCodecClose(t *testing.T) {
 	// server Decode
 	serverCtx := context.Background()
 	_, serverMsg := codec.WithNewMessage(serverCtx)
+	laddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10000")
+	assert.Nil(t, err)
+	raddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10001")
+	assert.Nil(t, err)
+	serverMsg.WithLocalAddr(laddr)
+	serverMsg.WithRemoteAddr(raddr)
 	init, err := serverCodec.Decode(serverMsg, initResult)
 	assert.Nil(t, err)
 	assert.Nil(t, init)
@@ -249,6 +274,8 @@ func TestStreamCodecClose(t *testing.T) {
 	// server Decode Close
 	serverCtx = context.Background()
 	_, serverMsg = codec.WithNewMessage(serverCtx)
+	serverMsg.WithLocalAddr(laddr)
+	serverMsg.WithRemoteAddr(raddr)
 	closeDecode, err := serverCodec.Decode(serverMsg, closeResult)
 	assert.Nil(t, err)
 	assert.Nil(t, closeDecode)
@@ -257,6 +284,8 @@ func TestStreamCodecClose(t *testing.T) {
 	// server encode Close
 	ctx = context.Background()
 	_, encodeMsg := codec.WithNewMessage(ctx)
+	encodeMsg.WithLocalAddr(laddr)
+	encodeMsg.WithRemoteAddr(raddr)
 	serverFrameHead := &trpc.FrameHead{
 		FrameType:       uint8(trpcpb.TrpcDataFrameType_TRPC_STREAM_FRAME),
 		StreamFrameType: uint8(trpcpb.TrpcStreamFrameType_TRPC_STREAM_FRAME_CLOSE),
@@ -277,6 +306,8 @@ func TestStreamCodecClose(t *testing.T) {
 	// Server decode error after encode close
 	serverCtx = context.Background()
 	_, serverMsg = codec.WithNewMessage(serverCtx)
+	serverMsg.WithLocalAddr(laddr)
+	serverMsg.WithRemoteAddr(raddr)
 	closeDecode, err = serverCodec.Decode(serverMsg, closeResult)
 	assert.NotNil(t, err)
 	assert.Nil(t, closeDecode)
@@ -284,6 +315,8 @@ func TestStreamCodecClose(t *testing.T) {
 	// Client decode close
 	clientCtx := context.Background()
 	_, clientMsg := codec.WithNewMessage(clientCtx)
+	clientMsg.WithLocalAddr(laddr)
+	clientMsg.WithRemoteAddr(raddr)
 	CloseRsp, err := clientCodec.Decode(clientMsg, serverEncodeData)
 	assert.Nil(t, err)
 	assert.Nil(t, CloseRsp)
@@ -329,6 +362,12 @@ func TestStreamCodecReset(t *testing.T) {
 	// Server decode Reset
 	serverCtx := context.Background()
 	_, serverMsg := codec.WithNewMessage(serverCtx)
+	laddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10000")
+	assert.Nil(t, err)
+	raddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10001")
+	assert.Nil(t, err)
+	serverMsg.WithLocalAddr(laddr)
+	serverMsg.WithRemoteAddr(raddr)
 	resetDecode, err := serverCodec.Decode(serverMsg, resetResult)
 	assert.Nil(t, err)
 	assert.Nil(t, resetDecode)
@@ -339,6 +378,8 @@ func TestStreamCodecReset(t *testing.T) {
 	// server encode Close
 	ctx = context.Background()
 	_, encodeMsg := codec.WithNewMessage(ctx)
+	encodeMsg.WithLocalAddr(laddr)
+	encodeMsg.WithRemoteAddr(raddr)
 	serverFrameHead := &trpc.FrameHead{
 		FrameType:       uint8(trpcpb.TrpcDataFrameType_TRPC_STREAM_FRAME),
 		StreamFrameType: uint8(trpcpb.TrpcStreamFrameType_TRPC_STREAM_FRAME_CLOSE),
@@ -361,6 +402,8 @@ func TestStreamCodecReset(t *testing.T) {
 	// client Decode reset
 	clientCtx := context.Background()
 	_, clientMsg := codec.WithNewMessage(clientCtx)
+	encodeMsg.WithLocalAddr(laddr)
+	encodeMsg.WithRemoteAddr(raddr)
 	resetRsp, err := clientCodec.Decode(clientMsg, serverEncodeData)
 	assert.Nil(t, err)
 	assert.Nil(t, resetRsp)
@@ -448,6 +491,12 @@ func TestFeedbackFrameType(t *testing.T) {
 	// server Decode
 	serverCtx := context.Background()
 	_, serverMsg := codec.WithNewMessage(serverCtx)
+	laddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10000")
+	assert.Nil(t, err)
+	raddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10001")
+	assert.Nil(t, err)
+	serverMsg.WithLocalAddr(laddr)
+	serverMsg.WithRemoteAddr(raddr)
 	init, err := serverCodec.Decode(serverMsg, initResult)
 	assert.Nil(t, err)
 	assert.Nil(t, init)
@@ -485,6 +534,8 @@ func TestFeedbackFrameType(t *testing.T) {
 	// server Decode  feedback frame
 	serverCtx = context.Background()
 	_, serverMsg = codec.WithNewMessage(serverCtx)
+	serverMsg.WithLocalAddr(laddr)
+	serverMsg.WithRemoteAddr(raddr)
 	dataDecode, err := serverCodec.Decode(serverMsg, encodeData)
 	assert.Nil(t, dataDecode)
 	assert.Nil(t, err)
@@ -529,6 +580,12 @@ func TestDecodeEncodeFail(t *testing.T) {
 	// server Decode
 	serverCtx := context.Background()
 	_, serverMsg := codec.WithNewMessage(serverCtx)
+	laddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10000")
+	assert.Nil(t, err)
+	raddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10001")
+	assert.Nil(t, err)
+	serverMsg.WithLocalAddr(laddr)
+	serverMsg.WithRemoteAddr(raddr)
 	init, err := serverCodec.Decode(serverMsg, initResult)
 	assert.Nil(t, err)
 	assert.Nil(t, init)
@@ -605,6 +662,12 @@ func TestEncodeWithMetadata(t *testing.T) {
 
 	// Server Decode
 	serverCtx, serverMsg := codec.WithNewMessage(context.Background())
+	laddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10000")
+	assert.Nil(t, err)
+	raddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10001")
+	assert.Nil(t, err)
+	serverMsg.WithLocalAddr(laddr)
+	serverMsg.WithRemoteAddr(raddr)
 	initRsp, err := serverCodec.Decode(serverMsg, initResult)
 	assert.Nil(t, err)
 	assert.Nil(t, initRsp)
@@ -644,6 +707,12 @@ func TestEncodeWithDyeing(t *testing.T) {
 
 	// Server Decode
 	serverCtx, serverMsg := codec.WithNewMessage(context.Background())
+	laddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10000")
+	assert.Nil(t, err)
+	raddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10001")
+	assert.Nil(t, err)
+	serverMsg.WithLocalAddr(laddr)
+	serverMsg.WithRemoteAddr(raddr)
 	initRsp, err := serverCodec.Decode(serverMsg, initResult)
 	assert.Nil(t, err)
 	assert.Nil(t, initRsp)
@@ -682,6 +751,12 @@ func TestEncodeWithEnvTransfer(t *testing.T) {
 
 	// Server Decode
 	serverCtx, serverMsg := codec.WithNewMessage(context.Background())
+	laddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10000")
+	assert.Nil(t, err)
+	raddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10001")
+	assert.Nil(t, err)
+	serverMsg.WithLocalAddr(laddr)
+	serverMsg.WithRemoteAddr(raddr)
 	initRsp, err := serverCodec.Decode(serverMsg, initResult)
 	assert.Nil(t, err)
 	assert.Nil(t, initRsp)
diff --git a/internal/addrutil/addrutil.go b/internal/addrutil/addrutil.go
new file mode 100644
index 0000000..108dd85
--- /dev/null
+++ b/internal/addrutil/addrutil.go
@@ -0,0 +1,12 @@
+// Package addrutil provides some utility functions for net address.
+package addrutil
+
+import (
+	"net"
+	"strings"
+)
+
+// AddrToKey combines local and remote address into a string.
+func AddrToKey(local, remote net.Addr) string {
+	return strings.Join([]string{local.Network(), local.String(), remote.String()}, "_")
+}
diff --git a/internal/addrutil/addrutil_test.go b/internal/addrutil/addrutil_test.go
new file mode 100644
index 0000000..8da3489
--- /dev/null
+++ b/internal/addrutil/addrutil_test.go
@@ -0,0 +1,18 @@
+package addrutil_test
+
+import (
+	"net"
+	"testing"
+
+	"github.com/stretchr/testify/require"
+	"trpc.group/trpc-go/trpc-go/internal/addrutil"
+)
+
+func TestAddrToKey(t *testing.T) {
+	laddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10000")
+	require.Nil(t, err)
+	raddr, err := net.ResolveTCPAddr("tcp", "127.0.0.1:10001")
+	require.Nil(t, err)
+	key := addrutil.AddrToKey(laddr, raddr)
+	require.Equal(t, key, laddr.Network()+"_"+laddr.String()+"_"+raddr.String())
+}
diff --git a/stream/server.go b/stream/server.go
index f688214..3e13185 100644
--- a/stream/server.go
+++ b/stream/server.go
@@ -51,6 +51,7 @@ func (s *serverStream) SendMsg(m interface{}) error {
 	msg := codec.Message(s.ctx)
 	ctx, newMsg := codec.WithCloneContextAndMessage(s.ctx)
 	defer codec.PutBackMessage(newMsg)
+	newMsg.WithLocalAddr(msg.LocalAddr())
 	newMsg.WithRemoteAddr(msg.RemoteAddr())
 	newMsg.WithStreamID(s.streamID)
 	// Refer to the pb code generated by trpc.proto, common to each language, automatically generated code.
@@ -164,6 +165,7 @@ func (s *serverStream) CloseSend(closeType, ret int32, message string) error {
 	oldMsg := codec.Message(s.ctx)
 	ctx, msg := codec.WithCloneContextAndMessage(s.ctx)
 	defer codec.PutBackMessage(msg)
+	msg.WithLocalAddr(oldMsg.LocalAddr())
 	msg.WithRemoteAddr(oldMsg.RemoteAddr())
 	msg.WithFrameHead(newFrameHead(trpcpb.TrpcStreamFrameType_TRPC_STREAM_FRAME_CLOSE, s.streamID))
 	msg.WithStreamFrame(&trpcpb.TrpcStreamCloseMeta{
@@ -195,6 +197,7 @@ func (s *serverStream) feedback(w uint32) error {
 	oldMsg := codec.Message(s.ctx)
 	ctx, msg := codec.WithCloneContextAndMessage(s.ctx)
 	defer codec.PutBackMessage(msg)
+	msg.WithLocalAddr(oldMsg.LocalAddr())
 	msg.WithRemoteAddr(oldMsg.RemoteAddr())
 	msg.WithStreamID(s.streamID)
 	msg.WithFrameHead(newFrameHead(trpcpb.TrpcStreamFrameType_TRPC_STREAM_FRAME_FEEDBACK, s.streamID))
@@ -364,6 +367,7 @@ func (sd *streamDispatcher) handleInit(ctx context.Context,
 	// send init response packet.
 	newCtx, newMsg := codec.WithCloneContextAndMessage(ctx)
 	defer codec.PutBackMessage(newMsg)
+	newMsg.WithLocalAddr(msg.LocalAddr())
 	newMsg.WithRemoteAddr(msg.RemoteAddr())
 	newMsg.WithStreamID(streamID)
 	newMsg.WithFrameHead(newFrameHead(trpcpb.TrpcStreamFrameType_TRPC_STREAM_FRAME_INIT, ss.streamID))
diff --git a/transport/server_transport_stream.go b/transport/server_transport_stream.go
index 76cbe5f..02ee58b 100644
--- a/transport/server_transport_stream.go
+++ b/transport/server_transport_stream.go
@@ -16,10 +16,10 @@ package transport
 import (
 	"context"
 	"fmt"
-	"net"
 
 	"trpc.group/trpc-go/trpc-go/codec"
 	"trpc.group/trpc-go/trpc-go/errs"
+	"trpc.group/trpc-go/trpc-go/internal/addrutil"
 )
 
 // serverStreamTransport implements ServerStreamTransport and keeps backward compatibility with the
@@ -36,10 +36,6 @@ func NewServerStreamTransport(opt ...ServerTransportOption) ServerStreamTranspor
 	return &serverStreamTransport{s}
 }
 
-func addrToKey(addr net.Addr) string {
-	return fmt.Sprintf("%s//%s", addr.Network(), addr.String())
-}
-
 // DefaultServerStreamTransport is the default ServerStreamTransport.
 var DefaultServerStreamTransport = NewServerStreamTransport()
 
@@ -52,11 +48,13 @@ func (st *serverStreamTransport) ListenAndServe(ctx context.Context, opts ...Lis
 // Send is the method to send stream messages.
 func (st *serverStreamTransport) Send(ctx context.Context, req []byte) error {
 	msg := codec.Message(ctx)
-	addr := msg.RemoteAddr()
-	if addr == nil {
-		return errs.NewFrameError(errs.RetServerSystemErr, "Remote addr is invalid")
+	raddr := msg.RemoteAddr()
+	laddr := msg.LocalAddr()
+	if raddr == nil || laddr == nil {
+		return errs.NewFrameError(errs.RetServerSystemErr,
+			fmt.Sprintf("Address is invalid, local: %s, remote: %s", laddr, raddr))
 	}
-	key := addrToKey(addr)
+	key := addrutil.AddrToKey(laddr, raddr)
 	st.serverTransport.m.RLock()
 	tc, ok := st.serverTransport.addrToConn[key]
 	st.serverTransport.m.RUnlock()
@@ -74,8 +72,7 @@ func (st *serverStreamTransport) Send(ctx context.Context, req []byte) error {
 // Close closes ServerStreamTransport, it also cleans up cached connections.
 func (st *serverStreamTransport) Close(ctx context.Context) {
 	msg := codec.Message(ctx)
-	addr := msg.RemoteAddr()
-	key := addrToKey(addr)
+	key := addrutil.AddrToKey(msg.LocalAddr(), msg.RemoteAddr())
 	st.m.Lock()
 	delete(st.serverTransport.addrToConn, key)
 	st.m.Unlock()
diff --git a/transport/server_transport_stream_test.go b/transport/server_transport_stream_test.go
index 4ca89c9..514d718 100644
--- a/transport/server_transport_stream_test.go
+++ b/transport/server_transport_stream_test.go
@@ -167,11 +167,12 @@ func TestStreamTCPListenAndServeFail(t *testing.T) {
 
 // TestStreamTCPListenAndServeSend tests listen and send failures.
 func TestStreamTCPListenAndServeSend(t *testing.T) {
+	lnAddr := "127.0.0.1:12016"
 	st := transport.NewServerStreamTransport()
 	go func() {
 		err := st.ListenAndServe(context.Background(),
 			transport.WithListenNetwork("tcp"),
-			transport.WithListenAddress(":12016"),
+			transport.WithListenAddress(lnAddr),
 			transport.WithHandler(&echoStreamHandler{}),
 			transport.WithServerFramerBuilder(&multiplexedFramerBuilder{}),
 		)
@@ -203,13 +204,16 @@ func TestStreamTCPListenAndServeSend(t *testing.T) {
 	port := getFreeAddr("tcp")
 	la := "127.0.0.1" + port
 	ct := transport.NewClientStreamTransport()
-	err = ct.Init(ctx, transport.WithDialNetwork("tcp"), transport.WithDialAddress(":12016"),
+	err = ct.Init(ctx, transport.WithDialNetwork("tcp"), transport.WithDialAddress(lnAddr),
 		transport.WithClientFramerBuilder(fb), transport.WithMsg(msg), transport.WithLocalAddr(la))
 	assert.Nil(t, err)
 	time.Sleep(100 * time.Millisecond)
-	addr, err := net.ResolveTCPAddr("tcp", la)
+	raddr, err := net.ResolveTCPAddr("tcp", la)
 	assert.Nil(t, err)
-	msg.WithRemoteAddr(addr)
+	laddr, err := net.ResolveTCPAddr("tcp", lnAddr)
+	assert.Nil(t, err)
+	msg.WithRemoteAddr(raddr)
+	msg.WithLocalAddr(laddr)
 	err = st.Send(ctx, reqData)
 	assert.Nil(t, err)
 }
diff --git a/transport/server_transport_tcp.go b/transport/server_transport_tcp.go
index a82815f..ec91715 100644
--- a/transport/server_transport_tcp.go
+++ b/transport/server_transport_tcp.go
@@ -26,6 +26,7 @@ import (
 
 	"trpc.group/trpc-go/trpc-go/codec"
 	"trpc.group/trpc-go/trpc-go/errs"
+	"trpc.group/trpc-go/trpc-go/internal/addrutil"
 	"trpc.group/trpc-go/trpc-go/internal/report"
 	"trpc.group/trpc-go/trpc-go/internal/writev"
 	"trpc.group/trpc-go/trpc-go/log"
@@ -148,7 +149,7 @@ func (s *serverTransport) serveTCP(ctx context.Context, ln net.Listener, opts *L
 		// To avoid over writing packages, checks whether should we copy packages by Framer and
 		// some other configurations.
 		tc.copyFrame = frame.ShouldCopy(opts.CopyFrame, tc.serverAsync, codec.IsSafeFramer(tc.fr))
-		key := addrToKey(tc.remoteAddr)
+		key := addrutil.AddrToKey(tc.localAddr, tc.remoteAddr)
 		s.m.Lock()
 		s.addrToConn[key] = tc
 		s.m.Unlock()
@@ -210,7 +211,7 @@ func (c *tcpconn) close() {
 		}
 
 		// Remove cache in server stream transport.
-		key := addrToKey(c.remoteAddr)
+		key := addrutil.AddrToKey(c.localAddr, c.remoteAddr)
 		c.st.m.Lock()
 		delete(c.st.addrToConn, key)
 		c.st.m.Unlock()
diff --git a/transport/tnet/server_transport.go b/transport/tnet/server_transport.go
index 61a7c61..08ed2fe 100644
--- a/transport/tnet/server_transport.go
+++ b/transport/tnet/server_transport.go
@@ -21,7 +21,6 @@ import (
 	"context"
 	"errors"
 	"fmt"
-	"net"
 	"strings"
 	"sync"
 
@@ -29,6 +28,7 @@ import (
 
 	"trpc.group/trpc-go/trpc-go/codec"
 	"trpc.group/trpc-go/trpc-go/errs"
+	"trpc.group/trpc-go/trpc-go/internal/addrutil"
 	"trpc.group/trpc-go/trpc-go/log"
 	"trpc.group/trpc-go/trpc-go/transport"
 )
@@ -79,11 +79,14 @@ func (s *serverTransport) ListenAndServe(ctx context.Context, opts ...transport.
 
 // Send implements ServerStreamTransport, sends stream messages.
 func (s *serverTransport) Send(ctx context.Context, req []byte) error {
-	addr := codec.Message(ctx).RemoteAddr()
-	if addr == nil {
-		return errs.NewFrameError(errs.RetServerSystemErr, "remote addr is invalid")
+	msg := codec.Message(ctx)
+	raddr := msg.RemoteAddr()
+	laddr := msg.LocalAddr()
+	if raddr == nil || laddr == nil {
+		return errs.NewFrameError(errs.RetServerSystemErr,
+			fmt.Sprintf("Address is invalid, local: %s, remote: %s", laddr, raddr))
 	}
-	tc, ok := s.loadConn(addrToKey(addr))
+	tc, ok := s.loadConn(addrutil.AddrToKey(laddr, raddr))
 	if !ok {
 		return errs.NewFrameError(errs.RetServerSystemErr, "can't find conn by addr")
 	}
@@ -97,7 +100,10 @@ func (s *serverTransport) Send(ctx context.Context, req []byte) error {
 
 // Close closes transport, and cleans up cached connections.
 func (s *serverTransport) Close(ctx context.Context) {
-	s.deleteConn(addrToKey(codec.Message(ctx).RemoteAddr()))
+	msg := codec.Message(ctx)
+	raddr := msg.RemoteAddr()
+	laddr := msg.LocalAddr()
+	s.deleteConn(addrutil.AddrToKey(laddr, raddr))
 }
 
 func (s *serverTransport) switchNetworkToServe(ctx context.Context, opts *transport.ListenServeOptions) error {
@@ -141,7 +147,3 @@ func buildListenServeOptions(opts ...transport.ListenServeOption) (*transport.Li
 	}
 	return lsOpts, nil
 }
-
-func addrToKey(addr net.Addr) string {
-	return fmt.Sprintf("%s//%s", addr.Network(), addr.String())
-}
diff --git a/transport/tnet/server_transport_tcp.go b/transport/tnet/server_transport_tcp.go
index 33425db..ec5ab4f 100644
--- a/transport/tnet/server_transport_tcp.go
+++ b/transport/tnet/server_transport_tcp.go
@@ -34,6 +34,7 @@ import (
 
 	"trpc.group/trpc-go/trpc-go/codec"
 	"trpc.group/trpc-go/trpc-go/errs"
+	"trpc.group/trpc-go/trpc-go/internal/addrutil"
 	"trpc.group/trpc-go/trpc-go/internal/report"
 	intertls "trpc.group/trpc-go/trpc-go/internal/tls"
 	"trpc.group/trpc-go/trpc-go/log"
@@ -232,7 +233,7 @@ func (s *serverTransport) onConnOpened(conn net.Conn, pool *ants.PoolWithFunc,
 	// To avoid overwriting packets, check whether we should copy packages by Framer and some other configurations.
 	tc.copyFrame = frame.ShouldCopy(opts.CopyFrame, tc.serverAsync, codec.IsSafeFramer(tc.framer))
 
-	s.storeConn(addrToKey(conn.RemoteAddr()), tc)
+	s.storeConn(addrutil.AddrToKey(conn.LocalAddr(), conn.RemoteAddr()), tc)
 	return tc
 }
 
@@ -255,7 +256,7 @@ func (s *serverTransport) onConnClosed(conn net.Conn, handler transport.Handler)
 	}
 
 	// Release the connection resources stored on the transport.
-	s.deleteConn(addrToKey(conn.RemoteAddr()))
+	s.deleteConn(addrutil.AddrToKey(conn.LocalAddr(), conn.RemoteAddr()))
 }
 
 func handleTCP(conn interface{}) error {
diff --git a/transport/tnet/server_transport_tcp_test.go b/transport/tnet/server_transport_tcp_test.go
index 0aa566e..92499ca 100644
--- a/transport/tnet/server_transport_tcp_test.go
+++ b/transport/tnet/server_transport_tcp_test.go
@@ -286,6 +286,9 @@ func TestServerTCP_SendAndClose(t *testing.T) {
 	assert.True(t, ok)
 	ctx, msg := codec.EnsureMessage(context.Background())
 	msg.WithRemoteAddr(cliAddr)
+	svrAddr, err := net.ResolveTCPAddr("tcp", addr)
+	assert.Nil(t, err)
+	msg.WithLocalAddr(svrAddr)
 	err = streamTransport.Send(ctx, helloWorld)
 	assert.Nil(t, err)
 

From abb4c612c10db83686836e87677dbfcf97668369 Mon Sep 17 00:00:00 2001
From: goodliu <zenghao235711@gmail.com>
Date: Wed, 1 Nov 2023 11:17:13 +0800
Subject: [PATCH 08/16] workflow: add pull request template (#130)

---
 .github/PULL_REQUEST_TEMPLATE.md | 13 +++++++++++++
 CONTRIBUTING.md                  |  3 +++
 CONTRIBUTING.zh_CN.md            |  3 +++
 3 files changed, 19 insertions(+)
 create mode 100644 .github/PULL_REQUEST_TEMPLATE.md

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 0000000..ffa153f
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,13 @@
+Thanks for your PR, you're awesome! 👍
+
+Please ensure you have read the [Contributing code](https://github.com/trpc-group/trpc-go/blob/main/CONTRIBUTING.md#contributing-code). 
+
+The PR title should be formatted as follows: `client: remove internal info`
+  - The package name goes before the colon
+  - The part after the colon uses the verb tense + phrase that completes the blank in,
+    "This change modifies tRPC-Go to ___________"
+  - Lowercase verb after the colon
+  - No trailing period
+  - Keep the title as short as possible. ideally under 76 characters or shorter.
+
+Delete these instructions once you have read and applied them.
\ No newline at end of file
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index c993577..1c45e00 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -99,6 +99,9 @@ The [benchstat](https://godoc.org/golang.org/x/perf/cmd/benchstat) tool is conve
 The special notation "Fixes #12345" associates the change with issue 12345 in the tRPC-Go issue tracker.
 When this change is eventually applied, the issue tracker will automatically mark the issue as fixed.
 
+- If there is a corresponding issue, add either `Fixes #12345` or `Updates #12345` (the latter if this is not a complete fix) to this comment
+- If referring to a repo other than `trpc-go` you can use the `owner/repo#issue_number` syntax: `Fixes trpc-group/tnet#12345`
+
 
 ## Miscellaneous topics
 
diff --git a/CONTRIBUTING.zh_CN.md b/CONTRIBUTING.zh_CN.md
index 0b11100..5e658fd 100644
--- a/CONTRIBUTING.zh_CN.md
+++ b/CONTRIBUTING.zh_CN.md
@@ -91,6 +91,9 @@ tRPC-Go 中的提交消息遵循一套特定的约定，我们将在本节中讨
 特殊表示法 "Fixes #12345" 将变更与 tRPC-Go issue 跟踪器中的 issue 12345关联。
 当此变更最终应用时，issue 跟踪器将自动将该 issue 标记为已修复。
 
+- 如果有相关 issue，请在此评论中添加 `Fixes #12345` 或` Updates #12345`（如果这不是完整的修复）
+- 如果涉及到的仓库不是 `trpc-go`，则可以使用 `owner/repo#issue_number` 语法：`Fixes trpc-group/tnet#12345`
+
 ## 其他主题
 
 ### 版权声明

From d36d5d5f4f1c2a2ed2e5189a5542ff241a8fea85 Mon Sep 17 00:00:00 2001
From: Rick <1450685+LinuxSuRen@users.noreply.github.com>
Date: Wed, 1 Nov 2023 14:18:36 +0800
Subject: [PATCH 09/16] doc: a guide about how to use api-testing to try tRPC
 (#129)

close https://github.com/trpc-group/trpc-go/issues/100

@WineChord gives me a very big help. Thanks for that.

---------

Co-authored-by: Rick <linuxsuren@users.noreply.github.com>
Co-authored-by: wineandchord <guoqizhou123123@qq.com>
---
 docs/README.md                   | 1 +
 docs/README.zh_CN.md             | 1 +
 docs/user_guide/testing.md       | 9 +++++++++
 docs/user_guide/testing.zh_CN.md | 9 +++++++++
 4 files changed, 20 insertions(+)
 create mode 100644 docs/user_guide/testing.md
 create mode 100644 docs/user_guide/testing.zh_CN.md

diff --git a/docs/README.md b/docs/README.md
index 62d3991..8b75e50 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -27,6 +27,7 @@ English | [中文](README.zh_CN.md)
   - [High Performance Network Package tnet](/docs/user_guide/tnet.md)
   - [Track Running Status](/rpcz/README.md)
   - [Attachment (Big Binary Data) Transfer](/docs/user_guide/attachment.md)
+  - [Testing](/docs/user_guide/testing.md)
 - Developer Guide
   - Plugin Development
     - [Plugin Overview](/plugin/README.md)
diff --git a/docs/README.zh_CN.md b/docs/README.zh_CN.md
index 5d9c310..058fdf1 100644
--- a/docs/README.zh_CN.md
+++ b/docs/README.zh_CN.md
@@ -27,6 +27,7 @@
   - [高性能网络库 tnet](/docs/user_guide/tnet.zh_CN.md)
   - [运行状态追踪](/rpcz/README.zh_CN.md)
   - [附件（大二进制数据）传输](/docs/user_guide/attachment.zh_CN.md)
+  - [测试](/docs/user_guide/testing.zh_CN.md)
 - 开发指南
   - 插件开发
     - [插件向导](/plugin/README.zh_CN.md)
diff --git a/docs/user_guide/testing.md b/docs/user_guide/testing.md
new file mode 100644
index 0000000..ea22616
--- /dev/null
+++ b/docs/user_guide/testing.md
@@ -0,0 +1,9 @@
+# tRPC-Go Testing
+
+Interface testing refers to the process in which, after the service has successfully started, verification is carried out by sending packets.
+
+## Tools
+
+* [trpc-cli](TODO)
+* [api-testing](https://github.com/linuxsuren/api-testing)
+* [eab](TODO)
diff --git a/docs/user_guide/testing.zh_CN.md b/docs/user_guide/testing.zh_CN.md
new file mode 100644
index 0000000..b6b128d
--- /dev/null
+++ b/docs/user_guide/testing.zh_CN.md
@@ -0,0 +1,9 @@
+# tRPC-Go Testing
+
+接口测试是指服务启动成功后，通过发送报文进行验证的过程。
+
+## 工具
+
+* [trpc-cli](TODO)
+* [api-testing](https://github.com/linuxsuren/api-testing)
+* [eab](TODO)

From da0e38e29aaca96a5194bd838287e4a62c2f179f Mon Sep 17 00:00:00 2001
From: goodliu <zenghao235711@gmail.com>
Date: Wed, 1 Nov 2023 14:28:33 +0800
Subject: [PATCH 10/16] workflow: add coverage check configuration (#114)

---
 .github/codecov.yaml | 12 ++++++++++++
 1 file changed, 12 insertions(+)
 create mode 100644 .github/codecov.yaml

diff --git a/.github/codecov.yaml b/.github/codecov.yaml
new file mode 100644
index 0000000..2550cad
--- /dev/null
+++ b/.github/codecov.yaml
@@ -0,0 +1,12 @@
+coverage: # https://docs.codecov.com/docs/codecovyml-reference#coverage
+  precision: 5
+  range:
+    - 85.0
+    - 90.0
+  status:
+    project:
+      default:
+        branches:
+          - ^main$
+        target: 85.0 # the minimum coverage ratio that the commit must meet to be considered a success.
+        threshold: 1% # allow the coverage to drop by X%, and posting a success status.

From 37d200816b47be2af466a633467ac91c538e0326 Mon Sep 17 00:00:00 2001
From: goodliu <zenghao235711@gmail.com>
Date: Sat, 4 Nov 2023 13:58:45 +0800
Subject: [PATCH 11/16] test: add English version of README document (#133)

---
 test/README.md       | 241 ++++++++++++++++++++-----------------
 test/README.zh_CN.md | 274 +++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 406 insertions(+), 109 deletions(-)
 create mode 100644 test/README.zh_CN.md

diff --git a/test/README.md b/test/README.md
index a15f9bc..b134a5f 100644
--- a/test/README.md
+++ b/test/README.md
@@ -1,37 +1,48 @@
-# 如何在 tRPC-Go 中添加集成测试用例
+English | [中文](README.zh_CN.md)
 
-## 什么时候该添加集成测试用例
+# How to add integration test cases in tRPC-Go
 
-测试用例可以从 Test Size 和 Test Scope 两个维度进行划分，按 Test Size 从小到大划分，包含小型测试，中型测试和大型测试；按 Test Scope 从小到大划分，包含单元测试，集成测试和系统测试。测试用例的维度越大，运行时需要的 CPU，IO，网络，内存等资源越多，运行速度越慢，得到的运行结果也越不可靠 [1]。对于一个系统来说，这几种测试的占比在软件工程实践中，存在如下一个测试金字塔 [2] 的粗略指导性原则，维度越低的测试用例占比应该越高。
+## When to add integration test cases
 
-```
-        .                 系统测试 5%
-       ...                集成测试 15%
-................          单元测试 80%
+Test cases can be divided into two dimensions: Test Size and Test Scope.
+Test Size is divided into small, medium, and large tests; Test Scope is divided into unit tests, integration tests, and system tests.
+The larger the dimension of the test case, the more CPU, IO, network, memory, and other resources are required during runtime, the slower the running speed, and the less reliable the obtained running results [1].
+For a system, there is a rough guiding principle of the test pyramid [2] in software engineering practice, where the lower the dimension of the test case, the higher the proportion.
+
+```text
+        .                 System Test 5%
+       ...                Integration Test 15%
+................          Unit Test 80%
 ```
 
-**因此在 tRPC-Go 中也建议尽量编写小维度的小型测试和单元测试**。以下场景可能需要添加集成测试用例：
+**Therefore, it is also recommended to write small-dimension small tests and unit tests in tRPC-Go.** 
+The following scenarios may require adding integration test cases:
 
-1. 需要使用到多进程的情况，例如测试 server 的优雅重启，可以仿照 `graceful_restart_test.go` 中的实现。
-2. 需要创建 client 来访问一个真实 server [^1] 提供的服务来验证功能的场景，根据 server 提供的服务类型的不同，可仿照 `trpc_test.go`、 `http_test.go`、`restful_test.go` 和`streaming_test.go`。
+- Scenarios requiring multiple processes, such as testing the graceful restart of the server, can refer to the implementation in `graceful_restart_test.go`.
+- Scenarios where a client needs to access services provided by a real server [^1] to verify functionality. 
+Depending on the type of service provided by the server, you can refer to `trpc_test.go`, `http_test.go`, `restful_test.go`, and `streaming_test.go`.
 
-[^1]: tRPC-Go 的集成测试网络调用只使用了 localhost 网络，同时整个测试只能运行在单机上。
+[^1] The integration test network calls in tRPC-Go only use the localhost network, and the entire test can only run on a single machine.
 
-## 测试代码的组织形式
+## Test code organization
 
-### 平铺
+### Flat
 
-Go 语言内置 `go test` 命令，该命令会运行 `_test.go` 文件中符合 `TestXXX` 命名规则的函数，进而实现测试代码的执行。因为 `go test` 并没有对测试代码的组织形式提出任何约束条件，所以现有很多测试代码都采用了十分简单的“平铺”组织。这种“平铺”的代码组织形式优点是每个测试函数都是互不相关的，在代码结构上没有额外的抽象，上手非常容易。然而， “平铺”并不适用于 tRPC-Go 的集成测试，因为  tRPC-Go 的集成测试存在以下特点：
+Go language has a built-in `go test` command, which runs functions with the `TestXXX` naming rule in `_test.go` files, thus executing test code. 
+Since go test does not impose any constraints on the organization of test code, many existing test codes use a very simple "flat" organization.
+The advantage of this "flat" code organization is that each test function is unrelated, there is no additional abstraction in the code structure, and it is very easy to get started.
+However, "flat" is not suitable for tRPC-Go's integration testing because tRPC-Go's integration testing has the following characteristics:
 
-1. 会测试各种用户使用场景，存在大量的测试用例，“平铺”由于没有层次感，代码就会显得比较混乱；
-2. 多个测试用例在概念上可能是相关的，如都是针对 tRPC-Go 数据透传的测试，应该把这些用例组织在一起；
-3. 几乎每个测试用例前都需要在存在某个 server 的特定环境中执行，且在用例执行完后需要清理资源（主要是关闭启动的 server），应该把这些共有逻辑提炼出来，在所有用例之间实现共享。
+- There are many test cases for various user usage scenarios. "Flat" has no hierarchy, so the code will appear chaotic.
+- Multiple test cases may be conceptually related, such as testing tRPC-Go data penetration. These cases should be organized together.
+- Almost every test case needs to be executed in a specific environment with a server, and resources (mainly closing the started server) need to be cleaned up after the case is executed. This common logic should be extracted and shared among all cases.
 
-### xUnit 家族模式
+### xUnit's family pattern
 
-针对 tRPC-Go 的集成测试的特点 1 和特点 2，解决办法是让测试代码组成形式具有层次，将概念上相关的用例在组织一起，我们采用了 xUnit 家族 [3，4，5] 典型的三层测试代码组织形式：
+To address characteristics 1 and 2 of tRPC-Go's integration testing, the solution is to make the test code organization hierarchical and organize conceptually related cases together.
+We adopted the typical three-layer test code organization of the xUnit family [3,4,5]:
 
-```bash
+```text
 Test Project
     Test Suite1
         Test Case1
@@ -43,48 +54,51 @@ Test Project
         Test CaseN
     ... 
     Test SuiteN
-  	   Test Case1
-       ...
-       Test CaseN
+        Test Case1
+        ...
+        Test CaseN
 ```
 
-这种代码组织形式包含三个层次，一个 Test Project 由若干个 Test Suite 组成，而每个 Test Suite 又包含多个 Test Case。
-
-在 Go 1.7 版本之前，使用 Go 原生工具和标准库是无法按照上述形式组织测试代码的，在 Go 1.7 中加入的对 subtest[6] 的支持允许在 Go 中也可以使用上面这种方式组织测试代码。然而社区中广泛流行 testify 在 Go 官方 testing 包的基础上做了简单封装，方便好用，其中的 suite[7] 包提供了类似的能力，所以 tRPC-Go 的集成测试主要利用了 testify/suite 来实现以上的代码组织形式。
+This code organization has three levels: a Test Project consists of several Test Suites, and each Test Suite contains multiple Test Cases.
 
-### 测试固件
+Before Go 1.7, it was impossible to organize test code in the above form using Go's native tools and standard library.
+The support for subtest[6] added in Go 1.7 allows this kind of organization in Go as well.
+However, the widely popular testify in the community is a simple wrapper around Go's official testing package, which is convenient and easy to use.
+Its suite[7] package provides similar capabilities, so tRPC-Go's integration testing mainly uses testify/suite to achieve the above code organization.
 
-针对 tRPC-Go 的集成测试的特点 3，解决办法是利用 testify/suite 中的 SetUp 和 TearDown 函数分别来创建/设置和拆除/销毁测试固件[8]。
+### Test fixtures
 
-> 测试固件是指一个人造的、确定性的环境，一个测试用例或一个测试套件（下的一组测试用例）在这个环境中进行测试，其测试结果是可重复的（多次测试运行的结果是相同的）。
+To address characteristic 3 of tRPC-Go's integration testing, the solution is to use the SetUp and TearDown functions in testify/suite to create/set and teardown/destroy test fixtures[8].
 
-测试固件存在于以下常见场景：
+> A test fixture is an artificial, deterministic environment where a test case or a test suite (a group of test cases under it) is tested, and its test result is repeatable (the results of multiple test runs are the same).
 
-- 创建启动 server 需要的相关资源并启动一个 server，测试结束后关闭一个 server，并清理相关资源
+Test fixtures are commonly found in the following scenarios:
 
-- 将一组已知的特定数据加载到数据库中，测试结束后清除这些数据
-- 复制一组特定的已知文件，测试结束后清除这些文件
+- Create the necessary resources to start a server, start a server, close a server after the test is over, and clean up related resources
+- Load a specific set of known data into the database, and clear the data after the test is over
+- Copy a specific set of known files, and clear the files after the test is over
 
-当然测试固件可以有不同的级别，分别对应 Test Project、Test Suite 和 Test Case，因此 tRPC-Go 中集成测试执行流一般如下：
+Of course, test fixtures can have different levels, corresponding to Test Project, Test Suite, and Test Case.
+Therefore, the general execution flow of integration testing in tRPC-Go is as follows:
 
-```bash
- 集成测试包
-    测试开始
-        Test Project 级别的固件创建
-            Test Suite 级别的固件创建（启动 server 等）
-                Test Case 级别的固件创建
-                    运行测试（一般需要 client 发送请求同 server 进行交互，然后根据返回的结果进行验证）
-                Test Case 级别的固件销毁
-            Test Suite 级别的固件销毁（关闭 server 等）
-        Test Project 级别的固件销毁
-    测试结束
+```text
+Integration Test Package
+   Test Start
+       Test Project level fixture creation
+           Test Suite level fixture creation (start server, etc.)
+               Test Case level fixture creation
+                   Run test (usually requires client to send request to interact with server, and then verify based on the returned result)
+               Test Case level fixture teardown
+           Test Suite level fixture teardown (close server, etc.)
+       Test Project level fixture teardown
+   Test End
 ```
 
-### 代码示例
+### Code Example
 
-下面以测试 tRPC-Go 框架代码中的 admin 模块为例子来分析下 tRPC-Go 集成测试代码所采用的代码组织形式和执行流。
+Let's take the admin module in the tRPC-Go framework code as an example to analyze the code organization and execution flow adopted by tRPC-Go integration test code.
 
-我们通过运行 admin_go.test 中 的 TestAdmin 函数来分析集成测试的代码组织形式：
+We analyze the code organization of the integration test by running the `TestAdmin` function in `admin_go.test`:
 
 ```bash
 === RUN   TestRunSuite
@@ -109,19 +123,19 @@ Test Project
 PASS
 ```
 
-从中可以看到 `go test`的输出相对于“平铺”更有层次感，我们可以一眼看出对哪些函数/方法进行了测试、这些被测对象对应的 TestSuite 以及 TestSuite 中的每个 TestCase。
+From the output of `go test`, we can see that it is more hierarchical than "flat", and we can easily see which functions/methods have been tested, the corresponding TestSuite, and each TestCase in the TestSuite.
 
 ```bash
-TestRunSuite  <--- 对应 Test Project
-    TestAdmin  <--- 对应 Test Suite1
-       testCmds              ｜  <---- 对应 Test Case1
-       testCmdsConfig        ｜  <---- 对应 Test Case2
-       testCmdsLogLevel      ｜  <---- 对应 Test Case3
-       testCustomHandleFunc  ｜  <---- 对应 Test Case4
-       testIsHealthy         ｜  <---- 对应 Test Case5
+TestRunSuite  <--- Corresponds to Test Project
+    TestAdmin  <--- Corresponds to Test Suite1
+       testCmds              ｜  <---- Corresponds to Test Case1
+       testCmdsConfig        ｜  <---- Corresponds to Test Case2
+       testCmdsLogLevel      ｜  <---- Corresponds to Test Case3
+       testCustomHandleFunc  ｜  <---- Corresponds to Test Case4
+       testIsHealthy         ｜  <---- Corresponds to Test Case5
 ```
 
-我们根据函数的执行顺序，依次查看 `TestRunSuite` 、`TestAdmin` 和 `testXXX(testCmds, testCmdsConfig, ...)` 的代码逻辑来分析测试执行流。
+We analyze the test execution flow by looking at the code logic of `TestRunSuite`, `TestAdmin`, and `testXXX(testCmds, testCmdsConfig, ...)` in the order of function execution.
 
 ```go
 func TestRunSuite(t *testing.T) {
@@ -176,21 +190,23 @@ func (s *TestSuite) TearDownTest() {}
 func (s *TestSuite) TearDownSuite() {}
 ```
 
-第一步， `TestRunSuite` 会创建一个 `TestSuite` 实例，并依次运行 `TestSuite` 中符合 `TestXXX` 命名规则的成员方法，例如这里的 `TestAdmin`。可以认为这里的 `TestSuite` 类管理着 tRPC-Go 集成测试的所有 Test Suite，`TestAdmin` 为其中一个 Test Suite [^2]。
+In the first step, `TestRunSuite` creates a `TestSuite` instance and runs the member methods of `TestSuite` that conform to the `TestXXX` naming rule, such as `TestAdmin` here. You can think of the `TestSuite` class as managing all Test Suites in tRPC-Go integration testing, with `TestAdmin` being one of them [^2].
+
+In the second step, before executing `TestAdmin`, the `SetupSuite()` and `SetupTest()` of `TestSuite` will be executed in sequence to create Test Project-level and Test Suite-level fixtures.
 
-第二步，在执行 `TestAdmin` 之前会依次执行 `TestSuite` 的 `SetupSuite()` 和 `SetupTest()` 来创建 Test Project 级别和 Test Suite 级别的固件。
+In the third step, the `testCmds`, `testCmdsConfig`, `testCmdsLogLevel`, `testCustomHandleFunc`, and `testIsHealthy` Test Cases in `TestAdmin` will be executed using the `s.Run` method. Here, Test Case-level fixtures can be created at the beginning of each function and destroyed using the defer function method.
 
-第三步，会通过 `s.Run` 方法执行 `TestAdmin` 中的 `testCmds`、`testCmdsConfig`、`testCmdsLogLevel`、 `testCustomHandleFunc` 和 `testIsHealthy` 中的 Test Case，这里可以在每个函数的开始出创建 Test Case 级别的固件，用 defer 函数的方法来销毁 Test Case 级别的固件。
+In the fourth step, actual testing will be performed in each Test Case, such as sending an HTTP Get request to the admin server in `testCmds` and verifying based on the returned result.
 
-第四步，会在每个 Test Case 中进行实际的测试，例如 `testCmds` 会向 admin server 发送一个 HTTP Get 请求，根据返回的结果做验证。
+In the fifth step, after each `TestAdmin` is finished, the `TearDownTest` of `TestSuite` will be run to destroy Test Suite-level fixtures, and the `TearDownSuite` will be run after all Test Suites are finished to destroy Test Project-level fixtures.
 
-第五步，会在每个 `TestAdmin` 结束后运行 `TestSuite` 的 `TearDownTest` 来销毁 Test Suite 级别的固件，会在所有的 Test Suite 结束后运行 `TearDownSuite` 来销毁 Test Project 级别的固件。
+[^2]: In tRPC-Go, the semantics of the `TestSuite` structure and the suite in testify/suite are slightly different, with the latter's suite referring to a Test Suite.
 
-[^2]: tRPC-Go 中`TestSuite` 结构体的语义和 testify/suite 中 suite 的语义有些许区别，后者的 suite 就是指一个 Test Suite。
 
-### 新增一个集成测试用例示范
+### Adding a new integration test case demonstration
 
-一般来说，在 tRPC-Go 集成测试中，新增一个测试用例一般需要先启动一个 server，然后创建 client 来访问 server 提供了 service，最后根据返回结果验证。下面以测试 tRPC 协议 一应一答超时为例：
+Generally, in tRPC-Go integration testing, adding a test case usually requires starting a server first, then creating a client to access the service provided by the server, and finally verifying based on the returned result.
+The following example demonstrates testing the tRPC protocol's one-to-one timeout:
 
 ```go
 1 func (s *TestSuite) TestClientTimeoutAtUnaryCall() {
@@ -202,72 +218,79 @@ func (s *TestSuite) TearDownSuite() {}
 7 }
 ```
 
-#### 第一步：根据 tRPC-Go 测试代码的组织形式来组织测试用例
+#### Step 1: Organize test cases according to the tRPC-Go test code organization
 
-如果一个 Test Suite 中只包含 一个 Test Case，可以把该 Test Case 的位置往上提升。根据需要测试的功能，取一个符合 TestXXX 语法规则且简单易懂的函数名，代码的第 1 行定义了一个名为 `TestClientTimeoutAtUnaryCall`的`*TestSuite` 的成员方法。
+If a Test Suite contains only one Test Case, the position of the Test Case can be raised.
+Based on the functionality to be tested, choose a function name that conforms to the TestXXX syntax and is easy to understand. 
+In line 1 of the code, a member method of `*TestSuite` named `TestClientTimeoutAtUnaryCall` is defined.
 
-#### 第二步：启动一个提供 trpc service 的 server
+#### Step 2: Start a server providing trpc service
 
-代码的第 2 行调用 `*TestSuite` 的成员方法 `startServer` 启动了一个 trpc service，并设置一应一答服务中的 sleep 时间为 1s。tRPC-Go 集成测试可以为启动的服务提供 3 种级别的灵活性：
+In line 2 of the code, the `startServer` member method of `*TestSuite` is called to start a trpc service, and the sleep time in the one-to-one service is set to 1s. 
+tRPC-Go integration testing can provide 3 levels of flexibility for starting services:
 
-- 可以启动不同类型的 service。service_imp.go 实现了 protocols 目录下 test.proto 定义的各种类型的 service，包括`TRPCService`、`StreamingService` 、`testHTTPService` 和 `testRESTfulService`，涵盖了 trpc、streaming、http 和 restful 协议。
+- Different types of services can be started. 
+The `service_imp.go` file implements various types of services defined in the protocols directory's `test.proto`, including `TRPCService`, `StreamingService`, `testHTTPService`, and `testRESTfulService`, covering trpc, streaming, http, and restful protocols.
+- The processing logic of methods in the service can be customized. 
+For example, when constructing the `TRPCService`, you can fill in the`EmptyCallF` field, and when the client initiates the `EmptyCall` call, the custom processing logic will be executed.
 
-- 可以自定义 service 中的 method 处理逻辑。如可以在构造 `TRPCService` 的填写`EmptyCallF`字段，则 client 发起 `EmptyCall` 调用时会执行自定义的处理逻辑。
+```go
+// TRPCService to test tRPC service.
+type TRPCService struct {
+  // Customizable implementations of server handlers.
+  EmptyCallF func(ctx context.Context, in *testpb.Empty) (*testpb.Empty, error)
 
-  ```go
-  // TRPCService to test tRPC service.
-  type TRPCService struct {
-  	// Customizable implementations of server handlers.
-  	EmptyCallF func(ctx context.Context, in *testpb.Empty) (*testpb.Empty, error)
-  
-  	unaryCallSleepTime time.Duration
-  }
-  
-  // EmptyCall to test empty call.
-  func (s *TRPCService) EmptyCall(ctx context.Context, in *testpb.Empty) (*testpb.Empty, error) {
-  	if s.EmptyCallF != nil {
-  		return s.EmptyCallF(ctx, in)
-  	}
-  	return &testpb.Empty{}, nil
-  }
-  ```
+  unaryCallSleepTime time.Duration
+}
 
-- 可以改变 service 中的 method 的行为。例如这个示例里设置了`unaryCallSleepTime` 时间为 1s。
+// EmptyCall to test empty call.
+func (s *TRPCService) EmptyCall(ctx context.Context, in *testpb.Empty) (*testpb.Empty, error) {
+  if s.EmptyCallF != nil {
+    return s.EmptyCallF(ctx, in)
+  }
+  return &testpb.Empty{}, nil
+}
+```
+- The behavior of methods in the service can be changed.
+For example, in this example, the unaryCallSleepTime is set to 1s.
 
-#### 第三步：创建 client 且发起一个普通 RPC 调用
+#### Step 3: Create a client and initiate a regular RPC call
 
-代码的第 4 行通过调用`*TestSuite` 的成员方法 `newTRPCClient` 创建了一个 trpc client, 该方法设置 client 的 Target，超时时间和不采用多路复用。
+In line 4 of the code, a trpc client is created by calling the `newTRPCClient` member method of `*TestSuite`.
+This method sets the client's Target, timeout, and disables multiplexing.
 
 ```go
 // newTRPCClient creates a tRPC client connected to this service that the test may use.
 // The newly created client will be available in the client field of TestSuite.
 func (s *TestSuite) newTRPCClient(opts ...client.Option) testpb.TestTRPCClientProxy {
-	log.Debugf("client dial to %s.", s.serverAddress())
-	const defaultTimeout = 1 * time.Second
-	return testpb.NewTestTRPCClientProxy(
-		append(
-			opts,
-			client.WithTarget(s.serverAddress()),
-			client.WithTimeout(defaultTimeout),
-			client.WithMultiplexed(s.tRPCEnv.clientMultiplexed),
-		)...,
-	)
+  log.Debugf("client dial to %s.", s.serverAddress())
+  const defaultTimeout = 1 * time.Second
+  return testpb.NewTestTRPCClientProxy(
+    append(
+      opts,
+      client.WithTarget(s.serverAddress()),
+      client.WithTimeout(defaultTimeout),
+      client.WithMultiplexed(s.tRPCEnv.clientMultiplexed),
+    )...,
+  )
 }
 ```
 
-代码的第 5 行会发起一个普通 RPC `UnaryCall`, 请求参数 `s.defaultSimpleRequest` 为 `*testpb.SimpleRequest` 类型，可以从 pb 生成的桩代码包 `testpb "trpc.group/trpc-go/trpc-go/test/protocols"` 中自行构建请求参数。
+In line 5 of the code, a regular RPC `UnaryCall` is initiated.
+The request parameter `s.defaultSimpleRequest` is of type `*testpb.SimpleRequest`, which can be constructed from the stub code package `testpb "trpc.group/trpc-go/trpc-go/test/protocols"`.
 
-### 第四步：根据返回结果验证
+#### Step 4: Verify based on the returned result
 
-代码的第 6 行根据返回的错误码，使用 require 包验证错误码的的类型是否符合预期的 `errs.RetClientTimeout`。
+In line 6 of the code, the error code is verified using the `require` package to check if the error code type matches the expected `errs.RetClientTimeout`.
 
-## 参考
+## References
 
-1. Winters, Titus, Tom Manshreck, and Hyrum Wright. *Software engineering at Google: Lessons learned from programming over time*. O'Reilly Media, 2020.
-2. Mike Cohn, *Succeeding with Agile: Software Development Using Scrum* (New York: Addison-Wesley Professional, 2009)
-3. xUnit 家族测试框架在 Java 和 Python 语言中广为流行，最初由极限编程倡导者 Kent Beck 和 Erich Gamma 建立的，见 Meszaros, Gerard. *xUnit test patterns: Refactoring test code*. Pearson Education, 2007.
+1. Winters, Titus, Tom Manshreck, and Hyrum Wright. Software engineering at Google: Lessons learned from programming over time. O'Reilly Media, 2020.
+2. Mike Cohn, Succeeding with Agile: Software Development Using Scrum (New York: Addison-Wesley Professional, 2009)
+3. xUnit's family testing frameworks are widely popular in Java and Python languages, initially established by extreme programming advocates Kent Beck and Erich Gamma, see Meszaros, Gerard. 
+xUnit test patterns: Refactoring test code. Pearson Education, 2007.
 4. JUnit: https://junit.org/junit5/docs/current/user-guide/
 5. PyUnit: https://pyunit.sourceforge.net/pyunit.html
 6. https://pkg.go.dev/testing#hdr-Subtests_and_Sub_benchmarks
 7. https://pkg.go.dev/github.com/stretchr/testify/suite
-8. Test fixture:Software https://en.wikipedia.org/wiki/Test_fixture
+8. Test fixture:Software https://en.wikipedia.org/wiki/Test_fixture
\ No newline at end of file
diff --git a/test/README.zh_CN.md b/test/README.zh_CN.md
new file mode 100644
index 0000000..bf5f989
--- /dev/null
+++ b/test/README.zh_CN.md
@@ -0,0 +1,274 @@
+[English](README.md) | 中文
+
+# 如何在 tRPC-Go 中添加集成测试用例
+
+## 什么时候该添加集成测试用例
+
+测试用例可以从 Test Size 和 Test Scope 两个维度进行划分，按 Test Size 从小到大划分，包含小型测试，中型测试和大型测试；按 Test Scope 从小到大划分，包含单元测试，集成测试和系统测试。测试用例的维度越大，运行时需要的 CPU，IO，网络，内存等资源越多，运行速度越慢，得到的运行结果也越不可靠 [1]。对于一个系统来说，这几种测试的占比在软件工程实践中，存在如下一个测试金字塔 [2] 的粗略指导性原则，维度越低的测试用例占比应该越高。
+
+```text
+        .                 系统测试 5%
+       ...                集成测试 15%
+................          单元测试 80%
+```
+
+**因此在 tRPC-Go 中也建议尽量编写小维度的小型测试和单元测试**。以下场景可能需要添加集成测试用例：
+
+- 需要使用到多进程的情况，例如测试 server 的优雅重启，可以仿照 `graceful_restart_test.go` 中的实现。
+- 需要创建 client 来访问一个真实 server [^1] 提供的服务来验证功能的场景，根据 server 提供的服务类型的不同，可仿照 `trpc_test.go`、 `http_test.go`、`restful_test.go` 和`streaming_test.go`。
+
+[^1] tRPC-Go 的集成测试网络调用只使用了 localhost 网络，同时整个测试只能运行在单机上。
+
+## 测试代码的组织形式
+
+### 平铺
+
+Go 语言内置 `go test` 命令，该命令会运行 `_test.go` 文件中符合 `TestXXX` 命名规则的函数，进而实现测试代码的执行。因为 `go test` 并没有对测试代码的组织形式提出任何约束条件，所以现有很多测试代码都采用了十分简单的“平铺”组织。这种“平铺”的代码组织形式优点是每个测试函数都是互不相关的，在代码结构上没有额外的抽象，上手非常容易。然而， “平铺”并不适用于 tRPC-Go 的集成测试，因为  tRPC-Go 的集成测试存在以下特点：
+
+- 会测试各种用户使用场景，存在大量的测试用例，“平铺”由于没有层次感，代码就会显得比较混乱；
+- 多个测试用例在概念上可能是相关的，如都是针对 tRPC-Go 数据透传的测试，应该把这些用例组织在一起；
+- 几乎每个测试用例前都需要在存在某个 server 的特定环境中执行，且在用例执行完后需要清理资源（主要是关闭启动的 server），应该把这些共有逻辑提炼出来，在所有用例之间实现共享。
+
+### xUnit 家族模式
+
+针对 tRPC-Go 的集成测试的特点 1 和特点 2，解决办法是让测试代码组成形式具有层次，将概念上相关的用例在组织一起，我们采用了 xUnit 家族 [3，4，5] 典型的三层测试代码组织形式：
+
+```text
+Test Project
+    Test Suite1
+        Test Case1
+        ...
+        Test CaseN
+    Test Suite2 
+        Test Case1
+        ...
+        Test CaseN
+    ... 
+    Test SuiteN
+  	   Test Case1
+       ...
+       Test CaseN
+```
+
+这种代码组织形式包含三个层次，一个 Test Project 由若干个 Test Suite 组成，而每个 Test Suite 又包含多个 Test Case。
+
+在 Go 1.7 版本之前，使用 Go 原生工具和标准库是无法按照上述形式组织测试代码的，在 Go 1.7 中加入的对 subtest[6] 的支持允许在 Go 中也可以使用上面这种方式组织测试代码。然而社区中广泛流行 testify 在 Go 官方 testing 包的基础上做了简单封装，方便好用，其中的 suite[7] 包提供了类似的能力，所以 tRPC-Go 的集成测试主要利用了 testify/suite 来实现以上的代码组织形式。
+
+### 测试固件
+
+针对 tRPC-Go 的集成测试的特点 3，解决办法是利用 testify/suite 中的 SetUp 和 TearDown 函数分别来创建/设置和拆除/销毁测试固件[8]。
+
+> 测试固件是指一个人造的、确定性的环境，一个测试用例或一个测试套件（下的一组测试用例）在这个环境中进行测试，其测试结果是可重复的（多次测试运行的结果是相同的）。
+
+测试固件存在于以下常见场景：
+
+- 创建启动 server 需要的相关资源并启动一个 server，测试结束后关闭一个 server，并清理相关资源
+- 将一组已知的特定数据加载到数据库中，测试结束后清除这些数据
+- 复制一组特定的已知文件，测试结束后清除这些文件
+
+当然测试固件可以有不同的级别，分别对应 Test Project、Test Suite 和 Test Case，因此 tRPC-Go 中集成测试执行流一般如下：
+
+```text
+集成测试包
+   测试开始
+       Test Project 级别的固件创建
+           Test Suite 级别的固件创建（启动 server 等）
+               Test Case 级别的固件创建
+                   运行测试（一般需要 client 发送请求同 server 进行交互，然后根据返回的结果进行验证）
+               Test Case 级别的固件销毁
+           Test Suite 级别的固件销毁（关闭 server 等）
+       Test Project 级别的固件销毁
+   测试结束
+```
+
+### 代码示例
+
+下面以测试 tRPC-Go 框架代码中的 admin 模块为例子来分析下 tRPC-Go 集成测试代码所采用的代码组织形式和执行流。
+
+我们通过运行 `admin_go.test` 中 的 `TestAdmin` 函数来分析集成测试的代码组织形式：
+
+```bash
+=== RUN   TestRunSuite
+--- PASS: TestRunSuite (0.51s)
+=== RUN   TestRunSuite/TestAdmin
+2022-10-18 14:19:26.999	DEBUG	maxprocs/maxprocs.go:47	maxprocs: Leaving GOMAXPROCS=10: CPU quota undefined
+2022-10-18 14:19:26.999	INFO	server/service.go:158	process:6983, trpc service:trpc.testing.end2end.TestTRPC launch success, tcp::0, serving ...
+    --- PASS: TestRunSuite/TestAdmin (0.51s)
+=== RUN   TestRunSuite/TestAdmin/cmds
+        --- PASS: TestRunSuite/TestAdmin/cmds (0.00s)
+=== RUN   TestRunSuite/TestAdmin/cmds-config
+        --- PASS: TestRunSuite/TestAdmin/cmds-config (0.00s)
+=== RUN   TestRunSuite/TestAdmin/cmds-loglevel
+        --- PASS: TestRunSuite/TestAdmin/cmds-loglevel (0.00s)
+=== RUN   TestRunSuite/TestAdmin/CustomHandleFunc
+        --- PASS: TestRunSuite/TestAdmin/CustomHandleFunc (0.00s)
+=== RUN   TestRunSuite/TestAdmin/is-healthy
+2022-10-18 14:19:27.207	INFO	server/service.go:488	process:6983, trpc service:trpc.testing.end2end.TestTRPC, closing ...
+2022-10-18 14:19:27.207	INFO	admin/admin.go:154	process:6983, admin server, closed
+2022-10-18 14:19:27.508	INFO	server/service.go:508	process:6983, trpc service:trpc.testing.end2end.TestTRPC, closed
+        --- PASS: TestRunSuite/TestAdmin/is-healthy (0.00s)
+PASS
+```
+
+从中可以看到 `go test`的输出相对于“平铺”更有层次感，我们可以一眼看出对哪些函数/方法进行了测试、这些被测对象对应的 TestSuite 以及 TestSuite 中的每个 TestCase。
+
+```bash
+TestRunSuite  <--- 对应 Test Project
+    TestAdmin  <--- 对应 Test Suite1
+       testCmds              ｜  <---- 对应 Test Case1
+       testCmdsConfig        ｜  <---- 对应 Test Case2
+       testCmdsLogLevel      ｜  <---- 对应 Test Case3
+       testCustomHandleFunc  ｜  <---- 对应 Test Case4
+       testIsHealthy         ｜  <---- 对应 Test Case5
+```
+
+我们根据函数的执行顺序，依次查看 `TestRunSuite` 、`TestAdmin` 和 `testXXX(testCmds, testCmdsConfig, ...)` 的代码逻辑来分析测试执行流。
+
+```go
+func TestRunSuite(t *testing.T) {
+   suite.Run(t, new(TestSuite))
+}
+
+func (s *TestSuite) SetupSuite() {}
+
+func (s *TestSuite) SetupTest() {}
+
+func (s *TestSuite) TestAdmin() {
+  s.copyTRPCConfigFile(defaultTRPCWithAdminConfigPath)
+	s.startTRPCServerWithListener(&TRPCService{})
+	// wait a while until admin server has started.
+	time.Sleep(200 * time.Millisecond)
+	s.Run("cmds", s.testCmds)
+	s.Run("cmds-config", s.testCmdsConfig)
+	s.Run("cmds-loglevel", s.testCmdsLogLevel)
+	s.Run("CustomHandleFunc", s.testCustomHandleFunc)
+	s.Run("is-healthy", s.testIsHealthy)
+}
+
+func (s *TestSuite) testCmds(){
+  resp, err := httpRequest(http.MethodGet, fmt.Sprintf("http://%s/cmds", defaultAdminListenAddr), "")
+	require.Nil(s.T(), err)
+	r := struct {
+		Errcode int      `json:"errorcode"`
+		Message string   `json:"message"`
+		Cmds    []string `json:"cmds"`
+	}{}
+	require.Nil(s.T(), json.Unmarshal(resp, &r), "Unmarshal failed")
+	require.ElementsMatch(
+		s.T(),
+		[]string{
+			"/cmds",
+			"/version",
+			"/debug/pprof/",
+			"/debug/pprof/symbol",
+			"/debug/pprof/trace",
+			"/cmds/loglevel",
+			"/cmds/config",
+			"/is_healthy/",
+			"/debug/pprof/cmdline",
+			"/debug/pprof/profile",
+		},
+		r.Cmds,
+	)
+}
+
+func (s *TestSuite) TearDownTest() {}
+
+func (s *TestSuite) TearDownSuite() {}
+```
+
+第一步，`TestRunSuite` 会创建一个 `TestSuite` 实例，并依次运行 `TestSuite` 中符合 `TestXXX` 命名规则的成员方法，例如这里的 `TestAdmin`。可以认为这里的 `TestSuite` 类管理着 tRPC-Go 集成测试的所有 Test Suite，`TestAdmin` 为其中一个 Test Suite [^2]。
+
+第二步，在执行 `TestAdmin` 之前会依次执行 `TestSuite` 的 `SetupSuite()` 和 `SetupTest()` 来创建 Test Project 级别和 Test Suite 级别的固件。
+
+第三步，会通过 `s.Run` 方法执行 `TestAdmin` 中的 `testCmds`、`testCmdsConfig`、`testCmdsLogLevel`、 `testCustomHandleFunc` 和 `testIsHealthy` 中的 Test Case，这里可以在每个函数的开始出创建 Test Case 级别的固件，用 defer 函数的方法来销毁 Test Case 级别的固件。
+
+第四步，会在每个 Test Case 中进行实际的测试，例如 `testCmds` 会向 admin server 发送一个 HTTP Get 请求，根据返回的结果做验证。
+
+第五步，会在每个 `TestAdmin` 结束后运行 `TestSuite` 的 `TearDownTest` 来销毁 Test Suite 级别的固件，会在所有的 Test Suite 结束后运行 `TearDownSuite` 来销毁 Test Project 级别的固件。
+
+[^2]: tRPC-Go 中`TestSuite` 结构体的语义和 testify/suite 中 suite 的语义有些许区别，后者的 suite 就是指一个 Test Suite。
+
+### 新增一个集成测试用例示范
+
+一般来说，在 tRPC-Go 集成测试中，新增一个测试用例一般需要先启动一个 server，然后创建 client 来访问 server 提供了 service，最后根据返回结果验证。下面以测试 tRPC 协议 一应一答超时为例：
+
+```go
+1 func (s *TestSuite) TestClientTimeoutAtUnaryCall() {
+2 	s.startServer(&TRPCService{unaryCallSleepTime: time.Second})
+3 
+4 	c := s.newTRPCClient()
+5 	_, err := c.UnaryCall(trpc.BackgroundContext(), s.defaultSimpleRequest, client.WithTimeout(100*time.Millisecond))
+6 	require.Equal(s.T(), errs.RetClientTimeout, errs.Code(err))
+7 }
+```
+
+#### 第一步：根据 tRPC-Go 测试代码的组织形式来组织测试用例
+
+如果一个 Test Suite 中只包含 一个 Test Case，可以把该 Test Case 的位置往上提升。根据需要测试的功能，取一个符合 TestXXX 语法规则且简单易懂的函数名，代码的第 1 行定义了一个名为 `TestClientTimeoutAtUnaryCall`的`*TestSuite` 的成员方法。
+
+#### 第二步：启动一个提供 trpc service 的 server
+
+代码的第 2 行调用 `*TestSuite` 的成员方法 `startServer` 启动了一个 trpc service，并设置一应一答服务中的 sleep 时间为 1s。tRPC-Go 集成测试可以为启动的服务提供 3 种级别的灵活性：
+
+- 可以启动不同类型的 service。`service_imp.go` 实现了 protocols 目录下 `test.proto` 定义的各种类型的 service，包括`TRPCService`、`StreamingService` 、`testHTTPService` 和 `testRESTfulService`，涵盖了 trpc、streaming、http 和 restful 协议。
+
+- 可以自定义 service 中的 method 处理逻辑。如可以在构造 `TRPCService` 的填写`EmptyCallF`字段，则 client 发起 `EmptyCall` 调用时会执行自定义的处理逻辑。
+
+  ```go
+  // TRPCService to test tRPC service.
+  type TRPCService struct {
+  	// Customizable implementations of server handlers.
+  	EmptyCallF func(ctx context.Context, in *testpb.Empty) (*testpb.Empty, error)
+  
+  	unaryCallSleepTime time.Duration
+  }
+  
+  // EmptyCall to test empty call.
+  func (s *TRPCService) EmptyCall(ctx context.Context, in *testpb.Empty) (*testpb.Empty, error) {
+  	if s.EmptyCallF != nil {
+  		return s.EmptyCallF(ctx, in)
+  	}
+  	return &testpb.Empty{}, nil
+  }
+  ```
+
+- 可以改变 service 中的 method 的行为。例如这个示例里设置了`unaryCallSleepTime` 时间为 1s。
+
+#### 第三步：创建 client 且发起一个普通 RPC 调用
+
+代码的第 4 行通过调用`*TestSuite` 的成员方法 `newTRPCClient` 创建了一个 trpc client, 该方法设置 client 的 Target，超时时间和不采用多路复用。
+
+```go
+// newTRPCClient creates a tRPC client connected to this service that the test may use.
+// The newly created client will be available in the client field of TestSuite.
+func (s *TestSuite) newTRPCClient(opts ...client.Option) testpb.TestTRPCClientProxy {
+	log.Debugf("client dial to %s.", s.serverAddress())
+	const defaultTimeout = 1 * time.Second
+	return testpb.NewTestTRPCClientProxy(
+		append(
+			opts,
+			client.WithTarget(s.serverAddress()),
+			client.WithTimeout(defaultTimeout),
+			client.WithMultiplexed(s.tRPCEnv.clientMultiplexed),
+		)...,
+	)
+}
+```
+
+代码的第 5 行会发起一个普通 RPC `UnaryCall`, 请求参数 `s.defaultSimpleRequest` 为 `*testpb.SimpleRequest` 类型，可以从 pb 生成的桩代码包 `testpb "trpc.group/trpc-go/trpc-go/test/protocols"` 中自行构建请求参数。
+
+### 第四步：根据返回结果验证
+
+代码的第 6 行根据返回的错误码，使用 require 包验证错误码的的类型是否符合预期的 `errs.RetClientTimeout`。
+
+## 参考
+
+1. Winters, Titus, Tom Manshreck, and Hyrum Wright. *Software engineering at Google: Lessons learned from programming over time*. O'Reilly Media, 2020.
+2. Mike Cohn, *Succeeding with Agile: Software Development Using Scrum* (New York: Addison-Wesley Professional, 2009)
+3. xUnit 家族测试框架在 Java 和 Python 语言中广为流行，最初由极限编程倡导者 Kent Beck 和 Erich Gamma 建立的，见 Meszaros, Gerard. *xUnit test patterns: Refactoring test code*. Pearson Education, 2007.
+4. JUnit: https://junit.org/junit5/docs/current/user-guide/
+5. PyUnit: https://pyunit.sourceforge.net/pyunit.html
+6. https://pkg.go.dev/testing#hdr-Subtests_and_Sub_benchmarks
+7. https://pkg.go.dev/github.com/stretchr/testify/suite
+8. Test fixture:Software https://en.wikipedia.org/wiki/Test_fixture

From cf5ca252927b0e5c2f50ee96a0bfe588e8c27ac6 Mon Sep 17 00:00:00 2001
From: goodliu <zenghao235711@gmail.com>
Date: Fri, 10 Nov 2023 10:03:40 +0800
Subject: [PATCH 12/16] examples: remove main.go client_test.go and custom.yaml
 under example/features/feature/xxx dir (#135)

under example/features/feature/xxx dir
---
 examples/features/cancellation/client_test.go |  72 -----------
 examples/features/cancellation/main.go        |  27 -----
 examples/features/compression/client_test.go  |  69 -----------
 examples/features/config/custom.yaml          |   8 --
 examples/features/config/main.go              |  56 ---------
 examples/features/discovery/client_test.go    | 109 -----------------
 examples/features/discovery/main.go           |  27 -----
 examples/features/errs/client_test.go         |  65 ----------
 examples/features/errs/main.go                |  67 -----------
 examples/features/filter/client_test.go       |  82 -------------
 examples/features/filter/main.go              |  53 --------
 examples/features/http/client_test.go         |  90 --------------
 examples/features/http/main.go                |  28 -----
 examples/features/loadbalance/client_test.go  | 113 ------------------
 examples/features/loadbalance/main.go         |  27 -----
 examples/features/log/main.go                 |  72 -----------
 examples/features/metadata/client_test.go     |  82 -------------
 examples/features/metadata/main.go            |  45 -------
 examples/features/plugin/client_test.go       |  67 -----------
 examples/features/selector/client_test.go     |  87 --------------
 examples/features/selector/main.go            |  30 -----
 examples/features/timeout/main.go             |  27 -----
 22 files changed, 1303 deletions(-)
 delete mode 100644 examples/features/cancellation/client_test.go
 delete mode 100644 examples/features/cancellation/main.go
 delete mode 100644 examples/features/compression/client_test.go
 delete mode 100644 examples/features/config/custom.yaml
 delete mode 100644 examples/features/config/main.go
 delete mode 100644 examples/features/discovery/client_test.go
 delete mode 100644 examples/features/discovery/main.go
 delete mode 100644 examples/features/errs/client_test.go
 delete mode 100644 examples/features/errs/main.go
 delete mode 100644 examples/features/filter/client_test.go
 delete mode 100644 examples/features/filter/main.go
 delete mode 100644 examples/features/http/client_test.go
 delete mode 100644 examples/features/http/main.go
 delete mode 100644 examples/features/loadbalance/client_test.go
 delete mode 100644 examples/features/loadbalance/main.go
 delete mode 100644 examples/features/log/main.go
 delete mode 100644 examples/features/metadata/client_test.go
 delete mode 100644 examples/features/metadata/main.go
 delete mode 100644 examples/features/plugin/client_test.go
 delete mode 100644 examples/features/selector/client_test.go
 delete mode 100644 examples/features/selector/main.go
 delete mode 100644 examples/features/timeout/main.go

diff --git a/examples/features/cancellation/client_test.go b/examples/features/cancellation/client_test.go
deleted file mode 100644
index a100364..0000000
--- a/examples/features/cancellation/client_test.go
+++ /dev/null
@@ -1,72 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-package main
-
-import (
-	"context"
-	"testing"
-	"time"
-
-	"github.com/stretchr/testify/assert"
-
-	_ "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/client"
-	"trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-var addr = "ip://127.0.0.1:8000"
-
-func TestSayHello(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-	}
-
-	clientProxy := helloworld.NewGreeterClientProxy(opts...)
-
-	req := &helloworld.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHello(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-
-	cancel()
-	reqCanceled := &helloworld.HelloRequest{
-		Msg: "trpc-go-client-canceled",
-	}
-	rsp, err = clientProxy.SayHello(ctx, reqCanceled)
-	t.Log(rsp, err)
-}
-
-func TestSayHi(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-	}
-
-	clientProxy := helloworld.NewGreeterClientProxy(opts...)
-
-	req := &helloworld.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHi(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
diff --git a/examples/features/cancellation/main.go b/examples/features/cancellation/main.go
deleted file mode 100644
index 94c46f3..0000000
--- a/examples/features/cancellation/main.go
+++ /dev/null
@@ -1,27 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-// Package main is the main package.
-package main
-
-import (
-	trpc "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/examples/features/common"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-func main() {
-	s := trpc.NewServer()
-	pb.RegisterGreeterService(s, &common.GreeterServerImpl{})
-	s.Serve()
-}
diff --git a/examples/features/compression/client_test.go b/examples/features/compression/client_test.go
deleted file mode 100644
index ef016d7..0000000
--- a/examples/features/compression/client_test.go
+++ /dev/null
@@ -1,69 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-package main
-
-import (
-	"context"
-	"testing"
-	"time"
-
-	"github.com/stretchr/testify/assert"
-
-	_ "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/client"
-	"trpc.group/trpc-go/trpc-go/codec"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-var addr = "ip://127.0.0.1:8000"
-
-func TestSayHello(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-		client.WithCompressType(codec.CompressTypeGzip),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	req := &pb.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHello(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
-
-func TestSayHi(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-		client.WithCompressType(codec.CompressTypeSnappy),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	req := &pb.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHi(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
diff --git a/examples/features/config/custom.yaml b/examples/features/config/custom.yaml
deleted file mode 100644
index c928ee3..0000000
--- a/examples/features/config/custom.yaml
+++ /dev/null
@@ -1,8 +0,0 @@
-custom :
-  test : test
-  test_obj :
-    key1 : value1
-    key2 : false
-    key3 : 1234
-
-
diff --git a/examples/features/config/main.go b/examples/features/config/main.go
deleted file mode 100644
index 03935d3..0000000
--- a/examples/features/config/main.go
+++ /dev/null
@@ -1,56 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-// Package main is the main package.
-package main
-
-import (
-	"fmt"
-
-	"trpc.group/trpc-go/trpc-go/config"
-)
-
-func main() {
-	// Parse configuration files in yaml format.
-	c, err := config.Load("custom.yaml", config.WithCodec("yaml"), config.WithProvider("file"))
-	if err != nil {
-		fmt.Println(err)
-		return
-	}
-
-	// The format of the configuration file corresponds to custom struct.
-	var custom struct {
-		Custom struct {
-			Test    string `yaml:"test"`
-			TestObj struct {
-				Key1 string `yaml:"key1"`
-				Key2 bool   `yaml:"key2"`
-				Key3 int32  `yaml:"key3"`
-			} `yaml:"test_obj"`
-		} `yaml:"custom"`
-	}
-
-	err = c.Unmarshal(&custom)
-	if err != nil {
-		fmt.Println(err)
-		return
-	}
-
-	fmt.Printf("custom : %v \n", custom)
-
-	fmt.Printf("test : %s \n", c.GetString("custom.test", ""))
-	fmt.Printf("key1 : %s \n", c.GetString("custom.test_obj.key1", ""))
-	fmt.Printf("key2 : %t \n", c.GetBool("custom.test_obj.key2", false))
-	fmt.Printf("key2 : %d \n", c.GetInt32("custom.test_obj.key3", 0))
-
-}
diff --git a/examples/features/discovery/client_test.go b/examples/features/discovery/client_test.go
deleted file mode 100644
index 54fa93f..0000000
--- a/examples/features/discovery/client_test.go
+++ /dev/null
@@ -1,109 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-package main
-
-import (
-	"context"
-	"sync"
-	"testing"
-	"time"
-
-	"github.com/stretchr/testify/assert"
-
-	_ "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/client"
-	"trpc.group/trpc-go/trpc-go/naming/discovery"
-	"trpc.group/trpc-go/trpc-go/naming/registry"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-var target = "ip://127.0.0.1:8000"
-
-var serviceAddrMap sync.Map
-
-const (
-	exampleScheme      = "example"
-	exampleServiceName = "selector.example.trpc.test"
-)
-
-func init() {
-	serviceAddrMap.Store(exampleServiceName, []string{
-		"127.0.0.1:8000",
-		"127.0.0.1:8001",
-		"127.0.0.1:8002",
-	})
-	discovery.Register(exampleScheme, &exampleDiscovery{})
-}
-
-type exampleDiscovery struct{}
-
-// List 获取节点列表
-func (*exampleDiscovery) List(serviceName string, opt ...discovery.Option) ([]*registry.Node, error) {
-	var registryNodes []*registry.Node
-
-	if serviceAddr, ok := serviceAddrMap.Load(exampleServiceName); ok {
-		if addrs, ok := serviceAddr.([]string); ok {
-			for _, addr := range addrs {
-				registryNodes = append(registryNodes, &registry.Node{
-					ServiceName: serviceName,
-					Address:     addr,
-				})
-			}
-		}
-	}
-
-	return registryNodes, nil
-}
-
-func TestSayHello(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		// client.WithTarget(target),
-		client.WithServiceName(exampleServiceName),
-		client.WithDiscoveryName(exampleScheme),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	req := &pb.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHello(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
-
-func TestSayHi(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		// client.WithTarget(target),
-		client.WithServiceName(exampleServiceName),
-		client.WithDiscoveryName(exampleScheme),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	req := &pb.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHi(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
diff --git a/examples/features/discovery/main.go b/examples/features/discovery/main.go
deleted file mode 100644
index 94c46f3..0000000
--- a/examples/features/discovery/main.go
+++ /dev/null
@@ -1,27 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-// Package main is the main package.
-package main
-
-import (
-	trpc "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/examples/features/common"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-func main() {
-	s := trpc.NewServer()
-	pb.RegisterGreeterService(s, &common.GreeterServerImpl{})
-	s.Serve()
-}
diff --git a/examples/features/errs/client_test.go b/examples/features/errs/client_test.go
deleted file mode 100644
index 8784449..0000000
--- a/examples/features/errs/client_test.go
+++ /dev/null
@@ -1,65 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-package main
-
-import (
-	"context"
-	"testing"
-	"time"
-
-	"github.com/stretchr/testify/assert"
-
-	_ "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/client"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-var addr = "ip://127.0.0.1:8000"
-
-func TestSayHello(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	var req *pb.HelloRequest
-
-	rsp, err := clientProxy.SayHello(ctx, req)
-	assert.NotNil(t, err)
-	t.Log(rsp, err)
-}
-
-func TestSayHi(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	req := &pb.HelloRequest{
-		Msg: "",
-	}
-	rsp, err := clientProxy.SayHi(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
diff --git a/examples/features/errs/main.go b/examples/features/errs/main.go
deleted file mode 100644
index 69447ab..0000000
--- a/examples/features/errs/main.go
+++ /dev/null
@@ -1,67 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-// Package main is the main package.
-package main
-
-import (
-	"context"
-
-	trpc "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/errs"
-	"trpc.group/trpc-go/trpc-go/log"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-// GreeterServerImpl service implement
-type GreeterServerImpl struct{}
-
-// SayHello say hello request
-func (s *GreeterServerImpl) SayHello(ctx context.Context, req *pb.HelloRequest) (*pb.HelloReply, error) {
-	rsp := &pb.HelloReply{}
-	// implement business logic here ...
-	// ...
-
-	if req == nil || req.Msg == "" {
-		err := errs.New(10001, "req is empty")
-		return nil, err
-	}
-
-	log.Debugf("recv req:%s", req)
-	rsp.Msg = "Hello " + req.Msg
-	return rsp, nil
-}
-
-// SayHi say hi request
-func (s *GreeterServerImpl) SayHi(ctx context.Context, req *pb.HelloRequest) (*pb.HelloReply, error) {
-	rsp := &pb.HelloReply{}
-	// implement business logic here ...
-	// ...
-
-	if req == nil || req.Msg == "" {
-		err := errs.New(10001, "req is empty")
-		return nil, err
-	}
-
-	log.Debugf("SayHi recv req:%s", req)
-
-	rsp.Msg = "Hi " + req.Msg
-
-	return rsp, nil
-}
-
-func main() {
-	s := trpc.NewServer()
-	pb.RegisterGreeterService(s, &GreeterServerImpl{})
-	s.Serve()
-}
diff --git a/examples/features/filter/client_test.go b/examples/features/filter/client_test.go
deleted file mode 100644
index fa33740..0000000
--- a/examples/features/filter/client_test.go
+++ /dev/null
@@ -1,82 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-package main
-
-import (
-	"context"
-	"testing"
-	"time"
-
-	"trpc.group/trpc-go/trpc-go/client"
-	"trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-
-	"trpc.group/trpc-go/trpc-go/codec"
-	"trpc.group/trpc-go/trpc-go/filter"
-
-	_ "trpc.group/trpc-go/trpc-go"
-
-	"github.com/stretchr/testify/assert"
-)
-
-var addr = "ip://127.0.0.1:8000"
-
-func clientFilter(ctx context.Context, req interface{}, rsp interface{}, f filter.ClientHandleFunc) error {
-	msg := codec.Message(ctx)
-	md := msg.ClientMetaData()
-	if md == nil {
-		md = codec.MetaData{}
-	}
-	md["test_filter"] = []byte("ok")
-	msg.WithClientMetaData(md)
-	return f(ctx, req, rsp)
-}
-
-func TestSayHello(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-		client.WithFilter(clientFilter),
-	}
-
-	clientProxy := helloworld.NewGreeterClientProxy(opts...)
-
-	req := &helloworld.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHello(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
-
-func TestSayHi(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-	}
-
-	clientProxy := helloworld.NewGreeterClientProxy(opts...)
-
-	req := &helloworld.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHi(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
diff --git a/examples/features/filter/main.go b/examples/features/filter/main.go
deleted file mode 100644
index c908d94..0000000
--- a/examples/features/filter/main.go
+++ /dev/null
@@ -1,53 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-// Package main is the main package.
-package main
-
-import (
-	"context"
-
-	trpc "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/codec"
-	"trpc.group/trpc-go/trpc-go/examples/features/common"
-	"trpc.group/trpc-go/trpc-go/filter"
-	"trpc.group/trpc-go/trpc-go/log"
-	"trpc.group/trpc-go/trpc-go/server"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-func main() {
-	// Create a server.
-	s := trpc.NewServer(server.WithFilter(serverFilter))
-	pb.RegisterGreeterService(s, &common.GreeterServerImpl{})
-	// Start serving.
-	s.Serve()
-}
-
-func serverFilter(ctx context.Context, req interface{}, f filter.ServerHandleFunc) (interface{}, error) {
-	log.Debug("begin server filter")
-	defer log.Debug("end server filter")
-	msg := codec.Message(ctx)
-	md := msg.ServerMetaData()
-	// Extract metadata for processing in the filter.
-	if md == nil {
-		log.Debug("get filter msg nil")
-		return f(ctx, req)
-	}
-	if string(md["test_filter"]) != "ok" {
-		log.Debug("get filter msg error")
-		return f(ctx, req)
-	}
-	log.Debugf("get test_filter : %s", string(md["test_filter"]))
-	return f(ctx, req)
-}
diff --git a/examples/features/http/client_test.go b/examples/features/http/client_test.go
deleted file mode 100644
index 476103a..0000000
--- a/examples/features/http/client_test.go
+++ /dev/null
@@ -1,90 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-package main
-
-import (
-	"context"
-	"testing"
-	"time"
-
-	"github.com/stretchr/testify/assert"
-
-	"trpc.group/trpc-go/trpc-go/client"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-var addr = "ip://127.0.0.1:8080"
-
-func TestGreeterSayHello(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-		client.WithProtocol("http"),
-		client.WithTLS("../../../testdata/client.crt", "../../../testdata/client.key", "none", ""),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	req := &pb.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHello(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
-
-func TestHttp2GreeterSayHello(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-		client.WithProtocol("http2"),
-		client.WithTLS("../../../testdata/client.crt", "../../../testdata/client.key", "none", ""),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	req := &pb.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHello(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
-
-func TestGreeterSayHi(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-		client.WithProtocol("http"),
-		client.WithTLS("../../../testdata/client.crt", "../../../testdata/client.key", "none", ""),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	req := &pb.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHi(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
diff --git a/examples/features/http/main.go b/examples/features/http/main.go
deleted file mode 100644
index 27b44a5..0000000
--- a/examples/features/http/main.go
+++ /dev/null
@@ -1,28 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-// Package main is the main package.
-package main
-
-import (
-	trpc "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/examples/features/common"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-func main() {
-
-	s := trpc.NewServer()
-	pb.RegisterGreeterService(s, &common.GreeterServerImpl{})
-	s.Serve()
-}
diff --git a/examples/features/loadbalance/client_test.go b/examples/features/loadbalance/client_test.go
deleted file mode 100644
index 315d9b2..0000000
--- a/examples/features/loadbalance/client_test.go
+++ /dev/null
@@ -1,113 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-package main
-
-import (
-	"context"
-	"sync"
-	"testing"
-	"time"
-
-	"github.com/stretchr/testify/assert"
-
-	_ "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/client"
-	"trpc.group/trpc-go/trpc-go/naming/discovery"
-	_ "trpc.group/trpc-go/trpc-go/naming/loadbalance/roundrobin"
-	_ "trpc.group/trpc-go/trpc-go/naming/loadbalance/weightroundrobin"
-	"trpc.group/trpc-go/trpc-go/naming/registry"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-var addr = "ip://127.0.0.1:8000"
-
-var serviceAddrMap sync.Map
-
-const (
-	exampleScheme      = "example"
-	exampleServiceName = "selector.example.trpc.test"
-)
-
-func init() {
-	serviceAddrMap.Store(exampleServiceName, []string{
-		"127.0.0.1:8000",
-		"127.0.0.1:8001",
-		"127.0.0.1:8002",
-	})
-	discovery.Register(exampleScheme, &exampleDiscovery{})
-}
-
-type exampleDiscovery struct{}
-
-// List 获取节点列表
-func (*exampleDiscovery) List(serviceName string, opt ...discovery.Option) ([]*registry.Node, error) {
-	var registryNodes []*registry.Node
-
-	if serviceAddr, ok := serviceAddrMap.Load(exampleServiceName); ok {
-		if addrs, ok := serviceAddr.([]string); ok {
-			for _, addr := range addrs {
-				registryNodes = append(registryNodes, &registry.Node{
-					ServiceName: serviceName,
-					Address:     addr,
-				})
-			}
-		}
-	}
-
-	return registryNodes, nil
-}
-
-func TestSayHello(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		// client.WithTarget(addr),
-		client.WithDiscoveryName(exampleScheme),
-		client.WithServiceName(exampleServiceName),
-		client.WithBalancerName("round_robin"),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	req := &pb.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHello(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
-
-func TestSayHi(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		// client.WithTarget(addr),
-		client.WithDiscoveryName(exampleScheme),
-		client.WithServiceName(exampleServiceName),
-		client.WithBalancerName("weight_round_robin"),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	req := &pb.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHi(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
diff --git a/examples/features/loadbalance/main.go b/examples/features/loadbalance/main.go
deleted file mode 100644
index 94c46f3..0000000
--- a/examples/features/loadbalance/main.go
+++ /dev/null
@@ -1,27 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-// Package main is the main package.
-package main
-
-import (
-	trpc "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/examples/features/common"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-func main() {
-	s := trpc.NewServer()
-	pb.RegisterGreeterService(s, &common.GreeterServerImpl{})
-	s.Serve()
-}
diff --git a/examples/features/log/main.go b/examples/features/log/main.go
deleted file mode 100644
index f047661..0000000
--- a/examples/features/log/main.go
+++ /dev/null
@@ -1,72 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-// Package main is the main package.
-package main
-
-import (
-	"context"
-	"fmt"
-
-	trpc "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/log"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-// GreeterServerImpl service implement
-type GreeterServerImpl struct{}
-
-// SayHello say hello request
-func (s *GreeterServerImpl) SayHello(ctx context.Context, req *pb.HelloRequest) (*pb.HelloReply, error) {
-	rsp := &pb.HelloReply{}
-
-	rsp.Msg = fmt.Sprintf("trpc-go-server response: Hello %s", req.Msg)
-
-	// We can dynamically adjust the logging level at runtime.
-	log.SetLevel("console", log.LevelNames[req.Msg])
-
-	log.Tracef("recv msg:%s", req)
-	log.Debugf("recv msg:%s", req)
-	log.Infof("recv msg:%s", req)
-	log.Warnf("recv msg:%s", req)
-	log.Errorf("recv msg:%s", req)
-
-	return rsp, nil
-}
-
-// SayHi say hi request
-func (s *GreeterServerImpl) SayHi(ctx context.Context, req *pb.HelloRequest) (*pb.HelloReply, error) {
-	rsp := &pb.HelloReply{}
-
-	rsp.Msg = fmt.Sprintf("trpc-go-server response: Hello %s", req.Msg)
-
-	// We can dynamically adjust the logging level at runtime.
-	log.SetLevel("file", log.LevelNames[req.Msg])
-
-	log.Tracef("recv msg:%s", req)
-	log.Debugf("recv msg:%s", req)
-	log.Infof("recv msg:%s", req)
-	log.Warnf("recv msg:%s", req)
-	log.Errorf("recv msg:%s", req)
-
-	return rsp, nil
-}
-
-func main() {
-	s := trpc.NewServer()
-	pb.RegisterGreeterService(s, &GreeterServerImpl{})
-	err := s.Serve()
-	if err != nil {
-		panic(err)
-	}
-}
diff --git a/examples/features/metadata/client_test.go b/examples/features/metadata/client_test.go
deleted file mode 100644
index 721dac3..0000000
--- a/examples/features/metadata/client_test.go
+++ /dev/null
@@ -1,82 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-package main
-
-import (
-	"context"
-	"testing"
-	"time"
-
-	"github.com/stretchr/testify/assert"
-
-	_ "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/client"
-	"trpc.group/trpc-go/trpc-go/codec"
-	"trpc.group/trpc-go/trpc-go/filter"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-var addr = "ip://127.0.0.1:8000"
-
-func clientFilter(ctx context.Context, req interface{}, rsp interface{}, f filter.ClientHandleFunc) error {
-	msg := codec.Message(ctx)
-	md := msg.ClientMetaData()
-	if md == nil {
-		md = codec.MetaData{}
-	}
-	md["timestamp2"] = []byte(time.Now().String())
-	msg.WithClientMetaData(md)
-	return f(ctx, req, rsp)
-}
-
-func TestSayHello(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-		client.WithFilter(clientFilter),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	req := &pb.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHello(ctx, req)
-
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
-
-func TestSayHi(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-		client.WithMetaData("timestamp1", []byte(time.Now().String())),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	req := &pb.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHi(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
diff --git a/examples/features/metadata/main.go b/examples/features/metadata/main.go
deleted file mode 100644
index 10fc362..0000000
--- a/examples/features/metadata/main.go
+++ /dev/null
@@ -1,45 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-// Package main is the main package.
-package main
-
-import (
-	"context"
-
-	trpc "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/codec"
-	"trpc.group/trpc-go/trpc-go/examples/features/common"
-	"trpc.group/trpc-go/trpc-go/filter"
-	"trpc.group/trpc-go/trpc-go/log"
-	"trpc.group/trpc-go/trpc-go/server"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-func main() {
-	// Create a server.
-	s := trpc.NewServer(server.WithFilter(getMetaData))
-	pb.RegisterGreeterService(s, &common.GreeterServerImpl{})
-	// Start serving.
-	s.Serve()
-}
-
-func getMetaData(ctx context.Context, req interface{}, f filter.ServerHandleFunc) (interface{}, error) {
-	msg := codec.Message(ctx)
-	md := msg.ServerMetaData()
-	// Extract metadata for processing in the filter.
-	for k, v := range md {
-		log.Debugf("get metadata key : %s, value : %s", k, string(v))
-	}
-	return f(ctx, req)
-}
diff --git a/examples/features/plugin/client_test.go b/examples/features/plugin/client_test.go
deleted file mode 100644
index 8d8fa3e..0000000
--- a/examples/features/plugin/client_test.go
+++ /dev/null
@@ -1,67 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-package plugin
-
-import (
-	"context"
-	"testing"
-	"time"
-
-	"github.com/stretchr/testify/assert"
-
-	_ "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/client"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-var addr = "ip://127.0.0.1:8000"
-
-func TestSayHello(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	req := &pb.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-
-	rsp, err := clientProxy.SayHello(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
-
-func TestSayHi(t *testing.T) {
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	opts := []client.Option{
-		client.WithTarget(addr),
-	}
-
-	clientProxy := pb.NewGreeterClientProxy(opts...)
-
-	req := &pb.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := clientProxy.SayHi(ctx, req)
-	t.Log(rsp, err)
-	assert.NotNil(t, err)
-}
diff --git a/examples/features/selector/client_test.go b/examples/features/selector/client_test.go
deleted file mode 100644
index b17a118..0000000
--- a/examples/features/selector/client_test.go
+++ /dev/null
@@ -1,87 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-package main
-
-import (
-	"context"
-	"errors"
-	"flag"
-	"fmt"
-	"testing"
-	"time"
-
-	"github.com/stretchr/testify/assert"
-	trpcpb "trpc.group/trpc/trpc-protocol/pb/go/trpc"
-
-	"trpc.group/trpc-go/trpc-go/client"
-	"trpc.group/trpc-go/trpc-go/log"
-	"trpc.group/trpc-go/trpc-go/naming/registry"
-	"trpc.group/trpc-go/trpc-go/naming/selector"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-var (
-	exampleScheme      = "example"
-	exampleServiceName = "selector.example.trpc.test"
-)
-
-func TestClient(t *testing.T) {
-	flag.Parse()
-
-	ctx, cancel := context.WithTimeout(context.TODO(), time.Millisecond*2000)
-	defer cancel()
-
-	node := &registry.Node{}
-	rsphead := &trpcpb.ResponseProtocol{}
-	opts := []client.Option{
-		client.WithServiceName("trpc.test.helloworld"),
-		client.WithProtocol("trpc"),
-		client.WithNetwork("tcp4"),
-		client.WithTarget(fmt.Sprintf("%s://%s", exampleScheme, exampleServiceName)),
-		client.WithSelectorNode(node),
-		client.WithRspHead(rsphead),
-	}
-
-	proxy := pb.NewGreeterClientProxy()
-
-	req := &pb.HelloRequest{
-		Msg: "trpc-go-client",
-	}
-	rsp, err := proxy.SayHello(ctx, req, opts...)
-	log.Debugf("req:%s, rsp:%s, err:%v", req, rsp, err)
-	assert.NotNil(t, err)
-}
-
-func init() {
-	selector.Register(exampleScheme, &exampleSelector{})
-}
-
-type exampleSelector struct{}
-
-// Select 通过 service name 获取一个后端节点
-func (s *exampleSelector) Select(serviceName string, opt ...selector.Option) (*registry.Node, error) {
-	fmt.Println(serviceName)
-	if serviceName == exampleServiceName {
-		return &registry.Node{
-			Address: "127.0.0.1:8000",
-		}, nil
-	}
-
-	return nil, errors.New("no available node")
-}
-
-// Report 上报当前请求成功或失败
-func (s *exampleSelector) Report(node *registry.Node, cost time.Duration, success error) error {
-	return nil
-}
diff --git a/examples/features/selector/main.go b/examples/features/selector/main.go
deleted file mode 100644
index 618f360..0000000
--- a/examples/features/selector/main.go
+++ /dev/null
@@ -1,30 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-// Package main is the main package.
-package main
-
-import (
-	trpc "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/examples/features/common"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-func main() {
-	s := trpc.NewServer()
-	pb.RegisterGreeterService(s, &common.GreeterServerImpl{})
-	err := s.Serve()
-	if err != nil {
-		panic(err)
-	}
-}
diff --git a/examples/features/timeout/main.go b/examples/features/timeout/main.go
deleted file mode 100644
index 94c46f3..0000000
--- a/examples/features/timeout/main.go
+++ /dev/null
@@ -1,27 +0,0 @@
-//
-//
-// Tencent is pleased to support the open source community by making tRPC available.
-//
-// Copyright (C) 2023 THL A29 Limited, a Tencent company.
-// All rights reserved.
-//
-// If you have downloaded a copy of the tRPC source code from Tencent,
-// please note that tRPC source code is licensed under the  Apache 2.0 License,
-// A copy of the Apache 2.0 License is included in this file.
-//
-//
-
-// Package main is the main package.
-package main
-
-import (
-	trpc "trpc.group/trpc-go/trpc-go"
-	"trpc.group/trpc-go/trpc-go/examples/features/common"
-	pb "trpc.group/trpc-go/trpc-go/testdata/trpc/helloworld"
-)
-
-func main() {
-	s := trpc.NewServer()
-	pb.RegisterGreeterService(s, &common.GreeterServerImpl{})
-	s.Serve()
-}

From cc272f55b1ae48ad3f089eb3a808bd74ee676044 Mon Sep 17 00:00:00 2001
From: Leo <leoyoungxh@gmail.com>
Date: Mon, 13 Nov 2023 11:54:31 +0800
Subject: [PATCH 13/16] docs: add requirements for PR labels in contribution
 guide (#134)

In order to generate the changlog quickly during the release process, PR
guidelines needs to be further improved.

Improve the PR template and documentation, requiring the inclusion of
release notes in the PR description and setting appropriate labels.

RELEASE NOTES: NONE
---
 .github/PULL_REQUEST_TEMPLATE.md | 31 +++++++++++++++++++++++++++++--
 CONTRIBUTING.md                  | 31 ++++++++++++++++++++++++++++++-
 CONTRIBUTING.zh_CN.md            | 31 +++++++++++++++++++++++++++++++
 3 files changed, 90 insertions(+), 3 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index ffa153f..c7defea 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,4 +1,4 @@
-Thanks for your PR, you're awesome! 👍
+<!-- Thanks for your PR, you're awesome! 👍
 
 Please ensure you have read the [Contributing code](https://github.com/trpc-group/trpc-go/blob/main/CONTRIBUTING.md#contributing-code). 
 
@@ -10,4 +10,31 @@ The PR title should be formatted as follows: `client: remove internal info`
   - No trailing period
   - Keep the title as short as possible. ideally under 76 characters or shorter.
 
-Delete these instructions once you have read and applied them.
\ No newline at end of file
+Add one of the following type of label:
+type/bug: Fixes a newly discovered bug.
+type/enhancement: Adding tests, refactoring.
+type/feature: New functionality.
+type/documentation: Adds documentation.
+
+Optionally add any of the following type of label if applicable:
+type/api-change: Adds, removes, or changes an API.
+type/failing-test: CI test case is showing intermittent failures.
+type/performance: Changes that improves performance.
+type/ci: Changes the CI configuration files and scripts.
+-->
+
+<!--
+*Automatically closes linked issue when PR is merged.
+Usage: `Fixes #<issue number>`.
+-->
+Fixes #
+
+<!--
+Does this PR introduce a user-facing change?
+
+If no, just write "NONE" below.
+If yes, a release note is required, Enter your extended release note below.
+
+A release note needs a clear, concise description of the change. 
+-->
+RELEASE NOTES: NONE
\ No newline at end of file
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 1c45e00..3cf68ff 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -75,7 +75,8 @@ Here is an example of a good one:
 > The algorithm is described at https://wikipedia.org/wiki/McGillicutty_Algorithm
 >
 > Fixes #159
-
+>
+> RELEASE NOTES: Improved precision of Sin, Cos, and Tan for very large arguments (>1e10) 
 
 #### First line
 
@@ -102,6 +103,34 @@ When this change is eventually applied, the issue tracker will automatically mar
 - If there is a corresponding issue, add either `Fixes #12345` or `Updates #12345` (the latter if this is not a complete fix) to this comment
 - If referring to a repo other than `trpc-go` you can use the `owner/repo#issue_number` syntax: `Fixes trpc-group/tnet#12345`
 
+#### PR type label
+
+The PR type label is used to help identify the types of changes going into the release over time. This may allow the Release Team to develop a better understanding of what sorts of issues we would miss with a faster release cadence.
+
+For all pull requests, one of the following PR type labels must be set:
+
+- type/bug: Fixes a newly discovered bug.
+- type/enhancement: Adding tests, refactoring.
+- type/feature: New functionality.
+- type/documentation: Adds documentation.
+- type/api-change: Adds, removes, or changes an API.
+- type/failing-test: CI test case is showing intermittent failures.
+- type/performance: Changes that improves performance.
+- type/ci: Changes the CI configuration files and scripts.
+
+#### Release notes
+
+Release notes are required for any pull request with user-visible changes, this could mean:
+
+- User facing, critical bug-fixes
+- Notable feature additions
+- Deprecations or removals
+- API changes
+- Documents additions
+
+If the current PR doesn't have user-visible changes, such as internal code refactoring or adding test cases, the release notes should be filled with 'NONE' and the changes in this PR will not be recorded in the next version's CHANGELOG. If the current PR has user-visible changes, the release notes should be filled out according to the actual situation, avoiding technical details and describing the impact of the current changes from a user's perspective as much as possible.
+
+Release notes are one of the most important reference points for users about to import or upgrade to a particular release of tRPC-Go.
 
 ## Miscellaneous topics
 
diff --git a/CONTRIBUTING.zh_CN.md b/CONTRIBUTING.zh_CN.md
index 5e658fd..96bc5d4 100644
--- a/CONTRIBUTING.zh_CN.md
+++ b/CONTRIBUTING.zh_CN.md
@@ -69,6 +69,8 @@ tRPC-Go 中的提交消息遵循一套特定的约定，我们将在本节中讨
 > The algorithm is described at https://wikipedia.org/wiki/McGillicutty_Algorithm
 >
 > Fixes #159
+>
+> RELEASE NOTES: Improved precision of Sin, Cos, and Tan for very large arguments (>1e10) 
 
 #### 第一行
 
@@ -94,6 +96,35 @@ tRPC-Go 中的提交消息遵循一套特定的约定，我们将在本节中讨
 - 如果有相关 issue，请在此评论中添加 `Fixes #12345` 或` Updates #12345`（如果这不是完整的修复）
 - 如果涉及到的仓库不是 `trpc-go`，则可以使用 `owner/repo#issue_number` 语法：`Fixes trpc-group/tnet#12345`
 
+#### PR 类型标签
+
+PR 类型标签用于标识当前 PR 变更所属的类型，为后续发布版本提供参考。这有助于发布团队在更快的发布周期里，准确识别当前周期内所有类型的问题。
+
+对于所有 PR，必须设置以下之一的 PR 类型标签：
+
+- type/bug: 修复新发现的 bug。
+- type/enhancement: 添加测试，重构内部代码。
+- type/feature: 新功能。
+- type/documentation: 添加文档。
+- type/api-change: 添加、删除或更改 API。
+- type/failing-test: CI 测试用例偶发失败。
+- type/performance: 改进性能的变更。
+- type/ci: 更改 CI 配置文件和脚本。
+
+#### 发布说明
+
+对于任何造成用户可见更改的 PR，都需要提供发布说明。这可能包括：
+
+- 用户可见的关键 bug 修复
+- 显著的功能增加
+- 功能弃用或移除
+- API 更改
+- 文档添加
+
+如果当前 PR 没有用户可见的变更，例如代码内部重构，添加测试用例等情况，发布说明内容填为 'NONE'，这个 PR 的变更就不会记录在下个版本的 CHANGELOG 中；如果当前 PR 有用户可见的变更，发布说明内容需要按照实际情况填写，尽量不要涉及技术细节，在用户视角描述当前变更会造成的影响。
+
+发布说明是用户即将使用或升级到 tRPC-Go 特定版本时的最重要参考点之一。
+
 ## 其他主题
 
 ### 版权声明

From c2bdf24372438c858265bd0d0fa8147236edaf15 Mon Sep 17 00:00:00 2001
From: goodliu <zenghao235711@gmail.com>
Date: Mon, 13 Nov 2023 11:54:53 +0800
Subject: [PATCH 14/16] client: remove the write operation on *registry.Node in
 LoadNodeConfig to avoid data race during selecting Node (#138)

cherry-pick from internal code within the company
---
 client/client.go      |  2 +-
 client/client_test.go |  2 +-
 client/options.go     |  2 --
 client/stream.go      | 11 ++++++++++-
 4 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/client/client.go b/client/client.go
index 2fe9fdf..8860c91 100644
--- a/client/client.go
+++ b/client/client.go
@@ -393,7 +393,7 @@ func selectorFilter(ctx context.Context, req interface{}, rsp interface{}, next
 	if err != nil {
 		return OptionsFromContext(ctx).fixTimeout(err)
 	}
-	ensureMsgRemoteAddr(msg, node.Network, node.Address)
+	ensureMsgRemoteAddr(msg, findFirstNonEmpty(node.Network, opts.Network), node.Address)
 
 	// Start to process the next filter and report.
 	begin := time.Now()
diff --git a/client/client_test.go b/client/client_test.go
index c5d3273..3734816 100644
--- a/client/client_test.go
+++ b/client/client_test.go
@@ -182,7 +182,7 @@ func TestClientFail(t *testing.T) {
 		client.WithSelectorNode(node), client.WithProtocol("fake")))
 	require.Equal(t, node.Address, "127.0.0.1:8080")
 	require.Equal(t, node.ServiceName, "127.0.0.1:8080")
-	require.Equal(t, node.Network, "tcp")
+	require.Empty(t, node.Network)
 
 	// test encode failure
 	reqBody = &codec.Body{Data: []byte("failbody")}
diff --git a/client/options.go b/client/options.go
index 6ad13b1..3e665c3 100644
--- a/client/options.go
+++ b/client/options.go
@@ -695,8 +695,6 @@ func (opts *Options) LoadNodeConfig(node *registry.Node) {
 	if node.Network != "" {
 		opts.Network = node.Network
 		opts.CallOptions = append(opts.CallOptions, transport.WithDialNetwork(node.Network))
-	} else {
-		node.Network = opts.Network
 	}
 	if node.Protocol != "" {
 		WithProtocol(node.Protocol)(opts)
diff --git a/client/stream.go b/client/stream.go
index d613fc0..a40ac8e 100644
--- a/client/stream.go
+++ b/client/stream.go
@@ -154,7 +154,7 @@ func (s *stream) Init(ctx context.Context, opt ...Option) (*Options, error) {
 		report.SelectNodeFail.Incr()
 		return nil, err
 	}
-	ensureMsgRemoteAddr(msg, node.Network, node.Address)
+	ensureMsgRemoteAddr(msg, findFirstNonEmpty(node.Network, opts.Network), node.Address)
 	const invalidCost = -1
 	opts.Node.set(node, node.Address, invalidCost)
 	if opts.Codec == nil {
@@ -166,6 +166,15 @@ func (s *stream) Init(ctx context.Context, opt ...Option) (*Options, error) {
 	return s.opts, nil
 }
 
+func findFirstNonEmpty(ss ...string) string {
+	for _, s := range ss {
+		if s != "" {
+			return s
+		}
+	}
+	return ""
+}
+
 // Invoke implements Stream.
 func (s *stream) Invoke(ctx context.Context) error {
 	return s.opts.StreamTransport.Init(ctx, s.opts.CallOptions...)

From 3fde950858bed56a9afc6db021230cf99fd22ae9 Mon Sep 17 00:00:00 2001
From: Bo Yan <cooperyan@tencent.com>
Date: Mon, 13 Nov 2023 16:14:03 +0800
Subject: [PATCH 15/16] server: explain more aboud MaxRoutines option (#137)

---
 config.go         | 4 +++-
 server/options.go | 2 ++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/config.go b/config.go
index bfa2441..6ea24e6 100644
--- a/config.go
+++ b/config.go
@@ -530,7 +530,9 @@ type ServiceConfig struct {
 	TLSCert           string   `yaml:"tls_cert"`               // Server TLS certificate.
 	CACert            string   `yaml:"ca_cert"`                // CA certificate to validate client certificate.
 	ServerAsync       *bool    `yaml:"server_async,omitempty"` // Whether to enable server asynchronous mode.
-	// Maximum number of goroutines for server asynchronous mode.
+	// MaxRoutines is the maximum number of goroutines for server asynchronous mode.
+	// Requests exceeding MaxRoutines will be queued. Prolonged overages may lead to OOM!
+	// MaxRoutines is not the solution to alleviate server overloading.
 	MaxRoutines int    `yaml:"max_routines"`
 	Writev      *bool  `yaml:"writev,omitempty"` // Whether to enable writev.
 	Transport   string `yaml:"transport"`        // Transport type.
diff --git a/server/options.go b/server/options.go
index 55d9907..177a05d 100644
--- a/server/options.go
+++ b/server/options.go
@@ -215,6 +215,8 @@ func WithWritev(writev bool) Option {
 // MaxRoutines should be set to twice as expected number of routines (can be calculated by expected QPS),
 // and larger than MAXPROCS.
 // If MaxRoutines is not set or set to 0, it will be set to (1<<31 - 1).
+// Requests exceeding MaxRoutines will be queued. Prolonged overages may lead to OOM!
+// MaxRoutines is not the solution to alleviate server overloading.
 func WithMaxRoutines(routines int) Option {
 	return func(o *Options) {
 		o.ServeOptions = append(o.ServeOptions, transport.WithMaxRoutines(routines))

From edc110563e1620608cd349a4a9f3caab656c2475 Mon Sep 17 00:00:00 2001
From: wineandchord <guoqizhou19@gmail.com>
Date: Thu, 30 Nov 2023 22:11:05 +0800
Subject: [PATCH 16/16] http: invite back default http server transport (#140)

Add default http server transport
---
 http/transport.go | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/http/transport.go b/http/transport.go
index b3d9331..980c35a 100644
--- a/http/transport.go
+++ b/http/transport.go
@@ -49,6 +49,8 @@ import (
 
 func init() {
 	st := NewServerTransport(func() *stdhttp.Server { return &stdhttp.Server{} })
+	DefaultServerTransport = st
+	DefaultHTTP2ServerTransport = st
 	// Server transport (protocol file service).
 	transport.RegisterServerTransport("http", st)
 	transport.RegisterServerTransport("http2", st)
@@ -60,6 +62,12 @@ func init() {
 	transport.RegisterClientTransport("http2", DefaultHTTP2ClientTransport)
 }
 
+// DefaultServerTransport is the default server http transport.
+var DefaultServerTransport transport.ServerTransport
+
+// DefaultHTTP2ServerTransport is the default server http2 transport.
+var DefaultHTTP2ServerTransport transport.ServerTransport
+
 // ServerTransport is the http transport layer.
 type ServerTransport struct {
 	newServer func() *stdhttp.Server