安装

RunLogos 依赖 OpenLogos CLI（openlogos）完成核心工作，包括项目初始化、openlogos verify、变更提案和 AI Skills 调度。请先安装 CLI；没有 CLI，RunLogos 无法完整工作。

第 1 步：安装 OpenLogos CLI

前置要求

OpenLogos CLI 需要 Node.js 18 或更高版本。先检查本机版本：

node --version

如果还没有安装 Node.js，请访问 nodejs.org 下载 LTS 版本。

安装命令

npm install -g @miniidealab/openlogos

验证安装

openlogos --version

如果能看到版本号，说明 CLI 已安装成功。如果系统提示找不到命令，请确认 npm 全局 bin 目录已经加入 PATH。

macOS / Linux 提示： 如果安装后找不到 openlogos，运行 npm config get prefix 查看全局安装目录，并把 <prefix>/bin 加入 ~/.zshrc 或 ~/.bashrc。

Windows 提示： npm 全局包通常位于 %APPDATA%\npm。请确认该目录已经加入系统 PATH。

第 2 步：安装 RunLogos

RunLogos 是面向 macOS 和 Windows 的原生桌面应用。安装不需要账号；只有解锁 Pro 能力时才需要 License Key。

系统要求

下载安装包

前往首页的下载区域，选择你的平台。

• macOS：.dmg 安装包
• Windows：.exe 安装包

macOS 安装

1. 打开下载好的 .dmg 文件
2. 将 RunLogos 拖入 Applications 文件夹
3. 从 Applications 或 Spotlight 打开 RunLogos
4. 如果 macOS 提示确认打开来自互联网的应用，点击 Open

Windows 安装

1. 运行下载好的 .exe 安装包
2. 按安装向导完成 Next → Next → Install
3. 从开始菜单或桌面快捷方式启动 RunLogos

第 3 步：初始化第一个项目

在 RunLogos 中打开项目之前，先用 CLI 初始化项目目录。进入你的项目根目录并运行：

openlogos init

该命令会创建 RunLogos 读取的 logos/ 目录结构：

logos/
  logos.config.json       # 项目配置，包含语言和模块
  logos-project.yaml      # RunLogos 用于导航项目资源的索引
  resources/              # 规格链产物所在目录
  spec/                   # OpenLogos 方法论规格
  skills/                 # 各阶段 AI Skills
AGENTS.md                 # AI 指令入口，Claude Code、OpenCode 等会自动读取

已有项目？ 在仓库根目录运行 openlogos init 即可。该命令不会覆盖你的业务代码。

首次启动

打开 RunLogos，并选择已经初始化的项目文件夹。RunLogos 会读取 logos/logos-project.yaml，发现规格链产物并填充文件树。

首次启动时，RunLogos 使用 社区版模式，可永久免费使用 Markdown 编辑器、时序图查看器和项目看板。

如需解锁完整规格链工作流（OpenAPI 编辑器、SQL 设计器、API 编排运行器），请激活你的 License Key →