WSL（适用于 Linux 的 Windows 子系统）集成¶
WSL 允许您直接在 Windows 上运行完整的 Linux 环境。设置完成后，STT shell 集成的工作方式与 Linux Bash 或 Zsh 指南相同 — shell 功能本身无需针对 Windows 进行调整。
推荐给： 熟悉 Linux 终端或已安装 WSL 进行开发工作的 Windows 用户。 WSL 提供最忠实的体验和最少的兼容性妥协。
先决条件¶
安装 WSL（一次性安装）¶
以管理员身份打开 PowerShell 或 CMD 并运行：
代码_块_0
默认情况下，这会在 Ubuntu 上安装 WSL2。出现提示时重新启动计算机。
要安装特定发行版：
代码_块_1
列出所有可用的发行版：
代码_块_2
验证您的 WSL 版本¶
代码_块_3
确保“版本”列显示“2”。如果显示“1”，请升级：
代码_块_4
WSL 内部的 Shell 集成¶
WSL 运行后，打开 Linux 终端并按照您首选 shell 的 Linux shell 指南 进行操作：
壳牌 |
指南 |
|---|---|
Bash（WSL 默认） |
|
泽什 |
|
鱼 |
|
克什 |
|
POSIX sh / 破折号 |
对于使用 Bash 的默认 Ubuntu/Debian WSL 设置，快速路径是：
代码_块_5
WSL 特定注意事项¶
从 WSL 访问 Windows 文件¶
您的 Windows 驱动器安装在 /mnt/ 下：
代码_块_6
如果您的项目位于 Windows 文件系统上（例如“C:\Projects\stt”），请将“SL5NET_AURA_PROJECT_ROOT”设置为：
代码_块_7
将此行添加到“~/.bashrc”（或 shell 的等效内容）“s()”函数的上方。
性能提示： 为了获得最佳 I/O 性能，请将项目文件保存在 WSL 文件系统内（例如
~/projects/stt），而不是放在/mnt/c/...上。 WSL 和 Windows 之间的跨文件系统访问速度明显变慢。
WSL 内的 Python 虚拟环境¶
在 WSL 中创建并使用标准 Linux 虚拟环境：
代码_块_8
函数中的“PY_EXEC”路径（“$SL5NET_AURA_PROJECT_ROOT/.venv/bin/python3”）将按原样正常工作。
从 Windows 终端运行 s¶
Windows Terminal 是在 Windows 上使用 WSL 的推荐方法。它支持每个 WSL 发行版的多个选项卡、窗格和配置文件。从 Microsoft Store 或通过以下方式安装：
代码_块_9
在 Windows 终端设置中将 WSL 发行版设置为默认配置文件，以获得最无缝的体验。
Docker 按需 (Linux)¶
为了节省系统资源，您可以将 Docker 配置为仅在需要时启动（例如，当 Aura 请求 Trino 数据库时），而不是在后台持续运行。
运行以下命令以禁用连续后台服务并启用“套接字激活”：
代码_块_10
使其更新安全（Linux Arch/Manjaro 用户）： 包更新有时会重置套接字配置。为了防止这种情况，创建一个持久的本地覆盖：
代码_块_11 确保以下行存在且未注释（删除“#”），然后保存并退出： 代码_块_12
WSL 中的 Docker 和 Kiwix¶
Kiwix 帮助程序脚本（kiwix-docker-start-if-not-running.sh）需要 Docker。安装适用于 Windows 的 Docker Desktop 并启用 WSL 2 集成：
1.下载并安装Docker Desktop。 2. 在 Docker Desktop → 设置 → 资源 → WSL 集成中，启用 WSL 发行版。 3.在WSL内部验证： 代码_块_13
从 Windows 调用 WSL s 函数（可选）¶
如果您想从 Windows CMD 或 PowerShell 窗口调用“s”快捷方式而不打开 WSL 终端，您可以将其包装：
代码_块_14
代码_块_15
-i标志加载一个交互式 shell，以便自动获取您的~/.bashrc（和s函数）。
＃＃ 特征
完全 Linux 兼容性：所有 Unix 工具（
timeout、pgrep、mktemp、grep）都可以本机工作 — 无需解决方法。动态路径：通过 shell 配置中设置的“SL5NET_AURA_PROJECT_ROOT”变量自动查找项目根目录。
自动重启：如果后端关闭，它会尝试运行
start_service和本地维基百科服务（Docker 必须正在运行）。智能超时：首先尝试 2 秒快速响应，然后退回到 70 秒深度处理模式。