Skip to content

Latest commit

 

History

History
493 lines (396 loc) · 40.3 KB

README.md

File metadata and controls

493 lines (396 loc) · 40.3 KB

ASFEnhance

Codacy Badge GitHub Workflow Status License

GitHub Release GitHub Release GitHub last commit

GitHub Repo stars GitHub Download

Bilibili Steam

Steam 爱发电

English Version | Русская Версия

ASFEnhance 介绍 & 使用指南: https://keylol.com/t804841-1-1

EULA

请不要使用本插件来进行不受欢迎的行为, 包括但不限于: 刷好评, 发布广告 等.

详见 插件配置说明

限时活动 EVENT

本组命令具有时效性, 仅能在特定时间内使用, 失效的命令将会在插件的下一个版本中被移除

命令 缩写 权限 说明
CLAIM20TH [Bots] C20 Operator 领取点数商店中 20 周年免费物品
CLAIMITEM [Bots] CI Operator 获取促销活动的奖励物品(比如贴纸)
SIM4 [Bots] Operator 获取 The Sims™ 4 贴纸 url
DL2 [Bots] Operator 获取 Dying Light 2 Stay Human 个人资料装饰品 url
DL22 [Bots] [Sticker Id] Operator 获取 Dying Light 2 Stay Human 个人资料头像, Sticker Id 参数可选, 有效值为 1 到 8 url
RLE [Bots] [Sticker Id] Operator 获取 Redfall Launch Event 贴纸, Sticker Id 参数可选, 有效值为 1 到 4 url
VOTE [Bots] <AppIds> V Operator 为 STEAM 大奖 投票, AppIds 最多指定 10 个游戏, 未指定或 AppIds 不足 10 个时不足部分将使用内置 AppId 进行投票
CHECKVOTE [Bots] CV Operator 获取 STEAM 大奖 徽章任务完成情况

安装方式

初次安装 / 手动更新

  1. 从 GitHub Releases 下载插件的最新版本
  2. 解压后将 ASFEnhance.dll 丢进 ArchiSteamFarm 目录下的 plugins 文件夹
  3. 重新启动 ArchiSteamFarm , 使用命令 ASFEnhance 或 ASFE 来检查插件是否正常工作

子模块

ASFEnhance 2.0.0.0 之后, 增加了子模块系统, 可以管理并更新受支持的插件

受支持的插件列表:

接入示例插件: ASFEnhanceAdapterDemoPlugin

插件更新 & 子模块更新

命令 缩写 权限 说明
PLUGINSLIST PL Operator 获取当前安装的插件列表, 末尾带 [] 的为可被 ASFEnhance 管理的子模块
PLUGINLIST - Operator 同 PLUGINSLIST
PLUGINSVERSION [插件名] PV Master 获取指定模块的版本信息, 未指定插件名时检查所有受支持的插件的版本信息
PLUGINVERSION - Master 同 PLUGINSVERSION
PLUGINSUPDATE [插件名] PU Master 自动更新指定模块, 未指定插件名时自动更新所有受支持的插件
PLUGINUPDATE - Master 同 PLUGINSUPDATE

更新日志

ASFEnhance 版本 适配 ASF 版本 更新说明
2.0.1.0 5.4.12.5 新增 VOTE CHECKVOTE 命令
2.0.0.0 5.4.12.5 ASF -> 5.4.12.5, 新的子模块系统, 新增 EMAIL 命令等
历史版本

ASF 5.4.10.3 以及之前的版本因为 Steam 的改动已经无法使用, 请使用新版本的 ASF 和 ASFEnhance

