版本-测试与变更记录
本页整理 wssocks-plugin-ustb 在现有资料中可以核实的版本线索、发布渠道和客户端交付形式，并说明测试及变更记录信息的可见范围。当前材料只有项目 README 摘录；它不足以还原自动化测试、发布流水线或逐版本变更明细。
目的与范围
本页关注如何识别项目版本相关信息、选择稳定版或夜间版下载渠道，以及在排查发布问题时区分已经明确记载的事实与尚待验证的实现。客户端的代理配置、连接机制和具体使用方法不属于本页范围；这里不根据项目简介推测它们的内部实现。
概览
项目是基于 wssocks 的 USTB 内网访问插件。README 说明，命令行客户端 cli 和通用图形客户端 client-ui 均包含 wssocks 与该插件；此外还提供 macOS 原生 swiftui-client。版本信息在现有资料中主要以功能首次提供的版本标注出现，而不是完整的发布日志。
| 可核实的版本线索 | README 所述内容 | 解读边界 |
|---|---|---|
| v0.5.0 起 | 提供基于 Fyne 的 client-ui 图形客户端 | 不能据此推断之前各版本的其他变更。 |
| v0.6.0、v0.7.0 起 | 提供基于 SwiftUI 的 macOS 原生客户端 | 原文同时提及两个版本，但未列出各版本分别引入了哪些修改。 |
| 未指定版本 | 提供命令行客户端 cli | 没有可核实的首次引入版本。 |
发布结构与交付范围
README 将交付物区分为命令行、跨平台图形界面和 macOS 原生应用，并分别列出适用平台。下图只表示这些明确列出的交付物与平台关系，不表示构建任务之间存在依赖或共享同一发布作业。
Source: README 摘录第 15–28 行；运行时未提供 File Reference Base URL，无法构造符合要求的仓库文件链接。
| 客户端 | README 标注的平台 | 稳定版交付物识别信息 |
|---|---|---|
cli | Windows x64、macOS x64/arm64、Linux x64/arm64 | GitHub releases 中的 wssocks-ustb-$OS-$ARCH。 |
client-ui | Windows x64、macOS x64/arm64 | GitHub releases 中的 client-ui-$OS-$ARCH。 |
swiftui-client | macOS x64/arm64 | 发布页中名称形如 wssocks-ustb-client-macOS-*.app.zip 的应用压缩包。 |
这些是 README 中的文件名形式和支持平台描述；资料没有说明具体版本号的命名规则、归档内容、签名、校验和或发布资产是否对每个平台始终齐全。
发布渠道与选择流程
README 把 GitHub releases 指为稳定版客户端下载渠道；希望尝试新功能的使用者则可以从 OSDN 下载夜间版本。页面顶部还展示了指向 release.yml 的 Release 徽章，但仅凭徽章链接不能判断触发条件、构建矩阵、测试门禁、版本生成或上传过程。
Source: README 摘录第 15–19、30–44 行；运行时未提供 File Reference Base URL，无法构造符合要求的仓库文件链接。
上图中的资产模式仅对应 README 对稳定版的说明；README 没有给出夜间版的资产名称，不能把稳定版命名规则直接套用到 OSDN。选择客户端时还应核对操作系统和架构，例如 README 并未把 Linux 列为图形客户端的支持平台。
安装与发布入口
README 提供两种命令行客户端获取途径：使用 Go 命令获取并运行帮助命令，或者从 GitHub releases 下载按系统与架构命名的文件。图形客户端则通过发布页获取。现有材料没有指定 Go 版本、依赖安装方式或 GUI 应用的安装步骤，因此不能将 README 中的下载说明等同于可复现的构建指导。
| 入口 | 已明确的信息 | 未明确的信息 |
|---|---|---|
| Go 命令 | README 给出 go get -u github.com/genshen/wssocks-plugin-ustb/wssocks-ustb，然后执行 wssocks-ustb --help。 | Go 工具链版本、模块兼容性以及安装后可执行文件的实际位置。 |
| 稳定版发布页 | README 指向项目 GitHub releases，并提供三类客户端的文件名识别信息。 | 发布频率、版本支持周期及资产校验方式。 |
| OSDN 夜间版 | README 明确将其定位为尝试新功能的下载渠道。 | 夜间版的构建时间、来源提交、保留周期及与稳定版的差异清单。 |
版本与变更记录
可见的变更线索只有 client-ui 从 v0.5.0 开始提供，以及 macOS 原生 swiftui-client 与 v0.6.0、v0.7.0 的关联。README 没有逐版本新增功能、修复、破坏性变更、迁移步骤或发布时间表，因此本页不能充当完整 changelog。若需要判断某项修改首次出现在哪个版本，应进一步核对对应发布页或仓库中的变更记录；这些内容在当前材料中不可验证。
测试与发布验证
README 顶部的 Release 徽章证明项目公开展示了一个名为 release.yml 的工作流入口链接，并不证明其中运行了哪些测试，或这些测试是否是发布前置条件。目前没有测试源文件、CI 工作流内容、测试命令、测试覆盖率或失败重试策略可供核查。实现细节未在现有资料中找到；因此本页不声称项目具有特定单元测试、集成测试、跨平台自动化测试或人工验收流程。
对发布资产进行排查时，能直接依据 README 核对的是客户端类别、标称平台、发布渠道和稳定版的文件名形式；资产实际是否存在、能否运行以及是否与特定版本对应，需要在实际发布页面和目标平台上验证。夜间版用于尝试新功能这一定位也不构成稳定性保证。
限制与后续核查点
- 构建配置：没有读取到实际工作流或构建脚本；不能说明构建触发器、编译参数、依赖缓存及上传步骤。
- 测试策略：没有读取到测试目录或执行配置；不能说明覆盖范围、门禁标准或跨平台验证结果。
- 版本管理：没有读取到标签规则、发布脚本或 changelog；不能推断语义化版本约定和升级兼容性。
- 发布安全性：没有读取到签名、哈希或供应链校验信息；下载后校验方式未在现有资料中给出。
相关链接
- 项目 README：客户端分类、平台和下载方式的现有资料出处。
- 稳定版发布页：README 指定的正式版本下载入口。
- Release 工作流入口：README 徽章指向的工作流页面；具体配置尚未核查。
- OSDN 夜间版：README 指定的夜间版本下载入口。
- 项目文档：README 提供的中文文档入口。