二次开发指南基于Cloud189Checkin生态的cloud189-sdk把天翼网盘API集成进你自己的项目【免费下载链接】Cloud189Checkin天翼网盘自动签到项目地址: https://gitcode.com/gh_mirrors/clo/Cloud189CheckinCloud189Checkin 是一款开箱即用的天翼网盘自动签到脚本但更值得关注的是它底层依赖的开源组件 cloud189-sdk——一个把天翼网盘 API 封装成 Node.js 类的轻量 SDK。登录、Token 刷新、签到、容量查询全部封装好了有编程基础的同学可以借它快速把天翼网盘能力集成进自己的项目。本文是一份面向新手的二次开发完整指南先 5 分钟跑通官方签到脚本再逐步拆解源码最后把天翼网盘 API 装进你自己的应用。为什么选择 cloud189-sdk 做天翼网盘二次开发直接调用天翼网盘接口需要自己处理登录加密、设备校验、会话失效重试等一堆脏活累活而 Cloud189Checkin 生态把这些全做完了开箱即用CloudClient一个类就能完成登录与签到Token 自动持久化、失效自动重试刷新源码可抄官方签到脚本本身就是一份SDK 使用示例核心不到 100 行照着改就行生态完整多账号管理、按账号分离的日志、7 种消息推送渠道二次开发时可以整套搬走项目的核心依赖在 package.json 中一目了然cloud189-sdk^1.0.8其余只有 dotenv读环境变量、log4js日志和 superagent推送请求架构非常轻量。5 分钟跑通天翼网盘自动签到脚本本地部署步骤第一步准备环境。需要 Node.js 18项目用到了Promise.any低版本跑不起来。第二步克隆仓库并安装依赖git clone https://gitcode.com/gh_mirrors/clo/Cloud189Checkin cd Cloud189Checkin npm install第三步配置账号。修改项目根目录的.env文件两种方式任选方式一TY_ACCOUNTS[{userName:账号1,password:密码1}]支持多个账号适合账号固定方式二TY_USERNAME_1TY_PASSWORD_1、TY_USERNAME_2TY_PASSWORD_2……数量不限适合账号经常变动也可以在系统环境变量中配置例如 Windows 的用户变量第四步运行npm start看到个人签到任务: 获得 xxM 空间和容量统计日志说明天翼网盘 API 已经在你本地跑通了。源码拆解app.js 里的天翼网盘 API 调用套路src/app.js 是项目入口读懂它就读懂了 SDK 的用法核心就三步1. 创建客户端src/app.jsconst cloudClient new CloudClient({ username: userName, password, token: new FileTokenStore(.token/${userName}.json), });FileTokenStore会把登录 Token 存到本地.token目录每个账号一个 JSON 文件下次运行自动复用——这正是二次开发时免重复登录的关键。2. 执行签到src/app.js调用cloudClient.userSign()返回的netdiskBonus就是本次签到获得的随机容量。3. 查询容量签到前后各调用一次getUserSizeInfo()对比差值即可得到精确的容量增量官方推送里的个人容量 / 家庭容量数字就是这么算出来的。 小技巧设置环境变量CLOUD189_VERBOSE1可开启 SDK 调试日志接口出问题时先看它。三步集成把 cloud189-sdk 装进你自己的 Node.js 项目不需要克隆整个仓库在你的项目里执行npm install cloud189-sdk然后写一个最小示例约 15 行即可运行const { CloudClient, FileTokenStore } require(cloud189-sdk); const client new CloudClient({ username: 你的账号, password: 你的密码, token: new FileTokenStore(./my-token.json), }); const size await client.getUserSizeInfo(); console.log(总容量(MB):, size.cloudCapacityInfo.totalSize / 1024 / 1024); const sign await client.userSign(); console.log(sign.isSign ? 今日已签到 : 签到成功获得 ${sign.netdiskBonus}M);接下来就可以自由发挥了常见的集成场景场景思路定时任务用 node-cron 每天固定时间执行签到摆脱平台限制后端服务封装成 REST 接口配合前端展示容量变化曲线聊天机器人群里发签到指令即执行结果自动推回群里面板脚本改造后部署到青龙、玄武面板多账号分组管理多账号与消息推送官方实现照着抄就行多账号读取accounts.js 展示了从环境变量批量读取账号的完整逻辑——优先读TY_ACCOUNTS否则按TY_USERNAME_n / TY_PASSWORD_n递增匹配直到读空为止。消息推送src/push/index.js 的push函数一次调用即可并发通知 7 个渠道——Server酱、Telegram Bot、企业微信群机器人、WxPusher、PushPlus、Bark、ShowDoc每个渠道独立一个文件集中在 src/push/ 目录。你的项目想加通知直接复制对应渠道文件就能用。日志系统src/logger.js 用 log4js 实现了控制台 按账号分文件的双写日志多账号排查问题时非常好用。定时运行与面板部署玄武、青龙与 GitHub ActionsGitHub Actions 定时执行fork 仓库并在环境变量中配置账号后工作流每天 10:35 自动签到运行记录一目了然玄武 / 青龙面板NAS 玩家可参考官方图文教程 doc/xuanwu/README.md核心思路就是在文件管理里编辑.env再到任务管理中新建npm start定时任务天翼网盘签到二次开发避坑清单账号密码绝不入库.env和.token目录包含敏感信息提交到公开仓库等于裸奔README 开头就重点警告了这条Node.js 必须 18低版本会因缺少Promise.any直接报错设备校验遇到设备ID不存在时需先在天翼云盘 App 中关闭设备锁特殊字符账号密码含#$等特殊字符时TY_ACCOUNTS要用单引号包起来否则 JSON 解析失败Token 要保留.token目录是登录态缓存删掉后每次运行都重新登录容易触发风控先开调试再排查CLOUD189_VERBOSE1能看到 SDK 内部请求细节比盲目重试快得多写在最后Cloud189Checkin 的真正价值不止于每天领到随机容量——它把天翼网盘 API 中最麻烦的登录与 Token 部分沉淀成了 cloud189-sdk。读完 src/app.js 的百余行源码再把 src/push/ 的推送模块抄进自己项目你就拥有了一个完整的天翼网盘自动签到 消息通知系统剩下的就是把它变成你想要的样子了。【免费下载链接】Cloud189Checkin天翼网盘自动签到项目地址: https://gitcode.com/gh_mirrors/clo/Cloud189Checkin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考