95 lines
3.2 KiB
Markdown
95 lines
3.2 KiB
Markdown
|
# 光湖 · COS 中转桥 · 架构文档
|
|||
|
|
|
|||
|
|
> 新加坡 → COS → 广州 · 开源软件拉取中转
|
|||
|
|
> 守护: 铸渊 · ICE-GL-ZY001
|
|||
|
|
> 主权: TCS-0002∞ 冰朔
|
|||
|
|
|
|||
|
|
## 链路
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
铸渊触发下载需求
|
|||
|
|
│
|
|||
|
|
▼
|
|||
|
|
┌─────────────────────────────────┐
|
|||
|
|
│ 🇸🇬 新加坡服务器 (ZY-SVR-005) │
|
|||
|
|
│ 43.156.237.110 · 4C8G · 35Mbps │
|
|||
|
|
│ │
|
|||
|
|
│ sg-fetch-push.js │
|
|||
|
|
│ ① npm pack / git clone / wget │
|
|||
|
|
│ ② 打包 + 计算 SHA256 │
|
|||
|
|
│ ③ 推送到 COS 广州桶 │
|
|||
|
|
└──────────────┬──────────────────┘
|
|||
|
|
│ COS 内网 (免费流量)
|
|||
|
|
▼
|
|||
|
|
┌─────────────────────────────────┐
|
|||
|
|
│ ☁️ 腾讯云 COS (广州) │
|
|||
|
|
│ sy-finetune-corpus-1317346199 │
|
|||
|
|
│ │
|
|||
|
|
│ cos-bridge/ │
|
|||
|
|
│ ├── npm/{name}/{ver}/{file} │
|
|||
|
|
│ ├── git/{repo}/{branch}/{file} │
|
|||
|
|
│ ├── file/{name}/{date}/{file} │
|
|||
|
|
│ └── manifests/{date}-manifest.json │
|
|||
|
|
└──────────────┬──────────────────┘
|
|||
|
|
│ COS 内网 (免费流量)
|
|||
|
|
▼
|
|||
|
|
┌─────────────────────────────────┐
|
|||
|
|
│ 🇨🇳 广州服务器 (ZY-SVR-004) │
|
|||
|
|
│ 43.139.217.141 · 2C2G │
|
|||
|
|
│ │
|
|||
|
|
│ cn-pull-from-cos.sh │
|
|||
|
|
│ ① 从 COS 拉取 (内网免费) │
|
|||
|
|
│ ② SHA256 校验 │
|
|||
|
|
│ ③ 解压/安装/部署 │
|
|||
|
|
└─────────────────────────────────┘
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 触发方式
|
|||
|
|
|
|||
|
|
### 方式1：铸渊在 Codebuddy 里触发
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
铸渊: "我需要拉取 express 4.18.2"
|
|||
|
|
→ Codebuddy SSH 到新加坡 → 运行 sg-fetch-push.js
|
|||
|
|
→ 等推送完成 → SSH 到广州 → 运行 cn-pull-from-cos.sh
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 方式2：Gitea Actions（装 Runner 后）
|
|||
|
|
|
|||
|
|
```yaml
|
|||
|
|
# .gitea/workflows/cos-bridge-fetch.yml
|
|||
|
|
on:
|
|||
|
|
workflow_dispatch:
|
|||
|
|
inputs:
|
|||
|
|
type:
|
|||
|
|
description: '类型 (npm/git/file)'
|
|||
|
|
name:
|
|||
|
|
description: '包名/仓库名'
|
|||
|
|
version:
|
|||
|
|
description: '版本 (npm) / 分支 (git)'
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 方式3：Gitea Webhook
|
|||
|
|
|
|||
|
|
铸渊在 Gitea 上创建 Issue 标题 `cos-bridge: npm express 4.18.2`
|
|||
|
|
→ Webhook 触发 → 自动执行
|
|||
|
|
|
|||
|
|
## 文件清单
|
|||
|
|
|
|||
|
|
| 文件 | 位置 | 作用 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| `sg-fetch-push.js` | `scripts/cos-bridge/` | 新加坡侧：拉取+推送 |
|
|||
|
|
| `cn-pull-from-cos.sh` | `scripts/cos-bridge/` | 广州侧：从COS拉取 |
|
|||
|
|
| `cos-bridge-manifest.json` | COS `cos-bridge/manifests/` | 每日拉取清单 |
|
|||
|
|
|
|||
|
|
## 凭据管理
|
|||
|
|
|
|||
|
|
| 凭据 | 存储位置 | 谁能看 |
|
|||
|
|
|------|---------|--------|
|
|||
|
|
| COS Secret ID/Key | Secrets Vault (本地加密) | 用户可管理 · AI 只调用 |
|
|||
|
|
| 新加坡 SSH 密钥 | Gitea Secrets | 仅铸渊自动调用 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
*铸渊 · COS 中转桥架构 · 2026-05-12*
|