WANIX 开源项目教程

1. 项目介绍

WANIX 是一个实验性的、本地优先的、Web 原生的类 Unix 开发环境。它允许用户在浏览器中运行和创建命令行、TUI（终端用户界面）和 Web 应用。WANIX 的核心特性包括：

• Go 编译器：在浏览器中运行，并支持跨平台编译。
• 可插拔的文件系统 API：支持自定义文件系统行为，类似于 FUSE/Plan9。
• 类 Unix 的 Shell：可以实时编辑和重新编译，或者完全替换。
• 内置微编辑器：类似于 nano。
• 支持 TypeScript 和 JSX：在 Web 应用中无需额外工具。
• 身份验证：使用 Auth0 部署为静态站点的“后端”。
• GitHub 文件系统：直接操作仓库分支。

2. 项目快速启动

安装 WANIX CLI

你可以通过以下命令安装 WANIX CLI：

bash -c "$(curl -sSL https://raw.githubusercontent.com/tractordev/wanix/main/install.sh)"

或者使用 Homebrew 安装：

brew tap progrium/homebrew-taps
brew install wanix

启动开发服务器

运行以下命令启动本地开发服务器：

wanix dev

部署到 GitHub Pages

使用以下命令将 WANIX 静态站点部署到 GitHub Pages：

wanix deploy

3. 应用案例和最佳实践

创建一个 Web 应用

在 WANIX 环境中，Web 应用位于 /app 目录下。你可以创建一个目录，例如 /app/webapp，并在其中创建一个 index.html 文件。然后使用以下命令打开应用：

open webapp

创建一个命令行工具

你可以通过在 /cmd 目录下创建一个 Shell 脚本或 Go 源代码来创建命令行工具。例如，创建一个名为 hello.sh 的 Shell 脚本：

micro /cmd/hello.sh

在文件中添加以下内容：

echo "Hello world"

保存并退出后，你可以在 Shell 中运行 hello 命令。

4. 典型生态项目

内置微编辑器

WANIX 内置了一个类似于 nano 的微编辑器，你可以使用它来编辑文件。例如，编辑 /cmd/hello.sh 文件：

micro /cmd/hello.sh

使用 Hugo

WANIX 提供了一个可以在 WANIX 中运行的 Hugo 版本。你可以通过以下命令安装 Hugo：

cd /cmd
get https://dl.wanix.sh/misc/hugo.wasm

安装完成后，你可以使用 Hugo 创建和管理静态站点。

身份验证

WANIX 支持使用 Auth0 进行身份验证。在部署到 GitHub Pages 时，你可以使用 --enable-auth 标志来启用身份验证：

wanix deploy --enable-auth

这将配置 Auth0，允许用户使用 GitHub 登录。登录后，WANIX 会将 GitHub 仓库挂载到 /repo 目录，你可以直接在 WANIX 中修改站点内容。