企业官网建设流程全解析

Windows用户必看：Open-Science WSL2 Bash预览配置图解

【免费下载链接】open-scienceAIPOCH Open-Science is an open-source, local-first, model-agnostic AI research workbench for macOS, Windows, and Linux, with scientific agents, Python/R notebooks, data connectors, and reproducible provenance.项目地址: https://gitcode.com/GitHub_Trending/open/open-science

Open-Science是一款开源、本地优先、不绑定特定大模型的 AI 科研工作台，覆盖 macOS、Windows 与 Linux 三大平台。对 Windows 用户来说，它最实用的能力之一，就是把WSL2 Bash 预览作为本地 Shell 运行时：在设置面板里几步勾选，就能让科研 Agent 直接跑在真正的 Linux 环境里。本文用图解方式带你从零完成配置。

开始之前：确认 3 项基础条件

WSL2 Bash 预览不是所有 Windows 机器都能用。系统会在启动时用一套"门控"判断当前是否可用，核心条件如下：

• 🪟系统为 Windows x64（64 位），WSL 相关的软件与内核已就绪；
• 📦安装包构建：正式打包版本需内置 WSL2 资产且清单匹配（开发机可用开发预览开关）；
• 🔄可能需要重启：安装 WSL2 平台后，Windows 需重启一次才能继续。

提示：预览是否可用属于构建时决策，运行期无法通过环境变量或偏好设置强行打开。若你的版本显示"WSL2 Bash Preview is unavailable"，面板会引导你切回 PowerShell 继续使用。

判断逻辑源码见 wsl2-preview-gate.ts。

图解第一步：在设置中找到 Local Shell 面板

打开设置 → Runtimes，往下滚动即可看到Local Shell · WSL2 Bash Preview区块。这个区块就是你配置 WSL2 的唯一入口：它负责探测状态、展示就绪检查项、并在一切就绪后提供切换开关。

面板顶部有一个Check now / Check again按钮，点击后会实时刷新发行版列表与配置状态。界面源码位于 WslLocalShellSection.tsx。

图解第二步：安装 WSL2 平台与发行版

首次配置时，面板会按顺序提示你完成三件事：

1. 安装 WSL2 平台—— 若提示not-installed，点击Install WSL2。Windows 会弹出管理员授权（UAC），注意：这一步只安装 WSL2 平台本身，不会替你装发行版。
2. 安装发行版—— 若没有可用的发行版，可下拉选择后点击Install。默认推荐Ubuntu 24.04 LTS，也支持 Debian 13、Ubuntu 22.04、Kali Linux、openSUSE、Fedora 等。
3. 首次启动—— 安装完成后点击Open distribution terminal，在弹出的终端里完成 Linux 用户名与密码的初始化。

🔒 安全边界：Open-Science 绝不会替你输入任何密码，账户初始化这类交互始终由你在可见终端中手动完成。

图解第三步：选择发行版与非 root 用户

平台装好后，面板会列出所有已安装的发行版。你需要：

• 从下拉框里选一个WSL2发行版（WSL1 会被标为unsupported，无法选中）；
• 填入一个精确的、非 root 的 Linux 用户名；
• 点击Save and check保存并重新探测。

保存只是"候选"，并不会立即启用 WSL2 Bash。真正激活要等所有就绪检查通过，并在下一步手动确认。相关数据结构与状态定义见 wsl-setup.ts。

图解第四步：补齐依赖并切换运行时

保存后，面板会展示一排就绪检查项（Readiness checks），全部变绿才算 ready：

• WSL2 发行版 ✅
• Linux 主目录（home）✅
• Bash ✅
• bubblewrap ✅
• Python 3 ✅
• 镜像网络（Mirrored networking）✅
• Linux namespaces ✅
• 本地 Windows 工作区（NTFS）✅

如果缺 Bash / Python 3 / bubblewrap，且系统支持自动安装，会出现Install missing dependencies按钮——它会以 WSL root 一次性只装缺失的运行库，不改 sudoers，也不自动启用。

一切就绪后，点击Use WSL2 Bash完成切换；随时也可以点Switch to PowerShell切回。切换仅对之后的命令生效，正在运行的命令不会被移动或重跑。

卡在某一步？用"对话式配置"修复

如果某项检查一直红灯，面板提供Set up in conversation按钮，它会开启一个专属的 WSL 配置会话，由 Agent 拿着诊断工具一步步陪你修复。内置的修复手册会在该会话中加载，指导你完成镜像网络、NTFS 工作区、非 root 用户等关键项。手册文件见 wsl2-setup.md，探测与终端拉起逻辑见 wsl-setup-terminal.ts 和 wsl-setup-guide.ts。

常见问题速查

📎 注意：wsl --shutdown会影响所有正在运行的发行版并可能中断 Docker，操作前先确认。

相关模块与源码索引

• 预览可用性门控：wsl2-preview-gate.ts
• WSL 探测 / 安装 / 终端：wsl-setup-terminal.ts
• 修复会话手册加载：wsl-setup-guide.ts
• 配置面板界面：WslLocalShellSection.tsx
• 共享状态与类型：wsl-setup.ts
• 端到端验证用例：wsl-setup-conversation.spec.ts
• 官方贡献指南：CONTRIBUTING.md

配置完成后，你就能在 Open-Science 里用真实的 Linux Bash 环境运行 Python/R 笔记本、连接数据源，并保留可复现的执行溯源。祝配置顺利 🚀

【免费下载链接】open-scienceAIPOCH Open-Science is an open-source, local-first, model-agnostic AI research workbench for macOS, Windows, and Linux, with scientific agents, Python/R notebooks, data connectors, and reproducible provenance.项目地址: https://gitcode.com/GitHub_Trending/open/open-science