ASFEnhance 版本 依赖 ASF 版本 5.4.7.3 5.4.8.3 5.4.9.3
1.8.13.0 5.4.10.3 ❌ ✔️ ✔️
1.8.12.2 5.4.9.3 ✔️ ✔️
1.8.11.1 5.4.9.3 ✔️ ✔️
1.8.10.0 5.4.9.3 ✔️ ✔️
1.8.9.0 5.4.9.3 ✔️ ✔️
1.8.8.0 5.4.8.3 ❌ ✔️ ✔️
ASFEnhance 版本 依赖 ASF 版本 5.4.5.2 5.4.6.3 5.4.7.3 5.4.8.3
1.8.7.1 5.4.7.3 ✔️ ❌
1.8.6.2 5.4.7.3 ✔️ ❌
1.8.5.0 5.4.7.3 ✔️ ❌
1.8.4.0 5.4.7.2 ✔️ ❌
1.8.3.0 5.4.6.3 ✔️ ✔️ ❌
1.8.2.0 5.4.6.3 ✔️ ✔️ ❌
1.8.1.3 5.4.5.2 ✔️ ✔️ ✔️ ❌
ASFEnhance 版本 依赖 ASF 版本 5.4.1.11 5.4.2.13 5.4.3.2 5.4.4.x
1.8.0.2 5.4.4.5 ❌ ❌ ✔️
1.7.25.0 5.4.4.5 ❌ ❌ ✔️
1.7.24.1 5.4.4.5 ❌ ❌ ✔️
1.7.23.0 5.4.4.5 ❌ ❌ ✔️
1.7.22.0 5.4.4.5 ❌ ❌ ✔️
1.7.21.0 5.4.4.4 ❌ ❌ ✔️
1.7.20.1 5.4.4.3 ❌ ❌ ✔️
1.7.19.1 5.4.3.2 ❌ ❌ ✔️
1.7.18.0 5.4.2.13 ❌ ✔️ ✔️
1.7.17.0 5.4.2.13 ❌ ✔️ ✔️
1.7.16.0 5.4.2.13 ❌ ✔️ ✔️
1.7.15.2 5.4.2.13 ❌ ✔️ ✔️
1.7.14.1 5.4.2.13 ❌ ✔️ ✔️
1.7.13.0 5.4.2.13 ❌ ✔️ ✔️
ASFEnhance 版本 依赖 ASF 版本 5.3.1.2 5.3.2.4 5.4.0.3 5.4.1.11
1.7.12.1 5.4.1.11 ❌ ❌ ❌ ✔️
1.7.11.0 5.4.1.11 ❌ ❌ ❌ ✔️
1.7.10.0 5.4.1.11 ❌ ❌ ❌ ✔️
1.7.9.0 5.4.1.11 ❌ ❌ ❌ ✔️
1.7.8.0 5.4.1.11 ❌ ❌ ❌ ✔️
1.7.7.0 5.4.1.11 ❌ ❌ ❌ ✔️
1.7.6.0 5.4.0.3 ❌ ❌ ✔️ ✔️
1.7.5.0 5.4.0.3 ❌ ❌ ✔️ ✔️
1.7.4.0 5.4.0.3 ❌ ❌ ✔️ ✔️
1.7.3.0 5.4.0.3 ❌ ❌ ✔️ ✔️
1.7.2.1 5.4.0.3 ❌ ❌ ✔️ ✔️
1.7.1.0 5.4.0.3 ❌ ❌ ✔️ ✔️
1.7.0.1 5.4.0.3 ❌ ❌ ✔️ ✔️
1.6.23.0 5.3.2.4 ❌ ✔️ ✔️
1.6.22.1 5.3.2.4 ❌ ✔️ ✔️
1.6.21.6 5.3.2.4 ❌ ✔️ ✔️
1.6.20.1 5.3.2.4 ❌ ✔️ ✔️
1.6.19.4 5.3.2.4 ❌ ✔️ ✔️
1.6.18.1 5.3.2.4 ❌ ✔️ ✔️
ASFEnhance 版本 依赖 ASF 版本 5.2.6.3 5.2.7.7 5.2.8.4 5.3.0.3 5.3.1.2
1.6.18.0 5.3.1.2 ❌ ❌ ❌ ✔️ ✔️
1.6.16.0 5.3.1.2 ❌ ❌ ❌ ✔️ ✔️
1.6.15.0 5.3.1.2 ❌ ❌ ❌ ✔️ ✔️
1.6.14.0 5.3.1.2 ❌ ❌ ❌ ✔️ ✔️
1.6.12.717 5.3.1.2 ❌ ❌ ❌ ✔️ ✔️
1.6.11.670 5.3.1.2 ❌ ❌ ❌ ✔️ ✔️
1.6.10.666 5.3.0.3 ❌ ❌ ❌ ✔️ ✔️*
1.6.9.663 5.2.8.4 ❌ ❌ ✔️ ❌
1.6.8.661 5.2.7.7 ❌ ✔️

