部署到计算机(或路由器)

... 大约 2 分钟

# 部署到计算机(或路由器)

HyperaiShell 目前依赖于 .net Core 3.1，但部署则不依赖目标计算机中的 .net 框架。

# 使用已有发布

在这里下载适用于目标平台的可执行文件。

如果没有找到适用的版本，则需要自己编译。

# 手动编译

编译 HyperaiShell 需要 .net SDK 支持，在这里获取安装。

注意

具有编译能力的是 .net SDK 而不是 .net runtime，下载时注意区分。

进入 HyperaiShell.App 目录（即与 HyperaiShell.App.csproj 同级），在终端运行

# dotnet restore
# dotnet build
dotnet publish --configuration Release -r [RID] -o [OutputDir]

1
2
3

RID列表和具体过程自行查阅 dotnet cli 文档。

# 配置

HyperaiShell.App 安装目录可以找到一个 appsettings.json 文件，修改其中的内容使其合理。

其中必须配置 HyperaiShell.App 使用的适配器。具体字段及对应的值请查询适配器提供方的文档.

目前版本提供了 mirai 适配器.

以下是 mirai 适配器 的配置, 以供参考.

{
	"Application": {
		"SelectedClientName": "Mirai",
		"Daddy": MANAGER_QQ
	},
	"Clients": [
		{
			"Name": "Mirai",
			"AssemblyName": "Ac682.Hyperai.Clients.Mirai",
			"ClientTypeDefined": "Ac682.Hyperai.Clients.Mirai.MiraiClient",
			"OptionsTypeDefined": "Ac682.Hyperai.Clients.Mirai.MiraiClientOptions",
			"Options": {
				"Port": PORT,
				"Host": "HOST_IP_OR_DOMAIN",
				"AuthKey": "YOUR_AUTH_KEY",
				"SelfQQ": QQ_OF_BOT
			}
		}
	]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

该适配器除了不可变字段以外，Clients[0].Options 字段需要设置端口 Port ，主机 Host ，mirai的authkey AuthKey 和机器人自己的QQ SelfQQ 。

例如CQ和TG等更多适配器请查阅项目仓库README.

# 运行

在安装目录的终端输入

./HyperaiShell.App

就能让它跑起来。

# 从现有的版本更新

每一个 release 都是完整版, 包括了默认配置 appsettings.json 文件. 增量更新先备份 appsettings.json 文件, 删除目录内的所有 .dll, .so, 以及可执行文件(保留所有文件夹和). 然后解压并替换新版本到旧版本, 采取覆盖来解决文件冲突. 最后把备份的 appsettings.json 内容迁移到刚复制的 appsettings.json 中即可完成版本更新.

通过这种方法更新出现意外的错误则建议重新完整纯净安装并配置一次, 之后逐步把原先数据迁移过来.

注意

注意 plugins 目录下的文件有可能出现版本重复.

什么是 HyperaiShell 安装扩展