5 分钟上手

跟着这 4 步就能在自己的 Windows 主机上远程跑 PowerShell 命令，并按 token 计费。

1. 注册账户

打开控制台 https://web.gateway.wechas.com/register，填邮箱和密码注册。

注册后系统送 100 token 体验额度（约 50 次 PowerShell 调用）。

2. 创建一台主机

登录后进 控制台 → 我的主机，点”新增主机”，填一个名称（如 dev-pc-01）。

系统自动为这台主机生成：

  • 唯一的 host_id (UUID)
  • 32 字符 secretKey（KEK 加密落库，中枢不见明文）
  • 一对 ed25519 keypair（私钥仅出现在 install.ps1 一次）

3. 在主机上跑安装包

点 “下载安装包” 得到 install-xxxxxx.ps1，拷到 Windows 主机，管理员身份跑：

powershell -ExecutionPolicy Bypass -File install-xxxxxx.ps1

agent 会：

  1. 拷自己到 C:\Program Files\m2-gateway\m2-gateway.exe
  2. 在 HKCU\Run 与 HKLM\Run 注册自启动
  3. 加防火墙入站规则（端口 23456）
  4. 私钥用 Windows DPAPI 包装后存到 %PROGRAMDATA%\m2-gateway\setup.conf
  5. 立即拨号 wss 连中枢，写一行 online 事件

回控制台主机列表，几秒后这台主机会显示绿色脉动徽标（在线）。

4. 创建 API Key + 调用

在 控制台 → API Keys 点 “新建 Key”，完整 secret 仅本次显示，先复制保存。

格式：ak_<key_id>.<secret>

接下来用任一 SDK：

Python

from gateway_new_sdk import Client, ShellRequest

c = Client(base_url="https://api.gateway.wechas.com", api_key="ak_xxx.yyy")
r = c.exec_shell("<host-uuid>", ShellRequest(
    path="powershell.exe",
    args="Get-Process | Select-Object -First 5",
))
print(r.stdout)

Go

import sdk "github.com/gateway-new/sdk-go"

c := sdk.New("https://api.gateway.wechas.com", "ak_xxx.yyy")
r, _ := c.ExecShell(ctx, hostID, sdk.ShellRequest{
    Path: "powershell.exe",
    Args: "Get-Process | Select-Object -First 5",
})
fmt.Println(r.Stdout)

TypeScript

import { Client } from "@gateway-new/sdk";

const c = new Client({ baseUrl: "https://api.gateway.wechas.com", apiKey: "ak_xxx.yyy" });
const r = await c.execShell("<host-uuid>", {
  path: "powershell.exe",
  args: "Get-Process | Select-Object -First 5",
});
console.log(r.stdout);

计费

每次 exec_shell 扣 5 token（约 0.05 元）。 余额不足时返 HTTP 402；可在控制台 账单 页充值。

下一步