快速开始

环境要求

从源码开发或构建需要：

Node.js >= 20
npm >= 10

运行发布产物时，根据产物选择 Node.js 或 txiki.js。

安装与构建

git clone https://github.com/catlair/mcloud-sign.git
cd mcloud-sign
npm install

# 构建 Node.js 单文件
npm run build:cli

# 构建 txiki.js 单文件
npm run build:cli:tjs

两个命令默认都写入 out/index.mjs：

npm run build:cli 生成 Node.js 目标。
npm run build:cli:tjs 生成 txiki.js 目标，并会覆盖同名文件。

如需同时保留两个目标的产物，应在每次构建后自行复制或重命名。txiki.js 构建将 tjs:* 保留为运行时模块。

创建配置

推荐使用配置生成器，或者在运行目录创建 asign.json：

{
  "version": 2,
  "caiyun": [
    {
      "auth": "Base64 编码的认证字符串",
      "nickname": "主账号"
    }
  ]
}

version 固定为 2，caiyun 是账号数组，每个账号必须提供 auth。

获取 auth

登录移动云盘网页或 App 对应页面。
在浏览器开发者工具的 Network 面板中查看请求。
复制请求头中的 authorization 完整值。
将它写入本地配置；不要提交到 Git，也不要粘贴到公开日志或问题反馈中。

运行

开发模式

npm run dev:cli

Node.js 单文件

node out/index.mjs

编程调用

import { run } from "./out/index.mjs";

await run();
// 或指定配置文件
await run("/absolute/path/to/asign.json");

run 仅接受可选的配置文件路径，不接受配置对象。

默认执行流程

每个账号会独立初始化并依次执行：

网盘签到、复活奖励和任务扩展。
拍拍系列活动、趣玩 AI 抽奖和红包派对等已接入调度的活动。
消息推送奖励、通知奖励、备份礼物和 App 任务。
云朵大作战（按配置）。
待领取奖品、领取云朵和临时文件清理。

下一步可阅读配置详解和部署。