海棠云螭的博客

GenshinConvert授权码

Tue, 20 Jan 2026 01:07:51 +0800

65D5DA733F6C4A62BFB5542A9837BE9B---已激活

0E1E36BBC5A948C7A37D05856FB240D3---已激活

F9DC6BD279AF4E639DF51D43B076227F---已激活

26F5984547B64A918B20936E6FF609B6---已激活

0E9FA37CF1E94DE3B8AA173FECAE1B42---已激活

B337EFF766D94964933D5A5BCB0344D8---已激活

A5F4FC9D93C94ED0ACFEE218F034862B---已激活

CC33F3E4B4F84437BB6A45D753FEB34F---未激活

3C49B2157B1541279431D1E8AFFBE9BF---未激活

7EC77DE8C5EF4B3CB4B0B6449DB18161---未激活

DD368CE05BCC4A019A34D20E7EEFC3D0---未激活

3A9B133A56124661B25CA58E466A67ED---未激活

642D02A57AD1468893251B81C7BCC7F0---未激活

2E9ECD1242CA458A9D9715DA2C6B31A7---未激活

5EE84DD41A8D4F43BDD2DB8FDB615C78---未激活

5DE37F21508A42549BB67AB9CA2F729E---未激活

167A6557B65744198D96BBCA869E8D53---已激活

2305873E1EBA434081525114D5F63B19---未激活

7784A0A4D14444EE9EA8A336C37F9ADD---已激活

B98D3BE6B78048E1B5A39D148FE5545C---已激活

D3F618ADB434476DAD148D40009E0FBC---未激活

342D301FD22441579D22B3783D1AFF16---未激活

C36A4AA6D8F44D86861ADB45968EA1FC---未激活

5EA1D05F70204B7DBCBDFCFA3B1DA838---已激活

5C8D4AC0920B4D54849FCB63ADDDECE9---未激活

0617D09B4F924B3E85C8D75B3D721139---已激活

85849C08D6914C2F989C363C56A55E2C---未激活

47F6F1747BC94E439A12CA1B12618536---未激活

A6FF997053C44D9D8441CC52D36DC9CB---未激活

87330809D69D47D8B75CEBA4EA022734---未激活

C487497379E3494491D1AB4C9C284E6B---已激活

A45FA96B72B249BB8D35D89A05D1C740---未激活

3C5C39A104324A38A6EEBB48947F2FC1---未激活

9F1D99914A9D4EFDB9B554D5D0CF446D---未激活

3ED382E706E44F5599121C986B45846C---未激活

FA52C75D9BD643A4B4D6CD9D11FE1D04---未激活

D54ADC13DC2B4CADA956D777329ACB39---未激活

EA35B92727D04C939A597A41CD58EBB1---未激活

A0344646B5134BC18E049403B2E81436---已激活

361897DDAC234309B1422C23F7842386---未激活

964FBF3B307D4055B26D453C80AE5D9E---未激活

30C4498032AD4A519E46B93EC952D07F---未激活

D41959A5564349B49E9EE643E6216CE8---未激活

418A08884A6A4E18B7D495095629CD26---未激活

187143ACE9674C34B9DB607F847D22B2---已激活

40926940FA944027A74039EA99848F21---未激活

25CD6974FECD4224BC8DCF7541219456---已激活

1948C89B0BF2452F84BB1749DAFFB459---未激活

AB10392B49EF43168B55E149568EDC4D---未激活

3A69BE2E93604C5C82F9EEA0E9216FD4---未激活

7DB30856916A4635A8C2529B4138B22B---已激活

5E90C0043B844A0EBE33AF6EAF112246---未激活

5BF6A36CBA694365A5A5DDCA94F4FE10---未激活

318D57DB9C424172A8E929D49E9C707E---未激活

8B5F075DDB2148EFA38E58AA9790CB40---已激活

226BFF1C7C7C448DA47410FDD156B1CE---已激活

DF638341866843B6BA3C584633702206---已激活

CEC44A8FD7DC4BD6994A3B75D627E559---已激活

6EFBD617325F46AB98E3E0EB25707D54---已激活

36B22461134145168013050E5CBF0313---已激活

57C470FFD0E44FC6ABBAE791B66D239C---已激活

BE7D365409F849C1B5F8397A508550AD---已激活

DD739E90006547EB9C9034F466F9279E---已激活

AEADB830A3FE4FB98CC42DE71BA862EF---已激活

5F5DBA4BC7A24071B60E32B6AB21B6D7---已激活

