# Technical Documentation: mack-a/v2ray-agent

> ℹ️ **Provenance:** Multi-Tier Ingestion · [CodeWiki Reference](https://codewiki.google/github.com/mack-a/v2ray-agent)

### Overview (README.md)

# v2ray-agent

- [感谢 JetBrains 提供的非商业开源软件开发授权](https://www.jetbrains.com/?from=v2ray-agent)


[](https://www.gnu.org/licenses/agpl-3.0)
[](https://t.me/v2rayAgentChannel)
[](https://t.me/technologyshare)
[](https://www.v2ray-agent.com/)
[](documents/en/README_EN.md)

Xray-core/sing-box 一键脚本快速安装

## 功能

*   **多核心支持:** 支持 Xray-core 和 sing-box.
*   **多协议支持:** 支持 VLESS, VMess, Trojan, Hysteria2, Tuic, NaiveProxy 等多种协议.
*   **自动TLS:** 自动申请和续订 SSL 证书.
*   **易于管理:** 提供简单的菜单来管理用户、端口和配置.
*   **订阅支持:** 生成和管理订阅链接.
*   **分流管理:** 提供wireguard、IPv6、Socks5、DNS、VMess(ws)、SNI反向代理，可用于解锁流媒体、规避IP验证等作用.
*   **目标域名管理:** 提供域名黑名单管理，可用于禁止访问指定网站.
*   **BT下载管理:** 可用于禁止下载P2P相关内容.
*   **更多内容请访问[官方网站](https://www.v2ray-agent.com/categories/jiao-cheng)、[备用](https://www.592083.com/categories/jiao-cheng)、[X](https://x.com/v2rayagent)**

## 快速开始

### 安装脚本版

```
wget -P /root -N --no-check-certificate "https://raw.githubusercontent.com/mack-a/v2ray-agent/master/install.sh" && chmod 700 /root/install.sh && /root/install.sh
```

### 使用

安装后，运行以下命令可再次打开管理菜单:

```
vasma
```

### 安装Docker版
```
wget -P /root -N --no-check-certificate "https://raw.githubusercontent.com/mack-a/v2ray-agent/master/shell/docker_reality.sh" && chmod 700 /root/docker_reality.sh && /root/docker_reality.sh
```

### 使用 

* [Docker Reality 使用说明](https://www.v2ray-agent.com/archives/019e1b57-92b3-70ab-8919-cdf8c0bb4fe9)
 
安装后，运行以下命令可再次打开管理菜单:

```
vasmad
```

## 文档和指南

*   [八合一脚本从入门到精通](https://www.v2ray-agent.com/archives/1710141233)
*   [脚本快速搭建教程](https://www.v2ray-agent.com/archives/1682491479771)
*   [脚本使用注意事项](https://www.v2ray-agent.com/archives/1679931532764)
*   [脚本异常处理](https://www.v2ray-agent.com/archives/1684115970026)   
*   [VPS选购攻略](https://www.v2ray-agent.com/archives/1679975663984)
*   [垃圾VPS大救星，hysteria2最新协议一键搭建](https://www.v2ray-agent.com/archives/1697162969693)
*   [RackNerd低价 联通AS4837套餐，年付10美起](https://www.v2ray-agent.com/archives/racknerdtao-can-zheng-li-nian-fu-10mei-yuan)
*   [搬瓦工优质套餐推荐](https://www.v2ray-agent.com/archives/2023nian-ban-wa-gong-ji-fang-tui-jian)
*   [DMIT优质套餐推荐](https://www.v2ray-agent.com/archives/1679159868033)

## 社区与支持

*   **Telegram:** [频道](https://t.me/v2rayAgentChannel) | [群组](https://t.me/technologyshare)
*   **网站:** [官网](https://www.v2ray-agent.com/) | [备用](https://www.592083.xyz/)
*   **反馈:** [提交 issue](https://github.com/mack-a/v2ray-agent/issues)
*   **X:** [链接](https://x.com/v2rayagent)

## 捐赠

感谢您对开源项目的关注和支持。如果您觉得这个项目对您有帮助，欢迎通过以下方式进行捐赠。

*   [购买VPS捐赠](https://www.v2ray-agent.com/categories/vps)
*   [通过虚拟币向我捐赠](https://www.v2ray-agent.com/1679123834836)

## 许可证

本项根据 [AGPL-3.0 许可证](LICENSE) 授权.

---

### Superpowers Plans 2026 09 14 Pelican Bike (`docs/superpowers/plans/2026-09-14-pelican-bike.md`)

# Pelican Bike SVG Animation Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.

**Goal:** Create a single dependency-free HTML page showing a retro poster SVG animation of a pelican riding a bicycle.

**Architecture:** One semantic HTML document contains styles, an inline SVG scene, and a tiny control script. SVG groups separate scenery, bike, and pelican so CSS/SVG animations can target each independently.

**Tech Stack:** HTML5, CSS3 keyframes, inline SVG, vanilla JavaScript.

## Global Constraints

- No external assets or libraries.
- Use retro poster colors: paper yellow, ink navy, orange/coral accents.
- Support pause/resume and `prefers-reduced-motion`.
- Keep the page responsive without horizontal overflow.

### Task 1: Build the animated poster page

**Files:**
- Create: `pelican-bike.html`

**Interfaces:**
- Produces a standalone page with SVG scene and button `#toggle-motion`.

- [ ] Add document structure, responsive layout, background texture, title, and accessible button.
- [ ] Draw scenery with sun, clouds, layered hills, road, and grass using inline SVG.
- [ ] Draw bicycle with two wheel groups, frame, handlebar, seat, pedals, and rider connection points.
- [ ] Draw a recognizable pelican with body, long beak, head, wing, eye, feet, and legs.
- [ ] Add wheel rotation, cloud drift, body bob, and alternating leg/pedal motion via CSS keyframes.
- [ ] Add JavaScript to toggle a `.paused` class and update button label/ARIA state.
- [ ] Add reduced-motion media query that stops decorative movement while preserving the illustration.
- [ ] Verify by opening the file in a browser and checking animation, button behavior, and narrow viewport.
- [ ] Commit with `git add pelican-bike.html && git commit -m "feat: add animated pelican bicycle poster"`.

---

### Superpowers Specs 2026 09 14 Pelican Bike Design (`docs/superpowers/specs/2026-09-14-pelican-bike-design.md`)

# 骑自行车的鹈鹕 SVG 动画设计

## 目标
创建一个无需依赖、双击即可打开的 HTML 页面，用 SVG 动画表现一只鹈鹕骑自行车，整体采用复古海报风格。

## 视觉
米黄色纸张背景，深蓝色线稿，橙红与珊瑚色作为主体和装饰色。页面包含标题、太阳、远山、草地与道路，主体居中并有足够留白。

## 动画
自行车两个车轮持续旋转；鹈鹕的双腿交替踩踏；身体和头部轻微上下起伏；云朵缓慢漂移。提供暂停/继续按钮，并尊重 `prefers-reduced-motion`。

## 技术
单文件 `pelican-bike.html`，原生 HTML/CSS/内联 SVG，无外部资源。通过 SVG `<animateTransform>`、CSS keyframes 和按钮事件控制动画状态。窄屏下缩放 SVG 与文本布局。

## 验收
打开文件即可看到完整构图和连续动画；按钮可暂停和恢复；页面在窄屏下不横向溢出。

---

--- METRICS ---
- Files Extracted: 3
- Estimated Token Budget: ~1292 tokens
- Canonical Reference: https://codewiki.google/github.com/mack-a/v2ray-agent