插件配置说明

本插件的配置不是必须的, 保持默认配置即可使用大部分功能

ASF.json

{
  //ASF 配置
  "CurrentCulture": "...",
  "IPCPassword": "...",
  "...": "...",
  //ASFEnhance 配置
  "ASFEnhance": {
    "EULA": true,
    "Statistic": true,
    "DevFeature": false,
    "DisabledCmds": ["foo", "bar"],
    "Address": {
      "Address": "Address",
      "City": "City",
      "Country": "US",
      "State": "NE",
      "PostCode": "12345"
    },
    "Addresses": [
      {
        "Address": "Address",
        "City": "City",
        "Country": "US",
        "State": "NE",
        "PostCode": "12345"
      }
    ]
  }
}
配置项 类型 默认值 说明
EULA bool true 是否同意 EULA*
Statistic bool true 是否允许发送统计数据, 仅用于统计插件用户数量, 不会发送任何其他信息
DevFeature bool false 是否启用开发者特性 (一共 3 条命令) 具有一定安全风险, 请谨慎开启
DisabledCmds list null 可选配置, 在此列表中的命令将会被禁用** , 不区分大小写, 仅对 ASFEnhance 中的命令生效
Address*** dict null 可选配置, 单个账单地址, 使用 REDEEMWALLET 命令激活钱包兑换码如果要求设置账单地址时自动使用
Addresses*** list null 可选配置, 多个账单地址, 需要账单地址时从列表中随机使用一个

* 同意 EULA 后, ASFEnhance 将会开放全部命令, 作为交换, ASFEnhance 会在执行 GROUPLIST 和 CURATORLIST 时自动关注作者的鉴赏家和组 (如果尚未关注的话)

* 禁用 EULA 后, ASFEnhance 将会限制使用 鉴赏家/群组/评测 等功能, 同时 ASFEnhance 也不会主动关注鉴赏家和组

** DisabledCmds 配置说明: 该项配置不区分大小写, 仅对 ASFEnhance 中的命令有效 例如配置为 ["foo","BAR"] , 则代表 FOO 和 BAR 命令将会被禁用 如果无需禁用任何命令, 请将此项配置为 null 或者 [] 当某条命令被禁用时, 仍然可以使用 ASFE.xxx 的形式调用被禁用的命令, 例如 ASFE.EXPLORER

*** Address 与 Addresses 为同一个配置项, 如果需要使用定区功能 , 仅配置一个即可, 不需要都配置, 如果不需要这个功能也可以不配置

插件指令说明

插件测试

命令 缩写 权限 说明
ASFENHANCE ASFE FamilySharing 查看 ASFEnhance 的版本

账号相关

命令 缩写 权限 说明
PURCHASEHISTORY [Bots] PH Operator 读取商店消费历史记录
FREELICENSES [Bots] FL Operator 读取账户中的免费 Sub License 列表
FREELICENSE [Bots] 同 FREELICENSES
LICENSES [Bots] L Operator 读取账户中的所有 License 列表
LICENSE [Bots] 同 LICENSES
REMOVEDEMOS [Bots] RD Master 移除账户中所有的 Demo License
REMOVEDEMO [Bots] 同 REMOVEDEMOS
REMOVELICENSES [Bots] <SubIDs> RL Master 移除账户中指定的 Sub License
REMOVELICENSE [Bots] <SubIDs> 同 REMOVELICENSES
EMAILIOPTIONS [Bots] EO Operator 读取账户中的电子邮件偏好选项 url
EMAILIOPTION [Bots] 同 EMAILOPTIONS
SETEMAILOPTIONS [Bots] <Options> SEO Master 设置账户中的电子邮件偏好选项
SETEMAILOPTION [Bots] <Options> 同 SETEMAILOPTIONS
NOTIFICATIONOPTIONS [Bots] NOO Operator 读取账户中的通知选项 url
NOTIFICATIONOPTION [Bots] 同 NOTIFICATIONOPTIONS
SETNOTIFICATIONOPTIONS [Bots] <Options> SNOO Master 设置账户中的通知选项
SETNOTIFICATIONOPTION [Bots] <Options> 同 SETNOTIFICATIONOPTIONS
GETBOTBANNED [Bots] GBB Operator 获取机器人的账户封禁情况
GETBOTBANN [Bots] 同 GETBOTBANNED
GETACCOUNTBANNED <SteamIds> GBB Operator 获取指定账户封禁情况, 支持 SteamId 64 / SteamId 32
GETACCOUNTBAN <SteamIds> 同 GETACCOUNTBANNED
EMAIL [Bots] EM Operator 获取账户电子邮件

  • SETEMAILOPTIONS 参数说明

    <Options> 参数接受最多 9 个参数, 使用空格或者 , 分隔, 顺序参照 url 如果参数为 on, yes, true, 1, y 则视为开启, 否则视为禁用(默认)