B995958ECCC34724885B6E7A39862D44---已激活

C8F11EB245E24F2497834BB558EDDB44---已激活

87D1C27498C24553867F5F65F1350DB8---已激活

1661C92193104FA0AE8C63A157A63FC3---已激活

BA9279787C9C4F05973BA67B141C1B74---未激活

A5C88D88320843EB88956B6104581ABF---未激活

0127C6580F224A2C862B8841E06B92A9---未激活

C426A9851664411D99F73A6C1709650C---未激活

59956297B7D840FEB93695B46CADE855---未激活

0462B805D1414CE4886E08A55421D611---未激活

6E2D97578E8147D29253CB7DF007065C---未激活

47BD0288ADC94AA3B50B0A534714D3A2---未激活

6EB8978A52814DA6A8E50CA8B6E02CA7---未激活

4C9FF0AAEC7E42C0807AC9A44BA22C0C---未激活

A8BEE18C5A574A8897FCAF4FFADE09F6---未激活

2D6947ADBA9E442D98B88D9E1CFA3F25---未激活

65FA9F4D6F4542BA8874A8636CC7094F---未激活

7CD3D76D5CA04CE3BD529B363AA40221---未激活

29F50ABF7E334F5BA4F8EA9429941C97---未激活

1B95EF80D6534A38B4F7B1976DCC6097---未激活

F89C694FF39F402D92E32DB4BB560674---未激活

19E44F44EE9146FB86175D4429A5E2BD---已激活

6F35820280E74EABAA06C2DA9E22C974---未激活

5403E013E6934FCD870929E97B1078EE---未激活

39B738981C9C4E8A95F100D8AC7DEE0C---已激活

76E1507D848A4E7C878416DF10AA7B76---未激活

14DC647218B947AC9F9F36E46EF07940---未激活

E07E862B15624C758AD27B05E17FF410---未激活

87F3361C1E9D4E2FA681A046CC6FEA26---未激活

7DC5BB8E25394EF3B544684CD0061E33---未激活

A437446265BB4186818B272A51F3B9A0---已激活

A602AA97221441A78805AB0DB6B9677B---已激活

7C0AE811DCAD43B0A44D371A2DABCB34---已激活

C934377F47C346F7BE67FFB52AE857E0---未激活

7ACEAF8749D64CC5BE1CA08C8D59221D---已激活

0A3B1DC9B41B47C8953EC604A3ADA931---已激活

8FCC090C1F08411CB3833AF6346C9091---已激活

1CDEB2CC3F414E84BA894655E753194C---已激活

HaiTang.Library.Api2018k 库调用说明文档

Sat, 06 Dec 2025 16:28:43 +0800

HaiTang.Library.Api2018k 库调用说明文档

概述

HaiTang.Library.Api2018k 是一个用于与 2018k.cn 网络验证系统交互的 .NET 类库，提供软件更新、用户管理、卡密验证、云变量操作、后台管理等功能。库中包含三个主要部分：

Update 类：客户端核心功能，用于获取软件信息、验证卡密、管理用户、操作云变量等。
AdminSDK 类：后台管理功能，用于登录后台、管理软件、卡密等。
Tools 工具类：提供机器码生成、加密解密、随机字符串、类型转换等辅助方法。
Log 日志类：基于 NLog 的简单日志封装，按天输出到文件。

所有异步方法均返回 Task 或 Task<T>，使用时请使用 await 或适当方式等待。

命名空间引用

using HaiTang.Library.Api2018k;
using HaiTang.Library.Api2018k.SDK;   // 后台管理相关

1. `Update` 类 – 客户端核心功能

1.1 初始化与软件信息

`InitializationAsync`

初始化软件实例，获取软件配置信息。此方法是后续大多数方法的前置调用。

public async Task<(bool Success, Mysoft? config)> InitializationAsync(
    string ID, 
    string key, 
    string? Code = null)

参数

名称	类型	说明
`ID`	`string`	程序实例ID（软件ID），由2018k后台生成
`key`	`string`	OpenID（开发者密钥），后台获取
`Code`	`string?`	机器码，若为 `null` 将自动调用 `Tools.GetMachineCodeEx()` 获取本机机器码

返回值

Success：是否成功获取有效软件信息（config.author != null）。
config：Mysoft 对象，包含软件全部信息；若失败则为 null。

异常

Exception：网络请求异常或数据解析异常时抛出，但方法内部已捕获并记录日志，返回 (false, null)。

示例

