nethard-core-channel

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

nethard-core-channel

★ 12 Open GitHub ↗

No description available.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# nethard-core

`nethard-core` 是一个面向 Node.js 的 TypeScript 工具库，封装了与《我的世界》中国版相关的渠道登录、设备信息生成、SAuth 参数生成以及常用随机值生成能力。

当前代码主要覆盖两个渠道：

- 网易移动端 MPay 登录流程
- 4399 移动端/PC 登录、注册、验证码与实名相关流程

> 注意：本项目会调用第三方登录与认证接口。请仅在合法、授权、合规的场景中使用，并妥善处理账号、手机号、身份证号、token、cookie 等敏感信息。

## 技术栈

- TypeScript
- Node.js ESM/CJS 双格式输出
- tsup 构建
- axios HTTP 客户端
- cheerio HTML 解析
- uuid 随机 UUID 生成
- ESLint 代码检查
- pnpm 包管理

## 环境要求

- Node.js 20 或更高版本
- pnpm 10.23.0 或更高版本

项目在 `package.json` 中声明了包管理器：

```bash
pnpm@10.23.0
```

## 安装依赖

```bash
pnpm install
```

## 常用命令

```bash
# 构建 dist
pnpm build

# 监听源码变化并构建
pnpm watch

# 运行 ESLint
pnpm lint
```

当前项目没有配置测试脚本。

## 目录结构

```text
src/
  index.ts                  # 包入口，导出 channel 与 random
  random/                   # 随机值、UDID、User-Agent 等工具
  channel/
    index.ts                # 渠道模块入口
    types.ts                # 通用 Client、SAuth 与 UniSauth 类型
    netease/                # 网易 MPay 移动端流程
      client.ts
      errors.ts
      mpay.ts
    4399/                   # 4399 移动端/PC 流程
      client.ts
      devices.ts
      errors.ts
      cipher.ts
```

## 包导出

根入口导出两个命名空间：

```ts
export * as channel from "./channel";
export * as random from "./random";
```

使用示例：

```ts
import { channel, random } from "nethard-core";
```

构建后会输出：

- `dist/index.js`：ESM 入口
- `dist/index.cjs`：CommonJS 入口
- `dist/index.d.ts` / `dist/index.d.cts`：类型声明

## Random 工具

`random` 命名空间提供以下工具函数：

```ts
import { random } from "nethard-core";

const step = random.randomStep();
const uniqueId = random.randomUniqueId();
const udid = random.randomUdid();
const uuid = random.randomUUID();
const userAgent = random.randomUserAgent();
```

函数说明：

| 函数 | 返回值 | 说明 |
| --- | --- | --- |
| `randomStep()` | `number` | 生成 32 位范围内的随机 step 值 |
| `randomUniqueId()` | `string` | 生成 16 字节十六进制随机字符串 |
| `randomUdid()` | `string` | 生成 8 字节十六进制 UDID |
| `randomUUID()` | `string` | 基于 UUID v4/v5 与时间戳生成 UUID |
| `randomUserAgent()` | `string` | 随机生成浏览器 User-Agent |

## 网易渠道

网易渠道模块位于 `channel.netease`，主要包含：

- `getMPayInfo()`：生成本地设备信息并向 MPay 注册远端设备
- `makeAppInfo()`：生成网易应用参数
- `makeLocalDeviceInfoPE()`：生成移动端本地设备信息
- `getRemoteDeviceInfo()`：获取远端设备 ID 与 key
- `ClientPEImpl`：网易移动端客户端
- `getPhoneSms()`：请求手机验证码
- `verifyPhoneSms()`：校验或发送短信验证码相关请求
- `MPayLoginError` / `MPayDeviceError` / `PhoneSmsError`：错误类型

### 网易游客登录示例

```ts
import { channel } from "nethard-core";

const mpayInfo = await channel.netease.getMPayInfo();
const client = await channel.netease.ClientPEImpl.loginByGuest(mpayInfo);

const sauthJson = client.getSAuthJson();
console.log(sauthJson);
```

### 网易账号登录示例

```ts
import { channel } from "nethard-core";

const mpayInfo = await channel.netease.getMPayInfo();

const client = await channel.netease.ClientPEImpl.loginByAccount({
  mpayInfo,
  username: "your_username",
  password: "your_password",
});

console.log(client.userId);
console.log(client.getSAuthJson());
```

### 网易手机号登录流程

