企业官网建设流程全解析

Windows用户的Open-Science环境设置完全指南（含WSL2配置）

【免费下载链接】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（AIPOCH Open-Science）是一款开源、本地优先、模型无关的 AI 科研工作台，支持 macOS、Windows 和 Linux。本文将带你在 Windows 上完成Open-Science 环境设置：从下载安装、五步初始化向导，到WSL2 Bash 运行时配置，全部流程一步到位。即使是第一次接触 Linux 子系统的用户，也能跟着做完。

Open-Science 是什么？为什么 Windows 用户需要关注

一句话概括：它是一个"科研项目工作台"。你创建一个项目，用自然语言描述研究目标，AI 智能体就会读文件、检索文献、执行 Python/R 代码、查询科学数据库，并生成带完整溯源证据的报告、表格和图表。

对 Windows 用户有两个核心卖点：

• 本地优先：项目数据、会话、笔记全部存储在本地，API Key 使用系统安全凭据存储
• WSL2 Bash 预览：Windows x64 上可启用 WSL2 环境来执行 shell 命令，让 Linux 风格的科研脚本（如 Bash、Python 环境）直接在应用内运行

第一步：下载并安装 Windows 版本

1. 打开项目最新 Release 页面，展开Assets
2. 选择Windows x64安装程序（注意：WSL2 Bash 功能仅支持 Windows x64，这是 WSL2 预览启用逻辑 中明确校验的）
3. 双击安装，若 Windows 提示"未知发布者"，确认包来自官方 Releases 页即可继续
4. 需要校验安装包完整性时，参考 SECURITY.md 中的下载验证说明

第二步：完成五步首次启动向导

首次启动会进入引导式设置，共五步。只有当前步骤的必需检查项全部通过，"Continue" 按钮才会点亮：

模型连接这一步会实际发起测试请求。如果失败，按 FAQ 思路排查：检查 API Key 是否复制完整、Base URL 与地域是否正确、模型 ID 是否使用厂商给出的精确名称。

第三步：创建第一个科研项目

设置完成后：

1. 点击New project，给项目起一个稳定的研究名称
2. 打开会话，描述目标、输入数据、约束、期望输出和验收方式
3. 附加源文件（@引用项目文件，/选择已启用技能）
4. 发送任务，在预览面板中查看生成的报告与图表

生成的每个产物都可以打开Provenance视图，追溯其生成代码、执行历史、输入文件和环境清单——这是它区别于普通 AI 聊天工具的关键能力。

WSL2 配置完整流程

这是 Windows 用户最值得花时间的一节。启用后，应用中的 shell 命令会路由到经过就绪检查的 WSL2 环境。完整官方指南随应用分发，源文件在 resources/guides/wsl2-setup.md。

4.1 前置条件检查

WSL2 Bash 预览有三个硬性前提（来自 wsl2-preview-gate.ts）：

• 操作系统为Windows x64
• 使用打包发布的版本
• 当前构建启用了该功能（默认启用）

4.2 安装 WSL2 平台与发行版

在 PowerShell（管理员）中执行：

# 安装 WSL2（含默认 Linux 发行版） wsl --install # 重启系统后确认版本与镜像网络模式 wsl --version wslinfo --networking-mode

⚠️关键要求：当前预览版需要mirrored 网络模式。如果wslinfo --networking-mode不返回mirrored，需要编辑%UserProfile%\.wslconfig，在[wsl2]段加入networkingMode=mirrored。编辑前建议先备份原文件，并保留无关的配置段。

修改网络模式后需要执行wsl --shutdown——这会关闭所有正在运行的 Linux 发行版，可能中断 Docker，请提前保存工作。

4.3 在应用内完成配置（推荐方式）

其实你不需要手动折腾命令行。Open-Science 内置了对话式 WSL 配置会话：

1. 在输入框输入/setup-wsl，选择"Set up or repair WSL2 Bash in Open Science."
2. 智能体会调用专属诊断工具wsl_setup_diagnostics，返回版本匹配的发行版候选、就绪检查结果和恢复建议
3. 按诊断结果操作：平台未安装 → 引导安装；无可用发行版 → 安装推荐发行版；多个发行版 → 让你选择
4. 缺少 Bash、Python 3 或 bubblewrap 时，设置页会出现Install missing dependencies按钮，一键以 WSL root 安装缺失包（不会把运行用户加入 sudoers）

几个安全细节值得了解：配置会话只在显式绑定的会话中生效，普通对话无法调用这些工具；全程不会在对话中索要 Linux 密码——账号初始化等交互提示都发生在为你打开的可见终端里。相关实现见 wsl-setup-owner.ts 与端到端测试 e2e/wsl-setup-conversation.spec.ts。

4.4 激活 WSL2 Bash 并回退

所有就绪检查通过后，回到Settings，选择Use WSL2 Bash完成激活。这个动作走的是应用内置的激活与回滚工作流：如果切换后刷新 shell 能力失败，会自动恢复你之前的偏好（逻辑见 local-shell.ts）。

即使日后删除了激活的发行版，应用也会通过wsl_distro_not_found等错误码自动检测并回退到 PowerShell，不会让 shell 处于坏状态。

常见问题 FAQ

Q：WSL2 配置失败了怎么办？A：重新运行/setup-wsl会话并让诊断工具重新探测——官方指南明确要求"每次变更后重跑诊断"，以它的恢复建议为准，而不是盲目重试。

Q：WSL2 Bash 会影响 Notebook 吗？A：不会。两者独立：Notebook 运行 Python/R 内核，WSL2 Bash 只处理 shell 命令，配置会话不会替你装 Jupyter 或替换发行版包管理器。

Q：我的科研数据会离开电脑吗？A：默认全部本地存储。只有模型请求、网页搜索和你配置的连接器调用会把对应内容发送给所选外部服务，运行前请审查敏感输入。

延伸阅读

• 官方 README（简体中文）：docs/zh-Hans/README.md
• 首次启动五步详解：README.md
• WSL2 配置指南源文件：resources/guides/wsl2-setup.md
• 能力路线图：ROADMAP.md

🎉 到这里，你的 Windows 版 Open-Science 环境就配置完毕了。从下载安装到 WSL2 就绪，整个过程不超过 30 分钟——接下来，就把研究目标交给智能体吧。

【免费下载链接】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