// 初始化，使用自动获取的机器码
var update = new Update();
var (success, config) = await update.InitializationAsync("soft123", "your-openid-key");
if (success)
{
    Console.WriteLine($"软件名称：{config.softwareName}");
    Console.WriteLine($"版本号：{config.versionNumber}");
}
else
{
    Console.WriteLine("初始化失败，请检查网络或软件ID");
}

`GetSoftCheck` [过时]

检查软件实例是否正常。

[Obsolete("合并到InitializationAsync()方法中，2027年01月01日正式禁用此方法", false)]
public async Task<bool> GetSoftCheck()

说明此方法已过时，建议直接使用 InitializationAsync 获取完整信息。因为它内部调用 InitializationAsync 并仅返回成功状态。

示例

bool isOk = await update.GetSoftCheck();

获取软件信息的各个属性方法

以下方法均从缓存的 Mysoft 对象中提取特定字段，若缓存失效会自动调用 InitializationAsync 刷新。

方法	返回值	说明
`GetSoftwareID()`	`Task<string>`	软件实例ID
`GetVersionNumber()`	`Task<string>`	软件版本号
`GetSoftwareName()`	`Task<string>`	软件名称
`GetVersionInformation()`	`Task<string>`	版本更新内容
`GetNotice()`	`Task<string>`	公告信息
`GetDownloadLink()`	`Task<string>`	下载链接
`GetNumberOfVisits()`	`Task<string>`	访问量（字符串形式）
`GetMiniVersion()`	`Task<string>`	最低支持版本号
`GetIsItEffective()`	`Task<bool>`	卡密当前是否有效
`GetExpirationDate()`	`Task<string>`	卡密过期时间戳（毫秒）
`GetRemarks()`	`Task<string>`	授权备注
`GetNumberOfDays()`	`Task<int>`	授权有效天数（永久为 99999）
`GetNetworkVerificationId()`	`Task<string>`	卡密ID
`GetTimeStamp()`	`Task<long>`	服务器时间戳（毫秒）
`GetMandatoryUpdate()`	`Task<bool>`	是否强制更新
`GetSoftwareMd5()`	`Task<string>`	软件 MD5

示例

string version = await update.GetVersionNumber();
bool isEffective = await update.GetIsItEffective();
long serverTime = await update.GetTimeStamp();
Console.WriteLine($"当前版本：{version}，卡密有效：{isEffective}");

1.2 云变量操作

`GetCloudVariables`

获取指定云变量的值。

public async Task<string> GetCloudVariables(string VarName)

参数

名称	类型	说明
`VarName`	`string`	云变量名称

返回值变量值字符串；若变量不存在或获取失败，返回常量 "<空>"（_error）。

示例

string bgColor = await update.GetCloudVariables("background_color");
if (bgColor != "<空>")
{
    Console.WriteLine($"背景色设置为：{bgColor}");
}

`GetCloudVarArray`

获取所有云变量，返回一个 JSON 对象。

public async Task<string> GetCloudVarArray()

返回值格式化后的 JSON 字符串，格式如 { "key1": "value1", "key2": "value2" }。

示例

string allVars = await update.GetCloudVarArray();
Console.WriteLine(allVars);
// 输出：
// {
//   "welcome_message": "欢迎使用",
//   "max_users": "100"
// }

`updateCloudVariables`

修改或新增云变量。

public async Task<(bool success, string message)> updateCloudVariables(
    string VarKey, 
    string Value)

参数

名称	类型	说明
`VarKey`	`string`	变量名
`Value`	`string`	要设置的值

返回值

success：操作是否成功。
message：成功时返回设置的键值对 JSON（如 {"key":"bg_color","value":"blue"}），失败时返回错误信息。

示例

var (ok, msg) = await update.updateCloudVariables("theme", "dark");
if (ok)
{
    Console.WriteLine("云变量更新成功：" + msg);
}
else
{
    Console.WriteLine("更新失败：" + msg);
}

1.3 卡密操作

`ActivationKey`

激活卡密（绑定当前机器码）。

public async Task<(bool success, string message)> ActivationKey(string authId)

参数

名称	类型	说明
`authId`	`string`	卡密ID（从后台获取或用户输入）

返回值

success：是否激活成功。
message：成功返回“授权成功”，失败返回错误原因。

示例

var (ok, msg) = await update.ActivationKey("1CDEB2CC3F414E84BA894655E753194C");
if (ok)
{
    MessageBox.Show("激活成功！");
}
else
{
    MessageBox.Show("激活失败：" + msg);
}

`CreateNetworkAuthentication`