```ts
import { channel } from "nethard-core";

const mpayInfo = await channel.netease.getMPayInfo();

await channel.netease.getPhoneSms({
  mpayInfo,
  phoneNumber: "13800000000",
});

const verifyResult = await channel.netease.verifyPhoneSms({
  action: "verify",
  mpayInfo,
  phoneNumber: "13800000000",
  verifyCode: "123456",
});

const client = await channel.netease.ClientPEImpl.loginByPhone({
  mpayInfo,
  phoneNumber: "13800000000",
  ticket: verifyResult.ticket,
});

console.log(client.getSAuthJson());
```

## 4399 渠道

4399 渠道模块位于 `channel.games4399`，主要包含：

- `getParams()`：获取 OAuth 登录参数
- `getReqInfo()`：获取注册或登录页面中的请求信息、验证码 ID、注册请求 ID 等
- `getCaptchaToken()`：校验滑块或点选验证码并返回验证码 token
- `getDefalutDevice()`：生成默认设备信息
- `ClientPEImpl`：4399 移动端客户端
- `ClientPCImpl`：4399 PC 客户端
- 4399 登录、注册、验证码与校验相关错误类型

### 4399 移动端账号登录示例

```ts
import { channel } from "nethard-core";

const device = channel.games4399.getDefalutDevice();
const params = await channel.games4399.getParams({ device });

const client = await channel.games4399.ClientPEImpl.loginByAccount({
  device,
  params,
  username: "your_username",
  password: "your_password",
});

console.log(client.info.uid);
console.log(client.getSAuthJson());
```

### 4399 移动端注册并登录示例

```ts
import { channel } from "nethard-core";

const device = channel.games4399.getDefalutDevice();
const params = await channel.games4399.getParams({ device });
const reqInfo = await channel.games4399.getReqInfo({
  auth_action: "register",
  params,
});

const client = await channel.games4399.ClientPEImpl.registerAndLogin({
  device,
  params,
  reg_req_id: reqInfo.regReqId,
  username: "new_username",
  password: "new_password",
});

console.log(client.getSAuthJson());
```

### 4399 PC 登录示例

```ts
import { channel } from "nethard-core";

const client = await channel.games4399.ClientPCImpl.login({
  username: "your_username",
  password: "your_password",
});

const cookies = client.getCookies();
const sauthJson = await client.getSAuthJson();

console.log(cookies);
console.log(sauthJson);
```

### 4399 验证码处理

登录或注册过程中，如果接口抛出验证码错误，可以从错误对象中读取 `captchaId` 和 `captchaUrl`，由调用方完成验证码识别或人工处理后继续请求。

```ts
import { channel } from "nethard-core";

try {
  // login or register
}
catch (error) {
  if (error instanceof channel.games4399.Games4399LoginCaptchaError) {
    console.log(error.captchaId);
    console.log(error.captchaUrl);
  }
}
```

滑块或点选验证码可以通过 `getCaptchaToken()` 获取 token：

```ts
import { channel } from "nethard-core";

const token = await channel.games4399.getCaptchaToken({
  captchaType: "jigsaw",
  captchaId: "captcha_id",
  xPos: 120,
});

console.log(token);
```

## SAuth 类型

项目定义了通用 `Client` / `ClientPC` 接口：

```ts
interface Client {
  getSAuthJson: () => SAuthJson;
}

interface ClientPC {
  getSAuthJson: () => Promise<SAuthJsonPC>;
}
```

不同渠道客户端会根据渠道和平台返回对应的 SAuth 参数：

- 网易移动端：`SAuthJsonNeteasePE`
- 4399 移动端：`SAuthJson4399PE`
- 4399 PC：`SAuthJson4399PC`

## 错误处理

建议按具体错误类型处理可恢复流程，例如验证码、短信、设备注册失败等。

```ts
import { channel } from "nethard-core";

try {
  const mpayInfo = await channel.netease.getMPayInfo();
  await channel.netease.ClientPEImpl.loginByGuest(mpayInfo);
}
catch (error) {
  if (error instanceof channel.netease.MPayDeviceError) {
    console.error("设备注册失败", error.response);
  }
  else if (error instanceof channel.netease.MPayLoginError) {
    console.error("登录失败", error.response);
  }
  else {
    throw error;
  }
}
```

## 开发说明

- 源码入口为 `src/index.ts`
- 构建配置为 `tsup.config.ts`
- TypeScript 配置为 `tsconfig.json`
- 路径别名 `@/*` 指向 `src/*`
- lint-staged 会在 pre-commit 阶段执行 `eslint --fix`

## 许可证

No License

nethard-core-channel

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README