# Script Collection

一个面向日常自动化的小型脚本集合，当前包含 Homebrew 升级管理、Sub-Store 节点重命名处理、Cloudflare Worker 脚本。

## 目录

```text
script/
├── homebrew/
│   ├── README.md
│   └── brew-upgrade-manager.sh
├── substore/
│   ├── README.md
│   └── sntp-rename.js
├── cf_worker/
│   ├── lskypro/
│   │   ├── README.md
│   │   └── lsky-telegram-worker.js
│   └── tg-bot/
│       ├── README.md
│       └── tg-bot.js
├── LICENSE
└── README.md
```

## 脚本概览

| 目录 | 脚本 | 用途 | 运行环境 |
| --- | --- | --- | --- |
| `homebrew/` | `brew-upgrade-manager.sh` | 自动更新 Homebrew、升级 Formula/Cask、清理缓存 | macOS、Bash、Homebrew |
| `substore/` | `sntp-rename.js` | 守候网络节点命名专用，在 Sub-Store 代理节点名称中注入线路标签 | Sub-Store 脚本处理器 |
| `cf_worker/lskypro/` | `lsky-telegram-worker.js` | Telegram 收图后上传到 Lsky Pro，并返回 Markdown 图片链接代码块 | Cloudflare Workers、D1、Telegram Bot、Lsky Pro |
| `cf_worker/tg-bot/` | `tg-bot.js` | 基于 Cloudflare Workers 的 Telegram 私聊转发与管理后台 | Cloudflare Workers、D1、Telegram Bot |

## 快速开始

### Homebrew 升级

```bash
cd homebrew
chmod +x brew-upgrade-manager.sh
./brew-upgrade-manager.sh
```

如在非交互式终端运行，可指定输出宽度：

```bash
./brew-upgrade-manager.sh --width 130
HB_TERMINAL_WIDTH=130 ./brew-upgrade-manager.sh
```

详细配置见 [homebrew/README.md](homebrew/README.md)。

### Sub-Store 节点标签注入

把 [substore/sntp-rename.js](substore/sntp-rename.js) 作为守候网络节点命名专用的 Sub-Store 节点处理脚本使用。默认会识别 `GTM`、`S1`、`S2`、`S3`、`S4`、`BGP`、`Anytls` 等关键词，并把标签插入到节点名末尾或 `- SNTP` 后缀之前。

详细规则见 [substore/README.md](substore/README.md)。

### Cloudflare Worker 脚本

`cf_worker/` 目录包含两个独立 Worker：

- [cf_worker/lskypro/lsky-telegram-worker.js](cf_worker/lskypro/lsky-telegram-worker.js)：接收 Telegram 图片，上传到 Lsky Pro，返回 Markdown 图片链接代码块。默认单文件上限 `500.00 MB`，上传队列最多 `500` 张。
- [cf_worker/tg-bot/tg-bot.js](cf_worker/tg-bot/tg-bot.js)：Telegram 私聊转发与管理后台，绑定 Telegram Bot Token、管理员 ID、管理群 ID 和 D1 数据库。

详细部署说明分别见 [cf_worker/lskypro/README.md](cf_worker/lskypro/README.md) 和 [cf_worker/tg-bot/README.md](cf_worker/tg-bot/README.md)。

## 安全提示

- 不要把 Bot Token、Cloudflare 密钥、Telegram 群组 ID、管理员 ID 或 sudo 密码提交到公开仓库。
- `homebrew/brew-upgrade-manager.sh` 当前包含 `SUDO_PWD` 占位变量，若确需使用自动输入 sudo 密码，请只在本机私有副本中填写。
- Cloudflare Worker 脚本会保存用户状态、消息映射、上传队列或配置项到 D1，请按实际隐私要求控制数据库访问权限。

## 许可证

本项目使用 GNU Affero General Public License v3.0，详见 [LICENSE](LICENSE)。