索引 名称 说明
1 是否启用电子邮件通知 禁用后其余选项均不起作用
2 愿望单物品打折时发送邮件通知
3 愿望单物品发行或脱离抢先体验时发送邮件通知
4 关注的青睐之光物品发行或脱离抢先体验时发送邮件通知
5 关注的发行商发行或者脱离抢险体验时发送邮件通知
6 当季节促销开始时发送邮件通知
7 收到鉴赏家评测副本时发送邮件通知
8 收到社区奖励时发送邮件通知
9 收到游戏活动通知时发送邮件通知

  • SETNOTIFICATIONS 参数说明

    <Options> 参数接受最多 9 个参数, 使用空格或者 , 分隔, 顺序参照 url 索引含义和设置值可选的范围见下表

索引 名称
1 我收到了礼物
2 我订阅的讨论区有回复
3 我库存中收到了新物品
4 我收到了好友邀请
5 有大型特卖
6 愿望单中的某件物品有折扣
7 我收到了一个新的交易报价
8 我收到了 Steam 客服的回复
9 我收到了 Steam 回合通知
设置值 含义
0 关闭通知
1 启用通知
2 启用通知, Steam 客户端弹出通知
3 启用通知, 手机应用推送通知
4 启用通知, Steam 客户端弹出通知, 手机应用推送通知

其他功能

命令 缩写 权限 说明
KEY <Text> K FamilySharing 从文本提取 key
ASFEHELP EHELP FamilySharing 查看全部指令说明
HELP <Command> - FamilySharing 查看指令说明

群组相关

命令 缩写 权限 说明
GROUPLIST [Bots] GL FamilySharing 查看机器人的群组列表
JOINGROUP [Bots] <GroupName> JG Master 加入指定群组
LEAVEGROUP [Bots] <GroupID> LG Master 离开指定群组

GroupID可以用命令GROUPLIST获取

个人资料相关

命令 缩写 权限 说明
PROFILE [Bots] PF FamilySharing 查看个人资料
PROFILELINK [Bots] PFL FamilySharing 查看个人资料链接
STEAMID [Bots] SID FamilySharing 查看 steamID
FRIENDCODE [Bots] FC FamilySharing 查看好友代码
TRADELINK [Bots] TL Operator 查看交易链接
REPLAY [Bots] RP Operator 获取摘要图片链接 (可以解锁徽章)
REPLAYPRIVACY [Bots] Privacy RPP Operator 设置年度总结可见性, Privacy 1=私密 2=好友可见 3=公开
CLEARALIAS [Bots] Opetator 清除曾用名
GAMEAVATAR [Bots] <AppID> [AvatarID] GA Master 根据指定 AppID 和 AvatarID 设置机器人的头像, 省略 AvatarId 时将随机选择头像
RANDOMGAMEAVATAR [Bots] RGA Master 设置机器人的头像为随机游戏头像
ADVNICKNAME [Bots] Query ANN Master 使用 占位符 设置机器人昵称, 可用占位符 %dn% %ln% %un% %botn% 不区分大小写
SETAVATAR [Bots] ImageUrl 🐞* GA Master 设置机器人的头像为指定网络图片
DELETEAVATAR [Bots] 🐞* Master 删除机器人的头像(设置为默认头像)
CRAFTBADGE [Bots] CB Master 自动合成可合成徽章 (每个可升级徽章合成一级)