创建卡密（需要管理员权限，通常用于后台自动生成）。

public async Task<string> CreateNetworkAuthentication(int day, string remark, string ID)

参数

名称	类型	说明
`day`	`int`	有效天数（例如 30 表示30天，若要永久可尝试传入 0 或 99999，但需确认后端支持）
`remark`	`string`	卡密备注
`ID`	`string`	程序实例ID（软件ID）

返回值格式化的 JSON 字符串，包含新创建的卡密信息，如：

{
  "code": 200,
  "data": "1CDEB2CC3F414E84BA894655E753194C",
  "message": "请求成功"
}

示例

string result = await update.CreateNetworkAuthentication(30, "测试卡密", "soft123");
Console.WriteLine(result);

`ReplaceBind`

解绑或换绑机器码。

public async Task<(bool success, string message)> ReplaceBind(
    string AuthId, 
    string? Code = null)

参数

名称	类型	说明
`AuthId`	`string`	卡密ID
`Code`	`string?`	新机器码；若为 `null` 则执行解绑（清除绑定的机器码）

返回值

success：操作是否成功。
message：成功返回“解|换绑成功”，失败返回错误信息。

示例

// 解绑
var (ok1, msg1) = await update.ReplaceBind("AUTH-123456");
// 换绑到新机器码
string newCode = Tools.GetMachineCodeEx();
var (ok2, msg2) = await update.ReplaceBind("AUTH-123456", newCode);

`GetRemainingUsageTime`

获取卡密剩余使用时间。

public async Task<long> GetRemainingUsageTime()

返回值

-1：永久有效。
0：已过期。
1：未注册（无有效卡密或未激活）。
>0：剩余毫秒数。

示例

long remaining = await update.GetRemainingUsageTime();
if (remaining == -1)
    Console.WriteLine("永久授权");
else if (remaining == 0)
    Console.WriteLine("已过期");
else if (remaining == 1)
    Console.WriteLine("未注册");
else
    Console.WriteLine($"剩余：{TimeSpan.FromMilliseconds(remaining).TotalDays:F1} 天");

`GetNetworkCode`

获取验证码（用于用户注册等需要验证码的场合）。

public async Task<string> GetNetworkCode()

返回值验证码字符串（例如 "8A3F"）。

示例

string captcha = await update.GetNetworkCode();
Console.WriteLine("验证码：" + captcha);

1.4 用户相关方法

`CustomerRegister`

注册新用户。

public async Task<bool> CustomerRegister(
    string email, 
    string password, 
    string? nickName = null, 
    string? avatarUrl = null, 
    string? captcha = null)

参数

名称	类型	说明
`email`	`string`	用户邮箱（作为登录账号）
`password`	`string`	密码
`nickName`	`string?`	昵称（可选）
`avatarUrl`	`string?`	头像地址（可选）
`captcha`	`string?`	验证码（可选，需要时从 `GetNetworkCode()` 获取）

返回值注册成功返回 true，否则 false。

示例

bool regOk = await update.CustomerRegister(
    email: "user@haitangyunchi.com",
    password: "123456",
    nickName: "测试用户",
    captcha: await update.GetNetworkCode()
);
if (regOk)
    Console.WriteLine("注册成功");

`InitializationUserAsync`

初始化用户会话，获取用户信息。后续用户相关方法需先调用此方法（或确保 Constants.EMAIL 和 Constants.PASSWORD 已设置）。

public async Task<UserInfo> InitializationUserAsync(
    string ID, 
    string key, 
    string email, 
    string password)

参数

名称	类型	说明
`ID`	`string`	软件ID
`key`	`string`	OpenID
`email`	`string`	用户邮箱
`password`	`string`	用户密码

返回值UserInfo 对象；若失败则返回空对象（所有字段为空）。

示例

UserInfo user = await update.InitializationUserAsync("soft123", "your-key", "user@haitangyunchi.com", "pass");
if (!string.IsNullOrEmpty(user.CustomerId))
{
    Console.WriteLine($"欢迎 {user.Nickname}");
}

`GetUserInfo`

获取当前已初始化用户的完整信息。

public async Task<UserInfo> GetUserInfo()

返回值UserInfo 对象（若未初始化，返回空对象）。

示例

UserInfo info = await update.GetUserInfo();
Console.WriteLine($"用户ID：{info.CustomerId}");

用户信息属性获取方法

以下方法均从 UserInfo 缓存中提取特定字段。

