Add GitHub Actions and Codecov usage guide

[pionxe]

概述

为仓库的 GitHub Actions 和 Codecov 工作流添加了一份面向初学者的指南。

主要内容

• 解释 GitHub Actions 的基础知识。

• 介绍 Codecov 的基本概念及其覆盖率工作流。

• 详细说明仓库当前的 CI 运行逻辑。

• 文档化了配置步骤、日常用法以及常见问题排查。

注意事项

• 该指南已与合并至 main 分支的 CI 工作流保持同步。

• 本 PR 仅包含文档更新。

Fixes #44

[codecov]

Welcome to Codecov 🎉

Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests.

ℹ️ You can also turn on project coverage checks and project coverage reporting on Pull Request comment

Thanks for integrating Codecov - We've got you covered ☂️

[minorcell]

代码审查总结

本次 PR 包含两部分改动：

1. 代码重构：将 UTF-8 模式设置函数从 中提取，使用 Go build tag 分成 和 两个平台特定文件。这是正确的做法，避免了运行时的 判断，改为编译时的条件编译。
2. 文档新增：添加了一份面向初学者的 GitHub Actions + Codecov 使用指南。

整体方向良好，以下是具体的审查意见。

[minorcell]

潜在问题：未检查 syscall 调用的返回值

syscall.NewLazyDLL 调用的是系统 DLL，如果 kernel32.dll 加载失败或者找不到对应函数，NewProc 不会报错，但实际调用时会 panic。建议至少对 .Find() 结果进行检查，或者使用 golang.org/x/sys/windows 包中更安全的 API。

例如：

import "golang.org/x/sys/windows"

func setUTF8Mode() {
    windows.SetConsoleOutputCP(65001)
    windows.SetConsoleCP(65001)
}

使用 golang.org/x/sys/windows 包更符合 Go Windows 编程的最佳实践，且有明确的错误返回值。

[pionxe]

已采纳该建议。当前实现已从 syscall.NewLazyDLL 切换为 golang.org/x/sys/windows 的显式 API，并补充了错误处理。现在设置控制台输入/输出编码失败时会输出警告，但不会中断程序启动，这样既提升了安全性和可维护性，也避免了潜在的 panic 风险。

[minorcell]

未处理调用返回的错误

setConsoleOutputCP.Call() 和 setConsoleCP.Call() 实际上会返回三个值：(r1, r2 uintptr, err error)。当前代码忽略了所有返回值，如果设置失败不会有任何提示。

建议至少记录一条警告日志，例如：

r1, _, err := setConsoleOutputCP.Call(uintptr(65001))
if r1 == 0 {
    // 设置失败，可以记录日志但无需中断程序
    _ = err
}

[pionxe]

当前实现已不再使用 syscall.NewLazyDLL / Proc.Call，而是改为 golang.org/x/sys/windows 的 SetConsoleOutputCP / SetConsoleCP，并对返回的 error 做了显式处理。设置失败时会输出警告，但不会中断程序启动。

[minorcell]

建议：考虑是否需要支持 Linux/macOS 的 UTF-8 设置

非 Windows 系统（Linux/macOS）默认 locale 通常是 UTF-8，但并不绝对。当前非 Windows 平台的 setUTF8Mode() 是空函数，这在绝大多数情况下没有问题。

但若要更严谨，可以在此文件中添加注释说明为什么非 Windows 系统不需要此操作，例如：

// setUTF8Mode 在非 Windows 系统上是空操作。
// Linux 和 macOS 默认使用 UTF-8 编码，无需额外设置。
func setUTF8Mode() {}

这样有助于后续维护者理解代码意图。

[pionxe]

已添加相应注释

[minorcell]

文档整体质量很高，内容详实，结构清晰，非常适合初学者。以下几点小建议供参考：

1. 文件名 GitHub_Actions_Codecov_Guide.md 使用了下划线，建议统一为连字符风格 github-actions-codecov-guide.md，这也是 GitHub 文档和大多数开源项目的惯例。
2. 可以考虑在 docs/ 目录下添加一个简短的 README.md 或在根目录的 README 中添加指向此文档的链接，便于团队成员发现这份指南。

[pionxe]

已更改文件名，符合GitHub 文档惯例，同时在根目录的README中添加了文档导航部分，将docs目录中已有的都链接上了。

[minorcell]

文档与实际 CI 配置存在细微差异

文档中 Setup Go 步骤命名为 Set up Go（第 7.6 节），而实际 .github/workflows/ci.yml 文件中该步骤名称为 Setup Go（无空格）。虽然是小细节，但建议保持文档与实际配置一致，避免初学者对照时产生困惑。

实际 ci.yml 中：

- name: Setup Go

文档中描述的是：

- name: Set up Go

[pionxe]

已把第 7.6 节里的步骤名从 Set up Go 改成了和实际 CI 完全一致的 Setup Go

[minorcell]

文档中引用了不存在于仓库的 Action 版本，请核实

文档中提到 actions/checkout@v5 和 actions/setup-go@v6，但目前（2024-2025 年）常用的稳定版本是：

• actions/checkout@v4
• actions/setup-go@v5

请确认实际 ci.yml 中使用的版本，并确保文档与实际配置保持一致。如果已升级到 v5/v6，建议在文档中说明版本选择的理由。

[pionxe]

已在第 7 节前面补了说明，明确“文档以仓库当前 .github/workflows/ci.yml 为准”，并解释为什么这里使用的是 actions/checkout@v5 和 actions/setup-go@v6

[minorcell]

建议：在第 13.1 节增加 golangci-lint 的说明

当前文档在推荐的后续增强中只提到了 go fmt 和 go vet，建议同时提到 golangci-lint，这是 Go 社区最广泛使用的综合静态分析工具，能发现 go vet 无法捕获的更多问题。

示例配置可参考：

- name: Lint
  uses: golangci/golangci-lint-action@v6
  with:
    version: latest

[pionxe]

已在第 13.1 节补充了 golangci-lint 说明和示例配置