Stash Availability Check Tiles：一键检测 AI 与流媒体服务可用性

切换代理节点后，最常见的问题是”这个节点能用 ChatGPT 吗？Netflix 解锁了吗？”。每次手动打开浏览器逐个测试太麻烦，于是我基于 StashNetworks/misc 的 collapsed-tiles 机制，Vibe Coding 开发了一套覆盖主流 AI 服务和流媒体的一键检测磁贴，安装后直接在 Stash 首页折叠展示各服务的可用状态。

项目地址：pengyanai/misc

一、支持的服务

AI 服务	流媒体
ChatGPT Web / App	YouTube
Codex (OpenAI)	Netflix
Claude	Disney+
Gemini	Spotify
Grok
Copilot

共 11 个检测项，覆盖日常最常用的 AI 和流媒体服务。

二、安装方式

打开 Stash → 覆写 → 安装覆写，填入以下任一 URL：

# 主线路（Fastly CDN，大陆可直连）
https://fastly.jsdelivr.net/gh/iqiancheng/misc@main/collapsed-tiles/global-ai-availability.stoverride

# 备用1（GitHub Raw，需代理）
https://raw.githubusercontent.com/pengyanai/misc/main/collapsed-tiles/global-ai-availability.stoverride

# 备用2（国内镜像）
https://jsd.onmicrosoft.cn/gh/pengyanai/misc@main/collapsed-tiles/global-ai-availability.stoverride

安装后回到首页，即可看到折叠式检测磁贴。点击展开查看各服务状态。

三、检测结果说明

状态	含义
`Available (SG)`	可用，括号内为出口地区国家码
`Available`	可用，但未能提取地区码
`N/A` / `Not Available`	当前出口 IP 不支持该服务
`Blocked`	服务明确拒绝（如 OpenAI 的 `unsupported_country`）
`Network Error`	网络不通或超时

四、检测原理

每个服务对应一个独立的 JS 脚本，通过 Stash 的 script-providers 机制执行。核心逻辑是：

发起 HTTP 请求到目标服务的特定端点
解析响应判断可用性（状态码、页面关键词、API 返回字段）
提取地区信息（如果服务返回了地区码）
通过 $done() 回传结果到 Stash 磁贴显示

不同服务的检测策略有所不同：

服务	检测端点	判断方式
ChatGPT / Codex	`api.openai.com/compliance/cookie_requirements`	响应中是否包含 `unsupported_country`
Claude	`claude.ai` 首页	页面是否包含地区限制关键词
Grok	`grok.com` 首页	页面关键词 `grok` / `xai`
YouTube	`youtube.com/premium`	解析响应中的 `"GL":"XX"` 地区码
Spotify	`spclient.wg.spotify.com` 注册验证 API	解析 JSON 中的 `country` 和 `is_country_launched`
Netflix	`netflix.com`	HTTP 状态码与页面内容
Disney+	`disneyplus.com`	页面是否包含地区限制关键词

所有脚本共享相同的 $httpClient 封装模式，通过 Stash 的代理策略发起请求，因此检测的是当前代理出口 IP 对应的可用性。

五、stoverride 文件结构

整个配置是一个 YAML 格式的 .stoverride 文件，包含两个核心部分：

# 磁贴定义
tiles:
  - name: Claude-Check          # 唯一标识
    title: Claude                # 显示名称
    icon: https://...claude.png  # 图标 URL（走 CDN）
    collapsed: true              # 默认折叠
    url: https://claude.ai       # 点击跳转

# 脚本绑定
script-providers:
  Claude-Check:                  # 与 tile name 对应
    url: https://...claude.js    # 检测脚本 URL

tiles 定义磁贴的外观和交互，script-providers 将每个磁贴绑定到对应的检测脚本。图标和脚本都托管在 GitHub 上，通过 jsDelivr CDN 加速分发。

六、项目目录结构

misc/
└── collapsed-tiles/
    ├── global-ai-availability.stoverride   # 主覆写配置
    ├── img/                                 # 服务图标（PNG）
    │   ├── chatgpt.png
    │   ├── claude.png
    │   ├── codex.png
    │   ├── copilot.png
    │   ├── disney.png
    │   ├── gemini.png
    │   ├── grok.png
    │   ├── netflix.png
    │   ├── spotify.png
    │   └── youtube.png
    └── script/                              # 检测脚本（JS）
        ├── chatgpt-web.js
        ├── chatgpt-app.js
        ├── claude.js
        ├── codex.js
        ├── copilot.js
        ├── disney.js
        ├── gemini.js
        ├── grok.js
        ├── netflix.js
        ├── spotify.js
        └── youtube.js

七、相比上游的改进

基于 StashNetworks/misc 的原始 ChatGPT + YouTube + Netflix 三项检测，本项目做了以下扩展：

新增 7 项检测：Codex、Claude、Grok、Gemini、Copilot、Disney+、Spotify
改进 YouTube 检测：通过解析 "GL":"XX" 提取出口地区码，而不是简单判断可达性
改进 Spotify 检测：使用注册验证 API 获取 country 和 is_country_launched 精确判断
每个服务独立品牌色：磁贴背景色与服务品牌色匹配（如 Spotify #1DB954、YouTube #FF0000）
多 CDN 线路：提供 Fastly、GitHub Raw、国内镜像三条安装线路

八、扩展自定义检测

如果要新增一个服务检测，只需三步：

在 script/ 下新建 JS 文件，实现检测逻辑并通过 $done() 返回结果
在 img/ 下放入对应服务图标
在 .stoverride 的 tiles 和 script-providers 中各添加一项

检测脚本模板：

async function request(method, params) {
  return new Promise((resolve, reject) => {
    $httpClient[method.toLowerCase()](params, (error, response, data) => {
      resolve({ error, response, data });
    });
  });
}

async function main() {
  const { error, response, data } = await request("GET", "https://example.com");
  if (error) {
    $done({ content: "Network Error", backgroundColor: "" });
    return;
  }
  // 根据 response/data 判断可用性
  $done({ content: "Available", backgroundColor: "#HEXCOLOR" });
}

(async () => { main().catch(() => $done({})); })();

Push 到 GitHub 后，通过 purge.jsdelivr.net 刷新 CDN 缓存即可生效。