方法	返回值	说明
`GetUserId()`	`Task<string>`	用户ID
`GetUserAvatar()`	`Task<string>`	用户头像URL
`GetUserNickname()`	`Task<string>`	用户昵称
`GetUserEmail()`	`Task<string>`	用户邮箱
`GetUserBalance()`	`Task<int>`	账户余额/剩余天数（需根据业务含义）
`GetUserLicense()`	`Task<bool>`	是否已授权（`License == "y"`）
`GetUserTimeCrypt()`	`Task<string>`	登录时间戳

示例

string uid = await update.GetUserId();
int balance = await update.GetUserBalance();
bool licensed = await update.GetUserLicense();

`Recharge`

使用卡密为用户充值（增加账户余额/有效期）。

public async Task<string> Recharge(string AuthId)

参数

名称	类型	说明
`AuthId`	`string`	卡密ID

返回值接口返回的原始 JSON 字符串。

示例

string rechargeResult = await update.Recharge("8B5F075DDB2148EFA38E58AA9790CB40");
Console.WriteLine(rechargeResult);

1.5 消息发送

`MessageSend`

发送一条消息到服务器（可用于记录日志或向开发者发送通知）。

public async Task<string> MessageSend(string message)

参数

名称	类型	说明
`message`	`string`	要发送的消息内容

返回值格式化的 JSON 响应。

示例

string response = await update.MessageSend("用户点击了开始按钮");
Console.WriteLine(response);

1.6 缓存控制静态方法

这些方法用于操作 Update 类内部的静态缓存（软件信息、用户信息），通常不需要手动调用，除非需要强制刷新。

方法	说明
`GetCachedSoftwareInfo()`	获取缓存的软件信息对象
`SetCachedSoftwareInfo(bool success, Mysoft softwareInfo)`	设置软件信息缓存
`IsCacheValid()`	检查软件信息缓存是否有效（5分钟内）
`ClearStaticCache()`	清除软件信息缓存
`GetCachedUserInfo()`	获取缓存的用户信息对象
`SetCachedUserInfo(UserInfo userInfo)`	设置用户信息缓存
`IsUserCacheValid()`	检查用户信息缓存是否有效（5分钟内）
`ClearUserCache()`	清除用户信息缓存

示例

// 强制清除缓存，下次获取时会重新请求网络
Update.ClearStaticCache();
Update.ClearUserCache();

2. `AdminSDK` 类 – 后台管理功能

所有方法必须先调用 LoginAsync 成功登录，否则会抛出 InvalidOperationException。

`LoginAsync`

登录后台管理系统。

public async Task<(bool Success, string Message)> LoginAsync(string account, string password)

参数

名称	类型	说明
`account`	`string`	后台账号
`password`	`string`	密码

返回值

Success：登录是否成功。
Message：成功时返回 Token（会自动保存在 Token 属性中），失败时返回错误信息。

示例

var admin = new AdminSDK();
var (ok, token) = await admin.LoginAsync("admin", "123456");
if (ok)
{
    Console.WriteLine("登录成功，Token：" + token);
}

`GetSoftwareIdsAsync`

获取软件ID列表。

public async Task<List<string>> GetSoftwareIdsAsync(long maxCount = 10)

参数

名称	类型	说明
`maxCount`	`long`	最大返回数量（默认10）

返回值软件ID字符串列表。

示例

List<string> ids = await admin.GetSoftwareIdsAsync(20);
foreach (string id in ids)
{
    Console.WriteLine(id);
}

`GetSoftwareInfoByIdAsync`

根据软件ID获取详细信息。

public async Task<SoftwareInfo> GetSoftwareInfoByIdAsync(
    string softwareId, 
    long maxCount = 10)

参数

名称	类型	说明
`softwareId`	`string`	软件ID
`maxCount`	`long`	最大查询数量（用于翻页）

返回值SoftwareInfo 对象，包含软件名称、版本、访问量、下载链接等。

示例

SoftwareInfo info = await admin.GetSoftwareInfoByIdAsync("soft123");
Console.WriteLine($"软件名：{info.SoftwareName}，版本：{info.SoftwareVersion}");

`GetCardListAsync`

获取卡密列表。

public async Task<List<CardInfo>> GetCardListAsync(
    string? softwareId = null, 
    long maxCount = 50)

参数

名称	类型	说明
`softwareId`	`string?`	筛选指定软件的卡密，为 `null` 则返回所有
`maxCount`	`long`	最大返回数量（默认50）

返回值List<CardInfo>，每个元素包含卡号、状态、机器码、备注、有效期等。

示例