*🐞: 需要使用 generic 版本的 ASF (非 generic-netf)

  • GAMEAVATAR 使用说明

头像来自 Game Avatars Page

  • ADVNICKNAME Query 参数说明

数字可以任意指定

占位符 说明 示例结果
%d% 随机数字 5
%dn% n 位随机数字 %d6% -> 114514
%l% 随机小写字母 x
%ln% n 位小写字母 %d7% -> asfeadf
%u% 随机大写字母 C
%un% n 位随机大写字母 %d8% -> ASXCGDFA
%bot% 机器人昵称 ASFE
%bot3% 机器人昵称, 重复 3 次 %bot3% -> ASFEASFEASFE

鉴赏家相关

命令 缩写 权限 说明
CURATORLIST [Bots] CL Master 查看已关注的鉴赏家列表
FOLLOWCURATOR [Bots] <ClanIDs> FCU Master 关注指定鉴赏家
UNFOLLOWCURATOR [Bots] UFCU Master 取消关注指定鉴赏家
UNFOLLOWALLCURATORS [Bots] UFACU Master 取消关注所有鉴赏家
UNFOLLOWALLCURATOR [Bots] 同 UNFOLLOWALLCURATORS

愿望单相关

命令 缩写 权限 说明
ADDWISHLIST [Bots] <AppIDs> AW Master 添加愿望单
REMOVEWISHLIST [Bots] <AppIDs> RW Master 移除愿望单
FOLLOWGAME [Bots] <AppIDs> FG Master 关注游戏
UNFOLLOWGAME [Bots] <AppIDs> UFG Master 取消关注游戏
CHECK [Bots] <AppIDs> CK Master 检查游戏关注/愿望单情况

商店相关

命令 缩写 权限 说明
APPDETAIL [Bots] <AppIDs> AD Operator 获取 APP 信息, 无法获取锁区游戏信息, 仅支持APP
SEARCH [Bots] Keywords SS Operator 搜索商店
SUBS [Bots] <AppIDs|SubIDs|BundleIDs> S Operator 查询商店 SUB, 支持 APP/SUB/BUNDLE
PUBLISHRECOMMENT [Bots] <AppIDs> COMMENT PREC Master 发布评测, APPID 或 +APPID 给好评, -AppID 给差评
DELETERECOMMENT [Bots] <AppIDs> DREC Master 删除评测
REQUESTACCESS [Bots] <AppIDs> RA Operator 请求游戏内测访问权限, 等效于点击 请求访问权限
VIEWPAGE [Bots] Url VP Operator 访问指定页面

购物车相关

STEAM 的购物车储存在 Cookies 里,重启 ASF 将会导致购物车清空

命令 缩写 权限 说明
CART [Bots] C Operator 查看机器人购物车
ADDCART [Bots] <SubIDs|BundleIDs> AC Operator 添加购物车, 仅能使用SubID和BundleID
CARTRESET [Bots] CR Operator 清空购物车
CARTCOUNTRY [Bots] CC Operator 获取购物车可用结算区域(跟账号钱包和当前 IP 所在地有关)
FAKEPURCHASE [Bots] FPC Master 模拟结算机器人的购物车, 生成一条购买失败的记录, 不会真的结账
PURCHASE [Bots] PC Master 结算机器人的购物车, 只能为机器人自己购买 (使用 Steam 钱包余额结算)
PURCHASEGIFT [BotA] BotB PCG Master 结算机器人 A 的购物车, 发送礼物给机器人 B (使用 Steam 钱包余额结算)

Steam 允许重复购买,使用 PURCHASE 命令前请自行确认有无重复内容

社区相关

命令 缩写 权限 说明
CLEARNOTIFICATION [Bots] CN Operator 清除新物品和新留言通知

好友相关

