> For the complete documentation index, see [llms.txt](https://qx.atlucky.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://qx.atlucky.me/shi-yong-fang-fa/pei-zhi-wen-jian-xiang-jie/gong-ju-fen-xi/http-qing-qiu-tasklocal.md).

# HTTP请求\[task\_local]

## 简介

QX 对于此项目的介绍：构造HTTP或HTTPS请求，并在指定的时间发送。兼容5位或6位（不包括指令）cron语法。

计划任务需QX处于运行状态以及计划任务开关为开启状态。

点击任务图标可禁用单个任务，但您仍可向右滑动对应条目手动执行。

这部分添加的内容体现在配置文件的**`[task_local]`**字段内格式：

```
[task_local]
0 0 * * * https://raw.githubusercontent.com/crossutility/Quantumult-X/master/sample-task.js#force-timeout=10000&method=POST, tag=Sample, img-url=https://raw.githubusercontent.com/crossutility/Quantumult-X/master/quantumult-x.png, enabled=true
```

配置文件中一条完整的http请求是这么组成的

```
<任务类型>, <资源路径>,<资源标签>,<图标路径>,<是否启用>
```

* **任务类型**：cron（定时任务）、event-network（网络切换脚本，网络切换/变化时触发）、event-interaction（UI交互脚本，首页长按策略或节点唤出）
* **`tag`**：任务名称标识
* **`img-url`**：可本地可网络，只支持144\*144大小图标
* **`enabled`** 是否启用该任务，若不使用可改为 `false`

## 界面

在使用这系列的功能之前，先对界面和各图标的功能简单介绍一下。

<figure><img src="/files/RvTRokKU4a3r0a903Bp3" alt=""><figcaption></figcaption></figure>

在任务上向左和向右滑动会出现一些选项，点击任务图标可以禁用该任务。

<figure><img src="/files/QvgNAnTiMWrozbr3hg9e" alt=""><figcaption></figcaption></figure>

### 任务仓库task gallery 订阅

TF 版本 1.0.17 (build 433)后，Quantumult X 加入了 task-gallery，可以实现签到脚本订阅&管理。

[官方示范格式JSON](https://github.com/crossutility/Quantumult-X/blob/master/gallery.json)

[可用API转换，示范](https://t.me/QuanX_API/63)

添加步骤见下面图文

这里以下面这个为例

[`https://dove.589669.xyz/task2qxgallery?&sub=https%3A%2F%2Fraw.githubusercontent.com%2Fchavyleung%2Fscripts%2Fmaster%2FLoon.task.conf&name=Chavy_Tasks`](https://dove.589669.xyz/task2qxgallery?\&sub=https%3A%2F%2Fraw.githubusercontent.com%2Fchavyleung%2Fscripts%2Fmaster%2FLoon.task.conf\&name=Chavy_Tasks)

点击上面最左边的任务仓库图标，在出来的页面中点击➕图标，在弹出的对话框中清理掉原来的链接地址，注意完全清理掉，粘贴进去要添加的仓库链接，注意不要留空格

<figure><img src="/files/0k2bvdMNnh2ldOTAScRT" alt=""><figcaption></figcaption></figure>

如果链接没有错误的话，添加进去的任务仓库会显示仓库名称和任务图标，点击想添加使用的任务图片旁边的➕号，添加到请求列表中去。

<figure><img src="/files/jLc6hrQBFnSEmotZavLX" alt=""><figcaption></figcaption></figure>

签到类型的脚本，配置正确的话到设定时间会在QX启动的情况下自动运行，这种一般需要配合着账户的cookie，具体使用方法请阅读脚本中或者作者写的使用说明。

<figure><img src="/files/MRkGsPvQ2Kczn2CTYoS1" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
使用任务仓库请注意其中的脚本的使用方法和有效性，有些脚本可能已经失效或者过期了。
{% endhint %}

### 实战添加boxjs和单个任务

涉及到签到类型的task都与账户的cookie和数据持久化有关联，这里以巴哈姆特的签到为例，图文描述一下boxjs的安装和订阅，以及单个任务添加等步骤，如果遇到相同类型的可以作为参考

脚本地址：`https://github.com/NobyDa/Script/blob/master/Bahamut/BahamutDailyBonus.js`

<figure><img src="/files/owZr6QDFpAk8tFvjyq5n" alt=""><figcaption></figcaption></figure>

通过阅读脚本的注释说明部分，可以看到需要用到boxjs订阅，并且给出了订阅地址，以及脚本的兼容性，如何使用等等

{% hint style="warning" %}
规范的开发者都会写清楚如何使用，养成阅读开发者说明的好习惯。
{% endhint %}

#### 添加boxjs

QX添加boxjs是在重写中进行的（早期是采用http\_backend，但是此方法已经废弃），添加步骤，点一下首页的风车图标，进入设置，点击重写板块下的规则资源，点击右上角的链接🔗图标，在资源路径中粘贴上boxjs的重写资源链接，填上标签，勾上资源解析器，并且保存即可。（远程重写的一些操作步骤见[重写章节](/shi-yong-fang-fa/pei-zhi-wen-jian-xiang-jie/zhong-xie-rewrite/rewrite_remote.md#tian-jia-fang-shi)）

<figure><img src="/files/By7ygKdriMiidPebCm3R" alt=""><figcaption></figcaption></figure>

#### boxjs中添加订阅

在boxjs的订阅页面中，选择添加订阅（如果没有其它订阅时）或者右上角的➕号，将脚本介绍中的订阅地址粘贴进去（json格式）

<figure><img src="/files/bZ6IJShajKLJyTlZ4wFK" alt=""><figcaption><p>boxjs添加订阅步骤</p></figcaption></figure>

保存后刷新出内容，在其中找到巴哈姆特签到相关的，按照脚本说明输入用户名和密码并保存。

<figure><img src="/files/xUzDnIF9Ath3V3u8gii8" alt=""><figcaption><p>一般里面都含有很多内容，根据需要订阅使用，注意看使用说明</p></figcaption></figure>

#### 添加单个任务

添加方式有按照默认的先写cron再写入脚本，这种方式是将脚本的内容整个复制粘贴到脚本编辑器中，并存储在本地，因为一般人没有脚本的维护更新能力，不建议使用此种方式添加，在此也不做介绍了。介绍的是点击添加后选择文本方式和高级这两种

1.使用文本方式添加

在请求列表点击右上角的➕号，选择文本方式添加，将`[task_local]`底下的内容一次性的全部复制并粘贴进去后保存即可。

例如上面的脚本中说明QX的使用方法部分：

> ***
>
> 【 QX 1.0.10+ 脚本配置 】 :
>
> ***
>
> \[task\_local]&#x20;
>
> 0 8 \* \* \* <https://raw.githubusercontent.com/NobyDa/Script/master/Bahamut/BahamutDailyBonus.js>, tag=巴哈姆特签到, img-url=<https://raw.githubusercontent.com/NobyDa/mini/master/Color/bahamutGame.png>
>
> \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*/

则是将：

`0 8 * * * https://raw.githubusercontent.com/NobyDa/Script/master/Bahamut/BahamutDailyBonus.js, tag=巴哈姆特签到, img-url=https://raw.githubusercontent.com/NobyDa/mini/master/Color/bahamutGame.png`

这一部分全部复制后贴进去保存即可，见下图。

<figure><img src="/files/SscfHO2IhTkWCcP9kDyI" alt=""><figcaption><p>文本方式添加</p></figcaption></figure>

2.点击添加后选择高级方式添加，将字段按照对应位置填写进去保存即可

<figure><img src="/files/0xSTnLDDMYZniafycDEL" alt=""><figcaption><p>填写时候按照类型添加即可</p></figcaption></figure>

添加成功后，手动执行看下效果

<figure><img src="/files/sdkqHXgDPXmWg9tqrSxF" alt=""><figcaption><p>手动执行看下日志</p></figcaption></figure>

关于boxjs的一些使用等可以参照开发者本人的教程：<https://docs.boxjs.app>

以上是以巴哈姆特的签到配合boxjs做的一个示例的过程，如果有类似的可以作为参照，使用过程中请仔细阅读相关说明。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://qx.atlucky.me/shi-yong-fang-fa/pei-zhi-wen-jian-xiang-jie/gong-ju-fen-xi/http-qing-qiu-tasklocal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.