// 获取所有卡密
List<CardInfo> allCards = await admin.GetCardListAsync();
// 获取指定软件的卡密
List<CardInfo> softCards = await admin.GetCardListAsync("soft123");
foreach (var card in softCards)
{
    Console.WriteLine($"{card.CardNumber} - 激活：{card.IsActivated}");
}

`CreateCardAsync`

批量创建卡密。

public async Task<(bool Success, List<string> CreatedCards)> CreateCardAsync(
    string softwareId, 
    string remarks, 
    int duration, 
    int count)

参数

名称	类型	说明
`softwareId`	`string`	软件ID
`remarks`	`string`	备注
`duration`	`int`	有效天数（0 表示永久）
`count`	`int`	创建数量

返回值

Success：操作是否成功。
CreatedCards：新生成的卡密列表。

示例

var (ok, cards) = await admin.CreateCardAsync("soft123", "测试卡密", 30, 5);
if (ok)
{
    Console.WriteLine("生成的卡密：");
    foreach (string c in cards) Console.WriteLine(c);
}

`CreateSoftwareAsync`

创建新软件。

public async Task<bool> CreateSoftwareAsync(string name, string version)

参数

名称	类型	说明
`name`	`string`	软件名称
`version`	`string`	初始版本号

返回值成功返回 true，失败返回 false。

示例

bool created = await admin.CreateSoftwareAsync("我的软件", "1.0.0");
Console.WriteLine(created ? "创建成功" : "创建失败");

`EditSoftwareInfoAsync` [未实现]

编辑软件信息（预留接口）。

public async Task<bool> EditSoftwareInfoAsync(string id, SoftwareInfo updatedInfo)

注意：此方法目前抛出 NotImplementedException，请根据实际后端接口自行实现。

数据模型（AdminSDK）

`SoftwareInfo`

属性	类型	说明
`SoftwareName`	`string`	软件名称
`SoftwareVersion`	`string`	版本号
`VisitCount`	`string`	访问量
`UpdateContent`	`string`	更新内容
`LowVersion`	`string`	强制更新版本（最低版本）
`Md5`	`string`	文件 MD5
`CreateTime`	`string`	创建时间
`DownloadUrl`	`string`	下载链接
`ForceUpdate`	`bool`	是否强制更新
`Id`	`string`	软件ID

`CardInfo`

属性	类型	说明
`CardNumber`	`string`	卡密编号
`IsActivated`	`bool`	是否已激活
`MachineCode`	`string`	绑定的机器码
`Remarks`	`string`	备注
`Duration`	`string`	有效天数
`SoftwareId`	`string`	所属软件ID

3. `Tools` 工具类

3.1 机器码

`GetMachineCode` [过时]

获取格式化的 20 位机器码（CPU+主板+盐值）。

[Obsolete("请使用 GetMachineCodeEx() 以获得更好的机器码，2027年01月01日正式禁用此方法", false)]
public static string GetMachineCode()

返回值格式：XXXXX-XXXXX-XXXXX-XXXXX-XXXXX。

示例

string oldCode = Tools.GetMachineCode(); // 例如 "AB12C-DE34F-GH56I-JK78L-MN90P"

`GetMachineCodeEx`

获取更安全的 128 位（SHA512）机器码。

public static string GetMachineCodeEx()

返回值128 字符十六进制字符串。

示例

string machineCode = Tools.GetMachineCodeEx();
Console.WriteLine(machineCode); // 输出类似 "9F86D081884C7D659A2FEAA0C55AD015A3BF4F1B2B0B822CD15D6C15B0F00A08..."

3.2 随机字符串与盐值

`GenerateRandomString`

生成指定类型和长度的随机字符串。

public static string GenerateRandomString(int length, int type = 0)

参数

名称	类型	说明
`length`	`int`	长度
`type`	`int`	类型：0=字母数字（默认），1=字母，2=数字，3=大写字母，4=大写字母+数字

返回值随机字符串。

示例

string code = Tools.GenerateRandomString(8, 4); // 8位大写字母+数字，如 "A3F9B2K1"
string password = Tools.GenerateRandomString(12, 0); // 12位混合字符

`GenerateSalt`

生成密码学安全的随机盐值（Base64）。

public static string GenerateSalt(int length = 64)

参数

名称	类型	说明
`length`	`int`	随机字节长度（默认64，）

返回值Base64 编码的盐值。

示例

string salt = Tools.GenerateSalt(); 		// 生成64字符的Base64字符串
string customSalt = Tools.GenerateSalt(32);	// 生成32字符的Base64字符串

