# VUS官方代码-示例

**Repository Path**: rtccn_mc/vus-example

## Basic Information

- **Project Name**: VUS官方代码-示例
- **Description**: VUS官方代码示例库
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-16
- **Last Updated**: 2026-09-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="https://gitee.com/rtccn_mc/vus/raw/master/vus-logo.png" alt="VUS Logo" width="192">
</p>

> 文档版本：v1.0_apk（APK 功能时代）
> 最后更新时间：2026-09-04

# VUS 官方示例库（vus-example）

> **以用促建，实战驱动**
> 示例是语言的试金石，实战是语言的炼金炉。

本仓库是 VUS 官方示例代码库，承载 "以用促建" 的发展理念：**不在真空中设计功能，而是通过编写有实际用途的 VUS 代码来驱动语言演进。**

## 理念：以用促建，实战驱动

VUS 语言的每一步演进，都源于真实场景的需求；每一次语言升级，都来自实战项目的检验。我们相信，**只有经过实际代码检验的语言，才是真正可用的语言。**

### 开发循环

```
写应用 → 找痛点 → 补功能 → 再写应用
```

1. **写应用**：用 VUS 编写一个真实可用的程序
2. **找痛点**：在编写过程中记录语言的不足与缺失
3. **补功能**：按优先级补齐缺失的特性与修复 Bug
4. **再写应用**：用更新后的 VUS 编写下一个程序，验证修复效果

循环往复，每一次循环 VUS 都离"真正可用"更近一步。

## 快速开始

```bash
# 克隆示例库
git clone https://gitee.com/rtccn_mc/vus-example.git
cd vus-example

# 运行入门示例（需先安装 VUS 语言）
vus run examples/hello.vus
```

> 安装 VUS：`curl -fsSL https://gitee.com/rtccn_mc/vus/raw/master/install.sh | bash`

## 目录结构

```
vus-example/
├── examples/            # 示例程序（按主题分类）
│   ├── hello.vus        # 入门：你好，世界！
│   ├── 算法/            # 算法与递归
│   ├── 结构体/          # 结构体定义与访问
│   ├── 泛型/            # 泛型函数
│   ├── 并发/            # 线程与协程
│   ├── 实战/            # 真实应用（计算器、搜索、本地部署等）
│   ├── 插件/            # 插件体系（vux 功能插件调用）
│   ├── GUI/             # GuiLite 画布流（图形_*，Termux/Linux X11）
│   ├── 音游/            # 体感音游（vus chart + vus_xyz 运行时）
│   └── VUA/             # VUA Android 组件流（.vua + 界面_*，APK 时代）
├── docs/                # 从示例学语法
└── README.md
```

## 示例索引

| 示例 | 主题 | 能力点 |
|------|------|--------|
| [hello.vus](examples/hello.vus) | 入门 | 打印、变量、算术运算 |
| [算法/阶乘.vus](examples/算法/阶乘.vus) | 递归 | 函数、递归、条件分支 |
| [算法/斐波那契.vus](examples/算法/斐波那契.vus) | 递归 | 函数、递归运算 |
| [结构体/点.vus](examples/结构体/点.vus) | 结构体 | struct、字段访问 |
| [泛型/泛型.vus](examples/泛型/泛型.vus) | 泛型 | 泛型函数、类型参数 |
| [并发/线程协程.vus](examples/并发/线程协程.vus) | 并发 | 线程、协程、让出/恢复 |
| [实战/插件调用.vus](examples/实战/插件调用.vus) | 插件体系 | 插件_运行内建函数 |
| [实战/meili_search.vus](examples/实战/meili_search.vus) | 真实应用 | 生成 Meilisearch 搜索页面 |
| [实战/计算器.vus](examples/实战/计算器.vus) | GUI 应用 | 图形_* 画布流、按钮事件、状态机 |
| [实战/本地搜索部署.vus](examples/实战/本地搜索部署.vus) | 插件组合 | 插件_运行 驱动本地部署 + 搜索全链路 |
| [插件/实时调用.vus](examples/插件/实时调用.vus) | 插件体系 | 插件_运行 / 插件_运行JSON 实时调用 |
| [GUI/控件总览.vus](examples/GUI/控件总览.vus) | GUI 画布流 | 图形_* 全部控件（按钮/列表/复选框/画布） |
| [GUI/图形应用演示.vus](examples/GUI/图形应用演示.vus) | GUI 画布流 | 多页面应用、tab 切换、交互回调 |
| [GUI/迷你操作系统.vus](examples/GUI/迷你操作系统.vus) | GUI 画布流 | 页面栈窗口管理、文件管理器、内嵌终端 |
| [音游/XYZ体感音游.vus](examples/音游/XYZ体感音游.vus) | 体感音游 | vus_xyz 运行时、谱面判定、传感器甩动 |
| [VUA/安卓界面.vus](examples/VUA/安卓界面.vus) | VUA 组件流 | .vua 定义界面 + 界面_显示/设置/取 驱动 |

> **运行环境提示**：
> - `GUI/` 与 `实战/计算器.vus`：需 GUI 依赖（libpng/freetype/X11），见 [VUS 安装](https://gitee.com/rtccn_mc/vus)。
> - `音游/`：在 Termux + 传感器 + mpv 环境效果最佳，无传感器时自动降级仅为渲染演示。
> - `VUA/`：配合 `vus build --apk` 在 Android 端运行（APK 功能时代）。
> - `插件/` 与 `实战/本地搜索部署.vus`：先用 `vus vux install 示例` / `vus vux install meilisearch_localdeployment` 安装对应插件。

## 如何贡献示例

欢迎贡献实战示例！请遵循以下原则：

1. **真实可用**：示例必须是可实际运行的完整程序，而非语法片段
2. **驱动语言**：每个示例应能验证或挑战 VUS 的某个能力点
3. **记录痛点**：编写过程中发现的语言缺陷，请提交到 [VUS 主仓库 Issues](https://gitee.com/rtccn_mc/vus/issues)
4. **分类清晰**：放入 examples/ 下对应主题目录

## 从示例学语法

- [docs/TUTORIAL.md](docs/TUTORIAL.md) — 通过示例讲解 VUS 核心语法

## 相关仓库

| 仓库 | 说明 |
|------|------|
| [rtccn_mc/vus](https://gitee.com/rtccn_mc/vus) | VUS 语言编译器与运行时 |
| [rtccn_mc/official-vus.vux-package](https://gitee.com/rtccn_mc/official-vus.vux-package) | VUS 官方功能插件包 |

## 开源协议

[MIT](LICENSE) © 2026 VUS Language Contributors