命令 缩写 权限 说明
ADDBOTFRIEND <Bots> ABF Master 让Bots互相添加为好友
ADDBOTFRIEND <BotAs>+<BotBs> Master 让BotAs互相添加为好友, 并且让BotAs添加BotsBs为好友
ADDFRIEND [Bots] <Text> AF Master 让机器人发送好友请求, Text 支持 自定义链接, SteamId, 好友代码
DELETEFRIEND [Bots] <Text> DF Master 删除指定好友, Text 支持 自定义链接, SteamId, 好友代码
DELETEALLFRIEND [Bots] Master 删除所有好友
INVITELINK [Bots] IL Operator 生成好友邀请链接
  • ADDBOTFRIEND 参数示例
    • ADDBOTFRIEND a,b c: 让a,b,c互相添加好友
    • ADDBOTFRIEND a,b,c + d,e: 让a,b,c互相添加好友, 然后让a,b,c分别添加d,e为好友, d不会添加e为好友
    • ADDBOTFRIEND ASF: 允许使用通配符
    • ADDBOTFRIEND a b c + ASF: 允许使用通配符
    • ADDBOTFRIEND ASF + ASF: 允许使用, 但是没有意义

探索队列

命令 缩写 权限 说明
EXPLORER [Bots] EX Master 5 秒后触发 ASF 探索队列任务

请尽量让 ASF 自己来探索队列, 本命令仅作为强制触发探索队列的一种补充方式

钱包相关

命令 缩写 权限 说明
REDEEMWALLET [Bots] <keys> RWA Master 兑换钱包充值码, 如果需要提供地址信息则自动填入配置文件中的地址
REDEEMWALLETMULT [Bots] <keys> RWAM Master 批量兑换钱包充值码, 但是每个机器人只会兑换一个 key

ASF 命令缩写

命令缩写 等价命令 说明
AL [Bots] <Licenses> ADDLICENSE [Bots] <Licenses> 添加免费 SUB
LA LEVEL ASF 获取所有机器人的等级
BA BALANCE ASF 获取所有机器人的钱包余额
PA POINTS ASF 获取所有机器人的点数余额
P [Bots] POINTS 获取机器人的点数余额
CA CART ASF 获取所有机器人的购物车信息

面向开发者

本组命令默认是禁用的. 需要在 ASF.json 中配置 "DevFeature": true 才能启用本组命令

命令 权限 说明
COOKIES [Bots] Owner 查看 Steam 商店的 Cookies
APIKEY [Bots] Owner 查看 Bot 的 APIKey
ACCESSTOKEN [Bots] Owner 查看 Bot 的 ACCESSTOKEN

IPC 接口

使用该功能前需要同意 EULA, 详见 插件配置说明

API 方法 参数 说明
/Api/ASFEnhance/{botNames}/FollowCurator POST ClanIDs 关注鉴赏家
/Api/ASFEnhance/{botNames}/UnFollowCurator POST ClanIDs 取消关注鉴赏家
/Api/ASFEnhance/{botNames}/FollowingCurators POST Start, Count 获取已关注的鉴赏家列表
/Api/ASFEnhance/{botNames}/GetAppDetail POST AppIDs 获取游戏详情
/Api/ASFEnhance/{botNames}/Purchase POST SubIDs, BundleIDs, SkipOwned 批量购买游戏
/Api/ASFEnhance/{botNames}/PublishReview POST AppIDs, RateUp, AllowReply, ForFree,Public,Comment 发布游戏评测
/Api/ASFEnhance/{botNames}/DeleteReview POST AppIDs 删除游戏评测
/Api/ASFEnhance/{botNames}/AddWishlist POST AppIDs 添加愿望单
/Api/ASFEnhance/{botNames}/RemoveWishlist POST AppIDs 移除愿望单
/Api/ASFEnhance/{botNames}/FollowGame POST AppIDs 关注游戏
/Api/ASFEnhance/{botNames}/UnFollowGame POST AppIDs 取消关注游戏
/Api/ASFEnhance/{botNames}/CheckGame POST AppIDs 检查游戏关注和愿望单情况

Repobeats analytics image

Stargazers over time