3.3 哈希

`Sha256`

计算字符串的 SHA-256 哈希值（十六进制大写）。

public static string Sha256(string input)

参数

名称	类型	说明
`input`	`string`	输入字符串

返回值64 字符的十六进制字符串。

示例

string hash = Tools.Sha256("hello");
Console.WriteLine(hash); // 2CF24DBA5FB0A30E26E83B2AC5B9E29E1B161E5C1FA7425E73043362938B9824

`Sha512`

计算字符串的 SHA-512 哈希值（十六进制大写）。

public static string Sha512(string input)

返回值128 字符的十六进制字符串。

示例

string hash = Tools.Sha512("hello");
Console.WriteLine(hash);	// 9B71D224BD62F3785D96D46AD3EA3D73319BFBC2890CAADAE2DFF72519673CA72323C3D99BA5C11D7C7ACC6E...

3.4 加密解密

使用十六进制密钥的 AES 加密/解密

密钥必须为 32 字节的十六进制字符串（64字符），例如由 Tools.Sha256("password") 生成。

public static string Encrypt(string plainText, string key)
public static string Decrypt(string cipherText, string key)

参数

plainText：明文。
cipherText：Base64 密文（包含16字节随机IV）。
key：32字节十六进制密钥（64字符）。

返回值加密返回 Base64 字符串，解密返回明文。

示例

string key = Tools.Sha256("mySecretKey"); // 64字符十六进制
string encrypted = Tools.Encrypt("敏感数据", key);
Console.WriteLine(encrypted);
string decrypted = Tools.Decrypt(encrypted, key);
Console.WriteLine(decrypted); // 输出 "敏感数据"

使用密码+盐值的 AES 加密/解密（PBKDF2派生密钥）

更安全的加密方式，推荐用于用户密码加密。

public static string Encrypt(string plainText, string password, string salt)
public static string Decrypt(string cipherText, string password, string salt)

参数

password：用户提供的密码。
salt：盐值（建议使用 GenerateSalt() 生成）。
其他同前。

示例

string password = "userPass123";
string salt = Tools.GenerateSalt();
string encrypted = Tools.Encrypt("秘密信息", password, salt);
string decrypted = Tools.Decrypt(encrypted, password, salt);

3.5 类型转换

`ToBoolean`

将多种常见字符串转换为布尔值。

public static bool ToBoolean(string value, out bool result)

参数

名称	类型	说明
`value`	`string`	输入字符串
`result`	`out bool`	转换成功后的布尔值

返回值true 表示转换成功，false 表示无法识别。

支持的值（不区分大小写）

真：true, 1, yes, y, on, enable, enabled, active, t, ok, okay, correct, right, positive, affirmative, aye, si, da, ja, はい, 是, 真, ✓, √
假：false, 0, no, n, off, disable, disabled, inactive, f, cancel, wrong, incorrect, negative, nay, no way, non, nein, нет, いいえ, 否, 假, ✗, ×

示例

if (Tools.ToBoolean("yes", out bool b1)) Console.WriteLine(b1); // True
if (Tools.ToBoolean("0", out bool b2)) Console.WriteLine(b2);   // False
if (Tools.ToBoolean("maybe", out bool b3)) { } else Console.WriteLine("无法转换");

3.6 更新程序

`upgrade`

启动外部更新程序 upgrade.exe 进行软件更新。

public static void upgrade(string downloadUrl)

参数

名称	类型	说明
`downloadUrl`	`string`	新版本下载地址

说明需要在程序目录下放置 upgrade.exe，该程序将接收下载地址和当前进程路径作为参数。若 upgrade.exe 不存在，方法静默返回。

示例

string downloadUrl = await update.GetDownloadLink();
Tools.upgrade(downloadUrl);
// 启动更新程序后，当前进程应尽快退出
Environment.Exit(0);

4. `Log` 日志类

基于 NLog 的静态日志类，日志文件保存在 应用程序根目录/Logs/yyyy-MM-dd.log。

方法

方法	说明
`Debug(string message)`	记录调试信息
`Info(string message)`	记录一般信息
`Warn(string message)`	记录警告
`Error(string message)`	记录错误
`Error(Exception ex, string message)`	记录错误及异常详情
`Fatal(string message)`	记录致命错误

示例

Log.Info("应用程序启动");
try
{
    // 业务代码
}
catch (Exception ex)
{
    Log.Error(ex, "操作失败");
}

附录：常用数据模型

`Mysoft` (软件信息)

