Windows 部署

使用 Windows AMD64 完整包，不需要自行安装 Go、Node.js 或数据库服务。

下载与校验

从 GitHub 最新正式版下载：

• 文件名以 windows-amd64.zip 结尾的 Windows 安装包
• SHA256SUMS.txt

在下载目录打开 PowerShell：

$packagePath = (Resolve-Path -LiteralPath (Read-Host '粘贴下载的 Windows AMD64 ZIP 完整路径')).Path
Get-FileHash -LiteralPath $packagePath -Algorithm SHA256

将输出与 SHA256SUMS.txt 中对应文件的 SHA256 比较，一致后再解压。

解压并启动

使用一个新的独立目录，例如 C:\MengkaNT。确认目录没有其他实例的数据，并继续在同一个 PowerShell 窗口执行：

New-Item -ItemType Directory C:\MengkaNT -ErrorAction Stop
Expand-Archive -LiteralPath $packagePath -DestinationPath C:\MengkaNT
Set-Location C:\MengkaNT

包内没有额外顶层文件夹；解压后当前目录直接包含 mengka.exe、public、data。

首次在 PowerShell 等终端中运行时，会询问网页访问端口；输入可用端口，或按 Enter 使用默认的 7878。选择会保存到程序目录下的 data\config.yaml，确认后再打开初始化地址。已有配置文件时直接使用其中的端口，不会再次询问。

也可以提前配置：在程序的 data 文件夹内，将包内 config.example.yaml 改名为 config.yaml，再修改 server.port。例如：

server:
  port: 8787

如果 data\config.yaml 已存在，直接编辑它，不要用示例文件覆盖。只修改 server.port，保留其他配置。在程序目录的 PowerShell 中启动：

.\mengka.exe

运行期间保持终端打开，以后也从这个目录启动。

完成初始化

复制终端显示的完整初始化地址，在同一台电脑的浏览器打开。地址同时保存在 data\platform-auth\setup-access.txt，必须完整复制地址，保留路径与 # 后的内容。

1. 输入注册卡注册当前实例。
2. 阅读并确认使用协议。
3. 设置本地管理员账号、密码和监听端口。
4. 完成初始化后，用管理员账号登录。

一张注册卡仅供一个实例注册，默认永久 Free。保留 data 后，原实例重启或更新无需再次用卡。初始化地址与管理员凭据请勿公开分享。

远程 Windows 上的 127.0.0.1 指服务器本机。可在远程桌面的浏览器中访问，或按实际端口建立 SSH 转发；仅替换主机与端口，保留路径与 # 后的全部内容。

添加账号与接入插件

先创建设备指纹，然后添加 QQ 账号并选择协议与设备。点击登录后按提示完成滑块、短信或扫码确认。

运行系统与 QQ 协议相互独立，Windows 上也可以选择 Linux QQ 协议，登录时按页面提示完成验证。

在插件页面导入适配当前框架的 IPC 插件，或创建 HTTP、正向／反向 WebSocket 服务连接外部插件，将服务地址和令牌填入插件配置。详见插件开发。

保留数据与升级

优先使用框架顶部“在线更新”检查可用版本，按提示更新后等待服务恢复。

手动更新时，先停止程序并备份完整安装目录，把新包解压到临时目录，再替换原实例的 mengka.exe、public、data/init.sql 和 data/migrations.sql。保留其余 data 内容，不让两份程序同时写入相同数据。随后仍从原安装目录启动。

如果再次看到初始化页，先检查启动目录与数据文件，再查看日志，不要急于重新注册。

常见问题

窗口一闪而过

在 PowerShell 中运行 .\mengka.exe 查看实际错误，检查安装包完整性、目录写入权限和系统安全软件提示。

初始化地址打不开

确认进程仍在运行，使用当前终端或 setup-access.txt 中的完整地址。首次启动时按 Enter 使用 7878；输入了其他端口或已有 data\config.yaml 时，使用保存的端口。初始化时若修改了监听端口，之后访问也要使用新端口。

插件连不上

检查插件是否运行、连接模式是否一致、服务地址与令牌是否正确，并按当前 API 文档检查消息和参数格式。