AsulTop

一、立项背景和目标 该仓库是自研的 AsulLang 轻量化脚本解释器项目。当下很多嵌入式脚本引擎体积庞大、跨平台兼容性较差，C++ 程序接入脚本引擎流程繁琐，多数轻量解释器缺少异步、装饰器、元编程等现代语法。 项目目标为搭建一款基于 C++、易于嵌入宿主程序的跨平台脚本引擎；完善新式编程语言语法用来做语言特性试验；搭建命令行工具、VS‑Code 插件、内置标准库，降低开发者二次开发难度，方便 C++ 项目搭载动态可修改的脚本业务逻辑。 二、软件功能、核心功能模块 项目主体采用 C++ 编写解释器内核，附带 VSCode 语法插件、编译测试脚本，主要分为五大模块。 解释器内核模块：包含词法分析、语法解析、抽象语法树生成、运行时环境、异步事件循环，负责解析源码、管理变量作用域、调度异步任务，同时内置语言服务支撑代码提示。 脚本语言核心能力：支持面向对象多继承、闭包、装饰器、解构赋值、模式匹配、异步语法、模块导入、元编程等功能；自带文件读写、网络请求、正则、动态库调用、单元测试等标准库。 命令行工具模块：提供 REPL 交互式终端、脚本文件运行、版本查看、批量测试功能，可以直接调试和执行 alang 格式源码。 编辑器配套工具：VSCode 扩展实现语法高亮、代码折叠、符号识别，方便日常脚本编写。 C++ 宿主接入模块：对外开放原生绑定接口，开发者能够注册 C++ 函数与类，实现 C++ 主程序和脚本之间互相调用，还支持 FFI 调用系统动态链接库。 三、业务流程、功能路径 首先进行项目编译部署，拉取源码后借助 CMake 完成跨平台配置，编译生成可执行程序，安装对应依赖环境。 日常开发存在三条使用路径。第一种为交互式调试，启动程序进入 REPL 环境，逐行输入代码即时运行调试；第二种直接加载.alang脚本文件执行业务代码；第三种嵌入进 C++ 工程，初始化引擎、注册底层原生接口后运行脚本，手动驱动事件循环处理异步任务。 完整开发流程：安装 VSCode 插件编写脚本，导入内置标准库实现文件、网络等功能；编写单元测试，运行批量测试脚本校验代码；高级场景依靠 FFI 调用本地动态库，利用元编程接口动态生成、执行代码。 该引擎适合桌面程序、嵌入式项目扩展动态逻辑，也可供爱好者开展编程语言相关实验。

ACM-Next 业务与功能介绍 1、立项背景和目标 Counter-Strike 2（CS2）的配置文件（按键绑定、准星、游戏参数等）在社区中分发、共享和安装门槛较高，普通玩家难以手动完成路径定位与文件部署。ACM-Next（AsulCFGManager-Next）是一款基于 Qt/C++ 的 CS2 配置文件管理与部署工具，面向 Windows 10/11 平台，旨在通过图形化界面实现配置包的在线获取、本地导入、签名验证、表单化自定义及一键部署，同时支持多游戏平台（Steam、完美世界竞技平台、5E对战平台）启动项的统一管理。 2、软件功能与核心模块介绍 在线商店模块 支持自定义源拉取配置包清单，展示名称、版本、作者、描述及文件大小，一键下载安装。 本地管理模块 扫描已安装配置、导入本地 ZIP 包，支持编辑、卸载及冲突检测。 部署面板模块 基于 .asul 表单定义文件动态渲染 UI，支持按键绑定、下拉选项、文本输入等五种字段类型，并通过条件表达式控制字段可见性。 启动项管理模块 统一管理 Steam、完美世界竞技平台、5E对战平台的 CS2 启动参数，支持多账号切换与一键应用。 安全机制 集成 AVF-SDK 数字签名验证，区分受信任与不受信任的配置来源。 全局设置 支持明暗主题切换、Windows 系统色同步、亚克力/云母等显示模式、中英文语言切换。 3、业务流程与功能路径 用户启动程序后，系统自动通过注册表检测 Steam 安装路径并定位 CS2 配置目录。 配置部署流程 部署页 → 选择在线商店/自定义URL/本地导入 → 下载或选取配置包 → 数字签名验证 → 异步解压 → 解析 .asul 表单 → 打开部署面板进行自定义配置（按键、选项、文本等） → 点击部署生成 .cfg 文件写入 CS2 目录。 启动项管理流程 启动项页 → 选择平台及账号 → 勾选/取消配置项的启动参数 → 应用写入平台配置文件。 配置维护 已安装配置可随时重新编辑或卸载，卸载时自动重置按键绑定与控制台变量。

WrtClient 业务与功能介绍 一、立项背景与目标 东北电力大学校园网需要用户手动打开浏览器进行Web认证才能上网，断网后还得重新登录，操作繁琐。WrtClient部署在OpenWrt路由器上，目标是：实现校园网自动认证和断线重连；提供Web管理界面让普通人也能配置路由器；通过Webhook把网络故障和设备变化实时推送给用户；在路由器有限资源下保持高效稳定运行。 二、核心功能模块 初始化向导：首次启动引导完成设备激活、WiFi连接和校园网账号配置。 身份认证：16位授权码验证，Token有效期24小时，30分钟心跳续期。 WiFi管理：通过UCI命令读写无线配置，支持WPA2/WPA3，兼容iw和iwinfo双通道扫描。 设备管理：融合ARP表、DHCP租约和连接跟踪三源数据发现设备，支持流量统计、设备踢出和别名设置。 防火墙信息：展示iptables规则和防火墙配置，支持NAT类型检测。 网络诊断：DNS解析、ICMP Ping、TCP Ping、路由追踪，结果60秒缓存。 校园网认证：集成NEEPU SDK，支持三大运营商多账号优先级排序，每30秒检测网络，断网自动重连。 Webhook推送：6种事件类型，自定义请求模板和头信息，验证码双步验证，异步派发。 自动化规则：支持事件触发和Cron定时，可执行Webhook通知、Shell命令和日志写入。 系统监控：实时展示CPU、内存、流量，历史图表，小组件可配置，SSE每2秒推送。 局域网测速：内网下载和上传速率测试。应用更新：双源检查，SHA256校验，一键升级。 三、业务流程 首次使用：访问路由器跳转初始化向导，验证授权码，选择WiFi连接，配置校园网账号自动认证，完成后登录进入仪表盘。 日常使用：登录后实时查看系统状态，按需操作WiFi、设备、诊断、测速、推送、自动化等功能。 后台运行：数据采集每2秒缓存系统信息，SSE推送给客户端，校园网监控每30秒自动重连，诊断每60秒更新快照，事件变化触发Webhook和自动化规则。 容错保障：procd守护崩溃后5秒重启，hotplug监听接口事件，rc.local兜底启动。