管理脚本

与远程代理集和规则集合类似，脚本需要通过 script-providers 管理。声明后即可在改写、面板和定时任务中引用。

最简单的例子是：

script-providers:
  your-fancy-script:
    url: https://your-fancy-script.com/your-fancy-script.js
    interval: 86400

Stash 会根据 interval 定期从指定 URL 下载脚本并缓存到磁盘。下载时会遵循 Etag 与 Last-Modified 头判断是否更新，避免不必要的请求。

💡

下述功能仅在 Stash 3.2.5 及更高版本中生效。

为了临时调试与测试，你可以使用 payload 字段将脚本直接写入配置文件。例如：

script-providers:
  your-fancy-script:
    interval: 86400
    payload: |
      console.log("This is a test script");
      $done();

当 url 与 payload 同时存在时，Stash 启动时会将 payload 写入本地缓存，后续更新会尝试从 url 下载脚本并覆盖缓存。

⚠️

不建议使用 payload 编写复杂脚本，这会显著降低 Stash 的配置解析效率。

为便于管理本地缓存，你可以用 path 指定缓存路径。例如：

script-providers:
  your-fancy-script:
    url: https://your-fancy-script.com/your-fancy-script.js
    path: ./fancy/script.js
    interval: 86400
    payload: |
      console.log("This is a test script");
      $done();

Stash 启动时会检查 ./fancy/script.js 是否存在；若存在则直接使用，否则写入 payload。后续更新会从 url 下载脚本并覆盖本地缓存。

⚠️

为避免路径越权，Stash 会将 path 限制在配置文件所在目录及其子目录内。

你可以仅声明 script-providers 并使用 path，不填写 url，这样脚本不会进行定时更新。例如：

script-providers:
  local-debug-script:
    path: ./fancy/script.js

开启 iCloud 后，可在 Mac 上直接修改该脚本文件，iCloud 会同步到 iPhone。同步完成后脚本会实时生效，这种方式非常适合本地调试脚本。

HTTP 重写语法与接口