常见问题

安装

RunLogos 支持哪些平台？

支持 macOS 12+（Apple Silicon 与 Intel）和 Windows 10 64 位及以上版本。Linux 版本在规划中。

安装包大约多大？

约 200 MB。RunLogos 会打包必要运行时，不需要额外安装桌面运行环境。

RunLogos 应用内为什么不能直接下载更新？

RunLogos 1.0.3 起，新版本统一从官网下载页 runlogos.cn/download 获取。在 设置 → 检查更新 中点击「前往官网下载」即可打开下载页。详见设置、隐私与更新。

授权

“永久授权”是什么意思？

你永久拥有已购买版本，可以一直使用，无需订阅。后续年度更新费用只影响新版本更新资格，不影响已符合资格版本的继续使用。

一个 License 可以激活几台设备？

一个 License 可同时激活 2 台设备。如需激活第三台设备，请先在 Settings → License → Manage Devices 中解绑旧设备。

可以从试用版升级为永久授权吗？

可以。进入 Settings → License → Upgrade 查看当前可用方案并补差价升级。License Key 会保持不变。

早鸟版还能买吗？

早鸟版已停止发售，已购早鸟 License 继续有效并可按年续费（¥139/年）。现在的永久授权方案是标准版，价格以定价页为准。

功能

社区版真的永久免费吗？

是。Markdown 编辑器、时序图查看器和项目看板永久免费，无需账号。

使用 AI Skills 需要什么？

完整 AI 工作流需要付费 License。Skills 内置于 RunLogos，但具体 AI 执行仍使用你本地已经配置好的 AI 编程工具。

RunLogos 会上传我的代码吗？

不会。项目数据保存在本机 logos/ 目录中，并由你自己的 Git 仓库管理。RunLogos 不会主动上传你的代码和规格文档。

如何关闭匿名使用统计和崩溃报告？

打开 设置 → 隐私与数据，可以分别关闭「发送匿名使用统计」和「发送崩溃报告」。两项默认开启，关闭后立即生效，本机尚未发送的数据也会清空。上报内容不包含文档、代码、Prompt、路径或凭据。详见设置、隐私与更新。

如何把项目发布到测试环境或生产环境？

先在 logos/environments.yaml 登记环境（需要 OpenLogos CLI ≥ 0.16.7、RunLogos 1.0.4 起），然后在 RunLogos 菜单 项目 → 环境... 点「发布…」，或对 Agent 说「发布到测试环境」。上手步骤见环境与部署。

没有用 git 的项目能部署吗？

部署、晋级、回滚和审批都以 git 提交作为版本号，所以需要先启用版本管理。在环境面板点「启用版本管理…」，RunLogos 会在本机创建仓库并完成初始提交，不需要远程或 GitHub。详见 RunLogos 环境面板。

老项目没有场景文档，能直接提变更吗？

能。写变更提案时，本次触达的文档如果不存在，Agent 会读取现有代码逆向生成完整文档，随提案合并。不需要先补齐全部规格。详见按需补齐缺失文档。

排障

安装 CLI 后提示 openlogos: command not found

重新打开终端。如果仍然失败，请检查 /usr/local/bin（macOS）或 npm 全局 bin 目录是否在 PATH 中。

终端里能运行 openlogos，RunLogos 却提示未安装或版本过低

RunLogos 1.0.3 起会读取你的 shell 配置（例如 ~/.zshrc）中的 PATH 查找 openlogos。请先确认版本不低于 0.15.16（openlogos --version），低于时运行 npm install -g @miniidealab/openlogos@latest；然后完全退出并重新打开 RunLogos。

部署报 DEPLOY_SECRETS_MISSING，可我明明在 shell 里 export 了变量

从 Finder 或开始菜单启动的 RunLogos 拿不到你在 ~/.zshrc 等 shell 配置里 export 的变量。在环境面板的「密钥」标签为该变量点「设置值」保存一次即可：值加密保存在本机，RunLogos 启动的部署、冒烟和 Agent 会自动注入。已在运行的 Agent 需要重启后才能拿到新值。详见 RunLogos 环境面板。

全自动驱动为什么停在「等待审批」？

目标环境配置了 require_approval，而这次要部署的版本还没被批准。审批只能由人做，全自动模式也不会越过。在环境面板点「批准版本…」（或在终端运行 openlogos approve）后，重新驱动即可继续。停在「晋级未满足」时，则需要先在上游环境用同一版本冒烟通过。详见环境与部署。

macOS 提示应用已损坏或无法打开

进入 System Settings → Privacy & Security，在 RunLogos 提示旁点击 Open Anyway。这是 macOS 对非 App Store 应用的常规 Gatekeeper 提示。

仍然无法解决？

请提交 GitHub Issue，或发送邮件到 fred@miniidealab.com。