属性	类型	说明
`author`	`string`	作者
`softwareMd5`	`string`	软件 MD5
`softwareName`	`string`	软件名称
`softwareId`	`string`	软件ID
`versionNumber`	`string`	版本号
`mandatoryUpdate`	`bool`	是否强制更新
`numberOfVisits`	`int`	访问量
`miniVersion`	`string`	最低版本
`timeStamp`	`long`	服务器时间戳
`networkVerificationId`	`string`	卡密ID
`isItEffective`	`bool`	卡密是否有效
`numberOfDays`	`int`	有效天数
`networkVerificationRemarks`	`string`	授权备注
`expirationDate`	`long`	过期时间戳
`downloadLink`	`string`	下载链接
`notice`	`string`	公告
`versionInformation`	`string`	更新内容
`bilibiliLink`	`string`	B站链接（固定值）

`UserInfo` (用户信息)

属性	类型	说明
`CustomerId`	`string`	用户ID
`AvatarUrl`	`string`	头像URL
`Nickname`	`string`	昵称
`Email`	`string`	邮箱
`Balance`	`int`	余额/剩余天数
`License`	`string`	授权标识（ true/ false）
`TimeCrypt`	`string`	登录时间戳
`Timestamp`	`long`	服务器时间戳

欢迎使用Z-BlogPHP！

Fri, 24 Oct 2025 00:04:40 +0800

欢迎使用Z-Blog，这是程序自动生成的文章，您可以删除或是编辑它:)

系统生成了一个留言本和一篇《欢迎使用Z-BlogPHP！》，祝您使用愉快！

海棠云螭的博客

GenshinConvert授权码

HaiTang.Library.Api2018k 库调用说明文档

HaiTang.Library.Api2018k 库调用说明文档

概述

命名空间引用

1. Update 类 – 客户端核心功能

1.1 初始化与软件信息

InitializationAsync

GetSoftCheck [过时]

获取软件信息的各个属性方法

1.2 云变量操作

GetCloudVariables

GetCloudVarArray

updateCloudVariables

1.3 卡密操作

ActivationKey

CreateNetworkAuthentication

ReplaceBind

GetRemainingUsageTime

GetNetworkCode

1.4 用户相关方法

CustomerRegister

InitializationUserAsync

GetUserInfo

用户信息属性获取方法

Recharge

1.5 消息发送

MessageSend

1.6 缓存控制静态方法

2. AdminSDK 类 – 后台管理功能

LoginAsync

GetSoftwareIdsAsync

GetSoftwareInfoByIdAsync

GetCardListAsync

CreateCardAsync

CreateSoftwareAsync

EditSoftwareInfoAsync [未实现]

数据模型（AdminSDK）

SoftwareInfo

CardInfo

3. Tools 工具类

3.1 机器码

GetMachineCode [过时]

GetMachineCodeEx

3.2 随机字符串与盐值

GenerateRandomString

GenerateSalt

3.3 哈希

Sha256

Sha512

3.4 加密解密

使用十六进制密钥的 AES 加密/解密

使用密码+盐值的 AES 加密/解密（PBKDF2派生密钥）

3.5 类型转换

ToBoolean

3.6 更新程序

upgrade

4. Log 日志类

方法

附录：常用数据模型

Mysoft (软件信息)

UserInfo (用户信息)

欢迎使用Z-BlogPHP！

1. `Update` 类 – 客户端核心功能

`InitializationAsync`

`GetSoftCheck` [过时]

`GetCloudVariables`

`GetCloudVarArray`

`updateCloudVariables`

`ActivationKey`

`CreateNetworkAuthentication`

`ReplaceBind`

`GetRemainingUsageTime`

`GetNetworkCode`

`CustomerRegister`

`InitializationUserAsync`

`GetUserInfo`

`Recharge`

`MessageSend`

2. `AdminSDK` 类 – 后台管理功能

`LoginAsync`

`GetSoftwareIdsAsync`

`GetSoftwareInfoByIdAsync`

`GetCardListAsync`

`CreateCardAsync`

`CreateSoftwareAsync`

`EditSoftwareInfoAsync` [未实现]

`SoftwareInfo`

`CardInfo`

3. `Tools` 工具类

`GetMachineCode` [过时]

`GetMachineCodeEx`

`GenerateRandomString`

`GenerateSalt`

`Sha256`

`Sha512`

`ToBoolean`

`upgrade`

4. `Log` 日志类

`Mysoft` (软件信息)

`UserInfo` (用户信息)